@unbrained/pm-cli 2026.10.11 → 2026.10.13

package/dist/sdk/query/duplicate-candidates.d.ts

@@ -3,5 +3,5 @@ import type { PreparedSimilarityText } from "../similarity-scoring.js";
 export declare const MAX_DUPLICATE_CANDIDATE_PAIRS = 1000000;
 /** Generate every potentially qualifying pair once, with an explicit exhaustive oracle. */
 export declare function collectDuplicateCandidatePairs(items: readonly {
-    prepared: PreparedSimilarityText;
+prepared: PreparedSimilarityText;
 }[], maxPairs?: number, threshold?: number, exhaustive?: boolean): Set<string>;

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

@@ -6,101 +6,101 @@ import type { ItemMetadata, Dependency, LinkedDoc, LinkedFile, LinkedTest } from
 export { GET_DEPTH_VALUES, listGetProjectionFields, } from "./projection-contracts.js";
 /** Latest claim or release coordinate exposed without its mutation patch. */
 interface ClaimHistoryContext {
-    ts: string;
-    author: string;
-    message: string | null;
+ts: string;
+author: string;
+message: string | null;
 }
 /** Ownership from the selected item snapshot, accompanied by its latest claim and release events. */
 interface ClaimStateContext {
-    claimed: boolean;
-    assignee: string | null;
-    last_claim: ClaimHistoryContext | null;
-    last_release: ClaimHistoryContext | null;
+claimed: boolean;
+assignee: string | null;
+last_claim: ClaimHistoryContext | null;
+last_release: ClaimHistoryContext | null;
 }
 /** Depth or field-selected metadata; identity survives every projection. */
 type GetItemProjection = {
-    [K in keyof ItemMetadata]?: K extends "dependencies" ? (Pick<Dependency, "id" | "kind"> & Partial<Dependency>)[] : ItemMetadata[K];
+[K in keyof ItemMetadata]?: K extends "dependencies" ? (Pick<Dependency, "id" | "kind"> & Partial<Dependency>)[] : ItemMetadata[K];
 } & {
-    /** Canonical item identity retained by every depth and field projection. */
-    id: string;
-    /** Item document body, included inside metadata for CLI/list parity. */
-    body?: string;
-    /** Number of notes omitted by a token-bounded projection. */
-    notes_count?: number;
-    /** Number of linked tests omitted by a token-bounded projection. */
-    tests_count?: number;
-    /** Stable cardinalities for every collection mutation surface. */
-    collection_counts?: Readonly<{
-        comments: number;
-        notes: number;
-        learnings: number;
-        files: number;
-        tests: number;
-        docs: number;
-        reminders: number;
-        events: number;
-    }>;
+/** Canonical item identity retained by every depth and field projection. */
+id: string;
+/** Item document body, included inside metadata for CLI/list parity. */
+body?: string;
+/** Number of notes omitted by a token-bounded projection. */
+notes_count?: number;
+/** Number of linked tests omitted by a token-bounded projection. */
+tests_count?: number;
+/** Stable cardinalities for every collection mutation surface. */
+collection_counts?: Readonly<{
+comments: number;
+notes: number;
+learnings: number;
+files: number;
+tests: number;
+docs: number;
+reminders: number;
+events: number;
+}>;
 };
 /** Single-item read with optional derived facets; omission materiality is carried separately from its JSON representation. */
 export interface GetResult {
-    /** Selected metadata and body; requested empty collections are represented explicitly. */
-    item: GetItemProjection;
-    /** Requested artifact groups; narrower selectors leave unrequested groups empty. */
-    linked?: {
-        files: LinkedFile[];
-        tests: LinkedTest[];
-        docs: LinkedDoc[];
-    };
-    /** Ownership evidence for the current or selected historical snapshot. */
-    claim_state?: ClaimStateContext;
-    /** Current child rollup for full or explicit child reads and deep container reads; historical hierarchy is not indexed. */
-    children?: ChildRollupContext;
-    /** Normalized scheduling data for scheduled item types and metadata. */
-    schedule?: Partial<ItemScheduleContext>;
-    /** Current state of forward-declared blockers; reverse graph edges require a corpus query and historical reads omit this current-state facet. */
-    blockers?: {
-        /** Explicit scope: scalar and blocked_by edges declared by this item. */
-        scope: "declared";
-        /** Nonterminal, missing and external references that still gate declared prerequisites. */
-        open: Omit<ResolvedBlocker, "resolved">[];
-        /** Declared references whose targets have terminal runtime statuses. */
-        closed_count: number;
-    };
-    /** True when the item was reconstructed from immutable history. */
-    reconstructed?: true;
-    /** Durable version, or null when legacy compaction lost the numeric mapping. */
-    as_of_version?: number | null;
-    /** Timestamp of the last history entry included in a reconstructed read. */
-    as_of_timestamp?: string;
-    /** Current descendants selected through registered hierarchy semantics and the optional depth bound. */
-    tree?: {
-        root_id: string;
-        root_title: string | null;
-        depth_limit: number | null;
-        count: number;
-        items: Record<string, unknown>[];
-    };
+/** Selected metadata and body; requested empty collections are represented explicitly. */
+item: GetItemProjection;
+/** Requested artifact groups; narrower selectors leave unrequested groups empty. */
+linked?: {
+files: LinkedFile[];
+tests: LinkedTest[];
+docs: LinkedDoc[];
+};
+/** Ownership evidence for the current or selected historical snapshot. */
+claim_state?: ClaimStateContext;
+/** Current child rollup for full or explicit child reads and deep container reads; historical hierarchy is not indexed. */
+children?: ChildRollupContext;
+/** Normalized scheduling data for scheduled item types and metadata. */
+schedule?: Partial<ItemScheduleContext>;
+/** Current state of forward-declared blockers; reverse graph edges require a corpus query and historical reads omit this current-state facet. */
+blockers?: {
+/** Explicit scope: scalar and blocked_by edges declared by this item. */
+scope: "declared";
+/** Nonterminal, missing and external references that still gate declared prerequisites. */
+open: Omit<ResolvedBlocker, "resolved">[];
+/** Declared references whose targets have terminal runtime statuses. */
+closed_count: number;
+};
+/** True when the item was reconstructed from immutable history. */
+reconstructed?: true;
+/** Durable version, or null when legacy compaction lost the numeric mapping. */
+as_of_version?: number | null;
+/** Timestamp of the last history entry included in a reconstructed read. */
+as_of_timestamp?: string;
+/** Current descendants selected through registered hierarchy semantics and the optional depth bound. */
+tree?: {
+root_id: string;
+root_title: string | null;
+depth_limit: number | null;
+count: number;
+items: Record<string, unknown>[];
+};
 }
 /** Decide which item types receive a child rollup during deep reads. */
 declare function shouldAutoIncludeGetChildren(itemType: string): boolean;
 /** Select item detail and optional hierarchy or verified historical evidence. Incompatible projections fail before serving the item. */
 export interface GetOptions {
-    /** Detail depth: brief|standard|deep|full. Full includes current children for every type; standard and brief avoid workspace enumeration. */
-    depth?: string;
-    /** Comma-separated metadata or facet selectors, including item-prefixed aliases; identity is always retained. */
-    fields?: string;
-    /** Complete item and current child rollup for every type, mutually exclusive with fields/depth. Historical reads retain child recovery because past hierarchy is not indexed. */
-    full?: boolean;
-    /** Include current descendants; cannot be combined with a historical read. */
-    tree?: boolean;
-    /** Non-negative descendant depth limit, valid only when tree is enabled. */
-    treeDepth?: string;
-    /** One-based history version or ISO timestamp for a mutation-free read. */
-    at?: string;
+/** Detail depth: brief|standard|deep|full. Full includes current children for every type; standard and brief avoid workspace enumeration. */
+depth?: string;
+/** Comma-separated metadata or facet selectors, including item-prefixed aliases; identity is always retained. */
+fields?: string;
+/** Complete item and current child rollup for every type, mutually exclusive with fields/depth. Historical reads retain child recovery because past hierarchy is not indexed. */
+full?: boolean;
+/** Include current descendants; cannot be combined with a historical read. */
+tree?: boolean;
+/** Non-negative descendant depth limit, valid only when tree is enabled. */
+treeDepth?: string;
+/** One-based history version or ISO timestamp for a mutation-free read. */
+at?: string;
 }
 /** Read one authoritative item and selected facets. Full current reads compute children for every type; ordinary Task reads avoid corpus enumeration. Historical reads exclude current hierarchy, and failed derived usage recording never invalidates the item read. */
 export declare function runGet(id: string, global: GlobalOptions, options?: GetOptions): Promise<GetResult>;
 /** Compatibility access to deep-read container classification; explicit full reads override that classification. */
 export declare const _testOnlyGetCommand: {
-    shouldAutoIncludeGetChildren: typeof shouldAutoIncludeGetChildren;
+shouldAutoIncludeGetChildren: typeof shouldAutoIncludeGetChildren;
 };

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

@@ -7,84 +7,84 @@ import { type HistoryProvenanceRow, type HistoryProvenanceSummary } from "../his
 export { verifyHistoryChain };
 /** Documents the history command options payload exchanged by command, SDK, and package integrations. */
 export interface HistoryCommandOptions {
-    /** Value that configures or reports limit for this contract. */
-    limit?: string;
-    /** Value that configures or reports diff for this contract. */
-    diff?: boolean;
-    /** Restrict --diff to a single field's before/after transitions (implies --diff). */
-    field?: string;
-    /** Value that configures or reports verify for this contract. */
-    verify?: boolean;
-    /** Value that configures or reports compact for this contract. */
-    compact?: boolean;
-    /** Return patch-free provenance rows. */
-    provenance?: boolean;
-    /** Include constant-size provenance completeness metrics. */
-    provenanceSummary?: boolean;
-    /** Filter by canonical recorded or vocabulary-resolved harness. */
-    harness?: string | readonly string[];
-    /** Filter by privacy-safe invocation fingerprint. */
-    agentInstance?: string | readonly string[];
-    /** Exact provenance dimension predicates (`dimension=value`). */
-    provenanceFilter?: string | readonly string[];
+/** Value that configures or reports limit for this contract. */
+limit?: string;
+/** Value that configures or reports diff for this contract. */
+diff?: boolean;
+/** Restrict --diff to a single field's before/after transitions (implies --diff). */
+field?: string;
+/** Value that configures or reports verify for this contract. */
+verify?: boolean;
+/** Value that configures or reports compact for this contract. */
+compact?: boolean;
+/** Return patch-free provenance rows. */
+provenance?: boolean;
+/** Include constant-size provenance completeness metrics. */
+provenanceSummary?: boolean;
+/** Filter by canonical recorded or vocabulary-resolved harness. */
+harness?: string | readonly string[];
+/** Filter by privacy-safe invocation fingerprint. */
+agentInstance?: string | readonly string[];
+/** Exact provenance dimension predicates (`dimension=value`). */
+provenanceFilter?: string | readonly string[];
 }
 /** Documents the history diff entry payload exchanged by command, SDK, and package integrations. */
 export interface HistoryDiffEntry {
-    /** Value that configures or reports index for this contract. */
-    index: number;
-    /** Durable version address after compaction; null for unmapped legacy checkpoints. */
-    version?: number | null;
-    /** Value that configures or reports ts for this contract. */
-    ts: string;
-    /** Value that configures or reports op for this contract. */
-    op: string;
-    /** Value that configures or reports author for this contract. */
-    author: string;
-    /** Value that configures or reports patch ops for this contract. */
-    patch_ops: number;
-    /** Value that configures or reports changed fields for this contract. */
-    changed_fields: string[];
+/** Value that configures or reports index for this contract. */
+index: number;
+/** Durable version address after compaction; null for unmapped legacy checkpoints. */
+version?: number | null;
+/** Value that configures or reports ts for this contract. */
+ts: string;
+/** Value that configures or reports op for this contract. */
+op: string;
+/** Value that configures or reports author for this contract. */
+author: string;
+/** Value that configures or reports patch ops for this contract. */
+patch_ops: number;
+/** Value that configures or reports changed fields for this contract. */
+changed_fields: string[];
 }
 /** Documents the history result payload exchanged by command, SDK, and package integrations. */
 export interface HistoryResult {
-    /** Stable identifier used to reference this record across commands and storage. */
-    id: string;
-    /** Value that configures or reports history for this contract. */
-    history?: HistoryEntry[];
-    /** Value that configures or reports compact history for this contract. */
-    compact_history?: HistoryDiffEntry[];
-    /** Patch-free immutable provenance rows. */
-    provenance_history?: HistoryProvenanceRow[];
-    /** Value that configures or reports compact for this contract. */
-    compact: boolean;
-    /** Explicit active row projection. */
-    projection: {
-        /** Stable projection mode. */
-        mode: "compact" | "provenance" | "full";
-        /** Active row collection key. */
-        row_key: "compact_history" | "provenance_history" | "history";
-    };
-    /** Constant-size disclosure of field groups withheld by the active mode. */
-    omission_receipt: OutputOmissionReceipt;
-    /** Value that configures or reports count for this contract. */
-    count: number;
-    /** Value that configures or reports limit for this contract. */
-    limit: number | null;
-    /** Value that configures or reports diff for this contract. */
-    diff?: HistoryDiffValueEntry[];
-    /** Value that configures or reports verification for this contract. */
-    verification?: HistoryVerificationResult;
-    /** Constant-size provenance completeness metrics. */
-    provenance_summary?: HistoryProvenanceSummary;
-    /** Present after compaction; row indices remain physical stream positions. */
-    version_addressing?: {
-        /** Add to a physical one-based index; null when the original mapping is lost. */
-        offset: number | null;
-        /** Earliest reconstructable original version, or null for legacy checkpoints. */
-        first_version: number | null;
-        /** Latest addressable version, including maintenance audit events. */
-        last_version: number | null;
-    };
+/** Stable identifier used to reference this record across commands and storage. */
+id: string;
+/** Value that configures or reports history for this contract. */
+history?: HistoryEntry[];
+/** Value that configures or reports compact history for this contract. */
+compact_history?: HistoryDiffEntry[];
+/** Patch-free immutable provenance rows. */
+provenance_history?: HistoryProvenanceRow[];
+/** Value that configures or reports compact for this contract. */
+compact: boolean;
+/** Explicit active row projection. */
+projection: {
+/** Stable projection mode. */
+mode: "compact" | "provenance" | "full";
+/** Active row collection key. */
+row_key: "compact_history" | "provenance_history" | "history";
+};
+/** Constant-size disclosure of field groups withheld by the active mode. */
+omission_receipt: OutputOmissionReceipt;
+/** Value that configures or reports count for this contract. */
+count: number;
+/** Value that configures or reports limit for this contract. */
+limit: number | null;
+/** Value that configures or reports diff for this contract. */
+diff?: HistoryDiffValueEntry[];
+/** Value that configures or reports verification for this contract. */
+verification?: HistoryVerificationResult;
+/** Constant-size provenance completeness metrics. */
+provenance_summary?: HistoryProvenanceSummary;
+/** Present after compaction; row indices remain physical stream positions. */
+version_addressing?: {
+/** Add to a physical one-based index; null when the original mapping is lost. */
+offset: number | null;
+/** Earliest reconstructable original version, or null for legacy checkpoints. */
+first_version: number | null;
+/** Latest addressable version, including maintenance audit events. */
+last_version: number | null;
+};
 }
 /** Implements run history for the public runtime surface of this module. */
 export declare function runHistory(id: string, options: HistoryCommandOptions, global: GlobalOptions): Promise<HistoryResult>;

package/dist/sdk/query/item-filter-options.d.ts

@@ -5,92 +5,92 @@
  */
 /** Common scalar item filters accepted by list/search-style commands. */
 export interface SharedItemScalarFilterOptions {
-    /** Lifecycle state reported for status. */
-    status?: string;
-    /** Schema type that determines the shape and validation rules for this value. */
-    type?: string;
-    /** Value that configures or reports tag for this contract. */
-    tag?: string;
-    /** Value that configures or reports priority for this contract. */
-    priority?: string;
-    /** Value that configures or reports deadline before for this contract. */
-    deadlineBefore?: string;
-    /** Value that configures or reports deadline after for this contract. */
-    deadlineAfter?: string;
-    /** Value that configures or reports updated after for this contract. */
-    updatedAfter?: string;
-    /** Value that configures or reports updated before for this contract. */
-    updatedBefore?: string;
-    /** Value that configures or reports created after for this contract. */
-    createdAfter?: string;
-    /** Value that configures or reports created before for this contract. */
-    createdBefore?: string;
-    /** Value that configures or reports assignee for this contract. */
-    assignee?: string;
-    /** Value that configures or reports parent for this contract. */
-    parent?: string;
-    /** Value that configures or reports sprint for this contract. */
-    sprint?: string;
-    /** Value that configures or reports release for this contract. */
-    release?: string;
+/** Lifecycle state reported for status. */
+status?: string;
+/** Schema type that determines the shape and validation rules for this value. */
+type?: string;
+/** Value that configures or reports tag for this contract. */
+tag?: string;
+/** Value that configures or reports priority for this contract. */
+priority?: string;
+/** Value that configures or reports deadline before for this contract. */
+deadlineBefore?: string;
+/** Value that configures or reports deadline after for this contract. */
+deadlineAfter?: string;
+/** Value that configures or reports updated after for this contract. */
+updatedAfter?: string;
+/** Value that configures or reports updated before for this contract. */
+updatedBefore?: string;
+/** Value that configures or reports created after for this contract. */
+createdAfter?: string;
+/** Value that configures or reports created before for this contract. */
+createdBefore?: string;
+/** Value that configures or reports assignee for this contract. */
+assignee?: string;
+/** Value that configures or reports parent for this contract. */
+parent?: string;
+/** Value that configures or reports sprint for this contract. */
+sprint?: string;
+/** Value that configures or reports release for this contract. */
+release?: string;
 }
 /** Common governance-metadata presence filters accepted by item query commands. */
 export interface SharedGovernanceMissingFilterOptions {
-    /** Value that configures or reports filter reviewer missing for this contract. */
-    filterReviewerMissing?: boolean;
-    /** Value that configures or reports filter risk missing for this contract. */
-    filterRiskMissing?: boolean;
-    /** Value that configures or reports filter confidence missing for this contract. */
-    filterConfidenceMissing?: boolean;
-    /** Value that configures or reports filter sprint missing for this contract. */
-    filterSprintMissing?: boolean;
-    /** Value that configures or reports filter release missing for this contract. */
-    filterReleaseMissing?: boolean;
+/** Value that configures or reports filter reviewer missing for this contract. */
+filterReviewerMissing?: boolean;
+/** Value that configures or reports filter risk missing for this contract. */
+filterRiskMissing?: boolean;
+/** Value that configures or reports filter confidence missing for this contract. */
+filterConfidenceMissing?: boolean;
+/** Value that configures or reports filter sprint missing for this contract. */
+filterSprintMissing?: boolean;
+/** Value that configures or reports filter release missing for this contract. */
+filterReleaseMissing?: boolean;
 }
 /** Common content-field presence filters accepted by item query commands. */
 export interface SharedContentFieldFilterOptions {
-    /** Whether notes applies to this operation. */
-    hasNotes?: boolean;
-    /** Whether learnings applies to this operation. */
-    hasLearnings?: boolean;
-    /** Whether files applies to this operation. */
-    hasFiles?: boolean;
-    /** Whether docs applies to this operation. */
-    hasDocs?: boolean;
-    /** Whether tests applies to this operation. */
-    hasTests?: boolean;
-    /** Whether comments applies to this operation. */
-    hasComments?: boolean;
-    /** Whether deps applies to this operation. */
-    hasDeps?: boolean;
-    /** Whether body applies to this operation. */
-    hasBody?: boolean;
-    /** Whether linked command applies to this operation. */
-    hasLinkedCommand?: boolean;
-    /** Value that configures or reports no notes for this contract. */
-    noNotes?: boolean;
-    /** Value that configures or reports no learnings for this contract. */
-    noLearnings?: boolean;
-    /** Value that configures or reports no files for this contract. */
-    noFiles?: boolean;
-    /** Value that configures or reports filter files missing for this contract. */
-    filterFilesMissing?: boolean;
-    /** Value that configures or reports no docs for this contract. */
-    noDocs?: boolean;
-    /** Value that configures or reports filter docs missing for this contract. */
-    filterDocsMissing?: boolean;
-    /** Value that configures or reports no tests for this contract. */
-    noTests?: boolean;
-    /** Value that configures or reports no comments for this contract. */
-    noComments?: boolean;
-    /** Value that configures or reports no deps for this contract. */
-    noDeps?: boolean;
-    /** Value that configures or reports empty body for this contract. */
-    emptyBody?: boolean;
-    /** Value that configures or reports no linked command for this contract. */
-    noLinkedCommand?: boolean;
+/** Whether notes applies to this operation. */
+hasNotes?: boolean;
+/** Whether learnings applies to this operation. */
+hasLearnings?: boolean;
+/** Whether files applies to this operation. */
+hasFiles?: boolean;
+/** Whether docs applies to this operation. */
+hasDocs?: boolean;
+/** Whether tests applies to this operation. */
+hasTests?: boolean;
+/** Whether comments applies to this operation. */
+hasComments?: boolean;
+/** Whether deps applies to this operation. */
+hasDeps?: boolean;
+/** Whether body applies to this operation. */
+hasBody?: boolean;
+/** Whether linked command applies to this operation. */
+hasLinkedCommand?: boolean;
+/** Value that configures or reports no notes for this contract. */
+noNotes?: boolean;
+/** Value that configures or reports no learnings for this contract. */
+noLearnings?: boolean;
+/** Value that configures or reports no files for this contract. */
+noFiles?: boolean;
+/** Value that configures or reports filter files missing for this contract. */
+filterFilesMissing?: boolean;
+/** Value that configures or reports no docs for this contract. */
+noDocs?: boolean;
+/** Value that configures or reports filter docs missing for this contract. */
+filterDocsMissing?: boolean;
+/** Value that configures or reports no tests for this contract. */
+noTests?: boolean;
+/** Value that configures or reports no comments for this contract. */
+noComments?: boolean;
+/** Value that configures or reports no deps for this contract. */
+noDeps?: boolean;
+/** Value that configures or reports empty body for this contract. */
+emptyBody?: boolean;
+/** Value that configures or reports no linked command for this contract. */
+noLinkedCommand?: boolean;
 }
 /** Base option shape for item query commands with schema/runtime extension flags. */
 export interface SharedItemFilterOptions extends SharedItemScalarFilterOptions, SharedGovernanceMissingFilterOptions, SharedContentFieldFilterOptions {
-    [key: string]: unknown;
+[key: string]: unknown;
 }

package/dist/sdk/query/list-filter-shared.d.ts

@@ -5,7 +5,7 @@
  */
 import type { ListOptions } from "./list.js";
 interface HasListFilterOptions {
-    includePagination?: boolean;
+includePagination?: boolean;
 }
 /** Implements check whether list filters for the public runtime surface of this module. */
 export declare function hasListFilters(list: ListOptions | undefined, status: string | undefined, options?: HasListFilterOptions): boolean;