[docs] Update documentation for features from 2026-05-10

[danielmeppiel]

Documentation Updates - 2026-05-10

This PR updates the documentation based on features merged in the last 24 hours.

Features Documented

• apm update -- new dependency lifecycle command (from Add 'apm update' command and '--frozen' install flag (closes #1203) #1244)
• apm self-update -- CLI self-updater renamed from apm update (from Add 'apm update' command and '--frozen' install flag (closes #1203) #1244)
• apm install --frozen -- CI-safe install flag (from Add 'apm update' command and '--frozen' install flag (closes #1203) #1244)
• No-op nudge: apm install on a satisfied lockfile now hints apm update (from Add 'apm update' command and '--frozen' install flag (closes #1203) #1244)

Changes Made

• Updated docs/src/content/docs/reference/cli-commands.md:
  • Replaced the old apm update (CLI self-updater) section with the new dependency-update command: resolves apm.yml against latest refs, shows a structured plan, prompts [y/N] before any mutation. Flags: --yes, --dry-run, --verbose.
  • Added new apm self-update section covering the old CLI self-updater behavior (including --check, version-checking, distributor guidance, and manual update instructions).
  • Added --frozen flag to apm install options: CI-safe install that exits 1 if apm.lock.yaml is missing or out of sync with apm.yml. Noted mutual exclusion with --update.
  • Marked --update flag on apm install as deprecated; users should prefer apm update.
  • Clarified --force help text: does NOT refresh refs.
  • Added no-op nudge note to apm install Diff-Aware Installation section.

Merged PRs Referenced

• Add 'apm update' command and '--frozen' install flag (closes #1203) #1244 -- Add apm update command and --frozen install flag (closes Install locked until apm.lockfile.yaml removed #1203)
• Reject unsupported flat-format dependencies with actionable error #1189 -- Reject unsupported flat-format dependencies with actionable error (manifest schema already documents the correct format; no doc change needed)
• fix: policy inheritance preserves parent unmanaged_files when child omits block (closes #1198) #1253 -- fix: policy inheritance preserves parent unmanaged_files when child omits block (bug fix; no user-facing API change to document)
• fix: accept full ADO https:// URLs with sub-paths (closes #1128) #1254 -- fix: accept full ADO https:// URLs with sub-paths (bug fix; no user-facing API change to document)

Notes

The packages/apm-guide/.apm/skills/apm-usage/commands.md resource file was already up to date with apm update and apm self-update entries (likely updated in the same PR). No changes needed there.

Note

🔒 Integrity filter blocked 1 item

The following item was blocked because it doesn't meet the GitHub integrity level.

• #1149 search_pull_requests: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".

To allow these resources, lower min-integrity in your GitHub frontmatter:

tools:
  github:
    min-integrity: approved  # merged | approved | unapproved | none

Generated by Daily Documentation Updater · ● 1.2M · ◷

To install this agentic workflow, run

gh aw add githubnext/agentics/workflows/daily-doc-updater.md@b87234850bf9664d198f28a02df0f937d0447295

• expires on May 13, 2026, 6:08 AM UTC

[Copilot]

Pull request overview

Updates the CLI command reference to document the newly introduced dependency lifecycle command surface (apm update, apm self-update, and apm install --frozen) and related install messaging.

Changes:

• Documents apm update as the dependency refresh command (plan + consent gate) and adds a new apm self-update section for CLI binary updates.
• Adds --frozen to apm install and marks --update as deprecated in favor of apm update.
• Notes the no-op install hint that points users to apm update when the lockfile is already satisfied.

Show a summary per file

File	Description
docs/src/content/docs/reference/cli-commands.md	Updates CLI reference docs for apm update / apm self-update semantics, apm install --frozen, and the satisfied-lockfile hint.

Copilot's findings

Comments suppressed due to low confidence (1)

docs/src/content/docs/reference/cli-commands.md:867

• The version-checking snippet says Run apm self-update to upgrade, but the current startup notification hint is still Run apm update to upgrade. Please align the docs with the current CLI output (or update the code and then keep the docs consistent with it).

[!] A new version of APM is available: 0.7.0 (current: 0.6.3)
Run apm self-update to upgrade

• Files reviewed: 1/1 changed files
• Comments generated: 4