@unbrained/pm-cli 2026.10.12 → 2026.10.13

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

@@ -10,122 +10,122 @@ import { type ListCommandName, type ListProjectionMode } from "./projection-cont
 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;
-    /** 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;
-    /** Force the complete matched set and deliberately override `limit`; use plain `limit` for bounded pagination. */
-    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;
-    /** Fail instead of returning a partial result when any item or item directory cannot be read. */
-    strictRead?: boolean;
-    /**
+/** 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;
+/** Force the complete matched set and deliberately override `limit`; use plain `limit` for bounded pagination. */
+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;
+/** Fail instead of returning a partial result when any item or item directory cannot be read. */
+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
      * same classification `pm next` and `pm context` use (GH-578). Set by the
      * `list-blocked` command variant; plain `--status blocked` stays a raw
      * lifecycle-status filter.
      */
-    dependencyBlocked?: boolean;
-    /** Select a role-derived active lifecycle bucket instead of one literal status id. */
-    lifecycleBucket?: "open" | "in_progress";
-    /** 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;
+dependencyBlocked?: boolean;
+/** Select a role-derived active lifecycle bucket instead of one literal status id. */
+lifecycleBucket?: "open" | "in_progress";
+/** 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;
 }
 /** 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;
+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;
 /** 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;
-    /** Parent item ID, or null for a root row. */
-    tree_parent: string | null;
-    /** Number of direct children represented by the row. */
-    tree_children: number;
-    /** Indented display title for token-efficient tree rendering. */
-    tree_title: string;
+/** Zero-based depth relative to the selected tree root. */
+tree_depth: number;
+/** Parent item ID, or null for a root row. */
+tree_parent: string | null;
+/** Number of direct children represented by the row. */
+tree_children: number;
+/** Indented display title for token-efficient tree rendering. */
+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;
-    /** Item title. */
-    title?: string;
-    /** Item lifecycle status (workspace schemas may define custom statuses). */
-    status?: string;
-    /** Item type name (workspace schemas may define custom types). */
-    type?: string;
-    /** Item priority (0 highest through 4 lowest). */
-    priority?: number;
-    /** Parent item id, or null for root items. */
-    parent?: string | null;
-    /** ISO timestamp of the last mutation. */
-    updated_at?: string;
+/** Item id (always present in the compact default projection). */
+id?: string;
+/** Item title. */
+title?: string;
+/** Item lifecycle status (workspace schemas may define custom statuses). */
+status?: string;
+/** Item type name (workspace schemas may define custom types). */
+type?: string;
+/** Item priority (0 highest through 4 lowest). */
+priority?: number;
+/** Parent item id, or null for root items. */
+parent?: string | null;
+/** ISO timestamp of the last mutation. */
+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>;
 /** 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"];
@@ -136,76 +136,76 @@ 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;
-    /** Total rows matched before pagination. Stable on every list envelope. */
-    total: number;
-    /** Whether additional rows remain after this page. */
-    has_more: boolean;
-    /** Opaque continuation cursor when additional rows remain. */
-    next_cursor: string | null;
-    /** Effective page size, including an automatic at-scale bound. */
-    applied_limit?: number;
-    /** Explicit marker that the response is a bounded page. */
-    truncated: boolean;
-    /** Machine-readable truthfulness contract for the source corpus behind this page. */
-    completeness: {
-        /** Complete after a source scan, partial when reads failed, or unchecked when served from a derived index. */
-        status: "complete" | "partial" | "unchecked";
-        /** Item documents omitted because they could not be read or decoded. */
-        unreadable_item_count: number;
-        /** Type directories omitted because they could not be read. */
-        unreadable_directory_count: number;
-    };
-    warnings?: string[];
+items: ListResultItem[];
+count: number;
+/** Total rows matched before pagination. Stable on every list envelope. */
+total: number;
+/** Whether additional rows remain after this page. */
+has_more: boolean;
+/** Opaque continuation cursor when additional rows remain. */
+next_cursor: string | null;
+/** Effective page size, including an automatic at-scale bound. */
+applied_limit?: number;
+/** Explicit marker that the response is a bounded page. */
+truncated: boolean;
+/** Machine-readable truthfulness contract for the source corpus behind this page. */
+completeness: {
+/** Complete after a source scan, partial when reads failed, or unchecked when served from a derived index. */
+status: "complete" | "partial" | "unchecked";
+/** Item documents omitted because they could not be read or decoded. */
+unreadable_item_count: number;
+/** Type directories omitted because they could not be read. */
+unreadable_directory_count: number;
+};
+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: {
-        mode: "compact";
-        fields: string[];
-    };
-    /** Value that configures or reports sorting for this contract. */
-    sorting?: undefined;
-    /** Value that configures or reports now for this contract. */
-    now?: undefined;
+/** Value that configures or reports filters for this contract. */
+filters: Record<string, unknown>;
+/** Value that configures or reports projection for this contract. */
+projection: {
+mode: "compact";
+fields: string[];
+};
+/** 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;
+/** 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;
 }
 /** 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>;
-    /** Discriminator proving that rows are complete metadata records. */
-    projection: {
-        mode: "full";
-        fields: null;
-    };
+/** Full metadata rows, optionally enriched with tree metadata. */
+items: Array<ListedItem | ListTreeItem>;
+/** Discriminator proving that rows are complete metadata records. */
+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.
@@ -221,13 +221,13 @@ export declare function buildContentFilterEcho(options: Record<string, unknown>)
 /** 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>;
+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;
@@ -250,52 +250,52 @@ declare function sortItems(items: ListedItem[], sortField: ListSortField | undef
 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;
+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;
+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>;
 /** 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;
-    }) => 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;
+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;
 };

package/dist/sdk/query/multi-value-filters.d.ts

@@ -7,10 +7,10 @@ import { type ItemTypeRegistry } from "../../core/item/type-registry.js";
 import type { ItemType } from "../../types/index.js";
 /** Options for parsing one repeatable or comma-separated query-filter value. */
 export interface MultiValueFilterOptions {
-    /** User-facing flag spelling included in validation errors. */
-    label: string;
-    /** Normalize each decoded token before de-duplication. */
-    normalize?: (value: string) => string;
+/** User-facing flag spelling included in validation errors. */
+label: string;
+/** Normalize each decoded token before de-duplication. */
+normalize?: (value: string) => string;
 }
 /**
  * Parses a comma-separated OR filter while supporting `\,` for a literal comma

package/dist/sdk/query/next-ready-budget.d.ts

@@ -1,20 +1,20 @@
 import type { NextResult } from "./next.js";
 /** Evidence for a ready-selection ceiling, separate from the whole-response ceiling. */
 export interface NextReadyBudgetReceipt {
-    /** The exact fields charged to this selection budget. */
-    scope: "recommended_and_ready";
-    /** Maximum UTF-8 bytes/4 estimate requested by the caller. */
-    budget_tokens: number;
-    /** Greater of the JSON and TOON costs of the returned selection. */
-    estimated_tokens: number;
-    /** Whether even the empty selection fits the requested budget. */
-    within_budget: boolean;
-    /** Rows removed by this budget after the independent row limit. */
-    omitted_count: number;
-    /** Whether the highest-ranked recommendation was withheld. */
-    recommendation_omitted: boolean;
-    /** Cost of the full row-limited selection, suitable for a useful retry. */
-    restore_budget_tokens: number;
+/** The exact fields charged to this selection budget. */
+scope: "recommended_and_ready";
+/** Maximum UTF-8 bytes/4 estimate requested by the caller. */
+budget_tokens: number;
+/** Greater of the JSON and TOON costs of the returned selection. */
+estimated_tokens: number;
+/** Whether even the empty selection fits the requested budget. */
+within_budget: boolean;
+/** Rows removed by this budget after the independent row limit. */
+omitted_count: number;
+/** Whether the highest-ranked recommendation was withheld. */
+recommendation_omitted: boolean;
+/** Cost of the full row-limited selection, suitable for a useful retry. */
+restore_budget_tokens: number;
 }
 /** Trim alternatives before the recommendation, retaining order and complete population counts. */
 export declare function applyNextReadyBudget(result: NextResult, budget: number, hasIntentBudget: boolean): void;