@unbrained/pm-cli 2026.5.6 → 2026.5.11

package/dist/cli/guide-topics.js

@@ -0,0 +1,283 @@
+function normalizeTopicToken(value) {
+    return value.trim().toLowerCase().replaceAll("_", "-");
+}
+const GUIDE_TOPICS = [
+    {
+        id: "quickstart",
+        aliases: ["start", "getting-started", "bootstrap"],
+        title: "Quickstart",
+        summary: "Initialize a tracker and run the shortest safe plan -> execute -> close loop.",
+        intent: "Use this when a human or agent needs to start productive work quickly with minimal context load.",
+        commands: [
+            "pm init",
+            "pm context --limit 10",
+            "pm list-open --limit 20",
+            "pm create --create-mode progressive --title \"...\" --description \"...\" --type Task",
+            "pm claim <ID>",
+            "pm update <ID> --status in_progress",
+            "pm close <ID> \"<reason with evidence>\" --validate-close warn",
+        ],
+        workflows: [
+            {
+                name: "Start Session Safely",
+                goal: "Bootstrap without mutating unrelated state.",
+                prompt: "You are bootstrapping pm work. Use a token-efficient context snapshot first, then select one open item, claim it, and only then mutate.",
+                commands: ["pm context --limit 10", "pm list-open --limit 20", "pm claim <ID>"],
+            },
+        ],
+        docs: [
+            { path: "README.md", purpose: "High-level project and install entrypoint." },
+            { path: "docs/QUICKSTART.md", purpose: "Short setup and first-command walkthrough." },
+            { path: "docs/COMMANDS.md", purpose: "Task-oriented command recipes." },
+        ],
+        related: ["commands", "workflows", "release"],
+    },
+    {
+        id: "commands",
+        aliases: ["cli", "operations", "reference"],
+        title: "CLI Command Routing",
+        summary: "Find the right command family quickly and use command-scoped help/contracts output.",
+        intent: "Use this when selecting command paths, flags, and output formats for implementation or automation.",
+        commands: [
+            "pm --help",
+            "pm <command> --help",
+            "pm <command> --help --explain",
+            "pm contracts --command <command> --flags-only",
+            "pm contracts --command <command> --availability-only --runtime-only",
+            "pm completion <bash|zsh|fish>",
+        ],
+        workflows: [
+            {
+                name: "Flag Discovery",
+                goal: "Resolve command flags deterministically before mutations.",
+                prompt: "You are preparing to run a command. Use help and contracts surfaces to verify required/optional flags before execution.",
+                commands: ["pm <command> --help --explain", "pm contracts --command <command> --flags-only"],
+            },
+        ],
+        docs: [
+            { path: "docs/COMMANDS.md", purpose: "Command grouping and examples." },
+            { path: "docs/CONFIGURATION.md", purpose: "Project/global settings and policy controls." },
+            { path: "docs/TESTING.md", purpose: "Linked-test orchestration and safety guidance." },
+        ],
+        related: ["quickstart", "workflows", "sdk", "extensions"],
+    },
+    {
+        id: "workflows",
+        aliases: ["developer", "maintainer", "agent"],
+        title: "Developer and Agent Workflows",
+        summary: "Apply canonical claim -> execute -> verify -> close workflows with append-only evidence.",
+        intent: "Use this for day-to-day coding-agent execution loops and handoff-safe updates.",
+        commands: [
+            "pm claim <ID>",
+            "pm update <ID> --status in_progress",
+            "pm files <ID> --add ...",
+            "pm test <ID> --add ...",
+            "pm comments <ID> \"...\"",
+            "pm validate --check-resolution --check-history-drift",
+            "pm release <ID>",
+        ],
+        workflows: [
+            {
+                name: "Execution Loop",
+                goal: "Keep code, tests, and tracker evidence synchronized.",
+                prompt: "You are implementing a scoped change. Claim first, link files/tests/docs as you go, append evidence comments, and close only after validation.",
+                commands: [
+                    "pm claim <ID>",
+                    "pm update <ID> --status in_progress",
+                    "pm files <ID> --add path=<file>,scope=project",
+                    "pm test <ID> --run --progress",
+                    "pm close <ID> \"<evidence>\" --validate-close warn",
+                ],
+            },
+        ],
+        docs: [
+            { path: "AGENTS.md", purpose: "Repository operating rules and required workflow." },
+            { path: "docs/AGENT_GUIDE.md", purpose: "Agent-oriented usage and context strategy." },
+            { path: "docs/TESTING.md", purpose: "Sandbox-safe test execution rules." },
+        ],
+        related: ["quickstart", "commands", "skills"],
+    },
+    {
+        id: "sdk",
+        aliases: ["api", "typescript-sdk"],
+        title: "SDK and Integrations",
+        summary: "Use the published SDK surface for extension authoring and contract-safe integrations.",
+        intent: "Use this when building or reviewing programmatic integrations against @unbrained/pm-cli/sdk.",
+        commands: [
+            "pm contracts --schema-only",
+            "pm contracts --command extension --flags-only",
+            "pm contracts --runtime-only --availability-only",
+        ],
+        workflows: [
+            {
+                name: "Integration Contract Check",
+                goal: "Confirm action schemas and runtime availability before coding.",
+                prompt: "You are wiring an integration. Capture schema + runtime availability first, then map your adapter payload fields to contract keys.",
+                commands: [
+                    "pm contracts --schema-only",
+                    "pm contracts --availability-only --runtime-only",
+                    "pm contracts --command <command> --flags-only",
+                ],
+            },
+        ],
+        docs: [
+            { path: "docs/SDK.md", purpose: "Public SDK exports and extension authoring references." },
+            { path: "docs/ARCHITECTURE.md", purpose: "Core runtime composition and extension load flow." },
+        ],
+        related: ["extensions", "commands"],
+    },
+    {
+        id: "extensions",
+        aliases: ["plugins", "extension-authoring"],
+        title: "Extensions",
+        summary: "Install, author, and diagnose extensions with deterministic lifecycle controls.",
+        intent: "Use this for extension management, capability registration, and runtime diagnostics.",
+        commands: [
+            "pm extension explore --project",
+            "pm extension install <target> --project",
+            "pm extension manage --detail summary",
+            "pm extension doctor --detail deep",
+            "pm extension activate <target> --project",
+            "pm extension deactivate <target> --project",
+        ],
+        workflows: [
+            {
+                name: "Lifecycle Triage",
+                goal: "Diagnose extension state before forceful lifecycle actions.",
+                prompt: "You are debugging extension behavior. Inspect managed state first, then run doctor diagnostics, then apply install/adopt/activate actions.",
+                commands: [
+                    "pm extension explore --project",
+                    "pm extension manage --detail summary",
+                    "pm extension doctor --detail deep",
+                ],
+            },
+        ],
+        docs: [
+            { path: "docs/EXTENSIONS.md", purpose: "Capability model and lifecycle command usage." },
+            {
+                path: "docs/examples/starter-extension/README.md",
+                purpose: "Starter extension scaffold and local development path.",
+            },
+            { path: "docs/SDK.md", purpose: "SDK contracts used by extension implementations." },
+        ],
+        related: ["sdk", "commands", "skills"],
+    },
+    {
+        id: "skills",
+        aliases: ["agent-skills", "agentskills"],
+        title: "Agent Skills",
+        summary: "Skill bundles for developer, user, extensions, and sdk workflows aligned to the current CLI.",
+        intent: "Use this when an agent needs reproducible prompts/workflows with strict compatibility metadata.",
+        commands: [
+            "pm guide skills --depth deep",
+            "pm contracts --command guide --flags-only",
+            "pm validate --check-command-references",
+        ],
+        workflows: [
+            {
+                name: "Skill Selection",
+                goal: "Pick the narrowest compatible skill first to minimize context usage.",
+                prompt: "Select a pm skill based on the task intent, then execute only the workflow section needed for the current change.",
+                commands: ["pm guide skills", "pm guide skills --depth deep"],
+            },
+        ],
+        docs: [
+            { path: "docs/AGENT_GUIDE.md", purpose: "Agent-first usage and context model." },
+            { path: "docs/README.md", purpose: "Documentation routing with progressive disclosure." },
+            { path: ".agents/skills/README.md", purpose: "Agent skills index and routing overview." },
+            { path: ".agents/skills/pm-developer/SKILL.md", purpose: "Developer-oriented pm skill workflow." },
+            { path: ".agents/skills/pm-user/SKILL.md", purpose: "User/operator pm skill workflow." },
+            { path: ".agents/skills/pm-extensions/SKILL.md", purpose: "Extension-focused pm skill workflow." },
+            { path: ".agents/skills/pm-sdk/SKILL.md", purpose: "SDK integration pm skill workflow." },
+        ],
+        related: ["workflows", "harnesses", "commands"],
+    },
+    {
+        id: "harnesses",
+        aliases: ["compatibility", "agent-compatibility"],
+        title: "Agent Harness Compatibility",
+        summary: "Cross-harness compatibility guidance for skill discovery, prompts, and docs routing.",
+        intent: "Use this when adapting pm skills/docs usage for Pi, OpenClaw, Claude Code, Codex CLI, OpenCode, Amp, Droid, Hermes, or Gemini CLI.",
+        commands: ["pm guide skills", "pm guide commands", "pm contracts --runtime-only --availability-only"],
+        workflows: [
+            {
+                name: "Harness Mapping",
+                goal: "Route each harness to the same canonical skill/docs sources.",
+                prompt: "Map harness-specific entrypoints to the same pm guide topics and .agents/skills workflows without adding runtime harness-specific code.",
+                commands: ["pm guide harnesses --depth standard", "pm guide skills --depth deep"],
+            },
+        ],
+        docs: [
+            { path: "docs/AGENT_GUIDE.md", purpose: "Agent context and output-mode conventions." },
+            { path: "docs/README.md", purpose: "Single-source documentation routing entrypoint." },
+            { path: ".agents/skills/HARNESS_COMPATIBILITY.md", purpose: "Harness compatibility matrix and usage notes." },
+        ],
+        related: ["skills", "workflows"],
+    },
+    {
+        id: "release",
+        aliases: ["gates", "ship", "release-readiness"],
+        title: "Release and Staleness Gates",
+        summary: "Run release gates and docs/skills freshness checks before publishing.",
+        intent: "Use this when validating release readiness and preventing docs/skills drift.",
+        commands: [
+            "pnpm build",
+            "pnpm test:coverage",
+            "pnpm quality:static",
+            "node scripts/release/run-gates.mjs --telemetry-mode best-effort",
+            "pnpm security:scan",
+        ],
+        workflows: [
+            {
+                name: "Pre-Release Gate Sweep",
+                goal: "Ensure code, docs, and skills are all green before publish.",
+                prompt: "Run release gates in deterministic order and treat docs/skills freshness failures as release blockers.",
+                commands: [
+                    "pnpm build",
+                    "pnpm test:coverage",
+                    "node scripts/release/run-gates.mjs --telemetry-mode best-effort",
+                ],
+            },
+        ],
+        docs: [
+            { path: "docs/RELEASING.md", purpose: "Release flow and safety checks." },
+            { path: "CHANGELOG.md", purpose: "Versioned release history and unreleased notes." },
+            { path: "scripts/release/run-gates.mjs", purpose: "Source of truth for release gate ordering." },
+        ],
+        related: ["commands", "skills", "workflows"],
+    },
+];
+const TOPIC_BY_TOKEN = new Map();
+for (const topic of GUIDE_TOPICS) {
+    TOPIC_BY_TOKEN.set(topic.id, topic);
+    for (const alias of topic.aliases) {
+        TOPIC_BY_TOKEN.set(alias, topic);
+    }
+}
+export function listGuideTopics() {
+    return GUIDE_TOPICS.map((topic) => ({
+        ...topic,
+        aliases: [...topic.aliases],
+        commands: [...topic.commands],
+        workflows: topic.workflows.map((workflow) => ({
+            ...workflow,
+            commands: [...workflow.commands],
+        })),
+        docs: topic.docs.map((doc) => ({ ...doc })),
+        related: [...topic.related],
+    }));
+}
+export function listGuideTopicIds() {
+    return GUIDE_TOPICS.map((topic) => topic.id);
+}
+export function resolveGuideTopic(rawTopic) {
+    if (!rawTopic) {
+        return null;
+    }
+    const normalized = normalizeTopicToken(rawTopic);
+    if (!normalized) {
+        return null;
+    }
+    return TOPIC_BY_TOKEN.get(normalized) ?? null;
+}
+//# sourceMappingURL=guide-topics.js.map

package/dist/cli/guide-topics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guide-topics.js","sourceRoot":"/","sources":["cli/guide-topics.ts"],"names":[],"mappings":"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","sourcesContent":["export interface GuideDocReference {\n  path: string;\n  purpose: string;\n  optional?: boolean;\n}\n\nexport interface GuideWorkflowTemplate {\n  name: string;\n  goal: string;\n  prompt: string;\n  commands: string[];\n}\n\nexport interface GuideTopicDefinition {\n  id: string;\n  aliases: string[];\n  title: string;\n  summary: string;\n  intent: string;\n  commands: string[];\n  workflows: GuideWorkflowTemplate[];\n  docs: GuideDocReference[];\n  related: string[];\n}\n\nfunction normalizeTopicToken(value: string): string {\n  return value.trim().toLowerCase().replaceAll(\"_\", \"-\");\n}\n\nconst GUIDE_TOPICS: GuideTopicDefinition[] = [\n  {\n    id: \"quickstart\",\n    aliases: [\"start\", \"getting-started\", \"bootstrap\"],\n    title: \"Quickstart\",\n    summary: \"Initialize a tracker and run the shortest safe plan -> execute -> close loop.\",\n    intent: \"Use this when a human or agent needs to start productive work quickly with minimal context load.\",\n    commands: [\n      \"pm init\",\n      \"pm context --limit 10\",\n      \"pm list-open --limit 20\",\n      \"pm create --create-mode progressive --title \\\"...\\\" --description \\\"...\\\" --type Task\",\n      \"pm claim <ID>\",\n      \"pm update <ID> --status in_progress\",\n      \"pm close <ID> \\\"<reason with evidence>\\\" --validate-close warn\",\n    ],\n    workflows: [\n      {\n        name: \"Start Session Safely\",\n        goal: \"Bootstrap without mutating unrelated state.\",\n        prompt:\n          \"You are bootstrapping pm work. Use a token-efficient context snapshot first, then select one open item, claim it, and only then mutate.\",\n        commands: [\"pm context --limit 10\", \"pm list-open --limit 20\", \"pm claim <ID>\"],\n      },\n    ],\n    docs: [\n      { path: \"README.md\", purpose: \"High-level project and install entrypoint.\" },\n      { path: \"docs/QUICKSTART.md\", purpose: \"Short setup and first-command walkthrough.\" },\n      { path: \"docs/COMMANDS.md\", purpose: \"Task-oriented command recipes.\" },\n    ],\n    related: [\"commands\", \"workflows\", \"release\"],\n  },\n  {\n    id: \"commands\",\n    aliases: [\"cli\", \"operations\", \"reference\"],\n    title: \"CLI Command Routing\",\n    summary: \"Find the right command family quickly and use command-scoped help/contracts output.\",\n    intent: \"Use this when selecting command paths, flags, and output formats for implementation or automation.\",\n    commands: [\n      \"pm --help\",\n      \"pm <command> --help\",\n      \"pm <command> --help --explain\",\n      \"pm contracts --command <command> --flags-only\",\n      \"pm contracts --command <command> --availability-only --runtime-only\",\n      \"pm completion <bash|zsh|fish>\",\n    ],\n    workflows: [\n      {\n        name: \"Flag Discovery\",\n        goal: \"Resolve command flags deterministically before mutations.\",\n        prompt:\n          \"You are preparing to run a command. Use help and contracts surfaces to verify required/optional flags before execution.\",\n        commands: [\"pm <command> --help --explain\", \"pm contracts --command <command> --flags-only\"],\n      },\n    ],\n    docs: [\n      { path: \"docs/COMMANDS.md\", purpose: \"Command grouping and examples.\" },\n      { path: \"docs/CONFIGURATION.md\", purpose: \"Project/global settings and policy controls.\" },\n      { path: \"docs/TESTING.md\", purpose: \"Linked-test orchestration and safety guidance.\" },\n    ],\n    related: [\"quickstart\", \"workflows\", \"sdk\", \"extensions\"],\n  },\n  {\n    id: \"workflows\",\n    aliases: [\"developer\", \"maintainer\", \"agent\"],\n    title: \"Developer and Agent Workflows\",\n    summary: \"Apply canonical claim -> execute -> verify -> close workflows with append-only evidence.\",\n    intent: \"Use this for day-to-day coding-agent execution loops and handoff-safe updates.\",\n    commands: [\n      \"pm claim <ID>\",\n      \"pm update <ID> --status in_progress\",\n      \"pm files <ID> --add ...\",\n      \"pm test <ID> --add ...\",\n      \"pm comments <ID> \\\"...\\\"\",\n      \"pm validate --check-resolution --check-history-drift\",\n      \"pm release <ID>\",\n    ],\n    workflows: [\n      {\n        name: \"Execution Loop\",\n        goal: \"Keep code, tests, and tracker evidence synchronized.\",\n        prompt:\n          \"You are implementing a scoped change. Claim first, link files/tests/docs as you go, append evidence comments, and close only after validation.\",\n        commands: [\n          \"pm claim <ID>\",\n          \"pm update <ID> --status in_progress\",\n          \"pm files <ID> --add path=<file>,scope=project\",\n          \"pm test <ID> --run --progress\",\n          \"pm close <ID> \\\"<evidence>\\\" --validate-close warn\",\n        ],\n      },\n    ],\n    docs: [\n      { path: \"AGENTS.md\", purpose: \"Repository operating rules and required workflow.\" },\n      { path: \"docs/AGENT_GUIDE.md\", purpose: \"Agent-oriented usage and context strategy.\" },\n      { path: \"docs/TESTING.md\", purpose: \"Sandbox-safe test execution rules.\" },\n    ],\n    related: [\"quickstart\", \"commands\", \"skills\"],\n  },\n  {\n    id: \"sdk\",\n    aliases: [\"api\", \"typescript-sdk\"],\n    title: \"SDK and Integrations\",\n    summary: \"Use the published SDK surface for extension authoring and contract-safe integrations.\",\n    intent: \"Use this when building or reviewing programmatic integrations against @unbrained/pm-cli/sdk.\",\n    commands: [\n      \"pm contracts --schema-only\",\n      \"pm contracts --command extension --flags-only\",\n      \"pm contracts --runtime-only --availability-only\",\n    ],\n    workflows: [\n      {\n        name: \"Integration Contract Check\",\n        goal: \"Confirm action schemas and runtime availability before coding.\",\n        prompt:\n          \"You are wiring an integration. Capture schema + runtime availability first, then map your adapter payload fields to contract keys.\",\n        commands: [\n          \"pm contracts --schema-only\",\n          \"pm contracts --availability-only --runtime-only\",\n          \"pm contracts --command <command> --flags-only\",\n        ],\n      },\n    ],\n    docs: [\n      { path: \"docs/SDK.md\", purpose: \"Public SDK exports and extension authoring references.\" },\n      { path: \"docs/ARCHITECTURE.md\", purpose: \"Core runtime composition and extension load flow.\" },\n    ],\n    related: [\"extensions\", \"commands\"],\n  },\n  {\n    id: \"extensions\",\n    aliases: [\"plugins\", \"extension-authoring\"],\n    title: \"Extensions\",\n    summary: \"Install, author, and diagnose extensions with deterministic lifecycle controls.\",\n    intent: \"Use this for extension management, capability registration, and runtime diagnostics.\",\n    commands: [\n      \"pm extension explore --project\",\n      \"pm extension install <target> --project\",\n      \"pm extension manage --detail summary\",\n      \"pm extension doctor --detail deep\",\n      \"pm extension activate <target> --project\",\n      \"pm extension deactivate <target> --project\",\n    ],\n    workflows: [\n      {\n        name: \"Lifecycle Triage\",\n        goal: \"Diagnose extension state before forceful lifecycle actions.\",\n        prompt:\n          \"You are debugging extension behavior. Inspect managed state first, then run doctor diagnostics, then apply install/adopt/activate actions.\",\n        commands: [\n          \"pm extension explore --project\",\n          \"pm extension manage --detail summary\",\n          \"pm extension doctor --detail deep\",\n        ],\n      },\n    ],\n    docs: [\n      { path: \"docs/EXTENSIONS.md\", purpose: \"Capability model and lifecycle command usage.\" },\n      {\n        path: \"docs/examples/starter-extension/README.md\",\n        purpose: \"Starter extension scaffold and local development path.\",\n      },\n      { path: \"docs/SDK.md\", purpose: \"SDK contracts used by extension implementations.\" },\n    ],\n    related: [\"sdk\", \"commands\", \"skills\"],\n  },\n  {\n    id: \"skills\",\n    aliases: [\"agent-skills\", \"agentskills\"],\n    title: \"Agent Skills\",\n    summary: \"Skill bundles for developer, user, extensions, and sdk workflows aligned to the current CLI.\",\n    intent: \"Use this when an agent needs reproducible prompts/workflows with strict compatibility metadata.\",\n    commands: [\n      \"pm guide skills --depth deep\",\n      \"pm contracts --command guide --flags-only\",\n      \"pm validate --check-command-references\",\n    ],\n    workflows: [\n      {\n        name: \"Skill Selection\",\n        goal: \"Pick the narrowest compatible skill first to minimize context usage.\",\n        prompt:\n          \"Select a pm skill based on the task intent, then execute only the workflow section needed for the current change.\",\n        commands: [\"pm guide skills\", \"pm guide skills --depth deep\"],\n      },\n    ],\n    docs: [\n      { path: \"docs/AGENT_GUIDE.md\", purpose: \"Agent-first usage and context model.\" },\n      { path: \"docs/README.md\", purpose: \"Documentation routing with progressive disclosure.\" },\n      { path: \".agents/skills/README.md\", purpose: \"Agent skills index and routing overview.\" },\n      { path: \".agents/skills/pm-developer/SKILL.md\", purpose: \"Developer-oriented pm skill workflow.\" },\n      { path: \".agents/skills/pm-user/SKILL.md\", purpose: \"User/operator pm skill workflow.\" },\n      { path: \".agents/skills/pm-extensions/SKILL.md\", purpose: \"Extension-focused pm skill workflow.\" },\n      { path: \".agents/skills/pm-sdk/SKILL.md\", purpose: \"SDK integration pm skill workflow.\" },\n    ],\n    related: [\"workflows\", \"harnesses\", \"commands\"],\n  },\n  {\n    id: \"harnesses\",\n    aliases: [\"compatibility\", \"agent-compatibility\"],\n    title: \"Agent Harness Compatibility\",\n    summary: \"Cross-harness compatibility guidance for skill discovery, prompts, and docs routing.\",\n    intent: \"Use this when adapting pm skills/docs usage for Pi, OpenClaw, Claude Code, Codex CLI, OpenCode, Amp, Droid, Hermes, or Gemini CLI.\",\n    commands: [\"pm guide skills\", \"pm guide commands\", \"pm contracts --runtime-only --availability-only\"],\n    workflows: [\n      {\n        name: \"Harness Mapping\",\n        goal: \"Route each harness to the same canonical skill/docs sources.\",\n        prompt:\n          \"Map harness-specific entrypoints to the same pm guide topics and .agents/skills workflows without adding runtime harness-specific code.\",\n        commands: [\"pm guide harnesses --depth standard\", \"pm guide skills --depth deep\"],\n      },\n    ],\n    docs: [\n      { path: \"docs/AGENT_GUIDE.md\", purpose: \"Agent context and output-mode conventions.\" },\n      { path: \"docs/README.md\", purpose: \"Single-source documentation routing entrypoint.\" },\n      { path: \".agents/skills/HARNESS_COMPATIBILITY.md\", purpose: \"Harness compatibility matrix and usage notes.\" },\n    ],\n    related: [\"skills\", \"workflows\"],\n  },\n  {\n    id: \"release\",\n    aliases: [\"gates\", \"ship\", \"release-readiness\"],\n    title: \"Release and Staleness Gates\",\n    summary: \"Run release gates and docs/skills freshness checks before publishing.\",\n    intent: \"Use this when validating release readiness and preventing docs/skills drift.\",\n    commands: [\n      \"pnpm build\",\n      \"pnpm test:coverage\",\n      \"pnpm quality:static\",\n      \"node scripts/release/run-gates.mjs --telemetry-mode best-effort\",\n      \"pnpm security:scan\",\n    ],\n    workflows: [\n      {\n        name: \"Pre-Release Gate Sweep\",\n        goal: \"Ensure code, docs, and skills are all green before publish.\",\n        prompt:\n          \"Run release gates in deterministic order and treat docs/skills freshness failures as release blockers.\",\n        commands: [\n          \"pnpm build\",\n          \"pnpm test:coverage\",\n          \"node scripts/release/run-gates.mjs --telemetry-mode best-effort\",\n        ],\n      },\n    ],\n    docs: [\n      { path: \"docs/RELEASING.md\", purpose: \"Release flow and safety checks.\" },\n      { path: \"CHANGELOG.md\", purpose: \"Versioned release history and unreleased notes.\" },\n      { path: \"scripts/release/run-gates.mjs\", purpose: \"Source of truth for release gate ordering.\" },\n    ],\n    related: [\"commands\", \"skills\", \"workflows\"],\n  },\n];\n\nconst TOPIC_BY_TOKEN = new Map<string, GuideTopicDefinition>();\nfor (const topic of GUIDE_TOPICS) {\n  TOPIC_BY_TOKEN.set(topic.id, topic);\n  for (const alias of topic.aliases) {\n    TOPIC_BY_TOKEN.set(alias, topic);\n  }\n}\n\nexport function listGuideTopics(): GuideTopicDefinition[] {\n  return GUIDE_TOPICS.map((topic) => ({\n    ...topic,\n    aliases: [...topic.aliases],\n    commands: [...topic.commands],\n    workflows: topic.workflows.map((workflow) => ({\n      ...workflow,\n      commands: [...workflow.commands],\n    })),\n    docs: topic.docs.map((doc) => ({ ...doc })),\n    related: [...topic.related],\n  }));\n}\n\nexport function listGuideTopicIds(): string[] {\n  return GUIDE_TOPICS.map((topic) => topic.id);\n}\n\nexport function resolveGuideTopic(rawTopic: string | undefined): GuideTopicDefinition | null {\n  if (!rawTopic) {\n    return null;\n  }\n  const normalized = normalizeTopicToken(rawTopic);\n  if (!normalized) {\n    return null;\n  }\n  return TOPIC_BY_TOKEN.get(normalized) ?? null;\n}\n\n"]}

package/dist/cli/help-content.js

@@ -253,6 +253,20 @@ const HELP_BY_COMMAND_PATH = {
         ],
         tips: ["Use title_exact for strict collisions, title_fuzzy for near-duplicates, and parent_scope for child-level collisions."],
     },
+    guide: {
+        why: "Routes local progressive-disclosure documentation so agents can fetch only the context they need.",
+        examples: [
+            "pm guide",
+            "pm guide quickstart",
+            "pm guide commands --depth standard",
+            "pm guide skills --depth deep --format markdown",
+            "pm guide release --json",
+        ],
+        tips: [
+            "Use brief depth for minimal token footprint, standard for excerpted docs, and deep for full local document rendering.",
+            "Use --list to force topic index output even when topic parsing is ambiguous.",
+        ],
+    },
     calendar: {
         why: "Provides deadline/reminder/event scheduling views for planning and coordination.",
         examples: [
@@ -342,12 +356,16 @@ const HELP_BY_COMMAND_PATH = {
     comments: {
         why: "Adds or reviews lightweight status updates linked to an item.",
         examples: [
+            'pm comments pm-a1b2 "Verified fix on Linux and macOS"',
             'pm comments pm-a1b2 --add "Verified fix on Linux and macOS"',
+            'printf "%s\\n" "## Verification" "- linux pass" "- mac pass" | pm comments pm-a1b2 --stdin',
+            'pm comments pm-a1b2 --file docs/release-evidence.md --author "codex-agent"',
             'pm comments pm-a1b2 --add "text: verification note with commas, key-like words, and parser details"',
             'pm comments pm-a1b2 --add "Follow-up needed after review" --author "codex-agent" --force',
             "pm comments pm-a1b2 --limit 10",
         ],
         tips: [
+            "Use exactly one comment source at a time: positional [text], --add, --stdin, or --file.",
             "Use --force when adding comments to items currently assigned to a different owner.",
             "When --add payload resembles CSV-like key fragments (for example text=hello,scope:project), plain-text fallback is intentional; use explicit text=..., markdown text: ..., or stdin token - for structured intent.",
         ],
@@ -506,9 +524,15 @@ const HELP_BY_COMMAND_PATH = {
 };
 export const ROOT_HELP_BUNDLE = {
     why: "Provides deterministic project management workflows for humans and coding agents.",
-    examples: ["pm init", "pm list-open --limit 10", 'pm create --title "..." --description "..." --type Task --status open --priority 1 --message "..." --create-mode progressive'],
+    examples: [
+        "pm init",
+        "pm guide",
+        "pm list-open --limit 10",
+        'pm create --title "..." --description "..." --type Task --status open --priority 1 --message "..." --create-mode progressive',
+    ],
     tips: [
         "Use <command> --help for command-specific guidance and examples.",
+        "Use pm guide for local docs and skills routing with progressive disclosure.",
         "Use --json for machine parsing and integration flows.",
         "Use --no-pager to force direct help output in CI and other non-interactive shells.",
     ],

package/dist/cli/help-content.js.map

@@ -1 +1 @@
-{"version":3,"file":"help-content.js","sourceRoot":"/","sources":["cli/help-content.ts"],"names":[],"mappings":"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","sourcesContent":["import { Command } from \"commander\";\n\nexport interface HelpBundle {\n  why: string;\n  examples: string[];\n  tips?: string[];\n}\n\nexport interface HelpNarrative {\n  intent: string;\n  examples: string[];\n  tips: string[];\n  detail_mode: HelpDetailMode;\n}\n\nexport type HelpDetailMode = \"compact\" | \"detailed\";\n\nfunction renderCompactHelpBundle(bundle: HelpBundle): string {\n  const lines: string[] = [\n    \"\",\n    \"Intent:\",\n    `  ${bundle.why}`,\n  ];\n  if (bundle.examples.length > 0) {\n    lines.push(\"\", \"Example:\");\n    lines.push(`  ${bundle.examples[0]}`);\n  }\n  lines.push(\"\", \"Need deeper rationale and more examples?\");\n  lines.push(\"  Re-run with --explain.\");\n  return lines.join(\"\\n\");\n}\n\nfunction renderDetailedHelpBundle(bundle: HelpBundle): string {\n  const lines: string[] = [\n    \"\",\n    \"Why use this command:\",\n    `  ${bundle.why}`,\n    \"\",\n    \"Examples:\",\n    ...bundle.examples.map((example) => `  ${example}`),\n  ];\n  if (bundle.tips && bundle.tips.length > 0) {\n    lines.push(\"\", \"Tips:\");\n    lines.push(...bundle.tips.map((tip) => `  - ${tip}`));\n  }\n  return lines.join(\"\\n\");\n}\n\nfunction renderHelpBundle(bundle: HelpBundle, detailMode: HelpDetailMode): string {\n  if (detailMode === \"detailed\") {\n    return renderDetailedHelpBundle(bundle);\n  }\n  return renderCompactHelpBundle(bundle);\n}\n\nexport function normalizeHelpCommandPath(commandPath: string): string {\n  return commandPath\n    .trim()\n    .toLowerCase()\n    .split(/\\s+/)\n    .filter((part) => part.length > 0)\n    .join(\" \");\n}\n\nconst HELP_PATH_ALIASES: Record<string, string> = {\n  cal: \"calendar\",\n  ctx: \"context\",\n};\n\nfunction findDirectChildCommand(parent: Command, name: string): Command | null {\n  return parent.commands.find((entry) => entry.name() === name) ?? null;\n}\n\nfunction findCommandByPath(root: Command, pathParts: string[]): Command | null {\n  let current: Command = root;\n  for (const part of pathParts) {\n    const next = findDirectChildCommand(current, part);\n    if (!next) {\n      return null;\n    }\n    current = next;\n  }\n  return current;\n}\n\nfunction attachBundleByPath(root: Command, commandPath: string, bundle: HelpBundle, detailMode: HelpDetailMode): void {\n  const command = findCommandByPath(root, commandPath.split(\" \").filter((part) => part.length > 0));\n  if (!command) {\n    return;\n  }\n  command.addHelpText(\"after\", renderHelpBundle(bundle, detailMode));\n}\n\nexport function resolveHelpDetailMode(argv: string[]): HelpDetailMode {\n  if (argv.includes(\"--explain\")) {\n    return \"detailed\";\n  }\n  return \"compact\";\n}\n\nconst HELP_BY_COMMAND_PATH: Record<string, HelpBundle> = {\n  init: {\n    why: \"Bootstraps tracker storage and settings so all other commands can run safely.\",\n    examples: ['pm init', 'pm init acme', \"pm init --preset minimal\", \"pm init --preset strict\"],\n    tips: [\n      \"Run this once per repository before create/list/update commands.\",\n      \"Use --preset for non-interactive automation; omit it in a TTY to use the setup wizard.\",\n    ],\n  },\n  config: {\n    why: \"Reads or updates project/global settings such as definition-of-done, item format, telemetry, and policy toggles.\",\n    examples: [\n      'pm config project get definition-of-done',\n      'pm config project set definition-of-done --criterion \"tests pass\"',\n      \"pm config project set item-format --format toon\",\n      \"pm config project set sprint-release-format-policy --policy strict_error\",\n      \"pm config project set governance-preset --policy minimal\",\n      \"pm config project set governance-ownership-enforcement --policy none\",\n      \"pm config project set test-result-tracking --policy enabled\",\n      \"pm config global set telemetry-tracking --policy disabled\",\n    ],\n  },\n  extension: {\n    why:\n      \"Installs, explores, manages, diagnoses, adopts (single or bulk), and activates/deactivates custom extensions across project or global scope.\",\n    examples: [\n      \"pm extension init ./my-extension\",\n      \"pm extension install beads --project\",\n      \"pm extension install todos --global\",\n      \"pm extension install .agents/pm/extensions/sample --project\",\n      \"pm extension install https://github.com/unbraind/pm-cli/tree/main/.agents/pm/extensions/pi --global\",\n      \"pm extension install --gh unbraind/pm-cli/pi --project\",\n      \"pm extension explore --project\",\n      \"pm extension manage --global\",\n      \"pm extension doctor --detail deep\",\n      \"pm extension adopt sample-ext --project\",\n      \"pm extension adopt-all --project\",\n      \"pm extension adopt sample-ext --project --gh owner/repo/path --ref main\",\n      \"pm extension activate sample-ext --project\",\n      \"pm extension deactivate sample-ext --project\",\n      \"pm extension uninstall sample-ext --global\",\n      \"pm extension --install beads --project\",\n    ],\n    tips: [\n      \"Prefer explicit subcommands (init/scaffold/install/uninstall/explore/manage/doctor/adopt/adopt-all/activate/deactivate) for discoverability.\",\n      \"Legacy lifecycle flags remain supported as backward-compatible aliases.\",\n      \"Bundled aliases beads and todos resolve to package-shipped extension sources.\",\n      \"Use --gh/--github shorthand for GitHub sources and --ref to pin a branch, tag, or ref.\",\n      \"Install updates settings activation state automatically unless extension allowlist mode is unchanged.\",\n      \"Use --adopt for single-extension adoption and --adopt-all to bulk-register unmanaged installs as managed without reinstalling.\",\n      \"Use --manage for concise triage summaries and remediation-oriented diagnostics alongside full extension details.\",\n      \"Use --doctor for consolidated diagnostics with warning codes, remediation hints, and optional deep detail payloads.\",\n    ],\n  },\n  create: {\n    why: \"Creates a new planning item with deterministic metadata and history.\",\n    examples: [\n      'pm create --title \"Harden lock flow\" --description \"Improve stale lock handling\" --type Task --status open --priority 1 --message \"Create lock hardening task\" --create-mode progressive',\n      'pm create --title \"Weekly planning sync\" --description \"Recurring coordination meeting\" --type Meeting --schedule-preset lightweight',\n      'pm create --title \"Asset: Hero model\" --description \"Track playable model asset\" --type Asset --status open --priority 1 --message \"Create asset item\" --type-option category=Character --dep \"id=pm-epic01,kind=parent,author=codex-agent,created_at=now\" --comment \"author=codex-agent,created_at=now,text=Why this asset item exists.\" --note \"author=codex-agent,created_at=now,text=Initial implementation note.\" --learning \"author=codex-agent,created_at=now,text=Durable lesson placeholder.\" --file \"path=src/assets/hero.glb,scope=project,note=tracked asset\" --test \"command=node scripts/run-tests.mjs test,scope=project,timeout_seconds=240\" --doc \"path=README.md,scope=project,note=asset docs\"',\n    ],\n    tips: [\n      \"Use --schedule-preset lightweight for Reminder/Meeting/Event when you want minimal required create inputs.\",\n      \"Use --type <value> to load type-aware policy guidance in --help output.\",\n    ],\n  },\n  update: {\n    why: \"Mutates existing item fields while preserving history and lock safety.\",\n    examples: [\n      'pm update pm-a1b2 --status in_progress --message \"Start implementation\"',\n      'pm update pm-a1b2 --unset close-reason --message \"Clear stale close reason after reopen\"',\n      'pm update pm-a1b2 --unset assignee --deadline +2d --message \"Replan ownership and deadline\"',\n      'pm update pm-a1b2 --body \"Backfilled body text for legacy item\" --message \"Normalize missing body\"',\n    ],\n    tips: [\n      'Use \"pm close <ID> <TEXT>\" to close items instead of --status closed.',\n      \"When reopening from closed to a non-terminal status, update clears stale close_reason unless explicitly set via --close-reason.\",\n      'Use \"pm append <ID> --body <text>\" for additive notes; use update --body to replace body content.',\n    ],\n  },\n  \"update-many\": {\n    why: \"Bulk-updates matched item sets with dry-run previews and rollback checkpoints for safe large-scale metadata changes.\",\n    examples: [\n      \"pm update-many --filter-status open --status in_progress --dry-run\",\n      'pm update-many --filter-tag wave:7 --replace-tests --test \"command=node scripts/run-tests.mjs test -- tests/core/history.spec.ts,scope=project,timeout_seconds=240\"',\n      'pm update-many --filter-tag governance --reviewer maintainer-review --message \"Normalize reviewer metadata\"',\n      \"pm update-many --rollback ckpt-abc123\",\n    ],\n    tips: [\n      \"Use --dry-run first to inspect proposed changes before apply mode.\",\n      \"Linked-array mutation flags mirror pm update semantics (for example --replace-tests, --clear-files, and repeatable --doc/--note seeds).\",\n      \"Checkpoints are enabled by default for apply mode and can be restored with --rollback.\",\n    ],\n  },\n  normalize: {\n    why:\n      \"Scans items for low-signal lifecycle metadata drift, emits deterministic per-item plans, and optionally applies normalized metadata updates with update-style safety checks.\",\n    examples: [\n      \"pm normalize --dry-run\",\n      \"pm normalize --filter-status in_progress --dry-run\",\n      'pm normalize --filter-status closed --apply --author \"codex-agent\" --message \"Normalize closure metadata\"',\n    ],\n    tips: [\n      \"Dry-run mode is the default; pass --apply only after reviewing planned changes.\",\n      \"Apply mode honors ownership/audit constraints and supports --allow-audit-update with optional --force override.\",\n    ],\n  },\n  templates: {\n    why: \"Saves, lists, and inspects reusable create option bundles for repeatable workflows.\",\n    examples: [\n      'pm templates save triage-default --title \"Triage item\" --description \"...\" --type Task --status open --priority 2 --message \"Seed triage template\"',\n      \"pm templates list\",\n      \"pm templates show triage-default\",\n    ],\n    tips: [\n      \"Template names are positional arguments (`pm templates save <name>` and `pm templates show <name>`), not --name flags.\",\n      \"Combine templates with explicit create flags; explicit flags always override template defaults.\",\n    ],\n  },\n  deps: {\n    why: \"Inspects an item dependency graph as a tree or graph payload to understand blockers and hierarchy links.\",\n    examples: [\n      \"pm deps pm-a1b2\",\n      \"pm deps pm-a1b2 --format graph\",\n      \"pm deps pm-a1b2 --max-depth 2 --collapse repeated --summary\",\n    ],\n    tips: [\"Use --summary for lightweight counts when full graph payloads are unnecessary.\"],\n  },\n  list: {\n    why: \"Lists active items with deterministic filtering and ordering.\",\n    examples: [\n      \"pm list --limit 20\",\n      \"pm list --type Task --priority 0 --tag release --assignee codex-agent\",\n      \"pm list --compact --sort deadline --order asc\",\n      \"pm list --fields id,title,parent,type --sort parent --order asc\",\n    ],\n  },\n  \"list-all\": {\n    why: \"Lists all item states (including terminal states) when you need full visibility.\",\n    examples: [\"pm list-all --limit 50\", \"pm list-all --type Issue --include-body\"],\n  },\n  \"list-open\": {\n    why: \"Shows work that is ready to claim and start.\",\n    examples: [\"pm list-open --priority 0 --limit 10\"],\n  },\n  \"list-in-progress\": {\n    why: \"Tracks active execution and owner progress.\",\n    examples: [\"pm list-in-progress --assignee codex-agent --limit 20\"],\n  },\n  \"list-blocked\": {\n    why: \"Surfaces blocked work that needs intervention.\",\n    examples: [\"pm list-blocked --limit 20\"],\n  },\n  \"list-closed\": {\n    why: \"Reviews completed work and closure outcomes.\",\n    examples: [\"pm list-closed --limit 20 --type Task\"],\n  },\n  \"list-canceled\": {\n    why: \"Audits intentionally discontinued work.\",\n    examples: [\"pm list-canceled --limit 20\"],\n  },\n  \"list-draft\": {\n    why: \"Finds incompletely defined items that need refinement before execution.\",\n    examples: [\"pm list-draft --limit 20\"],\n  },\n  aggregate: {\n    why: \"Runs grouped aggregation queries for governance checks such as decomposition by parent/type or triage by status/priority.\",\n    examples: [\n      \"pm aggregate --group-by parent,type --count\",\n      \"pm aggregate --group-by type,status --count\",\n      \"pm aggregate --group-by parent,type --count --status open --parent pm-feature01\",\n    ],\n    tips: [\"Current aggregate mode is grouped counts only, so pass --count explicitly.\"],\n  },\n  \"dedupe-audit\": {\n    why: \"Audits potential duplicate items and emits deterministic merge suggestions before any mutation.\",\n    examples: [\n      \"pm dedupe-audit --mode title_exact\",\n      \"pm dedupe-audit --mode title_fuzzy --threshold 0.8 --limit 20\",\n      \"pm dedupe-audit --mode parent_scope --status open\",\n    ],\n    tips: [\"Use title_exact for strict collisions, title_fuzzy for near-duplicates, and parent_scope for child-level collisions.\"],\n  },\n  calendar: {\n    why: \"Provides deadline/reminder/event scheduling views for planning and coordination.\",\n    examples: [\n      \"pm calendar\",\n      \"pm calendar --view agenda --from +0d --to +7d --assignee codex-agent\",\n      \"pm calendar --view week --date 2026-04-06 --full-period --include deadlines,events\",\n      \"pm calendar --view month --tag release --format json\",\n    ],\n    tips: [\n      \"Day/week/month views are anchored period windows; default mode clips the start to now unless --past or --full-period is set.\",\n      \"--full-period applies only to day/week/month views; use --from/--to to bound agenda windows.\",\n    ],\n  },\n  context: {\n    why: \"Builds an agent-optimized snapshot of critical active work plus near-term agenda context with progressive depth levels.\",\n    examples: [\n      \"pm context\",\n      \"pm ctx --depth standard --limit 10\",\n      \"pm ctx --depth deep --assignee codex-agent\",\n      \"pm ctx --section hierarchy --section progress --section blockers\",\n      \"pm context --depth standard --activity-limit 20 --stale-threshold 14d\",\n      \"pm context --from +0d --to +7d --format markdown --depth deep\",\n    ],\n    tips: [\n      \"High-level focus contains Epics/Features and low-level focus contains Tasks/Issues/Chores/Event/Reminder/Milestone/Meeting.\",\n      \"When no open or in-progress work exists, blocked items are shown as fallback context.\",\n      \"--depth brief (default) shows focus+agenda; standard adds hierarchy/activity/progress/workload; deep adds blockers/files/staleness/tests.\",\n      \"--section overrides --depth and selects specific sections: hierarchy, activity, progress, blockers, files, workload, staleness, tests.\",\n      \"Configure defaults via pm config project set context --default-depth standard --activity-limit 15.\",\n    ],\n  },\n  search: {\n    why: \"Finds relevant items by keyword, semantic, or hybrid retrieval modes.\",\n    examples: [\n      'pm search \"lock stale retry\" --mode keyword --limit 10',\n      'pm search \"extension migration blockers\" --mode hybrid --type Task --priority 0',\n      'pm search \"Cross-Epic Realism Dependency Council\" --mode keyword --title-exact',\n    ],\n    tips: [\n      \"Use --title-exact to require exact normalized title parity, or --phrase-exact to require full-phrase matches in item text fields.\",\n      \"Use --include-linked when linked docs/files/tests should influence scoring.\",\n    ],\n  },\n  reindex: {\n    why: \"Rebuilds search artifacts after large changes to item corpus or provider/vector config.\",\n    examples: [\"pm reindex --mode keyword\", \"pm reindex --mode hybrid\"],\n  },\n  get: {\n    why: \"Shows complete details for one item by ID.\",\n    examples: [\"pm get pm-a1b2\", \"pm get pm-a1b2 --json\"],\n    tips: [\"JSON output shape is { item, body, linked, claim_state }; body is top-level (not item.body).\"],\n  },\n  history: {\n    why: \"Inspects item mutation timeline and audit trail.\",\n    examples: [\"pm history pm-a1b2 --limit 20\"],\n  },\n  activity: {\n    why: \"Reviews recent tracker-wide activity across items.\",\n    examples: [\n      \"pm activity --limit 50\",\n      \"pm activity --id pm-a1b2 --op update --author codex-agent --from -7d --to now\",\n      \"pm activity --json --stream rows --limit 200\",\n    ],\n    tips: [\"Use --stream with --json for line-delimited automation output; --from is inclusive and --to is exclusive.\"],\n  },\n  restore: {\n    why: \"Restores an item to a prior timestamp/version with history replay safety.\",\n    examples: ['pm restore pm-a1b2 2026-04-01T00:00:00.000Z --author \"codex-agent\" --message \"Rollback to known-good state\"'],\n  },\n  close: {\n    why: \"Transitions work to terminal closed state with explicit rationale.\",\n    examples: [\n      'pm close pm-a1b2 \"All acceptance criteria met\" --author \"codex-agent\" --message \"Close after verification\"',\n      'pm close pm-a1b2 \"Done\" --validate-close',\n      'pm close pm-a1b2 \"Done\" --validate-close off',\n      'pm close pm-a1b2 \"Done\" --validate-close strict',\n    ],\n  },\n  delete: {\n    why: \"Removes an item while preserving history evidence and lock/ownership checks.\",\n    examples: ['pm delete pm-a1b2 --author \"codex-agent\" --message \"Remove duplicate item\"'],\n  },\n  append: {\n    why: \"Adds implementation notes to body without replacing existing content.\",\n    examples: ['pm append pm-a1b2 --body \"Implemented retry with bounded backoff.\" --message \"Record implementation detail\"'],\n  },\n  comments: {\n    why: \"Adds or reviews lightweight status updates linked to an item.\",\n    examples: [\n      'pm comments pm-a1b2 --add \"Verified fix on Linux and macOS\"',\n      'pm comments pm-a1b2 --add \"text: verification note with commas, key-like words, and parser details\"',\n      'pm comments pm-a1b2 --add \"Follow-up needed after review\" --author \"codex-agent\" --force',\n      \"pm comments pm-a1b2 --limit 10\",\n    ],\n    tips: [\n      \"Use --force when adding comments to items currently assigned to a different owner.\",\n      \"When --add payload resembles CSV-like key fragments (for example text=hello,scope:project), plain-text fallback is intentional; use explicit text=..., markdown text: ..., or stdin token - for structured intent.\",\n    ],\n  },\n  \"comments-audit\": {\n    why: \"Audits latest comments or full history rows across filtered item sets.\",\n    examples: [\n      \"pm comments-audit --status open --latest 1\",\n      \"pm comments-audit --status open --latest 0\",\n      \"pm comments-audit --parent pm-feature01 --tag governance --sprint sprint-12 --release vnext --priority 0\",\n      \"pm comments-audit --full-history --limit 50\",\n    ],\n    tips: [\n      \"Use either --latest or --full-history (not both). --latest 0 returns item summaries without comment rows. --limit is an alias for --limit-items.\",\n    ],\n  },\n  notes: {\n    why: \"Adds or reviews durable implementation notes linked to an item.\",\n    examples: [\n      'pm notes pm-a1b2 --add \"Investigated parser edge case and documented fallback logic.\"',\n      'pm notes pm-a1b2 --add \"text: parser rationale with commas, colons, and key-like wording\"',\n      'pm notes pm-a1b2 --add \"Audit note\" --author \"reviewer\" --allow-audit-note',\n      \"pm notes pm-a1b2 --limit 10\",\n    ],\n    tips: [\n      \"Use --allow-audit-note for append-only non-owner audits; --allow-audit-comment remains supported as a legacy alias.\",\n      \"CSV-like add payloads with extra key fragments are treated as plain text by design; use explicit text keys (text= or text:) when structured parsing is required.\",\n    ],\n  },\n  learnings: {\n    why: \"Adds or reviews post-implementation learnings for future work.\",\n    examples: [\n      'pm learnings pm-a1b2 --add \"Avoid direct test-runner commands in linked tests; use sandbox runner.\"',\n      'pm learnings pm-a1b2 --add \"text: lesson with commas, key-like words, and punctuation-safe context\"',\n      'pm learnings pm-a1b2 --add \"Audit learning\" --author \"reviewer\" --allow-audit-learning',\n      \"pm learnings pm-a1b2 --limit 10\",\n    ],\n    tips: [\n      \"Use --allow-audit-learning for append-only non-owner audits; --allow-audit-comment remains supported as a legacy alias.\",\n      \"If you intended structured parsing for a key-like payload, prefer explicit text=..., markdown text: ..., or stdin token -; ambiguous CSV-like forms intentionally remain plain text.\",\n    ],\n  },\n  files: {\n    why: \"Associates changed source files with tracker items for reproducibility.\",\n    examples: [\n      'pm files pm-a1b2 --add \"path=src/cli/main.ts,scope=project,note=help orchestration\"',\n      \"pm files discover pm-a1b2\",\n      'pm files discover pm-a1b2 --apply --note \"discovered from item text\"',\n    ],\n  },\n  docs: {\n    why: \"Associates relevant documentation paths with tracker items.\",\n    examples: ['pm docs pm-a1b2 --add \"path=README.md,scope=project,note=user-facing command guidance\"'],\n  },\n  test: {\n    why: \"Links test commands/paths and optionally executes them for one item.\",\n    examples: [\n      'pm test pm-a1b2 --add \"command=node scripts/run-tests.mjs test -- tests/unit/output.spec.ts,scope=project,timeout_seconds=2400\"',\n      'pm test pm-a1b2 --add \"command=pm list-all --type Task --limit 200,scope=project,assert_stdout_contains=count:,assert_stdout_regex=count:\\\\s+\\\\d+\"',\n      'pm test pm-a1b2 --add \"command=pm list-all --type Task --limit 200,scope=project,pm_context_mode=auto\"',\n      \"pm test pm-a1b2 --run --timeout 2400 --env-set PORT=0 --env-clear PLAYWRIGHT_BASE_URL --shared-host-safe --pm-context tracker --fail-on-context-mismatch --fail-on-skipped\",\n      \"pm test pm-a1b2 --run --timeout 2400 --pm-context auto\",\n      \"pm test pm-a1b2 --run --background --timeout 2400 --progress\",\n    ],\n  },\n  \"test-all\": {\n    why: \"Runs linked tests in bulk for release/readiness sweeps.\",\n    examples: [\n      \"pm test-all --status in_progress --limit 5 --offset 10 --timeout 2400\",\n      \"pm test-all --status closed --timeout 3600 --progress --env-set PORT=0 --shared-host-safe --fail-on-skipped\",\n      \"pm test-all --status in_progress --pm-context tracker --fail-on-context-mismatch --require-assertions-for-pm\",\n      \"pm test-all --status in_progress --pm-context auto --fail-on-context-mismatch\",\n      \"pm test-all --status in_progress --background --timeout 3600\",\n    ],\n  },\n  \"test-runs\": {\n    why: \"Manages background linked-test runs with lifecycle controls and log/status inspection.\",\n    examples: [\n      \"pm test-runs list --status running --limit 20\",\n      \"pm test-runs status tr-abc123\",\n      \"pm test-runs logs tr-abc123 --stream stderr --tail 200\",\n      \"pm test-runs stop tr-abc123\",\n      \"pm test-runs resume tr-abc123\",\n    ],\n  },\n  stats: {\n    why: \"Reports tracker-level totals and distribution by type/status.\",\n    examples: [\"pm stats\", \"pm stats --json\"],\n  },\n  health: {\n    why: \"Validates tracker/runtime health including extension triage, migration, and integrity diagnostics.\",\n    examples: [\"pm health\", \"pm health --json\", \"pm health --check-only\", \"pm health --no-refresh\", \"pm health --refresh-vectors\"],\n  },\n  validate: {\n    why:\n      \"Runs standalone metadata, resolution, lifecycle (including dependency-cycle diagnostics), linked-file, linked-command reference, and history drift checks with default remediation hints for resolution gaps.\",\n    examples: [\n      \"pm validate\",\n      \"pm validate --check-resolution --json\",\n      \"pm validate --check-lifecycle --dependency-cycle-severity error\",\n      \"pm validate --check-files --scan-mode tracked-all\",\n      \"pm validate --check-files --scan-mode tracked-all-strict --include-pm-internals\",\n      \"pm validate --check-command-references\",\n      \"pm validate --check-resolution --fail-on-warn --json\",\n    ],\n    tips: [\"Resolution-gap warnings include default `pm update <id> ...` remediation hint templates in check details.\"],\n  },\n  gc: {\n    why: \"Cleans optional cache artifacts to keep local tracker state tidy.\",\n    examples: [\"pm gc\"],\n  },\n  claim: {\n    why: \"Claims an item to signal active ownership and reduce conflicts.\",\n    examples: [\n      'pm claim pm-a1b2 --author \"codex-agent\" --message \"Claim for implementation\"',\n      'pm claim pm-a1b2 --force --author \"codex-agent\" --message \"Take over terminal item\"',\n    ],\n    tips: [\"Claim takeover for non-terminal items does not require --force; --force is reserved for terminal/lock overrides.\"],\n  },\n  release: {\n    why: \"Releases an active claim when paused, handed off, or completed.\",\n    examples: [\n      'pm release pm-a1b2 --author \"codex-agent\" --message \"Release after closure\"',\n      'pm release pm-a1b2 --allow-audit-release --author \"reviewer\" --message \"Audit handoff release\"',\n    ],\n    tips: [\"Use --allow-audit-release for non-owner handoffs that only clear assignee metadata.\"],\n  },\n  \"start-task\": {\n    why: \"Lifecycle alias that claims an item and sets status to in_progress.\",\n    examples: ['pm start-task pm-a1b2 --author \"codex-agent\" --message \"Start implementation\"'],\n  },\n  \"pause-task\": {\n    why: \"Lifecycle alias that sets status to open and releases active assignment.\",\n    examples: ['pm pause-task pm-a1b2 --author \"codex-agent\" --message \"Pause for dependency unblock\"'],\n  },\n  \"close-task\": {\n    why: \"Lifecycle alias that closes with reason text and clears assignment metadata.\",\n    examples: ['pm close-task pm-a1b2 \"All acceptance criteria met\" --author \"codex-agent\" --message \"Close and handoff\"'],\n  },\n  completion: {\n    why: \"Generates shell completion scripts for faster and more reliable command entry.\",\n    examples: [\"pm completion bash\", \"pm completion zsh\", \"pm completion fish\", \"pm completion bash --eager-tags\"],\n    tips: [\"Default scripts resolve tag suggestions lazily at completion time; use --eager-tags to embed current tags directly.\"],\n  },\n  contracts: {\n    why: \"Exposes machine-readable CLI command and tool schema contracts for agent integrations.\",\n    examples: [\n      \"pm contracts\",\n      \"pm contracts --command list --runtime-only\",\n      \"pm contracts --command update --flags-only\",\n      \"pm contracts --availability-only --runtime-only\",\n      \"pm contracts --action create\",\n      \"pm contracts --schema-only\",\n    ],\n    tips: [\"Use --command to narrow actions/schema to one CLI surface; combine with --flags-only or --availability-only for lighter payloads.\"],\n  },\n};\n\nexport const ROOT_HELP_BUNDLE: HelpBundle = {\n  why: \"Provides deterministic project management workflows for humans and coding agents.\",\n  examples: [\"pm init\", \"pm list-open --limit 10\", 'pm create --title \"...\" --description \"...\" --type Task --status open --priority 1 --message \"...\" --create-mode progressive'],\n  tips: [\n    \"Use <command> --help for command-specific guidance and examples.\",\n    \"Use --json for machine parsing and integration flows.\",\n    \"Use --no-pager to force direct help output in CI and other non-interactive shells.\",\n  ],\n};\n\nfunction resolveCanonicalHelpPath(commandPath: string | undefined): string {\n  const normalized = normalizeHelpCommandPath(commandPath ?? \"\");\n  if (!normalized) {\n    return \"\";\n  }\n  return HELP_PATH_ALIASES[normalized] ?? normalized;\n}\n\nexport function resolveHelpBundleForPath(commandPath: string | undefined): HelpBundle {\n  const canonicalPath = resolveCanonicalHelpPath(commandPath);\n  if (!canonicalPath) {\n    return ROOT_HELP_BUNDLE;\n  }\n  return HELP_BY_COMMAND_PATH[canonicalPath] ?? ROOT_HELP_BUNDLE;\n}\n\nexport function resolveHelpNarrative(commandPath: string | undefined, detailMode: HelpDetailMode): HelpNarrative {\n  const bundle = resolveHelpBundleForPath(commandPath);\n  return {\n    intent: bundle.why,\n    examples: detailMode === \"detailed\" ? [...bundle.examples] : bundle.examples.length > 0 ? [bundle.examples[0]] : [],\n    tips: detailMode === \"detailed\" ? [...(bundle.tips ?? [])] : [],\n    detail_mode: detailMode,\n  };\n}\n\nexport function listDocumentedHelpPaths(): string[] {\n  return Object.keys(HELP_BY_COMMAND_PATH).sort((left, right) => left.localeCompare(right));\n}\n\nexport function attachRichHelpText(program: Command, argv: string[] = process.argv.slice(2)): void {\n  const detailMode = resolveHelpDetailMode(argv);\n  program.addHelpText(\"after\", renderHelpBundle(ROOT_HELP_BUNDLE, detailMode));\n  for (const [commandPath, bundle] of Object.entries(HELP_BY_COMMAND_PATH)) {\n    attachBundleByPath(program, commandPath, bundle, detailMode);\n  }\n}\n"]}
+{"version":3,"file":"help-content.js","sourceRoot":"/","sources":["cli/help-content.ts"],"names":[],"mappings":"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","sourcesContent":["import { Command } from \"commander\";\n\nexport interface HelpBundle {\n  why: string;\n  examples: string[];\n  tips?: string[];\n}\n\nexport interface HelpNarrative {\n  intent: string;\n  examples: string[];\n  tips: string[];\n  detail_mode: HelpDetailMode;\n}\n\nexport type HelpDetailMode = \"compact\" | \"detailed\";\n\nfunction renderCompactHelpBundle(bundle: HelpBundle): string {\n  const lines: string[] = [\n    \"\",\n    \"Intent:\",\n    `  ${bundle.why}`,\n  ];\n  if (bundle.examples.length > 0) {\n    lines.push(\"\", \"Example:\");\n    lines.push(`  ${bundle.examples[0]}`);\n  }\n  lines.push(\"\", \"Need deeper rationale and more examples?\");\n  lines.push(\"  Re-run with --explain.\");\n  return lines.join(\"\\n\");\n}\n\nfunction renderDetailedHelpBundle(bundle: HelpBundle): string {\n  const lines: string[] = [\n    \"\",\n    \"Why use this command:\",\n    `  ${bundle.why}`,\n    \"\",\n    \"Examples:\",\n    ...bundle.examples.map((example) => `  ${example}`),\n  ];\n  if (bundle.tips && bundle.tips.length > 0) {\n    lines.push(\"\", \"Tips:\");\n    lines.push(...bundle.tips.map((tip) => `  - ${tip}`));\n  }\n  return lines.join(\"\\n\");\n}\n\nfunction renderHelpBundle(bundle: HelpBundle, detailMode: HelpDetailMode): string {\n  if (detailMode === \"detailed\") {\n    return renderDetailedHelpBundle(bundle);\n  }\n  return renderCompactHelpBundle(bundle);\n}\n\nexport function normalizeHelpCommandPath(commandPath: string): string {\n  return commandPath\n    .trim()\n    .toLowerCase()\n    .split(/\\s+/)\n    .filter((part) => part.length > 0)\n    .join(\" \");\n}\n\nconst HELP_PATH_ALIASES: Record<string, string> = {\n  cal: \"calendar\",\n  ctx: \"context\",\n};\n\nfunction findDirectChildCommand(parent: Command, name: string): Command | null {\n  return parent.commands.find((entry) => entry.name() === name) ?? null;\n}\n\nfunction findCommandByPath(root: Command, pathParts: string[]): Command | null {\n  let current: Command = root;\n  for (const part of pathParts) {\n    const next = findDirectChildCommand(current, part);\n    if (!next) {\n      return null;\n    }\n    current = next;\n  }\n  return current;\n}\n\nfunction attachBundleByPath(root: Command, commandPath: string, bundle: HelpBundle, detailMode: HelpDetailMode): void {\n  const command = findCommandByPath(root, commandPath.split(\" \").filter((part) => part.length > 0));\n  if (!command) {\n    return;\n  }\n  command.addHelpText(\"after\", renderHelpBundle(bundle, detailMode));\n}\n\nexport function resolveHelpDetailMode(argv: string[]): HelpDetailMode {\n  if (argv.includes(\"--explain\")) {\n    return \"detailed\";\n  }\n  return \"compact\";\n}\n\nconst HELP_BY_COMMAND_PATH: Record<string, HelpBundle> = {\n  init: {\n    why: \"Bootstraps tracker storage and settings so all other commands can run safely.\",\n    examples: ['pm init', 'pm init acme', \"pm init --preset minimal\", \"pm init --preset strict\"],\n    tips: [\n      \"Run this once per repository before create/list/update commands.\",\n      \"Use --preset for non-interactive automation; omit it in a TTY to use the setup wizard.\",\n    ],\n  },\n  config: {\n    why: \"Reads or updates project/global settings such as definition-of-done, item format, telemetry, and policy toggles.\",\n    examples: [\n      'pm config project get definition-of-done',\n      'pm config project set definition-of-done --criterion \"tests pass\"',\n      \"pm config project set item-format --format toon\",\n      \"pm config project set sprint-release-format-policy --policy strict_error\",\n      \"pm config project set governance-preset --policy minimal\",\n      \"pm config project set governance-ownership-enforcement --policy none\",\n      \"pm config project set test-result-tracking --policy enabled\",\n      \"pm config global set telemetry-tracking --policy disabled\",\n    ],\n  },\n  extension: {\n    why:\n      \"Installs, explores, manages, diagnoses, adopts (single or bulk), and activates/deactivates custom extensions across project or global scope.\",\n    examples: [\n      \"pm extension init ./my-extension\",\n      \"pm extension install beads --project\",\n      \"pm extension install todos --global\",\n      \"pm extension install .agents/pm/extensions/sample --project\",\n      \"pm extension install https://github.com/unbraind/pm-cli/tree/main/.agents/pm/extensions/pi --global\",\n      \"pm extension install --gh unbraind/pm-cli/pi --project\",\n      \"pm extension explore --project\",\n      \"pm extension manage --global\",\n      \"pm extension doctor --detail deep\",\n      \"pm extension adopt sample-ext --project\",\n      \"pm extension adopt-all --project\",\n      \"pm extension adopt sample-ext --project --gh owner/repo/path --ref main\",\n      \"pm extension activate sample-ext --project\",\n      \"pm extension deactivate sample-ext --project\",\n      \"pm extension uninstall sample-ext --global\",\n      \"pm extension --install beads --project\",\n    ],\n    tips: [\n      \"Prefer explicit subcommands (init/scaffold/install/uninstall/explore/manage/doctor/adopt/adopt-all/activate/deactivate) for discoverability.\",\n      \"Legacy lifecycle flags remain supported as backward-compatible aliases.\",\n      \"Bundled aliases beads and todos resolve to package-shipped extension sources.\",\n      \"Use --gh/--github shorthand for GitHub sources and --ref to pin a branch, tag, or ref.\",\n      \"Install updates settings activation state automatically unless extension allowlist mode is unchanged.\",\n      \"Use --adopt for single-extension adoption and --adopt-all to bulk-register unmanaged installs as managed without reinstalling.\",\n      \"Use --manage for concise triage summaries and remediation-oriented diagnostics alongside full extension details.\",\n      \"Use --doctor for consolidated diagnostics with warning codes, remediation hints, and optional deep detail payloads.\",\n    ],\n  },\n  create: {\n    why: \"Creates a new planning item with deterministic metadata and history.\",\n    examples: [\n      'pm create --title \"Harden lock flow\" --description \"Improve stale lock handling\" --type Task --status open --priority 1 --message \"Create lock hardening task\" --create-mode progressive',\n      'pm create --title \"Weekly planning sync\" --description \"Recurring coordination meeting\" --type Meeting --schedule-preset lightweight',\n      'pm create --title \"Asset: Hero model\" --description \"Track playable model asset\" --type Asset --status open --priority 1 --message \"Create asset item\" --type-option category=Character --dep \"id=pm-epic01,kind=parent,author=codex-agent,created_at=now\" --comment \"author=codex-agent,created_at=now,text=Why this asset item exists.\" --note \"author=codex-agent,created_at=now,text=Initial implementation note.\" --learning \"author=codex-agent,created_at=now,text=Durable lesson placeholder.\" --file \"path=src/assets/hero.glb,scope=project,note=tracked asset\" --test \"command=node scripts/run-tests.mjs test,scope=project,timeout_seconds=240\" --doc \"path=README.md,scope=project,note=asset docs\"',\n    ],\n    tips: [\n      \"Use --schedule-preset lightweight for Reminder/Meeting/Event when you want minimal required create inputs.\",\n      \"Use --type <value> to load type-aware policy guidance in --help output.\",\n    ],\n  },\n  update: {\n    why: \"Mutates existing item fields while preserving history and lock safety.\",\n    examples: [\n      'pm update pm-a1b2 --status in_progress --message \"Start implementation\"',\n      'pm update pm-a1b2 --unset close-reason --message \"Clear stale close reason after reopen\"',\n      'pm update pm-a1b2 --unset assignee --deadline +2d --message \"Replan ownership and deadline\"',\n      'pm update pm-a1b2 --body \"Backfilled body text for legacy item\" --message \"Normalize missing body\"',\n    ],\n    tips: [\n      'Use \"pm close <ID> <TEXT>\" to close items instead of --status closed.',\n      \"When reopening from closed to a non-terminal status, update clears stale close_reason unless explicitly set via --close-reason.\",\n      'Use \"pm append <ID> --body <text>\" for additive notes; use update --body to replace body content.',\n    ],\n  },\n  \"update-many\": {\n    why: \"Bulk-updates matched item sets with dry-run previews and rollback checkpoints for safe large-scale metadata changes.\",\n    examples: [\n      \"pm update-many --filter-status open --status in_progress --dry-run\",\n      'pm update-many --filter-tag wave:7 --replace-tests --test \"command=node scripts/run-tests.mjs test -- tests/core/history.spec.ts,scope=project,timeout_seconds=240\"',\n      'pm update-many --filter-tag governance --reviewer maintainer-review --message \"Normalize reviewer metadata\"',\n      \"pm update-many --rollback ckpt-abc123\",\n    ],\n    tips: [\n      \"Use --dry-run first to inspect proposed changes before apply mode.\",\n      \"Linked-array mutation flags mirror pm update semantics (for example --replace-tests, --clear-files, and repeatable --doc/--note seeds).\",\n      \"Checkpoints are enabled by default for apply mode and can be restored with --rollback.\",\n    ],\n  },\n  normalize: {\n    why:\n      \"Scans items for low-signal lifecycle metadata drift, emits deterministic per-item plans, and optionally applies normalized metadata updates with update-style safety checks.\",\n    examples: [\n      \"pm normalize --dry-run\",\n      \"pm normalize --filter-status in_progress --dry-run\",\n      'pm normalize --filter-status closed --apply --author \"codex-agent\" --message \"Normalize closure metadata\"',\n    ],\n    tips: [\n      \"Dry-run mode is the default; pass --apply only after reviewing planned changes.\",\n      \"Apply mode honors ownership/audit constraints and supports --allow-audit-update with optional --force override.\",\n    ],\n  },\n  templates: {\n    why: \"Saves, lists, and inspects reusable create option bundles for repeatable workflows.\",\n    examples: [\n      'pm templates save triage-default --title \"Triage item\" --description \"...\" --type Task --status open --priority 2 --message \"Seed triage template\"',\n      \"pm templates list\",\n      \"pm templates show triage-default\",\n    ],\n    tips: [\n      \"Template names are positional arguments (`pm templates save <name>` and `pm templates show <name>`), not --name flags.\",\n      \"Combine templates with explicit create flags; explicit flags always override template defaults.\",\n    ],\n  },\n  deps: {\n    why: \"Inspects an item dependency graph as a tree or graph payload to understand blockers and hierarchy links.\",\n    examples: [\n      \"pm deps pm-a1b2\",\n      \"pm deps pm-a1b2 --format graph\",\n      \"pm deps pm-a1b2 --max-depth 2 --collapse repeated --summary\",\n    ],\n    tips: [\"Use --summary for lightweight counts when full graph payloads are unnecessary.\"],\n  },\n  list: {\n    why: \"Lists active items with deterministic filtering and ordering.\",\n    examples: [\n      \"pm list --limit 20\",\n      \"pm list --type Task --priority 0 --tag release --assignee codex-agent\",\n      \"pm list --compact --sort deadline --order asc\",\n      \"pm list --fields id,title,parent,type --sort parent --order asc\",\n    ],\n  },\n  \"list-all\": {\n    why: \"Lists all item states (including terminal states) when you need full visibility.\",\n    examples: [\"pm list-all --limit 50\", \"pm list-all --type Issue --include-body\"],\n  },\n  \"list-open\": {\n    why: \"Shows work that is ready to claim and start.\",\n    examples: [\"pm list-open --priority 0 --limit 10\"],\n  },\n  \"list-in-progress\": {\n    why: \"Tracks active execution and owner progress.\",\n    examples: [\"pm list-in-progress --assignee codex-agent --limit 20\"],\n  },\n  \"list-blocked\": {\n    why: \"Surfaces blocked work that needs intervention.\",\n    examples: [\"pm list-blocked --limit 20\"],\n  },\n  \"list-closed\": {\n    why: \"Reviews completed work and closure outcomes.\",\n    examples: [\"pm list-closed --limit 20 --type Task\"],\n  },\n  \"list-canceled\": {\n    why: \"Audits intentionally discontinued work.\",\n    examples: [\"pm list-canceled --limit 20\"],\n  },\n  \"list-draft\": {\n    why: \"Finds incompletely defined items that need refinement before execution.\",\n    examples: [\"pm list-draft --limit 20\"],\n  },\n  aggregate: {\n    why: \"Runs grouped aggregation queries for governance checks such as decomposition by parent/type or triage by status/priority.\",\n    examples: [\n      \"pm aggregate --group-by parent,type --count\",\n      \"pm aggregate --group-by type,status --count\",\n      \"pm aggregate --group-by parent,type --count --status open --parent pm-feature01\",\n    ],\n    tips: [\"Current aggregate mode is grouped counts only, so pass --count explicitly.\"],\n  },\n  \"dedupe-audit\": {\n    why: \"Audits potential duplicate items and emits deterministic merge suggestions before any mutation.\",\n    examples: [\n      \"pm dedupe-audit --mode title_exact\",\n      \"pm dedupe-audit --mode title_fuzzy --threshold 0.8 --limit 20\",\n      \"pm dedupe-audit --mode parent_scope --status open\",\n    ],\n    tips: [\"Use title_exact for strict collisions, title_fuzzy for near-duplicates, and parent_scope for child-level collisions.\"],\n  },\n  guide: {\n    why: \"Routes local progressive-disclosure documentation so agents can fetch only the context they need.\",\n    examples: [\n      \"pm guide\",\n      \"pm guide quickstart\",\n      \"pm guide commands --depth standard\",\n      \"pm guide skills --depth deep --format markdown\",\n      \"pm guide release --json\",\n    ],\n    tips: [\n      \"Use brief depth for minimal token footprint, standard for excerpted docs, and deep for full local document rendering.\",\n      \"Use --list to force topic index output even when topic parsing is ambiguous.\",\n    ],\n  },\n  calendar: {\n    why: \"Provides deadline/reminder/event scheduling views for planning and coordination.\",\n    examples: [\n      \"pm calendar\",\n      \"pm calendar --view agenda --from +0d --to +7d --assignee codex-agent\",\n      \"pm calendar --view week --date 2026-04-06 --full-period --include deadlines,events\",\n      \"pm calendar --view month --tag release --format json\",\n    ],\n    tips: [\n      \"Day/week/month views are anchored period windows; default mode clips the start to now unless --past or --full-period is set.\",\n      \"--full-period applies only to day/week/month views; use --from/--to to bound agenda windows.\",\n    ],\n  },\n  context: {\n    why: \"Builds an agent-optimized snapshot of critical active work plus near-term agenda context with progressive depth levels.\",\n    examples: [\n      \"pm context\",\n      \"pm ctx --depth standard --limit 10\",\n      \"pm ctx --depth deep --assignee codex-agent\",\n      \"pm ctx --section hierarchy --section progress --section blockers\",\n      \"pm context --depth standard --activity-limit 20 --stale-threshold 14d\",\n      \"pm context --from +0d --to +7d --format markdown --depth deep\",\n    ],\n    tips: [\n      \"High-level focus contains Epics/Features and low-level focus contains Tasks/Issues/Chores/Event/Reminder/Milestone/Meeting.\",\n      \"When no open or in-progress work exists, blocked items are shown as fallback context.\",\n      \"--depth brief (default) shows focus+agenda; standard adds hierarchy/activity/progress/workload; deep adds blockers/files/staleness/tests.\",\n      \"--section overrides --depth and selects specific sections: hierarchy, activity, progress, blockers, files, workload, staleness, tests.\",\n      \"Configure defaults via pm config project set context --default-depth standard --activity-limit 15.\",\n    ],\n  },\n  search: {\n    why: \"Finds relevant items by keyword, semantic, or hybrid retrieval modes.\",\n    examples: [\n      'pm search \"lock stale retry\" --mode keyword --limit 10',\n      'pm search \"extension migration blockers\" --mode hybrid --type Task --priority 0',\n      'pm search \"Cross-Epic Realism Dependency Council\" --mode keyword --title-exact',\n    ],\n    tips: [\n      \"Use --title-exact to require exact normalized title parity, or --phrase-exact to require full-phrase matches in item text fields.\",\n      \"Use --include-linked when linked docs/files/tests should influence scoring.\",\n    ],\n  },\n  reindex: {\n    why: \"Rebuilds search artifacts after large changes to item corpus or provider/vector config.\",\n    examples: [\"pm reindex --mode keyword\", \"pm reindex --mode hybrid\"],\n  },\n  get: {\n    why: \"Shows complete details for one item by ID.\",\n    examples: [\"pm get pm-a1b2\", \"pm get pm-a1b2 --json\"],\n    tips: [\"JSON output shape is { item, body, linked, claim_state }; body is top-level (not item.body).\"],\n  },\n  history: {\n    why: \"Inspects item mutation timeline and audit trail.\",\n    examples: [\"pm history pm-a1b2 --limit 20\"],\n  },\n  activity: {\n    why: \"Reviews recent tracker-wide activity across items.\",\n    examples: [\n      \"pm activity --limit 50\",\n      \"pm activity --id pm-a1b2 --op update --author codex-agent --from -7d --to now\",\n      \"pm activity --json --stream rows --limit 200\",\n    ],\n    tips: [\"Use --stream with --json for line-delimited automation output; --from is inclusive and --to is exclusive.\"],\n  },\n  restore: {\n    why: \"Restores an item to a prior timestamp/version with history replay safety.\",\n    examples: ['pm restore pm-a1b2 2026-04-01T00:00:00.000Z --author \"codex-agent\" --message \"Rollback to known-good state\"'],\n  },\n  close: {\n    why: \"Transitions work to terminal closed state with explicit rationale.\",\n    examples: [\n      'pm close pm-a1b2 \"All acceptance criteria met\" --author \"codex-agent\" --message \"Close after verification\"',\n      'pm close pm-a1b2 \"Done\" --validate-close',\n      'pm close pm-a1b2 \"Done\" --validate-close off',\n      'pm close pm-a1b2 \"Done\" --validate-close strict',\n    ],\n  },\n  delete: {\n    why: \"Removes an item while preserving history evidence and lock/ownership checks.\",\n    examples: ['pm delete pm-a1b2 --author \"codex-agent\" --message \"Remove duplicate item\"'],\n  },\n  append: {\n    why: \"Adds implementation notes to body without replacing existing content.\",\n    examples: ['pm append pm-a1b2 --body \"Implemented retry with bounded backoff.\" --message \"Record implementation detail\"'],\n  },\n  comments: {\n    why: \"Adds or reviews lightweight status updates linked to an item.\",\n    examples: [\n      'pm comments pm-a1b2 \"Verified fix on Linux and macOS\"',\n      'pm comments pm-a1b2 --add \"Verified fix on Linux and macOS\"',\n      'printf \"%s\\\\n\" \"## Verification\" \"- linux pass\" \"- mac pass\" | pm comments pm-a1b2 --stdin',\n      'pm comments pm-a1b2 --file docs/release-evidence.md --author \"codex-agent\"',\n      'pm comments pm-a1b2 --add \"text: verification note with commas, key-like words, and parser details\"',\n      'pm comments pm-a1b2 --add \"Follow-up needed after review\" --author \"codex-agent\" --force',\n      \"pm comments pm-a1b2 --limit 10\",\n    ],\n    tips: [\n      \"Use exactly one comment source at a time: positional [text], --add, --stdin, or --file.\",\n      \"Use --force when adding comments to items currently assigned to a different owner.\",\n      \"When --add payload resembles CSV-like key fragments (for example text=hello,scope:project), plain-text fallback is intentional; use explicit text=..., markdown text: ..., or stdin token - for structured intent.\",\n    ],\n  },\n  \"comments-audit\": {\n    why: \"Audits latest comments or full history rows across filtered item sets.\",\n    examples: [\n      \"pm comments-audit --status open --latest 1\",\n      \"pm comments-audit --status open --latest 0\",\n      \"pm comments-audit --parent pm-feature01 --tag governance --sprint sprint-12 --release vnext --priority 0\",\n      \"pm comments-audit --full-history --limit 50\",\n    ],\n    tips: [\n      \"Use either --latest or --full-history (not both). --latest 0 returns item summaries without comment rows. --limit is an alias for --limit-items.\",\n    ],\n  },\n  notes: {\n    why: \"Adds or reviews durable implementation notes linked to an item.\",\n    examples: [\n      'pm notes pm-a1b2 --add \"Investigated parser edge case and documented fallback logic.\"',\n      'pm notes pm-a1b2 --add \"text: parser rationale with commas, colons, and key-like wording\"',\n      'pm notes pm-a1b2 --add \"Audit note\" --author \"reviewer\" --allow-audit-note',\n      \"pm notes pm-a1b2 --limit 10\",\n    ],\n    tips: [\n      \"Use --allow-audit-note for append-only non-owner audits; --allow-audit-comment remains supported as a legacy alias.\",\n      \"CSV-like add payloads with extra key fragments are treated as plain text by design; use explicit text keys (text= or text:) when structured parsing is required.\",\n    ],\n  },\n  learnings: {\n    why: \"Adds or reviews post-implementation learnings for future work.\",\n    examples: [\n      'pm learnings pm-a1b2 --add \"Avoid direct test-runner commands in linked tests; use sandbox runner.\"',\n      'pm learnings pm-a1b2 --add \"text: lesson with commas, key-like words, and punctuation-safe context\"',\n      'pm learnings pm-a1b2 --add \"Audit learning\" --author \"reviewer\" --allow-audit-learning',\n      \"pm learnings pm-a1b2 --limit 10\",\n    ],\n    tips: [\n      \"Use --allow-audit-learning for append-only non-owner audits; --allow-audit-comment remains supported as a legacy alias.\",\n      \"If you intended structured parsing for a key-like payload, prefer explicit text=..., markdown text: ..., or stdin token -; ambiguous CSV-like forms intentionally remain plain text.\",\n    ],\n  },\n  files: {\n    why: \"Associates changed source files with tracker items for reproducibility.\",\n    examples: [\n      'pm files pm-a1b2 --add \"path=src/cli/main.ts,scope=project,note=help orchestration\"',\n      \"pm files discover pm-a1b2\",\n      'pm files discover pm-a1b2 --apply --note \"discovered from item text\"',\n    ],\n  },\n  docs: {\n    why: \"Associates relevant documentation paths with tracker items.\",\n    examples: ['pm docs pm-a1b2 --add \"path=README.md,scope=project,note=user-facing command guidance\"'],\n  },\n  test: {\n    why: \"Links test commands/paths and optionally executes them for one item.\",\n    examples: [\n      'pm test pm-a1b2 --add \"command=node scripts/run-tests.mjs test -- tests/unit/output.spec.ts,scope=project,timeout_seconds=2400\"',\n      'pm test pm-a1b2 --add \"command=pm list-all --type Task --limit 200,scope=project,assert_stdout_contains=count:,assert_stdout_regex=count:\\\\s+\\\\d+\"',\n      'pm test pm-a1b2 --add \"command=pm list-all --type Task --limit 200,scope=project,pm_context_mode=auto\"',\n      \"pm test pm-a1b2 --run --timeout 2400 --env-set PORT=0 --env-clear PLAYWRIGHT_BASE_URL --shared-host-safe --pm-context tracker --fail-on-context-mismatch --fail-on-skipped\",\n      \"pm test pm-a1b2 --run --timeout 2400 --pm-context auto\",\n      \"pm test pm-a1b2 --run --background --timeout 2400 --progress\",\n    ],\n  },\n  \"test-all\": {\n    why: \"Runs linked tests in bulk for release/readiness sweeps.\",\n    examples: [\n      \"pm test-all --status in_progress --limit 5 --offset 10 --timeout 2400\",\n      \"pm test-all --status closed --timeout 3600 --progress --env-set PORT=0 --shared-host-safe --fail-on-skipped\",\n      \"pm test-all --status in_progress --pm-context tracker --fail-on-context-mismatch --require-assertions-for-pm\",\n      \"pm test-all --status in_progress --pm-context auto --fail-on-context-mismatch\",\n      \"pm test-all --status in_progress --background --timeout 3600\",\n    ],\n  },\n  \"test-runs\": {\n    why: \"Manages background linked-test runs with lifecycle controls and log/status inspection.\",\n    examples: [\n      \"pm test-runs list --status running --limit 20\",\n      \"pm test-runs status tr-abc123\",\n      \"pm test-runs logs tr-abc123 --stream stderr --tail 200\",\n      \"pm test-runs stop tr-abc123\",\n      \"pm test-runs resume tr-abc123\",\n    ],\n  },\n  stats: {\n    why: \"Reports tracker-level totals and distribution by type/status.\",\n    examples: [\"pm stats\", \"pm stats --json\"],\n  },\n  health: {\n    why: \"Validates tracker/runtime health including extension triage, migration, and integrity diagnostics.\",\n    examples: [\"pm health\", \"pm health --json\", \"pm health --check-only\", \"pm health --no-refresh\", \"pm health --refresh-vectors\"],\n  },\n  validate: {\n    why:\n      \"Runs standalone metadata, resolution, lifecycle (including dependency-cycle diagnostics), linked-file, linked-command reference, and history drift checks with default remediation hints for resolution gaps.\",\n    examples: [\n      \"pm validate\",\n      \"pm validate --check-resolution --json\",\n      \"pm validate --check-lifecycle --dependency-cycle-severity error\",\n      \"pm validate --check-files --scan-mode tracked-all\",\n      \"pm validate --check-files --scan-mode tracked-all-strict --include-pm-internals\",\n      \"pm validate --check-command-references\",\n      \"pm validate --check-resolution --fail-on-warn --json\",\n    ],\n    tips: [\"Resolution-gap warnings include default `pm update <id> ...` remediation hint templates in check details.\"],\n  },\n  gc: {\n    why: \"Cleans optional cache artifacts to keep local tracker state tidy.\",\n    examples: [\"pm gc\"],\n  },\n  claim: {\n    why: \"Claims an item to signal active ownership and reduce conflicts.\",\n    examples: [\n      'pm claim pm-a1b2 --author \"codex-agent\" --message \"Claim for implementation\"',\n      'pm claim pm-a1b2 --force --author \"codex-agent\" --message \"Take over terminal item\"',\n    ],\n    tips: [\"Claim takeover for non-terminal items does not require --force; --force is reserved for terminal/lock overrides.\"],\n  },\n  release: {\n    why: \"Releases an active claim when paused, handed off, or completed.\",\n    examples: [\n      'pm release pm-a1b2 --author \"codex-agent\" --message \"Release after closure\"',\n      'pm release pm-a1b2 --allow-audit-release --author \"reviewer\" --message \"Audit handoff release\"',\n    ],\n    tips: [\"Use --allow-audit-release for non-owner handoffs that only clear assignee metadata.\"],\n  },\n  \"start-task\": {\n    why: \"Lifecycle alias that claims an item and sets status to in_progress.\",\n    examples: ['pm start-task pm-a1b2 --author \"codex-agent\" --message \"Start implementation\"'],\n  },\n  \"pause-task\": {\n    why: \"Lifecycle alias that sets status to open and releases active assignment.\",\n    examples: ['pm pause-task pm-a1b2 --author \"codex-agent\" --message \"Pause for dependency unblock\"'],\n  },\n  \"close-task\": {\n    why: \"Lifecycle alias that closes with reason text and clears assignment metadata.\",\n    examples: ['pm close-task pm-a1b2 \"All acceptance criteria met\" --author \"codex-agent\" --message \"Close and handoff\"'],\n  },\n  completion: {\n    why: \"Generates shell completion scripts for faster and more reliable command entry.\",\n    examples: [\"pm completion bash\", \"pm completion zsh\", \"pm completion fish\", \"pm completion bash --eager-tags\"],\n    tips: [\"Default scripts resolve tag suggestions lazily at completion time; use --eager-tags to embed current tags directly.\"],\n  },\n  contracts: {\n    why: \"Exposes machine-readable CLI command and tool schema contracts for agent integrations.\",\n    examples: [\n      \"pm contracts\",\n      \"pm contracts --command list --runtime-only\",\n      \"pm contracts --command update --flags-only\",\n      \"pm contracts --availability-only --runtime-only\",\n      \"pm contracts --action create\",\n      \"pm contracts --schema-only\",\n    ],\n    tips: [\"Use --command to narrow actions/schema to one CLI surface; combine with --flags-only or --availability-only for lighter payloads.\"],\n  },\n};\n\nexport const ROOT_HELP_BUNDLE: HelpBundle = {\n  why: \"Provides deterministic project management workflows for humans and coding agents.\",\n  examples: [\n    \"pm init\",\n    \"pm guide\",\n    \"pm list-open --limit 10\",\n    'pm create --title \"...\" --description \"...\" --type Task --status open --priority 1 --message \"...\" --create-mode progressive',\n  ],\n  tips: [\n    \"Use <command> --help for command-specific guidance and examples.\",\n    \"Use pm guide for local docs and skills routing with progressive disclosure.\",\n    \"Use --json for machine parsing and integration flows.\",\n    \"Use --no-pager to force direct help output in CI and other non-interactive shells.\",\n  ],\n};\n\nfunction resolveCanonicalHelpPath(commandPath: string | undefined): string {\n  const normalized = normalizeHelpCommandPath(commandPath ?? \"\");\n  if (!normalized) {\n    return \"\";\n  }\n  return HELP_PATH_ALIASES[normalized] ?? normalized;\n}\n\nexport function resolveHelpBundleForPath(commandPath: string | undefined): HelpBundle {\n  const canonicalPath = resolveCanonicalHelpPath(commandPath);\n  if (!canonicalPath) {\n    return ROOT_HELP_BUNDLE;\n  }\n  return HELP_BY_COMMAND_PATH[canonicalPath] ?? ROOT_HELP_BUNDLE;\n}\n\nexport function resolveHelpNarrative(commandPath: string | undefined, detailMode: HelpDetailMode): HelpNarrative {\n  const bundle = resolveHelpBundleForPath(commandPath);\n  return {\n    intent: bundle.why,\n    examples: detailMode === \"detailed\" ? [...bundle.examples] : bundle.examples.length > 0 ? [bundle.examples[0]] : [],\n    tips: detailMode === \"detailed\" ? [...(bundle.tips ?? [])] : [],\n    detail_mode: detailMode,\n  };\n}\n\nexport function listDocumentedHelpPaths(): string[] {\n  return Object.keys(HELP_BY_COMMAND_PATH).sort((left, right) => left.localeCompare(right));\n}\n\nexport function attachRichHelpText(program: Command, argv: string[] = process.argv.slice(2)): void {\n  const detailMode = resolveHelpDetailMode(argv);\n  program.addHelpText(\"after\", renderHelpBundle(ROOT_HELP_BUNDLE, detailMode));\n  for (const [commandPath, bundle] of Object.entries(HELP_BY_COMMAND_PATH)) {\n    attachBundleByPath(program, commandPath, bundle, detailMode);\n  }\n}\n"]}