fix: preserve wrapped CLI help in API docs

[notgitika]

Summary

• join wrapped Commander argument and option descriptions during extraction
• normalize generated AsciiDoc for AWS style and China rebranding checks
• add a regression test for wrapped help output

Addresses generated documentation feedback from Amazon CR-290947859.

Testing

• node --test scripts/extract-cli-model.test.mjs
• regenerated the v0.24.2 CLI reference

[agentcore-devx-automation]

Claude Security Review: no high-confidence findings. (run)

[github-actions]

Package Tarball

aws-agentcore-0.24.2.tgz

How to install

gh release download pr-1826-tarball --repo aws/agentcore-cli --pattern "*.tgz" --dir /tmp/pr-tarball
npm install -g /tmp/pr-tarball/aws-agentcore-0.24.2.tgz

[notgitika]

@strandly-the-agent review

[strandly-the-agent]

TL;DR — changes requested: the wrapped-help fix works, but the shared renderer can corrupt Optional … prose and the new regression test is not part of any automated test target.

✅ Reviewed 642f2f5; direct Node test 1/1, Python compile, build, and end-to-end generation (6 groups / 30 entries / 139 params) passed.
🔴 format:check still fails on the new test file; CI already identifies the formatting fix.
⚠️ The separate ai-review failure occurred during runner setup before review execution; the remaining build/test/security checks pass.

Review breakdown

• Correctness/docs: one deterministic cross-source wording regression.
• Test quality: the parser regression test passes directly but is absent from package/CI test targets.
• Suppressed: the memory-strategy wording concern did not reproduce against real inputs; no other escaping or parser defect was found.

No API or model-context pass was needed: these are internal documentation-generation scripts.

[strandly-the-agent]

🟡 This global rewrite breaks valid plural and mass-noun descriptions from the renderer's other supported sources. I reproduced Optional tags. → An optional tags. and Optional additional task metadata → An optional additional task metadata; every parameter reaches this rule via render_params(). Could we preserve Optional, or make the rewrite noun-aware, and add an exact renderer test for those cases plus the intended {aws} output?

[strandly-the-agent]

🟡 The regression test passes with node --test, but no repository test target runs it: the unit project only discovers src/**/*.test.ts(x), and the package test scripts invoke Vitest. I confirmed Vitest reports this file as “No test files found.” Please wire it into a CI-invoked script/workflow or convert/move it into the discovered suite so this regression remains enforced.

[agentcore-devx-automation]

Claude Security Review: no high-confidence findings. (run)