@unbrained/pm-cli 2026.6.30 → 2026.7.2

package/dist/cli/commands/list.js

@@ -4,7 +4,7 @@
  * Implements the pm list command surface and its agent-facing runtime behavior.
  */
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="045f427a-3120-5271-b24d-f2c6a91dc19c")}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]="dd407aef-010b-5b8b-8fa6-f58be6efb7bf")}catch(e){}}();
 import { pathExists } from "../../core/fs/fs-utils.js";
 import { getActiveExtensionRegistrations } from "../../core/extensions/index.js";
 import { toItemRecord } from "../../core/item/item-record.js";
@@ -179,6 +179,34 @@ const COMPACT_LIST_VALUE_FILTER_ECHO_ENTRIES = [
     { optionKey: "sprint", summaryKey: "sprint" },
     { optionKey: "release", summaryKey: "release" },
 ];
+const VERBOSE_LIST_VALUE_FILTER_ECHO_ENTRIES = [
+    { optionKey: "type", summaryKey: "type" },
+    { optionKey: "tag", summaryKey: "tag" },
+    { optionKey: "priority", summaryKey: "priority" },
+    { optionKey: "deadlineBefore", summaryKey: "deadline_before" },
+    { optionKey: "deadlineAfter", summaryKey: "deadline_after" },
+    { optionKey: "updatedAfter", summaryKey: "updated_after" },
+    { optionKey: "updatedBefore", summaryKey: "updated_before" },
+    { optionKey: "createdAfter", summaryKey: "created_after" },
+    { optionKey: "createdBefore", summaryKey: "created_before" },
+    { optionKey: "ids", summaryKey: "ids" },
+    { optionKey: "assignee", summaryKey: "assignee" },
+    { optionKey: "assigneeFilter", summaryKey: "assignee_filter" },
+    { optionKey: "parent", summaryKey: "parent" },
+    { optionKey: "sprint", summaryKey: "sprint" },
+    { optionKey: "release", summaryKey: "release" },
+    { optionKey: "limit", summaryKey: "limit" },
+    { optionKey: "offset", summaryKey: "offset" },
+    { optionKey: "includeBody", summaryKey: "include_body" },
+    { optionKey: "compact", summaryKey: "compact" },
+    { optionKey: "fields", summaryKey: "fields" },
+];
+const VERBOSE_LIST_BOOLEAN_FILTER_ECHO_ENTRIES = [
+    { key: "filterAcMissing", summaryKey: "filter_ac_missing" },
+    { key: "filterEstimatesMissing", summaryKey: "filter_estimates_missing" },
+    { key: "filterResolutionMissing", summaryKey: "filter_resolution_missing" },
+    { key: "filterMetadataMissing", summaryKey: "filter_metadata_missing" },
+];
 function buildCompactListFilterSummary(params) {
     const { filtersStatus, options, treeEnabled, treeDepth, sortField, sortOrder, runtimeFieldFilters, } = params;
     const filters = {};
@@ -458,6 +486,12 @@ function resolveListFilterSet(status, options, typeRegistry, statusRegistry) {
     };
 }
 function matchesListScalarFilters(item, filters, statusRegistry) {
+    return matchesListIdentityFilters(item, filters, statusRegistry) &&
+        matchesListDateFilters(item, filters) &&
+        matchesListAssigneeFilterSet(item, filters) &&
+        matchesListScopeFilters(item, filters);
+}
+function matchesListIdentityFilters(item, filters, statusRegistry) {
     if (filters.idsFilter && !filters.idsFilter.has(item.id))
         return false;
     if (filters.statusSet && !filters.statusSet.has(item.status))
@@ -466,10 +500,11 @@ function matchesListScalarFilters(item, filters, statusRegistry) {
         return false;
     if (filters.typeFilter && item.type !== filters.typeFilter)
         return false;
-    if (filters.tagFilter && !item.tags.includes(filters.tagFilter))
-        return false;
-    if (filters.priorityFilter !== undefined && item.priority !== filters.priorityFilter)
+    if (filters.tagFilter && !(item.tags ?? []).includes(filters.tagFilter))
         return false;
+    return filters.priorityFilter === undefined || item.priority === filters.priorityFilter;
+}
+function matchesListDateFilters(item, filters) {
     if (filters.deadlineBefore && (!item.deadline || compareTimestampStrings(item.deadline, filters.deadlineBefore) > 0))
         return false;
     if (filters.deadlineAfter && (!item.deadline || compareTimestampStrings(item.deadline, filters.deadlineAfter) < 0))
@@ -480,21 +515,21 @@ function matchesListScalarFilters(item, filters, statusRegistry) {
         return false;
     if (filters.createdAfter && compareTimestampStrings(item.created_at, filters.createdAfter) < 0)
         return false;
-    if (filters.createdBefore && compareTimestampStrings(item.created_at, filters.createdBefore) > 0)
-        return false;
+    return !filters.createdBefore || compareTimestampStrings(item.created_at, filters.createdBefore) <= 0;
+}
+function matchesListAssigneeFilterSet(item, filters) {
     if (filters.assigneeModeFilter === "assigned" && !item.assignee)
         return false;
     if (filters.assigneeModeFilter === "unassigned" && item.assignee)
         return false;
-    if (filters.assigneeFilter !== undefined && item.assignee !== filters.assigneeFilter)
-        return false;
+    return filters.assigneeFilter === undefined || item.assignee === filters.assigneeFilter;
+}
+function matchesListScopeFilters(item, filters) {
     if (filters.parentFilter !== undefined && !filters.treeEnabled && item.parent !== filters.parentFilter)
         return false;
     if (filters.sprintFilter !== undefined && item.sprint !== filters.sprintFilter)
         return false;
-    if (filters.releaseFilter !== undefined && item.release !== filters.releaseFilter)
-        return false;
-    return true;
+    return filters.releaseFilter === undefined || item.release === filters.releaseFilter;
 }
 function matchesListFilterSet(item, filters, statusRegistry, runtimeFieldFilters) {
     if (!matchesListScalarFilters(item, filters, statusRegistry)) {
@@ -666,10 +701,7 @@ function runtimeMetadataKeysForProjection(definitions) {
     }
     return keys;
 }
-/**
- * Implements run list for the public runtime surface of this module.
- */
-export async function runList(status, options, global) {
+async function resolveListRuntimeContext(options, global) {
     const pmRoot = resolvePmRoot(process.cwd(), global.path);
     if (!(await pathExists(getSettingsPath(pmRoot)))) {
         throw new PmCliError(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);
@@ -677,52 +709,55 @@ export async function runList(status, options, global) {
     const settings = await readSettings(pmRoot);
     const statusRegistry = resolveRuntimeStatusRegistry(settings.schema);
     const runtimeFieldRegistry = resolveRuntimeFieldRegistry(settings.schema);
-    const runtimeFieldFilters = collectRuntimeFilterValues(options, runtimeFieldRegistry, "list");
-    const typeRegistry = resolveItemTypeRegistry(settings, getActiveExtensionRegistrations());
     const projection = parseProjectionConfig(options);
-    const runtimeMetadataKeys = runtimeMetadataKeysForProjection(runtimeFieldRegistry.definitions);
-    validateListProjectionFields(projection, runtimeMetadataKeys);
-    const listWarnings = [];
-    const projectionNeedsBody = projection.fields.some((field) => normalizeProjectionField(field) === "body");
-    // The heavy collection fields are only emitted by `--full` (verbatim items) or an
-    // explicit `--fields <heavy>` selection. Every other projection (default brief,
-    // `--compact`, light `--fields`) reads only light scalar fields, so it takes the
-    // light path that skips the large collections cache (the hot-path JSON.parse win).
-    const projectionNeedsCollections = projection.mode === "full" ||
-        projection.fields.some((field) => HEAVY_PROJECTION_FIELDS.has(normalizeProjectionField(field)));
-    // Content-field filters (GH-242) inspect the heavy collection arrays and/or the
-    // body, so they force the matching load path even when the projection alone
-    // would take the light path. notes/learnings/files/docs/tests/comments/deps/
-    // linked_command live in the heavy collections; body needs the body load.
+    validateListProjectionFields(projection, runtimeMetadataKeysForProjection(runtimeFieldRegistry.definitions));
+    return {
+        pmRoot,
+        settings,
+        statusRegistry,
+        runtimeFieldFilters: collectRuntimeFilterValues(options, runtimeFieldRegistry, "list"),
+        typeRegistry: resolveItemTypeRegistry(settings, getActiveExtensionRegistrations()),
+        projection,
+    };
+}
+async function loadListItems(options, runtime, listWarnings) {
+    const projectionNeedsBody = runtime.projection.fields.some((field) => normalizeProjectionField(field) === "body");
+    const projectionNeedsCollections = runtime.projection.mode === "full" ||
+        runtime.projection.fields.some((field) => HEAVY_PROJECTION_FIELDS.has(normalizeProjectionField(field)));
     const contentFieldFilters = resolveContentFieldFilters(options);
     const contentNeedsCollections = contentFiltersNeedCollections(contentFieldFilters);
     const contentNeedsBody = contentFiltersNeedBody(contentFieldFilters);
-    let items;
     if (options.includeBody || projectionNeedsBody || contentNeedsBody) {
-        items = await listAllFrontMatterWithBody(pmRoot, settings.item_format, typeRegistry.type_to_folder, listWarnings, settings.schema);
-    }
-    else if (projectionNeedsCollections || contentNeedsCollections) {
-        items = await listAllFrontMatter(pmRoot, settings.item_format, typeRegistry.type_to_folder, listWarnings, settings.schema);
+        return await listAllFrontMatterWithBody(runtime.pmRoot, runtime.settings.item_format, runtime.typeRegistry.type_to_folder, listWarnings, runtime.settings.schema);
     }
-    else {
-        items = await listAllFrontMatterLight(pmRoot, settings.item_format, typeRegistry.type_to_folder, listWarnings, settings.schema);
+    if (projectionNeedsCollections || contentNeedsCollections) {
+        return await listAllFrontMatter(runtime.pmRoot, runtime.settings.item_format, runtime.typeRegistry.type_to_folder, listWarnings, runtime.settings.schema);
     }
+    return await listAllFrontMatterLight(runtime.pmRoot, runtime.settings.item_format, runtime.typeRegistry.type_to_folder, listWarnings, runtime.settings.schema);
+}
+function resolveListOrderingOptions(options) {
     const sortField = parseSortField(options.sort);
     const sortOrder = parseSortOrder(options.order) ?? "asc";
     const treeEnabled = options.tree === true;
     if (!treeEnabled && options.treeDepth !== undefined) {
         throw new PmCliError("List --tree-depth requires --tree", EXIT_CODE.USAGE);
     }
-    const treeDepth = treeEnabled ? parseTreeDepth(options.treeDepth) : undefined;
-    const parentRoot = treeEnabled ? trimNonEmpty(options.parent) : undefined;
     if (!sortField && options.order !== undefined) {
         throw new PmCliError("List --order requires --sort", EXIT_CODE.USAGE);
     }
+    return {
+        sortField,
+        sortOrder,
+        treeEnabled,
+        treeDepth: treeEnabled ? parseTreeDepth(options.treeDepth) : undefined,
+        parentRoot: treeEnabled ? trimNonEmpty(options.parent) : undefined,
+    };
+}
+function resolveListStatusSelection(status, options, statusRegistry) {
     const explicitStatus = resolveStatusFilter(options.status, statusRegistry);
     const resolvedStatus = explicitStatus ?? resolveStatusFilter(status, statusRegistry);
     const explicitAllStatuses = isStatusAllFilterInput(options.status);
     const effectiveOptions = explicitStatus || explicitAllStatuses ? { ...options, excludeTerminal: false } : options;
-    const filtered = applyFilters(items, resolvedStatus, effectiveOptions, typeRegistry, statusRegistry, runtimeFieldFilters);
     const filtersStatus = explicitAllStatuses
         ? "all"
         : resolvedStatus === undefined
@@ -730,88 +765,103 @@ export async function runList(status, options, global) {
             : resolvedStatus.length === 1
                 ? resolvedStatus[0]
                 : resolvedStatus;
-    const sorted = sortItems(filtered, sortField, sortOrder, statusRegistry);
-    const ordered = treeEnabled ? orderItemsAsTree(sorted, parentRoot, treeDepth) : sorted;
-    // --no-truncate (alias --all) forces full results, overriding any --limit so an
-    // agent can pull the entire matched set in one call (GH-154).
+    return { resolvedStatus, explicitAllStatuses, effectiveOptions, filtersStatus };
+}
+function pageAndProjectListItems(ordered, options, projection, treeEnabled) {
     const noTruncate = options.noTruncate === true;
     const limit = noTruncate ? undefined : parseIntegerLimit(options.limit);
     const offset = parseOffset(options.offset) ?? 0;
     const limited = limit === undefined ? ordered.slice(offset) : ordered.slice(offset, offset + limit);
     const projected = projectListItems(limited, projection, treeEnabled);
     const totalMatched = ordered.length;
-    // Surface the pre-pagination total only when rows were actually omitted.
-    const truncationExtras = projected.length < totalMatched ? { total: totalMatched } : {};
+    return {
+        projected,
+        totalMatched,
+        truncationExtras: projected.length < totalMatched ? { total: totalMatched } : {},
+    };
+}
+function buildVerboseListFilters(params) {
+    const { filtersStatus, options, noTruncate, treeEnabled, treeDepth, sortField, sortOrder, runtimeFieldFilters } = params;
+    const filters = { status: filtersStatus };
+    const optionRecord = options;
+    for (const entry of VERBOSE_LIST_VALUE_FILTER_ECHO_ENTRIES) {
+        filters[entry.summaryKey] = optionRecord[entry.optionKey] ?? null;
+    }
+    for (const entry of VERBOSE_LIST_BOOLEAN_FILTER_ECHO_ENTRIES) {
+        if (optionRecord[entry.key] === true) {
+            filters[entry.summaryKey] = true;
+        }
+    }
+    Object.assign(filters, buildGovernanceMissingFilterEcho(options), buildContentFilterEcho(options));
+    if (noTruncate) {
+        filters.no_truncate = true;
+    }
+    if (treeEnabled) {
+        filters.tree = true;
+        filters.tree_depth = treeDepth ?? null;
+    }
+    filters.sort = sortField ?? null;
+    filters.order = sortField ? sortOrder : null;
+    filters.runtime_filters = runtimeFieldFilters;
+    return filters;
+}
+/**
+ * Implements run list for the public runtime surface of this module.
+ */
+export async function runList(status, options, global) {
+    const runtime = await resolveListRuntimeContext(options, global);
+    const listWarnings = [];
+    const items = await loadListItems(options, runtime, listWarnings);
+    const ordering = resolveListOrderingOptions(options);
+    const statusSelection = resolveListStatusSelection(status, options, runtime.statusRegistry);
+    const filtered = applyFilters(items, statusSelection.resolvedStatus, statusSelection.effectiveOptions, runtime.typeRegistry, runtime.statusRegistry, runtime.runtimeFieldFilters);
+    const sorted = sortItems(filtered, ordering.sortField, ordering.sortOrder, runtime.statusRegistry);
+    const ordered = ordering.treeEnabled ? orderItemsAsTree(sorted, ordering.parentRoot, ordering.treeDepth) : sorted;
+    const noTruncate = options.noTruncate === true;
+    const page = pageAndProjectListItems(ordered, options, runtime.projection, ordering.treeEnabled);
     const now = nowIso();
     const warnings = [...new Set(listWarnings)].sort((left, right) => left.localeCompare(right));
-    const projectionFields = projection.mode === "full" ? null : [...projection.fields];
-    // pm-vhx6: compact-mode list output is primarily consumed by agents. Keep the
-    // metadata trailer token-light by returning only active/user-supplied filters
-    // and omitting projection/sorting/now boilerplate in this path.
-    const compactSummaryMode = projection.mode === "compact" && options.compact === true;
+    const projectionFields = runtime.projection.mode === "full" ? null : [...runtime.projection.fields];
+    const compactSummaryMode = runtime.projection.mode === "compact" && options.compact === true;
     if (compactSummaryMode) {
         const compactFilters = buildCompactListFilterSummary({
-            filtersStatus,
+            filtersStatus: statusSelection.filtersStatus,
             options,
-            treeEnabled,
-            treeDepth,
-            sortField,
-            sortOrder,
-            runtimeFieldFilters,
+            treeEnabled: ordering.treeEnabled,
+            treeDepth: ordering.treeDepth,
+            sortField: ordering.sortField,
+            sortOrder: ordering.sortOrder,
+            runtimeFieldFilters: runtime.runtimeFieldFilters,
         });
         return {
-            items: projected,
-            count: projected.length,
-            ...truncationExtras,
+            items: page.projected,
+            count: page.projected.length,
+            ...page.truncationExtras,
             filters: compactFilters,
             ...(warnings.length > 0 ? { warnings } : {}),
         };
     }
     return {
-        items: projected,
-        count: projected.length,
-        ...truncationExtras,
-        filters: {
-            status: filtersStatus,
-            type: options.type ?? null,
-            tag: options.tag ?? null,
-            priority: options.priority ?? null,
-            deadline_before: options.deadlineBefore ?? null,
-            deadline_after: options.deadlineAfter ?? null,
-            updated_after: options.updatedAfter ?? null,
-            updated_before: options.updatedBefore ?? null,
-            created_after: options.createdAfter ?? null,
-            created_before: options.createdBefore ?? null,
-            ids: options.ids ?? null,
-            assignee: options.assignee ?? null,
-            assignee_filter: options.assigneeFilter ?? null,
-            parent: options.parent ?? null,
-            sprint: options.sprint ?? null,
-            release: options.release ?? null,
-            ...(options.filterAcMissing === true ? { filter_ac_missing: true } : {}),
-            ...(options.filterEstimatesMissing === true ? { filter_estimates_missing: true } : {}),
-            ...(options.filterResolutionMissing === true ? { filter_resolution_missing: true } : {}),
-            ...(options.filterMetadataMissing === true ? { filter_metadata_missing: true } : {}),
-            ...buildGovernanceMissingFilterEcho(options),
-            ...buildContentFilterEcho(options),
-            limit: options.limit ?? null,
-            offset: options.offset ?? null,
-            ...(noTruncate ? { no_truncate: true } : {}),
-            include_body: options.includeBody ?? null,
-            compact: options.compact ?? null,
-            fields: options.fields ?? null,
-            ...(treeEnabled ? { tree: true, tree_depth: treeDepth ?? null } : {}),
-            sort: sortField ?? null,
-            order: sortField ? sortOrder : null,
-            runtime_filters: runtimeFieldFilters,
-        },
+        items: page.projected,
+        count: page.projected.length,
+        ...page.truncationExtras,
+        filters: buildVerboseListFilters({
+            filtersStatus: statusSelection.filtersStatus,
+            options,
+            noTruncate,
+            treeEnabled: ordering.treeEnabled,
+            treeDepth: ordering.treeDepth,
+            sortField: ordering.sortField,
+            sortOrder: ordering.sortOrder,
+            runtimeFieldFilters: runtime.runtimeFieldFilters,
+        }),
         projection: {
-            mode: projection.mode,
+            mode: runtime.projection.mode,
             fields: projectionFields,
         },
         sorting: {
-            sort: sortField ?? "default",
-            order: sortField ? sortOrder : "asc",
+            sort: ordering.sortField ?? "default",
+            order: ordering.sortField ? ordering.sortOrder : "asc",
         },
         now,
         ...(warnings.length > 0 ? { warnings } : {}),
@@ -845,4 +895,4 @@ export const _testOnly = {
     withTreeMetadata,
 };
 //# sourceMappingURL=list.js.map
-//# debugId=045f427a-3120-5271-b24d-f2c6a91dc19c
+//# debugId=dd407aef-010b-5b8b-8fa6-f58be6efb7bf