[docs] Update documentation for features from 2026-04-29

[danielmeppiel]

Documentation Updates - 2026-04-29

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

Features Documented

• apm marketplace add manifest.name alias resolution (from fix(marketplace): add honors manifest.name for Claude Code parity #1032)

Changes Made

• Updated docs/src/content/docs/guides/marketplaces.md -- new "Default alias resolution" subsection explaining the 3-tier precedence (--name > manifest.name > repo name), with a concrete Claude Code parity example
• Updated CHANGELOG.md -- added [Unreleased] Fixed entry for fix(marketplace): add honors manifest.name for Claude Code parity #1032

Merged PRs Referenced

• fix(shared/apm): repair gh-aw [a b] import-input serialization that breaks apm-prep #1033 -- fix(shared/apm): repair gh-aw [a b] import-input serialization (internal workflow fix, no user-facing doc needed)
• fix(marketplace): add honors manifest.name for Claude Code parity #1032 -- fix(marketplace): add honors manifest.name for Claude Code parity (documented here)
• fix(install): ADO Entra ID auth path + --update pre-flight abort (#1015) #1031 -- fix(install): ADO Entra ID auth path + --update pre-flight abort (docs and CHANGELOG already updated in that PR)
• fix(workflows): skip-don't-fail panel label gate; bump gh-aw v0.68.3 -> v0.71.1 #1030 -- fix(workflows): skip-don't-fail panel label gate; bump gh-aw (internal CI fix, no user-facing doc needed)

Notes

PR #1031 already updated docs/src/content/docs/getting-started/authentication.md with the ADO Entra ID and --update pre-flight sections, so no additional auth doc changes are needed here.

Note

🔒 Integrity filter blocked 5 items

The following items were blocked because they don't meet the GitHub integrity level.

• #1000 search_pull_requests: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• #996 search_pull_requests: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• #987 search_pull_requests: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• #861 search_pull_requests: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".
• #803 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 · ● 668.5K · ◷

To install this agentic workflow, run

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

• expires on May 1, 2026, 1:09 PM UTC

[Copilot]

Pull request overview

Documentation update to reflect the recently-merged change to apm marketplace add alias resolution so that it honors the name field from the fetched marketplace.json, improving parity with Claude Code marketplace instructions.

Changes:

• Documented default marketplace alias resolution behavior (manifest name -> repo name fallback) in the marketplaces guide.
• Added a corresponding [Unreleased] Fixed entry to the changelog for #1032.

Show a summary per file

File	Description
docs/src/content/docs/guides/marketplaces.md	Adds a new subsection describing default alias resolution and updates the --name option description.
CHANGELOG.md	Adds an Unreleased Fixed bullet documenting the #1032 behavior change.

Copilot's findings

• Files reviewed: 2/2 changed files
• Comments generated: 2

[Copilot]

The example hint output shows apm install @addy-agent-skills, but the CLI prints Install plugins with: apm install <plugin>@<alias> (with the plugin name before @). As written, the documented command is not valid and may mislead users; update the snippet to match the actual hint format.

Suggested change

	[i] Install plugins with: apm install @addy-agent-skills
	[i] Install plugins with: apm install code-review@addy-agent-skills

[Copilot]

In this section you refer to the name field in marketplace.json, but the option description says it defaults to manifest.name. For consistency and clarity (especially for readers who only know the file format), consider describing the default in terms of the marketplace.json name field rather than the internal model property name.

Suggested change

	- `--name/-n` -- Override the local alias (defaults to `manifest.name`, then repo name)
	- `--name/-n` -- Override the local alias (defaults to the `marketplace.json` `name` field, then repo name)