fix(telemetry): a backlog declaration the report can actually read

[blafourcade]

What

The by_backlog axis rests on one file per task folder — backlog-link.json — and nothing checked that the file was readable. Of the three this repository held, two carried writtenAt / writtenBy while cli/src/infrastructure/adapters/task-backlog-adapter.ts:30 reads written_at / written_by. Those two parsed as nothing.

Measured on the real sink, 30 days

Before:

{"backlog":"ai-driven-dev/framework#694"}    4
{"declaration":"unreadable"}               130
{"declaration":"none"}                    2918

After, same window, same records:

{"backlog":"ai-driven-dev/framework#746"}  133
{"backlog":"ai-driven-dev/framework#694"}    4
{"declaration":"none"}                    2918

The axis was never broken

It reported unreadable truthfully, on its own row, exactly as TaskBacklogDeclaration requires of a file it cannot parse — never folded into "declared nothing". What was missing is anything that reads that row before a person does.

Both wrong files were written by aidd-orchestrator:01-sdlc. Its own 01-frame.md tells it to carry the resolved ticket so that "whichever of Spec or Plan first creates the delivery folder can declare it there". It wrote the file itself instead, and took the field names from the TypeScript interface rather than from what either skill teaches.

The guard is the durable answer rather than a fourth copy of the JSON block in the orchestrator's own reference: a third skill inventing a fourth spelling now fails here, not in a report nobody reads.

The guard

Two cases. The first asserts every tracked backlog-link.json carries the three fields the reader looks for, in the spelling it looks for them. The second asserts those same three names are what aidd-pm:04-spec and aidd-dev:01-plan actually teach — because the reader is a cli/ module and this is a repository script test, so the rule is restated here, and a restatement drifting from the lesson is exactly what produced the two bad files.

Mutations run, both killed:

Mutation	Red
a declaration put back in camelCase	1
a skill stops teaching one of the three fields	1

373 repository script tests pass, 0 broken links in 798 files.

🤖 Generated with Claude Code

https://claude.ai/code/session_01VWNxk63AGKkqE8HRqHLjGp