This is the record of an abcd-managed repository

abcdBetav0.16.2 · 2026-11-06

Development record

The ingest verb's payload flag is named for its role rather than its content, breaking the house idiom its four siblings follow and colliding with the global rendering flag. The repository's output-contract pattern names the flag after what the JSON CONTAINS: review-json, verdict-json twice, changelog-json. This one is output-json, which names the role instead, and role is exactly the ambiguous axis here because the global json flag means the opposite direction of travel: one is how abcd renders its own result, the other is a path to what an agent returned. The verb's own example shows both on one line, which is where a reader trips. Renaming it to reading-json makes it unambiguous about whose output it is and consistent with the four siblings. The window is now: the verb shipped today and has no users, so the change costs a flag rename and a page regeneration, and the cost rises the moment anything scripts against it.

issueresolvedminoriss-2608311725218136

The ingest verb's payload flag is named for its role rather than its content, breaking the house idiom its four siblings follow and colliding with the global rendering flag. The repository's output-contract pattern names the flag after what the JSON CONTAINS: review-json, verdict-json twice, changelog-json. This one is output-json, which names the role instead, and role is exactly the ambiguous axis here because the global json flag means the opposite direction of travel: one is how abcd renders its own result, the other is a path to what an agent returned. The verb's own example shows both on one line, which is where a reader trips. Renaming it to reading-json makes it unambiguous about whose output it is and consistent with the four siblings. The window is now: the verb shipped today and has no users, so the change costs a flag rename and a page regeneration, and the cost rises the moment anything scripts against it.

Grounds

  • pursued: renaming the payload flag before the verb has users removes the collision with the global rendering flag at the cost of one regeneration; a script or a page still spelling output-json after this would show the sweep incomplete

Frontmatter

idiss-2608311725218136
typeissue
lifecycleresolved
severityminor

mentions1