Skip to content

fix(aidd-context): source tool-paths claims with dates and URLs - #621

Closed
alexsoyes wants to merge 1 commit into
nextfrom
fix/tool-paths-sources
Closed

fix(aidd-context): source tool-paths claims with dates and URLs#621
alexsoyes wants to merge 1 commit into
nextfrom
fix/tool-paths-sources

Conversation

@alexsoyes

Copy link
Copy Markdown
Contributor

Closes #618

What

Every factual cell in 08-hook-generate/references/tool-paths.md now carries [v] (read in the official docs on 2026-08-11) or [?] (not re-read, unverified). A Sources section lists each page, plus the two URLs that moved and now redirect.

Why

The file stated Codex CLI has no session-end moment. It has one. The claim was wrong and it propagated into a design decision before anyone re-read the source.

The failure is structural: not one cell carried a URL or a date, so nothing distinguished "read in the docs" from "assumed months ago". Auditing a single claim meant re-verifying the whole table. A skill reads this file instead of the vendor docs, so an error here becomes an error in every artefact it generates.

Corrections

  • Codex has SessionEnd. Timeout 1 s, 3 s max, and it does not run for subagents.
  • Copilot casing is not an alias. It selects the payload format (camelCase fields vs snake_case) and sometimes the event name: agentStop becomes Stop.
  • Failure semantics differ per tool, and one denies. A preToolUse handler that exits non-zero on Copilot denies the tool call, so an observer hook that throws stops the agent.
  • OpenCode confirmed as plugins-only: no session-end event, no session id in the plugin context.
  • Session identifier field names differ across all four supported tools, and no vendor documents whether the value survives a resume, clear, compaction or fork.

Verified against

Claude Code hooks and monitoring-usage, Codex hooks and config-advanced, Cursor hooks, Copilot hooks-reference, OpenCode plugins and config schema. One agent per tool, one page per claim, citations recorded in the dashboard repo at aidd_docs/memory/kpi/probes/03-hooks-et-identifiants-session.md.

🤖 Generated with Claude Code

The reference stated Codex CLI has no session-end moment. Codex documents
SessionEnd explicitly, and the wrong claim propagated into a design decision
before anyone re-read the source.

No cell carried a URL or a date, so auditing one claim meant re-verifying all
of them. Every factual cell now carries [v] (read in the official docs on
2026-08-11) or [?] (not re-read, unverified and never to be filled by guess),
with a Sources section listing each page and the two URLs that moved.

Corrections: Codex has SessionEnd; Copilot casing selects the payload format
rather than aliasing an event; failure semantics differ per tool and a Copilot
preToolUse handler that exits non-zero denies the tool call; OpenCode confirmed
plugins-only with no session-end event and no session id in plugin context.

Adds the session-identifier field per tool, the shell-command field per tool,
and the fact that no vendor documents whether that identifier survives a
resume, clear, compaction or fork.

Refs #618

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@alexsoyes
alexsoyes requested a review from a team as a code owner August 11, 2026 22:19
@alexsoyes

Copy link
Copy Markdown
Contributor Author

Closing: this work stays on the dashboard side. The verified matrix and its sources live in the dashboard repo at aidd_docs/memory/kpi/probes/03-hooks-et-identifiants-session.md. Reopen if the framework reference is picked up later.

@alexsoyes alexsoyes closed this Aug 11, 2026
@alexsoyes
alexsoyes deleted the fix/tool-paths-sources branch August 11, 2026 22:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant