Skip to content

Docs-accuracy audit: parser conformance + doc corrections - #148

Merged
navbytes merged 2 commits into
mainfrom
docs-audit-fixes
Aug 30, 2026
Merged

Docs-accuracy audit: parser conformance + doc corrections#148
navbytes merged 2 commits into
mainfrom
docs-audit-fixes

Conversation

@navbytes

Copy link
Copy Markdown
Owner

Deep docs-vs-source audit findings. Parser: JSON opt-in now requires "vee": 1 exactly (else text fallback, as documented); widget cards now require vee_widget: 1 per the published schema (with diagnostic; catalog plugins verified compliant). Docs: trim/emojize defaults in the params table, charts.md precedence wording, accessoryWidth slider mention, streaming-stderr claim in debugging.md, deep-link confirmation notes in cli-and-urls.md, Node floor in faq.md. Full gate + docs guards green.

JSONOutputParser decoded "vee" but never compared it to the declared
version, so any object with a "vee" key — including a mismatched
version — was treated as JSON opt-in instead of falling back to text.
WidgetCardParser never read "vee_widget" at all, though the schema and
docs mark it required. Both now match the schema: an object missing or
disagreeing on the version is rejected (JSON falls back to text
parsing; a widget card is rejected with a diagnostic).
…actions, and Node

- params.json: trim/emojize are on by default like ansi; regenerate
  the generated params table.
- charts.md: accessory precedence is first-wins (progress > sparkline
  > share chart), not last-wins.
- json-output.md: accessoryWidth also sizes a slider, matching the
  params table.
- debugging.md: a streaming plugin's stderr is captured (bounded tail)
  and surfaced in the restart message, not discarded.
- cli-and-urls.md: enableplugin/disableplugin/toggleplugin and an
  href-carrying notify pop a confirmation dialog when triggered via a
  deep link.
- faq.md: TypeScript's floor is Node >= 22.18 (type stripping), not
  24+.
@navbytes
navbytes enabled auto-merge (squash) August 30, 2026 00:47
@navbytes
navbytes merged commit 2e59fc5 into main Aug 30, 2026
7 checks passed
@navbytes
navbytes deleted the docs-audit-fixes branch August 30, 2026 00:49
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant