docs(airmcp): correct starter tool count to ~111 + ignore Codex config#286
Merged
Conversation
The "~125 starter tools" figure was a polluted local measurement that had spread to 5 places — README, docs/ios-architecture, the smoke-mcp and verify-published-package comments, and the tool-count-drift test comment — while the repo's own dump-tool-manifest.mjs already said ~111. Clean-room measurement (env -i, fresh HOME, no AIRMCP_*/GEMINI_*) confirms the default `npx -y airmcp` STARTER surface is 111 tools, four ways: runtime tools/list (env-clean) = 111; runtime with AIRMCP_TEST_MODE=1 = 111 (TEST_MODE only gates shutdown + test-only error helpers, not module registration); starter set composition coherent (the 162 excluded tools are exactly the opt-in modules); and dump-tool-manifest.mjs already says ~111. --full is unchanged: 273 runtime / 272 registerTool headline / 285 manifest superset, still guarded by count-stats + tool-count-drift. No gate ever asserted 125 (smoke/verify floor is >=100), so this was a stale-comment honesty gap surfaced by the RFC 0014 capability-surface work, not a test failure. Tilde kept — the starter subset is a curated soft value with the >=100 smoke floor as its only hard gate. Also gitignore the root AGENTS.md (the Codex twin of the already-ignored CLAUDE.md, carrying the same "Not published" design notes) and .codex/ (the Codex analog of .claude/*). The published agent guide stays tracked at .github/AGENTS.md; the root-anchored /AGENTS.md pattern does not shadow it. Keeps internal design notes out of the public tree. Tests: 123 suites / 1923 pass. stats:check clean.
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
1 participant
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.
The "~125 starter tools" figure was a polluted local measurement that had
spread to 5 places — README, docs/ios-architecture, the smoke-mcp and
verify-published-package comments, and the tool-count-drift test comment —
while the repo's own dump-tool-manifest.mjs already said ~111.
Clean-room measurement (env -i, fresh HOME, no AIRMCP_/GEMINI_) confirms
the default
npx -y airmcpSTARTER surface is 111 tools, four ways:runtime tools/list (env-clean) = 111; runtime with AIRMCP_TEST_MODE=1 = 111
(TEST_MODE only gates shutdown + test-only error helpers, not module
registration); starter set composition coherent (the 162 excluded tools are
exactly the opt-in modules); and dump-tool-manifest.mjs already says ~111.
--full is unchanged: 273 runtime / 272 registerTool headline / 285 manifest
superset, still guarded by count-stats + tool-count-drift. No gate ever
asserted 125 (smoke/verify floor is >=100), so this was a stale-comment
honesty gap surfaced by the RFC 0014 capability-surface work, not a test
failure. Tilde kept — the starter subset is a curated soft value with the
Also gitignore the root AGENTS.md (the Codex twin of the already-ignored
CLAUDE.md, carrying the same "Not published" design notes) and .codex/ (the
Codex analog of .claude/*). The published agent guide stays tracked at
.github/AGENTS.md; the root-anchored /AGENTS.md pattern does not shadow it.
Keeps internal design notes out of the public tree.
Tests: 123 suites / 1923 pass. stats:check clean.