Repository navigation
Open
Labels
area/docs-sitedocs/src/content (Starlight), README, doc generation.docs/src/content (Starlight), README, doc generation.status/acceptedHuman scope approval; verify the issue's approval record and review contact before work.Human scope approval; verify the issue's approval record and review contact before work.type/docsDocumentation change (prose, examples, generated reference).Documentation change (prose, examples, generated reference).
Milestone
Description
Before the 0.37 release, the docs site (docs/src/content/docs/), CLI help strings and the apm-usage skill (packages/apm-guide/.apm/skills/apm-usage/) must truthfully describe 0.37 behaviour.
Scope
A regrounding pass (docs-corpus-audit) against current main, focused on the 0.37 delta in CHANGELOG.md [Unreleased] and merged PRs in milestone 0.37.0:
vscode->copilotalias and root.mcp.json(feat!: Copilot project MCP in root .mcp.json; vscode a deprecated alias; drop apm manifest migrate #3875)target:deprecation and the exacttargets:replacement (feat(manifest): deprecate target: and add apm manifest migrate #3801, feat!: Copilot project MCP in root .mcp.json; vscode a deprecated alias; drop apm manifest migrate #3875)intellijrefusal as a recorded target (fix(manifest): bootstrap never writes unreadable targets; plain dependency and target errors #3873, fix(manifest): extract the bootstrap manifest owner; refuse IDE targets in apm.yml #3882)- lock-first marketplace replay and
--frozen(fix(install): replay locked marketplace dependencies from the lockfile #3915, fix: derive install expected state from the lock #3900, fix(install): --frozen applies the executables gate and MCP omission evidence #3938) - marketplace origin in the lock and the rebound-alias failure (fix(marketplace): record catalog origin in the lock; fail closed on rebound aliases #3917)
- the dependency-confusion check on every install path (fix(marketplace): apply the #1326 dependency-confusion check on every install path #3923, fix(install): reject one owner/repo from two hosts before fetching (#3696) #3895)
--refresh/apm updatemarketplace revalidation (fix(marketplace): explicit refresh revalidates catalogs or fails (#3279) #3910)- refusal of lockfiles written by a newer APM (fix(lockfile): refuse lockfiles written by a newer APM (#2334) #3916)
- Codex
.codex-plugin/plugin.jsoninapm pack(feat(pack): generate .codex-plugin/plugin.json for targets: [codex] #3906) - uninstall of object-form marketplace dependencies (fix(uninstall): remove object-form marketplace entries by plugin@marketplace #3933)
- the ADOPTERS issue form (docs(adopters): no-ceremony path and an adopter issue form #3935)
- OpenAPM 0.1.65 native activation profile (docs(spec): add the OpenAPM native plugin activation profile (#3919) #3929)
Done when
- Every page and
apm-usageresource that touches the items above matches 0.37 source behaviour, with surgical edits only. - At most about 3 PRs, grouped by area, each linking this issue.
- README drift is listed for the maintainer, not edited.
- Code defects found (code contradicts correct docs) are reported to the coordinator, not fixed here.
Out of scope
- Pages owned by in-flight feat(security): portable, content-pinned approval for dependency executables (#3902) #3918 and fix(claude): install intact user plugins through Claude settings, owned by the lock #3290 until they land; after that, only the drift they leave behind.
README.mdedits, code changes, IA/TOC restructuring.
Metadata
Metadata
Assignees
Labels
area/docs-sitedocs/src/content (Starlight), README, doc generation.docs/src/content (Starlight), README, doc generation.status/acceptedHuman scope approval; verify the issue's approval record and review contact before work.Human scope approval; verify the issue's approval record and review contact before work.type/docsDocumentation change (prose, examples, generated reference).Documentation change (prose, examples, generated reference).
Type
Projects
- StatusShow more project fieldsNo status
Activity
danielmeppiel commentedon Nov 19, 2026
Decision: approve
Area: project
Scope: Before the 0.37 release, reground the docs site (docs/src/content/docs/), CLI help strings and the apm-usage skill against current main for the 0.37 delta listed in this issue body. Surgical edits only; at most about 3 PRs grouped by area, each linking this issue.
Done when: Every page and apm-usage resource touching the listed 0.37 items matches source behaviour. README drift is listed for the maintainer, not edited. Code defects are reported to the coordinator, not fixed here. Pages owned by #3918 and #3290 are rechecked after those land.
Out of scope: README.md edits; code changes; IA/TOC restructuring.
Review contact: Daniel Meppiel (@danielmeppiel)
docs(reference): reground CLI reference, apm-usage and help text for …
docs: reground consumer, producer, integration and troubleshooting gu…
docs: reground pages freed by #3918 and leftover 0.37 drift (#3982)