@unbrained/pm-cli 2026.7.15 → 2026.7.17

package/dist/cli/commands/list.d.ts

@@ -1,213 +1,6 @@
-import { type ItemTypeRegistry } from "../../core/item/type-registry.js";
-import { type MissingMetadataFilters } from "../../core/governance/metadata-coverage.js";
-import { type ContentFieldFilters } from "../../core/governance/content-fields.js";
-import { type RuntimeStatusRegistry } from "../../core/schema/runtime-schema.js";
-import type { GlobalOptions } from "../../core/shared/command-types.js";
-import type { ItemMetadata, ItemStatus } from "../../types/index.js";
-import type { SharedItemFilterOptions } from "./item-filter-options.js";
-/** Documents the list options payload exchanged by command, SDK, and package integrations. */
-export interface ListOptions extends SharedItemFilterOptions {
-    /** Value that configures or reports ids for this contract. */
-    ids?: string;
-    /** Value that configures or reports assignee filter for this contract. */
-    assigneeFilter?: string;
-    /** Value that configures or reports today for this contract. */
-    today?: boolean;
-    /** Value that configures or reports recent for this contract. */
-    recent?: boolean;
-    /** Value that configures or reports limit for this contract. */
-    limit?: string;
-    /** Value that configures or reports offset for this contract. */
-    offset?: string;
-    /** Opaque cursor returned by a previous list page. */
-    after?: string;
-    /** Value that configures or reports no truncate for this contract. */
-    noTruncate?: boolean;
-    /** Value that configures or reports include body for this contract. */
-    includeBody?: boolean;
-    /** Value that configures or reports compact for this contract. */
-    compact?: boolean;
-    /** Value that configures or reports brief for this contract. */
-    brief?: boolean;
-    /** Value that configures or reports full for this contract. */
-    full?: boolean;
-    /** Value that configures or reports fields for this contract. */
-    fields?: string;
-    /** Value that configures or reports sort for this contract. */
-    sort?: string;
-    /** Value that configures or reports order for this contract. */
-    order?: string;
-    /** Value that configures or reports tree for this contract. */
-    tree?: boolean;
-    /** Value that configures or reports tree depth for this contract. */
-    treeDepth?: string;
-    /** Value that configures or reports exclude terminal for this contract. */
-    excludeTerminal?: boolean;
-    /** Value that configures or reports filter ac missing for this contract. */
-    filterAcMissing?: boolean;
-    /** Value that configures or reports filter estimates missing for this contract. */
-    filterEstimatesMissing?: boolean;
-    /** Value that configures or reports filter resolution missing for this contract. */
-    filterResolutionMissing?: boolean;
-    /** Value that configures or reports filter metadata missing for this contract. */
-    filterMetadataMissing?: boolean;
-}
-/** Extract the missing-metadata selection filters from list/update-many options. */
-export declare function resolveMissingMetadataFilters(options: {
-    filterAcMissing?: boolean;
-    filterEstimatesMissing?: boolean;
-    filterResolutionMissing?: boolean;
-    filterMetadataMissing?: boolean;
-    filterReviewerMissing?: boolean;
-    filterRiskMissing?: boolean;
-    filterConfidenceMissing?: boolean;
-    filterSprintMissing?: boolean;
-    filterReleaseMissing?: boolean;
-}): MissingMetadataFilters;
-/** 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 declare function resolveContentFieldFilters(options: Record<string, unknown>): ContentFieldFilters;
-/** Restricts listed item values accepted by command, SDK, and storage contracts. */
-export type ListedItem = ItemMetadata | (ItemMetadata & {
-    body: string;
-});
-type ListProjectionMode = "full" | "compact" | "fields";
-interface ListProjectionConfig {
-    mode: ListProjectionMode;
-    fields: string[];
-}
-/** Public contract for list sort fields, shared by SDK and presentation-layer consumers. */
-export declare const LIST_SORT_FIELDS: readonly ["priority", "deadline", "updated_at", "created_at", "title", "parent"];
-/** Restricts list sort field values accepted by command, SDK, and storage contracts. */
-export type ListSortField = (typeof LIST_SORT_FIELDS)[number];
-/** Supported values accepted by the list sort order contract. */
-export declare const LIST_SORT_ORDER_VALUES: readonly ["asc", "desc"];
-/** Restricts list sort order values accepted by command, SDK, and storage contracts. */
-export type ListSortOrder = (typeof LIST_SORT_ORDER_VALUES)[number];
-interface ListResultBase {
-    items: ListedItem[];
-    count: number;
-    total?: number;
-    /** Whether additional rows remain after this page. */
-    has_more?: boolean;
-    /** Opaque continuation cursor when additional rows remain. */
-    next_cursor?: string;
-    /** Effective page size, including an automatic at-scale bound. */
-    applied_limit?: number;
-    /** Explicit marker that the response is a bounded page. */
-    truncated?: true;
-    warnings?: string[];
-}
-/** Documents the list compact result payload exchanged by command, SDK, and package integrations. */
-export interface ListCompactResult extends ListResultBase {
-    /** Value that configures or reports filters for this contract. */
-    filters: Record<string, unknown>;
-    /** Value that configures or reports projection for this contract. */
-    projection?: undefined;
-    /** Value that configures or reports sorting for this contract. */
-    sorting?: undefined;
-    /** Value that configures or reports now for this contract. */
-    now?: undefined;
-}
-/** Documents the list verbose result payload exchanged by command, SDK, and package integrations. */
-export interface ListVerboseResult extends ListResultBase {
-    /** Value that configures or reports filters for this contract. */
-    filters: Record<string, unknown>;
-    /** Value that configures or reports projection for this contract. */
-    projection: {
-        mode: ListProjectionMode;
-        fields: string[] | null;
-    };
-    /** Value that configures or reports sorting for this contract. */
-    sorting: {
-        sort: ListSortField | "default";
-        order: ListSortOrder;
-    };
-    /** Value that configures or reports now for this contract. */
-    now: string;
-}
-/** Restricts list result values accepted by command, SDK, and storage contracts. */
-export type ListResult = ListCompactResult | ListVerboseResult;
-interface FilterValueEchoEntry {
-    optionKey: string;
-    summaryKey: string;
-    normalize?: (value: unknown) => unknown;
-}
 /**
- * Copies user-supplied option values into compact filter summaries.
+ * @module cli/commands/list
  *
- * 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.
+ * Compatibility export for the SDK-owned list/query implementation.
  */
-export declare function applyFilterValueEcho(filters: Record<string, unknown>, options: Record<string, unknown>, entries: ReadonlyArray<FilterValueEchoEntry>): void;
-/** Implements build content filter echo for the public runtime surface of this module. */
-export declare function buildContentFilterEcho(options: Record<string, unknown>): Record<string, true>;
-/** Implements build governance missing filter echo for the public runtime surface of this module. */
-export declare function buildGovernanceMissingFilterEcho(options: Record<string, unknown>): Record<string, true>;
-declare function buildCompactListFilterSummary(params: {
-    filtersStatus: string | string[] | null;
-    options: ListOptions;
-    treeEnabled: boolean;
-    treeDepth: number | undefined;
-    sortField: ListSortField | undefined;
-    sortOrder: ListSortOrder;
-    runtimeFieldFilters: Record<string, unknown>;
-}): Record<string, unknown>;
-declare function compareDefaultSort(left: ListedItem, right: ListedItem, statusRegistry: RuntimeStatusRegistry): number;
-declare function resolveListUpdatedAfter(options: ListOptions): string | undefined;
-declare function parseIdsFilter(raw: unknown): Set<string> | undefined;
-declare function parseOffset(raw: string | undefined): number | undefined;
-declare function parseFieldSelectors(raw: string | undefined): string[] | undefined;
-declare function parseProjectionConfig(options: ListOptions): ListProjectionConfig;
-declare function normalizeProjectionField(field: string): string;
-declare function parseSortField(raw: string | undefined): ListSortField | undefined;
-declare function parseSortOrder(raw: string | undefined): ListSortOrder | undefined;
-declare function parseAssigneeFilter(raw: string | undefined): "assigned" | "unassigned" | undefined;
-declare function applyFilters(items: ListedItem[], status: ItemStatus[] | undefined, options: ListOptions, typeRegistry: ItemTypeRegistry, statusRegistry: RuntimeStatusRegistry, runtimeFieldFilters: Record<string, unknown>): ListedItem[];
-declare function trimNonEmpty(value: string | undefined): string | undefined;
-declare function withTreeMetadata(item: ListedItem, depth: number, childCount: number): ListedItem;
-declare function orderItemsAsTree(sortedItems: ListedItem[], parentRoot: string | undefined, maxDepth: number | undefined): ListedItem[];
-declare function compareNullableString(left: string | null, right: string | null): number;
-declare function compareNullableTimestamp(left: string | null, right: string | null): number;
-declare function compareBySortField(left: ListedItem, right: ListedItem, field: ListSortField): number;
-declare function sortItems(items: ListedItem[], sortField: ListSortField | undefined, sortOrder: ListSortOrder, statusRegistry: RuntimeStatusRegistry): ListedItem[];
-declare function readListFieldValue(item: ListedItem, field: string, treeMode?: boolean): unknown;
-declare function projectListItems(items: ListedItem[], projection: ListProjectionConfig, treeMode?: boolean): ListedItem[];
-declare function runtimeMetadataKeysForProjection(definitions: Array<{
-    metadata_key: string;
-}>): string[];
-declare function resolveListPageLimit(options: ListOptions, totalRows: number): number | undefined;
-/** Implements run list for the public runtime surface of this module. */
-export declare function runList(status: ItemStatus | undefined, options: ListOptions, global: GlobalOptions): Promise<ListResult>;
-/** Public contract for test only, shared by SDK and presentation-layer consumers. */
-export declare const _testOnly: {
-    applyFilters: typeof applyFilters;
-    buildCompactListFilterSummary: typeof buildCompactListFilterSummary;
-    buildContentFilterEcho: typeof buildContentFilterEcho;
-    buildGovernanceMissingFilterEcho: typeof buildGovernanceMissingFilterEcho;
-    resolveContentFieldFilters: typeof resolveContentFieldFilters;
-    resolveMissingMetadataFilters: typeof resolveMissingMetadataFilters;
-    compareBySortField: typeof compareBySortField;
-    compareDefaultSort: typeof compareDefaultSort;
-    compareNullableString: typeof compareNullableString;
-    compareNullableTimestamp: typeof compareNullableTimestamp;
-    normalizeProjectionField: typeof normalizeProjectionField;
-    parseAssigneeFilter: typeof parseAssigneeFilter;
-    parseFieldSelectors: typeof parseFieldSelectors;
-    parseIdsFilter: typeof parseIdsFilter;
-    parseOffset: typeof parseOffset;
-    parseProjectionConfig: typeof parseProjectionConfig;
-    resolveListUpdatedAfter: typeof resolveListUpdatedAfter;
-    resolveListPageLimit: typeof resolveListPageLimit;
-    parseSortField: typeof parseSortField;
-    parseSortOrder: typeof parseSortOrder;
-    orderItemsAsTree: typeof orderItemsAsTree;
-    projectListItems: typeof projectListItems;
-    readListFieldValue: typeof readListFieldValue;
-    runtimeMetadataKeysForProjection: typeof runtimeMetadataKeysForProjection;
-    sortItems: typeof sortItems;
-    trimNonEmpty: typeof trimNonEmpty;
-    withTreeMetadata: typeof withTreeMetadata;
-};
-export {};
+export * from "../../sdk/query/list.js";