@unbrained/pm-cli 2026.5.14 → 2026.5.18

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

@@ -1 +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"]}
+{"version":3,"file":"migration-gates.js","sources":["cli/migration-gates.ts"],"sourceRoot":"/","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"],"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","debugId":"f2e7dc1e-9df0-5f24-8633-7ac2b755ad47"}

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

@@ -1,3 +1,5 @@
+
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="e75809a0-c5e1-5cf8-a248-74c848637e62")}catch(e){}}();
 import { EXIT_CODE } from "../core/shared/constants.js";
 import { PmCliError } from "../core/shared/errors.js";
 import { getGlobalOptions, normalizeAggregateOptions, normalizeActivityOptions, normalizeContextOptions, normalizeListOptions, normalizeSearchKeywordsInput, normalizeSearchOptions, printActivityJsonStream, printError, printListJsonStream, printResult, resolveActivityStreamMode, writeStdout, } from "./registration-helpers.js";
@@ -7,7 +9,7 @@ async function loadListQueryCommandsModule() {
     return listQueryCommandsModulePromise;
 }
 export function registerListQueryCommands(program) {
-    function registerListCommand(name, description, status, excludeTerminal, allowStatusFilter) {
+    function registerListCommand(name, description, status, excludeTerminal, allowStatusFilter, defaultBrief) {
         const command = program.command(name).description(description);
         if (allowStatusFilter) {
             command.option("--status <value>", "Filter by status");
@@ -27,9 +29,10 @@ export function registerListQueryCommands(program) {
             .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("--compact", "Render compact list projection fields (mutually exclusive with --brief/--full/--fields)")
+            .option("--brief", "Ultra-compact output: id, status, type, title only (agent-optimized, mutually exclusive with --compact/--full/--fields)")
+            .option("--full", "Render full list projection fields (mutually exclusive with --compact/--brief/--fields)")
+            .option("--fields <value>", "Render custom comma-separated list fields (mutually exclusive with --compact/--brief/--full; 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)")
@@ -37,6 +40,14 @@ export function registerListQueryCommands(program) {
             const globalOptions = getGlobalOptions(actionCommand);
             const startedAt = Date.now();
             const listOptions = normalizeListOptions(options);
+            if (defaultBrief === true &&
+                listOptions.includeBody !== true &&
+                listOptions.compact !== true &&
+                listOptions.brief !== true &&
+                listOptions.full !== true &&
+                listOptions.fields === undefined) {
+                listOptions.brief = true;
+            }
             if (excludeTerminal)
                 listOptions.excludeTerminal = true;
             const { runList } = await loadListQueryCommandsModule();
@@ -56,7 +67,7 @@ export function registerListQueryCommands(program) {
             }
         });
     }
-    registerListCommand("list", "List active items with optional filters.", undefined, true, true);
+    registerListCommand("list", "List active items with optional filters.", undefined, true, 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");
@@ -140,7 +151,13 @@ export function registerListQueryCommands(program) {
     program
         .command("search")
         .argument("<keywords...>", "Keyword query tokens")
-        .description("Search items with core keyword mode.")
+        .description("Search items with keyword, semantic, or hybrid retrieval.")
+        .option("--mode <value>", "Search mode: keyword|semantic|hybrid (default: keyword)")
+        .option("--semantic", "Shorthand for --mode semantic")
+        .option("--hybrid", "Shorthand for --mode hybrid")
+        .option("--include-linked", "Include linked files, docs, and tests in the searchable corpus")
+        .option("--title-exact", "Require exact normalized title match for the full query string")
+        .option("--phrase-exact", "Require exact normalized phrase match in searchable text")
         .option("--type <value>", "Filter by item type")
         .option("--tag <value>", "Filter by tag")
         .option("--priority <value>", "Filter by priority")
@@ -154,12 +171,12 @@ export function registerListQueryCommands(program) {
         const globalOptions = getGlobalOptions(command);
         const startedAt = Date.now();
         const { runSearch } = await loadListQueryCommandsModule();
+        const searchOptions = normalizeSearchOptions(options);
         const result = await runSearch(normalizeSearchKeywordsInput(keywords), {
-            ...normalizeSearchOptions(options),
-            mode: "keyword",
-            includeLinked: false,
-            titleExact: false,
-            phraseExact: false,
+            ...searchOptions,
+            mode: typeof searchOptions.mode === "string" && searchOptions.mode.trim().length > 0
+                ? searchOptions.mode
+                : "keyword",
         }, globalOptions);
         printResult(result, globalOptions);
         if (globalOptions.profile) {
@@ -169,12 +186,17 @@ export function registerListQueryCommands(program) {
     program
         .command("get")
         .argument("<id>", "Item id")
+        .option("--depth <value>", "Detail depth: brief|standard|deep (default: deep)")
+        .option("--fields <value>", "Render custom comma-separated item metadata fields (for example: --fields id,title,status,parent,type)")
         .description("Show item details by ID.")
-        .action(async (id, _options, command) => {
+        .action(async (id, options, command) => {
         const globalOptions = getGlobalOptions(command);
         const startedAt = Date.now();
         const { runGet } = await loadListQueryCommandsModule();
-        const result = await runGet(id, globalOptions);
+        const result = await runGet(id, globalOptions, {
+            depth: typeof options.depth === "string" ? options.depth : undefined,
+            fields: typeof options.fields === "string" ? options.fields : undefined,
+        });
         printResult(result, globalOptions);
         if (globalOptions.profile) {
             printError(`profile:command=get took_ms=${Date.now() - startedAt}`);
@@ -233,4 +255,5 @@ export function registerListQueryCommands(program) {
         }
     });
 }
-//# sourceMappingURL=register-list-query.js.map
+//# sourceMappingURL=register-list-query.js.map
+//# debugId=e75809a0-c5e1-5cf8-a248-74c848637e62

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

@@ -1 +1 @@
-{"version":3,"file":"register-list-query.js","sourceRoot":"/","sources":["cli/register-list-query.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Command } from \"commander\";\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  normalizeContextOptions,\n  normalizeListOptions,\n  normalizeSearchKeywordsInput,\n  normalizeSearchOptions,\n  printActivityJsonStream,\n  printError,\n  printListJsonStream,\n  printResult,\n  resolveActivityStreamMode,\n  writeStdout,\n} from \"./registration-helpers.js\";\n\ntype ListQueryCommandsModule = typeof import(\"./commands/index.js\");\n\nlet listQueryCommandsModulePromise: Promise<ListQueryCommandsModule> | null = null;\n\nasync function loadListQueryCommandsModule(): Promise<ListQueryCommandsModule> {\n  listQueryCommandsModulePromise ??= import(\"./commands/index.js\");\n  return listQueryCommandsModulePromise;\n}\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 { runList } = await loadListQueryCommandsModule();\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 { runAggregate } = await loadListQueryCommandsModule();\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(\"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 commands = await loadListQueryCommandsModule();\n      const result = await commands.runContext(normalized, globalOptions);\n      const outputFormat = commands.resolveContextOutputFormat(normalized, globalOptions);\n      if (outputFormat === \"markdown\") {\n        if (!globalOptions.quiet) {\n          writeStdout(`${commands.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 core keyword mode.\")\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 { runSearch } = await loadListQueryCommandsModule();\n      const result = await runSearch(\n        normalizeSearchKeywordsInput(keywords),\n        {\n          ...normalizeSearchOptions(options),\n          mode: \"keyword\",\n          includeLinked: false,\n          titleExact: false,\n          phraseExact: false,\n        },\n        globalOptions,\n      );\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(\"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 { runGet } = await loadListQueryCommandsModule();\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 { runHistory } = await loadListQueryCommandsModule();\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 { runActivity } = await loadListQueryCommandsModule();\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"]}
+{"version":3,"file":"register-list-query.js","sources":["cli/register-list-query.ts"],"sourceRoot":"/","sourcesContent":["import type { Command } from \"commander\";\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  normalizeContextOptions,\n  normalizeListOptions,\n  normalizeSearchKeywordsInput,\n  normalizeSearchOptions,\n  printActivityJsonStream,\n  printError,\n  printListJsonStream,\n  printResult,\n  resolveActivityStreamMode,\n  writeStdout,\n} from \"./registration-helpers.js\";\n\ntype ListQueryCommandsModule = typeof import(\"./commands/index.js\");\n\nlet listQueryCommandsModulePromise: Promise<ListQueryCommandsModule> | null = null;\n\nasync function loadListQueryCommandsModule(): Promise<ListQueryCommandsModule> {\n  listQueryCommandsModulePromise ??= import(\"./commands/index.js\");\n  return listQueryCommandsModulePromise;\n}\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    defaultBrief?: 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/--full/--fields)\")\n      .option(\"--brief\", \"Ultra-compact output: id, status, type, title only (agent-optimized, mutually exclusive with --compact/--full/--fields)\")\n      .option(\"--full\", \"Render full list projection fields (mutually exclusive with --compact/--brief/--fields)\")\n      .option(\n        \"--fields <value>\",\n        \"Render custom comma-separated list fields (mutually exclusive with --compact/--brief/--full; 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 (\n          defaultBrief === true &&\n          listOptions.includeBody !== true &&\n          listOptions.compact !== true &&\n          listOptions.brief !== true &&\n          listOptions.full !== true &&\n          listOptions.fields === undefined\n        ) {\n          listOptions.brief = true;\n        }\n        if (excludeTerminal) listOptions.excludeTerminal = true;\n        const { runList } = await loadListQueryCommandsModule();\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, 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 { runAggregate } = await loadListQueryCommandsModule();\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(\"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 commands = await loadListQueryCommandsModule();\n      const result = await commands.runContext(normalized, globalOptions);\n      const outputFormat = commands.resolveContextOutputFormat(normalized, globalOptions);\n      if (outputFormat === \"markdown\") {\n        if (!globalOptions.quiet) {\n          writeStdout(`${commands.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 retrieval.\")\n    .option(\"--mode <value>\", \"Search mode: keyword|semantic|hybrid (default: keyword)\")\n    .option(\"--semantic\", \"Shorthand for --mode semantic\")\n    .option(\"--hybrid\", \"Shorthand for --mode hybrid\")\n    .option(\"--include-linked\", \"Include linked files, docs, and tests in the searchable corpus\")\n    .option(\"--title-exact\", \"Require exact normalized title match for the full query string\")\n    .option(\"--phrase-exact\", \"Require exact normalized phrase match in searchable text\")\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 { runSearch } = await loadListQueryCommandsModule();\n      const searchOptions = normalizeSearchOptions(options);\n      const result = await runSearch(\n        normalizeSearchKeywordsInput(keywords),\n        {\n          ...searchOptions,\n          mode:\n            typeof searchOptions.mode === \"string\" && searchOptions.mode.trim().length > 0\n              ? searchOptions.mode\n              : \"keyword\",\n        },\n        globalOptions,\n      );\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(\"get\")\n    .argument(\"<id>\", \"Item id\")\n    .option(\"--depth <value>\", \"Detail depth: brief|standard|deep (default: deep)\")\n    .option(\"--fields <value>\", \"Render custom comma-separated item metadata fields (for example: --fields id,title,status,parent,type)\")\n    .description(\"Show item details by ID.\")\n    .action(async (id: string, options: Record<string, unknown>, command) => {\n      const globalOptions = getGlobalOptions(command);\n      const startedAt = Date.now();\n      const { runGet } = await loadListQueryCommandsModule();\n      const result = await runGet(\n        id,\n        globalOptions,\n        {\n          depth: typeof options.depth === \"string\" ? options.depth : undefined,\n          fields: typeof options.fields === \"string\" ? options.fields : undefined,\n        },\n      );\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 { runHistory } = await loadListQueryCommandsModule();\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 { runActivity } = await loadListQueryCommandsModule();\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"],"names":[],"mappings":"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","debugId":"e75809a0-c5e1-5cf8-a248-74c848637e62"}

package/dist/cli/register-mutation.js

@@ -1,3 +1,5 @@
+
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="df6717c1-afaf-5933-945b-32b84cacd324")}catch(e){}}();
 import { EXIT_CODE } from "../core/shared/constants.js";
 import { PmCliError } from "../core/shared/errors.js";
 import { CREATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS, UPDATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS, } from "../sdk/cli-contracts.js";
@@ -31,6 +33,7 @@ function registerCommanderOptionContracts(command, contracts) {
 export function registerMutationCommands(program) {
     const createCommand = program
         .command("create")
+        .argument("[title]", "Item title (positional shortcut for --title)")
         .description("Create a new project management item.");
     registerCommanderOptionContracts(createCommand, CREATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS);
     createCommand
@@ -44,9 +47,12 @@ export function registerMutationCommands(program) {
         .option("--clear-reminders", "Clear reminders")
         .option("--clear-events", "Clear events")
         .option("--clear-type-options", "Clear type options")
-        .action(async (options, command) => {
+        .action(async (positionalTitle, options, command) => {
         const globalOptions = getGlobalOptions(command);
         const startedAt = Date.now();
+        if (typeof positionalTitle === "string" && positionalTitle.length > 0 && options.title === undefined) {
+            options.title = positionalTitle;
+        }
         const normalized = normalizeCreateOptions(options, { requireType: false });
         const { runCreate } = await loadMutationCommandsModule();
         const result = await runCreate(normalized, globalOptions);
@@ -237,7 +243,9 @@ export function registerMutationCommands(program) {
     program
         .command("close")
         .argument("<id>", "Item id")
-        .argument("<text>", "Close reason text")
+        .argument("[text]", "Close reason text (alias: --reason)")
+        .option("--reason <value>", "Close reason text (alias for positional <text>)")
+        .option("--close-reason <value>", "Close reason text (alias for positional <text>)")
         .option("--author <value>", "Mutation author")
         .option("--message <value>", "History message")
         .option("--validate-close [mode]", 'Validate closure metadata before close: "off", "warn", or "strict" (default: settings governance preset)')
@@ -247,7 +255,24 @@ export function registerMutationCommands(program) {
         const globalOptions = getGlobalOptions(command);
         const startedAt = Date.now();
         const { runClose } = await loadMutationCommandsModule();
-        const result = await runClose(id, text, {
+        const reasonFromOption = (typeof options.reason === "string" && options.reason.trim().length > 0 && options.reason) ||
+            (typeof options.closeReason === "string" && options.closeReason.trim().length > 0 && options.closeReason) ||
+            undefined;
+        const resolvedText = typeof text === "string" && text.length > 0 ? text : reasonFromOption;
+        if (typeof resolvedText !== "string" || resolvedText.length === 0) {
+            throw new PmCliError("pm close requires a close reason as the second positional argument or via --reason.", EXIT_CODE.USAGE, {
+                code: "missing_required_argument",
+                why: "Close mutations are auditable; a reason is mandatory for the history record.",
+                examples: [
+                    `pm close ${id} "All acceptance criteria met"`,
+                    `pm close ${id} --reason "Verified by integration test"`,
+                ],
+                nextSteps: [
+                    "Re-run with the close reason as the second positional argument, or pass --reason \"<text>\".",
+                ],
+            });
+        }
+        const result = await runClose(id, resolvedText, {
             author: typeof options.author === "string" ? options.author : undefined,
             message: typeof options.message === "string" ? options.message : undefined,
             validateClose: options.validateClose === true
@@ -332,6 +357,204 @@ export function registerMutationCommands(program) {
             printError(`profile:command=restore took_ms=${Date.now() - startedAt}`);
         }
     });
+    const planCommand = program
+        .command("plan")
+        .description("Agent-optimized Plan item workflow: create, manage steps, link dependencies, approve, and materialize.")
+        .argument("[subcommand]", "Plan subcommand: create|show|add-step|update-step|complete-step|block-step|reorder-step|remove-step|link|unlink|decision|discovery|validation|resume|approve|materialize")
+        .argument("[id]", "Plan id (required for non-create subcommands); for create this may be the positional title")
+        .argument("[stepRef]", "Step reference: stable id (plan-step-001) or order integer")
+        .argument("[reorderTo]", "New order integer for reorder-step")
+        .option("--title <value>", "Plan title")
+        .option("--description <value>", "Plan description")
+        .option("--scope <value>", "Short scope statement of the target change or investigation")
+        .option("--parent <value>", "Parent pm item id")
+        .option("--related <value>", "Related pm item ids (repeatable, csv-friendly)", collect)
+        .option("--blocks <value>", "Pm item ids this plan blocks (repeatable, csv-friendly)", collect)
+        .option("--blocked-by <value>", "Pm item ids that block this plan (repeatable, csv-friendly)", collect)
+        .option("--blocked_by <value>", "Alias for --blocked-by", collect)
+        .option("--harness <value>", "Plan harness provenance: codex|claude-code|cursor|generic")
+        .option("--mode <value>", "Plan mode: draft|research|review|approved|executing|paused|completed|superseded")
+        .option("--resume-context <value>", "Compact context summary for a future stateless agent")
+        .option("--resume_context <value>", "Alias for --resume-context")
+        .option("--tags <value>", "Comma-separated tags")
+        .option("--priority <value>", "Priority 0-4")
+        .option("--body <value>", "Plan item body")
+        .option("--claim", "Claim the plan on create for the author")
+        .option("--from-search <value>", "Record the search query that led to plan creation")
+        .option("--from_search <value>", "Alias for --from-search")
+        .option("--step-title <value>", "Step title for add-step / update-step")
+        .option("--step_title <value>", "Alias for --step-title")
+        .option("--step-body <value>", "Step body text")
+        .option("--step_body <value>", "Alias for --step-body")
+        .option("--step-owner <value>", "Step owner")
+        .option("--step_owner <value>", "Alias for --step-owner")
+        .option("--step-status <value>", "Step status: pending|in_progress|completed|blocked|skipped|superseded")
+        .option("--step_status <value>", "Alias for --step-status")
+        .option("--step-evidence <value>", "Step evidence text (used by update-step/complete-step)")
+        .option("--step_evidence <value>", "Alias for --step-evidence")
+        .option("--step-blocked-reason <value>", "Step blocked reason (required when blocking)")
+        .option("--step_blocked_reason <value>", "Alias for --step-blocked-reason")
+        .option("--step-replacement <value>", "Replacement reference for a superseded step")
+        .option("--step_replacement <value>", "Alias for --step-replacement")
+        .option("--depends-on <value>", "Pm item ids the step depends on (repeatable, csv-friendly)", collect)
+        .option("--depends_on <value>", "Alias for --depends-on", collect)
+        .option("--link <value>", "Pm item id to link (repeatable, csv-friendly)", collect)
+        .option("--link-kind <value>", "Link kind: related|blocks|blocked_by|depends_on|discovered_from|implements|verifies|supersedes")
+        .option("--link_kind <value>", "Alias for --link-kind")
+        .option("--link-note <value>", "Optional note for the link")
+        .option("--link_note <value>", "Alias for --link-note")
+        .option("--promote-to-item-dep", "Also add the linked id as a top-level item dependency when linking")
+        .option("--promote_to_item_dep", "Alias for --promote-to-item-dep")
+        .option("--allow-multiple-active", "Allow multiple steps to be in_progress at once")
+        .option("--allow_multiple_active", "Alias for --allow-multiple-active")
+        .option("--file <value>", "Step linked file path=<value>[,scope=project|global,note=<text>] (repeatable)", collect)
+        .option("--test <value>", "Step linked test command=<value>[,path=<value>,note=<text>] (repeatable)", collect)
+        .option("--doc <value>", "Step linked doc path=<value>[,scope=project|global,note=<text>] (repeatable)", collect)
+        .option("--decision-text <value>", "Decision log entry text")
+        .option("--decision_text <value>", "Alias for --decision-text")
+        .option("--decision-rationale <value>", "Decision log entry rationale")
+        .option("--decision_rationale <value>", "Alias for --decision-rationale")
+        .option("--decision-evidence <value>", "Decision log entry evidence")
+        .option("--decision_evidence <value>", "Alias for --decision-evidence")
+        .option("--discovery-text <value>", "Discovery log entry text")
+        .option("--discovery_text <value>", "Alias for --discovery-text")
+        .option("--validation-text <value>", "Validation log entry text")
+        .option("--validation_text <value>", "Alias for --validation-text")
+        .option("--validation-command <value>", "Validation log entry command")
+        .option("--validation_command <value>", "Alias for --validation-command")
+        .option("--validation-expected <value>", "Validation log entry expected outcome")
+        .option("--validation_expected <value>", "Alias for --validation-expected")
+        .option("--depth <value>", "Show depth: brief|standard|deep (default: brief)")
+        .option("--fields <value>", "Comma-separated field projection for show output")
+        .option("--steps <value>", "Comma-separated step ids/orders for materialize")
+        .option("--materialize-type <value>", "Item type for materialized steps (default: Task)")
+        .option("--materialize_type <value>", "Alias for --materialize-type")
+        .option("--materialize-parent <value>", "Parent item id for materialized children (default: the plan)")
+        .option("--materialize_parent <value>", "Alias for --materialize-parent")
+        .option("--materialize-tags <value>", "Comma-separated tags for materialized children")
+        .option("--materialize_tags <value>", "Alias for --materialize-tags")
+        .option("--author <value>", "Mutation author")
+        .option("--message <value>", "Mutation message")
+        .option("--force", "Force ownership override")
+        .action(async (subcommand, id, stepRef, reorderToken, options, command) => {
+        const globalOptions = getGlobalOptions(command);
+        const startedAt = Date.now();
+        const { runPlan, PLAN_SUBCOMMANDS } = await loadMutationCommandsModule();
+        const normalizedSubcommand = (subcommand ?? "").trim().toLowerCase();
+        if (!normalizedSubcommand) {
+            throw new PmCliError(`pm plan requires a subcommand. Allowed: ${PLAN_SUBCOMMANDS.join(", ")}`, EXIT_CODE.USAGE, {
+                code: "missing_required_argument",
+                examples: [
+                    'pm plan create --title "Refactor lock retry"',
+                    "pm plan show pm-a1b2 --depth standard",
+                    'pm plan add-step pm-a1b2 --step-title "Read lock.ts"',
+                ],
+            });
+        }
+        if (!PLAN_SUBCOMMANDS.includes(normalizedSubcommand)) {
+            const didYouMean = normalizedSubcommand === "list" || normalizedSubcommand === "ls"
+                ? ['pm list --type Plan', 'pm list-all --type Plan']
+                : undefined;
+            throw new PmCliError(`Unknown pm plan subcommand "${subcommand}". Allowed: ${PLAN_SUBCOMMANDS.join(", ")}`, EXIT_CODE.USAGE, didYouMean ? { code: "unknown_subcommand", examples: didYouMean } : undefined);
+        }
+        const planOptions = { ...options };
+        // Normalize alternate-snake/camel aliases that Commander parses as different keys.
+        const aliasPairs = [
+            ["blocked_by", "blockedBy"],
+            ["resume_context", "resumeContext"],
+            ["from_search", "fromSearch"],
+            ["step_title", "stepTitle"],
+            ["step_body", "stepBody"],
+            ["step_owner", "stepOwner"],
+            ["step_status", "stepStatus"],
+            ["step_evidence", "stepEvidence"],
+            ["step_blocked_reason", "stepBlockedReason"],
+            ["step_replacement", "stepReplacement"],
+            ["depends_on", "dependsOn"],
+            ["link_kind", "linkKind"],
+            ["link_note", "linkNote"],
+            ["promote_to_item_dep", "promoteToItemDep"],
+            ["allow_multiple_active", "allowMultipleActive"],
+            ["decision_text", "decisionText"],
+            ["decision_rationale", "decisionRationale"],
+            ["decision_evidence", "decisionEvidence"],
+            ["discovery_text", "discoveryText"],
+            ["validation_text", "validationText"],
+            ["validation_command", "validationCommand"],
+            ["validation_expected", "validationExpected"],
+            ["materialize_type", "materializeType"],
+            ["materialize_parent", "materializeParent"],
+            ["materialize_tags", "materializeTags"],
+        ];
+        for (const [snake, camel] of aliasPairs) {
+            if (planOptions[snake] !== undefined && planOptions[camel] === undefined) {
+                planOptions[camel] = planOptions[snake];
+            }
+        }
+        let reorderTo;
+        if (normalizedSubcommand === "reorder-step" && typeof reorderToken === "string") {
+            const parsed = Number.parseInt(reorderToken, 10);
+            if (!Number.isFinite(parsed)) {
+                throw new PmCliError(`reorder-step requires an integer new order, got "${reorderToken}"`, EXIT_CODE.USAGE);
+            }
+            reorderTo = parsed;
+        }
+        // Allow positional title for `pm plan create "Title"` (mirrors pm create UX).
+        // Plan create never takes an id positional; the second token is the title.
+        let planId = id;
+        if (normalizedSubcommand === "create" && typeof id === "string" && id.length > 0 && planOptions.title === undefined) {
+            planOptions.title = id;
+            planId = undefined;
+        }
+        const result = await runPlan({
+            subcommand: normalizedSubcommand,
+            id: planId,
+            stepRef,
+            reorderTo,
+            options: planOptions,
+            global: globalOptions,
+        });
+        await invalidateSearchCachesForMutation(globalOptions, result);
+        printResult(result, globalOptions);
+        if (globalOptions.profile) {
+            printError(`profile:command=plan took_ms=${Date.now() - startedAt}`);
+        }
+    });
+    void planCommand;
+    program
+        .command("history-redact")
+        .argument("<id>", "Item id")
+        .option("--literal <value>", "Literal string to redact (repeatable)", collect)
+        .option("--regex <value>", "Regex pattern to redact (repeatable; accepts /pattern/flags or raw pattern)", collect)
+        .option("--replacement <value>", 'Replacement string (default: "[redacted]")')
+        .option("--dry-run", "Preview redaction impact without writing item/history files")
+        .option("--author <value>", "Mutation author")
+        .option("--message <value>", "Audit history message for the redaction marker entry")
+        .option("--force", "Force ownership/lock override")
+        .description("Redact sensitive literals/patterns from an item history stream and recompute hashes.")
+        .action(async (id, options, command) => {
+        const globalOptions = getGlobalOptions(command);
+        const startedAt = Date.now();
+        const { runHistoryRedact } = await loadMutationCommandsModule();
+        const literal = Array.isArray(options.literal) ? options.literal : undefined;
+        const regex = Array.isArray(options.regex) ? options.regex : undefined;
+        const result = await runHistoryRedact(id, {
+            literal,
+            regex,
+            replacement: typeof options.replacement === "string" ? options.replacement : undefined,
+            dryRun: options.dryRun === true,
+            author: typeof options.author === "string" ? options.author : undefined,
+            message: typeof options.message === "string" ? options.message : undefined,
+            force: Boolean(options.force),
+        }, globalOptions);
+        if (result.changed && !result.dry_run) {
+            await invalidateSearchCachesForMutation(globalOptions, result);
+        }
+        printResult(result, globalOptions);
+        if (globalOptions.profile) {
+            printError(`profile:command=history-redact took_ms=${Date.now() - startedAt}`);
+        }
+    });
     program
         .command("comments")
         .argument("<id>", "Item id")
@@ -597,4 +820,5 @@ export function registerMutationCommands(program) {
         }
     });
 }
-//# sourceMappingURL=register-mutation.js.map
+//# sourceMappingURL=register-mutation.js.map
+//# debugId=df6717c1-afaf-5933-945b-32b84cacd324