@unbrained/pm-cli 2026.7.1 → 2026.7.2

package/dist/cli/migration-gates.js

@@ -4,7 +4,7 @@
  * Provides CLI runtime support for Migration Gates.
  */
 
-!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]="3f652b37-a8f5-5d02-9199-d2982382b7a8")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="e5659f1c-76e6-52e9-96f6-201091483918")}catch(e){}}();
 import { pathExists } from "../core/fs/fs-utils.js";
 import { getActiveExtensionRegistrations } from "../core/extensions/index.js";
 import { resolveItemTypeRegistry } from "../core/item/type-registry.js";
@@ -72,55 +72,32 @@ export function collectMandatoryMigrationBlockers(migrations) {
 function hasMutatingListValues(value) {
     return Array.isArray(value) && value.length > 0;
 }
+const ALWAYS_MUTATING_COMMANDS = new Set(["create", "beads import", "todos import"]);
+const FORCEABLE_MUTATING_COMMANDS = new Set(["restore", "update", "close", "delete", "append", "claim", "release"]);
+const TEXT_APPEND_COMMANDS = new Set(["comments", "notes", "learnings"]);
+const LIST_MUTATION_COMMANDS = new Set(["files", "docs", "test"]);
 /**
  * Implements decide write gate for the public runtime surface of this module.
  */
 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,
-            };
+    if (ALWAYS_MUTATING_COMMANDS.has(commandPath)) {
+        return { isMutation: true, forceCapable: false, forceRequested: false };
     }
+    if (FORCEABLE_MUTATING_COMMANDS.has(commandPath)) {
+        return { isMutation: true, forceCapable: true, forceRequested };
+    }
+    if (TEXT_APPEND_COMMANDS.has(commandPath)) {
+        return { isMutation: typeof options.add === "string", forceCapable: true, forceRequested };
+    }
+    if (LIST_MUTATION_COMMANDS.has(commandPath)) {
+        return {
+            isMutation: hasMutatingListValues(options.add) || hasMutatingListValues(options.remove),
+            forceCapable: true,
+            forceRequested,
+        };
+    }
+    return { isMutation: false, forceCapable: false, forceRequested: false };
 }
 /**
  * Implements enforce mandatory migration write gate for the public runtime surface of this module.
@@ -169,4 +146,4 @@ export async function enforceItemFormatWriteGateAndPreflightMigration(commandPat
     }
 }
 //# sourceMappingURL=migration-gates.js.map
-//# debugId=3f652b37-a8f5-5d02-9199-d2982382b7a8
+//# debugId=e5659f1c-76e6-52e9-96f6-201091483918

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

@@ -1 +1 @@
-{"version":3,"file":"migration-gates.js","sources":["cli/migration-gates.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module cli/migration-gates\n *\n * Provides CLI runtime support for Migration Gates.\n */\nimport { 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\n/**\n * Documents the mandatory migration blocker payload exchanged by command, SDK, and package integrations.\n */\nexport interface MandatoryMigrationBlocker {\n  layer: \"global\" | \"project\";\n  name: string;\n  id: string;\n  status: string;\n}\n\n/**\n * Documents the write gate decision payload exchanged by command, SDK, and package integrations.\n */\nexport interface WriteGateDecision {\n  isMutation: boolean;\n  forceCapable: boolean;\n  forceRequested: boolean;\n}\n\n/**\n * Implements resolve migration id for the public runtime surface of this module.\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\n/**\n * Implements resolve normalized migration status for the public runtime surface of this module.\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\n/**\n * Implements collect mandatory migration blockers for the public runtime surface of this module.\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\n/**\n * Implements decide write gate for the public runtime surface of this module.\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\n/**\n * Implements enforce mandatory migration write gate for the public runtime surface of this module.\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\n/**\n * Implements enforce item format write gate and preflight migration for the public runtime surface of this module.\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":"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","debugId":"3f652b37-a8f5-5d02-9199-d2982382b7a8"}
+{"version":3,"file":"migration-gates.js","sources":["cli/migration-gates.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module cli/migration-gates\n *\n * Provides CLI runtime support for Migration Gates.\n */\nimport { 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\n/**\n * Documents the mandatory migration blocker payload exchanged by command, SDK, and package integrations.\n */\nexport interface MandatoryMigrationBlocker {\n  layer: \"global\" | \"project\";\n  name: string;\n  id: string;\n  status: string;\n}\n\n/**\n * Documents the write gate decision payload exchanged by command, SDK, and package integrations.\n */\nexport interface WriteGateDecision {\n  isMutation: boolean;\n  forceCapable: boolean;\n  forceRequested: boolean;\n}\n\n/**\n * Implements resolve migration id for the public runtime surface of this module.\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\n/**\n * Implements resolve normalized migration status for the public runtime surface of this module.\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\n/**\n * Implements collect mandatory migration blockers for the public runtime surface of this module.\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\nconst ALWAYS_MUTATING_COMMANDS = new Set([\"create\", \"beads import\", \"todos import\"]);\nconst FORCEABLE_MUTATING_COMMANDS = new Set([\"restore\", \"update\", \"close\", \"delete\", \"append\", \"claim\", \"release\"]);\nconst TEXT_APPEND_COMMANDS = new Set([\"comments\", \"notes\", \"learnings\"]);\nconst LIST_MUTATION_COMMANDS = new Set([\"files\", \"docs\", \"test\"]);\n\n/**\n * Implements decide write gate for the public runtime surface of this module.\n */\nexport function decideWriteGate(commandPath: string, options: Record<string, unknown>): WriteGateDecision {\n  const forceRequested = options.force === true;\n  if (ALWAYS_MUTATING_COMMANDS.has(commandPath)) {\n    return { isMutation: true, forceCapable: false, forceRequested: false };\n  }\n  if (FORCEABLE_MUTATING_COMMANDS.has(commandPath)) {\n    return { isMutation: true, forceCapable: true, forceRequested };\n  }\n  if (TEXT_APPEND_COMMANDS.has(commandPath)) {\n    return { isMutation: typeof options.add === \"string\", forceCapable: true, forceRequested };\n  }\n  if (LIST_MUTATION_COMMANDS.has(commandPath)) {\n    return {\n      isMutation: hasMutatingListValues(options.add) || hasMutatingListValues(options.remove),\n      forceCapable: true,\n      forceRequested,\n    };\n  }\n  return { isMutation: false, forceCapable: false, forceRequested: false };\n}\n\n/**\n * Implements enforce mandatory migration write gate for the public runtime surface of this module.\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\n/**\n * Implements enforce item format write gate and preflight migration for the public runtime surface of this module.\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":"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","debugId":"e5659f1c-76e6-52e9-96f6-201091483918"}

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

@@ -4,7 +4,7 @@
  * Provides CLI runtime support for Register List Query.
  */
 
-!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]="fa7ca75b-e41a-54de-9843-6e47079e9685")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="a3974412-2ea9-5d05-b064-54ae0f43978e")}catch(e){}}();
 import { Option } from "commander";
 import { EXIT_CODE } from "../core/shared/constants.js";
 import { PmCliError } from "../core/shared/errors.js";
@@ -56,6 +56,83 @@ function resolveReadCommandOutputFormat(commandLabel, rawFormat, globalOptions)
         json: normalized === "json",
     };
 }
+function applyDefaultBriefListMode(listOptions, defaultBrief) {
+    if (defaultBrief === true &&
+        listOptions.includeBody !== true &&
+        listOptions.compact !== true &&
+        listOptions.brief !== true &&
+        listOptions.full !== true &&
+        listOptions.fields === undefined) {
+        listOptions.brief = true;
+    }
+}
+function addHiddenOption(command, flags, description) {
+    command.addOption(new Option(flags, description).hideHelp());
+}
+function registerContentAndGovernanceFilters(command) {
+    command
+        .option("--has-notes", "Show only items that have notes")
+        .option("--has-learnings", "Show only items that have learnings")
+        .option("--has-files", "Show only items that have linked files")
+        .option("--has-docs", "Show only items that have linked docs")
+        .option("--has-tests", "Show only items that have linked tests")
+        .option("--has-comments", "Show only items that have comments")
+        .option("--has-deps", "Show only items that have dependencies")
+        .option("--has-body", "Show only items that have a non-empty body")
+        .option("--has-linked-command", "Show only items whose linked tests carry a runnable command")
+        .option("--no-notes", "Show only items that have no notes")
+        .option("--no-learnings", "Show only items that have no learnings")
+        .option("--no-files", "Show only items that have no linked files")
+        .option("--no-docs", "Show only items that have no linked docs")
+        .option("--no-tests", "Show only items that have no linked tests")
+        .option("--no-comments", "Show only items that have no comments")
+        .option("--no-deps", "Show only items that have no dependencies")
+        .option("--empty-body", "Show only items with an empty body")
+        .option("--no-linked-command", "Show only items whose linked tests carry no runnable command")
+        .option("--filter-reviewer-missing", "Show only items missing reviewer")
+        .option("--filter-risk-missing", "Show only items missing risk")
+        .option("--filter-confidence-missing", "Show only items missing confidence")
+        .option("--filter-sprint-missing", "Show only items missing sprint")
+        .option("--filter-release-missing", "Show only items missing release");
+}
+async function runRegisteredListCommand(params) {
+    const globalOptions = getGlobalOptions(params.actionCommand);
+    const startedAt = Date.now();
+    const listOptions = normalizeListOptions(params.options);
+    applyDefaultBriefListMode(listOptions, params.defaultBrief);
+    if (params.excludeTerminal)
+        listOptions.excludeTerminal = true;
+    const { runList } = await import("./commands/list.js");
+    const result = await runList(params.status, listOptions, globalOptions);
+    const streamMode = params.options.stream === true;
+    const listFormat = parseListFormat(params.options.format);
+    const tabular = listFormat === "csv" || listFormat === "table";
+    const effectiveGlobal = listFormat === "json" || listFormat === "toon"
+        ? resolveReadCommandOutputFormat("List", params.options.format, globalOptions)
+        : globalOptions;
+    if (streamMode && !effectiveGlobal.json) {
+        throw new PmCliError("--stream requires --json output mode.", EXIT_CODE.USAGE);
+    }
+    if (tabular && streamMode) {
+        throw new PmCliError("--format csv|table cannot be combined with --stream (line-delimited JSON).", EXIT_CODE.USAGE);
+    }
+    if (tabular) {
+        const rows = result.items;
+        const rendered = listFormat === "csv" ? renderRowsAsCsv(rows) : renderRowsAsTable(rows);
+        if (!effectiveGlobal.quiet && rendered.length > 0) {
+            writeStdout(`${rendered}\n`);
+        }
+    }
+    else if (streamMode) {
+        printListJsonStream(params.name, result, effectiveGlobal);
+    }
+    else {
+        printResult(result, effectiveGlobal);
+    }
+    if (globalOptions.profile) {
+        printError(`profile:command=${params.name} took_ms=${Date.now() - startedAt}`);
+    }
+}
 /**
  * Implements register list query commands for the public runtime surface of this module.
  */
@@ -67,41 +144,6 @@ export function registerListQueryCommands(program, options) {
     // (e.g. --assignee_filter for --assignee-filter) so they no longer bloat
     // --help output. The option still appears in command.options, so JSON help
     // and completion are unchanged.
-    function addHiddenOption(command, flags, description) {
-        command.addOption(new Option(flags, description).hideHelp());
-    }
-    // Register the content-field presence/absence filters (GH-242) and the
-    // governance-missing filters (GH-236) on a list-family or search command.
-    // Presence flags are plain booleans; absence flags use commander negation
-    // (`--no-notes` stores notes=false) except `--empty-body` which is its own
-    // dest so it composes with a future `--has-body`. linked_command tracks
-    // whether a linked test carries a runnable command.
-    function registerContentAndGovernanceFilters(command) {
-        command
-            .option("--has-notes", "Show only items that have notes")
-            .option("--has-learnings", "Show only items that have learnings")
-            .option("--has-files", "Show only items that have linked files")
-            .option("--has-docs", "Show only items that have linked docs")
-            .option("--has-tests", "Show only items that have linked tests")
-            .option("--has-comments", "Show only items that have comments")
-            .option("--has-deps", "Show only items that have dependencies")
-            .option("--has-body", "Show only items that have a non-empty body")
-            .option("--has-linked-command", "Show only items whose linked tests carry a runnable command")
-            .option("--no-notes", "Show only items that have no notes")
-            .option("--no-learnings", "Show only items that have no learnings")
-            .option("--no-files", "Show only items that have no linked files")
-            .option("--no-docs", "Show only items that have no linked docs")
-            .option("--no-tests", "Show only items that have no linked tests")
-            .option("--no-comments", "Show only items that have no comments")
-            .option("--no-deps", "Show only items that have no dependencies")
-            .option("--empty-body", "Show only items with an empty body")
-            .option("--no-linked-command", "Show only items whose linked tests carry no runnable command")
-            .option("--filter-reviewer-missing", "Show only items missing reviewer")
-            .option("--filter-risk-missing", "Show only items missing risk")
-            .option("--filter-confidence-missing", "Show only items missing confidence")
-            .option("--filter-sprint-missing", "Show only items missing sprint")
-            .option("--filter-release-missing", "Show only items missing release");
-    }
     function registerListCommand(name, description, status, excludeTerminal, allowStatusFilter, defaultBrief) {
         const command = program.command(name).description(description);
         if (allowStatusFilter) {
@@ -144,51 +186,7 @@ export function registerListQueryCommands(program, options) {
         registerContentAndGovernanceFilters(command);
         command
             .action(async (options, actionCommand) => {
-            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 import("./commands/list.js");
-            const result = await runList(status, listOptions, globalOptions);
-            const streamMode = options.stream === true;
-            const listFormat = parseListFormat(options.format);
-            const tabular = listFormat === "csv" || listFormat === "table";
-            // json|toon reuse the shared read-command override (honours the
-            // --json + --format toon conflict); csv|table are human render modes.
-            const effectiveGlobal = listFormat === "json" || listFormat === "toon"
-                ? resolveReadCommandOutputFormat("List", options.format, globalOptions)
-                : globalOptions;
-            if (streamMode && !effectiveGlobal.json) {
-                throw new PmCliError("--stream requires --json output mode.", EXIT_CODE.USAGE);
-            }
-            if (tabular && streamMode) {
-                throw new PmCliError("--format csv|table cannot be combined with --stream (line-delimited JSON).", EXIT_CODE.USAGE);
-            }
-            if (tabular) {
-                const rows = result.items;
-                const rendered = listFormat === "csv" ? renderRowsAsCsv(rows) : renderRowsAsTable(rows);
-                if (!effectiveGlobal.quiet && rendered.length > 0) {
-                    writeStdout(`${rendered}\n`);
-                }
-            }
-            else if (streamMode) {
-                printListJsonStream(name, result, effectiveGlobal);
-            }
-            else {
-                printResult(result, effectiveGlobal);
-            }
-            if (globalOptions.profile) {
-                printError(`profile:command=${name} took_ms=${Date.now() - startedAt}`);
-            }
+            await runRegisteredListCommand({ name, status, excludeTerminal, defaultBrief, options, actionCommand });
         });
         // Positive alias for --no-truncate (Commander stores the negation as truncate=false).
         addHiddenOption(command, "--all", "Alias for --no-truncate");
@@ -199,29 +197,20 @@ export function registerListQueryCommands(program, options) {
         // Singular alias so `--filter-estimate-missing` works (matches update-many spelling).
         addHiddenOption(command, "--filter-estimate-missing", "Alias for --filter-estimates-missing");
     }
-    if (shouldRegister("list")) {
-        registerListCommand("list", "List active items with optional filters.", undefined, true, true, true);
-    }
-    if (shouldRegister("list-all")) {
-        registerListCommand("list-all", "List all items with optional filters.", undefined, false, true);
-    }
-    if (shouldRegister("list-draft")) {
-        registerListCommand("list-draft", "List draft items with optional filters.", "draft");
-    }
-    if (shouldRegister("list-open")) {
-        registerListCommand("list-open", "List open items with optional filters.", "open", false, false, true);
-    }
-    if (shouldRegister("list-in-progress")) {
-        registerListCommand("list-in-progress", "List in-progress items with optional filters.", "in_progress", false, false, true);
-    }
-    if (shouldRegister("list-blocked")) {
-        registerListCommand("list-blocked", "List blocked items with optional filters.", "blocked", false, false, true);
-    }
-    if (shouldRegister("list-closed")) {
-        registerListCommand("list-closed", "List closed items with optional filters.", "closed");
-    }
-    if (shouldRegister("list-canceled")) {
-        registerListCommand("list-canceled", "List canceled items with optional filters.", "canceled");
+    const listCommandDescriptors = [
+        { name: "list", description: "List active items with optional filters.", excludeTerminal: true, allowStatusFilter: true, defaultBrief: true },
+        { name: "list-all", description: "List all items with optional filters.", excludeTerminal: false, allowStatusFilter: true },
+        { name: "list-draft", description: "List draft items with optional filters.", status: "draft" },
+        { name: "list-open", description: "List open items with optional filters.", status: "open", excludeTerminal: false, allowStatusFilter: false, defaultBrief: true },
+        { name: "list-in-progress", description: "List in-progress items with optional filters.", status: "in_progress", excludeTerminal: false, allowStatusFilter: false, defaultBrief: true },
+        { name: "list-blocked", description: "List blocked items with optional filters.", status: "blocked", excludeTerminal: false, allowStatusFilter: false, defaultBrief: true },
+        { name: "list-closed", description: "List closed items with optional filters.", status: "closed" },
+        { name: "list-canceled", description: "List canceled items with optional filters.", status: "canceled" },
+    ];
+    for (const descriptor of listCommandDescriptors) {
+        if (shouldRegister(descriptor.name)) {
+            registerListCommand(descriptor.name, descriptor.description, descriptor.status, descriptor.excludeTerminal, descriptor.allowStatusFilter, descriptor.defaultBrief);
+        }
     }
     if (shouldRegister("aggregate")) {
         const aggregateCommand = program
@@ -543,4 +532,4 @@ export const _testOnlyRegisterListQuery = {
     parseListFormat,
 };
 //# sourceMappingURL=register-list-query.js.map
-//# debugId=fa7ca75b-e41a-54de-9843-6e47079e9685
+//# debugId=a3974412-2ea9-5d05-b064-54ae0f43978e