@unbrained/pm-cli 2026.5.1 → 2026.5.3-5

package/dist/cli/migration-gates.d.ts

@@ -0,0 +1,22 @@
+import { type PreflightRuntimeDecision } from "../core/extensions/index.js";
+export interface MandatoryMigrationBlocker {
+    layer: "global" | "project";
+    name: string;
+    id: string;
+    status: string;
+}
+export interface WriteGateDecision {
+    isMutation: boolean;
+    forceCapable: boolean;
+    forceRequested: boolean;
+}
+export declare function resolveMigrationId(definition: Record<string, unknown>, fallbackIndex: number): string;
+export declare function resolveNormalizedMigrationStatus(definition: Record<string, unknown>): string;
+export declare function collectMandatoryMigrationBlockers(migrations: Array<{
+    layer: "global" | "project";
+    name: string;
+    definition: Record<string, unknown>;
+}>): MandatoryMigrationBlocker[];
+export declare function decideWriteGate(commandPath: string, options: Record<string, unknown>): WriteGateDecision;
+export declare function enforceMandatoryMigrationWriteGate(commandPath: string, options: Record<string, unknown>, blockers: MandatoryMigrationBlocker[]): void;
+export declare function enforceItemFormatWriteGateAndPreflightMigration(commandPath: string, options: Record<string, unknown>, pmRoot: string, decision: PreflightRuntimeDecision): Promise<void>;

package/dist/cli/migration-gates.js

@@ -0,0 +1,146 @@
+import { pathExists } from "../core/fs/fs-utils.js";
+import { getActiveExtensionRegistrations } from "../core/extensions/index.js";
+import { resolveItemTypeRegistry } from "../core/item/type-registry.js";
+import { migrateItemFilesToFormat } from "../core/store/item-format-migration.js";
+import { getSettingsPath } from "../core/store/paths.js";
+import { readSettingsWithMetadata, writeSettings } from "../core/store/settings.js";
+import { EXIT_CODE } from "../core/shared/constants.js";
+import { PmCliError } from "../core/shared/errors.js";
+import { toNonEmptyStringOrUndefined } from "../core/shared/primitives.js";
+import { printError } from "../core/output/output.js";
+export function resolveMigrationId(definition, fallbackIndex) {
+    const explicit = toNonEmptyStringOrUndefined(definition.id);
+    if (explicit) {
+        return explicit;
+    }
+    return `migration-${String(fallbackIndex + 1).padStart(3, "0")}`;
+}
+export function resolveNormalizedMigrationStatus(definition) {
+    const normalized = toNonEmptyStringOrUndefined(definition.status)?.toLowerCase();
+    return normalized ?? "pending";
+}
+function isMandatoryMigrationDefinition(definition) {
+    return definition.mandatory === true;
+}
+function compareMandatoryMigrationBlockers(left, right) {
+    const byLayer = left.layer.localeCompare(right.layer);
+    if (byLayer !== 0) {
+        return byLayer;
+    }
+    const byName = left.name.localeCompare(right.name);
+    if (byName !== 0) {
+        return byName;
+    }
+    return left.id.localeCompare(right.id);
+}
+export function collectMandatoryMigrationBlockers(migrations) {
+    const blockers = [];
+    migrations.forEach((entry, index) => {
+        if (!isMandatoryMigrationDefinition(entry.definition)) {
+            return;
+        }
+        const status = resolveNormalizedMigrationStatus(entry.definition);
+        if (status === "applied") {
+            return;
+        }
+        blockers.push({
+            layer: entry.layer,
+            name: entry.name,
+            id: resolveMigrationId(entry.definition, index),
+            status,
+        });
+    });
+    blockers.sort(compareMandatoryMigrationBlockers);
+    return blockers;
+}
+function hasMutatingListValues(value) {
+    return Array.isArray(value) && value.length > 0;
+}
+export function decideWriteGate(commandPath, options) {
+    const forceRequested = options.force === true;
+    switch (commandPath) {
+        case "create":
+        case "beads import":
+        case "todos import":
+            return {
+                isMutation: true,
+                forceCapable: false,
+                forceRequested: false,
+            };
+        case "restore":
+        case "update":
+        case "close":
+        case "delete":
+        case "append":
+        case "claim":
+        case "release":
+            return {
+                isMutation: true,
+                forceCapable: true,
+                forceRequested,
+            };
+        case "comments":
+        case "notes":
+        case "learnings":
+            return {
+                isMutation: typeof options.add === "string",
+                forceCapable: true,
+                forceRequested,
+            };
+        case "files":
+        case "docs":
+        case "test":
+            return {
+                isMutation: hasMutatingListValues(options.add) || hasMutatingListValues(options.remove),
+                forceCapable: true,
+                forceRequested,
+            };
+        default:
+            return {
+                isMutation: false,
+                forceCapable: false,
+                forceRequested: false,
+            };
+    }
+}
+export function enforceMandatoryMigrationWriteGate(commandPath, options, blockers) {
+    if (blockers.length === 0) {
+        return;
+    }
+    const decision = decideWriteGate(commandPath, options);
+    if (!decision.isMutation) {
+        return;
+    }
+    if (decision.forceCapable && decision.forceRequested) {
+        return;
+    }
+    const codes = blockers.map((entry) => `extension_migration_blocking:${entry.layer}:${entry.name}:${entry.id}:${entry.status}`);
+    const forceGuidance = decision.forceCapable
+        ? "Re-run this command with --force to bypass."
+        : "This command path does not support --force bypass.";
+    throw new PmCliError(`Write command "${commandPath}" blocked by unresolved mandatory extension migrations (${codes.join(",")}). ${forceGuidance}`, EXIT_CODE.CONFLICT);
+}
+export async function enforceItemFormatWriteGateAndPreflightMigration(commandPath, options, pmRoot, decision) {
+    const writeGate = decideWriteGate(commandPath, options);
+    if (!writeGate.isMutation) {
+        return;
+    }
+    if (!decision.enforce_item_format_gate && !decision.run_preflight_item_format_sync) {
+        return;
+    }
+    if (!(await pathExists(getSettingsPath(pmRoot)))) {
+        return;
+    }
+    const { settings, metadata, warnings } = await readSettingsWithMetadata(pmRoot);
+    for (const warning of warnings) {
+        printError(`warning:${warning}`);
+    }
+    if (decision.enforce_item_format_gate && !metadata.has_explicit_item_format) {
+        await writeSettings(pmRoot, settings, "item_format:auto_select_default");
+    }
+    if (decision.run_preflight_item_format_sync) {
+        const typeRegistry = resolveItemTypeRegistry(settings, getActiveExtensionRegistrations());
+        await migrateItemFilesToFormat(pmRoot, settings.item_format, "item_format:pre_mutation_sync", typeRegistry.type_to_folder, settings.schema);
+    }
+}
+//# sourceMappingURL=migration-gates.js.map

package/dist/cli/migration-gates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-gates.js","sourceRoot":"/","sources":["cli/migration-gates.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,+BAA+B,EAAiC,MAAM,6BAA6B,CAAC;AAC7G,OAAO,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AACxE,OAAO,EAAE,wBAAwB,EAAE,MAAM,wCAAwC,CAAC;AAClF,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,wBAAwB,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AACpF,OAAO,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAC;AAC3E,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAetD,MAAM,UAAU,kBAAkB,CAAC,UAAmC,EAAE,aAAqB;IAC3F,MAAM,QAAQ,GAAG,2BAA2B,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;IAC5D,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,OAAO,aAAa,MAAM,CAAC,aAAa,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,gCAAgC,CAAC,UAAmC;IAClF,MAAM,UAAU,GAAG,2BAA2B,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,CAAC;IACjF,OAAO,UAAU,IAAI,SAAS,CAAC;AACjC,CAAC;AAED,SAAS,8BAA8B,CAAC,UAAmC;IACzE,OAAO,UAAU,CAAC,SAAS,KAAK,IAAI,CAAC;AACvC,CAAC;AAED,SAAS,iCAAiC,CAAC,IAA+B,EAAE,KAAgC;IAC1G,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACtD,IAAI,OAAO,KAAK,CAAC,EAAE,CAAC;QAClB,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACnD,IAAI,MAAM,KAAK,CAAC,EAAE,CAAC;QACjB,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,OAAO,IAAI,CAAC,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,iCAAiC,CAC/C,UAIE;IAEF,MAAM,QAAQ,GAAgC,EAAE,CAAC;IACjD,UAAU,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;QAClC,IAAI,CAAC,8BAA8B,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC;YACtD,OAAO;QACT,CAAC;QACD,MAAM,MAAM,GAAG,gCAAgC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAClE,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,OAAO;QACT,CAAC;QACD,QAAQ,CAAC,IAAI,CAAC;YACZ,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,EAAE,EAAE,kBAAkB,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC;YAC/C,MAAM;SACP,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IACH,QAAQ,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;IACjD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,qBAAqB,CAAC,KAAc;IAC3C,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,WAAmB,EAAE,OAAgC;IACnF,MAAM,cAAc,GAAG,OAAO,CAAC,KAAK,KAAK,IAAI,CAAC;IAC9C,QAAQ,WAAW,EAAE,CAAC;QACpB,KAAK,QAAQ,CAAC;QACd,KAAK,cAAc,CAAC;QACpB,KAAK,cAAc;YACjB,OAAO;gBACL,UAAU,EAAE,IAAI;gBAChB,YAAY,EAAE,KAAK;gBACnB,cAAc,EAAE,KAAK;aACtB,CAAC;QACJ,KAAK,SAAS,CAAC;QACf,KAAK,QAAQ,CAAC;QACd,KAAK,OAAO,CAAC;QACb,KAAK,QAAQ,CAAC;QACd,KAAK,QAAQ,CAAC;QACd,KAAK,OAAO,CAAC;QACb,KAAK,SAAS;YACZ,OAAO;gBACL,UAAU,EAAE,IAAI;gBAChB,YAAY,EAAE,IAAI;gBAClB,cAAc;aACf,CAAC;QACJ,KAAK,UAAU,CAAC;QAChB,KAAK,OAAO,CAAC;QACb,KAAK,WAAW;YACd,OAAO;gBACL,UAAU,EAAE,OAAO,OAAO,CAAC,GAAG,KAAK,QAAQ;gBAC3C,YAAY,EAAE,IAAI;gBAClB,cAAc;aACf,CAAC;QACJ,KAAK,OAAO,CAAC;QACb,KAAK,MAAM,CAAC;QACZ,KAAK,MAAM;YACT,OAAO;gBACL,UAAU,EAAE,qBAAqB,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,qBAAqB,CAAC,OAAO,CAAC,MAAM,CAAC;gBACvF,YAAY,EAAE,IAAI;gBAClB,cAAc;aACf,CAAC;QACJ;YACE,OAAO;gBACL,UAAU,EAAE,KAAK;gBACjB,YAAY,EAAE,KAAK;gBACnB,cAAc,EAAE,KAAK;aACtB,CAAC;IACN,CAAC;AACH,CAAC;AAED,MAAM,UAAU,kCAAkC,CAChD,WAAmB,EACnB,OAAgC,EAChC,QAAqC;IAErC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO;IACT,CAAC;IACD,MAAM,QAAQ,GAAG,eAAe,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IACvD,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;QACzB,OAAO;IACT,CAAC;IACD,IAAI,QAAQ,CAAC,YAAY,IAAI,QAAQ,CAAC,cAAc,EAAE,CAAC;QACrD,OAAO;IACT,CAAC;IACD,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CACxB,CAAC,KAAK,EAAE,EAAE,CAAC,gCAAgC,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,EAAE,IAAI,KAAK,CAAC,MAAM,EAAE,CACnG,CAAC;IACF,MAAM,aAAa,GAAG,QAAQ,CAAC,YAAY;QACzC,CAAC,CAAC,6CAA6C;QAC/C,CAAC,CAAC,oDAAoD,CAAC;IACzD,MAAM,IAAI,UAAU,CAClB,kBAAkB,WAAW,2DAA2D,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,aAAa,EAAE,EAC5H,SAAS,CAAC,QAAQ,CACnB,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,+CAA+C,CACnE,WAAmB,EACnB,OAAgC,EAChC,MAAc,EACd,QAAkC;IAElC,MAAM,SAAS,GAAG,eAAe,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IACxD,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,CAAC;QAC1B,OAAO;IACT,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,wBAAwB,IAAI,CAAC,QAAQ,CAAC,8BAA8B,EAAE,CAAC;QACnF,OAAO;IACT,CAAC;IACD,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QACjD,OAAO;IACT,CAAC;IACD,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,MAAM,wBAAwB,CAAC,MAAM,CAAC,CAAC;IAChF,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,UAAU,CAAC,WAAW,OAAO,EAAE,CAAC,CAAC;IACnC,CAAC;IACD,IAAI,QAAQ,CAAC,wBAAwB,IAAI,CAAC,QAAQ,CAAC,wBAAwB,EAAE,CAAC;QAC5E,MAAM,aAAa,CAAC,MAAM,EAAE,QAAQ,EAAE,iCAAiC,CAAC,CAAC;IAC3E,CAAC;IACD,IAAI,QAAQ,CAAC,8BAA8B,EAAE,CAAC;QAC5C,MAAM,YAAY,GAAG,uBAAuB,CAAC,QAAQ,EAAE,+BAA+B,EAAE,CAAC,CAAC;QAC1F,MAAM,wBAAwB,CAC5B,MAAM,EACN,QAAQ,CAAC,WAAW,EACpB,+BAA+B,EAC/B,YAAY,CAAC,cAAc,EAC3B,QAAQ,CAAC,MAAM,CAChB,CAAC;IACJ,CAAC;AACH,CAAC","sourcesContent":["import { pathExists } from \"../core/fs/fs-utils.js\";\nimport { getActiveExtensionRegistrations, type PreflightRuntimeDecision } from \"../core/extensions/index.js\";\nimport { resolveItemTypeRegistry } from \"../core/item/type-registry.js\";\nimport { migrateItemFilesToFormat } from \"../core/store/item-format-migration.js\";\nimport { getSettingsPath } from \"../core/store/paths.js\";\nimport { readSettingsWithMetadata, writeSettings } from \"../core/store/settings.js\";\nimport { EXIT_CODE } from \"../core/shared/constants.js\";\nimport { PmCliError } from \"../core/shared/errors.js\";\nimport { toNonEmptyStringOrUndefined } from \"../core/shared/primitives.js\";\nimport { printError } from \"../core/output/output.js\";\n\nexport interface MandatoryMigrationBlocker {\n  layer: \"global\" | \"project\";\n  name: string;\n  id: string;\n  status: string;\n}\n\nexport interface WriteGateDecision {\n  isMutation: boolean;\n  forceCapable: boolean;\n  forceRequested: boolean;\n}\n\nexport function resolveMigrationId(definition: Record<string, unknown>, fallbackIndex: number): string {\n  const explicit = toNonEmptyStringOrUndefined(definition.id);\n  if (explicit) {\n    return explicit;\n  }\n  return `migration-${String(fallbackIndex + 1).padStart(3, \"0\")}`;\n}\n\nexport function resolveNormalizedMigrationStatus(definition: Record<string, unknown>): string {\n  const normalized = toNonEmptyStringOrUndefined(definition.status)?.toLowerCase();\n  return normalized ?? \"pending\";\n}\n\nfunction isMandatoryMigrationDefinition(definition: Record<string, unknown>): boolean {\n  return definition.mandatory === true;\n}\n\nfunction compareMandatoryMigrationBlockers(left: MandatoryMigrationBlocker, right: MandatoryMigrationBlocker): number {\n  const byLayer = left.layer.localeCompare(right.layer);\n  if (byLayer !== 0) {\n    return byLayer;\n  }\n  const byName = left.name.localeCompare(right.name);\n  if (byName !== 0) {\n    return byName;\n  }\n  return left.id.localeCompare(right.id);\n}\n\nexport function collectMandatoryMigrationBlockers(\n  migrations: Array<{\n    layer: \"global\" | \"project\";\n    name: string;\n    definition: Record<string, unknown>;\n  }>,\n): MandatoryMigrationBlocker[] {\n  const blockers: MandatoryMigrationBlocker[] = [];\n  migrations.forEach((entry, index) => {\n    if (!isMandatoryMigrationDefinition(entry.definition)) {\n      return;\n    }\n    const status = resolveNormalizedMigrationStatus(entry.definition);\n    if (status === \"applied\") {\n      return;\n    }\n    blockers.push({\n      layer: entry.layer,\n      name: entry.name,\n      id: resolveMigrationId(entry.definition, index),\n      status,\n    });\n  });\n  blockers.sort(compareMandatoryMigrationBlockers);\n  return blockers;\n}\n\nfunction hasMutatingListValues(value: unknown): boolean {\n  return Array.isArray(value) && value.length > 0;\n}\n\nexport function decideWriteGate(commandPath: string, options: Record<string, unknown>): WriteGateDecision {\n  const forceRequested = options.force === true;\n  switch (commandPath) {\n    case \"create\":\n    case \"beads import\":\n    case \"todos import\":\n      return {\n        isMutation: true,\n        forceCapable: false,\n        forceRequested: false,\n      };\n    case \"restore\":\n    case \"update\":\n    case \"close\":\n    case \"delete\":\n    case \"append\":\n    case \"claim\":\n    case \"release\":\n      return {\n        isMutation: true,\n        forceCapable: true,\n        forceRequested,\n      };\n    case \"comments\":\n    case \"notes\":\n    case \"learnings\":\n      return {\n        isMutation: typeof options.add === \"string\",\n        forceCapable: true,\n        forceRequested,\n      };\n    case \"files\":\n    case \"docs\":\n    case \"test\":\n      return {\n        isMutation: hasMutatingListValues(options.add) || hasMutatingListValues(options.remove),\n        forceCapable: true,\n        forceRequested,\n      };\n    default:\n      return {\n        isMutation: false,\n        forceCapable: false,\n        forceRequested: false,\n      };\n  }\n}\n\nexport function enforceMandatoryMigrationWriteGate(\n  commandPath: string,\n  options: Record<string, unknown>,\n  blockers: MandatoryMigrationBlocker[],\n): void {\n  if (blockers.length === 0) {\n    return;\n  }\n  const decision = decideWriteGate(commandPath, options);\n  if (!decision.isMutation) {\n    return;\n  }\n  if (decision.forceCapable && decision.forceRequested) {\n    return;\n  }\n  const codes = blockers.map(\n    (entry) => `extension_migration_blocking:${entry.layer}:${entry.name}:${entry.id}:${entry.status}`,\n  );\n  const forceGuidance = decision.forceCapable\n    ? \"Re-run this command with --force to bypass.\"\n    : \"This command path does not support --force bypass.\";\n  throw new PmCliError(\n    `Write command \"${commandPath}\" blocked by unresolved mandatory extension migrations (${codes.join(\",\")}). ${forceGuidance}`,\n    EXIT_CODE.CONFLICT,\n  );\n}\n\nexport async function enforceItemFormatWriteGateAndPreflightMigration(\n  commandPath: string,\n  options: Record<string, unknown>,\n  pmRoot: string,\n  decision: PreflightRuntimeDecision,\n): Promise<void> {\n  const writeGate = decideWriteGate(commandPath, options);\n  if (!writeGate.isMutation) {\n    return;\n  }\n  if (!decision.enforce_item_format_gate && !decision.run_preflight_item_format_sync) {\n    return;\n  }\n  if (!(await pathExists(getSettingsPath(pmRoot)))) {\n    return;\n  }\n  const { settings, metadata, warnings } = await readSettingsWithMetadata(pmRoot);\n  for (const warning of warnings) {\n    printError(`warning:${warning}`);\n  }\n  if (decision.enforce_item_format_gate && !metadata.has_explicit_item_format) {\n    await writeSettings(pmRoot, settings, \"item_format:auto_select_default\");\n  }\n  if (decision.run_preflight_item_format_sync) {\n    const typeRegistry = resolveItemTypeRegistry(settings, getActiveExtensionRegistrations());\n    await migrateItemFilesToFormat(\n      pmRoot,\n      settings.item_format,\n      \"item_format:pre_mutation_sync\",\n      typeRegistry.type_to_folder,\n      settings.schema,\n    );\n  }\n}\n"]}

package/dist/cli/register-list-query.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from "commander";
+export declare function registerListQueryCommands(program: Command): void;

package/dist/cli/register-list-query.js

@@ -0,0 +1,317 @@
+import { runAggregate, runActivity, runCalendar, runContext, runDedupeAudit, runGet, runHistory, runList, runReindex, runSearch, renderCalendarMarkdown, renderContextMarkdown, resolveCalendarOutputFormat, resolveContextOutputFormat, } from "./commands/index.js";
+import { EXIT_CODE } from "../core/shared/constants.js";
+import { PmCliError } from "../core/shared/errors.js";
+import { getGlobalOptions, normalizeAggregateOptions, normalizeActivityOptions, normalizeCalendarOptions, normalizeContextOptions, normalizeDedupeAuditOptions, normalizeListOptions, normalizeSearchKeywordsInput, normalizeSearchOptions, printActivityJsonStream, printError, printListJsonStream, printResult, resolveActivityStreamMode, writeStdout, } from "./registration-helpers.js";
+export function registerListQueryCommands(program) {
+    function registerListCommand(name, description, status, excludeTerminal, allowStatusFilter) {
+        const command = program.command(name).description(description);
+        if (allowStatusFilter) {
+            command.option("--status <value>", "Filter by status");
+        }
+        command
+            .option("--type <value>", "Filter by item type")
+            .option("--tag <value>", "Filter by tag")
+            .option("--priority <value>", "Filter by priority")
+            .option("--deadline-before <value>", "Filter by deadline upper bound (ISO/date string or relative)")
+            .option("--deadline-after <value>", "Filter by deadline lower bound (ISO/date string or relative)")
+            .option("--assignee <value>", "Filter by assignee")
+            .option("--assignee-filter <value>", "Filter assignee presence: assigned|unassigned")
+            .option("--assignee_filter <value>", "Alias for --assignee-filter")
+            .option("--parent <value>", "Filter by parent item ID")
+            .option("--sprint <value>", "Filter by sprint")
+            .option("--release <value>", "Filter by release")
+            .option("--limit <n>", "Limit returned item count")
+            .option("--offset <n>", "Skip the first n matching rows before limit is applied")
+            .option("--include-body", "Include item body in each returned list row")
+            .option("--compact", "Render compact list projection fields (mutually exclusive with --brief/--fields)")
+            .option("--brief", "Ultra-compact output: id, status, type, title only (agent-optimized, mutually exclusive with --compact/--fields)")
+            .option("--fields <value>", "Render custom comma-separated list fields (mutually exclusive with --compact/--brief; valid: --fields id,title)")
+            .option("--sort <value>", "Sort field: priority|deadline|updated_at|created_at|title|parent")
+            .option("--order <value>", "Sort order: asc|desc (requires --sort)")
+            .option("--stream", "Emit line-delimited JSON rows (requires --json)")
+            .action(async (options, actionCommand) => {
+            const globalOptions = getGlobalOptions(actionCommand);
+            const startedAt = Date.now();
+            const listOptions = normalizeListOptions(options);
+            if (excludeTerminal)
+                listOptions.excludeTerminal = true;
+            const result = await runList(status, listOptions, globalOptions);
+            const streamMode = options.stream === true;
+            if (streamMode && !globalOptions.json) {
+                throw new PmCliError("--stream requires --json output mode.", EXIT_CODE.USAGE);
+            }
+            if (streamMode) {
+                printListJsonStream(name, result, globalOptions);
+            }
+            else {
+                printResult(result, globalOptions);
+            }
+            if (globalOptions.profile) {
+                printError(`profile:command=${name} took_ms=${Date.now() - startedAt}`);
+            }
+        });
+    }
+    registerListCommand("list", "List active items with optional filters.", undefined, true, true);
+    registerListCommand("list-all", "List all items with optional filters.", undefined, false, true);
+    registerListCommand("list-draft", "List draft items with optional filters.", "draft");
+    registerListCommand("list-open", "List open items with optional filters.", "open");
+    registerListCommand("list-in-progress", "List in-progress items with optional filters.", "in_progress");
+    registerListCommand("list-blocked", "List blocked items with optional filters.", "blocked");
+    registerListCommand("list-closed", "List closed items with optional filters.", "closed");
+    registerListCommand("list-canceled", "List canceled items with optional filters.", "canceled");
+    program
+        .command("aggregate")
+        .description("Aggregate grouped item counts for governance queries.")
+        .option("--group-by <value>", "Comma-separated group-by fields (supported: parent,type,priority,status,assignee,tags,sprint,release)")
+        .option("--count", "Return grouped counts (default behavior)")
+        .option("--include-unparented", "Include unparented rows when grouping by parent")
+        .option("--include_unparented", "Alias for --include-unparented")
+        .option("--status <value>", "Filter by item status")
+        .option("--type <value>", "Filter by item type")
+        .option("--tag <value>", "Filter by tag")
+        .option("--priority <value>", "Filter by priority")
+        .option("--deadline-before <value>", "Filter by deadline upper bound (ISO/date string or relative)")
+        .option("--deadline-after <value>", "Filter by deadline lower bound (ISO/date string or relative)")
+        .option("--assignee <value>", "Filter by assignee")
+        .option("--assignee-filter <value>", "Filter assignee presence: assigned|unassigned")
+        .option("--assignee_filter <value>", "Alias for --assignee-filter")
+        .option("--parent <value>", "Filter by parent item ID")
+        .option("--sprint <value>", "Filter by sprint")
+        .option("--release <value>", "Filter by release")
+        .action(async (options, command) => {
+        const globalOptions = getGlobalOptions(command);
+        const startedAt = Date.now();
+        const result = await runAggregate(normalizeAggregateOptions(options), globalOptions);
+        printResult(result, globalOptions);
+        if (globalOptions.profile) {
+            printError(`profile:command=aggregate took_ms=${Date.now() - startedAt}`);
+        }
+    });
+    program
+        .command("dedupe-audit")
+        .description("Audit potential duplicate items with exact, fuzzy, or parent-scoped matching.")
+        .option("--mode <value>", "Dedupe mode: title_exact|title_fuzzy|parent_scope")
+        .option("--limit <n>", "Limit returned duplicate clusters")
+        .option("--threshold <value>", "Fuzzy mode token similarity threshold between 0 and 1")
+        .option("--status <value>", "Filter by item status")
+        .option("--type <value>", "Filter by item type")
+        .option("--tag <value>", "Filter by tag")
+        .option("--priority <value>", "Filter by priority")
+        .option("--deadline-before <value>", "Filter by deadline upper bound (ISO/date string or relative)")
+        .option("--deadline-after <value>", "Filter by deadline lower bound (ISO/date string or relative)")
+        .option("--assignee <value>", "Filter by assignee")
+        .option("--assignee-filter <value>", "Filter assignee presence: assigned|unassigned")
+        .option("--assignee_filter <value>", "Alias for --assignee-filter")
+        .option("--parent <value>", "Filter by parent item ID")
+        .option("--sprint <value>", "Filter by sprint")
+        .option("--release <value>", "Filter by release")
+        .action(async (options, command) => {
+        const globalOptions = getGlobalOptions(command);
+        const startedAt = Date.now();
+        const result = await runDedupeAudit(normalizeDedupeAuditOptions(options), globalOptions);
+        printResult(result, globalOptions);
+        if (globalOptions.profile) {
+            printError(`profile:command=dedupe-audit took_ms=${Date.now() - startedAt}`);
+        }
+    });
+    program
+        .command("calendar")
+        .alias("cal")
+        .description("Show deadline/reminder calendar views (agenda/day/week/month).")
+        .option("--view <value>", "Calendar view: agenda|day|week|month (default: agenda)")
+        .option("--date <value>", "Anchor date/time for view calculations (ISO/date string or relative)")
+        .option("--from <value>", "Agenda lower bound (ISO/date string or relative)")
+        .option("--to <value>", "Agenda upper bound (ISO/date string or relative)")
+        .option("--past", "Include past entries in the selected view")
+        .option("--full-period", "For day/week/month views, include the full anchored period without now-clipping")
+        .option("--full_period", "Alias for --full-period")
+        .option("--type <value>", "Filter by item type")
+        .option("--tag <value>", "Filter by tag")
+        .option("--priority <value>", "Filter by priority")
+        .option("--status <value>", "Filter by status")
+        .option("--assignee <value>", "Filter by assignee")
+        .option("--assignee-filter <value>", "Filter assignee presence: assigned|unassigned")
+        .option("--assignee_filter <value>", "Alias for --assignee-filter")
+        .option("--sprint <value>", "Filter by sprint")
+        .option("--release <value>", "Filter by release")
+        .option("--include <value>", "Include sources: deadlines|reminders|events|all (comma or | separated)")
+        .option("--recurrence-lookahead-days <n>", "Bound open-ended recurrence generation lookahead days")
+        .option("--recurrence_lookahead_days <n>", "Alias for --recurrence-lookahead-days")
+        .option("--recurrence-lookback-days <n>", "Bound open-ended recurrence generation lookback days")
+        .option("--recurrence_lookback_days <n>", "Alias for --recurrence-lookback-days")
+        .option("--occurrence-limit <n>", "Cap generated occurrences per recurring event")
+        .option("--occurrence_limit <n>", "Alias for --occurrence-limit")
+        .option("--limit <n>", "Limit returned event count")
+        .option("--format <value>", "Calendar output format override: markdown|toon|json")
+        .action(async (options, actionCommand) => {
+        const globalOptions = getGlobalOptions(actionCommand);
+        const startedAt = Date.now();
+        const normalized = normalizeCalendarOptions(options);
+        const result = await runCalendar(normalized, globalOptions);
+        const outputFormat = resolveCalendarOutputFormat(normalized, globalOptions);
+        if (outputFormat === "markdown") {
+            if (!globalOptions.quiet) {
+                writeStdout(`${renderCalendarMarkdown(result)}\n`);
+            }
+        }
+        else {
+            printResult(result, {
+                ...globalOptions,
+                json: outputFormat === "json",
+            });
+        }
+        if (globalOptions.profile) {
+            printError(`profile:command=calendar took_ms=${Date.now() - startedAt}`);
+        }
+    });
+    program
+        .command("context")
+        .alias("ctx")
+        .description("Show a token-efficient project context snapshot for next-work decisions.")
+        .option("--date <value>", "Anchor date/time for agenda window calculations (ISO/date string or relative)")
+        .option("--from <value>", "Agenda lower bound (ISO/date string or relative)")
+        .option("--to <value>", "Agenda upper bound (ISO/date string or relative)")
+        .option("--past", "Include past agenda entries in bounded windows")
+        .option("--type <value>", "Filter by item type")
+        .option("--tag <value>", "Filter by tag")
+        .option("--priority <value>", "Filter by priority")
+        .option("--assignee <value>", "Filter by assignee")
+        .option("--assignee-filter <value>", "Filter assignee presence: assigned|unassigned")
+        .option("--assignee_filter <value>", "Alias for --assignee-filter")
+        .option("--sprint <value>", "Filter by sprint")
+        .option("--release <value>", "Filter by release")
+        .option("--limit <n>", "Limit focus and agenda rows per section")
+        .option("--format <value>", "Context output format override: markdown|toon|json")
+        .option("--depth <value>", "Context depth: brief|standard|deep (default: settings or brief)")
+        .option("--section <value...>", "Include specific sections (repeatable; overrides --depth)")
+        .option("--activity-limit <n>", "Limit recent activity entries (default: settings or 10)")
+        .option("--stale-threshold <value>", "Staleness cutoff in days (e.g. 7 or 7d; default: settings or 7)")
+        .action(async (options, actionCommand) => {
+        const globalOptions = getGlobalOptions(actionCommand);
+        const startedAt = Date.now();
+        const normalized = normalizeContextOptions(options);
+        const result = await runContext(normalized, globalOptions);
+        const outputFormat = resolveContextOutputFormat(normalized, globalOptions);
+        if (outputFormat === "markdown") {
+            if (!globalOptions.quiet) {
+                writeStdout(`${renderContextMarkdown(result)}\n`);
+            }
+        }
+        else {
+            printResult(result, {
+                ...globalOptions,
+                json: outputFormat === "json",
+            });
+        }
+        if (globalOptions.profile) {
+            printError(`profile:command=context took_ms=${Date.now() - startedAt}`);
+        }
+    });
+    program
+        .command("search")
+        .argument("<keywords...>", "Keyword query tokens")
+        .description("Search items with keyword, semantic, or hybrid modes.")
+        .option("--mode <value>", "Search mode: keyword|semantic|hybrid (default: hybrid when semantic config or local Ollama auto-defaults are available, else keyword)")
+        .option("--include-linked", "Include readable linked docs/files/tests content in keyword and hybrid lexical scoring")
+        .option("--title-exact", "Require exact normalized title match against the full query")
+        .option("--phrase-exact", "Require exact normalized query phrase match in item text fields")
+        .option("--type <value>", "Filter by item type")
+        .option("--tag <value>", "Filter by tag")
+        .option("--priority <value>", "Filter by priority")
+        .option("--deadline-before <value>", "Filter by deadline upper bound (ISO/date string or relative)")
+        .option("--deadline-after <value>", "Filter by deadline lower bound (ISO/date string or relative)")
+        .option("--compact", "Render compact search hits (default; mutually exclusive with --full/--fields)")
+        .option("--full", "Render full search hits with nested item payloads (mutually exclusive with --compact/--fields)")
+        .option("--fields <value>", "Render custom comma-separated search hit fields (mutually exclusive with --compact/--full; valid: --fields id,title,score; invalid: --full --fields id,title)")
+        .option("--limit <n>", "Limit returned item count")
+        .action(async (keywords, options, command) => {
+        const globalOptions = getGlobalOptions(command);
+        const startedAt = Date.now();
+        const result = await runSearch(normalizeSearchKeywordsInput(keywords), normalizeSearchOptions(options), globalOptions);
+        printResult(result, globalOptions);
+        if (globalOptions.profile) {
+            printError(`profile:command=search took_ms=${Date.now() - startedAt}`);
+        }
+    });
+    program
+        .command("reindex")
+        .description("Rebuild search artifacts for keyword, semantic, and hybrid modes.")
+        .option("--mode <value>", "Reindex mode: keyword|semantic|hybrid", "keyword")
+        .option("--progress", "Emit progress updates to stderr (always shown in TTY, opt-in for non-TTY)")
+        .action(async (options, command) => {
+        const globalOptions = getGlobalOptions(command);
+        const startedAt = Date.now();
+        const result = await runReindex({
+            mode: typeof options.mode === "string" ? options.mode : undefined,
+            progress: Boolean(options.progress),
+        }, globalOptions);
+        printResult(result, globalOptions);
+        if (globalOptions.profile) {
+            printError(`profile:command=reindex took_ms=${Date.now() - startedAt}`);
+        }
+    });
+    program
+        .command("get")
+        .argument("<id>", "Item id")
+        .description("Show item details by ID.")
+        .action(async (id, _options, command) => {
+        const globalOptions = getGlobalOptions(command);
+        const startedAt = Date.now();
+        const result = await runGet(id, globalOptions);
+        printResult(result, globalOptions);
+        if (globalOptions.profile) {
+            printError(`profile:command=get took_ms=${Date.now() - startedAt}`);
+        }
+    });
+    program
+        .command("history")
+        .argument("<id>", "Item id")
+        .option("--limit <n>", "Return only the latest n history entries")
+        .option("--diff", "Include per-entry changed field summaries from history patches")
+        .option("--verify", "Verify hash chain and replay integrity for the full history stream")
+        .description("Show item history entries.")
+        .action(async (id, options, command) => {
+        const globalOptions = getGlobalOptions(command);
+        const startedAt = Date.now();
+        const result = await runHistory(id, {
+            limit: typeof options.limit === "string" ? options.limit : undefined,
+            diff: Boolean(options.diff),
+            verify: Boolean(options.verify),
+        }, globalOptions);
+        printResult(result, globalOptions);
+        if (globalOptions.profile) {
+            printError(`profile:command=history took_ms=${Date.now() - startedAt}`);
+        }
+    });
+    program
+        .command("activity")
+        .option("--id <value>", "Filter by item ID")
+        .option("--op <value>", "Filter by history operation")
+        .option("--author <value>", "Filter by history author")
+        .option("--from <value>", "Lower timestamp bound (ISO/date string or relative)")
+        .option("--to <value>", "Upper timestamp bound (ISO/date string or relative)")
+        .option("--limit <n>", "Return only the latest n activity entries")
+        .option("--compact", "Condensed output: show only id, op, ts, author, msg per entry")
+        .option("--stream [mode]", "Emit line-delimited JSON rows (requires --json). Optional mode: rows|ndjson|jsonl")
+        .description("Show recent activity across items.")
+        .action(async (options, command) => {
+        const globalOptions = getGlobalOptions(command);
+        const startedAt = Date.now();
+        const normalized = normalizeActivityOptions(options);
+        const result = await runActivity(normalized, globalOptions);
+        const streamMode = resolveActivityStreamMode(options.stream);
+        if (streamMode && !globalOptions.json) {
+            throw new PmCliError("--stream requires --json output mode.", EXIT_CODE.USAGE);
+        }
+        if (streamMode) {
+            printActivityJsonStream(result, normalized, globalOptions);
+        }
+        else {
+            printResult(result, globalOptions);
+        }
+        if (globalOptions.profile) {
+            printError(`profile:command=activity took_ms=${Date.now() - startedAt}`);
+        }
+    });
+}
+//# sourceMappingURL=register-list-query.js.map

package/dist/cli/register-list-query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-list-query.js","sourceRoot":"/","sources":["cli/register-list-query.ts"],"names":[],"mappings":"AACA,OAAO,EACL,YAAY,EACZ,WAAW,EACX,WAAW,EACX,UAAU,EACV,cAAc,EACd,MAAM,EACN,UAAU,EACV,OAAO,EACP,UAAU,EACV,SAAS,EACT,sBAAsB,EACtB,qBAAqB,EACrB,2BAA2B,EAC3B,0BAA0B,GAC3B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAEtD,OAAO,EACL,gBAAgB,EAChB,yBAAyB,EACzB,wBAAwB,EACxB,wBAAwB,EACxB,uBAAuB,EACvB,2BAA2B,EAC3B,oBAAoB,EACpB,4BAA4B,EAC5B,sBAAsB,EACtB,uBAAuB,EACvB,UAAU,EACV,mBAAmB,EACnB,WAAW,EACX,yBAAyB,EACzB,WAAW,GACZ,MAAM,2BAA2B,CAAC;AAEnC,MAAM,UAAU,yBAAyB,CAAC,OAAgB;IACxD,SAAS,mBAAmB,CAC1B,IAAY,EACZ,WAAmB,EACnB,MAAmB,EACnB,eAAyB,EACzB,iBAA2B;QAE3B,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;QAC/D,IAAI,iBAAiB,EAAE,CAAC;YACtB,OAAO,CAAC,MAAM,CAAC,kBAAkB,EAAE,kBAAkB,CAAC,CAAC;QACzD,CAAC;QACD,OAAO;aACJ,MAAM,CAAC,gBAAgB,EAAE,qBAAqB,CAAC;aAC/C,MAAM,CAAC,eAAe,EAAE,eAAe,CAAC;aACxC,MAAM,CAAC,oBAAoB,EAAE,oBAAoB,CAAC;aAClD,MAAM,CAAC,2BAA2B,EAAE,8DAA8D,CAAC;aACnG,MAAM,CAAC,0BAA0B,EAAE,8DAA8D,CAAC;aAClG,MAAM,CAAC,oBAAoB,EAAE,oBAAoB,CAAC;aAClD,MAAM,CAAC,2BAA2B,EAAE,+CAA+C,CAAC;aACpF,MAAM,CAAC,2BAA2B,EAAE,6BAA6B,CAAC;aAClE,MAAM,CAAC,kBAAkB,EAAE,0BAA0B,CAAC;aACtD,MAAM,CAAC,kBAAkB,EAAE,kBAAkB,CAAC;aAC9C,MAAM,CAAC,mBAAmB,EAAE,mBAAmB,CAAC;aAChD,MAAM,CAAC,aAAa,EAAE,2BAA2B,CAAC;aAClD,MAAM,CAAC,cAAc,EAAE,wDAAwD,CAAC;aAChF,MAAM,CAAC,gBAAgB,EAAE,6CAA6C,CAAC;aACvE,MAAM,CAAC,WAAW,EAAE,kFAAkF,CAAC;aACvG,MAAM,CAAC,SAAS,EAAE,kHAAkH,CAAC;aACrI,MAAM,CACL,kBAAkB,EAClB,iHAAiH,CAClH;aACA,MAAM,CAAC,gBAAgB,EAAE,kEAAkE,CAAC;aAC5F,MAAM,CAAC,iBAAiB,EAAE,wCAAwC,CAAC;aACnE,MAAM,CAAC,UAAU,EAAE,iDAAiD,CAAC;aACrE,MAAM,CAAC,KAAK,EAAE,OAAgC,EAAE,aAAa,EAAE,EAAE;YAChE,MAAM,aAAa,GAAG,gBAAgB,CAAC,aAAa,CAAC,CAAC;YACtD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAC7B,MAAM,WAAW,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;YAClD,IAAI,eAAe;gBAAE,WAAW,CAAC,eAAe,GAAG,IAAI,CAAC;YACxD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,aAAa,CAAC,CAAC;YACjE,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,KAAK,IAAI,CAAC;YAC3C,IAAI,UAAU,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC;gBACtC,MAAM,IAAI,UAAU,CAAC,uCAAuC,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC;YACjF,CAAC;YACD,IAAI,UAAU,EAAE,CAAC;gBACf,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,CAAC,CAAC;YACnD,CAAC;iBAAM,CAAC;gBACN,WAAW,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;YACrC,CAAC;YACD,IAAI,aAAa,CAAC,OAAO,EAAE,CAAC;gBAC1B,UAAU,CAAC,mBAAmB,IAAI,YAAY,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,EAAE,CAAC,CAAC;YAC1E,CAAC;QACH,CAAC,CAAC,CAAC;IACP,CAAC;IAED,mBAAmB,CAAC,MAAM,EAAE,0CAA0C,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAC/F,mBAAmB,CAAC,UAAU,EAAE,uCAAuC,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;IACjG,mBAAmB,CAAC,YAAY,EAAE,yCAAyC,EAAE,OAAO,CAAC,CAAC;IACtF,mBAAmB,CAAC,WAAW,EAAE,wCAAwC,EAAE,MAAM,CAAC,CAAC;IACnF,mBAAmB,CAAC,kBAAkB,EAAE,+CAA+C,EAAE,aAAa,CAAC,CAAC;IACxG,mBAAmB,CAAC,cAAc,EAAE,2CAA2C,EAAE,SAAS,CAAC,CAAC;IAC5F,mBAAmB,CAAC,aAAa,EAAE,0CAA0C,EAAE,QAAQ,CAAC,CAAC;IACzF,mBAAmB,CAAC,eAAe,EAAE,4CAA4C,EAAE,UAAU,CAAC,CAAC;IAE/F,OAAO;SACJ,OAAO,CAAC,WAAW,CAAC;SACpB,WAAW,CAAC,uDAAuD,CAAC;SACpE,MAAM,CACL,oBAAoB,EACpB,uGAAuG,CACxG;SACA,MAAM,CAAC,SAAS,EAAE,0CAA0C,CAAC;SAC7D,MAAM,CAAC,sBAAsB,EAAE,iDAAiD,CAAC;SACjF,MAAM,CAAC,sBAAsB,EAAE,gCAAgC,CAAC;SAChE,MAAM,CAAC,kBAAkB,EAAE,uBAAuB,CAAC;SACnD,MAAM,CAAC,gBAAgB,EAAE,qBAAqB,CAAC;SAC/C,MAAM,CAAC,eAAe,EAAE,eAAe,CAAC;SACxC,MAAM,CAAC,oBAAoB,EAAE,oBAAoB,CAAC;SAClD,MAAM,CAAC,2BAA2B,EAAE,8DAA8D,CAAC;SACnG,MAAM,CAAC,0BAA0B,EAAE,8DAA8D,CAAC;SAClG,MAAM,CAAC,oBAAoB,EAAE,oBAAoB,CAAC;SAClD,MAAM,CAAC,2BAA2B,EAAE,+CAA+C,CAAC;SACpF,MAAM,CAAC,2BAA2B,EAAE,6BAA6B,CAAC;SAClE,MAAM,CAAC,kBAAkB,EAAE,0BAA0B,CAAC;SACtD,MAAM,CAAC,kBAAkB,EAAE,kBAAkB,CAAC;SAC9C,MAAM,CAAC,mBAAmB,EAAE,mBAAmB,CAAC;SAChD,MAAM,CAAC,KAAK,EAAE,OAAgC,EAAE,OAAO,EAAE,EAAE;QAC1D,MAAM,aAAa,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;QAChD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,yBAAyB,CAAC,OAAO,CAAC,EAAE,aAAa,CAAC,CAAC;QACrF,WAAW,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;QACnC,IAAI,aAAa,CAAC,OAAO,EAAE,CAAC;YAC1B,UAAU,CAAC,qCAAqC,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,EAAE,CAAC,CAAC;QAC5E,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,OAAO;SACJ,OAAO,CAAC,cAAc,CAAC;SACvB,WAAW,CAAC,+EAA+E,CAAC;SAC5F,MAAM,CAAC,gBAAgB,EAAE,mDAAmD,CAAC;SAC7E,MAAM,CAAC,aAAa,EAAE,mCAAmC,CAAC;SAC1D,MAAM,CAAC,qBAAqB,EAAE,uDAAuD,CAAC;SACtF,MAAM,CAAC,kBAAkB,EAAE,uBAAuB,CAAC;SACnD,MAAM,CAAC,gBAAgB,EAAE,qBAAqB,CAAC;SAC/C,MAAM,CAAC,eAAe,EAAE,eAAe,CAAC;SACxC,MAAM,CAAC,oBAAoB,EAAE,oBAAoB,CAAC;SAClD,MAAM,CAAC,2BAA2B,EAAE,8DAA8D,CAAC;SACnG,MAAM,CAAC,0BAA0B,EAAE,8DAA8D,CAAC;SAClG,MAAM,CAAC,oBAAoB,EAAE,oBAAoB,CAAC;SAClD,MAAM,CAAC,2BAA2B,EAAE,+CAA+C,CAAC;SACpF,MAAM,CAAC,2BAA2B,EAAE,6BAA6B,CAAC;SAClE,MAAM,CAAC,kBAAkB,EAAE,0BAA0B,CAAC;SACtD,MAAM,CAAC,kBAAkB,EAAE,kBAAkB,CAAC;SAC9C,MAAM,CAAC,mBAAmB,EAAE,mBAAmB,CAAC;SAChD,MAAM,CAAC,KAAK,EAAE,OAAgC,EAAE,OAAO,EAAE,EAAE;QAC1D,MAAM,aAAa,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;QAChD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,2BAA2B,CAAC,OAAO,CAAC,EAAE,aAAa,CAAC,CAAC;QACzF,WAAW,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;QACnC,IAAI,aAAa,CAAC,OAAO,EAAE,CAAC;YAC1B,UAAU,CAAC,wCAAwC,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,EAAE,CAAC,CAAC;QAC/E,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,OAAO;SACJ,OAAO,CAAC,UAAU,CAAC;SACnB,KAAK,CAAC,KAAK,CAAC;SACZ,WAAW,CAAC,gEAAgE,CAAC;SAC7E,MAAM,CAAC,gBAAgB,EAAE,wDAAwD,CAAC;SAClF,MAAM,CAAC,gBAAgB,EAAE,sEAAsE,CAAC;SAChG,MAAM,CAAC,gBAAgB,EAAE,kDAAkD,CAAC;SAC5E,MAAM,CAAC,cAAc,EAAE,kDAAkD,CAAC;SAC1E,MAAM,CAAC,QAAQ,EAAE,2CAA2C,CAAC;SAC7D,MAAM,CAAC,eAAe,EAAE,iFAAiF,CAAC;SAC1G,MAAM,CAAC,eAAe,EAAE,yBAAyB,CAAC;SAClD,MAAM,CAAC,gBAAgB,EAAE,qBAAqB,CAAC;SAC/C,MAAM,CAAC,eAAe,EAAE,eAAe,CAAC;SACxC,MAAM,CAAC,oBAAoB,EAAE,oBAAoB,CAAC;SAClD,MAAM,CAAC,kBAAkB,EAAE,kBAAkB,CAAC;SAC9C,MAAM,CAAC,oBAAoB,EAAE,oBAAoB,CAAC;SAClD,MAAM,CAAC,2BAA2B,EAAE,+CAA+C,CAAC;SACpF,MAAM,CAAC,2BAA2B,EAAE,6BAA6B,CAAC;SAClE,MAAM,CAAC,kBAAkB,EAAE,kBAAkB,CAAC;SAC9C,MAAM,CAAC,mBAAmB,EAAE,mBAAmB,CAAC;SAChD,MAAM,CAAC,mBAAmB,EAAE,wEAAwE,CAAC;SACrG,MAAM,CAAC,iCAAiC,EAAE,uDAAuD,CAAC;SAClG,MAAM,CAAC,iCAAiC,EAAE,uCAAuC,CAAC;SAClF,MAAM,CAAC,gCAAgC,EAAE,sDAAsD,CAAC;SAChG,MAAM,CAAC,gCAAgC,EAAE,sCAAsC,CAAC;SAChF,MAAM,CAAC,wBAAwB,EAAE,+CAA+C,CAAC;SACjF,MAAM,CAAC,wBAAwB,EAAE,8BAA8B,CAAC;SAChE,MAAM,CAAC,aAAa,EAAE,4BAA4B,CAAC;SACnD,MAAM,CAAC,kBAAkB,EAAE,qDAAqD,CAAC;SACjF,MAAM,CAAC,KAAK,EAAE,OAAgC,EAAE,aAAa,EAAE,EAAE;QAChE,MAAM,aAAa,GAAG,gBAAgB,CAAC,aAAa,CAAC,CAAC;QACtD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,MAAM,UAAU,GAAG,wBAAwB,CAAC,OAAO,CAAC,CAAC;QACrD,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;QAC5D,MAAM,YAAY,GAAG,2BAA2B,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;QAC5E,IAAI,YAAY,KAAK,UAAU,EAAE,CAAC;YAChC,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,CAAC;gBACzB,WAAW,CAAC,GAAG,sBAAsB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACrD,CAAC;QACH,CAAC;aAAM,CAAC;YACN,WAAW,CAAC,MAAM,EAAE;gBAClB,GAAG,aAAa;gBAChB,IAAI,EAAE,YAAY,KAAK,MAAM;aAC9B,CAAC,CAAC;QACL,CAAC;QACD,IAAI,aAAa,CAAC,OAAO,EAAE,CAAC;YAC1B,UAAU,CAAC,oCAAoC,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,EAAE,CAAC,CAAC;QAC3E,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,OAAO;SACJ,OAAO,CAAC,SAAS,CAAC;SAClB,KAAK,CAAC,KAAK,CAAC;SACZ,WAAW,CAAC,0EAA0E,CAAC;SACvF,MAAM,CAAC,gBAAgB,EAAE,+EAA+E,CAAC;SACzG,MAAM,CAAC,gBAAgB,EAAE,kDAAkD,CAAC;SAC5E,MAAM,CAAC,cAAc,EAAE,kDAAkD,CAAC;SAC1E,MAAM,CAAC,QAAQ,EAAE,gDAAgD,CAAC;SAClE,MAAM,CAAC,gBAAgB,EAAE,qBAAqB,CAAC;SAC/C,MAAM,CAAC,eAAe,EAAE,eAAe,CAAC;SACxC,MAAM,CAAC,oBAAoB,EAAE,oBAAoB,CAAC;SAClD,MAAM,CAAC,oBAAoB,EAAE,oBAAoB,CAAC;SAClD,MAAM,CAAC,2BAA2B,EAAE,+CAA+C,CAAC;SACpF,MAAM,CAAC,2BAA2B,EAAE,6BAA6B,CAAC;SAClE,MAAM,CAAC,kBAAkB,EAAE,kBAAkB,CAAC;SAC9C,MAAM,CAAC,mBAAmB,EAAE,mBAAmB,CAAC;SAChD,MAAM,CAAC,aAAa,EAAE,yCAAyC,CAAC;SAChE,MAAM,CAAC,kBAAkB,EAAE,oDAAoD,CAAC;SAChF,MAAM,CAAC,iBAAiB,EAAE,iEAAiE,CAAC;SAC5F,MAAM,CAAC,sBAAsB,EAAE,2DAA2D,CAAC;SAC3F,MAAM,CAAC,sBAAsB,EAAE,yDAAyD,CAAC;SACzF,MAAM,CAAC,2BAA2B,EAAE,iEAAiE,CAAC;SACtG,MAAM,CAAC,KAAK,EAAE,OAAgC,EAAE,aAAa,EAAE,EAAE;QAChE,MAAM,aAAa,GAAG,gBAAgB,CAAC,aAAa,CAAC,CAAC;QACtD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,MAAM,UAAU,GAAG,uBAAuB,CAAC,OAAO,CAAC,CAAC;QACpD,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;QAC3D,MAAM,YAAY,GAAG,0BAA0B,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;QAC3E,IAAI,YAAY,KAAK,UAAU,EAAE,CAAC;YAChC,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,CAAC;gBACzB,WAAW,CAAC,GAAG,qBAAqB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACpD,CAAC;QACH,CAAC;aAAM,CAAC;YACN,WAAW,CAAC,MAAM,EAAE;gBAClB,GAAG,aAAa;gBAChB,IAAI,EAAE,YAAY,KAAK,MAAM;aAC9B,CAAC,CAAC;QACL,CAAC;QACD,IAAI,aAAa,CAAC,OAAO,EAAE,CAAC;YAC1B,UAAU,CAAC,mCAAmC,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,EAAE,CAAC,CAAC;QAC1E,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,OAAO;SACJ,OAAO,CAAC,QAAQ,CAAC;SACjB,QAAQ,CAAC,eAAe,EAAE,sBAAsB,CAAC;SACjD,WAAW,CAAC,uDAAuD,CAAC;SACpE,MAAM,CACL,gBAAgB,EAChB,uIAAuI,CACxI;SACA,MAAM,CAAC,kBAAkB,EAAE,wFAAwF,CAAC;SACpH,MAAM,CAAC,eAAe,EAAE,6DAA6D,CAAC;SACtF,MAAM,CAAC,gBAAgB,EAAE,iEAAiE,CAAC;SAC3F,MAAM,CAAC,gBAAgB,EAAE,qBAAqB,CAAC;SAC/C,MAAM,CAAC,eAAe,EAAE,eAAe,CAAC;SACxC,MAAM,CAAC,oBAAoB,EAAE,oBAAoB,CAAC;SAClD,MAAM,CAAC,2BAA2B,EAAE,8DAA8D,CAAC;SACnG,MAAM,CAAC,0BAA0B,EAAE,8DAA8D,CAAC;SAClG,MAAM,CAAC,WAAW,EAAE,+EAA+E,CAAC;SACpG,MAAM,CAAC,QAAQ,EAAE,gGAAgG,CAAC;SAClH,MAAM,CACL,kBAAkB,EAClB,+JAA+J,CAChK;SACA,MAAM,CAAC,aAAa,EAAE,2BAA2B,CAAC;SAClD,MAAM,CAAC,KAAK,EAAE,QAAkB,EAAE,OAAgC,EAAE,OAAO,EAAE,EAAE;QAC9E,MAAM,aAAa,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;QAChD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,4BAA4B,CAAC,QAAQ,CAAC,EAAE,sBAAsB,CAAC,OAAO,CAAC,EAAE,aAAa,CAAC,CAAC;QACvH,WAAW,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;QACnC,IAAI,aAAa,CAAC,OAAO,EAAE,CAAC;YAC1B,UAAU,CAAC,kCAAkC,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,EAAE,CAAC,CAAC;QACzE,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,OAAO;SACJ,OAAO,CAAC,SAAS,CAAC;SAClB,WAAW,CAAC,mEAAmE,CAAC;SAChF,MAAM,CAAC,gBAAgB,EAAE,uCAAuC,EAAE,SAAS,CAAC;SAC5E,MAAM,CAAC,YAAY,EAAE,2EAA2E,CAAC;SACjG,MAAM,CAAC,KAAK,EAAE,OAAgC,EAAE,OAAO,EAAE,EAAE;QAC1D,MAAM,aAAa,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;QAChD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,MAAM,MAAM,GAAG,MAAM,UAAU,CAC7B;YACE,IAAI,EAAE,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;YACjE,QAAQ,EAAE,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC;SACpC,EACD,aAAa,CACd,CAAC;QACF,WAAW,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;QACnC,IAAI,aAAa,CAAC,OAAO,EAAE,CAAC;YAC1B,UAAU,CAAC,mCAAmC,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,EAAE,CAAC,CAAC;QAC1E,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,OAAO;SACJ,OAAO,CAAC,KAAK,CAAC;SACd,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;SAC3B,WAAW,CAAC,0BAA0B,CAAC;SACvC,MAAM,CAAC,KAAK,EAAE,EAAU,EAAE,QAAiB,EAAE,OAAO,EAAE,EAAE;QACvD,MAAM,aAAa,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;QAChD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,EAAE,EAAE,aAAa,CAAC,CAAC;QAC/C,WAAW,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;QACnC,IAAI,aAAa,CAAC,OAAO,EAAE,CAAC;YAC1B,UAAU,CAAC,+BAA+B,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,EAAE,CAAC,CAAC;QACtE,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,OAAO;SACJ,OAAO,CAAC,SAAS,CAAC;SAClB,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;SAC3B,MAAM,CAAC,aAAa,EAAE,0CAA0C,CAAC;SACjE,MAAM,CAAC,QAAQ,EAAE,gEAAgE,CAAC;SAClF,MAAM,CAAC,UAAU,EAAE,oEAAoE,CAAC;SACxF,WAAW,CAAC,4BAA4B,CAAC;SACzC,MAAM,CAAC,KAAK,EAAE,EAAU,EAAE,OAAgC,EAAE,OAAO,EAAE,EAAE;QACtE,MAAM,aAAa,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;QAChD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,MAAM,MAAM,GAAG,MAAM,UAAU,CAC7B,EAAE,EACF;YACE,KAAK,EAAE,OAAO,OAAO,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;YACpE,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC;YAC3B,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC;SAChC,EACD,aAAa,CACd,CAAC;QACF,WAAW,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;QACnC,IAAI,aAAa,CAAC,OAAO,EAAE,CAAC;YAC1B,UAAU,CAAC,mCAAmC,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,EAAE,CAAC,CAAC;QAC1E,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,OAAO;SACJ,OAAO,CAAC,UAAU,CAAC;SACnB,MAAM,CAAC,cAAc,EAAE,mBAAmB,CAAC;SAC3C,MAAM,CAAC,cAAc,EAAE,6BAA6B,CAAC;SACrD,MAAM,CAAC,kBAAkB,EAAE,0BAA0B,CAAC;SACtD,MAAM,CAAC,gBAAgB,EAAE,qDAAqD,CAAC;SAC/E,MAAM,CAAC,cAAc,EAAE,qDAAqD,CAAC;SAC7E,MAAM,CAAC,aAAa,EAAE,2CAA2C,CAAC;SAClE,MAAM,CAAC,WAAW,EAAE,+DAA+D,CAAC;SACpF,MAAM,CAAC,iBAAiB,EAAE,mFAAmF,CAAC;SAC9G,WAAW,CAAC,oCAAoC,CAAC;SACjD,MAAM,CAAC,KAAK,EAAE,OAAgC,EAAE,OAAO,EAAE,EAAE;QAC1D,MAAM,aAAa,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;QAChD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,MAAM,UAAU,GAAG,wBAAwB,CAAC,OAAO,CAAC,CAAC;QACrD,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;QAC5D,MAAM,UAAU,GAAG,yBAAyB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAC7D,IAAI,UAAU,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC;YACtC,MAAM,IAAI,UAAU,CAAC,uCAAuC,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC;QACjF,CAAC;QACD,IAAI,UAAU,EAAE,CAAC;YACf,uBAAuB,CAAC,MAAM,EAAE,UAAU,EAAE,aAAa,CAAC,CAAC;QAC7D,CAAC;aAAM,CAAC;YACN,WAAW,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;QACrC,CAAC;QACD,IAAI,aAAa,CAAC,OAAO,EAAE,CAAC;YAC1B,UAAU,CAAC,oCAAoC,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,EAAE,CAAC,CAAC;QAC3E,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC","sourcesContent":["import type { Command } from \"commander\";\nimport {\n  runAggregate,\n  runActivity,\n  runCalendar,\n  runContext,\n  runDedupeAudit,\n  runGet,\n  runHistory,\n  runList,\n  runReindex,\n  runSearch,\n  renderCalendarMarkdown,\n  renderContextMarkdown,\n  resolveCalendarOutputFormat,\n  resolveContextOutputFormat,\n} from \"./commands/index.js\";\nimport { EXIT_CODE } from \"../core/shared/constants.js\";\nimport { PmCliError } from \"../core/shared/errors.js\";\nimport type { ItemStatus } from \"../types/index.js\";\nimport {\n  getGlobalOptions,\n  normalizeAggregateOptions,\n  normalizeActivityOptions,\n  normalizeCalendarOptions,\n  normalizeContextOptions,\n  normalizeDedupeAuditOptions,\n  normalizeListOptions,\n  normalizeSearchKeywordsInput,\n  normalizeSearchOptions,\n  printActivityJsonStream,\n  printError,\n  printListJsonStream,\n  printResult,\n  resolveActivityStreamMode,\n  writeStdout,\n} from \"./registration-helpers.js\";\n\nexport function registerListQueryCommands(program: Command): void {\n  function registerListCommand(\n    name: string,\n    description: string,\n    status?: ItemStatus,\n    excludeTerminal?: boolean,\n    allowStatusFilter?: boolean,\n  ): void {\n    const command = program.command(name).description(description);\n    if (allowStatusFilter) {\n      command.option(\"--status <value>\", \"Filter by status\");\n    }\n    command\n      .option(\"--type <value>\", \"Filter by item type\")\n      .option(\"--tag <value>\", \"Filter by tag\")\n      .option(\"--priority <value>\", \"Filter by priority\")\n      .option(\"--deadline-before <value>\", \"Filter by deadline upper bound (ISO/date string or relative)\")\n      .option(\"--deadline-after <value>\", \"Filter by deadline lower bound (ISO/date string or relative)\")\n      .option(\"--assignee <value>\", \"Filter by assignee\")\n      .option(\"--assignee-filter <value>\", \"Filter assignee presence: assigned|unassigned\")\n      .option(\"--assignee_filter <value>\", \"Alias for --assignee-filter\")\n      .option(\"--parent <value>\", \"Filter by parent item ID\")\n      .option(\"--sprint <value>\", \"Filter by sprint\")\n      .option(\"--release <value>\", \"Filter by release\")\n      .option(\"--limit <n>\", \"Limit returned item count\")\n      .option(\"--offset <n>\", \"Skip the first n matching rows before limit is applied\")\n      .option(\"--include-body\", \"Include item body in each returned list row\")\n      .option(\"--compact\", \"Render compact list projection fields (mutually exclusive with --brief/--fields)\")\n      .option(\"--brief\", \"Ultra-compact output: id, status, type, title only (agent-optimized, mutually exclusive with --compact/--fields)\")\n      .option(\n        \"--fields <value>\",\n        \"Render custom comma-separated list fields (mutually exclusive with --compact/--brief; valid: --fields id,title)\",\n      )\n      .option(\"--sort <value>\", \"Sort field: priority|deadline|updated_at|created_at|title|parent\")\n      .option(\"--order <value>\", \"Sort order: asc|desc (requires --sort)\")\n      .option(\"--stream\", \"Emit line-delimited JSON rows (requires --json)\")\n      .action(async (options: Record<string, unknown>, actionCommand) => {\n        const globalOptions = getGlobalOptions(actionCommand);\n        const startedAt = Date.now();\n        const listOptions = normalizeListOptions(options);\n        if (excludeTerminal) listOptions.excludeTerminal = true;\n        const result = await runList(status, listOptions, globalOptions);\n        const streamMode = options.stream === true;\n        if (streamMode && !globalOptions.json) {\n          throw new PmCliError(\"--stream requires --json output mode.\", EXIT_CODE.USAGE);\n        }\n        if (streamMode) {\n          printListJsonStream(name, result, globalOptions);\n        } else {\n          printResult(result, globalOptions);\n        }\n        if (globalOptions.profile) {\n          printError(`profile:command=${name} took_ms=${Date.now() - startedAt}`);\n        }\n      });\n  }\n\n  registerListCommand(\"list\", \"List active items with optional filters.\", undefined, true, true);\n  registerListCommand(\"list-all\", \"List all items with optional filters.\", undefined, false, true);\n  registerListCommand(\"list-draft\", \"List draft items with optional filters.\", \"draft\");\n  registerListCommand(\"list-open\", \"List open items with optional filters.\", \"open\");\n  registerListCommand(\"list-in-progress\", \"List in-progress items with optional filters.\", \"in_progress\");\n  registerListCommand(\"list-blocked\", \"List blocked items with optional filters.\", \"blocked\");\n  registerListCommand(\"list-closed\", \"List closed items with optional filters.\", \"closed\");\n  registerListCommand(\"list-canceled\", \"List canceled items with optional filters.\", \"canceled\");\n\n  program\n    .command(\"aggregate\")\n    .description(\"Aggregate grouped item counts for governance queries.\")\n    .option(\n      \"--group-by <value>\",\n      \"Comma-separated group-by fields (supported: parent,type,priority,status,assignee,tags,sprint,release)\",\n    )\n    .option(\"--count\", \"Return grouped counts (default behavior)\")\n    .option(\"--include-unparented\", \"Include unparented rows when grouping by parent\")\n    .option(\"--include_unparented\", \"Alias for --include-unparented\")\n    .option(\"--status <value>\", \"Filter by item status\")\n    .option(\"--type <value>\", \"Filter by item type\")\n    .option(\"--tag <value>\", \"Filter by tag\")\n    .option(\"--priority <value>\", \"Filter by priority\")\n    .option(\"--deadline-before <value>\", \"Filter by deadline upper bound (ISO/date string or relative)\")\n    .option(\"--deadline-after <value>\", \"Filter by deadline lower bound (ISO/date string or relative)\")\n    .option(\"--assignee <value>\", \"Filter by assignee\")\n    .option(\"--assignee-filter <value>\", \"Filter assignee presence: assigned|unassigned\")\n    .option(\"--assignee_filter <value>\", \"Alias for --assignee-filter\")\n    .option(\"--parent <value>\", \"Filter by parent item ID\")\n    .option(\"--sprint <value>\", \"Filter by sprint\")\n    .option(\"--release <value>\", \"Filter by release\")\n    .action(async (options: Record<string, unknown>, command) => {\n      const globalOptions = getGlobalOptions(command);\n      const startedAt = Date.now();\n      const result = await runAggregate(normalizeAggregateOptions(options), globalOptions);\n      printResult(result, globalOptions);\n      if (globalOptions.profile) {\n        printError(`profile:command=aggregate took_ms=${Date.now() - startedAt}`);\n      }\n    });\n\n  program\n    .command(\"dedupe-audit\")\n    .description(\"Audit potential duplicate items with exact, fuzzy, or parent-scoped matching.\")\n    .option(\"--mode <value>\", \"Dedupe mode: title_exact|title_fuzzy|parent_scope\")\n    .option(\"--limit <n>\", \"Limit returned duplicate clusters\")\n    .option(\"--threshold <value>\", \"Fuzzy mode token similarity threshold between 0 and 1\")\n    .option(\"--status <value>\", \"Filter by item status\")\n    .option(\"--type <value>\", \"Filter by item type\")\n    .option(\"--tag <value>\", \"Filter by tag\")\n    .option(\"--priority <value>\", \"Filter by priority\")\n    .option(\"--deadline-before <value>\", \"Filter by deadline upper bound (ISO/date string or relative)\")\n    .option(\"--deadline-after <value>\", \"Filter by deadline lower bound (ISO/date string or relative)\")\n    .option(\"--assignee <value>\", \"Filter by assignee\")\n    .option(\"--assignee-filter <value>\", \"Filter assignee presence: assigned|unassigned\")\n    .option(\"--assignee_filter <value>\", \"Alias for --assignee-filter\")\n    .option(\"--parent <value>\", \"Filter by parent item ID\")\n    .option(\"--sprint <value>\", \"Filter by sprint\")\n    .option(\"--release <value>\", \"Filter by release\")\n    .action(async (options: Record<string, unknown>, command) => {\n      const globalOptions = getGlobalOptions(command);\n      const startedAt = Date.now();\n      const result = await runDedupeAudit(normalizeDedupeAuditOptions(options), globalOptions);\n      printResult(result, globalOptions);\n      if (globalOptions.profile) {\n        printError(`profile:command=dedupe-audit took_ms=${Date.now() - startedAt}`);\n      }\n    });\n\n  program\n    .command(\"calendar\")\n    .alias(\"cal\")\n    .description(\"Show deadline/reminder calendar views (agenda/day/week/month).\")\n    .option(\"--view <value>\", \"Calendar view: agenda|day|week|month (default: agenda)\")\n    .option(\"--date <value>\", \"Anchor date/time for view calculations (ISO/date string or relative)\")\n    .option(\"--from <value>\", \"Agenda lower bound (ISO/date string or relative)\")\n    .option(\"--to <value>\", \"Agenda upper bound (ISO/date string or relative)\")\n    .option(\"--past\", \"Include past entries in the selected view\")\n    .option(\"--full-period\", \"For day/week/month views, include the full anchored period without now-clipping\")\n    .option(\"--full_period\", \"Alias for --full-period\")\n    .option(\"--type <value>\", \"Filter by item type\")\n    .option(\"--tag <value>\", \"Filter by tag\")\n    .option(\"--priority <value>\", \"Filter by priority\")\n    .option(\"--status <value>\", \"Filter by status\")\n    .option(\"--assignee <value>\", \"Filter by assignee\")\n    .option(\"--assignee-filter <value>\", \"Filter assignee presence: assigned|unassigned\")\n    .option(\"--assignee_filter <value>\", \"Alias for --assignee-filter\")\n    .option(\"--sprint <value>\", \"Filter by sprint\")\n    .option(\"--release <value>\", \"Filter by release\")\n    .option(\"--include <value>\", \"Include sources: deadlines|reminders|events|all (comma or | separated)\")\n    .option(\"--recurrence-lookahead-days <n>\", \"Bound open-ended recurrence generation lookahead days\")\n    .option(\"--recurrence_lookahead_days <n>\", \"Alias for --recurrence-lookahead-days\")\n    .option(\"--recurrence-lookback-days <n>\", \"Bound open-ended recurrence generation lookback days\")\n    .option(\"--recurrence_lookback_days <n>\", \"Alias for --recurrence-lookback-days\")\n    .option(\"--occurrence-limit <n>\", \"Cap generated occurrences per recurring event\")\n    .option(\"--occurrence_limit <n>\", \"Alias for --occurrence-limit\")\n    .option(\"--limit <n>\", \"Limit returned event count\")\n    .option(\"--format <value>\", \"Calendar output format override: markdown|toon|json\")\n    .action(async (options: Record<string, unknown>, actionCommand) => {\n      const globalOptions = getGlobalOptions(actionCommand);\n      const startedAt = Date.now();\n      const normalized = normalizeCalendarOptions(options);\n      const result = await runCalendar(normalized, globalOptions);\n      const outputFormat = resolveCalendarOutputFormat(normalized, globalOptions);\n      if (outputFormat === \"markdown\") {\n        if (!globalOptions.quiet) {\n          writeStdout(`${renderCalendarMarkdown(result)}\\n`);\n        }\n      } else {\n        printResult(result, {\n          ...globalOptions,\n          json: outputFormat === \"json\",\n        });\n      }\n      if (globalOptions.profile) {\n        printError(`profile:command=calendar took_ms=${Date.now() - startedAt}`);\n      }\n    });\n\n  program\n    .command(\"context\")\n    .alias(\"ctx\")\n    .description(\"Show a token-efficient project context snapshot for next-work decisions.\")\n    .option(\"--date <value>\", \"Anchor date/time for agenda window calculations (ISO/date string or relative)\")\n    .option(\"--from <value>\", \"Agenda lower bound (ISO/date string or relative)\")\n    .option(\"--to <value>\", \"Agenda upper bound (ISO/date string or relative)\")\n    .option(\"--past\", \"Include past agenda entries in bounded windows\")\n    .option(\"--type <value>\", \"Filter by item type\")\n    .option(\"--tag <value>\", \"Filter by tag\")\n    .option(\"--priority <value>\", \"Filter by priority\")\n    .option(\"--assignee <value>\", \"Filter by assignee\")\n    .option(\"--assignee-filter <value>\", \"Filter assignee presence: assigned|unassigned\")\n    .option(\"--assignee_filter <value>\", \"Alias for --assignee-filter\")\n    .option(\"--sprint <value>\", \"Filter by sprint\")\n    .option(\"--release <value>\", \"Filter by release\")\n    .option(\"--limit <n>\", \"Limit focus and agenda rows per section\")\n    .option(\"--format <value>\", \"Context output format override: markdown|toon|json\")\n    .option(\"--depth <value>\", \"Context depth: brief|standard|deep (default: settings or brief)\")\n    .option(\"--section <value...>\", \"Include specific sections (repeatable; overrides --depth)\")\n    .option(\"--activity-limit <n>\", \"Limit recent activity entries (default: settings or 10)\")\n    .option(\"--stale-threshold <value>\", \"Staleness cutoff in days (e.g. 7 or 7d; default: settings or 7)\")\n    .action(async (options: Record<string, unknown>, actionCommand) => {\n      const globalOptions = getGlobalOptions(actionCommand);\n      const startedAt = Date.now();\n      const normalized = normalizeContextOptions(options);\n      const result = await runContext(normalized, globalOptions);\n      const outputFormat = resolveContextOutputFormat(normalized, globalOptions);\n      if (outputFormat === \"markdown\") {\n        if (!globalOptions.quiet) {\n          writeStdout(`${renderContextMarkdown(result)}\\n`);\n        }\n      } else {\n        printResult(result, {\n          ...globalOptions,\n          json: outputFormat === \"json\",\n        });\n      }\n      if (globalOptions.profile) {\n        printError(`profile:command=context took_ms=${Date.now() - startedAt}`);\n      }\n    });\n\n  program\n    .command(\"search\")\n    .argument(\"<keywords...>\", \"Keyword query tokens\")\n    .description(\"Search items with keyword, semantic, or hybrid modes.\")\n    .option(\n      \"--mode <value>\",\n      \"Search mode: keyword|semantic|hybrid (default: hybrid when semantic config or local Ollama auto-defaults are available, else keyword)\",\n    )\n    .option(\"--include-linked\", \"Include readable linked docs/files/tests content in keyword and hybrid lexical scoring\")\n    .option(\"--title-exact\", \"Require exact normalized title match against the full query\")\n    .option(\"--phrase-exact\", \"Require exact normalized query phrase match in item text fields\")\n    .option(\"--type <value>\", \"Filter by item type\")\n    .option(\"--tag <value>\", \"Filter by tag\")\n    .option(\"--priority <value>\", \"Filter by priority\")\n    .option(\"--deadline-before <value>\", \"Filter by deadline upper bound (ISO/date string or relative)\")\n    .option(\"--deadline-after <value>\", \"Filter by deadline lower bound (ISO/date string or relative)\")\n    .option(\"--compact\", \"Render compact search hits (default; mutually exclusive with --full/--fields)\")\n    .option(\"--full\", \"Render full search hits with nested item payloads (mutually exclusive with --compact/--fields)\")\n    .option(\n      \"--fields <value>\",\n      \"Render custom comma-separated search hit fields (mutually exclusive with --compact/--full; valid: --fields id,title,score; invalid: --full --fields id,title)\",\n    )\n    .option(\"--limit <n>\", \"Limit returned item count\")\n    .action(async (keywords: string[], options: Record<string, unknown>, command) => {\n      const globalOptions = getGlobalOptions(command);\n      const startedAt = Date.now();\n      const result = await runSearch(normalizeSearchKeywordsInput(keywords), normalizeSearchOptions(options), globalOptions);\n      printResult(result, globalOptions);\n      if (globalOptions.profile) {\n        printError(`profile:command=search took_ms=${Date.now() - startedAt}`);\n      }\n    });\n\n  program\n    .command(\"reindex\")\n    .description(\"Rebuild search artifacts for keyword, semantic, and hybrid modes.\")\n    .option(\"--mode <value>\", \"Reindex mode: keyword|semantic|hybrid\", \"keyword\")\n    .option(\"--progress\", \"Emit progress updates to stderr (always shown in TTY, opt-in for non-TTY)\")\n    .action(async (options: Record<string, unknown>, command) => {\n      const globalOptions = getGlobalOptions(command);\n      const startedAt = Date.now();\n      const result = await runReindex(\n        {\n          mode: typeof options.mode === \"string\" ? options.mode : undefined,\n          progress: Boolean(options.progress),\n        },\n        globalOptions,\n      );\n      printResult(result, globalOptions);\n      if (globalOptions.profile) {\n        printError(`profile:command=reindex took_ms=${Date.now() - startedAt}`);\n      }\n    });\n\n  program\n    .command(\"get\")\n    .argument(\"<id>\", \"Item id\")\n    .description(\"Show item details by ID.\")\n    .action(async (id: string, _options: unknown, command) => {\n      const globalOptions = getGlobalOptions(command);\n      const startedAt = Date.now();\n      const result = await runGet(id, globalOptions);\n      printResult(result, globalOptions);\n      if (globalOptions.profile) {\n        printError(`profile:command=get took_ms=${Date.now() - startedAt}`);\n      }\n    });\n\n  program\n    .command(\"history\")\n    .argument(\"<id>\", \"Item id\")\n    .option(\"--limit <n>\", \"Return only the latest n history entries\")\n    .option(\"--diff\", \"Include per-entry changed field summaries from history patches\")\n    .option(\"--verify\", \"Verify hash chain and replay integrity for the full history stream\")\n    .description(\"Show item history entries.\")\n    .action(async (id: string, options: Record<string, unknown>, command) => {\n      const globalOptions = getGlobalOptions(command);\n      const startedAt = Date.now();\n      const result = await runHistory(\n        id,\n        {\n          limit: typeof options.limit === \"string\" ? options.limit : undefined,\n          diff: Boolean(options.diff),\n          verify: Boolean(options.verify),\n        },\n        globalOptions,\n      );\n      printResult(result, globalOptions);\n      if (globalOptions.profile) {\n        printError(`profile:command=history took_ms=${Date.now() - startedAt}`);\n      }\n    });\n\n  program\n    .command(\"activity\")\n    .option(\"--id <value>\", \"Filter by item ID\")\n    .option(\"--op <value>\", \"Filter by history operation\")\n    .option(\"--author <value>\", \"Filter by history author\")\n    .option(\"--from <value>\", \"Lower timestamp bound (ISO/date string or relative)\")\n    .option(\"--to <value>\", \"Upper timestamp bound (ISO/date string or relative)\")\n    .option(\"--limit <n>\", \"Return only the latest n activity entries\")\n    .option(\"--compact\", \"Condensed output: show only id, op, ts, author, msg per entry\")\n    .option(\"--stream [mode]\", \"Emit line-delimited JSON rows (requires --json). Optional mode: rows|ndjson|jsonl\")\n    .description(\"Show recent activity across items.\")\n    .action(async (options: Record<string, unknown>, command) => {\n      const globalOptions = getGlobalOptions(command);\n      const startedAt = Date.now();\n      const normalized = normalizeActivityOptions(options);\n      const result = await runActivity(normalized, globalOptions);\n      const streamMode = resolveActivityStreamMode(options.stream);\n      if (streamMode && !globalOptions.json) {\n        throw new PmCliError(\"--stream requires --json output mode.\", EXIT_CODE.USAGE);\n      }\n      if (streamMode) {\n        printActivityJsonStream(result, normalized, globalOptions);\n      } else {\n        printResult(result, globalOptions);\n      }\n      if (globalOptions.profile) {\n        printError(`profile:command=activity took_ms=${Date.now() - startedAt}`);\n      }\n    });\n}\n"]}

package/dist/cli/register-mutation.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from "commander";
+export declare function registerMutationCommands(program: Command): void;