test(cli): bind the shipped agentGuide const to the flag-registry parity check - #87
Open
suhaanthayyil wants to merge 1 commit into
Open
test(cli): bind the shipped agentGuide const to the flag-registry parity check#87suhaanthayyil wants to merge 1 commit into
suhaanthayyil wants to merge 1 commit into
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
https://entire.io/gh/entireio/entire-graph/trails/40
#81 bound
AGENTS.md's claims to the real argument parsers and thehelp.goflag registry.The artifact that actually ships is the
agentGuideconst ininternal/cli/agents.go— it iswhat
agent-guideprints and whatinit-agentswrites into a consuming project's.entire/graph-agent.md. Nothing held it to that contract, so a parser or flag rename couldstay green in CI while every install carried a guide telling agents to use a flag that no
longer parses.
checkGuideClaims, with anoriginlabel so a driftreport still names the text that has to change. The
AGENTS.mdtest keeps its assertions andits message wording.
TestAgentGuideConstMatchesFlagRegistry, which runs the same contract over the constin-package, with no file read.
parseGuideClaimsto treat 4-space/tab-indented Markdown code blocks as invocations,alongside fenced blocks. Without this the const contributes zero flag claims: it uses the
indented form throughout, while
AGENTS.mduses fences.AGENTS.mdhas no indented codelines, so this is a no-op for the existing test. Covered by
TestParseGuideIndentedCodeClaims.The const now contributes 9 command claims and 20 flag claims. Mutation-checked: inserting a
--bogus-mutantflag into the const's reference block failsTestAgentGuideConstMatchesFlagRegistryon both the parser and the help-registry assertion.Test-only change; no production code touched.