@unbrained/pm-cli 2026.10.12 → 2026.10.13

package/dist/sdk/output-projection.d.ts

@@ -1,170 +1,170 @@
 /** One field group that a richer output projection can restore. */
 export interface OutputProjectionFieldGroup {
-    /** Stable machine-readable field-group name. */
-    name: string;
-    /** Exact CLI flag or flag/value pair that restores the group. */
-    restore_with: string;
+/** Stable machine-readable field-group name. */
+name: string;
+/** Exact CLI flag or flag/value pair that restores the group. */
+restore_with: string;
 }
 /** Bounded disclosure that distinguishes complete output from silent omission. */
 export interface OutputOmissionReceipt {
-    /** Whether the active projection withheld at least one declared field group. */
-    has_omissions: boolean;
-    /** Constant-size count of withheld field groups. */
-    omitted_field_group_count: number;
-    /** Withheld groups and the exact opt-in that restores each one. */
-    omitted_field_groups: OutputProjectionFieldGroup[];
-    /** Population counted by context summary regardless of bounded focus rows. */
-    summary_scope?: "matching_items";
+/** Whether the active projection withheld at least one declared field group. */
+has_omissions: boolean;
+/** Constant-size count of withheld field groups. */
+omitted_field_group_count: number;
+/** Withheld groups and the exact opt-in that restores each one. */
+omitted_field_groups: OutputProjectionFieldGroup[];
+/** Population counted by context summary regardless of bounded focus rows. */
+summary_scope?: "matching_items";
 }
 /** Self-describing projection metadata that built-ins and extensions can use to derive receipts without command-specific code. */
 export interface OutputProjectionDeclaration {
-    /** Active projection name. */
-    mode: string;
-    /** Every optional field group supported by this result shape. */
-    declared_field_groups: OutputProjectionFieldGroup[];
-    /** Names of declared groups present in this result. */
-    included_field_groups: string[];
+/** Active projection name. */
+mode: string;
+/** Every optional field group supported by this result shape. */
+declared_field_groups: OutputProjectionFieldGroup[];
+/** Names of declared groups present in this result. */
+included_field_groups: string[];
 }
 /** Register non-serialized materiality evidence used to keep omission receipts token-proportional. */
 export declare function registerOutputMaterialFieldGroups(result: object, fieldGroups: readonly string[]): void;
 /** Machine-readable location and field-projection support for read-result rows. */
 export interface ReadRowContract {
-    /** Canonical read command that owns the result. */
-    command: string;
-    /** Whether the result exposes iterable collections or intentionally has none. */
-    row_kind: "collection" | "none";
-    /** Dot-delimited paths to array or object-map collections containing iterable result rows. */
-    row_keys: string[];
-    /** Optional nested collections that are independently resumable without redefining primary result rows. */
-    continuation_row_keys?: string[];
-    /** Whether the command accepts an explicit row-field projection. */
-    fields: "supported" | "unsupported";
-    /** Universal jq expression that iterates every declared collection path. */
-    jq_selector?: string;
-    /** TOON row encoding selected whenever every row is a flat object with one shared key set. */
-    toon_encoding?: "tabular_when_uniform";
+/** Canonical read command that owns the result. */
+command: string;
+/** Whether the result exposes iterable collections or intentionally has none. */
+row_kind: "collection" | "none";
+/** Dot-delimited paths to array or object-map collections containing iterable result rows. */
+row_keys: string[];
+/** Optional nested collections that are independently resumable without redefining primary result rows. */
+continuation_row_keys?: string[];
+/** Whether the command accepts an explicit row-field projection. */
+fields: "supported" | "unsupported";
+/** Universal jq expression that iterates every declared collection path. */
+jq_selector?: string;
+/** TOON row encoding selected whenever every row is a flat object with one shared key set. */
+toon_encoding?: "tabular_when_uniform";
 }
 /** Universal selector for results carrying a {@link ReadRowContract}. */
 export declare const PM_READ_ROW_JQ_SELECTOR = ".row_contract.row_keys[] as $key | getpath($key | split(\".\")) | if type == \"array\" then .[] else if type == \"object\" then to_entries[] else empty end end";
 /** Static row declarations shared by CLI, SDK, MCP, and package consumers. */
 export declare const PM_READ_ROW_CONTRACTS: {
-    readonly context: {
-        readonly row_keys: readonly ["high_level", "low_level"];
-        readonly fields: "supported";
-    };
-    readonly get: {
-        readonly row_keys: readonly ["children"];
-        readonly fields: "supported";
-    };
-    readonly list: {
-        readonly row_keys: readonly ["items"];
-        readonly fields: "supported";
-    };
-    readonly next: {
-        readonly row_keys: readonly ["recommended", "ready", "decision_needed", "gate_needed", "containers", "blocked", "held_by_others"];
-        readonly fields: "unsupported";
-    };
-    readonly search: {
-        readonly row_keys: readonly ["items"];
-        readonly fields: "supported";
-    };
-    readonly activity: {
-        readonly row_keys: readonly ["activity_digest", "compact_activity", "provenance_activity", "activity"];
-        readonly fields: "unsupported";
-    };
-    readonly history: {
-        readonly row_keys: readonly ["compact_history", "provenance_history", "history", "diff"];
-        readonly fields: "unsupported";
-    };
-    readonly deps: {
-        readonly row_keys: readonly ["graph.nodes", "graph.edges", "context.nodes", "context.edges"];
-        readonly fields: "unsupported";
-    };
-    readonly health: {
-        readonly row_keys: readonly ["checks"];
-        readonly fields: "unsupported";
-    };
-    readonly aggregate: {
-        readonly row_keys: readonly ["groups"];
-        readonly fields: "unsupported";
-    };
-    readonly duplicates: {
-        readonly row_keys: readonly ["clusters"];
-        readonly fields: "unsupported";
-    };
-    readonly stats: {
-        readonly row_keys: readonly ["by_type", "by_status"];
-        readonly fields: "unsupported";
-    };
-    readonly comments: {
-        readonly row_keys: readonly ["comments"];
-        readonly fields: "unsupported";
-    };
-    readonly notes: {
-        readonly row_keys: readonly ["notes"];
-        readonly fields: "unsupported";
-    };
-    readonly learnings: {
-        readonly row_keys: readonly ["learnings"];
-        readonly fields: "unsupported";
-    };
-    readonly files: {
-        readonly row_keys: readonly ["files"];
-        readonly fields: "unsupported";
-    };
-    readonly docs: {
-        readonly row_keys: readonly ["docs"];
-        readonly fields: "unsupported";
-    };
-    readonly validate: {
-        readonly row_keys: readonly ["checks", "warnings"];
-        readonly fields: "unsupported";
-    };
-    readonly contracts: {
-        readonly row_keys: readonly ["command_summaries", "commands"];
-        readonly fields: "unsupported";
-    };
+readonly context: {
+readonly row_keys: readonly ["high_level", "low_level"];
+readonly fields: "supported";
+};
+readonly get: {
+readonly row_keys: readonly ["children"];
+readonly fields: "supported";
+};
+readonly list: {
+readonly row_keys: readonly ["items"];
+readonly fields: "supported";
+};
+readonly next: {
+readonly row_keys: readonly ["recommended", "ready", "decision_needed", "gate_needed", "containers", "blocked", "held_by_others"];
+readonly fields: "unsupported";
+};
+readonly search: {
+readonly row_keys: readonly ["items"];
+readonly fields: "supported";
+};
+readonly activity: {
+readonly row_keys: readonly ["activity_digest", "compact_activity", "provenance_activity", "activity"];
+readonly fields: "unsupported";
+};
+readonly history: {
+readonly row_keys: readonly ["compact_history", "provenance_history", "history", "diff"];
+readonly fields: "unsupported";
+};
+readonly deps: {
+readonly row_keys: readonly ["graph.nodes", "graph.edges", "context.nodes", "context.edges"];
+readonly fields: "unsupported";
+};
+readonly health: {
+readonly row_keys: readonly ["checks"];
+readonly fields: "unsupported";
+};
+readonly aggregate: {
+readonly row_keys: readonly ["groups"];
+readonly fields: "unsupported";
+};
+readonly duplicates: {
+readonly row_keys: readonly ["clusters"];
+readonly fields: "unsupported";
+};
+readonly stats: {
+readonly row_keys: readonly ["by_type", "by_status"];
+readonly fields: "unsupported";
+};
+readonly comments: {
+readonly row_keys: readonly ["comments"];
+readonly fields: "unsupported";
+};
+readonly notes: {
+readonly row_keys: readonly ["notes"];
+readonly fields: "unsupported";
+};
+readonly learnings: {
+readonly row_keys: readonly ["learnings"];
+readonly fields: "unsupported";
+};
+readonly files: {
+readonly row_keys: readonly ["files"];
+readonly fields: "unsupported";
+};
+readonly docs: {
+readonly row_keys: readonly ["docs"];
+readonly fields: "unsupported";
+};
+readonly validate: {
+readonly row_keys: readonly ["checks", "warnings"];
+readonly fields: "unsupported";
+};
+readonly contracts: {
+readonly row_keys: readonly ["command_summaries", "commands"];
+readonly fields: "unsupported";
+};
 };
 /** Contract for a command whose output modes expose mutually exclusive row shapes. */
 export interface ModePairedOutputProjectionContract {
-    /** Stable command name. */
-    command: string;
-    /** Mode that contains the complete authoritative row shape. */
-    complete_mode: string;
-    /** Field groups withheld by each non-complete mode. */
-    omissions_by_mode: Readonly<Record<string, readonly OutputProjectionFieldGroup[]>>;
+/** Stable command name. */
+command: string;
+/** Mode that contains the complete authoritative row shape. */
+complete_mode: string;
+/** Field groups withheld by each non-complete mode. */
+omissions_by_mode: Readonly<Record<string, readonly OutputProjectionFieldGroup[]>>;
 }
 /** Shared activity/history contract used by CLI, SDK, MCP, and conformance tests. */
 export declare const PM_MODE_PAIRED_OUTPUT_PROJECTION_CONTRACTS: readonly [{
-    readonly command: "activity";
-    readonly complete_mode: "full";
-    readonly omissions_by_mode: {
-        readonly digest: readonly [{
-            readonly name: "event_rows";
-            readonly restore_with: "--raw";
-        }];
-        readonly compact: readonly [{
-            readonly name: "provenance";
-            readonly restore_with: "--full";
-        }];
-        readonly provenance: readonly [{
-            readonly name: "patch_and_hashes";
-            readonly restore_with: "--full";
-        }];
-    };
+readonly command: "activity";
+readonly complete_mode: "full";
+readonly omissions_by_mode: {
+readonly digest: readonly [{
+readonly name: "event_rows";
+readonly restore_with: "--raw";
+}];
+readonly compact: readonly [{
+readonly name: "provenance";
+readonly restore_with: "--full";
+}];
+readonly provenance: readonly [{
+readonly name: "patch_and_hashes";
+readonly restore_with: "--full";
+}];
+};
 }, {
-    readonly command: "history";
-    readonly complete_mode: "full";
-    readonly omissions_by_mode: {
-        readonly compact: readonly [{
-            readonly name: "raw_history";
-            readonly restore_with: "--full";
-        }];
-        readonly provenance: readonly [{
-            readonly name: "patch_and_hashes";
-            readonly restore_with: "--full";
-        }];
-    };
+readonly command: "history";
+readonly complete_mode: "full";
+readonly omissions_by_mode: {
+readonly compact: readonly [{
+readonly name: "raw_history";
+readonly restore_with: "--full";
+}];
+readonly provenance: readonly [{
+readonly name: "patch_and_hashes";
+readonly restore_with: "--full";
+}];
+};
 }];
 /** Reject a compact projection and its explicit full restoration when callers request both. */
 export declare function assertProjectionModeChoice(compactRequested: boolean, fullRequested: boolean, compactFlag: string): void;

package/dist/sdk/output-token-accounting.d.ts

@@ -2,40 +2,40 @@
 export type PmOutputTokenSection = "result_rows" | "envelope" | "diagnostics" | "hints";
 /** Byte and token estimate attributed to one output section. */
 export interface PmOutputTokenSectionAccounting {
-    /** Exact share of emitted pre-receipt bytes allocated to this section. */
-    bytes: number;
-    /** Token estimate derived with pm's canonical UTF-8 byte estimator. */
-    estimated_tokens: number;
+/** Exact share of emitted pre-receipt bytes allocated to this section. */
+bytes: number;
+/** Token estimate derived with pm's canonical UTF-8 byte estimator. */
+estimated_tokens: number;
 }
 /** Bounded accounting receipt attached only when explicitly requested. */
 export interface PmOutputTokenAccounting {
-    /** Receipt schema version. */
-    version: 1;
-    /** Scope measured by this receipt. */
-    measurement_scope: "output_before_token_accounting";
-    /** Canonical estimator shared with declared output budgets. */
-    estimator: "ceil(utf8_bytes / 4)";
-    /** Exact UTF-8 byte count of the emitted output before this receipt. */
-    total_bytes: number;
-    /** Canonical token estimate for {@link total_bytes}. */
-    total_estimated_tokens: number;
-    /** Deterministic attribution whose byte values sum exactly to total_bytes. */
-    sections: Record<PmOutputTokenSection, PmOutputTokenSectionAccounting>;
-    /** Exact UTF-8 bytes added by the accounting receipt itself. */
-    accounting_receipt_bytes: number;
-    /** Token estimate for the excluded receipt overhead. */
-    accounting_receipt_estimated_tokens: number;
-    /** Fields intentionally excluded from the accounted total. */
-    excluded_fields: readonly ["token_accounting"];
-    /** Describes how structural transport bytes are assigned to sections. */
-    section_allocation: "proportional_canonical_json";
+/** Receipt schema version. */
+version: 1;
+/** Scope measured by this receipt. */
+measurement_scope: "output_before_token_accounting";
+/** Canonical estimator shared with declared output budgets. */
+estimator: "ceil(utf8_bytes / 4)";
+/** Exact UTF-8 byte count of the emitted output before this receipt. */
+total_bytes: number;
+/** Canonical token estimate for {@link total_bytes}. */
+total_estimated_tokens: number;
+/** Deterministic attribution whose byte values sum exactly to total_bytes. */
+sections: Record<PmOutputTokenSection, PmOutputTokenSectionAccounting>;
+/** Exact UTF-8 bytes added by the accounting receipt itself. */
+accounting_receipt_bytes: number;
+/** Token estimate for the excluded receipt overhead. */
+accounting_receipt_estimated_tokens: number;
+/** Fields intentionally excluded from the accounted total. */
+excluded_fields: readonly ["token_accounting"];
+/** Describes how structural transport bytes are assigned to sections. */
+section_allocation: "proportional_canonical_json";
 }
 /** Result enriched by opt-in token accounting without weakening its input type. */
 export type PmTokenAccountedResult<Result> = Result extends Record<string, unknown> ? Result & {
-    token_accounting: PmOutputTokenAccounting;
+token_accounting: PmOutputTokenAccounting;
 } : {
-    result: Result;
-    token_accounting: PmOutputTokenAccounting;
+result: Result;
+token_accounting: PmOutputTokenAccounting;
 };
 /**
  * Attach a deterministic receipt for exactly the bytes produced by

package/dist/sdk/output.d.ts

@@ -17,37 +17,37 @@ export { encodePmTableRows, decodePmTableRows, type PmTableCellEncoding, type Pm
 export declare function serializeNdjsonRows(rows: readonly unknown[]): string;
 /** Terminal metadata that makes an NDJSON batch independently resumable. */
 export interface PmNdjsonStreamTrailer {
-    /** Producer-owned constant-size fields may extend the shared trailer. */
-    readonly [key: string]: unknown;
-    /** Stable discriminator that cannot be confused with a domain row. */
-    record_type: "pm.stream.trailer";
-    /** Number of domain rows preceding this trailer in the batch. */
-    count: number;
-    /** Whether another row was available when the batch was read. */
-    has_more: boolean;
-    /** Opaque cursor that resumes strictly after this batch. */
-    next_cursor: string | null;
-    /** Name of the authoritative or derived source that produced the batch. */
-    source: string;
-    /** Optional constant-size metadata owned by the stream producer. */
-    metadata?: Readonly<Record<string, unknown>>;
+/** Producer-owned constant-size fields may extend the shared trailer. */
+readonly [key: string]: unknown;
+/** Stable discriminator that cannot be confused with a domain row. */
+record_type: "pm.stream.trailer";
+/** Number of domain rows preceding this trailer in the batch. */
+count: number;
+/** Whether another row was available when the batch was read. */
+has_more: boolean;
+/** Opaque cursor that resumes strictly after this batch. */
+next_cursor: string | null;
+/** Name of the authoritative or derived source that produced the batch. */
+source: string;
+/** Optional constant-size metadata owned by the stream producer. */
+metadata?: Readonly<Record<string, unknown>>;
 }
 /** Metadata accepted by {@link serializeNdjsonStream}. */
 export interface PmNdjsonStreamTrailerInput {
-    /** Producer-owned constant-size fields may extend the shared trailer. */
-    readonly [key: string]: unknown;
-    /** The serializer owns the discriminator and callers cannot override it. */
-    readonly record_type?: never;
-    /** Number of domain rows preceding the terminal trailer. */
-    count: number;
-    /** Whether another row was available when the batch was read. */
-    has_more: boolean;
-    /** Opaque cursor that resumes strictly after this batch. */
-    next_cursor: string | null;
-    /** Name of the authoritative or derived source that produced the batch. */
-    source: string;
-    /** Optional constant-size metadata owned by the stream producer. */
-    metadata?: Readonly<Record<string, unknown>>;
+/** Producer-owned constant-size fields may extend the shared trailer. */
+readonly [key: string]: unknown;
+/** The serializer owns the discriminator and callers cannot override it. */
+readonly record_type?: never;
+/** Number of domain rows preceding the terminal trailer. */
+count: number;
+/** Whether another row was available when the batch was read. */
+has_more: boolean;
+/** Opaque cursor that resumes strictly after this batch. */
+next_cursor: string | null;
+/** Name of the authoritative or derived source that produced the batch. */
+source: string;
+/** Optional constant-size metadata owned by the stream producer. */
+metadata?: Readonly<Record<string, unknown>>;
 }
 /**
  * Serialize a bounded NDJSON batch followed by exactly one typed terminal

package/dist/sdk/package-import-adapters.d.ts

@@ -19,46 +19,46 @@ export type ImportPriorityValue = 0 | 1 | 2 | 3 | 4;
 export type ImportLinkedScope = "project" | "global";
 /** Configures conversion of loosely shaped source comments into pm log entries. */
 export interface ToImportLogEntriesOptions {
-    /** ISO 8601 timestamp recording when fallback created occurred. */
-    fallbackCreatedAt: string;
-    /** Value that configures or reports fallback author for this contract. */
-    fallbackAuthor: string;
-    /** Value that configures or reports allow scalar for this contract. */
-    allowScalar?: boolean;
-    /** Value that configures or reports text keys for this contract. */
-    textKeys?: readonly string[];
-    /** Value that configures or reports created at key for this contract. */
-    createdAtKey?: string;
-    /** Value that configures or reports author key for this contract. */
-    authorKey?: string;
-    /** Value that configures or reports to iso string for this contract. */
-    toIsoString?: (value: unknown) => string | undefined;
+/** ISO 8601 timestamp recording when fallback created occurred. */
+fallbackCreatedAt: string;
+/** Value that configures or reports fallback author for this contract. */
+fallbackAuthor: string;
+/** Value that configures or reports allow scalar for this contract. */
+allowScalar?: boolean;
+/** Value that configures or reports text keys for this contract. */
+textKeys?: readonly string[];
+/** Value that configures or reports created at key for this contract. */
+createdAtKey?: string;
+/** Value that configures or reports author key for this contract. */
+authorKey?: string;
+/** Value that configures or reports to iso string for this contract. */
+toIsoString?: (value: unknown) => string | undefined;
 }
 /** Configures conversion of loosely shaped source file/doc arrays into pm linked artifacts. */
 export interface ToImportLinkedArtifactsOptions {
-    /** Value that configures or reports allow scalar for this contract. */
-    allowScalar?: boolean;
-    /** Value that configures or reports path keys for this contract. */
-    pathKeys?: readonly string[];
+/** Value that configures or reports allow scalar for this contract. */
+allowScalar?: boolean;
+/** Value that configures or reports path keys for this contract. */
+pathKeys?: readonly string[];
 }
 /** Configures conversion of loosely shaped source test arrays into pm linked tests. */
 export interface ToImportLinkedTestsOptions {
-    /** Value that configures or reports allow scalar for this contract. */
-    allowScalar?: boolean;
-    /** Value that configures or reports command keys for this contract. */
-    commandKeys?: readonly string[];
-    /** Value that configures or reports path keys for this contract. */
-    pathKeys?: readonly string[];
-    /** Value that configures or reports require command for this contract. */
-    requireCommand?: boolean;
-    /** Value that configures or reports include extended assertions for this contract. */
-    includeExtendedAssertions?: boolean;
-    /** Value that configures or reports integer timeout for this contract. */
-    integerTimeout?: boolean;
-    /** Value that configures or reports timeout minimum for this contract. */
-    timeoutMinimum?: number;
-    /** Value that configures or reports timeout exclusive minimum for this contract. */
-    timeoutExclusiveMinimum?: boolean;
+/** Value that configures or reports allow scalar for this contract. */
+allowScalar?: boolean;
+/** Value that configures or reports command keys for this contract. */
+commandKeys?: readonly string[];
+/** Value that configures or reports path keys for this contract. */
+pathKeys?: readonly string[];
+/** Value that configures or reports require command for this contract. */
+requireCommand?: boolean;
+/** Value that configures or reports include extended assertions for this contract. */
+includeExtendedAssertions?: boolean;
+/** Value that configures or reports integer timeout for this contract. */
+integerTimeout?: boolean;
+/** Value that configures or reports timeout minimum for this contract. */
+timeoutMinimum?: number;
+/** Value that configures or reports timeout exclusive minimum for this contract. */
+timeoutExclusiveMinimum?: boolean;
 }
 /** Returns the trimmed string when `value` is a non-empty string, else undefined. */
 export declare function toNonEmptyImportString(value: unknown): string | undefined;
@@ -102,30 +102,30 @@ export declare function ensureTrackerInitialized(pmRoot: string): Promise<void>;
 export declare function emptyImportedDocument(): ItemDocument;
 /** Documents the commit imported item params payload exchanged by command, SDK, and package integrations. */
 export interface CommitImportedItemParams {
-    /** Value that configures or reports pm root for this contract. */
-    pmRoot: string;
-    /** Stable identifier used to reference this record across commands and storage. */
-    id: string;
-    /** Filesystem path used for item resolution. */
-    itemPath: string;
-    /** Value that configures or reports document for this contract. */
-    document: ItemDocument;
-    /** Value that configures or reports author for this contract. */
-    author: string;
-    /** Human-readable explanation suitable for logs and agent-facing output. */
-    message: string;
-    /** Value that configures or reports settings for this contract. */
-    settings: PmSettings;
-    /** Warning prefix emitted on a lock conflict, e.g. "beads_import_lock_conflict". */
-    conflictWarningPrefix: string;
+/** Value that configures or reports pm root for this contract. */
+pmRoot: string;
+/** Stable identifier used to reference this record across commands and storage. */
+id: string;
+/** Filesystem path used for item resolution. */
+itemPath: string;
+/** Value that configures or reports document for this contract. */
+document: ItemDocument;
+/** Value that configures or reports author for this contract. */
+author: string;
+/** Human-readable explanation suitable for logs and agent-facing output. */
+message: string;
+/** Value that configures or reports settings for this contract. */
+settings: PmSettings;
+/** Warning prefix emitted on a lock conflict, e.g. "beads_import_lock_conflict". */
+conflictWarningPrefix: string;
 }
 /** Restricts commit imported item result values accepted by command, SDK, and storage contracts. */
 export type CommitImportedItemResult = {
-    committed: true;
-    writeWarnings: string[];
+committed: true;
+writeWarnings: string[];
 } | {
-    committed: false;
-    conflictWarning: string;
+committed: false;
+conflictWarning: string;
 };
 /** Performs the shared item write/commit sequence: acquire the per-item lock, atomically write the TOON document, append the import history entry, and run on-write hooks. On a lock CONFLICT it returns a `conflictWarning` (using the caller-supplied prefix) instead of throwing; any other error removes the partially written file and rethrows. */
 export declare function commitImportedItem(params: CommitImportedItemParams): Promise<CommitImportedItemResult>;