@unbrained/pm-cli 2026.6.23 → 2026.6.30

package/dist/cli/help-content.js

@@ -5,7 +5,7 @@
  * Implements first example or empty for the public runtime surface of this module.
  */
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="1a2a7293-fe21-5cea-9b44-64f8f159a18c")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="d7542ba0-4296-52db-a5c2-5cd68f5f3cf1")}catch(e){}}();
 export function firstExampleOrEmpty(examples) {
     return examples.length > 0 ? [examples[0]] : [];
 }
@@ -175,6 +175,8 @@ const HELP_BY_COMMAND_PATH = {
             "pm package init ./my-hook-package --capability hooks",
             "pm package init ./my-search-package --capability search",
             "pm package init ./my-sync-package --capability importers",
+            "pm package init ./my-domain-package --capability schema",
+            "pm package init ./my-output-package --capability renderers",
             "pm install ./my-sync-package --project",
             "pm package doctor --project --detail summary",
         ],
@@ -182,6 +184,8 @@ const HELP_BY_COMMAND_PATH = {
             "Use --capability hooks for a starter after_command lifecycle reactor with runnable SDK testing coverage.",
             "Use --capability search for a starter search provider/vector-store adapter with runnable SDK testing coverage.",
             "Use --capability importers for paired import/export commands that move project context across systems.",
+            "Use --capability schema for a starter custom item type, field, and migration so pm models your project domain.",
+            "Use --capability renderers/parser/preflight/services for starter override surfaces (output renderer, parsed-option rewrite, pre-run gate decision, built-in service) — one runnable starter per SDK capability.",
             "The generated package is local-install safe; add SDK runtime imports only after declaring dependencies and validating with package doctor.",
             "Use package doctor after changes to verify activation, policy, and collision diagnostics.",
         ],
@@ -217,6 +221,8 @@ const HELP_BY_COMMAND_PATH = {
             "pm extension init ./my-hook-extension --capability hooks",
             "pm extension init ./my-search-extension --capability search",
             "pm extension init ./my-sync-extension --capability importers",
+            "pm extension init ./my-domain-extension --capability schema",
+            "pm extension init ./my-output-extension --capability renderers",
             "pm extension --install --project ./my-sync-extension",
             "pm extension --doctor --project --detail summary",
         ],
@@ -224,6 +230,8 @@ const HELP_BY_COMMAND_PATH = {
             "Use --capability hooks when the extension should react to command lifecycle events.",
             "Use --capability search when the extension should register retrieval primitives.",
             "Use --capability importers when the extension should register project-context import/export commands.",
+            "Use --capability schema when the extension should register custom item types, fields, and migrations.",
+            "Use --capability renderers/parser/preflight/services to override pm's output rendering, parsed options, pre-run gate, or a built-in service.",
             "Use package init for new distributable package workflows; extension init is the compatibility-level runtime scaffold.",
         ],
     },
@@ -471,6 +479,22 @@ const HELP_BY_COMMAND_PATH = {
             "Configure defaults via pm config project set context --default-depth standard --activity-limit 15.",
         ],
     },
+    next: {
+        why: "Answers 'what should I work on now?' in one read: the single highest-priority ready item with rationale, plus the ranked ready and blocked queues (project management = context management).",
+        examples: [
+            "pm next",
+            "pm next --json",
+            "pm next --limit 3 --ready-only",
+            "pm next --parent pm-mpbb",
+            "pm next --assignee codex-agent --format markdown",
+        ],
+        tips: [
+            "Ready = active status, no open blockers, and no open children (a concrete leaf); the recommendation resumes in-progress work before starting new work.",
+            "An item is blocked when its scalar blocked_by or a blocked_by dependency points at a non-terminal item; the blocked list names the blockers to clear.",
+            "Containers (Epics/Features with open children) are never recommended directly — the actionable leaf beneath them is.",
+            "Use --parent to scope to one epic's subtree, or --ready-only to drop the blocked companion list for the tightest output.",
+        ],
+    },
     search: {
         why: "Finds relevant items by keyword, semantic, or hybrid retrieval modes.",
         examples: [
@@ -837,4 +861,4 @@ export const _testOnly = {
     renderDetailedHelpBundle,
 };
 //# sourceMappingURL=help-content.js.map
-//# debugId=1a2a7293-fe21-5cea-9b44-64f8f159a18c
+//# debugId=d7542ba0-4296-52db-a5c2-5cd68f5f3cf1

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

@@ -1 +1 @@
-{"version":3,"file":"help-content.js","sources":["cli/help-content.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module cli/help-content\n *\n * Provides CLI runtime support for Help Content.\n */\nimport { Command } from \"commander\";\n\n/**\n * Documents the help bundle payload exchanged by command, SDK, and package integrations.\n */\nexport interface HelpBundle {\n  why: string;\n  examples: string[];\n  tips?: string[];\n}\n\n/**\n * Documents the help narrative payload exchanged by command, SDK, and package integrations.\n */\nexport interface HelpNarrative {\n  intent: string;\n  examples: string[];\n  tips: string[];\n  detail_mode: HelpDetailMode;\n}\n\n/**\n * Restricts help detail mode values accepted by command, SDK, and storage contracts.\n */\nexport type HelpDetailMode = \"compact\" | \"detailed\";\n\n// Compact help/narrative surfaces show at most the first example. Centralizing this\n// keeps the empty-examples guard in one place for renderCompactHelpBundle and\n// resolveHelpNarrative (both must degrade to an empty list rather than [undefined]).\n/**\n * Implements first example or empty for the public runtime surface of this module.\n */\nexport function firstExampleOrEmpty(examples: string[]): string[] {\n  return examples.length > 0 ? [examples[0]] : [];\n}\n\nfunction renderCompactHelpBundle(bundle: HelpBundle): string {\n  const lines: string[] = [\n    \"\",\n    \"Intent:\",\n    `  ${bundle.why}`,\n  ];\n  const compactExamples = firstExampleOrEmpty(bundle.examples);\n  if (compactExamples.length > 0) {\n    lines.push(\"\", \"Example:\");\n    lines.push(`  ${compactExamples[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\n/**\n * Implements normalize help command path for the public runtime surface of this module.\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\n/**\n * Implements resolve help detail mode for the public runtime surface of this module.\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: [\n      \"pm init\",\n      \"pm init acme\",\n      \"pm init ./pm-sandbox --defaults\",\n      \"pm init --preset minimal\",\n      \"pm init --agent-guidance add\",\n      \"pm init --defaults --with-packages\",\n    ],\n    tips: [\n      \"Run this once per repository before create/list/update commands.\",\n      \"A path-like positional (`./dir`, `/tmp/dir`) initializes that tracker path; a plain word remains an id prefix.\",\n      \"Rewriting id prefix, governance preset, or default author on an existing tracker requires --force.\",\n      \"Use --preset for non-interactive automation; omit it in a TTY to use the setup wizard.\",\n      \"Use --agent-guidance add to inject compact AGENTS/CLAUDE workflow guidance, or --agent-guidance status to inspect missing guidance without modifying files.\",\n      \"Use --with-packages when agents need bundled commands such as calendar and templates available immediately.\",\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      \"Compatibility command for package-backed runtime extension lifecycle operations across project or global scope.\",\n    examples: [\n      \"pm install ./my-package --project\",\n      \"pm install '*' --project\",\n      \"pm package doctor --project --detail summary\",\n      \"pm package manage --global\",\n      \"pm package activate sample-ext --project\",\n      \"pm package deactivate sample-ext --project\",\n      \"pm package uninstall sample-ext --global\",\n      \"pm extension explore --project\",\n      \"pm extension manage --global\",\n      \"pm extension describe sample-ext --project\",\n      \"pm extension doctor --detail deep\",\n    ],\n    tips: [\n      \"Prefer pm install and pm package in new user-facing automation.\",\n      \"Use pm extension when maintaining existing extension-specific scripts or debugging the compatibility runtime directly.\",\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 --describe to map exactly what each loaded extension registers (commands, hooks, item types, providers, overrides) in one call.\",\n      \"Use --doctor for consolidated diagnostics with warning codes, remediation hints, and optional deep detail payloads.\",\n    ],\n  },\n  package: {\n    why:\n      \"Installs, explores, manages, diagnoses, adopts, activates, deactivates, and refreshes package-backed pm runtime extensions.\",\n    examples: [\n      \"pm install npm:@scope/pm-package --project\",\n      \"pm package install ./my-package --project\",\n      \"pm package doctor --project --detail deep\",\n      \"pm package manage --project --runtime-probe\",\n      \"pm package describe --project\",\n      \"pm package activate sample-ext --project\",\n      \"pm upgrade --packages-only --dry-run\",\n    ],\n    tips: [\n      \"Prefer package vocabulary for user-facing workflows; extension vocabulary remains available for compatibility.\",\n      \"Use pm package describe [name] to map every surface a package registers without reading its manifest or running diagnostics.\",\n      \"Use pm upgrade to refresh the CLI/SDK and managed packages from their recorded sources.\",\n      \"Use --dry-run before upgrade when automation needs a deterministic plan.\",\n    ],\n  },\n  \"package init\": {\n    why: \"Generates an installable starter pm package with package metadata and a root extension entrypoint.\",\n    examples: [\n      \"pm package init ./my-package\",\n      \"pm package init ./my-hook-package --capability hooks\",\n      \"pm package init ./my-search-package --capability search\",\n      \"pm package init ./my-sync-package --capability importers\",\n      \"pm install ./my-sync-package --project\",\n      \"pm package doctor --project --detail summary\",\n    ],\n    tips: [\n      \"Use --capability hooks for a starter after_command lifecycle reactor with runnable SDK testing coverage.\",\n      \"Use --capability search for a starter search provider/vector-store adapter with runnable SDK testing coverage.\",\n      \"Use --capability importers for paired import/export commands that move project context across systems.\",\n      \"The generated package is local-install safe; add SDK runtime imports only after declaring dependencies and validating with package doctor.\",\n      \"Use package doctor after changes to verify activation, policy, and collision diagnostics.\",\n    ],\n  },\n  \"package install\": {\n    why: \"Installs pm packages from local paths, npm sources, GitHub sources, bundled aliases, or wildcard/all aliases.\",\n    examples: [\n      \"pm package install ./my-package --project\",\n      \"pm install npm:pm-changelog --project\",\n      \"pm package install --github org/repo/packages/my-pm-package --ref main\",\n    ],\n    tips: [\n      \"Prefer the top-level pm install alias in scripts when only installation is needed.\",\n      \"Run pm package manage or pm package doctor after installing external packages.\",\n    ],\n  },\n  \"package catalog\": {\n    why: \"Lists bundled first-party package catalog metadata and compact field projections.\",\n    examples: [\n      \"pm package catalog --project\",\n      \"pm package catalog --project --fields alias,installed,install_command\",\n      \"pm package list --project --fields alias,package_name,category\",\n    ],\n    tips: [\n      \"Use --fields for low-token package discovery in agent loops.\",\n      \"External npm package discovery still belongs to npm search.\",\n    ],\n  },\n  \"extension init\": {\n    why: \"Generates an installable starter runtime extension with manifest and entrypoint files.\",\n    examples: [\n      \"pm extension init ./my-extension\",\n      \"pm extension init ./my-hook-extension --capability hooks\",\n      \"pm extension init ./my-search-extension --capability search\",\n      \"pm extension init ./my-sync-extension --capability importers\",\n      \"pm extension --install --project ./my-sync-extension\",\n      \"pm extension --doctor --project --detail summary\",\n    ],\n    tips: [\n      \"Use --capability hooks when the extension should react to command lifecycle events.\",\n      \"Use --capability search when the extension should register retrieval primitives.\",\n      \"Use --capability importers when the extension should register project-context import/export commands.\",\n      \"Use package init for new distributable package workflows; extension init is the compatibility-level runtime scaffold.\",\n    ],\n  },\n  \"extension install\": {\n    why: \"Installs a compatibility runtime extension from local, npm, GitHub, bundled alias, or wildcard sources.\",\n    examples: [\n      \"pm extension install ./my-extension --project\",\n      \"pm extension --install --project ./my-extension\",\n      \"pm extension doctor --project --detail summary\",\n    ],\n    tips: [\"Prefer pm install or pm package install for new package-first automation.\"],\n  },\n  \"extension catalog\": {\n    why: \"Compatibility view of bundled package catalog metadata.\",\n    examples: [\n      \"pm extension catalog --project\",\n      \"pm extension catalog --project --fields alias,installed,install_command\",\n    ],\n    tips: [\"Prefer pm package catalog in new user-facing workflows.\"],\n  },\n  install: {\n    why: \"Installs a pm package into project scope by default, using local, npm, GitHub, or bundled alias sources.\",\n    examples: [\n      \"pm install '*' --project\",\n      \"pm install ./packages/pm-todos --project\",\n      \"pm install npm:@scope/pm-package --global\",\n      \"pm install --github org/repo/packages/my-pm-package --ref main\",\n    ],\n    tips: [\"Installed packages are recorded in managed state and can be inspected with pm package manage.\"],\n  },\n  upgrade: {\n    why: \"Updates the global pm CLI/SDK and refreshes managed pm packages from recorded install sources.\",\n    examples: [\n      \"pm upgrade --dry-run\",\n      \"pm upgrade --packages-only --project\",\n      \"pm upgrade todos --dry-run\",\n      \"pm upgrade --cli-only --repair\",\n      \"pm upgrade --tag next --dry-run\",\n    ],\n    tips: [\n      \"Omit target to include the CLI/SDK plus all managed packages in the selected scope.\",\n      \"Pass a target to refresh one managed package by name, directory, package name, or source.\",\n      \"Use --packages-only in repository automation when the global CLI should not be changed.\",\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,note=tracked asset\" --test \"command=node scripts/run-tests.mjs test,timeout_seconds=240\" --doc \"path=README.md,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  focus: {\n    why: \"Sets a session focused item so new pm create items default their --parent to it (project management = context management).\",\n    examples: [\n      \"pm focus pm-epic1\",\n      \"pm focus\",\n      \"pm focus --clear\",\n    ],\n    tips: [\n      \"Focus is session-local (stored in .agents/pm/runtime/session.json, gitignored) — it never affects teammates.\",\n      \"An explicit --parent on pm create always overrides the focused item; use --parent \\\"\\\" to create with no parent.\",\n      \"A stale focused item produces the same missing-parent validation as an explicit stale --parent.\",\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,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  \"close-many\": {\n    why: \"Bulk-closes matched items with a shared reason routed through full pm close semantics (close validation, active-child orphan checks, blocked-edge cleanup) plus dry-run previews and rollback checkpoints — unlike update-many --status closed, which bypasses close validation.\",\n    examples: [\n      'pm close-many --filter-sprint S-12 --reason \"Sprint S-12 acceptance criteria met\" --dry-run',\n      'pm close-many --filter-tag wave:7 --reason \"Superseded by redesign\" --validate-close warn',\n      'pm close-many --ids pm-a,pm-b,pm-c --reason \"Closed in batch\" --resolution \"Verified by integration suite\"',\n      \"pm close-many --rollback close-many-20260604-abc123\",\n    ],\n    tips: [\n      \"At least one filter (--filter-* or --ids) is required so close-many never matches every item.\",\n      \"Already-terminal matches are skipped by default; pass --force to re-close them.\",\n      \"Use --dry-run to preview matches plus per-item skip reasons and active-child orphan warnings before applying.\",\n      \"Checkpoints are enabled by default for apply mode; restore with --rollback <checkpoint-id>.\",\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 install guide-shell --project\",\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/Decisions/Event/Reminder/Milestone/Meeting/Plan.\",\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  eval: {\n    why: \"Measures search relevance against a curated golden-query set so retrieval regressions are caught, not guessed.\",\n    examples: [\n      \"pm eval --json\",\n      \"pm eval --mode hybrid --k 10\",\n      \"pm eval --fail-under 0.6 --json\",\n      \"pm eval --queries ./my-eval.json --mode semantic\",\n    ],\n    tips: [\n      \"Curate ground truth in <pmRoot>/search/eval-queries.json as an array of {query, relevant_ids, mode?} objects.\",\n      \"Wire --fail-under into CI to fail the build when aggregate nDCG@k drops below your baseline.\",\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 --progress --json\"],\n    tips: [\n      \"Use --progress for non-interactive visibility during local embedding runs.\",\n      \"JSON output includes semantic stale/unchanged/embed/upsert counts so agents can gate long reindex work without parsing stderr.\",\n    ],\n  },\n  get: {\n    why: \"Shows details for one item by ID, with optional lower-token projections for agent loops.\",\n    examples: [\n      \"pm get pm-a1b2\",\n      \"pm get pm-a1b2 --depth brief --json\",\n      \"pm get pm-a1b2 --fields id,title,status,parent,type --json\",\n    ],\n    tips: [\n      \"Default depth is standard for body plus linked artifacts without append-only logs; use brief for metadata-only checks or --full for complete history-heavy metadata.\",\n      \"Use --fields for the smallest deterministic item metadata payload when an agent only needs specific fields.\",\n      \"JSON output shape is { item, linked, claim_state, children }; body is nested at item.body (parity with list --include-body), and children appears for requested/container rollups.\",\n    ],\n  },\n  history: {\n    why: \"Inspects item mutation timeline and audit trail.\",\n    examples: [\"pm history pm-a1b2 --limit 20\", \"pm history pm-a1b2 --full --verify\"],\n  },\n  \"history-compact\": {\n    why: \"Compacts long history streams into a synthetic checkpoint while preserving replay integrity. Pass an item id for one stream, or a bulk selector (--ids/--all-over/--closed/--all-streams) to sweep many.\",\n    examples: [\n      \"pm history-compact pm-a1b2 --dry-run\",\n      \"pm history-compact pm-a1b2 --before 25 --author codex-agent --message \\\"Compact early history\\\"\",\n      \"pm history-compact --all-over 500 --dry-run\",\n      \"pm history-compact --closed --author codex-agent\",\n      \"pm history-compact --ids pm-a1b2,pm-c3d4 --dry-run\",\n    ],\n  },\n  activity: {\n    why: \"Reviews recent tracker-wide activity across items.\",\n    examples: [\n      \"pm activity --limit 50\",\n      \"pm activity --full --id pm-a1b2 --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,note=help orchestration\"',\n      'pm files pm-a1b2 --add src/cli/main.ts --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: [\n      'pm docs pm-a1b2 --add \"path=README.md,note=user-facing command guidance\"',\n      'pm docs pm-a1b2 --add README.md --note \"user-facing command guidance\"',\n    ],\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,timeout_seconds=2400\"',\n      'pm test pm-a1b2 --add \"command=pm list-all --type Task --limit 200,assert_stdout_contains=count:,assert_stdout_regex=count:\\\\s+\\\\d+\"',\n      'pm test pm-a1b2 --add \"command=pm list-all --type Task --limit 200,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  telemetry: {\n    why: \"Inspects and manages local telemetry queue/runtime state for observability diagnostics.\",\n    examples: [\n      \"pm telemetry status\",\n      \"pm telemetry stats --limit 10\",\n      \"pm telemetry flush\",\n      \"pm telemetry clear\",\n    ],\n  },\n  health: {\n    why: \"Validates tracker/runtime health including extension triage, migration, and integrity diagnostics.\",\n    examples: [\n      \"pm health\",\n      \"pm health --check-only --summary --json\",\n      \"pm health --brief --json\",\n      \"pm health --no-refresh\",\n      \"pm health --refresh-vectors\",\n    ],\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-lifecycle --parent-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: \"Deletes optional cache artifacts by default to keep local tracker state tidy; use --dry-run to preview targets without deleting files.\",\n    examples: [\"pm gc --dry-run\", \"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  meet: {\n    why: \"Shortcut to create a Meeting from friendly time flags (start/duration) without structured --event CSV.\",\n    examples: [\n      'pm meet \"Sprint Planning\" --start +1h --duration 1h',\n      'pm meet \"1:1\" --start 2026-07-01T15:00:00Z --end 2026-07-01T15:30:00Z --location \"Room A\"',\n    ],\n    tips: [\n      \"Start defaults to now and duration to 1h; pass --end to set an explicit end instead of --duration.\",\n      \"--duration accepts relative tokens (h/d/w/m where m is months) plus sub-hour forms like 30min or PT30M.\",\n    ],\n  },\n  event: {\n    why: \"Shortcut to create an Event from friendly time flags (start/duration) without structured --event CSV.\",\n    examples: [\n      'pm event \"Release v2\" --start 2026-07-01T10:00:00Z --duration 2h',\n      'pm event \"Conference\" --start 2026-08-01 --all-day',\n    ],\n    tips: [\n      \"Start defaults to now and duration to 1h; pass --end to set an explicit end instead of --duration.\",\n      \"--duration accepts relative tokens (h/d/w/m where m is months) plus sub-hour forms like 30min or PT30M.\",\n    ],\n  },\n  remind: {\n    why: \"Shortcut to create a Reminder from a single point in time without structured --reminder CSV.\",\n    examples: ['pm remind \"Review PR\" --at +2d', 'pm remind \"Follow up\" --at 2026-07-01T09:00:00Z --text \"Ping the team\"'],\n    tips: [\"The reminder time defaults to +1d and the reminder text defaults to the title.\"],\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 install guide-shell --project\",\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    \"Install guide-shell before using pm guide for local docs and skills routing.\",\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\n/**\n * Implements resolve help bundle for path for the public runtime surface of this module.\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\n/**\n * Implements resolve help narrative for the public runtime surface of this module.\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] : firstExampleOrEmpty(bundle.examples),\n    tips: detailMode === \"detailed\" ? [...(bundle.tips ?? [])] : [],\n    detail_mode: detailMode,\n  };\n}\n\n/**\n * Implements attach rich help text for the public runtime surface of this module.\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\nexport const _testOnly = {\n  renderCompactHelpBundle,\n  renderDetailedHelpBundle,\n};\n"],"names":[],"mappings":"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","debugId":"1a2a7293-fe21-5cea-9b44-64f8f159a18c"}
+{"version":3,"file":"help-content.js","sources":["cli/help-content.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module cli/help-content\n *\n * Provides CLI runtime support for Help Content.\n */\nimport { Command } from \"commander\";\n\n/**\n * Documents the help bundle payload exchanged by command, SDK, and package integrations.\n */\nexport interface HelpBundle {\n  why: string;\n  examples: string[];\n  tips?: string[];\n}\n\n/**\n * Documents the help narrative payload exchanged by command, SDK, and package integrations.\n */\nexport interface HelpNarrative {\n  intent: string;\n  examples: string[];\n  tips: string[];\n  detail_mode: HelpDetailMode;\n}\n\n/**\n * Restricts help detail mode values accepted by command, SDK, and storage contracts.\n */\nexport type HelpDetailMode = \"compact\" | \"detailed\";\n\n// Compact help/narrative surfaces show at most the first example. Centralizing this\n// keeps the empty-examples guard in one place for renderCompactHelpBundle and\n// resolveHelpNarrative (both must degrade to an empty list rather than [undefined]).\n/**\n * Implements first example or empty for the public runtime surface of this module.\n */\nexport function firstExampleOrEmpty(examples: string[]): string[] {\n  return examples.length > 0 ? [examples[0]] : [];\n}\n\nfunction renderCompactHelpBundle(bundle: HelpBundle): string {\n  const lines: string[] = [\n    \"\",\n    \"Intent:\",\n    `  ${bundle.why}`,\n  ];\n  const compactExamples = firstExampleOrEmpty(bundle.examples);\n  if (compactExamples.length > 0) {\n    lines.push(\"\", \"Example:\");\n    lines.push(`  ${compactExamples[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\n/**\n * Implements normalize help command path for the public runtime surface of this module.\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\n/**\n * Implements resolve help detail mode for the public runtime surface of this module.\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: [\n      \"pm init\",\n      \"pm init acme\",\n      \"pm init ./pm-sandbox --defaults\",\n      \"pm init --preset minimal\",\n      \"pm init --agent-guidance add\",\n      \"pm init --defaults --with-packages\",\n    ],\n    tips: [\n      \"Run this once per repository before create/list/update commands.\",\n      \"A path-like positional (`./dir`, `/tmp/dir`) initializes that tracker path; a plain word remains an id prefix.\",\n      \"Rewriting id prefix, governance preset, or default author on an existing tracker requires --force.\",\n      \"Use --preset for non-interactive automation; omit it in a TTY to use the setup wizard.\",\n      \"Use --agent-guidance add to inject compact AGENTS/CLAUDE workflow guidance, or --agent-guidance status to inspect missing guidance without modifying files.\",\n      \"Use --with-packages when agents need bundled commands such as calendar and templates available immediately.\",\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      \"Compatibility command for package-backed runtime extension lifecycle operations across project or global scope.\",\n    examples: [\n      \"pm install ./my-package --project\",\n      \"pm install '*' --project\",\n      \"pm package doctor --project --detail summary\",\n      \"pm package manage --global\",\n      \"pm package activate sample-ext --project\",\n      \"pm package deactivate sample-ext --project\",\n      \"pm package uninstall sample-ext --global\",\n      \"pm extension explore --project\",\n      \"pm extension manage --global\",\n      \"pm extension describe sample-ext --project\",\n      \"pm extension doctor --detail deep\",\n    ],\n    tips: [\n      \"Prefer pm install and pm package in new user-facing automation.\",\n      \"Use pm extension when maintaining existing extension-specific scripts or debugging the compatibility runtime directly.\",\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 --describe to map exactly what each loaded extension registers (commands, hooks, item types, providers, overrides) in one call.\",\n      \"Use --doctor for consolidated diagnostics with warning codes, remediation hints, and optional deep detail payloads.\",\n    ],\n  },\n  package: {\n    why:\n      \"Installs, explores, manages, diagnoses, adopts, activates, deactivates, and refreshes package-backed pm runtime extensions.\",\n    examples: [\n      \"pm install npm:@scope/pm-package --project\",\n      \"pm package install ./my-package --project\",\n      \"pm package doctor --project --detail deep\",\n      \"pm package manage --project --runtime-probe\",\n      \"pm package describe --project\",\n      \"pm package activate sample-ext --project\",\n      \"pm upgrade --packages-only --dry-run\",\n    ],\n    tips: [\n      \"Prefer package vocabulary for user-facing workflows; extension vocabulary remains available for compatibility.\",\n      \"Use pm package describe [name] to map every surface a package registers without reading its manifest or running diagnostics.\",\n      \"Use pm upgrade to refresh the CLI/SDK and managed packages from their recorded sources.\",\n      \"Use --dry-run before upgrade when automation needs a deterministic plan.\",\n    ],\n  },\n  \"package init\": {\n    why: \"Generates an installable starter pm package with package metadata and a root extension entrypoint.\",\n    examples: [\n      \"pm package init ./my-package\",\n      \"pm package init ./my-hook-package --capability hooks\",\n      \"pm package init ./my-search-package --capability search\",\n      \"pm package init ./my-sync-package --capability importers\",\n      \"pm package init ./my-domain-package --capability schema\",\n      \"pm package init ./my-output-package --capability renderers\",\n      \"pm install ./my-sync-package --project\",\n      \"pm package doctor --project --detail summary\",\n    ],\n    tips: [\n      \"Use --capability hooks for a starter after_command lifecycle reactor with runnable SDK testing coverage.\",\n      \"Use --capability search for a starter search provider/vector-store adapter with runnable SDK testing coverage.\",\n      \"Use --capability importers for paired import/export commands that move project context across systems.\",\n      \"Use --capability schema for a starter custom item type, field, and migration so pm models your project domain.\",\n      \"Use --capability renderers/parser/preflight/services for starter override surfaces (output renderer, parsed-option rewrite, pre-run gate decision, built-in service) — one runnable starter per SDK capability.\",\n      \"The generated package is local-install safe; add SDK runtime imports only after declaring dependencies and validating with package doctor.\",\n      \"Use package doctor after changes to verify activation, policy, and collision diagnostics.\",\n    ],\n  },\n  \"package install\": {\n    why: \"Installs pm packages from local paths, npm sources, GitHub sources, bundled aliases, or wildcard/all aliases.\",\n    examples: [\n      \"pm package install ./my-package --project\",\n      \"pm install npm:pm-changelog --project\",\n      \"pm package install --github org/repo/packages/my-pm-package --ref main\",\n    ],\n    tips: [\n      \"Prefer the top-level pm install alias in scripts when only installation is needed.\",\n      \"Run pm package manage or pm package doctor after installing external packages.\",\n    ],\n  },\n  \"package catalog\": {\n    why: \"Lists bundled first-party package catalog metadata and compact field projections.\",\n    examples: [\n      \"pm package catalog --project\",\n      \"pm package catalog --project --fields alias,installed,install_command\",\n      \"pm package list --project --fields alias,package_name,category\",\n    ],\n    tips: [\n      \"Use --fields for low-token package discovery in agent loops.\",\n      \"External npm package discovery still belongs to npm search.\",\n    ],\n  },\n  \"extension init\": {\n    why: \"Generates an installable starter runtime extension with manifest and entrypoint files.\",\n    examples: [\n      \"pm extension init ./my-extension\",\n      \"pm extension init ./my-hook-extension --capability hooks\",\n      \"pm extension init ./my-search-extension --capability search\",\n      \"pm extension init ./my-sync-extension --capability importers\",\n      \"pm extension init ./my-domain-extension --capability schema\",\n      \"pm extension init ./my-output-extension --capability renderers\",\n      \"pm extension --install --project ./my-sync-extension\",\n      \"pm extension --doctor --project --detail summary\",\n    ],\n    tips: [\n      \"Use --capability hooks when the extension should react to command lifecycle events.\",\n      \"Use --capability search when the extension should register retrieval primitives.\",\n      \"Use --capability importers when the extension should register project-context import/export commands.\",\n      \"Use --capability schema when the extension should register custom item types, fields, and migrations.\",\n      \"Use --capability renderers/parser/preflight/services to override pm's output rendering, parsed options, pre-run gate, or a built-in service.\",\n      \"Use package init for new distributable package workflows; extension init is the compatibility-level runtime scaffold.\",\n    ],\n  },\n  \"extension install\": {\n    why: \"Installs a compatibility runtime extension from local, npm, GitHub, bundled alias, or wildcard sources.\",\n    examples: [\n      \"pm extension install ./my-extension --project\",\n      \"pm extension --install --project ./my-extension\",\n      \"pm extension doctor --project --detail summary\",\n    ],\n    tips: [\"Prefer pm install or pm package install for new package-first automation.\"],\n  },\n  \"extension catalog\": {\n    why: \"Compatibility view of bundled package catalog metadata.\",\n    examples: [\n      \"pm extension catalog --project\",\n      \"pm extension catalog --project --fields alias,installed,install_command\",\n    ],\n    tips: [\"Prefer pm package catalog in new user-facing workflows.\"],\n  },\n  install: {\n    why: \"Installs a pm package into project scope by default, using local, npm, GitHub, or bundled alias sources.\",\n    examples: [\n      \"pm install '*' --project\",\n      \"pm install ./packages/pm-todos --project\",\n      \"pm install npm:@scope/pm-package --global\",\n      \"pm install --github org/repo/packages/my-pm-package --ref main\",\n    ],\n    tips: [\"Installed packages are recorded in managed state and can be inspected with pm package manage.\"],\n  },\n  upgrade: {\n    why: \"Updates the global pm CLI/SDK and refreshes managed pm packages from recorded install sources.\",\n    examples: [\n      \"pm upgrade --dry-run\",\n      \"pm upgrade --packages-only --project\",\n      \"pm upgrade todos --dry-run\",\n      \"pm upgrade --cli-only --repair\",\n      \"pm upgrade --tag next --dry-run\",\n    ],\n    tips: [\n      \"Omit target to include the CLI/SDK plus all managed packages in the selected scope.\",\n      \"Pass a target to refresh one managed package by name, directory, package name, or source.\",\n      \"Use --packages-only in repository automation when the global CLI should not be changed.\",\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,note=tracked asset\" --test \"command=node scripts/run-tests.mjs test,timeout_seconds=240\" --doc \"path=README.md,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  focus: {\n    why: \"Sets a session focused item so new pm create items default their --parent to it (project management = context management).\",\n    examples: [\n      \"pm focus pm-epic1\",\n      \"pm focus\",\n      \"pm focus --clear\",\n    ],\n    tips: [\n      \"Focus is session-local (stored in .agents/pm/runtime/session.json, gitignored) — it never affects teammates.\",\n      \"An explicit --parent on pm create always overrides the focused item; use --parent \\\"\\\" to create with no parent.\",\n      \"A stale focused item produces the same missing-parent validation as an explicit stale --parent.\",\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,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  \"close-many\": {\n    why: \"Bulk-closes matched items with a shared reason routed through full pm close semantics (close validation, active-child orphan checks, blocked-edge cleanup) plus dry-run previews and rollback checkpoints — unlike update-many --status closed, which bypasses close validation.\",\n    examples: [\n      'pm close-many --filter-sprint S-12 --reason \"Sprint S-12 acceptance criteria met\" --dry-run',\n      'pm close-many --filter-tag wave:7 --reason \"Superseded by redesign\" --validate-close warn',\n      'pm close-many --ids pm-a,pm-b,pm-c --reason \"Closed in batch\" --resolution \"Verified by integration suite\"',\n      \"pm close-many --rollback close-many-20260604-abc123\",\n    ],\n    tips: [\n      \"At least one filter (--filter-* or --ids) is required so close-many never matches every item.\",\n      \"Already-terminal matches are skipped by default; pass --force to re-close them.\",\n      \"Use --dry-run to preview matches plus per-item skip reasons and active-child orphan warnings before applying.\",\n      \"Checkpoints are enabled by default for apply mode; restore with --rollback <checkpoint-id>.\",\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 install guide-shell --project\",\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/Decisions/Event/Reminder/Milestone/Meeting/Plan.\",\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  next: {\n    why: \"Answers 'what should I work on now?' in one read: the single highest-priority ready item with rationale, plus the ranked ready and blocked queues (project management = context management).\",\n    examples: [\n      \"pm next\",\n      \"pm next --json\",\n      \"pm next --limit 3 --ready-only\",\n      \"pm next --parent pm-mpbb\",\n      \"pm next --assignee codex-agent --format markdown\",\n    ],\n    tips: [\n      \"Ready = active status, no open blockers, and no open children (a concrete leaf); the recommendation resumes in-progress work before starting new work.\",\n      \"An item is blocked when its scalar blocked_by or a blocked_by dependency points at a non-terminal item; the blocked list names the blockers to clear.\",\n      \"Containers (Epics/Features with open children) are never recommended directly — the actionable leaf beneath them is.\",\n      \"Use --parent to scope to one epic's subtree, or --ready-only to drop the blocked companion list for the tightest output.\",\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  eval: {\n    why: \"Measures search relevance against a curated golden-query set so retrieval regressions are caught, not guessed.\",\n    examples: [\n      \"pm eval --json\",\n      \"pm eval --mode hybrid --k 10\",\n      \"pm eval --fail-under 0.6 --json\",\n      \"pm eval --queries ./my-eval.json --mode semantic\",\n    ],\n    tips: [\n      \"Curate ground truth in <pmRoot>/search/eval-queries.json as an array of {query, relevant_ids, mode?} objects.\",\n      \"Wire --fail-under into CI to fail the build when aggregate nDCG@k drops below your baseline.\",\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 --progress --json\"],\n    tips: [\n      \"Use --progress for non-interactive visibility during local embedding runs.\",\n      \"JSON output includes semantic stale/unchanged/embed/upsert counts so agents can gate long reindex work without parsing stderr.\",\n    ],\n  },\n  get: {\n    why: \"Shows details for one item by ID, with optional lower-token projections for agent loops.\",\n    examples: [\n      \"pm get pm-a1b2\",\n      \"pm get pm-a1b2 --depth brief --json\",\n      \"pm get pm-a1b2 --fields id,title,status,parent,type --json\",\n    ],\n    tips: [\n      \"Default depth is standard for body plus linked artifacts without append-only logs; use brief for metadata-only checks or --full for complete history-heavy metadata.\",\n      \"Use --fields for the smallest deterministic item metadata payload when an agent only needs specific fields.\",\n      \"JSON output shape is { item, linked, claim_state, children }; body is nested at item.body (parity with list --include-body), and children appears for requested/container rollups.\",\n    ],\n  },\n  history: {\n    why: \"Inspects item mutation timeline and audit trail.\",\n    examples: [\"pm history pm-a1b2 --limit 20\", \"pm history pm-a1b2 --full --verify\"],\n  },\n  \"history-compact\": {\n    why: \"Compacts long history streams into a synthetic checkpoint while preserving replay integrity. Pass an item id for one stream, or a bulk selector (--ids/--all-over/--closed/--all-streams) to sweep many.\",\n    examples: [\n      \"pm history-compact pm-a1b2 --dry-run\",\n      \"pm history-compact pm-a1b2 --before 25 --author codex-agent --message \\\"Compact early history\\\"\",\n      \"pm history-compact --all-over 500 --dry-run\",\n      \"pm history-compact --closed --author codex-agent\",\n      \"pm history-compact --ids pm-a1b2,pm-c3d4 --dry-run\",\n    ],\n  },\n  activity: {\n    why: \"Reviews recent tracker-wide activity across items.\",\n    examples: [\n      \"pm activity --limit 50\",\n      \"pm activity --full --id pm-a1b2 --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,note=help orchestration\"',\n      'pm files pm-a1b2 --add src/cli/main.ts --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: [\n      'pm docs pm-a1b2 --add \"path=README.md,note=user-facing command guidance\"',\n      'pm docs pm-a1b2 --add README.md --note \"user-facing command guidance\"',\n    ],\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,timeout_seconds=2400\"',\n      'pm test pm-a1b2 --add \"command=pm list-all --type Task --limit 200,assert_stdout_contains=count:,assert_stdout_regex=count:\\\\s+\\\\d+\"',\n      'pm test pm-a1b2 --add \"command=pm list-all --type Task --limit 200,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  telemetry: {\n    why: \"Inspects and manages local telemetry queue/runtime state for observability diagnostics.\",\n    examples: [\n      \"pm telemetry status\",\n      \"pm telemetry stats --limit 10\",\n      \"pm telemetry flush\",\n      \"pm telemetry clear\",\n    ],\n  },\n  health: {\n    why: \"Validates tracker/runtime health including extension triage, migration, and integrity diagnostics.\",\n    examples: [\n      \"pm health\",\n      \"pm health --check-only --summary --json\",\n      \"pm health --brief --json\",\n      \"pm health --no-refresh\",\n      \"pm health --refresh-vectors\",\n    ],\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-lifecycle --parent-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: \"Deletes optional cache artifacts by default to keep local tracker state tidy; use --dry-run to preview targets without deleting files.\",\n    examples: [\"pm gc --dry-run\", \"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  meet: {\n    why: \"Shortcut to create a Meeting from friendly time flags (start/duration) without structured --event CSV.\",\n    examples: [\n      'pm meet \"Sprint Planning\" --start +1h --duration 1h',\n      'pm meet \"1:1\" --start 2026-07-01T15:00:00Z --end 2026-07-01T15:30:00Z --location \"Room A\"',\n    ],\n    tips: [\n      \"Start defaults to now and duration to 1h; pass --end to set an explicit end instead of --duration.\",\n      \"--duration accepts relative tokens (h/d/w/m where m is months) plus sub-hour forms like 30min or PT30M.\",\n    ],\n  },\n  event: {\n    why: \"Shortcut to create an Event from friendly time flags (start/duration) without structured --event CSV.\",\n    examples: [\n      'pm event \"Release v2\" --start 2026-07-01T10:00:00Z --duration 2h',\n      'pm event \"Conference\" --start 2026-08-01 --all-day',\n    ],\n    tips: [\n      \"Start defaults to now and duration to 1h; pass --end to set an explicit end instead of --duration.\",\n      \"--duration accepts relative tokens (h/d/w/m where m is months) plus sub-hour forms like 30min or PT30M.\",\n    ],\n  },\n  remind: {\n    why: \"Shortcut to create a Reminder from a single point in time without structured --reminder CSV.\",\n    examples: ['pm remind \"Review PR\" --at +2d', 'pm remind \"Follow up\" --at 2026-07-01T09:00:00Z --text \"Ping the team\"'],\n    tips: [\"The reminder time defaults to +1d and the reminder text defaults to the title.\"],\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 install guide-shell --project\",\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    \"Install guide-shell before using pm guide for local docs and skills routing.\",\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\n/**\n * Implements resolve help bundle for path for the public runtime surface of this module.\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\n/**\n * Implements resolve help narrative for the public runtime surface of this module.\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] : firstExampleOrEmpty(bundle.examples),\n    tips: detailMode === \"detailed\" ? [...(bundle.tips ?? [])] : [],\n    detail_mode: detailMode,\n  };\n}\n\n/**\n * Implements attach rich help text for the public runtime surface of this module.\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\nexport const _testOnly = {\n  renderCompactHelpBundle,\n  renderDetailedHelpBundle,\n};\n"],"names":[],"mappings":"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","debugId":"d7542ba0-4296-52db-a5c2-5cd68f5f3cf1"}

package/dist/cli/help-json-payload.js

@@ -1,5 +1,5 @@
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="c5494fa8-5038-5b37-b511-887d9144262c")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="913c0a00-924f-520e-adb6-4073fdb73413")}catch(e){}}();
 import { commandOptionFlagLabel, resolveCommandOptionPolicyState, resolveTypeDefinition, } from "../core/item/type-registry.js";
 import { EXIT_CODE } from "../core/shared/constants.js";
 import { printError, writeStdout } from "../core/output/output.js";
@@ -217,7 +217,7 @@ export async function maybeRenderBootstrapJsonHelp(rootProgram, argv, extensionD
             const unknownMessage = `unknown command '${helpRequest.commandPathTokens.join(" ")}'`;
             const runtimeContext = buildUnknownCommandGuidanceFromRuntime(unknownMessage, rootProgram, extensionDescriptors);
             const envelope = formatCommanderErrorForJson(unknownMessage, "help", BUILTIN_TYPE_HELP_VALUES, EXIT_CODE.USAGE, {
-                ...(runtimeContext ?? {}),
+                ...runtimeContext,
                 attemptedCommand: renderAttemptedCommand(argv),
                 normalizedInvocationArgs: [...argv],
                 providedOptionFlags: extractProvidedOptionFlags(argv),
@@ -320,4 +320,4 @@ export const _testOnly = {
     readOptionAttributeName,
 };
 //# sourceMappingURL=help-json-payload.js.map
-//# debugId=c5494fa8-5038-5b37-b511-887d9144262c
+//# debugId=913c0a00-924f-520e-adb6-4073fdb73413

package/dist/cli/help-json-payload.js.map

@@ -1 +1 @@
-{"version":3,"file":"help-json-payload.js","sources":["cli/help-json-payload.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module cli/help-json-payload\n *\n * Provides CLI runtime support for Help Json Payload.\n */\nimport { Command } from \"commander\";\nimport {\n  commandOptionFlagLabel,\n  resolveCommandOptionPolicyState,\n  resolveItemTypeRegistry,\n  resolveTypeDefinition,\n} from \"../core/item/type-registry.js\";\nimport { EXIT_CODE } from \"../core/shared/constants.js\";\nimport { printError, writeStdout } from \"../core/output/output.js\";\nimport {\n  type HelpOptionSummary,\n  type ExtensionCommandHelpDescriptor,\n  buildDynamicExtensionHelpOptionSummaries,\n  mergeHelpOptionSummaries,\n  findCommandByPath,\n  findDirectChildCommand,\n  commandAliases,\n} from \"./extension-command-help.js\";\nimport {\n  normalizeHelpCommandPath,\n  resolveHelpDetailMode,\n  resolveHelpNarrative,\n} from \"./help-content.js\";\nimport { getCommandPath } from \"./registration-helpers.js\";\nimport {\n  parseBootstrapGlobalOptions,\n  parseBootstrapHelpRequest,\n  parseBootstrapCommandName,\n  parseBootstrapTypeValue,\n} from \"./bootstrap-args.js\";\nimport { extractProvidedOptionFlags, renderPmCommand } from \"./argv-utils.js\";\nimport { formatCommanderErrorForJson } from \"./error-guidance.js\";\nimport {\n  BUILTIN_TYPE_HELP_VALUES,\n  buildUnknownCommandGuidanceFromRuntime,\n} from \"./commander-usage.js\";\n\n/**\n * Documents the help argument summary payload exchanged by command, SDK, and package integrations.\n */\nexport interface HelpArgumentSummary {\n  name: string;\n  required: boolean;\n  variadic: boolean;\n  description: string | null;\n}\n\n/**\n * Documents the help subcommand summary payload exchanged by command, SDK, and package integrations.\n */\nexport interface HelpSubcommandSummary {\n  name: string;\n  aliases: string[];\n  description: string;\n}\n\nfunction resolveCommandFromPathTokens(root: Command, pathTokens: string[]): Command | null {\n  if (pathTokens.length === 0) {\n    return root;\n  }\n  return findCommandByPath(root, pathTokens);\n}\n\nfunction extractOptionValueName(flags: string): string | null {\n  const match = flags.match(/[<[]([^>\\]]+)[>\\]]/);\n  if (!match) {\n    return null;\n  }\n  const value = match[1]?.trim();\n  return value && value.length > 0 ? value : null;\n}\n\nfunction readOptionAttributeName(option: unknown): string | null {\n  const optionRecord = option as {\n    attributeName?: (() => string) | string;\n  };\n  if (typeof optionRecord.attributeName === \"function\") {\n    const value = optionRecord.attributeName();\n    return typeof value === \"string\" && value.trim().length > 0 ? value.trim() : null;\n  }\n  if (typeof optionRecord.attributeName === \"string\" && optionRecord.attributeName.trim().length > 0) {\n    return optionRecord.attributeName.trim();\n  }\n  return null;\n}\n\nfunction buildOptionAliasMap(options: unknown[]): Map<string, string[]> {\n  const aliasMap = new Map<string, string[]>();\n  for (const option of options) {\n    const optionRecord = option as {\n      long?: string;\n    };\n    const attributeName = readOptionAttributeName(option);\n    if (!attributeName || typeof optionRecord.long !== \"string\" || optionRecord.long.trim().length === 0) {\n      continue;\n    }\n    const existing = aliasMap.get(attributeName) ?? [];\n    existing.push(optionRecord.long.trim());\n    aliasMap.set(attributeName, existing);\n  }\n  for (const [attributeName, values] of aliasMap.entries()) {\n    aliasMap.set(\n      attributeName,\n      [...new Set(values.map((value) => value.trim()).filter((value) => value.length > 0))].sort((left, right) =>\n        left.localeCompare(right),\n      ),\n    );\n  }\n  return aliasMap;\n}\n\nfunction renderAttemptedCommand(argv: string[]): string {\n  return renderPmCommand(argv);\n}\n\nfunction buildHelpOptionSummaries(command: Command): HelpOptionSummary[] {\n  const options = (command.options ?? []) as unknown[];\n  const optionAliasMap = buildOptionAliasMap(options);\n  return options.map((option) => {\n    const optionRecord = option as {\n      flags?: string;\n      long?: string;\n      short?: string;\n      description?: string;\n      mandatory?: boolean;\n      variadic?: boolean;\n      defaultValue?: unknown;\n    };\n    const flags = typeof optionRecord.flags === \"string\" ? optionRecord.flags.trim() : \"\";\n    const description = typeof optionRecord.description === \"string\" ? optionRecord.description.trim() : \"\";\n    const attributeName = readOptionAttributeName(option);\n    const aliasCandidates = attributeName ? optionAliasMap.get(attributeName) ?? [] : [];\n    const aliases = aliasCandidates\n      .filter((entry) => entry !== optionRecord.long)\n      .map((entry) => entry.trim())\n      .filter((entry) => entry.length > 0);\n    const aliasForMatch = description.match(/^Alias for ([^ ]+)/i);\n    const aliasFor = aliasForMatch && aliasForMatch[1] ? aliasForMatch[1].trim() : null;\n    const required =\n      optionRecord.mandatory === true || description.includes(\"[required]\") || description.toLowerCase().includes(\"required;\");\n    const valueRequired = flags.includes(\"<\");\n    const takesValue = valueRequired || flags.includes(\"[\");\n    const summary: HelpOptionSummary = {\n      flags,\n      long: typeof optionRecord.long === \"string\" ? optionRecord.long : null,\n      short: typeof optionRecord.short === \"string\" ? optionRecord.short : null,\n      description,\n      takes_value: takesValue,\n      value_required: valueRequired,\n      value_name: extractOptionValueName(flags),\n      variadic: optionRecord.variadic === true,\n      required,\n      aliases,\n      alias_for: aliasFor,\n    };\n    if (optionRecord.defaultValue !== undefined) {\n      summary.default_value = optionRecord.defaultValue;\n    }\n    return summary;\n  });\n}\n\nfunction compactHelpOptionAliases(options: HelpOptionSummary[]): HelpOptionSummary[] {\n  const canonicalByLong = new Map<string, HelpOptionSummary>();\n  const aliasOptions: HelpOptionSummary[] = [];\n  for (const option of options) {\n    if (option.alias_for && option.long) {\n      aliasOptions.push(option);\n      continue;\n    }\n    if (option.long) {\n      canonicalByLong.set(option.long, option);\n    }\n  }\n  for (const aliasOption of aliasOptions) {\n    const aliasFor = aliasOption.alias_for as string;\n    const canonical = canonicalByLong.get(aliasFor);\n    if (!canonical) {\n      continue;\n    }\n    const aliasLong = aliasOption.long as string;\n    const aliases = new Set<string>([...(canonical.aliases ?? []), aliasLong]);\n    canonical.aliases = [...aliases].sort((left, right) => left.localeCompare(right));\n  }\n  return options.filter((option) => {\n    if (!option.alias_for || !option.long) {\n      return true;\n    }\n    return !canonicalByLong.has(option.alias_for);\n  });\n}\n\nfunction buildHelpArgumentSummaries(command: Command): HelpArgumentSummary[] {\n  const commandRecord = command as unknown as {\n    registeredArguments?: Array<{\n      name?: (() => string) | string;\n      required?: boolean;\n      variadic?: boolean;\n      description?: string;\n    }>;\n    _args?: Array<{\n      name?: (() => string) | string;\n      required?: boolean;\n      variadic?: boolean;\n      description?: string;\n    }>;\n  };\n  const argumentsList = Array.isArray(commandRecord.registeredArguments)\n    ? commandRecord.registeredArguments\n    : Array.isArray(commandRecord._args)\n      ? commandRecord._args\n      : [];\n\n  return argumentsList.map((argument) => {\n    const rawName =\n      typeof argument.name === \"function\"\n        ? argument.name()\n        : typeof argument.name === \"string\"\n          ? argument.name\n          : \"argument\";\n    const description = typeof argument.description === \"string\" && argument.description.trim().length > 0\n      ? argument.description.trim()\n      : null;\n    return {\n      name: rawName.trim(),\n      required: argument.required === true,\n      variadic: argument.variadic === true,\n      description,\n    };\n  });\n}\n\nfunction buildHelpSubcommandSummaries(command: Command): HelpSubcommandSummary[] {\n  return command.commands\n    .map((entry) => ({\n      name: entry.name().trim(),\n      aliases: commandAliases(entry),\n      description: entry.description().trim(),\n    }))\n    .sort((left, right) => left.name.localeCompare(right.name));\n}\n\nfunction buildJsonHelpPayload(\n  rootProgram: Command,\n  targetCommand: Command,\n  argv: string[],\n  requestedPath: string[],\n  extensionDescriptors: ReadonlyMap<string, ExtensionCommandHelpDescriptor>,\n): Record<string, unknown> {\n  const detailMode = resolveHelpDetailMode(argv);\n  const resolvedPath = normalizeHelpCommandPath(getCommandPath(targetCommand));\n  const commandPath = resolvedPath.length > 0 ? resolvedPath : undefined;\n  const fallbackNarrative = resolveHelpNarrative(commandPath, detailMode);\n  const extensionDescriptor = commandPath ? extensionDescriptors.get(commandPath) : undefined;\n  const extensionExamples = extensionDescriptor?.examples ?? [];\n  const extensionFailureHints = extensionDescriptor?.failure_hints ?? [];\n  const narrative = extensionDescriptor\n    ? {\n        intent: extensionDescriptor.intent ?? extensionDescriptor.description ?? fallbackNarrative.intent,\n        examples:\n          detailMode === \"detailed\"\n            ? extensionExamples.length > 0\n              ? [...extensionExamples]\n              : [...fallbackNarrative.examples]\n            : extensionExamples.length > 0\n              ? [extensionExamples[0]]\n              : [...fallbackNarrative.examples],\n        tips:\n          detailMode === \"detailed\"\n            ? extensionFailureHints.length > 0\n              ? [...extensionFailureHints]\n              : [...fallbackNarrative.tips]\n            : [],\n        detail_mode: detailMode,\n      }\n    : fallbackNarrative;\n  const optionSummaries = compactHelpOptionAliases(\n    mergeHelpOptionSummaries(\n      buildHelpOptionSummaries(targetCommand),\n      buildDynamicExtensionHelpOptionSummaries(extensionDescriptor),\n    ),\n  );\n  const subcommands = buildHelpSubcommandSummaries(targetCommand);\n  return {\n    format: \"pm_help_v1\",\n    detail_mode: detailMode,\n    root_command: rootProgram.name(),\n    requested_path: requestedPath,\n    resolved_path: resolvedPath.length > 0 ? resolvedPath : rootProgram.name(),\n    description: targetCommand.description(),\n    usage: targetCommand.usage(),\n    intent: narrative.intent,\n    examples: narrative.examples,\n    tips: narrative.tips,\n    arguments: buildHelpArgumentSummaries(targetCommand),\n    options: optionSummaries,\n    subcommands,\n    has_subcommands: subcommands.length > 0,\n  };\n}\n\n/**\n * Implements maybe render bootstrap json help for the public runtime surface of this module.\n */\nexport async function maybeRenderBootstrapJsonHelp(\n  rootProgram: Command,\n  argv: string[],\n  extensionDescriptors: ReadonlyMap<string, ExtensionCommandHelpDescriptor>,\n): Promise<boolean> {\n  const bootstrapGlobal = parseBootstrapGlobalOptions(argv);\n  if (!bootstrapGlobal.json) {\n    return false;\n  }\n  const helpRequest = parseBootstrapHelpRequest(argv);\n  if (!helpRequest.requested) {\n    return false;\n  }\n  const targetCommand = resolveCommandFromPathTokens(rootProgram, helpRequest.commandPathTokens);\n  if (!targetCommand) {\n    if (!bootstrapGlobal.quiet) {\n      const unknownMessage = `unknown command '${helpRequest.commandPathTokens.join(\" \")}'`;\n      const runtimeContext = buildUnknownCommandGuidanceFromRuntime(unknownMessage, rootProgram, extensionDescriptors);\n      const envelope = formatCommanderErrorForJson(\n        unknownMessage,\n        \"help\",\n        BUILTIN_TYPE_HELP_VALUES,\n        EXIT_CODE.USAGE,\n        {\n          ...(runtimeContext ?? {}),\n          attemptedCommand: renderAttemptedCommand(argv),\n          normalizedInvocationArgs: [...argv],\n          providedOptionFlags: extractProvidedOptionFlags(argv),\n        },\n      );\n      printError(JSON.stringify(envelope, null, 2));\n    }\n    process.exitCode = EXIT_CODE.USAGE;\n    return true;\n  }\n  if (!bootstrapGlobal.quiet) {\n    const payload = buildJsonHelpPayload(rootProgram, targetCommand, argv, helpRequest.commandPathTokens, extensionDescriptors);\n    writeStdout(`${JSON.stringify(payload, null, 2)}\\n`);\n  }\n  process.exitCode = EXIT_CODE.SUCCESS;\n  return true;\n}\n\nfunction buildCreateUpdatePolicyHelpText(\n  commandName: \"create\" | \"update\",\n  typeRegistry: ReturnType<typeof resolveItemTypeRegistry>,\n  argv: string[],\n): string {\n  const selectedTypeRaw = parseBootstrapTypeValue(argv);\n  if (!selectedTypeRaw) {\n    const allowed = typeRegistry.types.join(\"|\");\n    const lines = [\n      \"\",\n      \"Type-aware option policies:\",\n      \"  pass --type <value> with --help to render required/disabled/hidden option policy details for that type.\",\n      `  active type values: ${allowed}`,\n    ];\n    if (commandName === \"create\") {\n      lines.push(\n        \"  scheduling shortcut: use --schedule-preset lightweight for Reminder/Meeting/Event minimal create flows.\",\n      );\n    }\n    return lines.join(\"\\n\");\n  }\n\n  const typeDefinition = resolveTypeDefinition(selectedTypeRaw, typeRegistry);\n  if (!typeDefinition) {\n    const allowed = typeRegistry.types.join(\"|\");\n    return [\n      \"\",\n      `Type-aware option policies: type \"${selectedTypeRaw}\" is not in the active registry.`,\n      `  active type values: ${allowed}`,\n    ].join(\"\\n\");\n  }\n\n  const baseRequired =\n    commandName === \"create\"\n      ? new Set<string>([\"title\", \"description\", \"type\", ...typeDefinition.required_create_fields, ...typeDefinition.required_create_repeatables])\n      : new Set<string>();\n  const policyState = resolveCommandOptionPolicyState(typeDefinition, commandName, baseRequired);\n  const toFlags = (options: string[]): string =>\n    options.length > 0 ? options.map((option) => commandOptionFlagLabel(commandName, option)).join(\", \") : \"none\";\n\n  const lines = [\n    \"\",\n    `Type-aware option policies for ${typeDefinition.name}:`,\n    `  required: ${toFlags(policyState.required)}`,\n    `  disabled: ${toFlags(policyState.disabled)}`,\n    `  hidden: ${toFlags(policyState.hidden)}`,\n  ];\n  if (commandName === \"create\" && [\"Reminder\", \"Meeting\", \"Event\"].includes(typeDefinition.name)) {\n    lines.push(\n      \"  schedule preset: --schedule-preset lightweight switches schedule artifacts to progressive required-option policy.\",\n    );\n    lines.push(\"  strict parity remains available via --create-mode strict.\");\n  }\n  if (typeDefinition.options.length === 0) {\n    lines.push(\"  type options: none\");\n  } else {\n    lines.push(\"  type options:\");\n    for (const option of typeDefinition.options) {\n      const requiredLabel = option.required ? \" (required)\" : \"\";\n      const aliases = option.aliases ?? [];\n      lines.push(`    - ${option.key}${requiredLabel}`);\n      lines.push(`      values: ${option.values.length > 0 ? option.values.join(\"|\") : \"any non-empty string\"}`);\n      lines.push(`      aliases: ${aliases.length > 0 ? aliases.join(\"|\") : \"none\"}`);\n      if (option.description && option.description.trim().length > 0) {\n        lines.push(`      description: ${option.description.trim()}`);\n      }\n    }\n  }\n  if (policyState.errors.length > 0) {\n    lines.push(`  config errors: ${policyState.errors.join(\"; \")}`);\n  }\n  return lines.join(\"\\n\");\n}\n\n/**\n * Implements attach create update policy help text for the public runtime surface of this module.\n */\nexport function attachCreateUpdatePolicyHelpText(\n  rootProgram: Command,\n  typeRegistry: ReturnType<typeof resolveItemTypeRegistry>,\n  argv: string[],\n): void {\n  const bootstrapCommand = parseBootstrapCommandName(argv);\n  if (bootstrapCommand !== \"create\" && bootstrapCommand !== \"update\") {\n    return;\n  }\n  const command = findDirectChildCommand(rootProgram, bootstrapCommand);\n  if (!command) {\n    return;\n  }\n  command.addHelpText(\"after\", buildCreateUpdatePolicyHelpText(bootstrapCommand, typeRegistry, argv));\n}\n\nexport const _testOnly = {\n  attachCreateUpdatePolicyHelpText,\n  buildCreateUpdatePolicyHelpText,\n  buildHelpArgumentSummaries,\n  buildHelpOptionSummaries,\n  buildHelpSubcommandSummaries,\n  buildOptionAliasMap,\n  compactHelpOptionAliases,\n  readOptionAttributeName,\n};\n"],"names":[],"mappings":"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","debugId":"c5494fa8-5038-5b37-b511-887d9144262c"}
+{"version":3,"file":"help-json-payload.js","sources":["cli/help-json-payload.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module cli/help-json-payload\n *\n * Provides CLI runtime support for Help Json Payload.\n */\nimport { Command } from \"commander\";\nimport {\n  commandOptionFlagLabel,\n  resolveCommandOptionPolicyState,\n  resolveItemTypeRegistry,\n  resolveTypeDefinition,\n} from \"../core/item/type-registry.js\";\nimport { EXIT_CODE } from \"../core/shared/constants.js\";\nimport { printError, writeStdout } from \"../core/output/output.js\";\nimport {\n  type HelpOptionSummary,\n  type ExtensionCommandHelpDescriptor,\n  buildDynamicExtensionHelpOptionSummaries,\n  mergeHelpOptionSummaries,\n  findCommandByPath,\n  findDirectChildCommand,\n  commandAliases,\n} from \"./extension-command-help.js\";\nimport {\n  normalizeHelpCommandPath,\n  resolveHelpDetailMode,\n  resolveHelpNarrative,\n} from \"./help-content.js\";\nimport { getCommandPath } from \"./registration-helpers.js\";\nimport {\n  parseBootstrapGlobalOptions,\n  parseBootstrapHelpRequest,\n  parseBootstrapCommandName,\n  parseBootstrapTypeValue,\n} from \"./bootstrap-args.js\";\nimport { extractProvidedOptionFlags, renderPmCommand } from \"./argv-utils.js\";\nimport { formatCommanderErrorForJson } from \"./error-guidance.js\";\nimport {\n  BUILTIN_TYPE_HELP_VALUES,\n  buildUnknownCommandGuidanceFromRuntime,\n} from \"./commander-usage.js\";\n\n/**\n * Documents the help argument summary payload exchanged by command, SDK, and package integrations.\n */\nexport interface HelpArgumentSummary {\n  name: string;\n  required: boolean;\n  variadic: boolean;\n  description: string | null;\n}\n\n/**\n * Documents the help subcommand summary payload exchanged by command, SDK, and package integrations.\n */\nexport interface HelpSubcommandSummary {\n  name: string;\n  aliases: string[];\n  description: string;\n}\n\nfunction resolveCommandFromPathTokens(root: Command, pathTokens: string[]): Command | null {\n  if (pathTokens.length === 0) {\n    return root;\n  }\n  return findCommandByPath(root, pathTokens);\n}\n\nfunction extractOptionValueName(flags: string): string | null {\n  const match = flags.match(/[<[]([^>\\]]+)[>\\]]/);\n  if (!match) {\n    return null;\n  }\n  const value = match[1]?.trim();\n  return value && value.length > 0 ? value : null;\n}\n\nfunction readOptionAttributeName(option: unknown): string | null {\n  const optionRecord = option as {\n    attributeName?: (() => string) | string;\n  };\n  if (typeof optionRecord.attributeName === \"function\") {\n    const value = optionRecord.attributeName();\n    return typeof value === \"string\" && value.trim().length > 0 ? value.trim() : null;\n  }\n  if (typeof optionRecord.attributeName === \"string\" && optionRecord.attributeName.trim().length > 0) {\n    return optionRecord.attributeName.trim();\n  }\n  return null;\n}\n\nfunction buildOptionAliasMap(options: unknown[]): Map<string, string[]> {\n  const aliasMap = new Map<string, string[]>();\n  for (const option of options) {\n    const optionRecord = option as {\n      long?: string;\n    };\n    const attributeName = readOptionAttributeName(option);\n    if (!attributeName || typeof optionRecord.long !== \"string\" || optionRecord.long.trim().length === 0) {\n      continue;\n    }\n    const existing = aliasMap.get(attributeName) ?? [];\n    existing.push(optionRecord.long.trim());\n    aliasMap.set(attributeName, existing);\n  }\n  for (const [attributeName, values] of aliasMap.entries()) {\n    aliasMap.set(\n      attributeName,\n      [...new Set(values.map((value) => value.trim()).filter((value) => value.length > 0))].sort((left, right) =>\n        left.localeCompare(right),\n      ),\n    );\n  }\n  return aliasMap;\n}\n\nfunction renderAttemptedCommand(argv: string[]): string {\n  return renderPmCommand(argv);\n}\n\nfunction buildHelpOptionSummaries(command: Command): HelpOptionSummary[] {\n  const options = (command.options ?? []) as unknown[];\n  const optionAliasMap = buildOptionAliasMap(options);\n  return options.map((option) => {\n    const optionRecord = option as {\n      flags?: string;\n      long?: string;\n      short?: string;\n      description?: string;\n      mandatory?: boolean;\n      variadic?: boolean;\n      defaultValue?: unknown;\n    };\n    const flags = typeof optionRecord.flags === \"string\" ? optionRecord.flags.trim() : \"\";\n    const description = typeof optionRecord.description === \"string\" ? optionRecord.description.trim() : \"\";\n    const attributeName = readOptionAttributeName(option);\n    const aliasCandidates = attributeName ? optionAliasMap.get(attributeName) ?? [] : [];\n    const aliases = aliasCandidates\n      .filter((entry) => entry !== optionRecord.long)\n      .map((entry) => entry.trim())\n      .filter((entry) => entry.length > 0);\n    const aliasForMatch = description.match(/^Alias for ([^ ]+)/i);\n    const aliasFor = aliasForMatch && aliasForMatch[1] ? aliasForMatch[1].trim() : null;\n    const required =\n      optionRecord.mandatory === true || description.includes(\"[required]\") || description.toLowerCase().includes(\"required;\");\n    const valueRequired = flags.includes(\"<\");\n    const takesValue = valueRequired || flags.includes(\"[\");\n    const summary: HelpOptionSummary = {\n      flags,\n      long: typeof optionRecord.long === \"string\" ? optionRecord.long : null,\n      short: typeof optionRecord.short === \"string\" ? optionRecord.short : null,\n      description,\n      takes_value: takesValue,\n      value_required: valueRequired,\n      value_name: extractOptionValueName(flags),\n      variadic: optionRecord.variadic === true,\n      required,\n      aliases,\n      alias_for: aliasFor,\n    };\n    if (optionRecord.defaultValue !== undefined) {\n      summary.default_value = optionRecord.defaultValue;\n    }\n    return summary;\n  });\n}\n\nfunction compactHelpOptionAliases(options: HelpOptionSummary[]): HelpOptionSummary[] {\n  const canonicalByLong = new Map<string, HelpOptionSummary>();\n  const aliasOptions: HelpOptionSummary[] = [];\n  for (const option of options) {\n    if (option.alias_for && option.long) {\n      aliasOptions.push(option);\n      continue;\n    }\n    if (option.long) {\n      canonicalByLong.set(option.long, option);\n    }\n  }\n  for (const aliasOption of aliasOptions) {\n    const aliasFor = aliasOption.alias_for as string;\n    const canonical = canonicalByLong.get(aliasFor);\n    if (!canonical) {\n      continue;\n    }\n    const aliasLong = aliasOption.long as string;\n    const aliases = new Set<string>([...(canonical.aliases ?? []), aliasLong]);\n    canonical.aliases = [...aliases].sort((left, right) => left.localeCompare(right));\n  }\n  return options.filter((option) => {\n    if (!option.alias_for || !option.long) {\n      return true;\n    }\n    return !canonicalByLong.has(option.alias_for);\n  });\n}\n\nfunction buildHelpArgumentSummaries(command: Command): HelpArgumentSummary[] {\n  const commandRecord = command as unknown as {\n    registeredArguments?: Array<{\n      name?: (() => string) | string;\n      required?: boolean;\n      variadic?: boolean;\n      description?: string;\n    }>;\n    _args?: Array<{\n      name?: (() => string) | string;\n      required?: boolean;\n      variadic?: boolean;\n      description?: string;\n    }>;\n  };\n  const argumentsList = Array.isArray(commandRecord.registeredArguments)\n    ? commandRecord.registeredArguments\n    : Array.isArray(commandRecord._args)\n      ? commandRecord._args\n      : [];\n\n  return argumentsList.map((argument) => {\n    const rawName =\n      typeof argument.name === \"function\"\n        ? argument.name()\n        : typeof argument.name === \"string\"\n          ? argument.name\n          : \"argument\";\n    const description = typeof argument.description === \"string\" && argument.description.trim().length > 0\n      ? argument.description.trim()\n      : null;\n    return {\n      name: rawName.trim(),\n      required: argument.required === true,\n      variadic: argument.variadic === true,\n      description,\n    };\n  });\n}\n\nfunction buildHelpSubcommandSummaries(command: Command): HelpSubcommandSummary[] {\n  return command.commands\n    .map((entry) => ({\n      name: entry.name().trim(),\n      aliases: commandAliases(entry),\n      description: entry.description().trim(),\n    }))\n    .sort((left, right) => left.name.localeCompare(right.name));\n}\n\nfunction buildJsonHelpPayload(\n  rootProgram: Command,\n  targetCommand: Command,\n  argv: string[],\n  requestedPath: string[],\n  extensionDescriptors: ReadonlyMap<string, ExtensionCommandHelpDescriptor>,\n): Record<string, unknown> {\n  const detailMode = resolveHelpDetailMode(argv);\n  const resolvedPath = normalizeHelpCommandPath(getCommandPath(targetCommand));\n  const commandPath = resolvedPath.length > 0 ? resolvedPath : undefined;\n  const fallbackNarrative = resolveHelpNarrative(commandPath, detailMode);\n  const extensionDescriptor = commandPath ? extensionDescriptors.get(commandPath) : undefined;\n  const extensionExamples = extensionDescriptor?.examples ?? [];\n  const extensionFailureHints = extensionDescriptor?.failure_hints ?? [];\n  const narrative = extensionDescriptor\n    ? {\n        intent: extensionDescriptor.intent ?? extensionDescriptor.description ?? fallbackNarrative.intent,\n        examples:\n          detailMode === \"detailed\"\n            ? extensionExamples.length > 0\n              ? [...extensionExamples]\n              : [...fallbackNarrative.examples]\n            : extensionExamples.length > 0\n              ? [extensionExamples[0]]\n              : [...fallbackNarrative.examples],\n        tips:\n          detailMode === \"detailed\"\n            ? extensionFailureHints.length > 0\n              ? [...extensionFailureHints]\n              : [...fallbackNarrative.tips]\n            : [],\n        detail_mode: detailMode,\n      }\n    : fallbackNarrative;\n  const optionSummaries = compactHelpOptionAliases(\n    mergeHelpOptionSummaries(\n      buildHelpOptionSummaries(targetCommand),\n      buildDynamicExtensionHelpOptionSummaries(extensionDescriptor),\n    ),\n  );\n  const subcommands = buildHelpSubcommandSummaries(targetCommand);\n  return {\n    format: \"pm_help_v1\",\n    detail_mode: detailMode,\n    root_command: rootProgram.name(),\n    requested_path: requestedPath,\n    resolved_path: resolvedPath.length > 0 ? resolvedPath : rootProgram.name(),\n    description: targetCommand.description(),\n    usage: targetCommand.usage(),\n    intent: narrative.intent,\n    examples: narrative.examples,\n    tips: narrative.tips,\n    arguments: buildHelpArgumentSummaries(targetCommand),\n    options: optionSummaries,\n    subcommands,\n    has_subcommands: subcommands.length > 0,\n  };\n}\n\n/**\n * Implements maybe render bootstrap json help for the public runtime surface of this module.\n */\nexport async function maybeRenderBootstrapJsonHelp(\n  rootProgram: Command,\n  argv: string[],\n  extensionDescriptors: ReadonlyMap<string, ExtensionCommandHelpDescriptor>,\n): Promise<boolean> {\n  const bootstrapGlobal = parseBootstrapGlobalOptions(argv);\n  if (!bootstrapGlobal.json) {\n    return false;\n  }\n  const helpRequest = parseBootstrapHelpRequest(argv);\n  if (!helpRequest.requested) {\n    return false;\n  }\n  const targetCommand = resolveCommandFromPathTokens(rootProgram, helpRequest.commandPathTokens);\n  if (!targetCommand) {\n    if (!bootstrapGlobal.quiet) {\n      const unknownMessage = `unknown command '${helpRequest.commandPathTokens.join(\" \")}'`;\n      const runtimeContext = buildUnknownCommandGuidanceFromRuntime(unknownMessage, rootProgram, extensionDescriptors);\n      const envelope = formatCommanderErrorForJson(\n        unknownMessage,\n        \"help\",\n        BUILTIN_TYPE_HELP_VALUES,\n        EXIT_CODE.USAGE,\n        {\n          ...runtimeContext,\n          attemptedCommand: renderAttemptedCommand(argv),\n          normalizedInvocationArgs: [...argv],\n          providedOptionFlags: extractProvidedOptionFlags(argv),\n        },\n      );\n      printError(JSON.stringify(envelope, null, 2));\n    }\n    process.exitCode = EXIT_CODE.USAGE;\n    return true;\n  }\n  if (!bootstrapGlobal.quiet) {\n    const payload = buildJsonHelpPayload(rootProgram, targetCommand, argv, helpRequest.commandPathTokens, extensionDescriptors);\n    writeStdout(`${JSON.stringify(payload, null, 2)}\\n`);\n  }\n  process.exitCode = EXIT_CODE.SUCCESS;\n  return true;\n}\n\nfunction buildCreateUpdatePolicyHelpText(\n  commandName: \"create\" | \"update\",\n  typeRegistry: ReturnType<typeof resolveItemTypeRegistry>,\n  argv: string[],\n): string {\n  const selectedTypeRaw = parseBootstrapTypeValue(argv);\n  if (!selectedTypeRaw) {\n    const allowed = typeRegistry.types.join(\"|\");\n    const lines = [\n      \"\",\n      \"Type-aware option policies:\",\n      \"  pass --type <value> with --help to render required/disabled/hidden option policy details for that type.\",\n      `  active type values: ${allowed}`,\n    ];\n    if (commandName === \"create\") {\n      lines.push(\n        \"  scheduling shortcut: use --schedule-preset lightweight for Reminder/Meeting/Event minimal create flows.\",\n      );\n    }\n    return lines.join(\"\\n\");\n  }\n\n  const typeDefinition = resolveTypeDefinition(selectedTypeRaw, typeRegistry);\n  if (!typeDefinition) {\n    const allowed = typeRegistry.types.join(\"|\");\n    return [\n      \"\",\n      `Type-aware option policies: type \"${selectedTypeRaw}\" is not in the active registry.`,\n      `  active type values: ${allowed}`,\n    ].join(\"\\n\");\n  }\n\n  const baseRequired =\n    commandName === \"create\"\n      ? new Set<string>([\"title\", \"description\", \"type\", ...typeDefinition.required_create_fields, ...typeDefinition.required_create_repeatables])\n      : new Set<string>();\n  const policyState = resolveCommandOptionPolicyState(typeDefinition, commandName, baseRequired);\n  const toFlags = (options: string[]): string =>\n    options.length > 0 ? options.map((option) => commandOptionFlagLabel(commandName, option)).join(\", \") : \"none\";\n\n  const lines = [\n    \"\",\n    `Type-aware option policies for ${typeDefinition.name}:`,\n    `  required: ${toFlags(policyState.required)}`,\n    `  disabled: ${toFlags(policyState.disabled)}`,\n    `  hidden: ${toFlags(policyState.hidden)}`,\n  ];\n  if (commandName === \"create\" && [\"Reminder\", \"Meeting\", \"Event\"].includes(typeDefinition.name)) {\n    lines.push(\n      \"  schedule preset: --schedule-preset lightweight switches schedule artifacts to progressive required-option policy.\",\n    );\n    lines.push(\"  strict parity remains available via --create-mode strict.\");\n  }\n  if (typeDefinition.options.length === 0) {\n    lines.push(\"  type options: none\");\n  } else {\n    lines.push(\"  type options:\");\n    for (const option of typeDefinition.options) {\n      const requiredLabel = option.required ? \" (required)\" : \"\";\n      const aliases = option.aliases ?? [];\n      lines.push(`    - ${option.key}${requiredLabel}`);\n      lines.push(`      values: ${option.values.length > 0 ? option.values.join(\"|\") : \"any non-empty string\"}`);\n      lines.push(`      aliases: ${aliases.length > 0 ? aliases.join(\"|\") : \"none\"}`);\n      if (option.description && option.description.trim().length > 0) {\n        lines.push(`      description: ${option.description.trim()}`);\n      }\n    }\n  }\n  if (policyState.errors.length > 0) {\n    lines.push(`  config errors: ${policyState.errors.join(\"; \")}`);\n  }\n  return lines.join(\"\\n\");\n}\n\n/**\n * Implements attach create update policy help text for the public runtime surface of this module.\n */\nexport function attachCreateUpdatePolicyHelpText(\n  rootProgram: Command,\n  typeRegistry: ReturnType<typeof resolveItemTypeRegistry>,\n  argv: string[],\n): void {\n  const bootstrapCommand = parseBootstrapCommandName(argv);\n  if (bootstrapCommand !== \"create\" && bootstrapCommand !== \"update\") {\n    return;\n  }\n  const command = findDirectChildCommand(rootProgram, bootstrapCommand);\n  if (!command) {\n    return;\n  }\n  command.addHelpText(\"after\", buildCreateUpdatePolicyHelpText(bootstrapCommand, typeRegistry, argv));\n}\n\nexport const _testOnly = {\n  attachCreateUpdatePolicyHelpText,\n  buildCreateUpdatePolicyHelpText,\n  buildHelpArgumentSummaries,\n  buildHelpOptionSummaries,\n  buildHelpSubcommandSummaries,\n  buildOptionAliasMap,\n  compactHelpOptionAliases,\n  readOptionAttributeName,\n};\n"],"names":[],"mappings":";;AAMA,OAAO,EACL,sBAAsB,EACtB,+BAA+B,EAE/B,qBAAqB,GACtB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,EAGL,wCAAwC,EACxC,wBAAwB,EACxB,iBAAiB,EACjB,sBAAsB,EACtB,cAAc,GACf,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,wBAAwB,EACxB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EACL,2BAA2B,EAC3B,yBAAyB,EACzB,yBAAyB,EACzB,uBAAuB,GACxB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,0BAA0B,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAC9E,OAAO,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAC;AAClE,OAAO,EACL,wBAAwB,EACxB,sCAAsC,GACvC,MAAM,sBAAsB,CAAC;AAqB9B,SAAS,4BAA4B,CAAC,IAAa,EAAE,UAAoB;IACvE,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,iBAAiB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;AAC7C,CAAC;AAED,SAAS,sBAAsB,CAAC,KAAa;IAC3C,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;IAChD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;IAC/B,OAAO,KAAK,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AAClD,CAAC;AAED,SAAS,uBAAuB,CAAC,MAAe;IAC9C,MAAM,YAAY,GAAG,MAEpB,CAAC;IACF,IAAI,OAAO,YAAY,CAAC,aAAa,KAAK,UAAU,EAAE,CAAC;QACrD,MAAM,KAAK,GAAG,YAAY,CAAC,aAAa,EAAE,CAAC;QAC3C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IACpF,CAAC;IACD,IAAI,OAAO,YAAY,CAAC,aAAa,KAAK,QAAQ,IAAI,YAAY,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACnG,OAAO,YAAY,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC;IAC3C,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,mBAAmB,CAAC,OAAkB;IAC7C,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAoB,CAAC;IAC7C,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,YAAY,GAAG,MAEpB,CAAC;QACF,MAAM,aAAa,GAAG,uBAAuB,CAAC,MAAM,CAAC,CAAC;QACtD,IAAI,CAAC,aAAa,IAAI,OAAO,YAAY,CAAC,IAAI,KAAK,QAAQ,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACrG,SAAS;QACX,CAAC;QACD,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC;QACnD,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QACxC,QAAQ,CAAC,GAAG,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC;IACxC,CAAC;IACD,KAAK,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,IAAI,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC;QACzD,QAAQ,CAAC,GAAG,CACV,aAAa,EACb,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CACzG,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAC1B,CACF,CAAC;IACJ,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,sBAAsB,CAAC,IAAc;IAC5C,OAAO,eAAe,CAAC,IAAI,CAAC,CAAC;AAC/B,CAAC;AAED,SAAS,wBAAwB,CAAC,OAAgB;IAChD,MAAM,OAAO,GAAG,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAc,CAAC;IACrD,MAAM,cAAc,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;IACpD,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;QAC5B,MAAM,YAAY,GAAG,MAQpB,CAAC;QACF,MAAM,KAAK,GAAG,OAAO,YAAY,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtF,MAAM,WAAW,GAAG,OAAO,YAAY,CAAC,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxG,MAAM,aAAa,GAAG,uBAAuB,CAAC,MAAM,CAAC,CAAC;QACtD,MAAM,eAAe,GAAG,aAAa,CAAC,CAAC,CAAC,cAAc,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACrF,MAAM,OAAO,GAAG,eAAe;aAC5B,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,YAAY,CAAC,IAAI,CAAC;aAC9C,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;aAC5B,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACvC,MAAM,aAAa,GAAG,WAAW,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC;QAC/D,MAAM,QAAQ,GAAG,aAAa,IAAI,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QACpF,MAAM,QAAQ,GACZ,YAAY,CAAC,SAAS,KAAK,IAAI,IAAI,WAAW,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,WAAW,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;QAC3H,MAAM,aAAa,GAAG,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QAC1C,MAAM,UAAU,GAAG,aAAa,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QACxD,MAAM,OAAO,GAAsB;YACjC,KAAK;YACL,IAAI,EAAE,OAAO,YAAY,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI;YACtE,KAAK,EAAE,OAAO,YAAY,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI;YACzE,WAAW;YACX,WAAW,EAAE,UAAU;YACvB,cAAc,EAAE,aAAa;YAC7B,UAAU,EAAE,sBAAsB,CAAC,KAAK,CAAC;YACzC,QAAQ,EAAE,YAAY,CAAC,QAAQ,KAAK,IAAI;YACxC,QAAQ;YACR,OAAO;YACP,SAAS,EAAE,QAAQ;SACpB,CAAC;QACF,IAAI,YAAY,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;YAC5C,OAAO,CAAC,aAAa,GAAG,YAAY,CAAC,YAAY,CAAC;QACpD,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,wBAAwB,CAAC,OAA4B;IAC5D,MAAM,eAAe,GAAG,IAAI,GAAG,EAA6B,CAAC;IAC7D,MAAM,YAAY,GAAwB,EAAE,CAAC;IAC7C,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;YACpC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC1B,SAAS;QACX,CAAC;QACD,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;YAChB,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;IACD,KAAK,MAAM,WAAW,IAAI,YAAY,EAAE,CAAC;QACvC,MAAM,QAAQ,GAAG,WAAW,CAAC,SAAmB,CAAC;QACjD,MAAM,SAAS,GAAG,eAAe,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAChD,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,SAAS;QACX,CAAC;QACD,MAAM,SAAS,GAAG,WAAW,CAAC,IAAc,CAAC;QAC7C,MAAM,OAAO,GAAG,IAAI,GAAG,CAAS,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC;QAC3E,SAAS,CAAC,OAAO,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC;IACpF,CAAC;IACD,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE;QAC/B,IAAI,CAAC,MAAM,CAAC,SAAS,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YACtC,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,CAAC,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,0BAA0B,CAAC,OAAgB;IAClD,MAAM,aAAa,GAAG,OAarB,CAAC;IACF,MAAM,aAAa,GAAG,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,mBAAmB,CAAC;QACpE,CAAC,CAAC,aAAa,CAAC,mBAAmB;QACnC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,KAAK,CAAC;YAClC,CAAC,CAAC,aAAa,CAAC,KAAK;YACrB,CAAC,CAAC,EAAE,CAAC;IAET,OAAO,aAAa,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE;QACpC,MAAM,OAAO,GACX,OAAO,QAAQ,CAAC,IAAI,KAAK,UAAU;YACjC,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE;YACjB,CAAC,CAAC,OAAO,QAAQ,CAAC,IAAI,KAAK,QAAQ;gBACjC,CAAC,CAAC,QAAQ,CAAC,IAAI;gBACf,CAAC,CAAC,UAAU,CAAC;QACnB,MAAM,WAAW,GAAG,OAAO,QAAQ,CAAC,WAAW,KAAK,QAAQ,IAAI,QAAQ,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;YACpG,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,EAAE;YAC7B,CAAC,CAAC,IAAI,CAAC;QACT,OAAO;YACL,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE;YACpB,QAAQ,EAAE,QAAQ,CAAC,QAAQ,KAAK,IAAI;YACpC,QAAQ,EAAE,QAAQ,CAAC,QAAQ,KAAK,IAAI;YACpC,WAAW;SACZ,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,4BAA4B,CAAC,OAAgB;IACpD,OAAO,OAAO,CAAC,QAAQ;SACpB,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACf,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE;QACzB,OAAO,EAAE,cAAc,CAAC,KAAK,CAAC;QAC9B,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE;KACxC,CAAC,CAAC;SACF,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;AAChE,CAAC;AAED,SAAS,oBAAoB,CAC3B,WAAoB,EACpB,aAAsB,EACtB,IAAc,EACd,aAAuB,EACvB,oBAAyE;IAEzE,MAAM,UAAU,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC;IAC/C,MAAM,YAAY,GAAG,wBAAwB,CAAC,cAAc,CAAC,aAAa,CAAC,CAAC,CAAC;IAC7E,MAAM,WAAW,GAAG,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC;IACvE,MAAM,iBAAiB,GAAG,oBAAoB,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;IACxE,MAAM,mBAAmB,GAAG,WAAW,CAAC,CAAC,CAAC,oBAAoB,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC5F,MAAM,iBAAiB,GAAG,mBAAmB,EAAE,QAAQ,IAAI,EAAE,CAAC;IAC9D,MAAM,qBAAqB,GAAG,mBAAmB,EAAE,aAAa,IAAI,EAAE,CAAC;IACvE,MAAM,SAAS,GAAG,mBAAmB;QACnC,CAAC,CAAC;YACE,MAAM,EAAE,mBAAmB,CAAC,MAAM,IAAI,mBAAmB,CAAC,WAAW,IAAI,iBAAiB,CAAC,MAAM;YACjG,QAAQ,EACN,UAAU,KAAK,UAAU;gBACvB,CAAC,CAAC,iBAAiB,CAAC,MAAM,GAAG,CAAC;oBAC5B,CAAC,CAAC,CAAC,GAAG,iBAAiB,CAAC;oBACxB,CAAC,CAAC,CAAC,GAAG,iBAAiB,CAAC,QAAQ,CAAC;gBACnC,CAAC,CAAC,iBAAiB,CAAC,MAAM,GAAG,CAAC;oBAC5B,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;oBACxB,CAAC,CAAC,CAAC,GAAG,iBAAiB,CAAC,QAAQ,CAAC;YACvC,IAAI,EACF,UAAU,KAAK,UAAU;gBACvB,CAAC,CAAC,qBAAqB,CAAC,MAAM,GAAG,CAAC;oBAChC,CAAC,CAAC,CAAC,GAAG,qBAAqB,CAAC;oBAC5B,CAAC,CAAC,CAAC,GAAG,iBAAiB,CAAC,IAAI,CAAC;gBAC/B,CAAC,CAAC,EAAE;YACR,WAAW,EAAE,UAAU;SACxB;QACH,CAAC,CAAC,iBAAiB,CAAC;IACtB,MAAM,eAAe,GAAG,wBAAwB,CAC9C,wBAAwB,CACtB,wBAAwB,CAAC,aAAa,CAAC,EACvC,wCAAwC,CAAC,mBAAmB,CAAC,CAC9D,CACF,CAAC;IACF,MAAM,WAAW,GAAG,4BAA4B,CAAC,aAAa,CAAC,CAAC;IAChE,OAAO;QACL,MAAM,EAAE,YAAY;QACpB,WAAW,EAAE,UAAU;QACvB,YAAY,EAAE,WAAW,CAAC,IAAI,EAAE;QAChC,cAAc,EAAE,aAAa;QAC7B,aAAa,EAAE,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,EAAE;QAC1E,WAAW,EAAE,aAAa,CAAC,WAAW,EAAE;QACxC,KAAK,EAAE,aAAa,CAAC,KAAK,EAAE;QAC5B,MAAM,EAAE,SAAS,CAAC,MAAM;QACxB,QAAQ,EAAE,SAAS,CAAC,QAAQ;QAC5B,IAAI,EAAE,SAAS,CAAC,IAAI;QACpB,SAAS,EAAE,0BAA0B,CAAC,aAAa,CAAC;QACpD,OAAO,EAAE,eAAe;QACxB,WAAW;QACX,eAAe,EAAE,WAAW,CAAC,MAAM,GAAG,CAAC;KACxC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAChD,WAAoB,EACpB,IAAc,EACd,oBAAyE;IAEzE,MAAM,eAAe,GAAG,2BAA2B,CAAC,IAAI,CAAC,CAAC;IAC1D,IAAI,CAAC,eAAe,CAAC,IAAI,EAAE,CAAC;QAC1B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,WAAW,GAAG,yBAAyB,CAAC,IAAI,CAAC,CAAC;IACpD,IAAI,CAAC,WAAW,CAAC,SAAS,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,aAAa,GAAG,4BAA4B,CAAC,WAAW,EAAE,WAAW,CAAC,iBAAiB,CAAC,CAAC;IAC/F,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC;YAC3B,MAAM,cAAc,GAAG,oBAAoB,WAAW,CAAC,iBAAiB,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;YACtF,MAAM,cAAc,GAAG,sCAAsC,CAAC,cAAc,EAAE,WAAW,EAAE,oBAAoB,CAAC,CAAC;YACjH,MAAM,QAAQ,GAAG,2BAA2B,CAC1C,cAAc,EACd,MAAM,EACN,wBAAwB,EACxB,SAAS,CAAC,KAAK,EACf;gBACE,GAAG,cAAc;gBACjB,gBAAgB,EAAE,sBAAsB,CAAC,IAAI,CAAC;gBAC9C,wBAAwB,EAAE,CAAC,GAAG,IAAI,CAAC;gBACnC,mBAAmB,EAAE,0BAA0B,CAAC,IAAI,CAAC;aACtD,CACF,CAAC;YACF,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAChD,CAAC;QACD,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC,KAAK,CAAC;QACnC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC;QAC3B,MAAM,OAAO,GAAG,oBAAoB,CAAC,WAAW,EAAE,aAAa,EAAE,IAAI,EAAE,WAAW,CAAC,iBAAiB,EAAE,oBAAoB,CAAC,CAAC;QAC5H,WAAW,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;IACvD,CAAC;IACD,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC,OAAO,CAAC;IACrC,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,+BAA+B,CACtC,WAAgC,EAChC,YAAwD,EACxD,IAAc;IAEd,MAAM,eAAe,GAAG,uBAAuB,CAAC,IAAI,CAAC,CAAC;IACtD,IAAI,CAAC,eAAe,EAAE,CAAC;QACrB,MAAM,OAAO,GAAG,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC7C,MAAM,KAAK,GAAG;YACZ,EAAE;YACF,6BAA6B;YAC7B,2GAA2G;YAC3G,yBAAyB,OAAO,EAAE;SACnC,CAAC;QACF,IAAI,WAAW,KAAK,QAAQ,EAAE,CAAC;YAC7B,KAAK,CAAC,IAAI,CACR,2GAA2G,CAC5G,CAAC;QACJ,CAAC;QACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,MAAM,cAAc,GAAG,qBAAqB,CAAC,eAAe,EAAE,YAAY,CAAC,CAAC;IAC5E,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,MAAM,OAAO,GAAG,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC7C,OAAO;YACL,EAAE;YACF,qCAAqC,eAAe,kCAAkC;YACtF,yBAAyB,OAAO,EAAE;SACnC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACf,CAAC;IAED,MAAM,YAAY,GAChB,WAAW,KAAK,QAAQ;QACtB,CAAC,CAAC,IAAI,GAAG,CAAS,CAAC,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,GAAG,cAAc,CAAC,sBAAsB,EAAE,GAAG,cAAc,CAAC,2BAA2B,CAAC,CAAC;QAC5I,CAAC,CAAC,IAAI,GAAG,EAAU,CAAC;IACxB,MAAM,WAAW,GAAG,+BAA+B,CAAC,cAAc,EAAE,WAAW,EAAE,YAAY,CAAC,CAAC;IAC/F,MAAM,OAAO,GAAG,CAAC,OAAiB,EAAU,EAAE,CAC5C,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,sBAAsB,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAEhH,MAAM,KAAK,GAAG;QACZ,EAAE;QACF,kCAAkC,cAAc,CAAC,IAAI,GAAG;QACxD,eAAe,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC,EAAE;QAC9C,eAAe,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC,EAAE;QAC9C,aAAa,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE;KAC3C,CAAC;IACF,IAAI,WAAW,KAAK,QAAQ,IAAI,CAAC,UAAU,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/F,KAAK,CAAC,IAAI,CACR,qHAAqH,CACtH,CAAC;QACF,KAAK,CAAC,IAAI,CAAC,6DAA6D,CAAC,CAAC;IAC5E,CAAC;IACD,IAAI,cAAc,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxC,KAAK,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;IACrC,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAC9B,KAAK,MAAM,MAAM,IAAI,cAAc,CAAC,OAAO,EAAE,CAAC;YAC5C,MAAM,aAAa,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3D,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC;YACrC,KAAK,CAAC,IAAI,CAAC,SAAS,MAAM,CAAC,GAAG,GAAG,aAAa,EAAE,CAAC,CAAC;YAClD,KAAK,CAAC,IAAI,CAAC,iBAAiB,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,sBAAsB,EAAE,CAAC,CAAC;YAC3G,KAAK,CAAC,IAAI,CAAC,kBAAkB,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;YAChF,IAAI,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC/D,KAAK,CAAC,IAAI,CAAC,sBAAsB,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAChE,CAAC;QACH,CAAC;IACH,CAAC;IACD,IAAI,WAAW,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClC,KAAK,CAAC,IAAI,CAAC,oBAAoB,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAClE,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gCAAgC,CAC9C,WAAoB,EACpB,YAAwD,EACxD,IAAc;IAEd,MAAM,gBAAgB,GAAG,yBAAyB,CAAC,IAAI,CAAC,CAAC;IACzD,IAAI,gBAAgB,KAAK,QAAQ,IAAI,gBAAgB,KAAK,QAAQ,EAAE,CAAC;QACnE,OAAO;IACT,CAAC;IACD,MAAM,OAAO,GAAG,sBAAsB,CAAC,WAAW,EAAE,gBAAgB,CAAC,CAAC;IACtE,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO;IACT,CAAC;IACD,OAAO,CAAC,WAAW,CAAC,OAAO,EAAE,+BAA+B,CAAC,gBAAgB,EAAE,YAAY,EAAE,IAAI,CAAC,CAAC,CAAC;AACtG,CAAC;AAED,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,gCAAgC;IAChC,+BAA+B;IAC/B,0BAA0B;IAC1B,wBAAwB;IACxB,4BAA4B;IAC5B,mBAAmB;IACnB,wBAAwB;IACxB,uBAAuB;CACxB,CAAC","debugId":"913c0a00-924f-520e-adb6-4073fdb73413"}