@unbrained/pm-cli 2026.7.1 → 2026.7.3

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]="4d49be94-9af3-531a-a94b-1eb4112dbdbd")}catch(e){}}();
 import { Option } from "commander";
 import { EXIT_CODE } from "../core/shared/constants.js";
 import { PmCliError } from "../core/shared/errors.js";
@@ -56,172 +56,305 @@ function resolveReadCommandOutputFormat(commandLabel, rawFormat, globalOptions)
         json: normalized === "json",
     };
 }
-/**
- * Implements register list query commands for the public runtime surface of this module.
- */
-export function registerListQueryCommands(program, options) {
-    const commandFilter = options?.commandFilter;
-    const shouldRegister = (commandName) => shouldRegisterListQueryCommand(commandName, commandFilter);
-    // Register a flag and hide it from --help text while keeping it functional as
-    // a parse-time alias. Used for pure snake_case underscore-duplicate aliases
-    // (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) {
-            command.option("--status <value>", "Filter by status (use all for no status restriction)");
+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`);
         }
-        command
-            .option("--type <value>", "Filter by item type")
-            .option("--tag <value>", "Filter by tag")
-            .option("--priority <value>", "Filter by priority")
-            .option("--deadline-before <value>", "Filter by deadline upper bound (ISO/date string or relative)")
-            .option("--deadline-after <value>", "Filter by deadline lower bound (ISO/date string or relative)")
-            .option("--updated-after <value>", 'Filter by updated_at lower bound: ISO timestamp or signed relative (e.g. "-2h"/"-7d" for the past). "Changed since my last window" → --updated-after <ISO>')
-            .option("--updated-before <value>", "Filter by updated_at upper bound: ISO timestamp or signed relative (-2h/+1d)")
-            .option("--created-after <value>", "Filter by created_at lower bound: ISO timestamp or signed relative (-2h/+1d)")
-            .option("--created-before <value>", "Filter by created_at upper bound: ISO timestamp or signed relative (-2h/+1d)")
-            .option("--ids <value>", "Filter by explicit item IDs (comma-separated or repeatable)")
-            .option("--assignee <value>", "Filter by assignee")
-            .option("--assignee-filter <value>", "Filter assignee presence: assigned|unassigned")
-            .option("--parent <value>", "Filter by parent item ID")
-            .option("--sprint <value>", "Filter by sprint")
-            .option("--release <value>", "Filter by release")
-            .option("--filter-ac-missing", "Show only items missing acceptance_criteria")
-            .option("--filter-estimates-missing", "Show only items missing estimated_minutes")
-            .option("--filter-resolution-missing", "Show only terminal items missing resolution")
-            .option("--filter-metadata-missing", "Show only items missing any tracked metadata (AC, estimate, or resolution)")
-            .option("--limit <n>", "Limit returned item count")
-            .option("--offset <n>", "Skip the first n matching rows before limit is applied")
-            .option("--no-truncate", "Return every matched row, overriding any --limit (alias: --all)")
-            .option("--include-body", "Include item body in each returned list row")
-            .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 (aliases: updated, created)")
-            .option("--order <value>", "Sort order: asc|desc (requires --sort)")
-            .option("--tree", "Render rows in parent/child tree order")
-            .option("--tree-depth <n>", "Maximum recursion depth with --tree (0 keeps root rows only)")
-            .option("--format <value>", "Output render mode: csv|table (human export) or json|toon (machine output override)")
-            .option("--stream", "Emit line-delimited JSON rows (requires --json)");
-        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}`);
-            }
+    }
+    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}`);
+    }
+}
+function registerListCommand(program, descriptor) {
+    const { name, description, status, excludeTerminal, allowStatusFilter, defaultBrief } = descriptor;
+    const command = program.command(name).description(description);
+    if (allowStatusFilter) {
+        command.option("--status <value>", "Filter by status (use all for no status restriction)");
+    }
+    command
+        .option("--type <value>", "Filter by item type")
+        .option("--tag <value>", "Filter by tag")
+        .option("--priority <value>", "Filter by priority")
+        .option("--deadline-before <value>", "Filter by deadline upper bound (ISO/date string or relative)")
+        .option("--deadline-after <value>", "Filter by deadline lower bound (ISO/date string or relative)")
+        .option("--updated-after <value>", 'Filter by updated_at lower bound: ISO timestamp or signed relative (e.g. "-2h"/"-7d" for the past). "Changed since my last window" → --updated-after <ISO>')
+        .option("--updated-before <value>", "Filter by updated_at upper bound: ISO timestamp or signed relative (-2h/+1d)")
+        .option("--created-after <value>", "Filter by created_at lower bound: ISO timestamp or signed relative (-2h/+1d)")
+        .option("--created-before <value>", "Filter by created_at upper bound: ISO timestamp or signed relative (-2h/+1d)")
+        .option("--ids <value>", "Filter by explicit item IDs (comma-separated or repeatable)")
+        .option("--assignee <value>", "Filter by assignee")
+        .option("--assignee-filter <value>", "Filter assignee presence: assigned|unassigned")
+        .option("--parent <value>", "Filter by parent item ID")
+        .option("--sprint <value>", "Filter by sprint")
+        .option("--release <value>", "Filter by release")
+        .option("--filter-ac-missing", "Show only items missing acceptance_criteria")
+        .option("--filter-estimates-missing", "Show only items missing estimated_minutes")
+        .option("--filter-resolution-missing", "Show only terminal items missing resolution")
+        .option("--filter-metadata-missing", "Show only items missing any tracked metadata (AC, estimate, or resolution)")
+        .option("--limit <n>", "Limit returned item count")
+        .option("--offset <n>", "Skip the first n matching rows before limit is applied")
+        .option("--no-truncate", "Return every matched row, overriding any --limit (alias: --all)")
+        .option("--include-body", "Include item body in each returned list row")
+        .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 (aliases: updated, created)")
+        .option("--order <value>", "Sort order: asc|desc (requires --sort)")
+        .option("--tree", "Render rows in parent/child tree order")
+        .option("--tree-depth <n>", "Maximum recursion depth with --tree (0 keeps root rows only)")
+        .option("--format <value>", "Output render mode: csv|table (human export) or json|toon (machine output override)")
+        .option("--stream", "Emit line-delimited JSON rows (requires --json)");
+    registerContentAndGovernanceFilters(command);
+    command.action(async (options, actionCommand) => {
+        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");
+    // Hidden pure snake_case underscore-duplicate alias (kept parse-functional).
+    addHiddenOption(command, "--tags <value>", "Alias for --tag");
+    addHiddenOption(command, "--assignee_filter <value>", "Alias for --assignee-filter");
+    addHiddenOption(command, "--tree_depth <n>", "Alias for --tree-depth");
+    // Singular alias so `--filter-estimate-missing` works (matches update-many spelling).
+    addHiddenOption(command, "--filter-estimate-missing", "Alias for --filter-estimates-missing");
+}
+async function runAggregateAction(options, command) {
+    const globalOptions = getGlobalOptions(command);
+    const startedAt = Date.now();
+    const { runAggregate } = await import("./commands/aggregate.js");
+    const result = await runAggregate(normalizeAggregateOptions(options), globalOptions);
+    printResult(result, globalOptions);
+    if (globalOptions.profile) {
+        printError(`profile:command=aggregate took_ms=${Date.now() - startedAt}`);
+    }
+}
+async function runContextAction(options, actionCommand) {
+    const globalOptions = getGlobalOptions(actionCommand);
+    const startedAt = Date.now();
+    const normalized = normalizeContextOptions(options);
+    const commands = await import("./commands/context.js");
+    const result = await commands.runContext(normalized, globalOptions);
+    const outputFormat = commands.resolveContextOutputFormat(normalized, globalOptions);
+    if (outputFormat === "markdown") {
+        if (!globalOptions.quiet) {
+            writeStdout(`${commands.renderContextMarkdown(result)}\n`);
+        }
+    }
+    else {
+        printResult(result, {
+            ...globalOptions,
+            json: outputFormat === "json",
         });
-        // Positive alias for --no-truncate (Commander stores the negation as truncate=false).
-        addHiddenOption(command, "--all", "Alias for --no-truncate");
-        // Hidden pure snake_case underscore-duplicate alias (kept parse-functional).
-        addHiddenOption(command, "--tags <value>", "Alias for --tag");
-        addHiddenOption(command, "--assignee_filter <value>", "Alias for --assignee-filter");
-        addHiddenOption(command, "--tree_depth <n>", "Alias for --tree-depth");
-        // 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 (globalOptions.profile) {
+        printError(`profile:command=context took_ms=${Date.now() - startedAt}`);
+    }
+}
+async function runNextAction(options, actionCommand) {
+    const globalOptions = getGlobalOptions(actionCommand);
+    const startedAt = Date.now();
+    const commands = await import("./commands/next.js");
+    const nextOptions = normalizeNextOptions(options);
+    const result = await commands.runNext(nextOptions, globalOptions);
+    const outputFormat = commands.resolveNextOutputFormat(nextOptions, globalOptions);
+    if (outputFormat === "markdown") {
+        if (!globalOptions.quiet) {
+            writeStdout(`${commands.renderNextMarkdown(result)}\n`);
+        }
+    }
+    else {
+        printResult(result, { ...globalOptions, json: outputFormat === "json" });
+    }
+    if (globalOptions.profile) {
+        printError(`profile:command=next took_ms=${Date.now() - startedAt}`);
+    }
+}
+async function runSearchAction(keywords, options, command) {
+    const globalOptions = getGlobalOptions(command);
+    const startedAt = Date.now();
+    const { runSearch } = await import("./commands/search.js");
+    const searchOptions = normalizeSearchOptions(options);
+    const result = await runSearch(normalizeSearchKeywordsInput(keywords), {
+        ...searchOptions,
+        mode: typeof searchOptions.mode === "string" && searchOptions.mode.trim().length > 0
+            ? searchOptions.mode
+            : "keyword",
+    }, globalOptions);
+    printResult(result, resolveReadCommandOutputFormat("Search", options.format, globalOptions));
+    if (globalOptions.profile) {
+        printError(`profile:command=search took_ms=${Date.now() - startedAt}`);
+    }
+}
+async function runEvalAction(options, command) {
+    const globalOptions = getGlobalOptions(command);
+    const startedAt = Date.now();
+    const { runEval } = await import("./commands/eval.js");
+    const result = await runEval({
+        mode: typeof options.mode === "string" ? options.mode : undefined,
+        k: typeof options.k === "string" ? options.k : undefined,
+        failUnder: typeof options.failUnder === "string" ? options.failUnder : undefined,
+        queries: typeof options.queries === "string" ? options.queries : undefined,
+        format: typeof options.format === "string" ? options.format : undefined,
+    }, globalOptions);
+    printResult(result, resolveReadCommandOutputFormat("Eval", options.format, globalOptions));
+    if (globalOptions.profile) {
+        printError(`profile:command=eval took_ms=${Date.now() - startedAt}`);
+    }
+    if (!result.passed) {
+        throw new PmCliError(`Eval gate failed: aggregate nDCG@${result.k} ${result.aggregate.ndcg} is below --fail-under ${result.fail_under}`, EXIT_CODE.GENERIC_FAILURE);
+    }
+}
+async function runGetAction(id, options, command) {
+    const globalOptions = getGlobalOptions(command);
+    const startedAt = Date.now();
+    const { runGet } = await import("./commands/get.js");
+    const result = await runGet(id, globalOptions, {
+        depth: typeof options.depth === "string" ? options.depth : undefined,
+        fields: typeof options.fields === "string" ? options.fields : undefined,
+        full: Boolean(options.full),
+        tree: options.tree === true,
+        treeDepth: typeof options.treeDepth === "string"
+            ? options.treeDepth
+            : typeof options.tree_depth === "string"
+                ? options.tree_depth
+                : undefined,
+    });
+    printResult(result, resolveReadCommandOutputFormat("Get", options.format, globalOptions));
+    if (globalOptions.profile) {
+        printError(`profile:command=get took_ms=${Date.now() - startedAt}`);
+    }
+}
+async function runHistoryAction(id, options, command) {
+    const globalOptions = getGlobalOptions(command);
+    const startedAt = Date.now();
+    if (options.compact === true && options.full === true) {
+        throw new PmCliError("History projection options are mutually exclusive. Use either --compact or --full.", EXIT_CODE.USAGE);
     }
-    if (shouldRegister("list-all")) {
-        registerListCommand("list-all", "List all items with optional filters.", undefined, false, true);
+    const field = typeof options.field === "string" ? options.field : undefined;
+    const { runHistory } = await import("./commands/history.js");
+    const result = await runHistory(id, {
+        limit: typeof options.limit === "string" ? options.limit : undefined,
+        compact: options.full === true ? false : true,
+        diff: Boolean(options.diff) || field !== undefined,
+        field,
+        verify: Boolean(options.verify),
+    }, globalOptions);
+    printResult(result, resolveReadCommandOutputFormat("History", options.format, globalOptions));
+    if (globalOptions.profile) {
+        printError(`profile:command=history took_ms=${Date.now() - startedAt}`);
     }
-    if (shouldRegister("list-draft")) {
-        registerListCommand("list-draft", "List draft items with optional filters.", "draft");
+}
+async function runActivityAction(options, command) {
+    const globalOptions = getGlobalOptions(command);
+    const startedAt = Date.now();
+    if (options.compact === true && options.full === true) {
+        throw new PmCliError("Activity projection options are mutually exclusive. Use either --compact or --full.", EXIT_CODE.USAGE);
     }
-    if (shouldRegister("list-open")) {
-        registerListCommand("list-open", "List open items with optional filters.", "open", false, false, true);
+    const normalized = normalizeActivityOptions(options);
+    const { runActivity } = await import("./commands/activity.js");
+    const result = await runActivity(normalized, globalOptions);
+    const streamMode = resolveActivityStreamMode(options.stream);
+    if (streamMode && !globalOptions.json) {
+        throw new PmCliError("--stream requires --json output mode.", EXIT_CODE.USAGE);
     }
-    if (shouldRegister("list-in-progress")) {
-        registerListCommand("list-in-progress", "List in-progress items with optional filters.", "in_progress", false, false, true);
+    if (streamMode) {
+        printActivityJsonStream(result, normalized, globalOptions);
     }
-    if (shouldRegister("list-blocked")) {
-        registerListCommand("list-blocked", "List blocked items with optional filters.", "blocked", false, false, true);
+    else {
+        printResult(result, globalOptions);
     }
-    if (shouldRegister("list-closed")) {
-        registerListCommand("list-closed", "List closed items with optional filters.", "closed");
+    if (globalOptions.profile) {
+        printError(`profile:command=activity took_ms=${Date.now() - startedAt}`);
     }
-    if (shouldRegister("list-canceled")) {
-        registerListCommand("list-canceled", "List canceled items with optional filters.", "canceled");
+}
+/**
+ * Implements register list query commands for the public runtime surface of this module.
+ */
+export function registerListQueryCommands(program, options) {
+    const commandFilter = options?.commandFilter;
+    const shouldRegister = (commandName) => shouldRegisterListQueryCommand(commandName, commandFilter);
+    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(program, descriptor);
+        }
     }
     if (shouldRegister("aggregate")) {
         const aggregateCommand = program
@@ -247,17 +380,7 @@ export function registerListQueryCommands(program, options) {
         // Hidden pure snake_case underscore-duplicate aliases (kept parse-functional).
         addHiddenOption(aggregateCommand, "--include_unparented", "Alias for --include-unparented");
         addHiddenOption(aggregateCommand, "--assignee_filter <value>", "Alias for --assignee-filter");
-        aggregateCommand
-            .action(async (options, command) => {
-            const globalOptions = getGlobalOptions(command);
-            const startedAt = Date.now();
-            const { runAggregate } = await import("./commands/aggregate.js");
-            const result = await runAggregate(normalizeAggregateOptions(options), globalOptions);
-            printResult(result, globalOptions);
-            if (globalOptions.profile) {
-                printError(`profile:command=aggregate took_ms=${Date.now() - startedAt}`);
-            }
-        });
+        aggregateCommand.action(runAggregateAction);
     }
     if (shouldRegister("context")) {
         const contextCommand = program
@@ -285,29 +408,7 @@ export function registerListQueryCommands(program, options) {
             .option("--stale-threshold <value>", "Staleness cutoff in days (e.g. 7 or 7d; default: settings or 7)");
         // Hidden pure snake_case underscore-duplicate alias (kept parse-functional).
         addHiddenOption(contextCommand, "--assignee_filter <value>", "Alias for --assignee-filter");
-        contextCommand
-            .action(async (options, actionCommand) => {
-            const globalOptions = getGlobalOptions(actionCommand);
-            const startedAt = Date.now();
-            const normalized = normalizeContextOptions(options);
-            const commands = await import("./commands/context.js");
-            const result = await commands.runContext(normalized, globalOptions);
-            const outputFormat = commands.resolveContextOutputFormat(normalized, globalOptions);
-            if (outputFormat === "markdown") {
-                if (!globalOptions.quiet) {
-                    writeStdout(`${commands.renderContextMarkdown(result)}\n`);
-                }
-            }
-            else {
-                printResult(result, {
-                    ...globalOptions,
-                    json: outputFormat === "json",
-                });
-            }
-            if (globalOptions.profile) {
-                printError(`profile:command=context took_ms=${Date.now() - startedAt}`);
-            }
-        });
+        contextCommand.action(runContextAction);
     }
     if (shouldRegister("next")) {
         const nextCommand = program
@@ -328,25 +429,7 @@ export function registerListQueryCommands(program, options) {
         addHiddenOption(nextCommand, "--assignee_filter <value>", "Alias for --assignee-filter");
         addHiddenOption(nextCommand, "--blocked_limit <n>", "Alias for --blocked-limit");
         addHiddenOption(nextCommand, "--ready_only", "Alias for --ready-only");
-        nextCommand.action(async (options, actionCommand) => {
-            const globalOptions = getGlobalOptions(actionCommand);
-            const startedAt = Date.now();
-            const commands = await import("./commands/next.js");
-            const nextOptions = normalizeNextOptions(options);
-            const result = await commands.runNext(nextOptions, globalOptions);
-            const outputFormat = commands.resolveNextOutputFormat(nextOptions, globalOptions);
-            if (outputFormat === "markdown") {
-                if (!globalOptions.quiet) {
-                    writeStdout(`${commands.renderNextMarkdown(result)}\n`);
-                }
-            }
-            else {
-                printResult(result, { ...globalOptions, json: outputFormat === "json" });
-            }
-            if (globalOptions.profile) {
-                printError(`profile:command=next took_ms=${Date.now() - startedAt}`);
-            }
-        });
+        nextCommand.action(runNextAction);
     }
     if (shouldRegister("search")) {
         const searchCommand = program
@@ -385,23 +468,7 @@ export function registerListQueryCommands(program, options) {
             .option("--format <value>", "Search output format override: json|toon")
             .option("--limit <n>", "Limit returned item count");
         registerContentAndGovernanceFilters(searchCommand);
-        searchCommand
-            .action(async (keywords, options, command) => {
-            const globalOptions = getGlobalOptions(command);
-            const startedAt = Date.now();
-            const { runSearch } = await import("./commands/search.js");
-            const searchOptions = normalizeSearchOptions(options);
-            const result = await runSearch(normalizeSearchKeywordsInput(keywords), {
-                ...searchOptions,
-                mode: typeof searchOptions.mode === "string" && searchOptions.mode.trim().length > 0
-                    ? searchOptions.mode
-                    : "keyword",
-            }, globalOptions);
-            printResult(result, resolveReadCommandOutputFormat("Search", options.format, globalOptions));
-            if (globalOptions.profile) {
-                printError(`profile:command=search took_ms=${Date.now() - startedAt}`);
-            }
-        });
+        searchCommand.action(runSearchAction);
         addHiddenOption(searchCommand, "--tags <value>", "Alias for --tag");
     }
     if (shouldRegister("eval")) {
@@ -414,25 +481,7 @@ export function registerListQueryCommands(program, options) {
             .option("--fail-under <value>", "Exit non-zero when aggregate nDCG@k falls below this threshold (0..1); CI gate")
             .option("--queries <path>", "Path to the golden-query JSON file (default: <pmRoot>/search/eval-queries.json)")
             .option("--format <value>", "Eval output format override: json|toon")
-            .action(async (options, command) => {
-            const globalOptions = getGlobalOptions(command);
-            const startedAt = Date.now();
-            const { runEval } = await import("./commands/eval.js");
-            const result = await runEval({
-                mode: typeof options.mode === "string" ? options.mode : undefined,
-                k: typeof options.k === "string" ? options.k : undefined,
-                failUnder: typeof options.failUnder === "string" ? options.failUnder : undefined,
-                queries: typeof options.queries === "string" ? options.queries : undefined,
-                format: typeof options.format === "string" ? options.format : undefined,
-            }, globalOptions);
-            printResult(result, resolveReadCommandOutputFormat("Eval", options.format, globalOptions));
-            if (globalOptions.profile) {
-                printError(`profile:command=eval took_ms=${Date.now() - startedAt}`);
-            }
-            if (!result.passed) {
-                throw new PmCliError(`Eval gate failed: aggregate nDCG@${result.k} ${result.aggregate.ndcg} is below --fail-under ${result.fail_under}`, EXIT_CODE.GENERIC_FAILURE);
-            }
-        });
+            .action(runEvalAction);
     }
     if (shouldRegister("get")) {
         const getCommand = program
@@ -445,26 +494,7 @@ export function registerListQueryCommands(program, options) {
             .option("--tree-depth <n>", "Maximum subtree depth for --tree descendants")
             .option("--format <value>", "Get output format override: json|toon")
             .description("Show item details by ID.")
-            .action(async (id, options, command) => {
-            const globalOptions = getGlobalOptions(command);
-            const startedAt = Date.now();
-            const { runGet } = await import("./commands/get.js");
-            const result = await runGet(id, globalOptions, {
-                depth: typeof options.depth === "string" ? options.depth : undefined,
-                fields: typeof options.fields === "string" ? options.fields : undefined,
-                full: Boolean(options.full),
-                tree: options.tree === true,
-                treeDepth: typeof options.treeDepth === "string"
-                    ? options.treeDepth
-                    : typeof options.tree_depth === "string"
-                        ? options.tree_depth
-                        : undefined,
-            });
-            printResult(result, resolveReadCommandOutputFormat("Get", options.format, globalOptions));
-            if (globalOptions.profile) {
-                printError(`profile:command=get took_ms=${Date.now() - startedAt}`);
-            }
-        });
+            .action(runGetAction);
         addHiddenOption(getCommand, "--tree_depth <n>", "Alias for --tree-depth");
     }
     if (shouldRegister("history")) {
@@ -479,26 +509,7 @@ export function registerListQueryCommands(program, options) {
             .option("--verify", "Verify hash chain and replay integrity for the full history stream")
             .option("--format <value>", "History output format override: json|toon")
             .description("Show item history entries.")
-            .action(async (id, options, command) => {
-            const globalOptions = getGlobalOptions(command);
-            const startedAt = Date.now();
-            if (options.compact === true && options.full === true) {
-                throw new PmCliError("History projection options are mutually exclusive. Use either --compact or --full.", EXIT_CODE.USAGE);
-            }
-            const field = typeof options.field === "string" ? options.field : undefined;
-            const { runHistory } = await import("./commands/history.js");
-            const result = await runHistory(id, {
-                limit: typeof options.limit === "string" ? options.limit : undefined,
-                compact: options.full === true ? false : true,
-                diff: Boolean(options.diff) || field !== undefined,
-                field,
-                verify: Boolean(options.verify),
-            }, globalOptions);
-            printResult(result, resolveReadCommandOutputFormat("History", options.format, globalOptions));
-            if (globalOptions.profile) {
-                printError(`profile:command=history took_ms=${Date.now() - startedAt}`);
-            }
-        });
+            .action(runHistoryAction);
     }
     if (shouldRegister("activity")) {
         program
@@ -513,29 +524,7 @@ export function registerListQueryCommands(program, options) {
             .option("--full", "Show full activity entries with JSON Patch payloads")
             .option("--stream [mode]", "Emit line-delimited JSON rows (requires --json). Optional mode: rows|ndjson|jsonl")
             .description("Show recent activity across items.")
-            .action(async (options, command) => {
-            const globalOptions = getGlobalOptions(command);
-            const startedAt = Date.now();
-            if (options.compact === true && options.full === true) {
-                throw new PmCliError("Activity projection options are mutually exclusive. Use either --compact or --full.", EXIT_CODE.USAGE);
-            }
-            const normalized = normalizeActivityOptions(options);
-            const { runActivity } = await import("./commands/activity.js");
-            const result = await runActivity(normalized, globalOptions);
-            const streamMode = resolveActivityStreamMode(options.stream);
-            if (streamMode && !globalOptions.json) {
-                throw new PmCliError("--stream requires --json output mode.", EXIT_CODE.USAGE);
-            }
-            if (streamMode) {
-                printActivityJsonStream(result, normalized, globalOptions);
-            }
-            else {
-                printResult(result, globalOptions);
-            }
-            if (globalOptions.profile) {
-                printError(`profile:command=activity took_ms=${Date.now() - startedAt}`);
-            }
-        });
+            .action(runActivityAction);
     }
 }
 export const _testOnlyRegisterListQuery = {
@@ -543,4 +532,4 @@ export const _testOnlyRegisterListQuery = {
     parseListFormat,
 };
 //# sourceMappingURL=register-list-query.js.map
-//# debugId=fa7ca75b-e41a-54de-9843-6e47079e9685
+//# debugId=4d49be94-9af3-531a-a94b-1eb4112dbdbd