@unbrained/pm-cli 2026.9.6 → 2026.9.8

package/dist/sdk/query/list.js

@@ -1,1305 +1,2 @@
-/**
- * @module sdk/query/list
- *
- * 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]="ccdb7d16-4f38-58d4-a19d-4ab1516cb1d7")}catch(e){}}();
-import { assertInitializedTracker } from "../environment/tracker-preflight.js";
-import { getActiveExtensionRegistrations, hasActiveOnReadHooks, } from "../../core/extensions/index.js";
-import { toItemRecord } from "../../core/item/item-record.js";
-import { isTerminalStatus } from "../../core/item/status.js";
-import { collectDependencyBlockedIds } from "../actionability.js";
-import { isStatusAllFilterInput, parseStatusFilterCsv, } from "../../core/item/status-filter.js";
-import { resolveItemTypeRegistry, } from "../../core/item/type-registry.js";
-import { parseIntegerLimit } from "./parsers.js";
-import { parsePriorityFilterSet, parseStringFilterSet, parseTypeFilterSet, } from "./multi-value-filters.js";
-import { collectRuntimeFilterValues, matchesRuntimeFilters, } from "../../core/schema/runtime-field-filters.js";
-import { hasMissingMetadataFilter, itemMatchesMissingMetadata, lifecycleClassifierFromStatusRegistry, } from "../../core/governance/metadata-coverage.js";
-import { contentFiltersNeedBody, contentFiltersNeedCollections, hasContentFieldFilter, itemMatchesContentFilters, } from "../../core/governance/content-fields.js";
-import { resolveRuntimeFieldRegistry, resolveRuntimeStatusRegistry, } from "../../core/schema/runtime-schema.js";
-import { EXIT_CODE } from "../../core/shared/constants.js";
-import { PmCliError } from "../../core/shared/errors.js";
-import { compareTimestampStrings, matchesTimestampFilters, nowIso, resolveIsoOrRelative, } from "../../core/shared/time.js";
-import { listAllItemMetadata, listAllItemMetadataLight, listAllItemMetadataWithBody, } from "../../core/store/item-store.js";
-import { HEAVY_METADATA_KEYS, readItemMetadataDerivedIndexState, } from "../../core/store/item-metadata-cache.js";
-import { queryItemMetadataIndex } from "../../core/store/item-metadata-query-index.js";
-import { resolvePmRoot } from "../../core/store/paths.js";
-import { readSettings } from "../../core/store/settings.js";
-import { LIST_FILTER_FLAG_CONTRACTS } from "../cli-contracts/flag-contracts.js";
-import { resolveWorkspaceRelationshipKindRegistry } from "../graph/assembly.js";
-import { collectHierarchyRelations, indexHierarchyRelations, } from "../graph/hierarchy-integrity.js";
-import { createQueryFingerprint, encodeQueryCursor, resolveQueryCursorStart, selectCursorSemanticOptions, } from "../pagination.js";
-import { BRIEF_LIST_FIELDS, DEFAULT_COMPACT_LIST_FIELDS, listListProjectionFields, } from "./projection-contracts.js";
-export { BRIEF_LIST_FIELDS, DEFAULT_COMPACT_LIST_FIELDS, LIST_COMMAND_DEFAULT_PROJECTIONS, listListProjectionFields, } from "./projection-contracts.js";
-/** Extract the missing-metadata selection filters from list/update-many options. */
-export const resolveMissingMetadataFilters = (options) => {
-    return {
-        acMissing: options.filterAcMissing === true,
-        estimatesMissing: options.filterEstimatesMissing === true,
-        resolutionMissing: options.filterResolutionMissing === true,
-        metadataMissing: options.filterMetadataMissing === true,
-        reviewerMissing: options.filterReviewerMissing === true,
-        riskMissing: options.filterRiskMissing === true,
-        confidenceMissing: options.filterConfidenceMissing === true,
-        sprintMissing: options.filterSprintMissing === true,
-        releaseMissing: options.filterReleaseMissing === true,
-    };
-};
-const CONTENT_FIELD_FLAG_MAPPINGS = [
-    {
-        field: "notes",
-        presentKey: "hasNotes",
-        absentKey: "noNotes",
-        presentFlag: "--has-notes",
-        absentFlag: "--no-notes",
-    },
-    {
-        field: "learnings",
-        presentKey: "hasLearnings",
-        absentKey: "noLearnings",
-        presentFlag: "--has-learnings",
-        absentFlag: "--no-learnings",
-    },
-    {
-        field: "files",
-        presentKey: "hasFiles",
-        absentKey: "noFiles",
-        presentFlag: "--has-files",
-        absentFlag: "--no-files",
-    },
-    {
-        field: "docs",
-        presentKey: "hasDocs",
-        absentKey: "noDocs",
-        presentFlag: "--has-docs",
-        absentFlag: "--no-docs",
-    },
-    {
-        field: "tests",
-        presentKey: "hasTests",
-        absentKey: "noTests",
-        presentFlag: "--has-tests",
-        absentFlag: "--no-tests",
-    },
-    {
-        field: "comments",
-        presentKey: "hasComments",
-        absentKey: "noComments",
-        presentFlag: "--has-comments",
-        absentFlag: "--no-comments",
-    },
-    {
-        field: "deps",
-        presentKey: "hasDeps",
-        absentKey: "noDeps",
-        presentFlag: "--has-deps",
-        absentFlag: "--no-deps",
-    },
-    {
-        field: "body",
-        presentKey: "hasBody",
-        absentKey: "emptyBody",
-        presentFlag: "--has-body",
-        absentFlag: "--empty-body",
-    },
-    {
-        field: "linked_command",
-        presentKey: "hasLinkedCommand",
-        absentKey: "noLinkedCommand",
-        presentFlag: "--has-linked-command",
-        absentFlag: "--no-linked-command",
-    },
-];
-/** Resolve the content-field presence/absence selections from list/search options. A field requested both present AND absent is a usage error (the two selections are mutually exclusive). Returns an empty object when no content-field filter is active. */
-export const resolveContentFieldFilters = (options) => {
-    const conflict = CONTENT_FIELD_FLAG_MAPPINGS.find((mapping) => options[mapping.presentKey] === true &&
-        options[mapping.absentKey] === true);
-    if (conflict) {
-        throw new PmCliError(`Cannot combine ${conflict.presentFlag} with ${conflict.absentFlag} for the same field.`, EXIT_CODE.USAGE);
-    }
-    return Object.fromEntries(CONTENT_FIELD_FLAG_MAPPINGS.flatMap((mapping) => {
-        if (options[mapping.presentKey] === true) {
-            return [[mapping.field, "present"]];
-        }
-        return options[mapping.absentKey] === true
-            ? [[mapping.field, "absent"]]
-            : [];
-    }));
-};
-/** Public contract for list sort fields, shared by SDK and presentation-layer consumers. */
-export const LIST_SORT_FIELDS = [
-    "priority",
-    "deadline",
-    "updated_at",
-    "created_at",
-    "title",
-    "parent",
-];
-/** Supported values accepted by the list sort order contract. */
-export const LIST_SORT_ORDER_VALUES = ["asc", "desc"];
-// A projection that selects any heavy collection field (or `--full`, which returns
-// items verbatim) must load the full metadata; everything else takes the light path.
-// Sourced from the single HEAVY_METADATA_KEYS definition in the cache layer so the
-// light/heavy split can never drift between the cache and the projection routing.
-const HEAVY_PROJECTION_FIELDS = new Set(HEAVY_METADATA_KEYS);
-/** Build the source-corpus certificate and enforce fail-closed list reads. */
-function resolveListCompleteness(warnings, indexed, strict) {
-    const unreadableItemCount = warnings.filter((warning) => warning.startsWith("item_list_item_read_failed:")).length;
-    const unreadableDirectoryCount = warnings.filter((warning) => warning.startsWith("item_list_directory_read_failed:")).length;
-    const completeness = {
-        status: indexed
-            ? "unchecked"
-            : unreadableItemCount + unreadableDirectoryCount > 0
-                ? "partial"
-                : "complete",
-        unreadable_item_count: unreadableItemCount,
-        unreadable_directory_count: unreadableDirectoryCount,
-    };
-    if (strict && completeness.status === "partial") {
-        throw new PmCliError(`List source is incomplete: ${unreadableItemCount} item document(s) and ${unreadableDirectoryCount} item directory/directories could not be read.`, EXIT_CODE.GENERIC_FAILURE, {
-            code: "list_source_incomplete",
-            why: "Strict list reads fail closed so agents and SDK consumers never treat an omitted item as a complete workspace.",
-            nextSteps: [
-                "Run pm validate --check-storage-integrity to locate unreadable tracker artifacts.",
-                "Repair the reported files or align the installed decoder version, then retry.",
-            ],
-        });
-    }
-    return completeness;
-}
-function isNonEmptyRecord(value) {
-    return (typeof value === "object" &&
-        value !== null &&
-        !Array.isArray(value) &&
-        Object.keys(value).length > 0);
-}
-// Active content-field filter flags, keyed by the options dest and the snake_case
-// summary key emitted in the filters echo (GH-242). Presence and absence are
-// distinct echo keys (has_notes vs no_notes; has_body vs empty_body).
-const CONTENT_FILTER_ECHO_ENTRIES = [
-    { key: "hasNotes", summaryKey: "has_notes" },
-    { key: "hasLearnings", summaryKey: "has_learnings" },
-    { key: "hasFiles", summaryKey: "has_files" },
-    { key: "hasDocs", summaryKey: "has_docs" },
-    { key: "hasTests", summaryKey: "has_tests" },
-    { key: "hasComments", summaryKey: "has_comments" },
-    { key: "hasDeps", summaryKey: "has_deps" },
-    { key: "hasBody", summaryKey: "has_body" },
-    { key: "hasLinkedCommand", summaryKey: "has_linked_command" },
-    { key: "noNotes", summaryKey: "no_notes" },
-    { key: "noLearnings", summaryKey: "no_learnings" },
-    { key: "noFiles", summaryKey: "no_files" },
-    { key: "noDocs", summaryKey: "no_docs" },
-    { key: "noTests", summaryKey: "no_tests" },
-    { key: "noComments", summaryKey: "no_comments" },
-    { key: "noDeps", summaryKey: "no_deps" },
-    { key: "emptyBody", summaryKey: "empty_body" },
-    { key: "noLinkedCommand", summaryKey: "no_linked_command" },
-];
-// Active governance-missing filter flags (GH-236), keyed by options dest and the
-// snake_case summary key emitted in the filters echo.
-const GOVERNANCE_MISSING_ECHO_ENTRIES = [
-    { key: "filterReviewerMissing", summaryKey: "filter_reviewer_missing" },
-    { key: "filterRiskMissing", summaryKey: "filter_risk_missing" },
-    { key: "filterConfidenceMissing", summaryKey: "filter_confidence_missing" },
-    { key: "filterSprintMissing", summaryKey: "filter_sprint_missing" },
-    { key: "filterReleaseMissing", summaryKey: "filter_release_missing" },
-];
-function applyContentFilterEcho(filters, options) {
-    for (const entry of CONTENT_FILTER_ECHO_ENTRIES) {
-        if (options[entry.key] === true) {
-            filters[entry.summaryKey] = true;
-        }
-    }
-}
-function applyGovernanceMissingFilterEcho(filters, options) {
-    for (const entry of GOVERNANCE_MISSING_ECHO_ENTRIES) {
-        if (options[entry.key] === true) {
-            filters[entry.summaryKey] = true;
-        }
-    }
-}
-/**
- * Copies user-supplied option values into compact filter summaries.
- *
- * Compact list/search responses are optimized for agent context: they echo only
- * filters the caller actually supplied. Keeping this helper shared prevents the
- * list and search command summaries from drifting as new scalar filters are
- * added.
- */
-export function applyFilterValueEcho(filters, options, entries) {
-    for (const entry of entries) {
-        const value = options[entry.optionKey];
-        if (value !== undefined) {
-            filters[entry.summaryKey] = entry.normalize
-                ? entry.normalize(value)
-                : value;
-        }
-    }
-}
-/** Implements build content filter echo for the public runtime surface of this module. */
-export function buildContentFilterEcho(options) {
-    const echo = {};
-    applyContentFilterEcho(echo, options);
-    return echo;
-}
-/** Implements build governance missing filter echo for the public runtime surface of this module. */
-export function buildGovernanceMissingFilterEcho(options) {
-    const echo = {};
-    applyGovernanceMissingFilterEcho(echo, options);
-    return echo;
-}
-const COMPACT_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" },
-];
-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" },
-];
-const LIST_RECENT_WINDOW = "-7d";
-function buildCompactListFilterSummary(params) {
-    const { filtersStatus, options, treeEnabled, treeDepth, sortField, sortOrder, runtimeFieldFilters, } = params;
-    const filters = {};
-    if (filtersStatus !== null) {
-        filters.status = filtersStatus;
-    }
-    if (options.dependencyBlocked === true) {
-        filters.blocked_semantics = "status_or_dependency";
-    }
-    applyFilterValueEcho(filters, options, COMPACT_LIST_VALUE_FILTER_ECHO_ENTRIES);
-    applyListWindowFilterEcho(filters, options);
-    if (options.filterAcMissing === true) {
-        filters.filter_ac_missing = true;
-    }
-    if (options.filterEstimatesMissing === true) {
-        filters.filter_estimates_missing = true;
-    }
-    if (options.filterResolutionMissing === true) {
-        filters.filter_resolution_missing = true;
-    }
-    if (options.filterMetadataMissing === true) {
-        filters.filter_metadata_missing = true;
-    }
-    applyGovernanceMissingFilterEcho(filters, options);
-    applyContentFilterEcho(filters, options);
-    if (options.limit !== undefined) {
-        filters.limit = options.limit;
-    }
-    if (options.offset !== undefined) {
-        filters.offset = options.offset;
-    }
-    if (options.includeBody === true) {
-        filters.include_body = true;
-    }
-    if (options.fields !== undefined) {
-        filters.fields = options.fields;
-    }
-    if (treeEnabled) {
-        filters.tree = true;
-        if (treeDepth !== undefined) {
-            filters.tree_depth = treeDepth;
-        }
-    }
-    if (sortField !== undefined) {
-        filters.sort = sortField;
-        filters.order = sortOrder;
-    }
-    if (isNonEmptyRecord(runtimeFieldFilters)) {
-        filters.runtime_filters = runtimeFieldFilters;
-    }
-    return filters;
-}
-function compareDefaultSort(left, right, statusRegistry) {
-    const leftTerminal = isTerminalStatus(left.status, statusRegistry);
-    const rightTerminal = isTerminalStatus(right.status, statusRegistry);
-    if (leftTerminal !== rightTerminal) {
-        return leftTerminal ? 1 : -1;
-    }
-    const byPriority = left.priority - right.priority;
-    if (byPriority !== 0) {
-        return byPriority;
-    }
-    const byUpdated = compareTimestampStrings(right.updated_at, left.updated_at);
-    if (byUpdated !== 0) {
-        return byUpdated;
-    }
-    return (left.id ?? "").localeCompare(right.id ?? "");
-}
-function sortItemsDefault(items, statusRegistry) {
-    return [...items].sort((left, right) => compareDefaultSort(left, right, statusRegistry));
-}
-function parseDeadline(raw, fieldLabel) {
-    if (raw === undefined)
-        return undefined;
-    return resolveIsoOrRelative(raw, new Date(), fieldLabel);
-}
-// updated/created date-window filters share the deadline ISO+relative resolver
-// so agents doing incremental "what changed since my last context window" syncs
-// can pass either an ISO timestamp (the common case — feed back the previous
-// run's `now`) or a SIGNED relative offset where "-2h"/"-7d" reach into the
-// past and "+1d" into the future (units h/d/w/m, m = months — there is no
-// minutes unit, matching the deadline resolver).
-function parseTimestampWindow(raw, fieldLabel) {
-    if (raw == null)
-        return undefined;
-    const value = String(raw).trim();
-    if (value.length === 0)
-        return undefined;
-    return resolveIsoOrRelative(value, new Date(), fieldLabel);
-}
-function resolveListUpdatedAfter(options) {
-    const hasUpdatedAfter = options.updatedAfter != null &&
-        String(options.updatedAfter).trim().length > 0;
-    const selectedWindows = [
-        options.today === true,
-        options.recent === true,
-        hasUpdatedAfter,
-    ].filter((selected) => selected).length;
-    if (selectedWindows > 1) {
-        throw new PmCliError("Choose only one updated_at window: --today, --recent, or --updated-after.", EXIT_CODE.USAGE);
-    }
-    if (options.today === true) {
-        const today = new Date();
-        today.setHours(0, 0, 0, 0);
-        return today.toISOString();
-    }
-    if (options.recent === true) {
-        return parseTimestampWindow(LIST_RECENT_WINDOW, "recent");
-    }
-    return parseTimestampWindow(options.updatedAfter, "updated-after");
-}
-function applyListWindowFilterEcho(filters, options) {
-    if (options.today === true) {
-        filters.today = true;
-    }
-    if (options.recent === true) {
-        filters.recent = true;
-    }
-}
-function parseIdsFilter(raw) {
-    if (raw == null)
-        return undefined;
-    const value = String(raw).trim();
-    if (value.length === 0) {
-        throw new PmCliError("--ids requires at least one non-empty item ID", EXIT_CODE.USAGE);
-    }
-    const ids = value
-        .split(",")
-        .map((entry) => entry.trim())
-        .filter((entry) => entry.length > 0);
-    if (ids.length === 0) {
-        throw new PmCliError("--ids requires at least one non-empty item ID", EXIT_CODE.USAGE);
-    }
-    return new Set(ids);
-}
-function parseOffset(raw) {
-    if (raw === undefined)
-        return undefined;
-    const normalized = String(raw).trim();
-    const parsed = normalized.length === 0 ? Number.NaN : Number(normalized);
-    if (!Number.isInteger(parsed) || parsed < 0) {
-        throw new PmCliError("Offset filter must be a non-negative integer", EXIT_CODE.USAGE);
-    }
-    return parsed;
-}
-function parseFieldSelectors(raw) {
-    if (raw === undefined) {
-        return undefined;
-    }
-    const selectors = raw
-        .split(",")
-        .map((entry) => entry.trim())
-        .filter((entry) => entry.length > 0);
-    if (selectors.length === 0) {
-        throw new PmCliError("List --fields requires a comma-separated list of field names", EXIT_CODE.USAGE);
-    }
-    return [...new Set(selectors)];
-}
-function parseProjectionConfig(options, invokedCommand = options.projectionCommand ?? "list") {
-    const compactRequested = options.compact === true;
-    const briefRequested = options.brief === true;
-    const fullRequested = options.full === true;
-    const fieldSelectors = parseFieldSelectors(options.fields);
-    const enabledModes = Number(compactRequested) +
-        Number(briefRequested) +
-        Number(fullRequested) +
-        Number(fieldSelectors !== undefined);
-    if (enabledModes > 1) {
-        throw new PmCliError("List projection options are mutually exclusive. Use one of --compact, --brief, --full, or --fields.", EXIT_CODE.USAGE, {
-            code: "projection_options_mutually_exclusive",
-            recovery: {
-                suggested_retry: `pm ${invokedCommand} --brief`,
-                suggested_retry_args: [invokedCommand, "--brief"],
-            },
-        });
-    }
-    if (fullRequested) {
-        return {
-            mode: "full",
-            fields: [],
-        };
-    }
-    if (briefRequested) {
-        return {
-            mode: "brief",
-            fields: [...BRIEF_LIST_FIELDS],
-        };
-    }
-    if (compactRequested) {
-        return {
-            mode: "compact",
-            fields: [...DEFAULT_COMPACT_LIST_FIELDS],
-        };
-    }
-    if (fieldSelectors) {
-        return {
-            mode: "fields",
-            fields: [
-                ...new Set(fieldSelectors.map((field) => normalizeProjectionField(field))),
-            ],
-        };
-    }
-    return {
-        mode: "full",
-        fields: [],
-    };
-}
-function normalizeProjectionField(field) {
-    return field.startsWith("item.") ? field.slice("item.".length) : field;
-}
-function validateListProjectionFields(projection, runtimeMetadataKeys, invokedCommand) {
-    if (projection.mode !== "fields") {
-        return;
-    }
-    const allowedValues = listListProjectionFields(runtimeMetadataKeys);
-    const allowed = new Set(allowedValues.map((field) => normalizeProjectionField(field)));
-    const unknown = projection.fields.filter((field) => !allowed.has(normalizeProjectionField(field)));
-    if (unknown.length > 0) {
-        throw new PmCliError(`Unknown list --fields value(s): ${unknown.join(", ")}`, EXIT_CODE.USAGE, {
-            code: "unknown_field_projection",
-            examples: [
-                "pm list-open --fields id,title,status,type,updated_at",
-                "pm list --fields id,title,parent,priority --limit 10",
-                "pm list-all --fields id,title,body --limit 5",
-            ],
-            recovery: {
-                allowed_values: allowedValues,
-                suggested_retry: `pm ${invokedCommand} --fields id,title,status --limit 10`,
-                suggested_retry_args: [
-                    invokedCommand,
-                    "--fields",
-                    "id,title,status",
-                    "--limit",
-                    "10",
-                ],
-            },
-        });
-    }
-}
-// Convenience aliases so agents/humans who reach for the bare verb form
-// (e.g. `--sort updated`) land on the canonical timestamp fields instead of an error.
-// A Map (not a plain object) avoids prototype-chain lookups for keys like "__proto__".
-const LIST_SORT_FIELD_ALIASES = new Map([
-    ["updated", "updated_at"],
-    ["update", "updated_at"],
-    ["modified", "updated_at"],
-    ["created", "created_at"],
-    ["create", "created_at"],
-]);
-function parseSortField(raw) {
-    if (raw === undefined) {
-        return undefined;
-    }
-    const normalized = raw.trim().toLowerCase();
-    const aliased = LIST_SORT_FIELD_ALIASES.get(normalized);
-    if (aliased) {
-        return aliased;
-    }
-    if (!LIST_SORT_FIELDS.includes(normalized)) {
-        throw new PmCliError(`Sort field must be one of ${LIST_SORT_FIELDS.join("|")} (aliases: updated->updated_at, created->created_at)`, EXIT_CODE.USAGE);
-    }
-    return normalized;
-}
-function parseSortOrder(raw) {
-    if (raw === undefined) {
-        return undefined;
-    }
-    const normalized = raw.trim().toLowerCase();
-    if (!LIST_SORT_ORDER_VALUES.includes(normalized)) {
-        throw new PmCliError(`Sort order must be one of ${LIST_SORT_ORDER_VALUES.join("|")}`, EXIT_CODE.USAGE);
-    }
-    return normalized;
-}
-function parseTreeDepth(raw) {
-    return parseIntegerLimit(raw, "--tree-depth");
-}
-function parseAssigneeFilter(raw) {
-    if (raw === undefined) {
-        return undefined;
-    }
-    const normalized = raw.trim().toLowerCase();
-    if (!normalized) {
-        throw new PmCliError("Assignee filter must be one of assigned|unassigned", EXIT_CODE.USAGE);
-    }
-    if (normalized !== "assigned" && normalized !== "unassigned") {
-        throw new PmCliError(`Invalid assignee filter "${raw}". Allowed: assigned|unassigned`, EXIT_CODE.USAGE);
-    }
-    return normalized;
-}
-// Resolve built-in, runtime, and workflow-group aliases through the shared
-// registry, rejecting typos instead of returning a misleading empty result.
-function resolveStatusFilter(status, statusRegistry) {
-    return parseStatusFilterCsv(status, statusRegistry, { strict: true });
-}
-function parseListTagFilters(raw) {
-    return parseStringFilterSet(raw, {
-        label: "--tag",
-        normalize: (tag) => tag.toLowerCase(),
-    });
-}
-function appendUnknownTagWarning(items, rawTags, warnings) {
-    const requestedTags = parseListTagFilters(rawTags);
-    if (requestedTags === undefined) {
-        return;
-    }
-    const knownTags = new Set(items.flatMap((item) => item.tags.map((tag) => tag.trim().toLowerCase())));
-    const unknownTags = [...requestedTags].filter((tag) => !knownTags.has(tag));
-    if (unknownTags.length > 0) {
-        warnings.push(`unknown_tags:${unknownTags.join(",")}`);
-    }
-}
-function assertListAssigneeFilters(assigneeFilter, assigneeModeFilter) {
-    if (assigneeFilter &&
-        [...assigneeFilter].some((value) => value.toLowerCase() === "none" || value.toLowerCase() === "null")) {
-        throw new PmCliError('--assignee no longer accepts "none" or "null". Use --assignee-filter unassigned.', EXIT_CODE.USAGE);
-    }
-    if (assigneeFilter !== undefined && assigneeModeFilter === "unassigned") {
-        throw new PmCliError("Cannot combine --assignee with --assignee-filter unassigned", EXIT_CODE.USAGE);
-    }
-}
-function resolveListFilterSet(status, options, typeRegistry, statusRegistry) {
-    const assigneeFilter = parseStringFilterSet(options.assignee, {
-        label: "--assignee",
-    });
-    const assigneeModeFilter = parseAssigneeFilter(options.assigneeFilter);
-    assertListAssigneeFilters(assigneeFilter, assigneeModeFilter);
-    const missingMetadataFilters = resolveMissingMetadataFilters(options);
-    const contentFieldFilters = resolveContentFieldFilters(options);
-    return {
-        idsFilter: parseIdsFilter(options.ids),
-        statusSet: status && status.length > 0 ? new Set(status) : undefined,
-        excludeTerminal: options.excludeTerminal === true,
-        typeFilter: parseTypeFilterSet(options.type, typeRegistry),
-        tagFilters: parseListTagFilters(options.tag),
-        priorityFilter: parsePriorityFilterSet(options.priority),
-        deadlineBefore: parseDeadline(options.deadlineBefore, "deadline-before"),
-        deadlineAfter: parseDeadline(options.deadlineAfter, "deadline-after"),
-        updatedAfter: resolveListUpdatedAfter(options),
-        updatedBefore: parseTimestampWindow(options.updatedBefore, "updated-before"),
-        createdAfter: parseTimestampWindow(options.createdAfter, "created-after"),
-        createdBefore: parseTimestampWindow(options.createdBefore, "created-before"),
-        assigneeFilter,
-        assigneeModeFilter,
-        parentFilter: options.parent?.trim(),
-        treeEnabled: options.tree === true,
-        sprintFilter: parseStringFilterSet(options.sprint, { label: "--sprint" }),
-        releaseFilter: parseStringFilterSet(options.release, {
-            label: "--release",
-        }),
-        missingMetadataFilters,
-        missingMetadataActive: hasMissingMetadataFilter(missingMetadataFilters),
-        lifecycleClassifier: lifecycleClassifierFromStatusRegistry(statusRegistry),
-        contentFieldFilters,
-        contentFiltersActive: hasContentFieldFilter(contentFieldFilters),
-    };
-}
-function matchesListIdentityFilters(item, filters, statusRegistry) {
-    if (filters.idsFilter && !filters.idsFilter.has(item.id))
-        return false;
-    if (filters.statusSet && !filters.statusSet.has(item.status))
-        return false;
-    if (filters.excludeTerminal && isTerminalStatus(item.status, statusRegistry))
-        return false;
-    if (filters.typeFilter && !filters.typeFilter.has(item.type))
-        return false;
-    if (filters.tagFilters &&
-        ![...filters.tagFilters].some((tag) => (item.tags ?? []).some((candidate) => candidate.trim().toLowerCase() === tag))) {
-        return false;
-    }
-    return (filters.priorityFilter === undefined ||
-        filters.priorityFilter.has(item.priority));
-}
-function matchesListDateFilters(item, filters) {
-    return matchesTimestampFilters(item, filters);
-}
-function matchesListAssigneeFilterSet(item, filters) {
-    if (filters.assigneeModeFilter === "assigned" && !item.assignee)
-        return false;
-    if (filters.assigneeModeFilter === "unassigned" && item.assignee)
-        return false;
-    return (filters.assigneeFilter === undefined ||
-        (item.assignee !== undefined && filters.assigneeFilter.has(item.assignee)));
-}
-function matchesListScopeFilters(item, filters, parentsByChild) {
-    const scalarParent = item.parent?.trim().toLowerCase();
-    const logicalParentIds = [
-        ...new Set([
-            ...(parentsByChild?.get(item.id.trim().toLowerCase()) ?? []),
-            ...(scalarParent ? [scalarParent] : []),
-        ]),
-    ];
-    if (filters.parentFilter !== undefined &&
-        !filters.treeEnabled &&
-        !logicalParentIds.includes(filters.parentFilter.trim().toLowerCase()))
-        return false;
-    if (filters.sprintFilter !== undefined &&
-        (item.sprint === undefined || !filters.sprintFilter.has(item.sprint)))
-        return false;
-    return (filters.releaseFilter === undefined ||
-        (item.release !== undefined && filters.releaseFilter.has(item.release)));
-}
-function matchesListFilterSet(item, filters, statusRegistry, runtimeFieldFilters, parentsByChild) {
-    if (!matchesListIdentityFilters(item, filters, statusRegistry) ||
-        !matchesListDateFilters(item, filters) ||
-        !matchesListAssigneeFilterSet(item, filters) ||
-        !matchesListScopeFilters(item, filters, parentsByChild)) {
-        return false;
-    }
-    if (filters.missingMetadataActive &&
-        !itemMatchesMissingMetadata(item, filters.missingMetadataFilters, filters.lifecycleClassifier)) {
-        return false;
-    }
-    if (filters.contentFiltersActive &&
-        !itemMatchesContentFilters(item, filters.contentFieldFilters)) {
-        return false;
-    }
-    if (!matchesRuntimeFilters(item, runtimeFieldFilters)) {
-        return false;
-    }
-    return true;
-}
-function applyFilters(items, status, options, typeRegistry, statusRegistry, runtimeFieldFilters, parentsByChild) {
-    const filters = resolveListFilterSet(status, options, typeRegistry, statusRegistry);
-    return items.filter((item) => matchesListFilterSet(item, filters, statusRegistry, runtimeFieldFilters, parentsByChild));
-}
-function trimNonEmpty(value) {
-    if (typeof value !== "string") {
-        return undefined;
-    }
-    const trimmed = value.trim();
-    return trimmed.length > 0 ? trimmed : undefined;
-}
-function withTreeMetadata(item, depth, childCount, parentId) {
-    const itemRecord = toItemRecord(item);
-    const title = typeof itemRecord.title === "string" ? itemRecord.title : "";
-    const parent = parentId ??
-        trimNonEmpty(typeof itemRecord.parent === "string" ? itemRecord.parent : undefined) ??
-        null;
-    return {
-        ...item,
-        tree_depth: depth,
-        tree_parent: parent,
-        tree_children: childCount,
-        tree_title: `${"  ".repeat(depth)}${title}`,
-    };
-}
-function buildListTreeIndexes(sortedItems, hierarchyIndexes) {
-    const byId = new Map();
-    const childrenByParent = new Map();
-    for (const item of sortedItems) {
-        const itemId = item.id.trim().toLowerCase();
-        byId.set(itemId, item);
-        const parentIds = hierarchyIndexes
-            ? (hierarchyIndexes.parents_by_child.get(itemId) ?? [])
-            : [trimNonEmpty(item.parent)?.toLowerCase()].filter((value) => value !== undefined);
-        for (const parentId of parentIds) {
-            const children = childrenByParent.get(parentId) ?? [];
-            children.push(item);
-            childrenByParent.set(parentId, children);
-        }
-    }
-    return { byId, childrenByParent };
-}
-function resolveListTreeRoots(sortedItems, parentRoot, byId, childrenByParent, hierarchyIndexes) {
-    return parentRoot
-        ? [...(childrenByParent.get(parentRoot.toLowerCase()) ?? [])]
-        : sortedItems.filter((item) => {
-            const parentIds = hierarchyIndexes
-                ? (hierarchyIndexes.parents_by_child.get(item.id.trim().toLowerCase()) ?? [])
-                : [trimNonEmpty(item.parent)?.toLowerCase()].filter((value) => value !== undefined);
-            return parentIds.every((parentId) => !byId.has(parentId));
-        });
-}
-function orderItemsAsTree(sortedItems, parentRoot, maxDepth, hierarchyIndexes, completeItems = sortedItems) {
-    const { byId, childrenByParent } = buildListTreeIndexes(sortedItems, hierarchyIndexes);
-    const roots = resolveListTreeRoots(sortedItems, parentRoot, byId, childrenByParent, hierarchyIndexes);
-    const ordered = [];
-    const visited = new Set();
-    const canonicalIdByLowercase = new Map(completeItems.map((item) => [item.id.trim().toLowerCase(), item.id.trim()]));
-    const pending = [...roots].reverse().map((node) => ({
-        node,
-        depth: 0,
-        parentId: parentRoot === undefined
-            ? undefined
-            : (canonicalIdByLowercase.get(parentRoot.trim().toLowerCase()) ??
-                parentRoot.trim()),
-    }));
-    while (pending.length > 0) {
-        const { node, depth, parentId } = pending.pop();
-        const nodeId = node.id.trim().toLowerCase();
-        if (visited.has(nodeId))
-            continue;
-        visited.add(nodeId);
-        const children = childrenByParent.get(nodeId) ?? [];
-        ordered.push(withTreeMetadata(node, depth, children.length, parentId));
-        if (maxDepth !== undefined && depth >= maxDepth)
-            continue;
-        for (const child of [...children].reverse()) {
-            pending.push({
-                node: child,
-                depth: depth + 1,
-                parentId: canonicalIdByLowercase.get(nodeId),
-            });
-        }
-    }
-    if (parentRoot === undefined && maxDepth === undefined) {
-        for (const item of sortedItems) {
-            const itemId = item.id.trim().toLowerCase();
-            if (visited.has(itemId))
-                continue;
-            visited.add(itemId);
-            ordered.push(withTreeMetadata(item, 0, childrenByParent.get(itemId)?.length ?? 0));
-        }
-    }
-    return ordered;
-}
-function compareNullableString(left, right) {
-    if (left === right) {
-        return 0;
-    }
-    if (left === null) {
-        return 1;
-    }
-    if (right === null) {
-        return -1;
-    }
-    return left.localeCompare(right);
-}
-function compareNullableTimestamp(left, right) {
-    if (left === right) {
-        return 0;
-    }
-    if (left === null) {
-        return 1;
-    }
-    if (right === null) {
-        return -1;
-    }
-    return compareTimestampStrings(left, right);
-}
-function compareBySortField(left, right, field) {
-    switch (field) {
-        case "priority":
-            return left.priority - right.priority;
-        case "deadline":
-            return compareNullableTimestamp(left.deadline ?? null, right.deadline ?? null);
-        case "updated_at":
-            return compareTimestampStrings(left.updated_at, right.updated_at);
-        case "created_at":
-            return compareTimestampStrings(left.created_at, right.created_at);
-        case "title":
-            return (left.title ?? "").localeCompare(right.title ?? "");
-        case "parent":
-            return compareNullableString(left.parent ?? null, right.parent ?? null);
-        default:
-            return 0;
-    }
-}
-function sortItems(items, sortField, sortOrder, statusRegistry) {
-    if (!sortField) {
-        return sortItemsDefault(items, statusRegistry);
-    }
-    return [...items].sort((left, right) => {
-        const byField = compareBySortField(left, right, sortField);
-        if (byField !== 0) {
-            return sortOrder === "desc" ? -byField : byField;
-        }
-        const fallback = compareDefaultSort(left, right, statusRegistry);
-        return sortOrder === "desc" ? -fallback : fallback;
-    });
-}
-function readListFieldValue(item, field, treeMode = false) {
-    const normalized = normalizeProjectionField(field.trim());
-    if (normalized.length === 0) {
-        return null;
-    }
-    const itemRecord = toItemRecord(item);
-    if (treeMode &&
-        normalized === "title" &&
-        typeof itemRecord.tree_title === "string") {
-        return itemRecord.tree_title;
-    }
-    if (Object.prototype.hasOwnProperty.call(itemRecord, normalized)) {
-        return itemRecord[normalized] ?? null;
-    }
-    return null;
-}
-function projectListItems(items, projection, treeMode = false) {
-    if (projection.mode === "full") {
-        return items;
-    }
-    return items.map((item) => {
-        const projected = {};
-        for (const field of projection.fields) {
-            // Field values are read straight off the parsed item metadata, so the
-            // typed core keys (id/title/status/...) hold their declared runtime
-            // shapes; the cast only widens the write, not the read surface.
-            projected[field] = readListFieldValue(item, field, treeMode);
-        }
-        return projected;
-    });
-}
-function runtimeMetadataKeysForProjection(definitions) {
-    const keys = [];
-    for (const field of definitions) {
-        keys.push(field.metadata_key);
-    }
-    return keys;
-}
-function resolveListPageLimit(options, totalRows) {
-    if (options.noTruncate === true) {
-        return undefined;
-    }
-    return (parseIntegerLimit(options.limit) ?? (totalRows >= 10_000 ? 20 : undefined));
-}
-function resolveListPageStart(ordered, options, cursorFingerprint) {
-    if (options.after === undefined) {
-        return parseOffset(options.offset) ?? 0;
-    }
-    return resolveQueryCursorStart(ordered, options.after, cursorFingerprint, (item) => item.id);
-}
-function buildListPageExtras(limit, hasMore, nextCursor) {
-    return {
-        ...(limit !== undefined ? { applied_limit: limit } : {}),
-        has_more: hasMore,
-        truncated: hasMore,
-        next_cursor: nextCursor ?? null,
-    };
-}
-async function resolveListRuntimeContext(options, global) {
-    const pmRoot = resolvePmRoot(process.cwd(), global.path);
-    await assertInitializedTracker(pmRoot);
-    const settings = await readSettings(pmRoot);
-    const statusRegistry = resolveRuntimeStatusRegistry(settings.schema);
-    const runtimeFieldRegistry = resolveRuntimeFieldRegistry(settings.schema);
-    const invokedCommand = options.projectionCommand ?? "list";
-    const projection = parseProjectionConfig(options, invokedCommand);
-    validateListProjectionFields(projection, runtimeMetadataKeysForProjection(runtimeFieldRegistry.definitions), invokedCommand);
-    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);
-    if (options.includeBody || projectionNeedsBody || contentNeedsBody) {
-        return await listAllItemMetadataWithBody(runtime.pmRoot, runtime.settings.item_format, runtime.typeRegistry.type_to_folder, listWarnings, runtime.settings.schema);
-    }
-    if (projectionNeedsCollections || contentNeedsCollections) {
-        return await listAllItemMetadata(runtime.pmRoot, runtime.settings.item_format, runtime.typeRegistry.type_to_folder, listWarnings, runtime.settings.schema);
-    }
-    return await listAllItemMetadataLight(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);
-    }
-    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);
-    let lifecycleStatus;
-    if (options.lifecycleBucket === "in_progress") {
-        lifecycleStatus = [statusRegistry.in_progress_status];
-    }
-    else if (options.lifecycleBucket === "open") {
-        lifecycleStatus = [...statusRegistry.active_statuses]
-            .filter((entry) => entry !== statusRegistry.in_progress_status)
-            .sort((left, right) => left.localeCompare(right));
-    }
-    const resolvedStatus = explicitStatus ??
-        lifecycleStatus ??
-        resolveStatusFilter(status, statusRegistry);
-    const explicitAllStatuses = isStatusAllFilterInput(options.status);
-    const effectiveOptions = explicitStatus || explicitAllStatuses
-        ? { ...options, excludeTerminal: false }
-        : options;
-    let filtersStatus = "all";
-    if (explicitAllStatuses) {
-        filtersStatus = "all";
-    }
-    else if (explicitStatus !== undefined) {
-        filtersStatus =
-            explicitStatus.length === 1 ? explicitStatus[0] : explicitStatus;
-    }
-    else if (options.lifecycleBucket !== undefined) {
-        filtersStatus = options.lifecycleBucket;
-    }
-    else if (resolvedStatus !== undefined) {
-        filtersStatus =
-            resolvedStatus.length === 1 ? resolvedStatus[0] : resolvedStatus;
-    }
-    else if (effectiveOptions.excludeTerminal === true) {
-        filtersStatus = null;
-    }
-    return {
-        resolvedStatus,
-        explicitAllStatuses,
-        effectiveOptions,
-        filtersStatus,
-    };
-}
-function pageAndProjectListItems(ordered, options, projection, treeEnabled, cursorFingerprint) {
-    if (options.after !== undefined && options.offset !== undefined) {
-        throw new PmCliError("List --after cannot be combined with --offset.", EXIT_CODE.USAGE);
-    }
-    const limit = resolveListPageLimit(options, ordered.length);
-    const offset = resolveListPageStart(ordered, options, cursorFingerprint);
-    const limited = limit === undefined
-        ? ordered.slice(offset)
-        : ordered.slice(offset, offset + limit);
-    const projected = projectListItems(limited, projection, treeEnabled);
-    const totalMatched = ordered.length;
-    const hasMore = limited.length > 0 && offset + limited.length < totalMatched;
-    const nextCursor = hasMore && limited.length > 0
-        ? encodeQueryCursor(cursorFingerprint, limited[limited.length - 1].id, offset + limited.length - 1)
-        : undefined;
-    return {
-        projected,
-        totalMatched,
-        pageExtras: buildListPageExtras(limit, hasMore, nextCursor),
-    };
-}
-function buildListCursorFingerprint(status, options, ordering) {
-    return createQueryFingerprint("list", {
-        status,
-        options: selectCursorSemanticOptions(options, LIST_FILTER_FLAG_CONTRACTS),
-        sort: ordering.sortField ?? "default",
-        order: ordering.sortOrder,
-        tree: ordering.treeEnabled,
-        tree_depth: ordering.treeDepth ?? null,
-    });
-}
-async function tryLoadIndexedListPage(params) {
-    const { options, runtime, statusSelection, ordering } = params;
-    const supportedOptionKeys = new Set([
-        "status",
-        "limit",
-        "offset",
-        "compact",
-        "brief",
-        "full",
-        "fields",
-        "format",
-        "stream",
-        "includeBody",
-        "excludeTerminal",
-        "dependencyBlocked",
-        "lifecycleBucket",
-        "noTruncate",
-        "projectionCommand",
-        "truncate",
-        "notes",
-        "learnings",
-        "files",
-        "docs",
-        "tests",
-        "comments",
-        "deps",
-        "linkedCommand",
-    ]);
-    const projectionNeedsHeavyData = [
-        runtime.projection.mode === "full",
-        runtime.projection.fields.some((field) => {
-            const normalized = normalizeProjectionField(field);
-            return normalized === "body" || HEAVY_PROJECTION_FIELDS.has(normalized);
-        }),
-    ].includes(true);
-    const requiresFallback = [
-        options.limit === undefined,
-        options.after !== undefined,
-        options.noTruncate === true,
-        options.includeBody === true,
-        options.dependencyBlocked === true,
-        options.strictRead === true,
-        ordering.treeEnabled,
-        ordering.sortField !== undefined,
-        projectionNeedsHeavyData,
-        hasActiveOnReadHooks(),
-        Object.keys(runtime.runtimeFieldFilters).length > 0,
-        Object.entries(options).some(([key, value]) => value !== undefined && !supportedOptionKeys.has(key)),
-    ].includes(true);
-    if (requiresFallback) {
-        return null;
-    }
-    const indexState = await readItemMetadataDerivedIndexState(runtime.pmRoot, [
-        ...new Set(Object.values(runtime.typeRegistry.type_to_folder)),
-    ]);
-    if (!indexState)
-        return null;
-    const limit = parseIntegerLimit(options.limit);
-    const offset = parseOffset(options.offset) ?? 0;
-    const indexed = await queryItemMetadataIndex({
-        pmRoot: runtime.pmRoot,
-        expectedSourceCursor: indexState.source_cursor,
-        query: {
-            statuses: statusSelection.resolvedStatus,
-            excludeStatuses: statusSelection.resolvedStatus === undefined &&
-                statusSelection.effectiveOptions.excludeTerminal === true
-                ? [...runtime.statusRegistry.terminal_statuses]
-                : undefined,
-            terminalStatuses: [...runtime.statusRegistry.terminal_statuses],
-            limit,
-            offset,
-        },
-    });
-    if (!indexed)
-        return null;
-    const hasMore = indexed.items.length > 0 && offset + indexed.items.length < indexed.total;
-    const nextCursor = hasMore
-        ? encodeQueryCursor(buildListCursorFingerprint(statusSelection.filtersStatus, options, ordering), indexed.items.at(-1).id, offset + indexed.items.length - 1)
-        : undefined;
-    return {
-        projected: projectListItems(indexed.items, runtime.projection, false),
-        totalMatched: indexed.total,
-        pageExtras: buildListPageExtras(limit, hasMore, nextCursor),
-    };
-}
-function buildVerboseListFilters(params) {
-    const { filtersStatus, options, noTruncate, treeEnabled, treeDepth, sortField, sortOrder, runtimeFieldFilters, } = params;
-    const filters = {};
-    if (filtersStatus !== null) {
-        filters.status = filtersStatus;
-    }
-    if (options.dependencyBlocked === true) {
-        filters.blocked_semantics = "status_or_dependency";
-    }
-    const optionRecord = options;
-    for (const entry of VERBOSE_LIST_VALUE_FILTER_ECHO_ENTRIES) {
-        const value = optionRecord[entry.optionKey];
-        if (value !== undefined && value !== null) {
-            filters[entry.summaryKey] = value;
-        }
-    }
-    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));
-    applyListWindowFilterEcho(filters, options);
-    if (noTruncate) {
-        filters.no_truncate = true;
-    }
-    if (options.strictRead === true) {
-        filters.strict_read = true;
-    }
-    if (treeEnabled) {
-        filters.tree = true;
-        if (treeDepth !== undefined) {
-            filters.tree_depth = treeDepth;
-        }
-    }
-    if (sortField !== undefined) {
-        filters.sort = sortField;
-        filters.order = sortOrder;
-    }
-    filters.runtime_filters = runtimeFieldFilters;
-    return filters;
-}
-/** Execute a list query with projection-aware public result typing. */
-export async function runList(status, options, global) {
-    const runtime = await resolveListRuntimeContext(options, global);
-    const listWarnings = [];
-    const ordering = resolveListOrderingOptions(options);
-    const statusSelection = resolveListStatusSelection(status, options, runtime.statusRegistry);
-    const noTruncate = options.noTruncate === true;
-    const indexedPage = await tryLoadIndexedListPage({
-        options,
-        runtime,
-        statusSelection,
-        ordering,
-    });
-    let page = indexedPage;
-    if (!page) {
-        const items = await loadListItems(options, runtime, listWarnings);
-        const needsHierarchyIndexes = ordering.treeEnabled || trimNonEmpty(options.parent) !== undefined;
-        const hierarchyIndexes = needsHierarchyIndexes
-            ? indexHierarchyRelations(collectHierarchyRelations(items, resolveWorkspaceRelationshipKindRegistry()))
-            : undefined;
-        appendUnknownTagWarning(items, options.tag, listWarnings);
-        const filtered = applyFilters(items, statusSelection.resolvedStatus, statusSelection.effectiveOptions, runtime.typeRegistry, runtime.statusRegistry, runtime.runtimeFieldFilters, hierarchyIndexes?.parents_by_child);
-        // Edge-aware blocked selection (GH-578): classify against the complete
-        // loaded corpus so terminal blocker targets count as satisfied, then narrow
-        // the already-filtered rows to the shared blocked set.
-        const scoped = options.dependencyBlocked === true
-            ? (() => {
-                const blockedIds = collectDependencyBlockedIds(items, runtime.statusRegistry);
-                return filtered.filter((item) => blockedIds.has(item.id.trim().toLowerCase()));
-            })()
-            : filtered;
-        const sorted = sortItems(scoped, ordering.sortField, ordering.sortOrder, runtime.statusRegistry);
-        const ordered = ordering.treeEnabled
-            ? orderItemsAsTree(sorted, ordering.parentRoot, ordering.treeDepth, hierarchyIndexes, items)
-            : sorted;
-        page = pageAndProjectListItems(ordered, options, runtime.projection, ordering.treeEnabled, buildListCursorFingerprint(statusSelection.filtersStatus, options, ordering));
-    }
-    const now = nowIso();
-    const warnings = [...new Set(listWarnings)].sort((left, right) => left.localeCompare(right));
-    const completeness = resolveListCompleteness(warnings, indexedPage !== null, options.strictRead === 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: statusSelection.filtersStatus,
-            options,
-            treeEnabled: ordering.treeEnabled,
-            treeDepth: ordering.treeDepth,
-            sortField: ordering.sortField,
-            sortOrder: ordering.sortOrder,
-            runtimeFieldFilters: runtime.runtimeFieldFilters,
-        });
-        return {
-            items: page.projected,
-            count: page.projected.length,
-            total: page.totalMatched,
-            ...page.pageExtras,
-            completeness,
-            filters: compactFilters,
-            projection: {
-                mode: "compact",
-                fields: projectionFields,
-            },
-            ...(warnings.length > 0 ? { warnings } : {}),
-        };
-    }
-    return {
-        items: page.projected,
-        count: page.projected.length,
-        total: page.totalMatched,
-        ...page.pageExtras,
-        completeness,
-        filters: buildVerboseListFilters({
-            filtersStatus: statusSelection.filtersStatus,
-            options,
-            noTruncate,
-            treeEnabled: ordering.treeEnabled,
-            treeDepth: ordering.treeDepth,
-            sortField: ordering.sortField,
-            sortOrder: ordering.sortOrder,
-            runtimeFieldFilters: runtime.runtimeFieldFilters,
-        }),
-        projection: {
-            mode: runtime.projection.mode,
-            fields: projectionFields,
-        },
-        sorting: {
-            sort: ordering.sortField ?? "default",
-            order: ordering.sortField ? ordering.sortOrder : "asc",
-        },
-        now,
-        ...(warnings.length > 0 ? { warnings } : {}),
-    };
-}
-/** Public contract for test only, shared by SDK and presentation-layer consumers. */
-export const _testOnly = {
-    applyFilters,
-    buildCompactListFilterSummary,
-    buildContentFilterEcho,
-    buildGovernanceMissingFilterEcho,
-    resolveContentFieldFilters,
-    resolveMissingMetadataFilters,
-    compareBySortField,
-    compareDefaultSort,
-    compareNullableString,
-    compareNullableTimestamp,
-    normalizeProjectionField,
-    parseAssigneeFilter,
-    parseFieldSelectors,
-    parseIdsFilter,
-    parseOffset,
-    parseProjectionConfig,
-    resolveListUpdatedAfter,
-    resolveListPageLimit,
-    parseSortField,
-    parseSortOrder,
-    orderItemsAsTree,
-    projectListItems,
-    readListFieldValue,
-    runtimeMetadataKeysForProjection,
-    sortItems,
-    trimNonEmpty,
-    withTreeMetadata,
-};
+!(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]="9957767d-cc97-58ad-a46e-3f88a18a3c8c")}catch(e2){}})();import{assertInitializedTracker}from"../environment/tracker-preflight.js";import{getActiveExtensionRegistrations,hasActiveOnReadHooks}from"../../core/extensions/index.js";import{toItemRecord}from"../../core/item/item-record.js";import{isTerminalStatus}from"../../core/item/status.js";import{collectDependencyBlockedIds}from"../actionability.js";import{isStatusAllFilterInput,parseStatusFilterCsv}from"../../core/item/status-filter.js";import{resolveItemTypeRegistry}from"../../core/item/type-registry.js";import{parseIntegerLimit}from"./parsers.js";import{parsePriorityFilterSet,parseStringFilterSet,parseTypeFilterSet}from"./multi-value-filters.js";import{collectRuntimeFilterValues,matchesRuntimeFilters}from"../../core/schema/runtime-field-filters.js";import{hasMissingMetadataFilter,itemMatchesMissingMetadata,lifecycleClassifierFromStatusRegistry}from"../../core/governance/metadata-coverage.js";import{contentFiltersNeedBody,contentFiltersNeedCollections,hasContentFieldFilter,itemMatchesContentFilters}from"../../core/governance/content-fields.js";import{resolveRuntimeFieldRegistry,resolveRuntimeStatusRegistry}from"../../core/schema/runtime-schema.js";import{EXIT_CODE}from"../../core/shared/constants.js";import{PmCliError}from"../../core/shared/errors.js";import{compareTimestampStrings,matchesTimestampFilters,nowIso,resolveIsoOrRelative}from"../../core/shared/time.js";import{listAllItemMetadata,listAllItemMetadataLight,listAllItemMetadataWithBody}from"../../core/store/item-store.js";import{HEAVY_METADATA_KEYS,readItemMetadataDerivedIndexState}from"../../core/store/item-metadata-cache.js";import{queryItemMetadataIndex}from"../../core/store/item-metadata-query-index.js";import{resolvePmRoot}from"../../core/store/paths.js";import{readSettings}from"../../core/store/settings.js";import{LIST_FILTER_FLAG_CONTRACTS}from"../cli-contracts/flag-contracts.js";import{resolveWorkspaceRelationshipKindRegistry}from"../graph/assembly.js";import{collectHierarchyRelations,indexHierarchyRelations}from"../graph/hierarchy-integrity.js";import{createQueryFingerprint,encodeQueryCursor,resolveQueryCursorStart,selectCursorSemanticOptions}from"../pagination.js";import{BRIEF_LIST_FIELDS,DEFAULT_COMPACT_LIST_FIELDS,listListProjectionFields}from"./projection-contracts.js";import{BRIEF_LIST_FIELDS as BRIEF_LIST_FIELDS2,DEFAULT_COMPACT_LIST_FIELDS as DEFAULT_COMPACT_LIST_FIELDS2,LIST_COMMAND_DEFAULT_PROJECTIONS,listListProjectionFields as listListProjectionFields2}from"./projection-contracts.js";const resolveMissingMetadataFilters=options=>{return{acMissing:options.filterAcMissing===true,estimatesMissing:options.filterEstimatesMissing===true,resolutionMissing:options.filterResolutionMissing===true,metadataMissing:options.filterMetadataMissing===true,reviewerMissing:options.filterReviewerMissing===true,riskMissing:options.filterRiskMissing===true,confidenceMissing:options.filterConfidenceMissing===true,sprintMissing:options.filterSprintMissing===true,releaseMissing:options.filterReleaseMissing===true}};const CONTENT_FIELD_FLAG_MAPPINGS=[{field:"notes",presentKey:"hasNotes",absentKey:"noNotes",presentFlag:"--has-notes",absentFlag:"--no-notes"},{field:"learnings",presentKey:"hasLearnings",absentKey:"noLearnings",presentFlag:"--has-learnings",absentFlag:"--no-learnings"},{field:"files",presentKey:"hasFiles",absentKey:"noFiles",presentFlag:"--has-files",absentFlag:"--no-files"},{field:"docs",presentKey:"hasDocs",absentKey:"noDocs",presentFlag:"--has-docs",absentFlag:"--no-docs"},{field:"tests",presentKey:"hasTests",absentKey:"noTests",presentFlag:"--has-tests",absentFlag:"--no-tests"},{field:"comments",presentKey:"hasComments",absentKey:"noComments",presentFlag:"--has-comments",absentFlag:"--no-comments"},{field:"deps",presentKey:"hasDeps",absentKey:"noDeps",presentFlag:"--has-deps",absentFlag:"--no-deps"},{field:"body",presentKey:"hasBody",absentKey:"emptyBody",presentFlag:"--has-body",absentFlag:"--empty-body"},{field:"linked_command",presentKey:"hasLinkedCommand",absentKey:"noLinkedCommand",presentFlag:"--has-linked-command",absentFlag:"--no-linked-command"}];const resolveContentFieldFilters=options=>{const conflict=CONTENT_FIELD_FLAG_MAPPINGS.find(mapping=>options[mapping.presentKey]===true&&options[mapping.absentKey]===true);if(conflict){throw new PmCliError(`Cannot combine ${conflict.presentFlag} with ${conflict.absentFlag} for the same field.`,EXIT_CODE.USAGE)}return Object.fromEntries(CONTENT_FIELD_FLAG_MAPPINGS.flatMap(mapping=>{if(options[mapping.presentKey]===true){return[[mapping.field,"present"]]}return options[mapping.absentKey]===true?[[mapping.field,"absent"]]:[]}))};const LIST_SORT_FIELDS=["priority","deadline","updated_at","created_at","title","parent"];const LIST_SORT_ORDER_VALUES=["asc","desc"];const HEAVY_PROJECTION_FIELDS=new Set(HEAVY_METADATA_KEYS);function resolveListCompleteness(warnings,indexed,strict){const unreadableItemCount=warnings.filter(warning=>warning.startsWith("item_list_item_read_failed:")).length;const unreadableDirectoryCount=warnings.filter(warning=>warning.startsWith("item_list_directory_read_failed:")).length;const completeness={status:indexed?"unchecked":unreadableItemCount+unreadableDirectoryCount>0?"partial":"complete",unreadable_item_count:unreadableItemCount,unreadable_directory_count:unreadableDirectoryCount};if(strict&&completeness.status==="partial"){throw new PmCliError(`List source is incomplete: ${unreadableItemCount} item document(s) and ${unreadableDirectoryCount} item directory/directories could not be read.`,EXIT_CODE.GENERIC_FAILURE,{code:"list_source_incomplete",why:"Strict list reads fail closed so agents and SDK consumers never treat an omitted item as a complete workspace.",nextSteps:["Run pm validate --check-storage-integrity to locate unreadable tracker artifacts.","Repair the reported files or align the installed decoder version, then retry."]})}return completeness}function isNonEmptyRecord(value){return typeof value==="object"&&value!==null&&!Array.isArray(value)&&Object.keys(value).length>0}const CONTENT_FILTER_ECHO_ENTRIES=[{key:"hasNotes",summaryKey:"has_notes"},{key:"hasLearnings",summaryKey:"has_learnings"},{key:"hasFiles",summaryKey:"has_files"},{key:"hasDocs",summaryKey:"has_docs"},{key:"hasTests",summaryKey:"has_tests"},{key:"hasComments",summaryKey:"has_comments"},{key:"hasDeps",summaryKey:"has_deps"},{key:"hasBody",summaryKey:"has_body"},{key:"hasLinkedCommand",summaryKey:"has_linked_command"},{key:"noNotes",summaryKey:"no_notes"},{key:"noLearnings",summaryKey:"no_learnings"},{key:"noFiles",summaryKey:"no_files"},{key:"noDocs",summaryKey:"no_docs"},{key:"noTests",summaryKey:"no_tests"},{key:"noComments",summaryKey:"no_comments"},{key:"noDeps",summaryKey:"no_deps"},{key:"emptyBody",summaryKey:"empty_body"},{key:"noLinkedCommand",summaryKey:"no_linked_command"}];const GOVERNANCE_MISSING_ECHO_ENTRIES=[{key:"filterReviewerMissing",summaryKey:"filter_reviewer_missing"},{key:"filterRiskMissing",summaryKey:"filter_risk_missing"},{key:"filterConfidenceMissing",summaryKey:"filter_confidence_missing"},{key:"filterSprintMissing",summaryKey:"filter_sprint_missing"},{key:"filterReleaseMissing",summaryKey:"filter_release_missing"}];function applyContentFilterEcho(filters,options){for(const entry of CONTENT_FILTER_ECHO_ENTRIES){if(options[entry.key]===true){filters[entry.summaryKey]=true}}}function applyGovernanceMissingFilterEcho(filters,options){for(const entry of GOVERNANCE_MISSING_ECHO_ENTRIES){if(options[entry.key]===true){filters[entry.summaryKey]=true}}}function applyFilterValueEcho(filters,options,entries){for(const entry of entries){const value=options[entry.optionKey];if(value!==void 0){filters[entry.summaryKey]=entry.normalize?entry.normalize(value):value}}}function buildContentFilterEcho(options){const echo={};applyContentFilterEcho(echo,options);return echo}function buildGovernanceMissingFilterEcho(options){const echo={};applyGovernanceMissingFilterEcho(echo,options);return echo}const COMPACT_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"}];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"}];const LIST_RECENT_WINDOW="-7d";function buildCompactListFilterSummary(params){const{filtersStatus,options,treeEnabled,treeDepth,sortField,sortOrder,runtimeFieldFilters}=params;const filters={};if(filtersStatus!==null){filters.status=filtersStatus}if(options.dependencyBlocked===true){filters.blocked_semantics="status_or_dependency"}applyFilterValueEcho(filters,options,COMPACT_LIST_VALUE_FILTER_ECHO_ENTRIES);applyListWindowFilterEcho(filters,options);if(options.filterAcMissing===true){filters.filter_ac_missing=true}if(options.filterEstimatesMissing===true){filters.filter_estimates_missing=true}if(options.filterResolutionMissing===true){filters.filter_resolution_missing=true}if(options.filterMetadataMissing===true){filters.filter_metadata_missing=true}applyGovernanceMissingFilterEcho(filters,options);applyContentFilterEcho(filters,options);if(options.limit!==void 0){filters.limit=options.limit}if(options.offset!==void 0){filters.offset=options.offset}if(options.includeBody===true){filters.include_body=true}if(options.fields!==void 0){filters.fields=options.fields}if(treeEnabled){filters.tree=true;if(treeDepth!==void 0){filters.tree_depth=treeDepth}}if(sortField!==void 0){filters.sort=sortField;filters.order=sortOrder}if(isNonEmptyRecord(runtimeFieldFilters)){filters.runtime_filters=runtimeFieldFilters}return filters}function compareDefaultSort(left,right,statusRegistry){const leftTerminal=isTerminalStatus(left.status,statusRegistry);const rightTerminal=isTerminalStatus(right.status,statusRegistry);if(leftTerminal!==rightTerminal){return leftTerminal?1:-1}const byPriority=left.priority-right.priority;if(byPriority!==0){return byPriority}const byUpdated=compareTimestampStrings(right.updated_at,left.updated_at);if(byUpdated!==0){return byUpdated}return(left.id??"").localeCompare(right.id??"")}function sortItemsDefault(items,statusRegistry){return[...items].sort((left,right)=>compareDefaultSort(left,right,statusRegistry))}function parseDeadline(raw,fieldLabel){if(raw===void 0)return void 0;return resolveIsoOrRelative(raw,new Date,fieldLabel)}function parseTimestampWindow(raw,fieldLabel){if(raw==null)return void 0;const value=String(raw).trim();if(value.length===0)return void 0;return resolveIsoOrRelative(value,new Date,fieldLabel)}function resolveListUpdatedAfter(options){const hasUpdatedAfter=options.updatedAfter!=null&&String(options.updatedAfter).trim().length>0;const selectedWindows=[options.today===true,options.recent===true,hasUpdatedAfter].filter(selected=>selected).length;if(selectedWindows>1){throw new PmCliError("Choose only one updated_at window: --today, --recent, or --updated-after.",EXIT_CODE.USAGE)}if(options.today===true){const today=new Date;today.setHours(0,0,0,0);return today.toISOString()}if(options.recent===true){return parseTimestampWindow(LIST_RECENT_WINDOW,"recent")}return parseTimestampWindow(options.updatedAfter,"updated-after")}function applyListWindowFilterEcho(filters,options){if(options.today===true){filters.today=true}if(options.recent===true){filters.recent=true}}function parseIdsFilter(raw){if(raw==null)return void 0;const value=String(raw).trim();if(value.length===0){throw new PmCliError("--ids requires at least one non-empty item ID",EXIT_CODE.USAGE)}const ids=value.split(",").map(entry=>entry.trim()).filter(entry=>entry.length>0);if(ids.length===0){throw new PmCliError("--ids requires at least one non-empty item ID",EXIT_CODE.USAGE)}return new Set(ids)}function parseOffset(raw){if(raw===void 0)return void 0;const normalized=String(raw).trim();const parsed=normalized.length===0?Number.NaN:Number(normalized);if(!Number.isInteger(parsed)||parsed<0){throw new PmCliError("Offset filter must be a non-negative integer",EXIT_CODE.USAGE)}return parsed}function parseFieldSelectors(raw){if(raw===void 0){return void 0}const selectors=raw.split(",").map(entry=>entry.trim()).filter(entry=>entry.length>0);if(selectors.length===0){throw new PmCliError("List --fields requires a comma-separated list of field names",EXIT_CODE.USAGE)}return[...new Set(selectors)]}function parseProjectionConfig(options,invokedCommand=options.projectionCommand??"list"){const compactRequested=options.compact===true;const briefRequested=options.brief===true;const fullRequested=options.full===true;const fieldSelectors=parseFieldSelectors(options.fields);const enabledModes=Number(compactRequested)+Number(briefRequested)+Number(fullRequested)+Number(fieldSelectors!==void 0);if(enabledModes>1){throw new PmCliError("List projection options are mutually exclusive. Use one of --compact, --brief, --full, or --fields.",EXIT_CODE.USAGE,{code:"projection_options_mutually_exclusive",recovery:{suggested_retry:`pm ${invokedCommand} --brief`,suggested_retry_args:[invokedCommand,"--brief"]}})}if(fullRequested){return{mode:"full",fields:[]}}if(briefRequested){return{mode:"brief",fields:[...BRIEF_LIST_FIELDS]}}if(compactRequested){return{mode:"compact",fields:[...DEFAULT_COMPACT_LIST_FIELDS]}}if(fieldSelectors){return{mode:"fields",fields:[...new Set(fieldSelectors.map(field=>normalizeProjectionField(field)))]}}return{mode:"full",fields:[]}}function normalizeProjectionField(field){return field.startsWith("item.")?field.slice("item.".length):field}function validateListProjectionFields(projection,runtimeMetadataKeys,invokedCommand){if(projection.mode!=="fields"){return}const allowedValues=listListProjectionFields(runtimeMetadataKeys);const allowed=new Set(allowedValues.map(field=>normalizeProjectionField(field)));const unknown=projection.fields.filter(field=>!allowed.has(normalizeProjectionField(field)));if(unknown.length>0){throw new PmCliError(`Unknown list --fields value(s): ${unknown.join(", ")}`,EXIT_CODE.USAGE,{code:"unknown_field_projection",examples:["pm list-open --fields id,title,status,type,updated_at","pm list --fields id,title,parent,priority --limit 10","pm list-all --fields id,title,body --limit 5"],recovery:{allowed_values:allowedValues,suggested_retry:`pm ${invokedCommand} --fields id,title,status --limit 10`,suggested_retry_args:[invokedCommand,"--fields","id,title,status","--limit","10"]}})}}const LIST_SORT_FIELD_ALIASES=new Map([["updated","updated_at"],["update","updated_at"],["modified","updated_at"],["created","created_at"],["create","created_at"]]);function parseSortField(raw){if(raw===void 0){return void 0}const normalized=raw.trim().toLowerCase();const aliased=LIST_SORT_FIELD_ALIASES.get(normalized);if(aliased){return aliased}if(!LIST_SORT_FIELDS.includes(normalized)){throw new PmCliError(`Sort field must be one of ${LIST_SORT_FIELDS.join("|")} (aliases: updated->updated_at, created->created_at)`,EXIT_CODE.USAGE)}return normalized}function parseSortOrder(raw){if(raw===void 0){return void 0}const normalized=raw.trim().toLowerCase();if(!LIST_SORT_ORDER_VALUES.includes(normalized)){throw new PmCliError(`Sort order must be one of ${LIST_SORT_ORDER_VALUES.join("|")}`,EXIT_CODE.USAGE)}return normalized}function parseTreeDepth(raw){return parseIntegerLimit(raw,"--tree-depth")}function parseAssigneeFilter(raw){if(raw===void 0){return void 0}const normalized=raw.trim().toLowerCase();if(!normalized){throw new PmCliError("Assignee filter must be one of assigned|unassigned",EXIT_CODE.USAGE)}if(normalized!=="assigned"&&normalized!=="unassigned"){throw new PmCliError(`Invalid assignee filter "${raw}". Allowed: assigned|unassigned`,EXIT_CODE.USAGE)}return normalized}function resolveStatusFilter(status,statusRegistry){return parseStatusFilterCsv(status,statusRegistry,{strict:true})}function parseListTagFilters(raw){return parseStringFilterSet(raw,{label:"--tag",normalize:tag=>tag.toLowerCase()})}function appendUnknownTagWarning(items,rawTags,warnings){const requestedTags=parseListTagFilters(rawTags);if(requestedTags===void 0){return}const knownTags=new Set(items.flatMap(item=>item.tags.map(tag=>tag.trim().toLowerCase())));const unknownTags=[...requestedTags].filter(tag=>!knownTags.has(tag));if(unknownTags.length>0){warnings.push(`unknown_tags:${unknownTags.join(",")}`)}}function assertListAssigneeFilters(assigneeFilter,assigneeModeFilter){if(assigneeFilter&&[...assigneeFilter].some(value=>value.toLowerCase()==="none"||value.toLowerCase()==="null")){throw new PmCliError('--assignee no longer accepts "none" or "null". Use --assignee-filter unassigned.',EXIT_CODE.USAGE)}if(assigneeFilter!==void 0&&assigneeModeFilter==="unassigned"){throw new PmCliError("Cannot combine --assignee with --assignee-filter unassigned",EXIT_CODE.USAGE)}}function resolveListFilterSet(status,options,typeRegistry,statusRegistry){const assigneeFilter=parseStringFilterSet(options.assignee,{label:"--assignee"});const assigneeModeFilter=parseAssigneeFilter(options.assigneeFilter);assertListAssigneeFilters(assigneeFilter,assigneeModeFilter);const missingMetadataFilters=resolveMissingMetadataFilters(options);const contentFieldFilters=resolveContentFieldFilters(options);return{idsFilter:parseIdsFilter(options.ids),statusSet:status&&status.length>0?new Set(status):void 0,excludeTerminal:options.excludeTerminal===true,typeFilter:parseTypeFilterSet(options.type,typeRegistry),tagFilters:parseListTagFilters(options.tag),priorityFilter:parsePriorityFilterSet(options.priority),deadlineBefore:parseDeadline(options.deadlineBefore,"deadline-before"),deadlineAfter:parseDeadline(options.deadlineAfter,"deadline-after"),updatedAfter:resolveListUpdatedAfter(options),updatedBefore:parseTimestampWindow(options.updatedBefore,"updated-before"),createdAfter:parseTimestampWindow(options.createdAfter,"created-after"),createdBefore:parseTimestampWindow(options.createdBefore,"created-before"),assigneeFilter,assigneeModeFilter,parentFilter:options.parent?.trim(),treeEnabled:options.tree===true,sprintFilter:parseStringFilterSet(options.sprint,{label:"--sprint"}),releaseFilter:parseStringFilterSet(options.release,{label:"--release"}),missingMetadataFilters,missingMetadataActive:hasMissingMetadataFilter(missingMetadataFilters),lifecycleClassifier:lifecycleClassifierFromStatusRegistry(statusRegistry),contentFieldFilters,contentFiltersActive:hasContentFieldFilter(contentFieldFilters)}}function matchesListIdentityFilters(item,filters,statusRegistry){if(filters.idsFilter&&!filters.idsFilter.has(item.id))return false;if(filters.statusSet&&!filters.statusSet.has(item.status))return false;if(filters.excludeTerminal&&isTerminalStatus(item.status,statusRegistry))return false;if(filters.typeFilter&&!filters.typeFilter.has(item.type))return false;if(filters.tagFilters&&![...filters.tagFilters].some(tag=>(item.tags??[]).some(candidate=>candidate.trim().toLowerCase()===tag))){return false}return filters.priorityFilter===void 0||filters.priorityFilter.has(item.priority)}function matchesListDateFilters(item,filters){return matchesTimestampFilters(item,filters)}function matchesListAssigneeFilterSet(item,filters){if(filters.assigneeModeFilter==="assigned"&&!item.assignee)return false;if(filters.assigneeModeFilter==="unassigned"&&item.assignee)return false;return filters.assigneeFilter===void 0||item.assignee!==void 0&&filters.assigneeFilter.has(item.assignee)}function matchesListScopeFilters(item,filters,parentsByChild){const scalarParent=item.parent?.trim().toLowerCase();const logicalParentIds=[...new Set([...parentsByChild?.get(item.id.trim().toLowerCase())??[],...scalarParent?[scalarParent]:[]])];if(filters.parentFilter!==void 0&&!filters.treeEnabled&&!logicalParentIds.includes(filters.parentFilter.trim().toLowerCase()))return false;if(filters.sprintFilter!==void 0&&(item.sprint===void 0||!filters.sprintFilter.has(item.sprint)))return false;return filters.releaseFilter===void 0||item.release!==void 0&&filters.releaseFilter.has(item.release)}function matchesListFilterSet(item,filters,statusRegistry,runtimeFieldFilters,parentsByChild){if(!matchesListIdentityFilters(item,filters,statusRegistry)||!matchesListDateFilters(item,filters)||!matchesListAssigneeFilterSet(item,filters)||!matchesListScopeFilters(item,filters,parentsByChild)){return false}if(filters.missingMetadataActive&&!itemMatchesMissingMetadata(item,filters.missingMetadataFilters,filters.lifecycleClassifier)){return false}if(filters.contentFiltersActive&&!itemMatchesContentFilters(item,filters.contentFieldFilters)){return false}if(!matchesRuntimeFilters(item,runtimeFieldFilters)){return false}return true}function applyFilters(items,status,options,typeRegistry,statusRegistry,runtimeFieldFilters,parentsByChild){const filters=resolveListFilterSet(status,options,typeRegistry,statusRegistry);return items.filter(item=>matchesListFilterSet(item,filters,statusRegistry,runtimeFieldFilters,parentsByChild))}function trimNonEmpty(value){if(typeof value!=="string"){return void 0}const trimmed=value.trim();return trimmed.length>0?trimmed:void 0}function withTreeMetadata(item,depth,childCount,parentId){const itemRecord=toItemRecord(item);const title=typeof itemRecord.title==="string"?itemRecord.title:"";const parent=parentId??trimNonEmpty(typeof itemRecord.parent==="string"?itemRecord.parent:void 0)??null;return{...item,tree_depth:depth,tree_parent:parent,tree_children:childCount,tree_title:`${"  ".repeat(depth)}${title}`}}function buildListTreeIndexes(sortedItems,hierarchyIndexes){const byId=new Map;const childrenByParent=new Map;for(const item of sortedItems){const itemId=item.id.trim().toLowerCase();byId.set(itemId,item);const parentIds=hierarchyIndexes?hierarchyIndexes.parents_by_child.get(itemId)??[]:[trimNonEmpty(item.parent)?.toLowerCase()].filter(value=>value!==void 0);for(const parentId of parentIds){const children=childrenByParent.get(parentId)??[];children.push(item);childrenByParent.set(parentId,children)}}return{byId,childrenByParent}}function resolveListTreeRoots(sortedItems,parentRoot,byId,childrenByParent,hierarchyIndexes){return parentRoot?[...childrenByParent.get(parentRoot.toLowerCase())??[]]:sortedItems.filter(item=>{const parentIds=hierarchyIndexes?hierarchyIndexes.parents_by_child.get(item.id.trim().toLowerCase())??[]:[trimNonEmpty(item.parent)?.toLowerCase()].filter(value=>value!==void 0);return parentIds.every(parentId=>!byId.has(parentId))})}function orderItemsAsTree(sortedItems,parentRoot,maxDepth,hierarchyIndexes,completeItems=sortedItems){const{byId,childrenByParent}=buildListTreeIndexes(sortedItems,hierarchyIndexes);const roots=resolveListTreeRoots(sortedItems,parentRoot,byId,childrenByParent,hierarchyIndexes);const ordered=[];const visited=new Set;const canonicalIdByLowercase=new Map(completeItems.map(item=>[item.id.trim().toLowerCase(),item.id.trim()]));const pending=[...roots].reverse().map(node=>({node,depth:0,parentId:parentRoot===void 0?void 0:canonicalIdByLowercase.get(parentRoot.trim().toLowerCase())??parentRoot.trim()}));while(pending.length>0){const{node,depth,parentId}=pending.pop();const nodeId=node.id.trim().toLowerCase();if(visited.has(nodeId))continue;visited.add(nodeId);const children=childrenByParent.get(nodeId)??[];ordered.push(withTreeMetadata(node,depth,children.length,parentId));if(maxDepth!==void 0&&depth>=maxDepth)continue;for(const child of[...children].reverse()){pending.push({node:child,depth:depth+1,parentId:canonicalIdByLowercase.get(nodeId)})}}if(parentRoot===void 0&&maxDepth===void 0){for(const item of sortedItems){const itemId=item.id.trim().toLowerCase();if(visited.has(itemId))continue;visited.add(itemId);ordered.push(withTreeMetadata(item,0,childrenByParent.get(itemId)?.length??0))}}return ordered}function compareNullableString(left,right){if(left===right){return 0}if(left===null){return 1}if(right===null){return-1}return left.localeCompare(right)}function compareNullableTimestamp(left,right){if(left===right){return 0}if(left===null){return 1}if(right===null){return-1}return compareTimestampStrings(left,right)}function compareBySortField(left,right,field){switch(field){case"priority":return left.priority-right.priority;case"deadline":return compareNullableTimestamp(left.deadline??null,right.deadline??null);case"updated_at":return compareTimestampStrings(left.updated_at,right.updated_at);case"created_at":return compareTimestampStrings(left.created_at,right.created_at);case"title":return(left.title??"").localeCompare(right.title??"");case"parent":return compareNullableString(left.parent??null,right.parent??null);default:return 0}}function sortItems(items,sortField,sortOrder,statusRegistry){if(!sortField){return sortItemsDefault(items,statusRegistry)}return[...items].sort((left,right)=>{const byField=compareBySortField(left,right,sortField);if(byField!==0){return sortOrder==="desc"?-byField:byField}const fallback=compareDefaultSort(left,right,statusRegistry);return sortOrder==="desc"?-fallback:fallback})}function readListFieldValue(item,field,treeMode=false){const normalized=normalizeProjectionField(field.trim());if(normalized.length===0){return null}const itemRecord=toItemRecord(item);if(treeMode&&normalized==="title"&&typeof itemRecord.tree_title==="string"){return itemRecord.tree_title}if(Object.prototype.hasOwnProperty.call(itemRecord,normalized)){return itemRecord[normalized]??null}return null}function projectListItems(items,projection,treeMode=false){if(projection.mode==="full"){return items}return items.map(item=>{const projected={};for(const field of projection.fields){projected[field]=readListFieldValue(item,field,treeMode)}return projected})}function runtimeMetadataKeysForProjection(definitions){const keys=[];for(const field of definitions){keys.push(field.metadata_key)}return keys}function resolveListPageLimit(options,totalRows){if(options.noTruncate===true){return void 0}return parseIntegerLimit(options.limit)??(totalRows>=1e4?20:void 0)}function resolveListPageStart(ordered,options,cursorFingerprint){if(options.after===void 0){return parseOffset(options.offset)??0}return resolveQueryCursorStart(ordered,options.after,cursorFingerprint,item=>item.id)}function buildListPageExtras(limit,hasMore,nextCursor){return{...limit!==void 0?{applied_limit:limit}:{},has_more:hasMore,truncated:hasMore,next_cursor:nextCursor??null}}async function resolveListRuntimeContext(options,global2){const pmRoot=resolvePmRoot(process.cwd(),global2.path);await assertInitializedTracker(pmRoot);const settings=await readSettings(pmRoot);const statusRegistry=resolveRuntimeStatusRegistry(settings.schema);const runtimeFieldRegistry=resolveRuntimeFieldRegistry(settings.schema);const invokedCommand=options.projectionCommand??"list";const projection=parseProjectionConfig(options,invokedCommand);validateListProjectionFields(projection,runtimeMetadataKeysForProjection(runtimeFieldRegistry.definitions),invokedCommand);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);if(options.includeBody||projectionNeedsBody||contentNeedsBody){return await listAllItemMetadataWithBody(runtime.pmRoot,runtime.settings.item_format,runtime.typeRegistry.type_to_folder,listWarnings,runtime.settings.schema)}if(projectionNeedsCollections||contentNeedsCollections){return await listAllItemMetadata(runtime.pmRoot,runtime.settings.item_format,runtime.typeRegistry.type_to_folder,listWarnings,runtime.settings.schema)}return await listAllItemMetadataLight(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!==void 0){throw new PmCliError("List --tree-depth requires --tree",EXIT_CODE.USAGE)}if(!sortField&&options.order!==void 0){throw new PmCliError("List --order requires --sort",EXIT_CODE.USAGE)}return{sortField,sortOrder,treeEnabled,treeDepth:treeEnabled?parseTreeDepth(options.treeDepth):void 0,parentRoot:treeEnabled?trimNonEmpty(options.parent):void 0}}function resolveListStatusSelection(status,options,statusRegistry){const explicitStatus=resolveStatusFilter(options.status,statusRegistry);let lifecycleStatus;if(options.lifecycleBucket==="in_progress"){lifecycleStatus=[statusRegistry.in_progress_status]}else if(options.lifecycleBucket==="open"){lifecycleStatus=[...statusRegistry.active_statuses].filter(entry=>entry!==statusRegistry.in_progress_status).sort((left,right)=>left.localeCompare(right))}const resolvedStatus=explicitStatus??lifecycleStatus??resolveStatusFilter(status,statusRegistry);const explicitAllStatuses=isStatusAllFilterInput(options.status);const effectiveOptions=explicitStatus||explicitAllStatuses?{...options,excludeTerminal:false}:options;let filtersStatus="all";if(explicitAllStatuses){filtersStatus="all"}else if(explicitStatus!==void 0){filtersStatus=explicitStatus.length===1?explicitStatus[0]:explicitStatus}else if(options.lifecycleBucket!==void 0){filtersStatus=options.lifecycleBucket}else if(resolvedStatus!==void 0){filtersStatus=resolvedStatus.length===1?resolvedStatus[0]:resolvedStatus}else if(effectiveOptions.excludeTerminal===true){filtersStatus=null}return{resolvedStatus,explicitAllStatuses,effectiveOptions,filtersStatus}}function pageAndProjectListItems(ordered,options,projection,treeEnabled,cursorFingerprint){if(options.after!==void 0&&options.offset!==void 0){throw new PmCliError("List --after cannot be combined with --offset.",EXIT_CODE.USAGE)}const limit=resolveListPageLimit(options,ordered.length);const offset=resolveListPageStart(ordered,options,cursorFingerprint);const limited=limit===void 0?ordered.slice(offset):ordered.slice(offset,offset+limit);const projected=projectListItems(limited,projection,treeEnabled);const totalMatched=ordered.length;const hasMore=limited.length>0&&offset+limited.length<totalMatched;const nextCursor=hasMore&&limited.length>0?encodeQueryCursor(cursorFingerprint,limited[limited.length-1].id,offset+limited.length-1):void 0;return{projected,totalMatched,pageExtras:buildListPageExtras(limit,hasMore,nextCursor)}}function buildListCursorFingerprint(status,options,ordering){return createQueryFingerprint("list",{status,options:selectCursorSemanticOptions(options,LIST_FILTER_FLAG_CONTRACTS),sort:ordering.sortField??"default",order:ordering.sortOrder,tree:ordering.treeEnabled,tree_depth:ordering.treeDepth??null})}async function tryLoadIndexedListPage(params){const{options,runtime,statusSelection,ordering}=params;const supportedOptionKeys=new Set(["status","limit","offset","compact","brief","full","fields","format","stream","includeBody","excludeTerminal","dependencyBlocked","lifecycleBucket","noTruncate","projectionCommand","truncate","notes","learnings","files","docs","tests","comments","deps","linkedCommand"]);const projectionNeedsHeavyData=[runtime.projection.mode==="full",runtime.projection.fields.some(field=>{const normalized=normalizeProjectionField(field);return normalized==="body"||HEAVY_PROJECTION_FIELDS.has(normalized)})].includes(true);const requiresFallback=[options.limit===void 0,options.after!==void 0,options.noTruncate===true,options.includeBody===true,options.dependencyBlocked===true,options.strictRead===true,ordering.treeEnabled,ordering.sortField!==void 0,projectionNeedsHeavyData,hasActiveOnReadHooks(),Object.keys(runtime.runtimeFieldFilters).length>0,Object.entries(options).some(([key,value])=>value!==void 0&&!supportedOptionKeys.has(key))].includes(true);if(requiresFallback){return null}const indexState=await readItemMetadataDerivedIndexState(runtime.pmRoot,[...new Set(Object.values(runtime.typeRegistry.type_to_folder))]);if(!indexState)return null;const limit=parseIntegerLimit(options.limit);const offset=parseOffset(options.offset)??0;const indexed=await queryItemMetadataIndex({pmRoot:runtime.pmRoot,expectedSourceCursor:indexState.source_cursor,query:{statuses:statusSelection.resolvedStatus,excludeStatuses:statusSelection.resolvedStatus===void 0&&statusSelection.effectiveOptions.excludeTerminal===true?[...runtime.statusRegistry.terminal_statuses]:void 0,terminalStatuses:[...runtime.statusRegistry.terminal_statuses],limit,offset}});if(!indexed)return null;const hasMore=indexed.items.length>0&&offset+indexed.items.length<indexed.total;const nextCursor=hasMore?encodeQueryCursor(buildListCursorFingerprint(statusSelection.filtersStatus,options,ordering),indexed.items.at(-1).id,offset+indexed.items.length-1):void 0;return{projected:projectListItems(indexed.items,runtime.projection,false),totalMatched:indexed.total,pageExtras:buildListPageExtras(limit,hasMore,nextCursor)}}function buildVerboseListFilters(params){const{filtersStatus,options,noTruncate,treeEnabled,treeDepth,sortField,sortOrder,runtimeFieldFilters}=params;const filters={};if(filtersStatus!==null){filters.status=filtersStatus}if(options.dependencyBlocked===true){filters.blocked_semantics="status_or_dependency"}const optionRecord=options;for(const entry of VERBOSE_LIST_VALUE_FILTER_ECHO_ENTRIES){const value=optionRecord[entry.optionKey];if(value!==void 0&&value!==null){filters[entry.summaryKey]=value}}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));applyListWindowFilterEcho(filters,options);if(noTruncate){filters.no_truncate=true}if(options.strictRead===true){filters.strict_read=true}if(treeEnabled){filters.tree=true;if(treeDepth!==void 0){filters.tree_depth=treeDepth}}if(sortField!==void 0){filters.sort=sortField;filters.order=sortOrder}filters.runtime_filters=runtimeFieldFilters;return filters}async function runList(status,options,global2){const runtime=await resolveListRuntimeContext(options,global2);const listWarnings=[];const ordering=resolveListOrderingOptions(options);const statusSelection=resolveListStatusSelection(status,options,runtime.statusRegistry);const noTruncate=options.noTruncate===true;const indexedPage=await tryLoadIndexedListPage({options,runtime,statusSelection,ordering});let page=indexedPage;if(!page){const items=await loadListItems(options,runtime,listWarnings);const needsHierarchyIndexes=ordering.treeEnabled||trimNonEmpty(options.parent)!==void 0;const hierarchyIndexes=needsHierarchyIndexes?indexHierarchyRelations(collectHierarchyRelations(items,resolveWorkspaceRelationshipKindRegistry())):void 0;appendUnknownTagWarning(items,options.tag,listWarnings);const filtered=applyFilters(items,statusSelection.resolvedStatus,statusSelection.effectiveOptions,runtime.typeRegistry,runtime.statusRegistry,runtime.runtimeFieldFilters,hierarchyIndexes?.parents_by_child);const scoped=options.dependencyBlocked===true?(()=>{const blockedIds=collectDependencyBlockedIds(items,runtime.statusRegistry);return filtered.filter(item=>blockedIds.has(item.id.trim().toLowerCase()))})():filtered;const sorted=sortItems(scoped,ordering.sortField,ordering.sortOrder,runtime.statusRegistry);const ordered=ordering.treeEnabled?orderItemsAsTree(sorted,ordering.parentRoot,ordering.treeDepth,hierarchyIndexes,items):sorted;page=pageAndProjectListItems(ordered,options,runtime.projection,ordering.treeEnabled,buildListCursorFingerprint(statusSelection.filtersStatus,options,ordering))}const now=nowIso();const warnings=[...new Set(listWarnings)].sort((left,right)=>left.localeCompare(right));const completeness=resolveListCompleteness(warnings,indexedPage!==null,options.strictRead===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:statusSelection.filtersStatus,options,treeEnabled:ordering.treeEnabled,treeDepth:ordering.treeDepth,sortField:ordering.sortField,sortOrder:ordering.sortOrder,runtimeFieldFilters:runtime.runtimeFieldFilters});return{items:page.projected,count:page.projected.length,total:page.totalMatched,...page.pageExtras,completeness,filters:compactFilters,projection:{mode:"compact",fields:projectionFields},...warnings.length>0?{warnings}:{}}}return{items:page.projected,count:page.projected.length,total:page.totalMatched,...page.pageExtras,completeness,filters:buildVerboseListFilters({filtersStatus:statusSelection.filtersStatus,options,noTruncate,treeEnabled:ordering.treeEnabled,treeDepth:ordering.treeDepth,sortField:ordering.sortField,sortOrder:ordering.sortOrder,runtimeFieldFilters:runtime.runtimeFieldFilters}),projection:{mode:runtime.projection.mode,fields:projectionFields},sorting:{sort:ordering.sortField??"default",order:ordering.sortField?ordering.sortOrder:"asc"},now,...warnings.length>0?{warnings}:{}}}const _testOnly={applyFilters,buildCompactListFilterSummary,buildContentFilterEcho,buildGovernanceMissingFilterEcho,resolveContentFieldFilters,resolveMissingMetadataFilters,compareBySortField,compareDefaultSort,compareNullableString,compareNullableTimestamp,normalizeProjectionField,parseAssigneeFilter,parseFieldSelectors,parseIdsFilter,parseOffset,parseProjectionConfig,resolveListUpdatedAfter,resolveListPageLimit,parseSortField,parseSortOrder,orderItemsAsTree,projectListItems,readListFieldValue,runtimeMetadataKeysForProjection,sortItems,trimNonEmpty,withTreeMetadata};export{BRIEF_LIST_FIELDS2 as BRIEF_LIST_FIELDS,DEFAULT_COMPACT_LIST_FIELDS2 as DEFAULT_COMPACT_LIST_FIELDS,LIST_COMMAND_DEFAULT_PROJECTIONS,LIST_SORT_FIELDS,LIST_SORT_ORDER_VALUES,_testOnly,applyFilterValueEcho,buildContentFilterEcho,buildGovernanceMissingFilterEcho,listListProjectionFields2 as listListProjectionFields,resolveContentFieldFilters,resolveMissingMetadataFilters,runList};
 //# sourceMappingURL=list.js.map
-//# debugId=ccdb7d16-4f38-58d4-a19d-4ab1516cb1d7