@unbrained/pm-cli 2026.10.13 → 2026.10.15

package/dist/sdk/query/list.d.ts

@@ -3,51 +3,51 @@ import { type MissingMetadataFilters } from "../../core/governance/metadata-cove
 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 { ItemMetadata,ItemStatus } from "../../types/index.js";
 import type { SharedItemFilterOptions } from "./item-filter-options.js";
 import { type HierarchyRelationIndexes } from "../graph/hierarchy-integrity.js";
-import { type ListCommandName, type ListProjectionMode } from "./projection-contracts.js";
-export { BRIEF_LIST_FIELDS, DEFAULT_COMPACT_LIST_FIELDS, LIST_COMMAND_DEFAULT_PROJECTIONS, listListProjectionFields, type ListCommandName, type ListProjectionMode, } from "./projection-contracts.js";
+import { type ListCommandName,type ListProjectionMode } from "./projection-contracts.js";
+export { BRIEF_LIST_FIELDS,DEFAULT_COMPACT_LIST_FIELDS,LIST_COMMAND_DEFAULT_PROJECTIONS,listListProjectionFields,type ListCommandName,type ListProjectionMode,} from "./projection-contracts.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;
+ids?:string;
 /** Value that configures or reports assignee filter for this contract. */
-assigneeFilter?: string;
+assigneeFilter?:string;
 /** Value that configures or reports today for this contract. */
-today?: boolean;
+today?:boolean;
 /** Value that configures or reports recent for this contract. */
-recent?: boolean;
+recent?:boolean;
 /** Value that configures or reports limit for this contract. */
-limit?: string;
+limit?:string;
 /** Value that configures or reports offset for this contract. */
-offset?: string;
+offset?:string;
 /** Opaque cursor returned by a previous list page. */
-after?: string;
+after?:string;
 /** Force the complete matched set and deliberately override `limit`; use plain `limit` for bounded pagination. */
-noTruncate?: boolean;
+noTruncate?:boolean;
 /** Value that configures or reports include body for this contract. */
-includeBody?: boolean;
+includeBody?:boolean;
 /** Value that configures or reports compact for this contract. */
-compact?: boolean;
+compact?:boolean;
 /** Value that configures or reports brief for this contract. */
-brief?: boolean;
+brief?:boolean;
 /** Value that configures or reports full for this contract. */
-full?: boolean;
+full?:boolean;
 /** Value that configures or reports fields for this contract. */
-fields?: string;
+fields?:string;
 /** Value that configures or reports sort for this contract. */
-sort?: string;
+sort?:string;
 /** Value that configures or reports order for this contract. */
-order?: string;
+order?:string;
 /** Value that configures or reports tree for this contract. */
-tree?: boolean;
+tree?:boolean;
 /** Value that configures or reports tree depth for this contract. */
-treeDepth?: string;
+treeDepth?:string;
 /** Value that configures or reports exclude terminal for this contract. */
-excludeTerminal?: boolean;
+excludeTerminal?:boolean;
 /** Fail instead of returning a partial result when any item or item directory cannot be read. */
-strictRead?: boolean;
+strictRead?:boolean;
 /**
      * Select items that are blocked under the shared edge-aware definition
      * (blocked lifecycle status OR at least one open `blocked_by` edge), the
@@ -55,157 +55,157 @@ strictRead?: boolean;
      * `list-blocked` command variant; plain `--status blocked` stays a raw
      * lifecycle-status filter.
      */
-dependencyBlocked?: boolean;
+dependencyBlocked?:boolean;
 /** Select a role-derived active lifecycle bucket instead of one literal status id. */
-lifecycleBucket?: "open" | "in_progress";
+lifecycleBucket?:"open" | "in_progress";
 /** Value that configures or reports filter ac missing for this contract. */
-filterAcMissing?: boolean;
+filterAcMissing?:boolean;
 /** Value that configures or reports filter estimates missing for this contract. */
-filterEstimatesMissing?: boolean;
+filterEstimatesMissing?:boolean;
 /** Value that configures or reports filter resolution missing for this contract. */
-filterResolutionMissing?: boolean;
+filterResolutionMissing?:boolean;
 /** Value that configures or reports filter metadata missing for this contract. */
-filterMetadataMissing?: boolean;
+filterMetadataMissing?:boolean;
 }
 /** Adapter-only list context that never expands the public SDK options contract. */
 interface ListRuntimeOptions extends ListOptions {
-projectionCommand?: ListCommandName;
+projectionCommand?:ListCommandName;
 }
 /** Extract the missing-metadata selection filters from list/update-many options. */
-export declare const resolveMissingMetadataFilters: (options: {
-filterAcMissing?: boolean;
-filterEstimatesMissing?: boolean;
-filterResolutionMissing?: boolean;
-filterMetadataMissing?: boolean;
-filterReviewerMissing?: boolean;
-filterRiskMissing?: boolean;
-filterConfidenceMissing?: boolean;
-filterSprintMissing?: boolean;
-filterReleaseMissing?: boolean;
+export declare const 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 const resolveContentFieldFilters: (options: Record<string, unknown>) => ContentFieldFilters;
+export declare const resolveContentFieldFilters:(options:Record<string,unknown>) => ContentFieldFilters;
 /** Restricts listed item values accepted by command, SDK, and storage contracts. */
 export type ListedItem = ItemMetadata | (ItemMetadata & {
-body: string;
+body:string;
 });
 /** Tree-only metadata added when list results are ordered hierarchically. */
 export interface ListTreeMetadata {
 /** Zero-based depth relative to the selected tree root. */
-tree_depth: number;
+tree_depth:number;
 /** Parent item ID, or null for a root row. */
-tree_parent: string | null;
+tree_parent:string | null;
 /** Number of direct children represented by the row. */
-tree_children: number;
+tree_children:number;
 /** Indented display title for token-efficient tree rendering. */
-tree_title: string;
+tree_title:string;
 }
 /** Full metadata enriched with tree-only fields. */
 export type ListTreeItem = ListedItem & ListTreeMetadata;
 /** Stable typed core of a projected list row (GH-601 / pm-x29o): the fields of the compact default projection, each optional because `--fields` can deselect any of them, but typed so `row.id` and friends are never `unknown`. */
 export interface ListProjectedItemCore {
 /** Item id (always present in the compact default projection). */
-id?: string;
+id?:string;
 /** Item title. */
-title?: string;
+title?:string;
 /** Item lifecycle status (workspace schemas may define custom statuses). */
-status?: string;
+status?:string;
 /** Item type name (workspace schemas may define custom types). */
-type?: string;
+type?:string;
 /** Item priority (0 highest through 4 lowest). */
-priority?: number;
+priority?:number;
 /** Parent item id, or null for root items. */
-parent?: string | null;
+parent?:string | null;
 /** ISO timestamp of the last mutation. */
-updated_at?: string;
+updated_at?:string;
 }
 /** A compact or explicitly selected field projection: typed core fields plus whatever else `--fields` selected. */
-export type ListProjectedItem = ListProjectedItemCore & Record<string, unknown>;
+export type ListProjectedItem = ListProjectedItemCore & Record<string,unknown>;
 /** Honest union of item shapes returned by the list engine. */
 export type ListResultItem = ListedItem | ListTreeItem | ListProjectedItem;
 interface ListProjectionConfig {
-mode: ListProjectionMode;
-fields: string[];
+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"];
+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"];
+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: ListResultItem[];
-count: number;
+items:ListResultItem[];
+count:number;
 /** Total rows matched before pagination. Stable on every list envelope. */
-total: number;
+total:number;
 /** Whether additional rows remain after this page. */
-has_more: boolean;
+has_more:boolean;
 /** Opaque continuation cursor when additional rows remain. */
-next_cursor: string | null;
+next_cursor:string | null;
 /** Effective page size, including an automatic at-scale bound. */
-applied_limit?: number;
+applied_limit?:number;
 /** Explicit marker that the response is a bounded page. */
-truncated: boolean;
+truncated:boolean;
 /** Machine-readable truthfulness contract for the source corpus behind this page. */
-completeness: {
+completeness:{
 /** Complete after a source scan, partial when reads failed, or unchecked when served from a derived index. */
-status: "complete" | "partial" | "unchecked";
+status:"complete" | "partial" | "unchecked";
 /** Item documents omitted because they could not be read or decoded. */
-unreadable_item_count: number;
+unreadable_item_count:number;
 /** Type directories omitted because they could not be read. */
-unreadable_directory_count: number;
+unreadable_directory_count:number;
 };
-warnings?: string[];
+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>;
+filters:Record<string,unknown>;
 /** Value that configures or reports projection for this contract. */
-projection: {
-mode: "compact";
-fields: string[];
+projection:{
+mode:"compact";
+fields:string[];
 };
 /** Value that configures or reports sorting for this contract. */
-sorting?: undefined;
+sorting?:undefined;
 /** Value that configures or reports now for this contract. */
-now?: undefined;
+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>;
+filters:Record<string,unknown>;
 /** Value that configures or reports projection for this contract. */
-projection: {
-mode: ListProjectionMode;
-fields: string[] | null;
+projection:{
+mode:ListProjectionMode;
+fields:string[] | null;
 };
 /** Value that configures or reports sorting for this contract. */
-sorting: {
-sort: ListSortField | "default";
-order: ListSortOrder;
+sorting:{
+sort:ListSortField | "default";
+order:ListSortOrder;
 };
 /** Value that configures or reports now for this contract. */
-now: string;
+now:string;
 }
 /** Verbose full-record result returned when `full: true` is requested. */
 export interface ListFullResult extends ListVerboseResult {
 /** Full metadata rows, optionally enriched with tree metadata. */
-items: Array<ListedItem | ListTreeItem>;
+items:Array<ListedItem | ListTreeItem>;
 /** Discriminator proving that rows are complete metadata records. */
-projection: {
-mode: "full";
-fields: null;
+projection:{
+mode:"full";
+fields:null;
 };
 }
 /** 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;
+optionKey:string;
+summaryKey:string;
+normalize?:(value:unknown) => unknown;
 }
 /**
  * Copies user-supplied option values into compact filter summaries.
@@ -215,87 +215,87 @@ normalize?: (value: unknown) => unknown;
  * list and search command summaries from drifting as new scalar filters are
  * added.
  */
-export declare function applyFilterValueEcho(filters: Record<string, unknown>, options: Record<string, unknown>, entries: ReadonlyArray<FilterValueEchoEntry>): void;
+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>;
+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: ListRuntimeOptions, invokedCommand?: ListCommandName): 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>, parentsByChild?: HierarchyRelationIndexes["parents_by_child"]): ListedItem[];
-declare function trimNonEmpty(value: string | undefined): string | undefined;
-declare function withTreeMetadata(item: ListedItem, depth: number, childCount: number, parentId?: string): ListTreeItem;
-declare function orderItemsAsTree(sortedItems: ListedItem[], parentRoot: string | undefined, maxDepth: number | undefined, hierarchyIndexes?: HierarchyRelationIndexes, completeItems?: readonly ListedItem[]): 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): ListResultItem[];
-declare function runtimeMetadataKeysForProjection(definitions: Array<{
-metadata_key: string;
-}>): string[];
-declare function resolveListPageLimit(options: ListOptions, totalRows: number): number | undefined;
+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:ListRuntimeOptions,invokedCommand?:ListCommandName):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>,parentsByChild?:HierarchyRelationIndexes["parents_by_child"]):ListedItem[];
+declare function trimNonEmpty(value:string | undefined):string | undefined;
+declare function withTreeMetadata(item:ListedItem,depth:number,childCount:number,parentId?:string):ListTreeItem;
+declare function orderItemsAsTree(sortedItems:ListedItem[],parentRoot:string | undefined,maxDepth:number | undefined,hierarchyIndexes?:HierarchyRelationIndexes,completeItems?:readonly ListedItem[]):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):ListResultItem[];
+declare function runtimeMetadataKeysForProjection(definitions:Array<{
+metadata_key:string;
+}>):string[];
+declare function resolveListPageLimit(options:ListOptions,totalRows:number):number | undefined;
 /** Return complete item metadata when the caller explicitly requests full projection. */
-export declare function runList(status: ItemStatus | undefined, options: ListOptions & {
-full: true;
-}, global: GlobalOptions): Promise<ListFullResult>;
+export declare function runList(status:ItemStatus | undefined,options:ListOptions & {
+full:true;
+},global:GlobalOptions):Promise<ListFullResult>;
 /** Implements run list for the public runtime surface of this module. */
-export declare function runList(status: ItemStatus | undefined, options: ListOptions, global: GlobalOptions): Promise<ListResult>;
+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: (options: Record<string, unknown>) => ContentFieldFilters;
-resolveMissingMetadataFilters: (options: {
-filterAcMissing?: boolean;
-filterEstimatesMissing?: boolean;
-filterResolutionMissing?: boolean;
-filterMetadataMissing?: boolean;
-filterReviewerMissing?: boolean;
-filterRiskMissing?: boolean;
-filterConfidenceMissing?: boolean;
-filterSprintMissing?: boolean;
-filterReleaseMissing?: boolean;
+export declare const _testOnly:{
+applyFilters:typeof applyFilters;
+buildCompactListFilterSummary:typeof buildCompactListFilterSummary;
+buildContentFilterEcho:typeof buildContentFilterEcho;
+buildGovernanceMissingFilterEcho:typeof buildGovernanceMissingFilterEcho;
+resolveContentFieldFilters:(options:Record<string,unknown>) => ContentFieldFilters;
+resolveMissingMetadataFilters:(options:{
+filterAcMissing?:boolean;
+filterEstimatesMissing?:boolean;
+filterResolutionMissing?:boolean;
+filterMetadataMissing?:boolean;
+filterReviewerMissing?:boolean;
+filterRiskMissing?:boolean;
+filterConfidenceMissing?:boolean;
+filterSprintMissing?:boolean;
+filterReleaseMissing?:boolean;
 }) => MissingMetadataFilters;
-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;
+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;
 };