docs(config-new): correct 'Zero API calls' claim for scaffold mode - #667
Merged
Conversation
The no-push scaffold mode of `config new` has never been offline: ComponentService.generate_scaffold always fetches the component detail from the AI Service (one read) to derive the schema/examples -- that is exactly what --project authenticates. Only Storage WRITE calls are zero. Corrected in the three surfaces carrying the claim: the command's --help docstring, commands-reference.md, and the historical gotchas.md entry (verified against v0.33.0 sources: the AI Service read was there from the start). The shipped 0.33.0 changelog entry is left untouched as release history. SKILL.md, keboola-expert.md, context.py AGENT_CONTEXT, CLAUDE.md and scaffold-workflow.md never carried the claim.
padak
force-pushed
the
claude/vigorous-proskuriakova-ad5d98
branch
from
August 23, 2026 20:29
1ab2c05 to
f68e2ce
Compare
padak
added a commit
that referenced
this pull request
Aug 23, 2026
* chore(release): 0.90.0 Bumps pyproject.toml to 0.90.0 and adds the changelog entry covering every PR merged since v0.89.0 (#658, #662, #661, #663, #665, #666, #664, #668, #667, #623), resolves the vNEXT placeholders those PRs left behind, and adds the curated What's new reel for the release. * docs(web-server): keep the What's-new anchor stable across releases The '### What's-new popup *(since vNEXT)*' heading put the version gate in the heading itself, so resolving the placeholder to 0.90.0 changed the generated slug to 'whats-new-popup-since-0900' and broke the in-page link at line 138 -- and would have broken it again on every future release. Moved the '(since 0.90.0)' tag to the first body line: the anchor is now the stable 'whats-new-popup', the gate stays visible, and check_version_gates.py still sees it (it scans the whole file, not just headings).
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.
Why
The docs for
config new(default no---pushscaffold mode) claimed "Zero API calls." That has never been true:commands/config.py::config_newcallsComponentService.generate_scaffold, which fetches the component detail from the AI Service (ai_client.get_component_detail) to derive the schema/examples — which is exactly why the--projectoption's own help says "for AI Service auth". Verified against the v0.33.0 sources: the AI Service read was there from the start, so even the "pre-v0.33.0" historical framing in gotchas.md was inaccurate.An AI agent reading "zero API calls" would wrongly conclude the scaffold works offline / without a resolvable project token.
What
Corrected the claim to "no Storage write calls (one AI Service read for the component schema)" in the three surfaces that carried it:
plugins/kbagent/skills/kbagent/references/commands-reference.md— theconfig newentryplugins/kbagent/skills/kbagent/references/gotchas.md— the "pre-v0.33.0 scaffold-only" historical entrysrc/keboola_agent_cli/commands/config.py— the command's--helpdocstringChecked and confirmed clean (claim not present): SKILL.md, keboola-expert.md,
context.pyAGENT_CONTEXT, CLAUDE.md command list, scaffold-workflow.md. The shipped 0.33.0 entry inchangelog.pyrepeats the phrase but is left untouched as release history.Docs-only change: no version bump, no changelog entry (per the #648 release process).
Testing
ruff check+ruff format --checkclean onconfig.pypytest tests/test_cli.py tests/test_config_create_cli.py tests/test_config_create_service.py— 278 passed