@unbrained/pm-cli 2026.9.7 → 2026.9.9

package/dist/sdk/completion.js

@@ -1,415 +1,6 @@
-/**
- * @module cli/commands/completion
- *
- * Implements the pm completion command surface and its agent-facing runtime behavior.
- */
-
-!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]="4bf2b42b-91f3-5850-b1f1-d8a01525860c")}catch(e){}}();
-import { EXIT_CODE, PmCliError } from "./runtime-primitives.js";
-import { listPmCommandsForTier } from "./agent-capability-contracts.js";
-import { SCAFFOLD_CAPABILITIES } from "./extension/scaffold.js";
-import { AGGREGATE_FLAG_CONTRACTS, ACTIVITY_FLAG_CONTRACTS, APPEND_FLAG_CONTRACTS, CALENDAR_FLAG_CONTRACTS, CLOSE_MANY_FLAG_CONTRACTS, COMPLETION_FLAG_CONTRACTS, CONTRACTS_FLAG_CONTRACTS, CONTEXT_FLAG_CONTRACTS, COPY_FLAG_CONTRACTS, FOCUS_FLAG_CONTRACTS, MEET_FLAG_CONTRACTS, REMIND_FLAG_CONTRACTS, CREATE_FLAG_CONTRACTS, DEPS_FLAG_CONTRACTS, DUPLICATES_FLAG_CONTRACTS, EXTENSION_FLAG_CONTRACTS, GRAPH_FLAG_CONTRACTS, GET_FLAG_CONTRACTS, GUIDE_FLAG_CONTRACTS, GLOBAL_FLAG_CONTRACTS, HEALTH_FLAG_CONTRACTS, HISTORY_AUTHOR_ACKNOWLEDGE_FLAG_CONTRACTS, HISTORY_FLAG_CONTRACTS, INIT_FLAG_CONTRACTS, LIST_FILTER_FLAG_CONTRACTS, NEXT_FLAG_CONTRACTS, PM_COMMAND_ALIAS_CONTRACTS, PACKAGE_FLAG_CONTRACTS, PLAN_FLAG_CONTRACTS, SEARCH_FLAG_CONTRACTS, STATS_FLAG_CONTRACTS, EVENTS_FLAG_CONTRACTS, UPDATE_FLAG_CONTRACTS, UPDATE_MANY_FLAG_CONTRACTS, UPGRADE_FLAG_CONTRACTS, toCompletionFlagString, } from "./cli-contracts.js";
-import { BUILTIN_ITEM_TYPE_VALUES, STATUS_VALUES } from "../types/index.js";
-import { listGuideTopicIds } from "./guide-topics.js";
-const VALID_SHELLS = ["bash", "zsh", "fish"];
-const DEFAULT_ITEM_TYPES = [...BUILTIN_ITEM_TYPE_VALUES];
-const DEFAULT_STATUS_VALUES = [...STATUS_VALUES];
-const HIDDEN_COMMAND_ALIASES = new Set(PM_COMMAND_ALIAS_CONTRACTS.filter((contract) => contract.hidden).map((contract) => contract.alias));
-const ALL_COMMANDS = listPmCommandsForTier("full").filter((command) => !HIDDEN_COMMAND_ALIASES.has(command));
-const LIST_FLAGS = toCompletionFlagString(LIST_FILTER_FLAG_CONTRACTS);
-const AGGREGATE_FLAGS = toCompletionFlagString(AGGREGATE_FLAG_CONTRACTS);
-const APPEND_FLAGS = toCompletionFlagString(APPEND_FLAG_CONTRACTS);
-const COPY_FLAGS = toCompletionFlagString(COPY_FLAG_CONTRACTS);
-const FOCUS_FLAGS = toCompletionFlagString(FOCUS_FLAG_CONTRACTS);
-const MEET_FLAGS = toCompletionFlagString(MEET_FLAG_CONTRACTS);
-const REMIND_FLAGS = toCompletionFlagString(REMIND_FLAG_CONTRACTS);
-const CREATE_FLAGS = toCompletionFlagString(CREATE_FLAG_CONTRACTS);
-const GET_FLAGS = toCompletionFlagString(GET_FLAG_CONTRACTS);
-const UPDATE_FLAGS = toCompletionFlagString(UPDATE_FLAG_CONTRACTS);
-const UPDATE_MANY_FLAGS = toCompletionFlagString(UPDATE_MANY_FLAG_CONTRACTS);
-const CLOSE_MANY_FLAGS = toCompletionFlagString(CLOSE_MANY_FLAG_CONTRACTS);
-const ACTIVITY_FLAGS = toCompletionFlagString(ACTIVITY_FLAG_CONTRACTS);
-const HISTORY_FLAGS = toCompletionFlagString(HISTORY_FLAG_CONTRACTS);
-const HISTORY_AUTHOR_ACKNOWLEDGE_FLAGS = toCompletionFlagString(HISTORY_AUTHOR_ACKNOWLEDGE_FLAG_CONTRACTS, false);
-const EVENTS_FLAGS = toCompletionFlagString(EVENTS_FLAG_CONTRACTS);
-const CALENDAR_FLAGS = toCompletionFlagString(CALENDAR_FLAG_CONTRACTS);
-const CONTEXT_FLAGS = toCompletionFlagString(CONTEXT_FLAG_CONTRACTS);
-const NEXT_FLAGS = toCompletionFlagString(NEXT_FLAG_CONTRACTS);
-const DEPS_FLAGS = toCompletionFlagString(DEPS_FLAG_CONTRACTS);
-const DUPLICATES_FLAGS = toCompletionFlagString(DUPLICATES_FLAG_CONTRACTS);
-const GRAPH_FLAGS = toCompletionFlagString(GRAPH_FLAG_CONTRACTS);
-const GUIDE_FLAGS = toCompletionFlagString(GUIDE_FLAG_CONTRACTS);
-const SEARCH_FLAGS = toCompletionFlagString(SEARCH_FLAG_CONTRACTS);
-const STATS_FLAGS = toCompletionFlagString(STATS_FLAG_CONTRACTS);
-const HEALTH_FLAGS = toCompletionFlagString(HEALTH_FLAG_CONTRACTS);
-const INIT_FLAGS = toCompletionFlagString(INIT_FLAG_CONTRACTS);
-const CONTRACTS_FLAGS = toCompletionFlagString(CONTRACTS_FLAG_CONTRACTS);
-const PLAN_FLAGS = toCompletionFlagString(PLAN_FLAG_CONTRACTS);
-const PLAN_SUBCOMMANDS_LIST = "create show add-step update-step complete-step block-step reorder-step remove-step link unlink decision discovery validation resume approve materialize";
-const COMPLETION_FLAGS = toCompletionFlagString(COMPLETION_FLAG_CONTRACTS);
-const COMPLETION_SHELL_CHOICES = `${COMPLETION_FLAGS} bash zsh fish`;
-const GUIDE_TOPIC_CHOICES = joinCompletionValues(listGuideTopicIds());
-const EXTENSION_LIFECYCLE_ACTIONS = "init scaffold install uninstall explore manage describe reload doctor catalog adopt adopt-all activate deactivate migrate";
-const PACKAGE_LIFECYCLE_ACTIONS = `${EXTENSION_LIFECYCLE_ACTIONS} upgrade`;
-const EXTENSION_LIFECYCLE_FLAGS = toCompletionFlagString(EXTENSION_FLAG_CONTRACTS);
-const PACKAGE_LIFECYCLE_FLAGS = toCompletionFlagString(PACKAGE_FLAG_CONTRACTS);
-const UPGRADE_FLAGS = toCompletionFlagString(UPGRADE_FLAG_CONTRACTS);
-const MUTATION_FLAGS = "--author --message --force --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help";
-const DELETE_MUTATION_FLAGS = "--dry-run --author --message --force --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help";
-const CLOSE_MUTATION_FLAGS = "--author --message --validate-close --duplicate-of --force --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help";
-const RELEASE_MUTATION_FLAGS = "--author --message --force --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help";
-const COMMAND_COMPLETION_DESCRIPTIONS = [
-    ["init", "Initialize pm storage for the current workspace"],
-    ["config", "Read or update pm settings"],
-    ["package", "Manage package lifecycle operations"],
-    ["packages", "Alias for package"],
-    ["create", "Create a new project management item"],
-    ["copy", "Copy an existing item to a new ID"],
-    ["focus", "Set/clear/show the session focused parent for new items"],
-    ["list", "List active items with optional filters"],
-    [
-        "aggregate",
-        "Aggregate grouped item counts and numeric stats for governance queries",
-    ],
-    ["duplicates", "Find bounded duplicate clusters across lifecycle statuses"],
-    ["guide", "Browse local progressive-disclosure guides"],
-    ["calendar", "Show calendar views for deadlines and reminders"],
-    ["cal", "Alias for calendar"],
-    ["context", "Show a token-efficient project context snapshot"],
-    ["ctx", "Alias for context"],
-    ["get", "Show item details by ID"],
-    ["next", "Recommend the next actionable (unblocked, ready) work item"],
-    ["search", "Search items with keyword, semantic, or hybrid modes"],
-    ["reindex", "Rebuild search artifacts"],
-    ["history", "Show item history entries"],
-    [
-        "history-compact",
-        "Compact history streams into a synthetic baseline + retained tail",
-    ],
-    [
-        "history-redact",
-        "Redact sensitive literals/patterns and recompute history hashes",
-    ],
-    [
-        "history-repair",
-        "Re-anchor a drifted history chain so pm health/validate report ok",
-    ],
-    [
-        "schema",
-        "Manage custom item types and statuses in .agents/pm/schema/*.json",
-    ],
-    [
-        "profile",
-        "List, show, apply, and lint project profiles (archetype schema/config/template/package bundles)",
-    ],
-    [
-        "plan",
-        "Agent-optimized Plan item workflow (create/show/add-step/update-step/complete-step/link/approve/materialize)",
-    ],
-    ["activity", "Show recent activity across items"],
-    ["restore", "Restore an item to an earlier state"],
-    ["update", "Update item fields and metadata"],
-    [
-        "update-many",
-        "Bulk-update matched items with dry-run and rollback checkpoints",
-    ],
-    ["close", "Close an item (reason requirement follows governance settings)"],
-    [
-        "close-many",
-        "Bulk-close matched items with an optional shared reason and rollback checkpoint",
-    ],
-    ["delete", "Delete an item and record the change"],
-    ["append", "Append text to an item body"],
-    ["comments", "List or add comments for an item"],
-    ["notes", "List or add notes for an item"],
-    ["learnings", "List or add learnings for an item"],
-    ["files", "Manage linked files"],
-    ["docs", "Manage linked docs"],
-    ["deps", "Show dependency relationships for an item"],
-    ["graph", "Bounded graph traversal, analytics, and governance-audit queries"],
-    ["test", "Manage linked tests and optionally run them"],
-    ["test-all", "Run linked tests across matching items"],
-    ["test-runs", "Manage background linked-test runs"],
-    ["stats", "Show project tracker statistics"],
-    ["health", "Show project tracker health checks"],
-    ["validate", "Run standalone validation checks"],
-    ["gc", "Clean optional cache artifacts"],
-    ["contracts", "Show machine-readable command and schema contracts"],
-    ["claim", "Claim an item for active work"],
-    ["release", "Release the active claim for an item"],
-    ["start-task", "Lifecycle alias to claim and set in_progress"],
-    ["pause-task", "Lifecycle alias to reopen and release claim"],
-    ["close-task", "Lifecycle alias to close and release claim"],
-    ["meet", "Shortcut to create a Meeting with scheduling defaults"],
-    ["event", "Shortcut to create an Event with scheduling defaults"],
-    ["remind", "Shortcut to create a Reminder from a point in time"],
-    ["templates", "Manage reusable create templates"],
-    ["completion", "Generate shell completion"],
-    ["help", "Display help for a command"],
-];
-const FISH_COMMAND_DESCRIPTION_OVERRIDES = new Map([
-    ["calendar", "Show deadline/reminder calendar views"],
-    ["schema", "Inspect and manage runtime schema"],
-    [
-        "profile",
-        "List, show, apply, and lint project profiles (archetype bundles)",
-    ],
-    [
-        "plan",
-        "Agent-optimized Plan workflow (create/show/add-step/update-step/complete-step/link/approve/materialize)",
-    ],
-    ["start-task", "Lifecycle alias to claim and set in-progress"],
-]);
-const GLOBAL_FLAGS = GLOBAL_FLAG_CONTRACTS.flatMap((entry) => [
-    entry.short,
-    entry.flag,
-    ...(entry.aliases ?? []),
-])
-    .filter((value) => Boolean(value))
-    .join(" ");
-function joinCompletionValues(values) {
-    return [
-        ...new Set(values.map((value) => value.trim()).filter((value) => value.length > 0)),
-    ]
-        .sort((left, right) => left.localeCompare(right))
-        .join(" ");
-}
-function joinCompletionValuesInOrder(values) {
-    return [
-        ...new Set(values.map((value) => value.trim()).filter((value) => value.length > 0)),
-    ].join(" ");
-}
-function shellDoubleQuote(value) {
-    return value
-        .replaceAll("\\", "\\\\")
-        .replaceAll('"', '\\"')
-        .replaceAll("$", "\\$")
-        .replaceAll("`", "\\`");
-}
-function completionTypeValues(itemTypes, runtime) {
-    return joinCompletionValuesInOrder(itemTypes.length > 0
-        ? itemTypes
-        : (runtime.item_types ?? DEFAULT_ITEM_TYPES));
-}
-function completionStatusValues(runtime) {
-    return joinCompletionValues(runtime.statuses ?? DEFAULT_STATUS_VALUES);
-}
-function mergeFlagStrings(baseFlags, runtimeFlags) {
-    const merged = [
-        ...baseFlags.split(/\s+/u).filter((value) => value.length > 0),
-        ...(runtimeFlags ?? []),
-    ];
-    return joinCompletionValues(merged);
-}
-function normalizeRuntimeCompletionFlags(runtimeFlags) {
-    const normalized = (runtimeFlags ?? [])
-        .map((value) => value.trim())
-        .filter((value) => value.startsWith("--") && value.length > 2)
-        .map((value) => `--${value.slice(2).replaceAll("_", "-")}`);
-    return [...new Set(normalized)].sort((left, right) => left.localeCompare(right));
-}
-function renderZshRuntimeFieldFlagSpecs(runtimeFlags) {
-    const normalized = normalizeRuntimeCompletionFlags(runtimeFlags);
-    if (normalized.length === 0) {
-        return "";
-    }
-    return `${normalized.map((flag) => `            '${flag}[Runtime schema field flag]:value' \\`).join("\n")}\n`;
-}
-function renderZshArgumentSpecs(specs, options = {}) {
-    const trailingContinuation = options.trailingContinuation ?? true;
-    const lastSpecIndex = specs.length - 1;
-    return specs
-        .map((spec, index) => `            ${spec}${trailingContinuation || index !== lastSpecIndex ? " \\" : ""}`)
-        .join("\n");
-}
-function renderZshCommandDescriptions() {
-    return COMMAND_COMPLETION_DESCRIPTIONS.map(([command, description]) => `    '${command}:${description}'`).join("\n");
-}
-function renderFishCommandDescriptions() {
-    return COMMAND_COMPLETION_DESCRIPTIONS.filter(([command]) => command !== "help")
-        .map(([command, description]) => {
-        const fishDescription = FISH_COMMAND_DESCRIPTION_OVERRIDES.get(command) ?? description;
-        return `complete -c pm -n __pm_no_subcommand -a ${command.padEnd(16)} -d '${fishDescription}'`;
-    })
-        .join("\n");
-}
-function renderZshPresenceFilterSpecs(options) {
-    const missingSpecs = [
-        "reviewer-missing[Select only items missing reviewer]",
-        "risk-missing[Select only items missing risk]",
-        "confidence-missing[Select only items missing confidence]",
-        "sprint-missing[Select only items missing sprint]",
-        "release-missing[Select only items missing release]",
-    ];
-    const contentMissingAliasSpecs = options.includeContentMissingAliases === true
-        ? [
-            "files-missing[Alias for --no-files]",
-            "docs-missing[Alias for --no-docs]",
-        ]
-        : [];
-    const pairedSpecs = [
-        [
-            "has-notes[Select only items that have notes]",
-            "no-notes[Select only items with no notes]",
-        ],
-        [
-            "has-learnings[Select only items that have learnings]",
-            "no-learnings[Select only items with no learnings]",
-        ],
-        [
-            "has-files[Select only items that have linked files]",
-            "no-files[Select only items with no linked files]",
-        ],
-        [
-            "has-docs[Select only items that have linked docs]",
-            "no-docs[Select only items with no linked docs]",
-        ],
-        [
-            "has-tests[Select only items that have linked tests]",
-            "no-tests[Select only items with no linked tests]",
-        ],
-        [
-            "has-comments[Select only items that have comments]",
-            "no-comments[Select only items with no comments]",
-        ],
-        [
-            "has-deps[Select only items that have dependencies]",
-            "no-deps[Select only items with no dependencies]",
-        ],
-        [
-            "has-body[Select only items with non-empty body]",
-            "empty-body[Select only items with empty body]",
-        ],
-        [
-            "has-linked-command[Select only items that have a linked command]",
-            "no-linked-command[Select only items with no linked command]",
-        ],
-    ];
-    return renderZshArgumentSpecs([
-        ...[...missingSpecs, ...contentMissingAliasSpecs].map((spec) => `'--${options.missingPrefix}${spec}'`),
-        ...pairedSpecs.flatMap(([positive, negative]) => [
-            `'--${options.pairedPrefix}${positive}'`,
-            `'--${options.pairedPrefix}${negative}'`,
-        ]),
-    ]);
-}
-const ZSH_MUTATION_COLLECTION_ARGUMENT_SPECS = [
-    "'--comment[Comment seed author=<value>,created_at=<iso|now>,text=<value>]:comment'",
-    "'--note[Note seed author=<value>,created_at=<iso|now>,text=<value>]:note'",
-    "'--learning[Learning seed author=<value>,created_at=<iso|now>,text=<value>]:learning'",
-    "'--file[Linked file path=<value>,scope=<project|global>,note=<text>]:file'",
-    "'--test[Linked test command=<value>,path=<value>,scope=<project|global>]:test'",
-    "'--doc[Linked doc path=<value>,scope=<project|global>,note=<text>]:doc'",
-    "'--reminder[Reminder entry at=<iso|relative>|date=<iso|relative>,text=<text>|title=<text>]:reminder'",
-    "'--event[Event entry start=<iso|relative>,end=<iso|relative>,recur_*]:event'",
-    "'--type-option[Type option key=value or key=<name>,value=<value>]:type_option'",
-    "'--unset[Clear scalar metadata field by name]:field'",
-    "'--replace-files[Atomically replace linked files with provided --file values]'",
-    "'--replace-docs[Atomically replace linked docs with provided --doc values]'",
-    "'--clear-deps[Clear dependency entries]'",
-    "'--clear-comments[Clear comments]'",
-    "'--clear-notes[Clear notes]'",
-    "'--clear-learnings[Clear learnings]'",
-    "'--clear-files[Clear linked files]'",
-    "'--clear-tests[Clear linked tests]'",
-    "'--clear-docs[Clear linked docs]'",
-    "'--clear-reminders[Clear reminders]'",
-    "'--clear-events[Clear events]'",
-    "'--clear-type-options[Clear type options]'",
-];
-function renderZshScheduleItemSpecs(kind) {
-    const leadingSpecs = kind === "reminder"
-        ? [
-            "'--at[Reminder time (default +1d)]:at'",
-            "'--text[Reminder text (defaults to title)]:text'",
-        ]
-        : [
-            "'--start[Start time (ISO, now, or relative)]:start'",
-            "'--duration[Duration from start (default 1h)]:duration'",
-            "'--end[End time (overrides --duration)]:end'",
-            "'--location[Location]:location'",
-            "'--timezone[IANA timezone]:timezone'",
-            "'--all-day[Mark as an all-day event]'",
-        ];
-    return renderZshArgumentSpecs([
-        ...leadingSpecs,
-        "'--parent[Parent item id]:parent'",
-        "'--allow-missing-parent[Permit a parent id that does not exist yet]'",
-        "'--tags[Comma-separated tags]:tags'",
-        "'(-p --priority)'{-p,--priority}'[Priority (0-4)]:(0 1 2 3 4)'",
-        "'(-b --body)'{-b,--body}'[Item body]:body'",
-        "'(-d --description)'{-d,--description}'[Short description]:description'",
-        "'--author[Mutation author]:author'",
-        "'--message[History message]:message'",
-        "'--json[Output JSON]'",
-        "'--quiet[Suppress stdout]'",
-    ], { trailingContinuation: false });
-}
-function renderZshBulkSelectionFilterSpecs(action, statusChoices, typeChoices, tagChoices) {
-    return renderZshArgumentSpecs([
-        `'--filter-status[Filter by status before ${action}]:(${statusChoices})'`,
-        `'--filter-type[Filter by type before ${action}]:(${typeChoices})'`,
-        `'--filter-tag[Filter by tag before ${action}]:(${tagChoices})'`,
-        `'--filter-priority[Filter by priority before ${action}]:(0 1 2 3 4)'`,
-        "'--filter-deadline-before[Filter by deadline upper bound]:deadline'",
-        "'--filter-deadline-after[Filter by deadline lower bound]:deadline'",
-        "'--filter-updated-after[Filter by updated_at lower bound (ISO/relative)]:timestamp'",
-        "'--filter-updated-before[Filter by updated_at upper bound (ISO/relative)]:timestamp'",
-        "'--filter-created-after[Filter by created_at lower bound (ISO/relative)]:timestamp'",
-        "'--filter-created-before[Filter by created_at upper bound (ISO/relative)]:timestamp'",
-        `'--filter-assignee[Filter by assignee before ${action}]:assignee'`,
-        "'--filter-assignee-filter[Filter assignee presence]:(assigned unassigned)'",
-        "'--filter-parent[Filter by parent item ID]:parent'",
-        "'--filter-sprint[Filter by sprint]:sprint'",
-        "'--filter-release[Filter by release]:release'",
-    ]);
-}
-function renderFishRuntimeFieldFlagSpecs(commands, runtimeFlags) {
-    const normalizedFlags = normalizeRuntimeCompletionFlags(runtimeFlags).map((flag) => flag.slice(2));
-    if (commands.length === 0 || normalizedFlags.length === 0) {
-        return "";
-    }
-    const lines = [];
-    for (const command of commands) {
-        for (const flag of normalizedFlags) {
-            lines.push(`complete -c pm -n '__fish_seen_subcommand_from ${command}' -l ${flag} -d 'Runtime schema field flag' -r`);
-        }
-    }
-    return `${lines.join("\n")}\n`;
-}
-function renderBashDynamicChoiceResolver(kind, command, fallback) {
-    const envKind = kind.toUpperCase();
-    const cacheVar = `PM_COMPLETION_${envKind}_CACHE`;
-    const cacheTsVar = `PM_COMPLETION_${envKind}_CACHE_TS`;
-    const ttlVar = `PM_COMPLETION_${envKind}_TTL`;
-    const escapedFallback = shellDoubleQuote(fallback);
-    return [
-        `_pm_completion_${kind}_choices() {`,
-        "  local now ttl cache_ts resolved",
-        '  now="$(date +%s 2>/dev/null || echo 0)"',
-        `  ttl="\${${ttlVar}:-120}"`,
-        `  cache_ts="\${${cacheTsVar}:-0}"`,
-        `  if [[ -n "\${${cacheVar}:-}" && "$now" -ne 0 && $((now - cache_ts)) -lt "$ttl" ]]; then`,
-        `    printf '%s\\n' "$${cacheVar}"`,
-        "    return 0",
-        "  fi",
-        `  resolved="$(pm ${command} 2>/dev/null)"`,
-        '  if [[ -z "$resolved" ]]; then',
-        `    resolved="${escapedFallback}"`,
-        "  fi",
-        `  ${cacheVar}="$resolved"`,
-        `  ${cacheTsVar}="$now"`,
-        `  printf '%s\\n' "$${cacheVar}"`,
-        "}",
-    ];
-}
-function renderZshDynamicChoiceResolver(kind, command, fallback) {
-    const envKind = kind.toUpperCase();
-    const cacheVar = `PM_COMPLETION_${envKind}_CACHE`;
-    const cacheTsVar = `PM_COMPLETION_${envKind}_CACHE_TS`;
-    const ttlVar = `PM_COMPLETION_${envKind}_TTL`;
-    const escapedFallback = shellDoubleQuote(fallback);
-    return `
+!(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]="79ec64d0-27b8-514f-a983-64971ed3cf18")}catch(e2){}})();import{WORKFLOW_POLICY_ACTIONS}from"./cli-contracts/enum-contracts.js";import{EXIT_CODE,PmCliError}from"./runtime-primitives.js";import{listPmCommandsForTier}from"./agent-capability-contracts.js";import{SCAFFOLD_CAPABILITIES}from"./extension/scaffold.js";import{AGGREGATE_FLAG_CONTRACTS,APPEND_FLAG_CONTRACTS,CALENDAR_FLAG_CONTRACTS,CLOSE_MANY_FLAG_CONTRACTS,COMPLETION_FLAG_CONTRACTS,CONTRACTS_FLAG_CONTRACTS,CONTEXT_FLAG_CONTRACTS,COPY_FLAG_CONTRACTS,FOCUS_FLAG_CONTRACTS,MEET_FLAG_CONTRACTS,REMIND_FLAG_CONTRACTS,CREATE_FLAG_CONTRACTS,DEPS_FLAG_CONTRACTS,DUPLICATES_FLAG_CONTRACTS,EXTENSION_FLAG_CONTRACTS,GRAPH_FLAG_CONTRACTS,GET_FLAG_CONTRACTS,GUIDE_FLAG_CONTRACTS,GLOBAL_FLAG_CONTRACTS,HEALTH_FLAG_CONTRACTS,HISTORY_AUTHOR_ACKNOWLEDGE_FLAG_CONTRACTS,HISTORY_FLAG_CONTRACTS,INIT_FLAG_CONTRACTS,LIST_FILTER_FLAG_CONTRACTS,NEXT_FLAG_CONTRACTS,PM_COMMAND_ALIAS_CONTRACTS,PM_HISTORY_COMMAND_ALIASES,resolveSubcommandFlagContractsForCommand,PACKAGE_FLAG_CONTRACTS,PLAN_FLAG_CONTRACTS,SEARCH_FLAG_CONTRACTS,STATS_FLAG_CONTRACTS,EVENTS_FLAG_CONTRACTS,UPDATE_FLAG_CONTRACTS,UPDATE_MANY_FLAG_CONTRACTS,UPGRADE_FLAG_CONTRACTS,toCompletionFlagString}from"./cli-contracts.js";import{BUILTIN_ITEM_TYPE_VALUES,STATUS_VALUES}from"../types/index.js";import{listGuideTopicIds}from"./guide-topics.js";import{enrichCliFlagInvocationContracts}from"./flag-invocation-contracts.js";import{GLOBAL_VALUE_CONSUMING_FLAGS}from"./cli-contracts/bootstrap-command-scanner.js";const VALID_SHELLS=["bash","zsh","fish"];const DEFAULT_ITEM_TYPES=[...BUILTIN_ITEM_TYPE_VALUES];const DEFAULT_STATUS_VALUES=[...STATUS_VALUES];const HIDDEN_COMMAND_ALIASES=new Set(PM_COMMAND_ALIAS_CONTRACTS.filter(contract=>contract.hidden).map(contract=>contract.alias));const ALL_COMMANDS=listPmCommandsForTier("full").filter(command=>!HIDDEN_COMMAND_ALIASES.has(command));const LIST_FLAGS=toCompletionFlagString(LIST_FILTER_FLAG_CONTRACTS);const AGGREGATE_FLAGS=toCompletionFlagString(AGGREGATE_FLAG_CONTRACTS);const APPEND_FLAGS=toCompletionFlagString(APPEND_FLAG_CONTRACTS);const COPY_FLAGS=toCompletionFlagString(COPY_FLAG_CONTRACTS);const RESTORE_INVOCATIONS=enrichCliFlagInvocationContracts("restore",resolveSubcommandFlagContractsForCommand("restore"));const FOCUS_FLAGS=toCompletionFlagString(FOCUS_FLAG_CONTRACTS);const MEET_FLAGS=toCompletionFlagString(MEET_FLAG_CONTRACTS);const REMIND_FLAGS=toCompletionFlagString(REMIND_FLAG_CONTRACTS);const CREATE_FLAGS=toCompletionFlagString(CREATE_FLAG_CONTRACTS);const GET_FLAGS=toCompletionFlagString(GET_FLAG_CONTRACTS);const UPDATE_FLAGS=toCompletionFlagString(UPDATE_FLAG_CONTRACTS);const UPDATE_MANY_FLAGS=toCompletionFlagString(UPDATE_MANY_FLAG_CONTRACTS);const CLOSE_MANY_FLAGS=toCompletionFlagString(CLOSE_MANY_FLAG_CONTRACTS);const HISTORY_LEAVES=PM_HISTORY_COMMAND_ALIASES.map(entry=>entry.canonical_argv[1]).join(" ");const HISTORY_OPERATION_FLAGS=PM_HISTORY_COMMAND_ALIASES.map(entry=>({...entry,flags:toCompletionFlagString(resolveSubcommandFlagContractsForCommand(entry.alias))}));const HISTORY_FLAGS=toCompletionFlagString(HISTORY_FLAG_CONTRACTS);const HISTORY_AUTHOR_ACKNOWLEDGE_FLAGS=toCompletionFlagString(HISTORY_AUTHOR_ACKNOWLEDGE_FLAG_CONTRACTS,false);const EVENTS_FLAGS=toCompletionFlagString(EVENTS_FLAG_CONTRACTS);const CALENDAR_FLAGS=toCompletionFlagString(CALENDAR_FLAG_CONTRACTS);const CONTEXT_FLAGS=toCompletionFlagString(CONTEXT_FLAG_CONTRACTS);const NEXT_FLAGS=toCompletionFlagString(NEXT_FLAG_CONTRACTS);const DEPS_FLAGS=toCompletionFlagString(DEPS_FLAG_CONTRACTS);const DUPLICATES_FLAGS=toCompletionFlagString(DUPLICATES_FLAG_CONTRACTS);const GRAPH_FLAGS=toCompletionFlagString(GRAPH_FLAG_CONTRACTS);const GUIDE_FLAGS=toCompletionFlagString(GUIDE_FLAG_CONTRACTS);const SEARCH_FLAGS=toCompletionFlagString(SEARCH_FLAG_CONTRACTS);const STATS_FLAGS=toCompletionFlagString(STATS_FLAG_CONTRACTS);const HEALTH_FLAGS=toCompletionFlagString(HEALTH_FLAG_CONTRACTS);const INIT_FLAGS=toCompletionFlagString(INIT_FLAG_CONTRACTS);const CONTRACTS_FLAGS=toCompletionFlagString(CONTRACTS_FLAG_CONTRACTS);const PLAN_FLAGS=toCompletionFlagString(PLAN_FLAG_CONTRACTS);const SCHEMA_SUBCOMMAND_CHOICES=`${WORKFLOW_POLICY_ACTIONS.join(" ")} list show show-status add-type remove-type add-status remove-status add-field remove-field list-fields show-field apply-preset rename-type rename-field remap-status`;const PLAN_SUBCOMMANDS_LIST="create show add-step update-step complete-step block-step reorder-step remove-step link unlink decision discovery validation resume approve materialize";const COMPLETION_FLAGS=toCompletionFlagString(COMPLETION_FLAG_CONTRACTS);const COMPLETION_SHELL_CHOICES=`${COMPLETION_FLAGS} bash zsh fish`;const GUIDE_TOPIC_CHOICES=joinCompletionValues(listGuideTopicIds());const EXTENSION_LIFECYCLE_ACTIONS="init scaffold install uninstall explore manage describe reload doctor catalog adopt adopt-all activate deactivate migrate";const PACKAGE_LIFECYCLE_ACTIONS=`${EXTENSION_LIFECYCLE_ACTIONS} upgrade`;const EXTENSION_LIFECYCLE_FLAGS=toCompletionFlagString(EXTENSION_FLAG_CONTRACTS);const PACKAGE_LIFECYCLE_FLAGS=toCompletionFlagString(PACKAGE_FLAG_CONTRACTS);const UPGRADE_FLAGS=toCompletionFlagString(UPGRADE_FLAG_CONTRACTS);const MUTATION_FLAGS="--author --message --force --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help";const DELETE_MUTATION_FLAGS="--dry-run --author --message --force --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help";const CLOSE_MUTATION_FLAGS="--author --message --validate-close --duplicate-of --force --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help";const RELEASE_MUTATION_FLAGS="--author --message --force --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help";const COMMAND_COMPLETION_DESCRIPTIONS=[["init","Initialize pm storage for the current workspace"],["config","Read or update pm settings"],["package","Manage package lifecycle operations"],["packages","Alias for package"],["create","Create a new project management item"],["copy","Copy an existing item to a new ID"],["focus","Set/clear/show the session focused parent for new items"],["list","List active items with optional filters"],["aggregate","Aggregate grouped item counts and numeric stats for governance queries"],["duplicates","Find bounded duplicate clusters across lifecycle statuses"],["guide","Browse local progressive-disclosure guides"],["calendar","Show calendar views for deadlines and reminders"],["cal","Alias for calendar"],["context","Show a token-efficient project context snapshot"],["ctx","Alias for context"],["get","Show item details by ID"],["next","Recommend the next actionable (unblocked, ready) work item"],["search","Search items with keyword, semantic, or hybrid modes"],["reindex","Rebuild search artifacts"],["history","Show item history entries"],["history-compact","Compact history streams into a synthetic baseline + retained tail"],["history-redact","Redact sensitive literals/patterns and recompute history hashes"],["history-repair","Re-anchor a drifted history chain so pm health/validate report ok"],["schema","Manage custom item types and statuses in .agents/pm/schema/*.json"],["profile","List, show, apply, and lint project profiles (archetype schema/config/template/package bundles)"],["plan","Agent-optimized Plan item workflow (create/show/add-step/update-step/complete-step/link/approve/materialize)"],["activity","Show recent activity across items"],["restore","Restore an item to an earlier state"],["update","Update item fields and metadata"],["update-many","Bulk-update matched items with dry-run and rollback checkpoints"],["close","Close an item (reason requirement follows governance settings)"],["close-many","Bulk-close matched items with an optional shared reason and rollback checkpoint"],["delete","Delete an item and record the change"],["append","Append text to an item body"],["comments","List or add comments for an item"],["notes","List or add notes for an item"],["learnings","List or add learnings for an item"],["files","Manage linked files"],["docs","Manage linked docs"],["deps","Show dependency relationships for an item"],["graph","Bounded graph traversal, analytics, and governance-audit queries"],["test","Manage linked tests and optionally run them"],["test-all","Run linked tests across matching items"],["test-runs","Manage background linked-test runs"],["stats","Show project tracker statistics"],["health","Show project tracker health checks"],["validate","Run standalone validation checks"],["gc","Clean optional cache artifacts"],["contracts","Show machine-readable command and schema contracts"],["claim","Claim an item for active work"],["release","Release the active claim for an item"],["start-task","Lifecycle alias to claim and set in_progress"],["pause-task","Lifecycle alias to reopen and release claim"],["close-task","Lifecycle alias to close and release claim"],["meet","Shortcut to create a Meeting with scheduling defaults"],["event","Shortcut to create an Event with scheduling defaults"],["remind","Shortcut to create a Reminder from a point in time"],["templates","Manage reusable create templates"],["completion","Generate shell completion"],["help","Display help for a command"]];const FISH_COMMAND_DESCRIPTION_OVERRIDES=new Map([["calendar","Show deadline/reminder calendar views"],["schema","Inspect and manage runtime schema"],["profile","List, show, apply, and lint project profiles (archetype bundles)"],["plan","Agent-optimized Plan workflow (create/show/add-step/update-step/complete-step/link/approve/materialize)"],["start-task","Lifecycle alias to claim and set in-progress"]]);const GLOBAL_FLAGS=GLOBAL_FLAG_CONTRACTS.flatMap(entry=>[entry.short,entry.flag,...entry.aliases??[]]).filter(value=>Boolean(value)).join(" ");const GLOBAL_COMPLETION_VALUE_PATTERNS=[...GLOBAL_VALUE_CONSUMING_FLAGS].join("|");const GLOBAL_COMPLETION_INLINE_PATTERNS=[...GLOBAL_VALUE_CONSUMING_FLAGS].map(flag=>`${flag}=*`).join("|");const GLOBAL_COMPLETION_SWITCH_PATTERNS=[...GLOBAL_FLAGS.split(" ").filter(flag=>!GLOBAL_VALUE_CONSUMING_FLAGS.has(flag)),"-h","-V"].join("|");function joinCompletionValues(values){return[...new Set(values.map(value=>value.trim()).filter(value=>value.length>0))].sort((left,right)=>left.localeCompare(right)).join(" ")}function joinCompletionValuesInOrder(values){return[...new Set(values.map(value=>value.trim()).filter(value=>value.length>0))].join(" ")}function shellDoubleQuote(value){return value.replaceAll("\\","\\\\").replaceAll('"','\\"').replaceAll("$","\\$").replaceAll("`","\\`")}function completionTypeValues(itemTypes,runtime){return joinCompletionValuesInOrder(itemTypes.length>0?itemTypes:runtime.item_types??DEFAULT_ITEM_TYPES)}function completionStatusValues(runtime){return joinCompletionValues(runtime.statuses??DEFAULT_STATUS_VALUES)}function mergeFlagStrings(baseFlags,runtimeFlags){const merged=[...baseFlags.split(/\s+/u).filter(value=>value.length>0),...runtimeFlags??[]];return joinCompletionValues(merged)}function normalizeRuntimeCompletionFlags(runtimeFlags){const normalized=(runtimeFlags??[]).map(value=>value.trim()).filter(value=>value.startsWith("--")&&value.length>2).map(value=>`--${value.slice(2).replaceAll("_","-")}`);return[...new Set(normalized)].sort((left,right)=>left.localeCompare(right))}function renderZshRuntimeFieldFlagSpecs(runtimeFlags){const normalized=normalizeRuntimeCompletionFlags(runtimeFlags);if(normalized.length===0){return""}return`${normalized.map(flag=>`            '${flag}[Runtime schema field flag]:value' \\`).join("\n")}
+`}function renderZshArgumentSpecs(specs,options={}){const trailingContinuation=options.trailingContinuation??true;const lastSpecIndex=specs.length-1;return specs.map((spec,index)=>`            ${spec}${trailingContinuation||index!==lastSpecIndex?" \\":""}`).join("\n")}function renderZshCommandDescriptions(){return COMMAND_COMPLETION_DESCRIPTIONS.filter(([command])=>!HIDDEN_COMMAND_ALIASES.has(command)).map(([command,description])=>`    '${command}:${description}'`).join("\n")}function renderFishCommandDescriptions(){return COMMAND_COMPLETION_DESCRIPTIONS.filter(([command])=>command!=="help"&&!HIDDEN_COMMAND_ALIASES.has(command)).map(([command,description])=>{const fishDescription=FISH_COMMAND_DESCRIPTION_OVERRIDES.get(command)??description;return`complete -c pm -n __pm_no_subcommand -a ${command.padEnd(16)} -d '${fishDescription}'`}).join("\n")}function renderZshPresenceFilterSpecs(options){const missingSpecs=["reviewer-missing[Select only items missing reviewer]","risk-missing[Select only items missing risk]","confidence-missing[Select only items missing confidence]","sprint-missing[Select only items missing sprint]","release-missing[Select only items missing release]"];const contentMissingAliasSpecs=options.includeContentMissingAliases===true?["files-missing[Alias for --no-files]","docs-missing[Alias for --no-docs]"]:[];const pairedSpecs=[["has-notes[Select only items that have notes]","no-notes[Select only items with no notes]"],["has-learnings[Select only items that have learnings]","no-learnings[Select only items with no learnings]"],["has-files[Select only items that have linked files]","no-files[Select only items with no linked files]"],["has-docs[Select only items that have linked docs]","no-docs[Select only items with no linked docs]"],["has-tests[Select only items that have linked tests]","no-tests[Select only items with no linked tests]"],["has-comments[Select only items that have comments]","no-comments[Select only items with no comments]"],["has-deps[Select only items that have dependencies]","no-deps[Select only items with no dependencies]"],["has-body[Select only items with non-empty body]","empty-body[Select only items with empty body]"],["has-linked-command[Select only items that have a linked command]","no-linked-command[Select only items with no linked command]"]];return renderZshArgumentSpecs([...[...missingSpecs,...contentMissingAliasSpecs].map(spec=>`'--${options.missingPrefix}${spec}'`),...pairedSpecs.flatMap(([positive,negative])=>[`'--${options.pairedPrefix}${positive}'`,`'--${options.pairedPrefix}${negative}'`])])}const ZSH_MUTATION_COLLECTION_ARGUMENT_SPECS=["'--comment[Comment seed author=<value>,created_at=<iso|now>,text=<value>]:comment'","'--note[Note seed author=<value>,created_at=<iso|now>,text=<value>]:note'","'--learning[Learning seed author=<value>,created_at=<iso|now>,text=<value>]:learning'","'--file[Linked file path=<value>,scope=<project|global>,note=<text>]:file'","'--test[Linked test command=<value>,path=<value>,scope=<project|global>]:test'","'--doc[Linked doc path=<value>,scope=<project|global>,note=<text>]:doc'","'--reminder[Reminder entry at=<iso|relative>|date=<iso|relative>,text=<text>|title=<text>]:reminder'","'--event[Event entry start=<iso|relative>,end=<iso|relative>,recur_*]:event'","'--type-option[Type option key=value or key=<name>,value=<value>]:type_option'","'--unset[Clear scalar metadata field by name]:field'","'--replace-files[Atomically replace linked files with provided --file values]'","'--replace-docs[Atomically replace linked docs with provided --doc values]'","'--clear-deps[Clear dependency entries]'","'--clear-comments[Clear comments]'","'--clear-notes[Clear notes]'","'--clear-learnings[Clear learnings]'","'--clear-files[Clear linked files]'","'--clear-tests[Clear linked tests]'","'--clear-docs[Clear linked docs]'","'--clear-reminders[Clear reminders]'","'--clear-events[Clear events]'","'--clear-type-options[Clear type options]'"];function renderZshScheduleItemSpecs(kind){const leadingSpecs=kind==="reminder"?["'--at[Reminder time (default +1d)]:at'","'--text[Reminder text (defaults to title)]:text'"]:["'--start[Start time (ISO, now, or relative)]:start'","'--duration[Duration from start (default 1h)]:duration'","'--end[End time (overrides --duration)]:end'","'--location[Location]:location'","'--timezone[IANA timezone]:timezone'","'--all-day[Mark as an all-day event]'"];return renderZshArgumentSpecs([...leadingSpecs,"'--parent[Parent item id]:parent'","'--allow-missing-parent[Permit a parent id that does not exist yet]'","'--tags[Comma-separated tags]:tags'","'(-p --priority)'{-p,--priority}'[Priority (0-4)]:(0 1 2 3 4)'","'(-b --body)'{-b,--body}'[Item body]:body'","'(-d --description)'{-d,--description}'[Short description]:description'","'--author[Mutation author]:author'","'--message[History message]:message'","'--json[Output JSON]'","'--quiet[Suppress stdout]'"],{trailingContinuation:false})}function renderZshBulkSelectionFilterSpecs(action,statusChoices,typeChoices,tagChoices){return renderZshArgumentSpecs([`'--filter-status[Filter by status before ${action}]:(${statusChoices})'`,`'--filter-type[Filter by type before ${action}]:(${typeChoices})'`,`'--filter-tag[Filter by tag before ${action}]:(${tagChoices})'`,`'--filter-priority[Filter by priority before ${action}]:(0 1 2 3 4)'`,"'--filter-deadline-before[Filter by deadline upper bound]:deadline'","'--filter-deadline-after[Filter by deadline lower bound]:deadline'","'--filter-updated-after[Filter by updated_at lower bound (ISO/relative)]:timestamp'","'--filter-updated-before[Filter by updated_at upper bound (ISO/relative)]:timestamp'","'--filter-created-after[Filter by created_at lower bound (ISO/relative)]:timestamp'","'--filter-created-before[Filter by created_at upper bound (ISO/relative)]:timestamp'",`'--filter-assignee[Filter by assignee before ${action}]:assignee'`,"'--filter-assignee-filter[Filter assignee presence]:(assigned unassigned)'","'--filter-parent[Filter by parent item ID]:parent'","'--filter-sprint[Filter by sprint]:sprint'","'--filter-release[Filter by release]:release'"])}function renderFishRuntimeFieldFlagSpecs(commands,runtimeFlags){const normalizedFlags=normalizeRuntimeCompletionFlags(runtimeFlags).map(flag=>flag.slice(2));if(commands.length===0||normalizedFlags.length===0){return""}const lines=[];for(const command of commands){for(const flag of normalizedFlags){lines.push(`complete -c pm -n '__fish_seen_subcommand_from ${command}' -l ${flag} -d 'Runtime schema field flag' -r`)}}return`${lines.join("\n")}
+`}function renderBashDynamicChoiceResolver(kind,command,fallback){const envKind=kind.toUpperCase();const cacheVar=`PM_COMPLETION_${envKind}_CACHE`;const cacheTsVar=`PM_COMPLETION_${envKind}_CACHE_TS`;const ttlVar=`PM_COMPLETION_${envKind}_TTL`;const escapedFallback=shellDoubleQuote(fallback);return[`_pm_completion_${kind}_choices() {`,"  local now ttl cache_ts resolved",'  now="$(date +%s 2>/dev/null || echo 0)"',`  ttl="\${${ttlVar}:-120}"`,`  cache_ts="\${${cacheTsVar}:-0}"`,`  if [[ -n "\${${cacheVar}:-}" && "$now" -ne 0 && $((now - cache_ts)) -lt "$ttl" ]]; then`,`    printf '%s\\n' "$${cacheVar}"`,"    return 0","  fi",`  resolved="$(pm ${command} 2>/dev/null)"`,'  if [[ -z "$resolved" ]]; then',`    resolved="${escapedFallback}"`,"  fi",`  ${cacheVar}="$resolved"`,`  ${cacheTsVar}="$now"`,`  printf '%s\\n' "$${cacheVar}"`,"}"]}function renderZshDynamicChoiceResolver(kind,command,fallback){const envKind=kind.toUpperCase();const cacheVar=`PM_COMPLETION_${envKind}_CACHE`;const cacheTsVar=`PM_COMPLETION_${envKind}_CACHE_TS`;const ttlVar=`PM_COMPLETION_${envKind}_TTL`;const escapedFallback=shellDoubleQuote(fallback);return`
 _pm_${kind}_choices() {
   local now ttl cache_ts resolved
   now=\${EPOCHSECONDS:-0}
@@ -427,12 +18,7 @@ _pm_${kind}_choices() {
   ${cacheTsVar}="$now"
   print -r -- "$${cacheVar}"
 }
-`;
-}
-function renderFishDynamicChoiceResolver(kind, command, fallback) {
-    const envKind = kind.toUpperCase();
-    const escapedFallback = fallback.replaceAll("'", "\\'");
-    return `
+`}function renderFishDynamicChoiceResolver(kind,command,fallback){const envKind=kind.toUpperCase();const escapedFallback=fallback.replaceAll("'","\\'");return`
 function __pm_${kind}_choices
   set -l now (date +%s ^/dev/null)
   if test -z "$now"
@@ -457,303 +43,7 @@ function __pm_${kind}_choices
   set -gx PM_COMPLETION_${envKind}_CACHE_TS $now
   printf '%s\\n' $resolved
 end
-`;
-}
-/** Implements generate bash script for the public runtime surface of this module. */
-export function generateBashScript(itemTypes = [], tags = [], eagerTagExpansion = false, runtime = {}) {
-    const cmds = ALL_COMMANDS.join(" ");
-    const useDynamicTypeExpansion = itemTypes.length === 0;
-    const typeValues = completionTypeValues(itemTypes, runtime);
-    const statusValues = completionStatusValues(runtime);
-    const tagValues = joinCompletionValues(tags);
-    const listFlags = mergeFlagStrings(LIST_FLAGS, runtime.command_flags?.list);
-    const createFlags = mergeFlagStrings(CREATE_FLAGS, runtime.command_flags?.create);
-    const updateFlags = mergeFlagStrings(UPDATE_FLAGS, runtime.command_flags?.update);
-    const updateManyFlags = mergeFlagStrings(UPDATE_MANY_FLAGS, runtime.command_flags?.["update-many"]);
-    const searchFlags = mergeFlagStrings(SEARCH_FLAGS, runtime.command_flags?.search);
-    const calendarFlags = mergeFlagStrings(CALENDAR_FLAGS, runtime.command_flags?.calendar);
-    const contextFlags = mergeFlagStrings(CONTEXT_FLAGS, runtime.command_flags?.context);
-    const useEagerTagExpansion = eagerTagExpansion || tags.length > 0;
-    // Note: "${...}" inside regular (non-template) strings are literal characters,
-    // not JS interpolation. Only backtick template literals interpolate ${...}.
-    const compgen = (flags) => `$(compgen -W "${flags}" -- "$cur")`;
-    return [
-        "# bash completion for pm",
-        "# Source this file or add 'eval \"$(pm completion bash)\"' to ~/.bashrc",
-        "",
-        ...(useDynamicTypeExpansion
-            ? [
-                ...renderBashDynamicChoiceResolver("type", "completion-types", typeValues),
-                "",
-            ]
-            : []),
-        ...renderBashDynamicChoiceResolver("status", "completion-statuses", statusValues),
-        "",
-        "_pm_completion() {",
-        "  local cur prev words cword",
-        "  _init_completion 2>/dev/null || {",
-        '    cur="${COMP_WORDS[COMP_CWORD]}"',
-        '    prev="${COMP_WORDS[COMP_CWORD-1]}"',
-        "    cword=$COMP_CWORD",
-        "  }",
-        "",
-        "  if [[ $cword -eq 1 ]]; then",
-        `    COMPREPLY=(${compgen(cmds)})`,
-        "    return 0",
-        "  fi",
-        "",
-        '  if [[ "$prev" == "--type" ]]; then',
-        useDynamicTypeExpansion
-            ? '    COMPREPLY=($(compgen -W "$(_pm_completion_type_choices)" -- "$cur"))'
-            : `    COMPREPLY=(${compgen(typeValues)})`,
-        "    return 0",
-        "  fi",
-        "",
-        '  if [[ "$prev" == "--status" ]]; then',
-        '    COMPREPLY=($(compgen -W "$(_pm_completion_status_choices)" -- "$cur"))',
-        "    return 0",
-        "  fi",
-        "",
-        ...(useEagerTagExpansion
-            ? [
-                '  if [[ ( "$prev" == "--tag" || "$prev" == "--tags" ) && ! ( ( "${COMP_WORDS[1]}" == "package" || "${COMP_WORDS[1]}" == "packages" ) && "${COMP_WORDS[2]}" == "upgrade" ) ]]; then',
-                `    COMPREPLY=(${compgen(tagValues)})`,
-                "    return 0",
-                "  fi",
-            ]
-            : [
-                '  if [[ ( "$prev" == "--tag" || "$prev" == "--tags" ) && ! ( ( "${COMP_WORDS[1]}" == "package" || "${COMP_WORDS[1]}" == "packages" ) && "${COMP_WORDS[2]}" == "upgrade" ) ]]; then',
-                "    local now ttl cache_ts tag_values",
-                '    now="$(date +%s 2>/dev/null || echo 0)"',
-                '    ttl="${PM_COMPLETION_TAG_TTL:-120}"',
-                '    cache_ts="${PM_COMPLETION_TAG_CACHE_TS:-0}"',
-                '    tag_values="${PM_COMPLETION_TAG_CACHE:-}"',
-                '    if [[ -z "$tag_values" || "$now" -eq 0 || $((now - cache_ts)) -ge "$ttl" ]]; then',
-                '      tag_values="$(pm completion-tags 2>/dev/null)"',
-                '      PM_COMPLETION_TAG_CACHE="$tag_values"',
-                '      PM_COMPLETION_TAG_CACHE_TS="$now"',
-                "    fi",
-                '    COMPREPLY=($(compgen -W "$tag_values" -- "$cur"))',
-                "    return 0",
-                "  fi",
-            ]),
-        "",
-        '  if [[ "$prev" == "--tag" && ( ( "${COMP_WORDS[1]}" == "package" || "${COMP_WORDS[1]}" == "packages" ) && "${COMP_WORDS[2]}" == "upgrade" ) ]]; then',
-        "    COMPREPLY=()",
-        "    return 0",
-        "  fi",
-        "",
-        '  local cmd="${COMP_WORDS[1]}"',
-        "",
-        '  case "$cmd" in',
-        "    list)",
-        `      COMPREPLY=(${compgen(listFlags)})`,
-        "      ;;",
-        "    aggregate)",
-        `      COMPREPLY=(${compgen(AGGREGATE_FLAGS)})`,
-        "      ;;",
-        "    duplicates)",
-        `      COMPREPLY=(${compgen(DUPLICATES_FLAGS)})`,
-        "      ;;",
-        "    create)",
-        `      COMPREPLY=(${compgen(createFlags)})`,
-        "      ;;",
-        "    copy)",
-        `      COMPREPLY=(${compgen(COPY_FLAGS)})`,
-        "      ;;",
-        "    focus)",
-        `      COMPREPLY=(${compgen(FOCUS_FLAGS)})`,
-        "      ;;",
-        "    update)",
-        `      COMPREPLY=(${compgen(updateFlags)})`,
-        "      ;;",
-        "    update-many)",
-        `      COMPREPLY=(${compgen(updateManyFlags)})`,
-        "      ;;",
-        "    calendar|cal)",
-        `      COMPREPLY=(${compgen(calendarFlags)})`,
-        "      ;;",
-        "    context|ctx)",
-        `      COMPREPLY=(${compgen(contextFlags)})`,
-        "      ;;",
-        "    next)",
-        `      COMPREPLY=(${compgen(NEXT_FLAGS)})`,
-        "      ;;",
-        "    guide)",
-        `      COMPREPLY=(${compgen(`${GUIDE_FLAGS} ${GUIDE_TOPIC_CHOICES}`)})`,
-        "      ;;",
-        "    search)",
-        `      COMPREPLY=(${compgen(searchFlags)})`,
-        "      ;;",
-        "    reindex)",
-        `      COMPREPLY=(${compgen("--mode --progress --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help")})`,
-        "      ;;",
-        "    init)",
-        `      COMPREPLY=(${compgen(`${INIT_FLAGS} --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help`)})`,
-        "      ;;",
-        "    config)",
-        `      COMPREPLY=(${compgen("--criterion --clear-criteria --format --policy --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help")})`,
-        "      ;;",
-        "    extension)",
-        `      COMPREPLY=(${compgen(`${EXTENSION_LIFECYCLE_ACTIONS} ${EXTENSION_LIFECYCLE_FLAGS}`)})`,
-        "      ;;",
-        "    package|packages)",
-        `      COMPREPLY=(${compgen(`${PACKAGE_LIFECYCLE_ACTIONS} ${PACKAGE_LIFECYCLE_FLAGS} ${UPGRADE_FLAGS}`)})`,
-        "      ;;",
-        "    comments)",
-        `      COMPREPLY=(${compgen("--add --body --stdin --file --edit --delete --limit --full-history --if-absent --author --message --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help")})`,
-        "      ;;",
-        "    notes)",
-        `      COMPREPLY=(${compgen("--add --add-json --stdin --file --edit --delete --limit --since --event-type --include-meta --full-history --if-absent --author --message --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help")})`,
-        "      ;;",
-        "    learnings)",
-        `      COMPREPLY=(${compgen("--add --stdin --file --edit --delete --limit --full-history --if-absent --author --message --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help")})`,
-        "      ;;",
-        "    files)",
-        `      COMPREPLY=(${compgen("discover lookup --add --add-glob --remove --migrate --list --apply --note --append-stable --validate-paths --scope --limit --offset --no-truncate --strict-read --explain --lines --decision-depth --author --message --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help")})`,
-        "      ;;",
-        "    docs)",
-        `      COMPREPLY=(${compgen("--add --add-glob --remove --migrate --note --validate-paths --author --message --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help")})`,
-        "      ;;",
-        "    append)",
-        `      COMPREPLY=(${compgen(APPEND_FLAGS)})`,
-        "      ;;",
-        "    deps)",
-        `      COMPREPLY=(${compgen(DEPS_FLAGS)})`,
-        "      ;;",
-        "    graph)",
-        `      COMPREPLY=(${compgen(`ancestors descendants predecessors successors paths impact analyze audit communities redundancy dominators slack centrality articulation plan index ${GRAPH_FLAGS}`)})`,
-        "      ;;",
-        "    test)",
-        `      COMPREPLY=(${compgen("--add --add-json --remove --remove-index --list --run --match --only-index --only-last --background --timeout --progress --env-set --env-clear --shared-host-safe --pm-context --override-linked-pm-context --fail-on-context-mismatch --fail-on-skipped --fail-on-empty-test-run --require-assertions-for-pm --check-context --auto-pm-context --author --message --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help")})`,
-        "      ;;",
-        "    test-all)",
-        `      COMPREPLY=(${compgen("--status --limit --offset --background --timeout --progress --env-set --env-clear --shared-host-safe --pm-context --override-linked-pm-context --fail-on-context-mismatch --fail-on-skipped --fail-on-empty-test-run --require-assertions-for-pm --check-context --auto-pm-context --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help")})`,
-        "      ;;",
-        "    test-runs)",
-        `      COMPREPLY=(${compgen("list status logs stop resume --status --limit --stream --tail --force --author --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help")})`,
-        "      ;;",
-        "    validate)",
-        `      COMPREPLY=(${compgen("--check-metadata --metadata-profile --check-resolution --check-lifecycle --check-stale-blockers --dependency-cycle-severity --parent-cycle-severity --check-files --scan-mode --include-pm-internals --verbose-file-lists --verbose-diagnostics --all-affected-ids --strict-exit --fail-on-warn --fix-hints --auto-fix --dry-run --fix-scope --prune-missing --check-history-drift --check-command-references --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help")})`,
-        "      ;;",
-        "    health)",
-        `      COMPREPLY=(${compgen(HEALTH_FLAGS)})`,
-        "      ;;",
-        "    history)",
-        `      COMPREPLY=(${compgen(HISTORY_FLAGS)})`,
-        "      ;;",
-        "    events)",
-        `      COMPREPLY=(${compgen(EVENTS_FLAGS)})`,
-        "      ;;",
-        "    history-compact)",
-        `      COMPREPLY=(${compgen("--before --ids --all-over --closed --all-streams --min-entries --dry-run --author --message --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help")})`,
-        "      ;;",
-        "    history-author-acknowledge)",
-        `      COMPREPLY=(${compgen(`${HISTORY_AUTHOR_ACKNOWLEDGE_FLAGS} --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help`)})`,
-        "      ;;",
-        "    get)",
-        `      COMPREPLY=(${compgen(GET_FLAGS)})`,
-        "      ;;",
-        "    history-redact)",
-        `      COMPREPLY=(${compgen("--literal --regex --replacement --dry-run --author --message --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help")})`,
-        "      ;;",
-        "    history-repair)",
-        `      COMPREPLY=(${compgen("--all --dry-run --author --message --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help")})`,
-        "      ;;",
-        "    schema)",
-        `      COMPREPLY=(${compgen("list show show-status add-type remove-type add-status remove-status add-field remove-field list-fields show-field apply-preset rename-type rename-field remap-status --description --default-status --folder --alias --role --order --type --commands --cli-flag --required --required-on-create --no-allow-unset --required-types --infer --min-count --apply --to --migration-id --dry-run --author --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help")})`,
-        "      ;;",
-        "    profile)",
-        `      COMPREPLY=(${compgen("list show apply lint agile ops research --dry-run --author --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help")})`,
-        "      ;;",
-        "    plan)",
-        `      COMPREPLY=(${compgen(`${PLAN_SUBCOMMANDS_LIST} ${PLAN_FLAGS}`)})`,
-        "      ;;",
-        "    activity)",
-        `      COMPREPLY=(${compgen(ACTIVITY_FLAGS)})`,
-        "      ;;",
-        "    contracts)",
-        `      COMPREPLY=(${compgen(CONTRACTS_FLAGS)})`,
-        "      ;;",
-        "    gc)",
-        `      COMPREPLY=(${compgen("--dry-run --scope --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help")})`,
-        "      ;;",
-        "    stats)",
-        `      COMPREPLY=(${compgen(STATS_FLAGS)})`,
-        "      ;;",
-        "    close|close-task)",
-        `      COMPREPLY=(${compgen(CLOSE_MUTATION_FLAGS)})`,
-        "      ;;",
-        "    close-many)",
-        `      COMPREPLY=(${compgen(CLOSE_MANY_FLAGS)})`,
-        "      ;;",
-        "    release)",
-        `      COMPREPLY=(${compgen(RELEASE_MUTATION_FLAGS)})`,
-        "      ;;",
-        "    delete)",
-        `      COMPREPLY=(${compgen(DELETE_MUTATION_FLAGS)})`,
-        "      ;;",
-        "    claim|restore|start-task|pause-task)",
-        `      COMPREPLY=(${compgen(MUTATION_FLAGS)})`,
-        "      ;;",
-        "    meet|event)",
-        `      COMPREPLY=(${compgen(MEET_FLAGS)})`,
-        "      ;;",
-        "    remind)",
-        `      COMPREPLY=(${compgen(REMIND_FLAGS)})`,
-        "      ;;",
-        "    completion)",
-        `      COMPREPLY=(${compgen(COMPLETION_SHELL_CHOICES)})`,
-        "      ;;",
-        "    templates)",
-        `      COMPREPLY=(${compgen("save list show")})`,
-        "      ;;",
-        "    *)",
-        `      COMPREPLY=(${compgen(GLOBAL_FLAGS)})`,
-        "      ;;",
-        "  esac",
-        '  if [[ "$cmd" == "comments" || "$cmd" == "notes" || "$cmd" == "learnings" ]]; then',
-        `    COMPREPLY+=(${compgen("--text")})`,
-        "  fi",
-        "  return 0",
-        "}",
-        "",
-        "complete -F _pm_completion pm",
-    ].join("\n");
-}
-/** Implements generate zsh script for the public runtime surface of this module. */
-export function generateZshScript(itemTypes = [], tags = [], eagerTagExpansion = false, runtime = {}) {
-    const useDynamicTypeExpansion = itemTypes.length === 0;
-    const typeFallbackChoices = completionTypeValues(itemTypes, runtime);
-    const statusFallbackChoices = completionStatusValues(runtime);
-    const typeChoices = useDynamicTypeExpansion
-        ? '${(f)"$(_pm_type_choices)"}'
-        : typeFallbackChoices;
-    const statusChoices = '${(f)"$(_pm_status_choices)"}';
-    const guideTopicChoices = GUIDE_TOPIC_CHOICES;
-    const tagChoices = joinCompletionValues(tags);
-    const useEagerTagExpansion = eagerTagExpansion || tags.length > 0;
-    const zshTagChoices = useEagerTagExpansion
-        ? tagChoices
-        : '${(f)"$(_pm_tag_choices)"}';
-    const zshListRuntimeFieldFlags = renderZshRuntimeFieldFlagSpecs(runtime.command_flags?.list);
-    const zshCreateRuntimeFieldFlags = renderZshRuntimeFieldFlagSpecs(runtime.command_flags?.create);
-    const zshSearchRuntimeFieldFlags = renderZshRuntimeFieldFlagSpecs(runtime.command_flags?.search);
-    const zshCalendarRuntimeFieldFlags = renderZshRuntimeFieldFlagSpecs(runtime.command_flags?.calendar);
-    const zshContextRuntimeFieldFlags = renderZshRuntimeFieldFlagSpecs(runtime.command_flags?.context);
-    const zshPresenceFilterFlags = renderZshPresenceFilterSpecs({
-        missingPrefix: "filter-",
-        pairedPrefix: "",
-        includeContentMissingAliases: true,
-    });
-    const zshBulkPresenceFilterFlags = renderZshPresenceFilterSpecs({
-        missingPrefix: "filter-",
-        pairedPrefix: "filter-",
-    });
-    const zshMutationCollectionFlags = renderZshArgumentSpecs(ZSH_MUTATION_COLLECTION_ARGUMENT_SPECS);
-    const dynamicTagResolver = useEagerTagExpansion
-        ? ""
-        : `
+`}function generateBashScript(itemTypes=[],tags=[],eagerTagExpansion=false,runtime={}){const cmds=ALL_COMMANDS.join(" ");const useDynamicTypeExpansion=itemTypes.length===0;const typeValues=completionTypeValues(itemTypes,runtime);const statusValues=completionStatusValues(runtime);const tagValues=joinCompletionValues(tags);const listFlags=mergeFlagStrings(LIST_FLAGS,runtime.command_flags?.list);const createFlags=mergeFlagStrings(CREATE_FLAGS,runtime.command_flags?.create);const updateFlags=mergeFlagStrings(UPDATE_FLAGS,runtime.command_flags?.update);const updateManyFlags=mergeFlagStrings(UPDATE_MANY_FLAGS,runtime.command_flags?.["update-many"]);const searchFlags=mergeFlagStrings(SEARCH_FLAGS,runtime.command_flags?.search);const calendarFlags=mergeFlagStrings(CALENDAR_FLAGS,runtime.command_flags?.calendar);const contextFlags=mergeFlagStrings(CONTEXT_FLAGS,runtime.command_flags?.context);const useEagerTagExpansion=eagerTagExpansion||tags.length>0;const compgen=flags=>`$(compgen -W "${flags}" -- "$cur")`;return["# bash completion for pm",`# Source this file or add 'eval "$(pm completion bash)"' to ~/.bashrc`,"",...useDynamicTypeExpansion?[...renderBashDynamicChoiceResolver("type","completion-types",typeValues),""]:[],...renderBashDynamicChoiceResolver("status","completion-statuses",statusValues),"","_pm_completion() {","  local cur prev words cword","  _init_completion 2>/dev/null || {",'    cur="${COMP_WORDS[COMP_CWORD]}"','    prev="${COMP_WORDS[COMP_CWORD-1]}"',"    cword=$COMP_CWORD","  }","","  if [[ $cword -eq 1 ]]; then",`    COMPREPLY=(${compgen(cmds)})`,"    return 0","  fi","",'  if [[ "$prev" == "--type" ]]; then',useDynamicTypeExpansion?'    COMPREPLY=($(compgen -W "$(_pm_completion_type_choices)" -- "$cur"))':`    COMPREPLY=(${compgen(typeValues)})`,"    return 0","  fi","",'  if [[ "$prev" == "--status" ]]; then','    COMPREPLY=($(compgen -W "$(_pm_completion_status_choices)" -- "$cur"))',"    return 0","  fi","",...useEagerTagExpansion?['  if [[ ( "$prev" == "--tag" || "$prev" == "--tags" ) && ! ( ( "${COMP_WORDS[1]}" == "package" || "${COMP_WORDS[1]}" == "packages" ) && "${COMP_WORDS[2]}" == "upgrade" ) ]]; then',`    COMPREPLY=(${compgen(tagValues)})`,"    return 0","  fi"]:['  if [[ ( "$prev" == "--tag" || "$prev" == "--tags" ) && ! ( ( "${COMP_WORDS[1]}" == "package" || "${COMP_WORDS[1]}" == "packages" ) && "${COMP_WORDS[2]}" == "upgrade" ) ]]; then',"    local now ttl cache_ts tag_values",'    now="$(date +%s 2>/dev/null || echo 0)"','    ttl="${PM_COMPLETION_TAG_TTL:-120}"','    cache_ts="${PM_COMPLETION_TAG_CACHE_TS:-0}"','    tag_values="${PM_COMPLETION_TAG_CACHE:-}"','    if [[ -z "$tag_values" || "$now" -eq 0 || $((now - cache_ts)) -ge "$ttl" ]]; then','      tag_values="$(pm completion-tags 2>/dev/null)"','      PM_COMPLETION_TAG_CACHE="$tag_values"','      PM_COMPLETION_TAG_CACHE_TS="$now"',"    fi",'    COMPREPLY=($(compgen -W "$tag_values" -- "$cur"))',"    return 0","  fi"],"",'  if [[ "$prev" == "--tag" && ( ( "${COMP_WORDS[1]}" == "package" || "${COMP_WORDS[1]}" == "packages" ) && "${COMP_WORDS[2]}" == "upgrade" ) ]]; then',"    COMPREPLY=()","    return 0","  fi","",'  local cmd="" word_index=1 word',"  while (( word_index < cword )); do",'    word="${COMP_WORDS[word_index]}"','    case "${word//_/-}" in',`      ${GLOBAL_COMPLETION_VALUE_PATTERNS}) (( word_index += 2 )); continue ;;`,`      ${GLOBAL_COMPLETION_INLINE_PATTERNS}|${GLOBAL_COMPLETION_SWITCH_PATTERNS}) (( word_index++ )); continue ;;`,"      --) break ;;","    esac",'    if [[ -z "$cmd" ]]; then','      cmd="$word"','      [[ "$cmd" == "history" ]] || break',"    else",'      case "$word" in',...PM_HISTORY_COMMAND_ALIASES.map(entry=>`        ${entry.canonical_argv[1]}) cmd="${entry.alias}" ;;`),"      esac","      break","    fi","    (( word_index++ ))","  done",'  case "$cmd" in',...HISTORY_OPERATION_FLAGS.flatMap(entry=>[`    ${entry.alias})`,`      COMPREPLY=(${compgen(entry.flags)})`,"      return 0","      ;;"]),"    list)",`      COMPREPLY=(${compgen(listFlags)})`,"      ;;","    aggregate)",`      COMPREPLY=(${compgen(AGGREGATE_FLAGS)})`,"      ;;","    duplicates)",`      COMPREPLY=(${compgen(DUPLICATES_FLAGS)})`,"      ;;","    create)",`      COMPREPLY=(${compgen(createFlags)})`,"      ;;","    copy)",`      COMPREPLY=(${compgen(COPY_FLAGS)})`,"      ;;","    focus)",`      COMPREPLY=(${compgen(FOCUS_FLAGS)})`,"      ;;","    update)",`      COMPREPLY=(${compgen(updateFlags)})`,"      ;;","    update-many)",`      COMPREPLY=(${compgen(updateManyFlags)})`,"      ;;","    calendar|cal)",`      COMPREPLY=(${compgen(calendarFlags)})`,"      ;;","    context|ctx)",`      COMPREPLY=(${compgen(contextFlags)})`,"      ;;","    next)",`      COMPREPLY=(${compgen(NEXT_FLAGS)})`,"      ;;","    guide)",`      COMPREPLY=(${compgen(`${GUIDE_FLAGS} ${GUIDE_TOPIC_CHOICES}`)})`,"      ;;","    search)",`      COMPREPLY=(${compgen(searchFlags)})`,"      ;;","    reindex)",`      COMPREPLY=(${compgen("--mode --progress --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help")})`,"      ;;","    init)",`      COMPREPLY=(${compgen(`${INIT_FLAGS} --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help`)})`,"      ;;","    config)",`      COMPREPLY=(${compgen("--criterion --clear-criteria --format --policy --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help")})`,"      ;;","    extension)",`      COMPREPLY=(${compgen(`${EXTENSION_LIFECYCLE_ACTIONS} ${EXTENSION_LIFECYCLE_FLAGS}`)})`,"      ;;","    package|packages)",`      COMPREPLY=(${compgen(`${PACKAGE_LIFECYCLE_ACTIONS} ${PACKAGE_LIFECYCLE_FLAGS} ${UPGRADE_FLAGS}`)})`,"      ;;","    comments)",`      COMPREPLY=(${compgen("--add --body --stdin --file --edit --delete --limit --full-history --if-absent --author --message --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help")})`,"      ;;","    notes)",`      COMPREPLY=(${compgen("--add --add-json --stdin --file --edit --delete --limit --since --event-type --include-meta --full-history --if-absent --author --message --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help")})`,"      ;;","    learnings)",`      COMPREPLY=(${compgen("--add --stdin --file --edit --delete --limit --full-history --if-absent --author --message --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help")})`,"      ;;","    files)",`      COMPREPLY=(${compgen("discover lookup --add --add-glob --remove --migrate --list --apply --note --append-stable --validate-paths --scope --limit --offset --no-truncate --strict-read --explain --lines --decision-depth --author --message --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help")})`,"      ;;","    docs)",`      COMPREPLY=(${compgen("--add --add-glob --remove --migrate --note --validate-paths --author --message --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help")})`,"      ;;","    append)",`      COMPREPLY=(${compgen(APPEND_FLAGS)})`,"      ;;","    deps)",`      COMPREPLY=(${compgen(DEPS_FLAGS)})`,"      ;;","    graph)",`      COMPREPLY=(${compgen(`ancestors descendants predecessors successors paths impact analyze audit communities redundancy dominators slack centrality articulation plan index ${GRAPH_FLAGS}`)})`,"      ;;","    test)",`      COMPREPLY=(${compgen("--add --add-json --remove --remove-index --list --run --match --only-index --only-last --background --timeout --progress --env-set --env-clear --shared-host-safe --pm-context --override-linked-pm-context --fail-on-context-mismatch --fail-on-skipped --fail-on-empty-test-run --require-assertions-for-pm --check-context --auto-pm-context --author --message --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help")})`,"      ;;","    test-all)",`      COMPREPLY=(${compgen("--status --limit --offset --background --timeout --progress --env-set --env-clear --shared-host-safe --pm-context --override-linked-pm-context --fail-on-context-mismatch --fail-on-skipped --fail-on-empty-test-run --require-assertions-for-pm --check-context --auto-pm-context --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help")})`,"      ;;","    test-runs)",`      COMPREPLY=(${compgen("list status logs stop resume --status --limit --stream --tail --force --author --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help")})`,"      ;;","    validate)",`      COMPREPLY=(${compgen("--check-completeness --check-metadata --metadata-profile --check-resolution --check-lifecycle --check-stale-blockers --dependency-cycle-severity --parent-cycle-severity --check-files --scan-mode --include-pm-internals --verbose-file-lists --verbose-diagnostics --all-affected-ids --strict-exit --fail-on-warn --fix-hints --auto-fix --dry-run --fix-scope --prune-missing --check-history-drift --check-command-references --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help")})`,"      ;;","    health)",`      COMPREPLY=(${compgen(HEALTH_FLAGS)})`,"      ;;","    history)","      if [[ $word_index -eq $cword ]]; then",`        COMPREPLY=(${compgen(`${HISTORY_FLAGS} ${HISTORY_LEAVES}`)})`,"      else",`        COMPREPLY=(${compgen(HISTORY_FLAGS)})`,"      fi","      ;;","    events)",`      COMPREPLY=(${compgen(EVENTS_FLAGS)})`,"      ;;","    history-author-acknowledge)",`      COMPREPLY=(${compgen(`${HISTORY_AUTHOR_ACKNOWLEDGE_FLAGS} --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help`)})`,"      ;;","    get)",`      COMPREPLY=(${compgen(GET_FLAGS)})`,"      ;;","    schema)",'      if [[ "$prev" == "policy-mode" ]]; then',`        COMPREPLY=(${compgen("advise refuse")})`,"        return","      fi",`      COMPREPLY=(${compgen(`${SCHEMA_SUBCOMMAND_CHOICES} --definition --policy --message --description --default-status --folder --alias --role --order --type --commands --cli-flag --required --required-on-create --no-allow-unset --required-types --infer --min-count --apply --to --migration-id --dry-run --author --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help`)})`,"      ;;","    profile)",`      COMPREPLY=(${compgen("list show apply lint agile ops research --dry-run --author --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help")})`,"      ;;","    plan)",`      COMPREPLY=(${compgen(`${PLAN_SUBCOMMANDS_LIST} ${PLAN_FLAGS}`)})`,"      ;;","    contracts)",`      COMPREPLY=(${compgen(CONTRACTS_FLAGS)})`,"      ;;","    gc)",`      COMPREPLY=(${compgen("--dry-run --scope --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help")})`,"      ;;","    stats)",`      COMPREPLY=(${compgen(STATS_FLAGS)})`,"      ;;","    close|close-task)",`      COMPREPLY=(${compgen(CLOSE_MUTATION_FLAGS)})`,"      ;;","    close-many)",`      COMPREPLY=(${compgen(CLOSE_MANY_FLAGS)})`,"      ;;","    release)",`      COMPREPLY=(${compgen(RELEASE_MUTATION_FLAGS)})`,"      ;;","    delete)",`      COMPREPLY=(${compgen(DELETE_MUTATION_FLAGS)})`,"      ;;","    claim|start-task|pause-task)",`      COMPREPLY=(${compgen(MUTATION_FLAGS)})`,"      ;;","    meet|event)",`      COMPREPLY=(${compgen(MEET_FLAGS)})`,"      ;;","    remind)",`      COMPREPLY=(${compgen(REMIND_FLAGS)})`,"      ;;","    completion)",`      COMPREPLY=(${compgen(COMPLETION_SHELL_CHOICES)})`,"      ;;","    templates)",`      COMPREPLY=(${compgen("save list show")})`,"      ;;","    *)",`      COMPREPLY=(${compgen(GLOBAL_FLAGS)})`,"      ;;","  esac",'  if [[ "$cmd" == "comments" || "$cmd" == "notes" || "$cmd" == "learnings" ]]; then',`    COMPREPLY+=(${compgen("--text")})`,"  fi","  return 0","}","","complete -F _pm_completion pm"].join("\n")}function generateZshScript(itemTypes=[],tags=[],eagerTagExpansion=false,runtime={}){const useDynamicTypeExpansion=itemTypes.length===0;const typeFallbackChoices=completionTypeValues(itemTypes,runtime);const statusFallbackChoices=completionStatusValues(runtime);const typeChoices=useDynamicTypeExpansion?'${(f)"$(_pm_type_choices)"}':typeFallbackChoices;const statusChoices='${(f)"$(_pm_status_choices)"}';const guideTopicChoices=GUIDE_TOPIC_CHOICES;const tagChoices=joinCompletionValues(tags);const useEagerTagExpansion=eagerTagExpansion||tags.length>0;const zshTagChoices=useEagerTagExpansion?tagChoices:'${(f)"$(_pm_tag_choices)"}';const zshListRuntimeFieldFlags=renderZshRuntimeFieldFlagSpecs(runtime.command_flags?.list);const zshCreateRuntimeFieldFlags=renderZshRuntimeFieldFlagSpecs(runtime.command_flags?.create);const zshSearchRuntimeFieldFlags=renderZshRuntimeFieldFlagSpecs(runtime.command_flags?.search);const zshCalendarRuntimeFieldFlags=renderZshRuntimeFieldFlagSpecs(runtime.command_flags?.calendar);const zshContextRuntimeFieldFlags=renderZshRuntimeFieldFlagSpecs(runtime.command_flags?.context);const zshPresenceFilterFlags=renderZshPresenceFilterSpecs({missingPrefix:"filter-",pairedPrefix:"",includeContentMissingAliases:true});const zshBulkPresenceFilterFlags=renderZshPresenceFilterSpecs({missingPrefix:"filter-",pairedPrefix:"filter-"});const zshMutationCollectionFlags=renderZshArgumentSpecs(ZSH_MUTATION_COLLECTION_ARGUMENT_SPECS);const dynamicTagResolver=useEagerTagExpansion?"":`
 _pm_tag_choices() {
   local now ttl cache_ts
   now=\${EPOCHSECONDS:-0}
@@ -767,8 +57,7 @@ _pm_tag_choices() {
   PM_COMPLETION_TAG_CACHE_TS="$now"
   print -r -- "$PM_COMPLETION_TAG_CACHE"
 }
-`;
-    return `#compdef pm
+`;return`#compdef pm
 # zsh completion for pm
 # Source this file or add 'eval "$(pm completion zsh)"' to ~/.zshrc
 
@@ -780,11 +69,41 @@ ${renderZshCommandDescriptions()}
   _describe 'command' commands
 }
 ${dynamicTagResolver}
-${useDynamicTypeExpansion ? renderZshDynamicChoiceResolver("type", "completion-types", typeFallbackChoices) : ""}
-${renderZshDynamicChoiceResolver("status", "completion-statuses", statusFallbackChoices)}
+${useDynamicTypeExpansion?renderZshDynamicChoiceResolver("type","completion-types",typeFallbackChoices):""}
+${renderZshDynamicChoiceResolver("status","completion-statuses",statusFallbackChoices)}
 
 _pm() {
   local context state line
+  local -a words=("$words[@]")
+  local CURRENT=$CURRENT
+  local word_index=2 history_seen=0 operation_index=0 word
+  while (( word_index < CURRENT )); do
+    word="$words[word_index]"
+    case "\${word//_/-}" in
+      ${GLOBAL_COMPLETION_VALUE_PATTERNS}) (( word_index += 2 )); continue ;;
+      ${GLOBAL_COMPLETION_INLINE_PATTERNS}|${GLOBAL_COMPLETION_SWITCH_PATTERNS}) (( word_index++ )); continue ;;
+      --) break ;;
+    esac
+    if (( history_seen == 0 )); then
+      [[ "$word" == "history" ]] || break
+      history_seen=1
+    else
+      operation_index=$word_index
+      break
+    fi
+    (( word_index++ ))
+  done
+  if (( history_seen && word_index == CURRENT )) && [[ "$words[CURRENT]" != -* ]]; then
+    local -a history_commands
+    history_commands=(${HISTORY_LEAVES})
+    _describe 'history operation' history_commands
+    return
+  fi
+  if (( operation_index > 0 )); then
+    case "$words[operation_index]" in
+${PM_HISTORY_COMMAND_ALIASES.map(entry=>`      ${entry.canonical_argv[1]}) words=("$words[1]" "${entry.alias}" "\${words[@]:$operation_index}"); (( CURRENT -= operation_index - 2 )) ;;`).join("\n")}
+    esac
+  fi
   _arguments -C \\
     '--json[Output JSON instead of TOON]' \\
     '--all[Reveal every public command and compatibility alias]' \\
@@ -962,7 +281,7 @@ ${zshMutationCollectionFlags}
           ;;
         update-many)
           _arguments \\
-${renderZshBulkSelectionFilterSpecs("applying updates", statusChoices, typeChoices, zshTagChoices)}
+${renderZshBulkSelectionFilterSpecs("applying updates",statusChoices,typeChoices,zshTagChoices)}
             '--filter-ac-missing[Select only items missing acceptance_criteria]' \\
             '--filter-estimates-missing[Select only items missing estimated_minutes]' \\
             '--filter-resolution-missing[Select only terminal items missing resolution]' \\
@@ -1027,7 +346,7 @@ ${zshMutationCollectionFlags}
           ;;
         close-many)
           _arguments \\
-${renderZshBulkSelectionFilterSpecs("closing", statusChoices, typeChoices, zshTagChoices)}
+${renderZshBulkSelectionFilterSpecs("closing",statusChoices,typeChoices,zshTagChoices)}
 ${zshBulkPresenceFilterFlags}
             '--ids[Explicit comma-separated ID allowlist]:ids' \\
             '--limit[Limit matched item count]:number' \\
@@ -1188,6 +507,7 @@ ${zshSearchRuntimeFieldFlags}            '--json[Output JSON]' \\
           ;;
         history-compact)
           _arguments \\
+            '--id[Item ID (alternative to positional ID)]:id' \\
             '--before[Compact entries strictly before this version number or ISO timestamp]:before' \\
             '--ids[Bulk: compact an explicit comma-separated list of item ids]:ids' \\
             '--all-over[Bulk: compact every stream with more than N entries]:all-over' \\
@@ -1226,6 +546,7 @@ ${zshSearchRuntimeFieldFlags}            '--json[Output JSON]' \\
           ;;
         history-redact)
           _arguments \\
+            '--id[Item ID (alternative to positional ID)]:id' \\
             '--literal[Literal string matcher to redact from history/item payloads]:literal' \\
             '--regex[Regex matcher to redact (/pattern/flags or raw pattern)]:regex' \\
             '--replacement[Replacement text (defaults to [redacted])]:replacement' \\
@@ -1238,6 +559,9 @@ ${zshSearchRuntimeFieldFlags}            '--json[Output JSON]' \\
           ;;
         history-repair)
           _arguments \\
+            '--id[Item ID (alternative to positional ID)]:id' \\
+            '--salvage-tail[Recover an invalid suffix after a verified prefix]' \\
+            '--normalize-provenance[Remove invalid provenance with aggregate evidence]' \\
             '--all[Repair every drifted stream in one audited pass]' \\
             '--dry-run[Preview the re-anchor impact without writing the history file]' \\
             '--author[Mutation author]:author' \\
@@ -1247,8 +571,16 @@ ${zshSearchRuntimeFieldFlags}            '--json[Output JSON]' \\
             '--quiet[Suppress stdout]'
           ;;
         schema)
+          if [[ "\${words[CURRENT-1]}" == policy-mode ]]; then
+            compadd advise refuse
+            return
+          fi
           _arguments \\
-            '1:subcommand:(list show show-status add-type remove-type add-status remove-status add-field remove-field list-fields show-field apply-preset rename-type rename-field remap-status)' \\
+            '1:subcommand:(${SCHEMA_SUBCOMMAND_CHOICES})' \\
+            '--definition[Policy definition or proposed fields JSON]:json' \\
+            '--policy[Approval policy id]:id' \\
+            '--message[History rationale]:text' \\
+            '--dry-run[Preview schema changes]' \\
             '--description[Human description for the custom item type, status, or field]:text' \\
             '--default-status[Default status hint for the custom item type]:status' \\
             '--folder[Storage folder for items of this custom type]:dir' \\
@@ -1314,6 +646,7 @@ ${zshSearchRuntimeFieldFlags}            '--json[Output JSON]' \\
             '--from[Lower timestamp bound (ISO/date string or relative)]:date' \\
             '--to[Upper timestamp bound (ISO/date string or relative)]:date' \\
             '--limit[Max entries]:number' \\
+            '--unbounded[Return every matching activity entry]' \\
             '--compact[Condensed activity projection]' \\
             '--raw[Emit raw compact per-event activity output]' \\
             '--full[Show full activity entries]' \\
@@ -1322,7 +655,7 @@ ${zshSearchRuntimeFieldFlags}            '--json[Output JSON]' \\
             '*--harness[Filter by recorded or vocabulary-resolved harness]:harness' \\
             '*--agent-instance[Filter by privacy-safe agent instance]:instance' \\
             '*--provenance-filter[Filter by exact declared provenance value]:dimension=value' \\
-            '--stream[Emit line-delimited JSON rows (requires --json)]:mode' \\
+            '--stream[Emit line-delimited JSON rows (requires --json)]::mode:(rows ndjson jsonl)' \\
             '--json[Output JSON]' \\
             '--quiet[Suppress stdout]'
           ;;
@@ -1620,6 +953,10 @@ ${zshSearchRuntimeFieldFlags}            '--json[Output JSON]' \\
             '--json[Output JSON]' \\
             '--quiet[Suppress stdout]'
           ;;
+        restore)
+          _arguments \\
+${renderZshArgumentSpecs(RESTORE_INVOCATIONS.map(flag=>`'${flag.flag}[${flag.description}]${flag.takes_value?":value":""}'`),{trailingContinuation:false})}
+          ;;
         start-task|pause-task)
           _arguments \\
             '--author[Mutation author]:author' \\
@@ -1639,6 +976,7 @@ ${zshSearchRuntimeFieldFlags}            '--json[Output JSON]' \\
           ;;
         validate)
           _arguments \\
+            '--check-completeness[Check declarative required fields]' \\
             '--check-metadata[Run metadata completeness checks]' \\
             '--metadata-profile[Select metadata validation profile for --check-metadata]:(core strict custom)' \\
             '--check-resolution[Run closed-item resolution metadata checks]' \\
@@ -1779,36 +1117,7 @@ ${zshSearchRuntimeFieldFlags}            '--json[Output JSON]' \\
   esac
 }
 
-compdef _pm pm`;
-}
-/** Implements generate fish script for the public runtime surface of this module. */
-export function generateFishScript(itemTypes = [], tags = [], eagerTagExpansion = false, runtime = {}) {
-    const listCommandNames = ALL_COMMANDS.filter((command) => command === "list" || command.startsWith("list-"));
-    const listCmds = listCommandNames.join(" ");
-    const noSubcommandList = ALL_COMMANDS.join(" ");
-    const useDynamicTypeExpansion = itemTypes.length === 0;
-    const typeFallbackChoices = completionTypeValues(itemTypes, runtime);
-    const statusFallbackChoices = completionStatusValues(runtime);
-    const typeChoices = useDynamicTypeExpansion
-        ? "(__pm_type_choices)"
-        : typeFallbackChoices;
-    const statusChoices = "(__pm_status_choices)";
-    const guideTopicChoices = GUIDE_TOPIC_CHOICES;
-    const tagChoices = joinCompletionValues(tags);
-    const useEagerTagExpansion = eagerTagExpansion || tags.length > 0;
-    const fishTagChoices = useEagerTagExpansion
-        ? `'${tagChoices}'`
-        : "'(__pm_tag_choices)'";
-    const fishListRuntimeFieldFlags = renderFishRuntimeFieldFlagSpecs(listCommandNames, runtime.command_flags?.list);
-    const fishCreateRuntimeFieldFlags = renderFishRuntimeFieldFlagSpecs(["create"], runtime.command_flags?.create);
-    const fishUpdateRuntimeFieldFlags = renderFishRuntimeFieldFlagSpecs(["update"], runtime.command_flags?.update);
-    const fishUpdateManyRuntimeFieldFlags = renderFishRuntimeFieldFlagSpecs(["update-many"], runtime.command_flags?.["update-many"]);
-    const fishSearchRuntimeFieldFlags = renderFishRuntimeFieldFlagSpecs(["search"], runtime.command_flags?.search);
-    const fishCalendarRuntimeFieldFlags = renderFishRuntimeFieldFlagSpecs(["calendar", "cal"], runtime.command_flags?.calendar);
-    const fishContextRuntimeFieldFlags = renderFishRuntimeFieldFlagSpecs(["context", "ctx"], runtime.command_flags?.context);
-    const dynamicTagResolver = useEagerTagExpansion
-        ? ""
-        : `
+compdef _pm pm`}function generateFishScript(itemTypes=[],tags=[],eagerTagExpansion=false,runtime={}){const listCommandNames=ALL_COMMANDS.filter(command=>command==="list"||command.startsWith("list-"));const listCmds=listCommandNames.join(" ");const noSubcommandList=ALL_COMMANDS.join(" ");const useDynamicTypeExpansion=itemTypes.length===0;const typeFallbackChoices=completionTypeValues(itemTypes,runtime);const statusFallbackChoices=completionStatusValues(runtime);const typeChoices=useDynamicTypeExpansion?"(__pm_type_choices)":typeFallbackChoices;const statusChoices="(__pm_status_choices)";const guideTopicChoices=GUIDE_TOPIC_CHOICES;const tagChoices=joinCompletionValues(tags);const useEagerTagExpansion=eagerTagExpansion||tags.length>0;const fishTagChoices=useEagerTagExpansion?`'${tagChoices}'`:"'(__pm_tag_choices)'";const fishListRuntimeFieldFlags=renderFishRuntimeFieldFlagSpecs(listCommandNames,runtime.command_flags?.list);const fishCreateRuntimeFieldFlags=renderFishRuntimeFieldFlagSpecs(["create"],runtime.command_flags?.create);const fishUpdateRuntimeFieldFlags=renderFishRuntimeFieldFlagSpecs(["update"],runtime.command_flags?.update);const fishUpdateManyRuntimeFieldFlags=renderFishRuntimeFieldFlagSpecs(["update-many"],runtime.command_flags?.["update-many"]);const fishSearchRuntimeFieldFlags=renderFishRuntimeFieldFlagSpecs(["search"],runtime.command_flags?.search);const fishCalendarRuntimeFieldFlags=renderFishRuntimeFieldFlagSpecs(["calendar","cal"],runtime.command_flags?.calendar);const fishContextRuntimeFieldFlags=renderFishRuntimeFieldFlagSpecs(["context","ctx"],runtime.command_flags?.context);const dynamicTagResolver=useEagerTagExpansion?"":`
 function __pm_tag_choices
   set -l now (date +%s ^/dev/null)
   if test -z "$now"
@@ -1821,17 +1130,18 @@ function __pm_tag_choices
   if set -q PM_COMPLETION_TAG_CACHE; and set -q PM_COMPLETION_TAG_CACHE_TS
     set -l age (math "$now - $PM_COMPLETION_TAG_CACHE_TS")
     if test $age -lt $ttl
-      printf '%s\n' $PM_COMPLETION_TAG_CACHE
+      printf '%s
+' $PM_COMPLETION_TAG_CACHE
       return
     end
   end
   set -l resolved (pm completion-tags ^/dev/null)
   set -gx PM_COMPLETION_TAG_CACHE $resolved
   set -gx PM_COMPLETION_TAG_CACHE_TS $now
-  printf '%s\n' $resolved
+  printf '%s
+' $resolved
 end
-`;
-    return `# Fish shell completion for pm
+`;return`# Fish shell completion for pm
 # Save to ~/.config/fish/completions/pm.fish
 # or run: pm completion fish > ~/.config/fish/completions/pm.fish
 
@@ -1862,8 +1172,8 @@ function __pm_no_subcommand
   not __fish_seen_subcommand_from ${noSubcommandList}
 end
 ${dynamicTagResolver}
-${useDynamicTypeExpansion ? renderFishDynamicChoiceResolver("type", "completion-types", typeFallbackChoices) : ""}
-${renderFishDynamicChoiceResolver("status", "completion-statuses", statusFallbackChoices)}
+${useDynamicTypeExpansion?renderFishDynamicChoiceResolver("type","completion-types",typeFallbackChoices):""}
+${renderFishDynamicChoiceResolver("status","completion-statuses",statusFallbackChoices)}
 
 # Subcommands
 ${renderFishCommandDescriptions()}
@@ -2295,18 +1605,61 @@ complete -c pm -n '__fish_seen_subcommand_from get' -l fields -d 'Render custom
 complete -c pm -n '__fish_seen_subcommand_from get' -l tree -d 'Include descendant subtree in result payload'
 complete -c pm -n '__fish_seen_subcommand_from get' -l tree-depth -d 'Cap subtree depth for --tree (0 = root only)' -r
 
+# Read the first command positions after consuming recognized global options.
+function __pm_history_tokens
+  set -l tokens (commandline -opc)
+  set -l skip_value 0
+  set -l positions 0
+  for token in $tokens[2..-1]
+    if test $skip_value -eq 1
+      set skip_value 0
+      continue
+    end
+    switch (string replace -a _ - -- "$token")
+      case ${GLOBAL_COMPLETION_VALUE_PATTERNS.replaceAll("|"," ")}
+        set skip_value 1
+        continue
+      case ${GLOBAL_COMPLETION_INLINE_PATTERNS.split("|").map(pattern=>`'${pattern}'`).join(" ")} ${GLOBAL_COMPLETION_SWITCH_PATTERNS.replaceAll("|"," ")}
+        continue
+      case --
+        printf '%s\\n' --
+        return
+    end
+    printf '%s\\n' "$token"
+    set positions (math $positions + 1)
+    if test $positions -eq 2; or test "$token" != history
+      return
+    end
+  end
+  if test $skip_value -eq 1
+    printf '%s\\n' --value
+  end
+end
+
+# Match only the command positions, keeping item history separate from maintenance.
+function __pm_history_operation
+  set -l tokens (__pm_history_tokens)
+  if test "$tokens[1]" = history; and contains -- "$tokens[2]" ${HISTORY_LEAVES}
+    test "$tokens[2]" = "$argv[2]"
+  else
+    test "$tokens[1]" = "$argv[1]"
+  end
+end
+complete -c pm -n 'test (count (__pm_history_tokens)) -eq 1; and __pm_history_operation history' -a '${HISTORY_LEAVES}' -d 'History operation'
+${RESTORE_INVOCATIONS.map(flag=>`complete -c pm -n '__pm_history_operation restore restore' -l ${flag.flag.slice(2)}${flag.takes_value?" -r":""}`).join("\n")}
+
 # history / activity flags
-complete -c pm -n '__fish_seen_subcommand_from history'  -l limit -d 'Max history entries' -r
-complete -c pm -n '__fish_seen_subcommand_from history'  -l compact -d 'Condensed history projection'
-complete -c pm -n '__fish_seen_subcommand_from history'  -l full -d 'Show full history entries'
-complete -c pm -n '__fish_seen_subcommand_from history'  -l provenance -d 'Patch-free identity and agent provenance projection'
-complete -c pm -n '__fish_seen_subcommand_from history'  -l provenance-summary -d 'Include bounded provenance completeness counts'
-complete -c pm -n '__fish_seen_subcommand_from history'  -l harness -d 'Filter by recorded or vocabulary-resolved harness' -r
-complete -c pm -n '__fish_seen_subcommand_from history'  -l agent-instance -d 'Filter by privacy-safe agent instance' -r
-complete -c pm -n '__fish_seen_subcommand_from history'  -l provenance-filter -d 'Filter by exact declared provenance value' -r
-complete -c pm -n '__fish_seen_subcommand_from history'  -l diff -d 'Include per-entry field-level before/after value diffs'
-complete -c pm -n '__fish_seen_subcommand_from history'  -l field -d 'With --diff, show only entries that changed this field' -r
-complete -c pm -n '__fish_seen_subcommand_from history'  -l verify -d 'Verify history hash chain and replay integrity'
+complete -c pm -n '__pm_history_operation history'  -l limit -d 'Max history entries' -r
+complete -c pm -n '__pm_history_operation history'  -l compact -d 'Condensed history projection'
+complete -c pm -n '__pm_history_operation history'  -l full -d 'Show full history entries'
+complete -c pm -n '__pm_history_operation history'  -l provenance -d 'Patch-free identity and agent provenance projection'
+complete -c pm -n '__pm_history_operation history'  -l provenance-summary -d 'Include bounded provenance completeness counts'
+complete -c pm -n '__pm_history_operation history'  -l harness -d 'Filter by recorded or vocabulary-resolved harness' -r
+complete -c pm -n '__pm_history_operation history'  -l agent-instance -d 'Filter by privacy-safe agent instance' -r
+complete -c pm -n '__pm_history_operation history'  -l provenance-filter -d 'Filter by exact declared provenance value' -r
+complete -c pm -n '__pm_history_operation history'  -l diff -d 'Include per-entry field-level before/after value diffs'
+complete -c pm -n '__pm_history_operation history'  -l field -d 'With --diff, show only entries that changed this field' -r
+complete -c pm -n '__pm_history_operation history'  -l verify -d 'Verify history hash chain and replay integrity'
 complete -c pm -n '__fish_seen_subcommand_from events' -l since -d 'Resume after a cursor or from an ISO timestamp' -r
 complete -c pm -n '__fish_seen_subcommand_from events' -l type -d 'Filter by mutation operation' -r
 complete -c pm -n '__fish_seen_subcommand_from events' -l author -d 'Filter by mutation author' -r
@@ -2320,16 +1673,17 @@ complete -c pm -n '__fish_seen_subcommand_from events' -l agent-instance -d 'Fil
 complete -c pm -n '__fish_seen_subcommand_from events' -l provenance-filter -d 'Filter by exact declared provenance value' -r
 complete -c pm -n '__fish_seen_subcommand_from events' -l follow -d 'Continue emitting committed events'
 complete -c pm -n '__fish_seen_subcommand_from events' -l interval-ms -d 'Empty-read delay while following' -r
-complete -c pm -n '__fish_seen_subcommand_from history-compact' -l before -d 'Compact entries strictly before this version number or ISO timestamp' -r
-complete -c pm -n '__fish_seen_subcommand_from history-compact' -l ids -d 'Bulk: compact an explicit comma-separated list of item ids' -r
-complete -c pm -n '__fish_seen_subcommand_from history-compact' -l all-over -d 'Bulk: compact every stream with more than N entries' -r
-complete -c pm -n '__fish_seen_subcommand_from history-compact' -l closed -d 'Bulk: compact only closed (terminal) items streams'
-complete -c pm -n '__fish_seen_subcommand_from history-compact' -l all-streams -d 'Bulk: compact every history stream regardless of lifecycle state'
-complete -c pm -n '__fish_seen_subcommand_from history-compact' -l min-entries -d 'Bulk: skip streams with at most N entries' -r
-complete -c pm -n '__fish_seen_subcommand_from history-compact' -l dry-run -d 'Preview compaction impact without writing the history file'
-complete -c pm -n '__fish_seen_subcommand_from history-compact' -l author -d 'Mutation author' -r
-complete -c pm -n '__fish_seen_subcommand_from history-compact' -l message -d 'Audit history message' -r
-complete -c pm -n '__fish_seen_subcommand_from history-compact' -l force -d 'Force ownership/lock override'
+complete -c pm -n '__pm_history_operation history-compact compact' -l before -d 'Compact entries strictly before this version number or ISO timestamp' -r
+complete -c pm -n '__pm_history_operation history-compact compact' -l id -d 'Item ID (alternative to positional ID)' -r
+complete -c pm -n '__pm_history_operation history-compact compact' -l ids -d 'Bulk: compact an explicit comma-separated list of item ids' -r
+complete -c pm -n '__pm_history_operation history-compact compact' -l all-over -d 'Bulk: compact every stream with more than N entries' -r
+complete -c pm -n '__pm_history_operation history-compact compact' -l closed -d 'Bulk: compact only closed (terminal) items streams'
+complete -c pm -n '__pm_history_operation history-compact compact' -l all-streams -d 'Bulk: compact every history stream regardless of lifecycle state'
+complete -c pm -n '__pm_history_operation history-compact compact' -l min-entries -d 'Bulk: skip streams with at most N entries' -r
+complete -c pm -n '__pm_history_operation history-compact compact' -l dry-run -d 'Preview compaction impact without writing the history file'
+complete -c pm -n '__pm_history_operation history-compact compact' -l author -d 'Mutation author' -r
+complete -c pm -n '__pm_history_operation history-compact compact' -l message -d 'Audit history message' -r
+complete -c pm -n '__pm_history_operation history-compact compact' -l force -d 'Force ownership/lock override'
 complete -c pm -n '__fish_seen_subcommand_from history-author-acknowledge' -l event -d 'Actionable unknown-author event' -r
 complete -c pm -n '__fish_seen_subcommand_from history-author-acknowledge' -l all-actionable -d 'Select every currently actionable event'
 complete -c pm -n '__fish_seen_subcommand_from history-author-acknowledge' -l dry-run -d 'Preview a deterministic source-bound plan'
@@ -2338,19 +1692,28 @@ complete -c pm -n '__fish_seen_subcommand_from history-author-acknowledge' -l li
 complete -c pm -n '__fish_seen_subcommand_from history-author-acknowledge' -l attributed-author -d 'Principal attributed by maintainer review' -r
 complete -c pm -n '__fish_seen_subcommand_from history-author-acknowledge' -l reviewer -d 'Reviewer recording the disposition' -r
 complete -c pm -n '__fish_seen_subcommand_from history-author-acknowledge' -l reason -d 'Evidence-backed review rationale' -r
-complete -c pm -n '__fish_seen_subcommand_from history-redact' -l literal -d 'Literal string matcher to redact from history/item payloads' -r
-complete -c pm -n '__fish_seen_subcommand_from history-redact' -l regex -d 'Regex matcher to redact (/pattern/flags or raw pattern)' -r
-complete -c pm -n '__fish_seen_subcommand_from history-redact' -l replacement -d 'Replacement text (defaults to [redacted])' -r
-complete -c pm -n '__fish_seen_subcommand_from history-redact' -l dry-run -d 'Preview redaction impact without writing files'
-complete -c pm -n '__fish_seen_subcommand_from history-redact' -l author -d 'Mutation author' -r
-complete -c pm -n '__fish_seen_subcommand_from history-redact' -l message -d 'Audit history message' -r
-complete -c pm -n '__fish_seen_subcommand_from history-redact' -l force -d 'Force ownership/lock override'
-complete -c pm -n '__fish_seen_subcommand_from history-repair' -l all -d 'Repair every drifted stream in one audited pass'
-complete -c pm -n '__fish_seen_subcommand_from history-repair' -l dry-run -d 'Preview the re-anchor impact without writing the history file'
-complete -c pm -n '__fish_seen_subcommand_from history-repair' -l author -d 'Mutation author' -r
-complete -c pm -n '__fish_seen_subcommand_from history-repair' -l message -d 'Audit history message' -r
-complete -c pm -n '__fish_seen_subcommand_from history-repair' -l force -d 'Force ownership/lock override'
-complete -c pm -n '__fish_seen_subcommand_from schema' -a 'list show show-status add-type remove-type add-status remove-status add-field remove-field list-fields show-field apply-preset rename-type rename-field remap-status' -d 'Schema subcommand'
+complete -c pm -n '__pm_history_operation history-redact redact' -l literal -d 'Literal string matcher to redact from history/item payloads' -r
+complete -c pm -n '__pm_history_operation history-redact redact' -l id -d 'Item ID (alternative to positional ID)' -r
+complete -c pm -n '__pm_history_operation history-redact redact' -l regex -d 'Regex matcher to redact (/pattern/flags or raw pattern)' -r
+complete -c pm -n '__pm_history_operation history-redact redact' -l replacement -d 'Replacement text (defaults to [redacted])' -r
+complete -c pm -n '__pm_history_operation history-redact redact' -l dry-run -d 'Preview redaction impact without writing files'
+complete -c pm -n '__pm_history_operation history-redact redact' -l author -d 'Mutation author' -r
+complete -c pm -n '__pm_history_operation history-redact redact' -l message -d 'Audit history message' -r
+complete -c pm -n '__pm_history_operation history-redact redact' -l force -d 'Force ownership/lock override'
+complete -c pm -n '__pm_history_operation history-repair repair' -l salvage-tail -d 'Recover an invalid suffix after a verified prefix'
+complete -c pm -n '__pm_history_operation history-repair repair' -l id -d 'Item ID (alternative to positional ID)' -r
+complete -c pm -n '__pm_history_operation history-repair repair' -l normalize-provenance -d 'Remove invalid provenance with aggregate evidence'
+complete -c pm -n '__pm_history_operation history-repair repair' -l all -d 'Repair every drifted stream in one audited pass'
+complete -c pm -n '__pm_history_operation history-repair repair' -l dry-run -d 'Preview the re-anchor impact without writing the history file'
+complete -c pm -n '__pm_history_operation history-repair repair' -l author -d 'Mutation author' -r
+complete -c pm -n '__pm_history_operation history-repair repair' -l message -d 'Audit history message' -r
+complete -c pm -n '__pm_history_operation history-repair repair' -l force -d 'Force ownership/lock override'
+complete -c pm -n '__fish_seen_subcommand_from schema' -a '${SCHEMA_SUBCOMMAND_CHOICES}' -d 'Schema subcommand'
+complete -c pm -n '__fish_seen_subcommand_from schema; and __fish_seen_subcommand_from policy-mode' -a 'advise refuse' -d 'Policy enforcement'
+complete -c pm -n '__fish_seen_subcommand_from schema' -l definition -d 'Policy definition or proposed fields JSON' -r
+complete -c pm -n '__fish_seen_subcommand_from schema' -l policy -d 'Approval policy id' -r
+complete -c pm -n '__fish_seen_subcommand_from schema' -l message -d 'History rationale' -r
+complete -c pm -n '__fish_seen_subcommand_from schema' -l dry-run -d 'Preview schema changes'
 complete -c pm -n '__fish_seen_subcommand_from schema' -l description -d 'Human description for the custom item type, status, or field' -r
 complete -c pm -n '__fish_seen_subcommand_from schema' -l default-status -d 'Default status hint for the custom item type' -r
 complete -c pm -n '__fish_seen_subcommand_from schema' -l folder -d 'Storage folder for items of this custom type' -r
@@ -2395,21 +1758,22 @@ complete -c pm -n '__fish_seen_subcommand_from plan' -l promote-to-item-dep -d '
 complete -c pm -n '__fish_seen_subcommand_from plan' -l author -d 'Mutation author' -r
 complete -c pm -n '__fish_seen_subcommand_from plan' -l message -d 'Mutation message' -r
 complete -c pm -n '__fish_seen_subcommand_from plan' -l force -d 'Force ownership override'
-complete -c pm -n '__fish_seen_subcommand_from activity' -l id -d 'Filter by item ID' -r
-complete -c pm -n '__fish_seen_subcommand_from activity' -l op -d 'Filter by history operation' -r
-complete -c pm -n '__fish_seen_subcommand_from activity' -l author -d 'Filter by history author' -r
-complete -c pm -n '__fish_seen_subcommand_from activity' -l from -d 'Lower timestamp bound (ISO/date string or relative)' -r
-complete -c pm -n '__fish_seen_subcommand_from activity' -l to -d 'Upper timestamp bound (ISO/date string or relative)' -r
-complete -c pm -n '__fish_seen_subcommand_from activity' -l limit -d 'Max activity entries' -r
-complete -c pm -n '__fish_seen_subcommand_from activity' -l compact -d 'Condensed activity projection'
-complete -c pm -n '__fish_seen_subcommand_from activity' -l raw -d 'Emit raw compact per-event activity output'
-complete -c pm -n '__fish_seen_subcommand_from activity' -l full -d 'Show full activity entries'
-complete -c pm -n '__fish_seen_subcommand_from activity' -l provenance -d 'Patch-free identity and agent provenance projection'
-complete -c pm -n '__fish_seen_subcommand_from activity' -l provenance-summary -d 'Include bounded provenance completeness counts'
-complete -c pm -n '__fish_seen_subcommand_from activity' -l harness -d 'Filter by recorded or vocabulary-resolved harness' -r
-complete -c pm -n '__fish_seen_subcommand_from activity' -l agent-instance -d 'Filter by privacy-safe agent instance' -r
-complete -c pm -n '__fish_seen_subcommand_from activity' -l provenance-filter -d 'Filter by exact declared provenance value' -r
-complete -c pm -n '__fish_seen_subcommand_from activity' -l stream -d 'Emit line-delimited JSON rows (requires --json)'
+complete -c pm -n '__pm_history_operation activity activity' -l id -d 'Filter by item ID' -r
+complete -c pm -n '__pm_history_operation activity activity' -l op -d 'Filter by history operation' -r
+complete -c pm -n '__pm_history_operation activity activity' -l author -d 'Filter by history author' -r
+complete -c pm -n '__pm_history_operation activity activity' -l from -d 'Lower timestamp bound (ISO/date string or relative)' -r
+complete -c pm -n '__pm_history_operation activity activity' -l to -d 'Upper timestamp bound (ISO/date string or relative)' -r
+complete -c pm -n '__pm_history_operation activity activity' -l limit -d 'Max activity entries' -r
+complete -c pm -n '__pm_history_operation activity activity' -l unbounded -d 'Return every matching activity entry'
+complete -c pm -n '__pm_history_operation activity activity' -l compact -d 'Condensed activity projection'
+complete -c pm -n '__pm_history_operation activity activity' -l raw -d 'Emit raw compact per-event activity output'
+complete -c pm -n '__pm_history_operation activity activity' -l full -d 'Show full activity entries'
+complete -c pm -n '__pm_history_operation activity activity' -l provenance -d 'Patch-free identity and agent provenance projection'
+complete -c pm -n '__pm_history_operation activity activity' -l provenance-summary -d 'Include bounded provenance completeness counts'
+complete -c pm -n '__pm_history_operation activity activity' -l harness -d 'Filter by recorded or vocabulary-resolved harness' -r
+complete -c pm -n '__pm_history_operation activity activity' -l agent-instance -d 'Filter by privacy-safe agent instance' -r
+complete -c pm -n '__pm_history_operation activity activity' -l provenance-filter -d 'Filter by exact declared provenance value' -r
+complete -c pm -n '__pm_history_operation activity activity' -l stream -d 'Emit line-delimited JSON rows (requires --json)'
 complete -c pm -n '__fish_seen_subcommand_from contracts' -l action -d 'Filter schema by tool action' -r
 complete -c pm -n '__fish_seen_subcommand_from contracts' -l command -d 'Scope output to one command (narrow-by-default)' -r
 complete -c pm -n '__fish_seen_subcommand_from contracts' -l summary -d 'Return compact command intent summary'
@@ -2636,6 +2000,7 @@ complete -c pm -n '__fish_seen_subcommand_from close-many' -l rollback
 complete -c pm -n '__fish_seen_subcommand_from close-many' -l no-checkpoint          -d 'Disable checkpoint creation during apply mode'
 
 # validate flags
+complete -c pm -n '__fish_seen_subcommand_from validate' -l check-completeness -d 'Check declarative required fields'
 complete -c pm -n '__fish_seen_subcommand_from validate' -l check-metadata -d 'Run metadata completeness checks'
 complete -c pm -n '__fish_seen_subcommand_from validate' -l metadata-profile -d 'Select metadata validation profile for --check-metadata' -r -a 'core strict custom'
 complete -c pm -n '__fish_seen_subcommand_from validate' -l check-resolution -d 'Run closed-item resolution metadata checks'
@@ -2767,35 +2132,5 @@ for package_cmd in package packages
   complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l repair -d 'Force npm global reinstall for the CLI/SDK'
   complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l tag -d 'npm version or dist-tag for upgrades' -r
   complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l package-name -d 'Override the CLI package name' -r
-end`;
-}
-const SETUP_HINTS = {
-    bash: 'Add to ~/.bashrc or ~/.bash_profile: eval "$(pm completion bash)"',
-    zsh: 'Add to ~/.zshrc: eval "$(pm completion zsh)"',
-    fish: "Run: pm completion fish > ~/.config/fish/completions/pm.fish",
-};
-/** Implements run completion for the public runtime surface of this module. */
-export function runCompletion(shell, itemTypes = [], tags = [], eagerTagExpansion = false, runtime = {}) {
-    const normalized = shell.trim().toLowerCase();
-    if (!VALID_SHELLS.includes(normalized)) {
-        throw new PmCliError(`Unknown shell: "${shell}". Supported shells: ${VALID_SHELLS.join(", ")}.`, EXIT_CODE.USAGE);
-    }
-    const validShell = normalized;
-    let script;
-    if (validShell === "bash") {
-        script = generateBashScript(itemTypes, tags, eagerTagExpansion, runtime);
-    }
-    else if (validShell === "zsh") {
-        script = generateZshScript(itemTypes, tags, eagerTagExpansion, runtime);
-    }
-    else {
-        script = generateFishScript(itemTypes, tags, eagerTagExpansion, runtime);
-    }
-    return {
-        shell: validShell,
-        script,
-        setup_hint: SETUP_HINTS[validShell],
-    };
-}
+end`}const SETUP_HINTS={bash:'Add to ~/.bashrc or ~/.bash_profile: eval "$(pm completion bash)"',zsh:'Add to ~/.zshrc: eval "$(pm completion zsh)"',fish:"Run: pm completion fish > ~/.config/fish/completions/pm.fish"};function runCompletion(shell,itemTypes=[],tags=[],eagerTagExpansion=false,runtime={}){const normalized=shell.trim().toLowerCase();if(!VALID_SHELLS.includes(normalized)){throw new PmCliError(`Unknown shell: "${shell}". Supported shells: ${VALID_SHELLS.join(", ")}.`,EXIT_CODE.USAGE)}const validShell=normalized;let script;if(validShell==="bash"){script=generateBashScript(itemTypes,tags,eagerTagExpansion,runtime)}else if(validShell==="zsh"){script=generateZshScript(itemTypes,tags,eagerTagExpansion,runtime)}else{script=generateFishScript(itemTypes,tags,eagerTagExpansion,runtime)}return{shell:validShell,script,setup_hint:SETUP_HINTS[validShell]}}export{generateBashScript,generateFishScript,generateZshScript,runCompletion};
 //# sourceMappingURL=completion.js.map
-//# debugId=4bf2b42b-91f3-5850-b1f1-d8a01525860c