Skip to content

docs(telemetry): the README says what 00-init runs and what OpenCode cannot - #871

Merged
blafourcade merged 1 commit into
nextfrom
docs/telemetry-readme-truth
Sep 16, 2026
Merged

blafourcade merged 1 commit into
nextfrom
docs/telemetry-readme-truth

Conversation

@blafourcade

Copy link
Copy Markdown
Contributor

What

Two claims in the telemetry plugin README were false, and both read as a capability rather than a limit.

  • 00-init never runs check. Its actions are: confirm the CLI, ask then enable, then prove a session is recorded by reading a run file back (skills/00-init/actions/03-verify.md). Its transversal rule allows only on --yes, off, and the identity / forget verbs. The table said "aidd telemetry on, then check".
  • OpenCode gives no step. Its profile declares stepStart: null (hooks/lib/tools/opencode.cjs:11) and its plugin forwards task paths only, so no skill invocation ever reaches the journal. The coverage table gave it a step "through its own plugin API".

A limit a reader has to look up gets read as a zero, so the OpenCode one joins the named limits instead of living in a table cell.

Evidence

Measured on a live OpenCode session during the #812 work: the journal carried session_start, task_declared and turn_end, and no step_start.

Gates

447 repository script tests, unchanged before and after this edit: the 11 red ones fail with Cannot find module 'js-yaml' / ajv because this worktree has no node_modules, not because of this change. Docs only, no code touched.

🤖 Generated with Claude Code

https://claude.ai/code/session_01VWNxk63AGKkqE8HRqHLjGp

…cannot

Two claims in the plugin README were false, and both read as a capability.

`00-init` never runs `check`: its actions are check the CLI, enable, then prove
a session is journalled by reading a run file back. The table said "then check".

OpenCode gives no step: its profile declares `stepStart: null`, and its plugin
forwards task paths only, so no skill invocation ever reaches the journal. The
coverage table gave it a step, and a limit a reader has to look up reads as a
zero, so it is named with the others.

Co-Authored-By: Claude Opus 5 <[email protected]>
Claude-Session: https://claude.ai/code/session_01VWNxk63AGKkqE8HRqHLjGp
AIDD-Session-Id: 2c21d903-3a7e-47ac-83f8-d8b7ae3aa579
@blafourcade
blafourcade requested a review from a team as a code owner September 16, 2026 03:13
@blafourcade
blafourcade merged commit 83b0246 into next Sep 16, 2026
5 checks passed
@blafourcade
blafourcade deleted the docs/telemetry-readme-truth branch September 16, 2026 03:13
@aidd-bot aidd-bot Bot mentioned this pull request Sep 24, 2026
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