@unbrained/pm-cli 2026.10.11 → 2026.10.13

package/dist/sdk/governance/linked-file-report.d.ts

@@ -3,35 +3,35 @@ import { type MissingLinkedPathRow, type OwnerItemMetadata, type StaleLinkOwnerI
 import type { ClassifiedStaleLinkedPath } from "../../core/validate/stale-file-classification.js";
 /** Repair evidence for one path; nested holders use the same ceiling as paths. */
 export interface LinkedFileRepairRow extends MissingLinkedPathRow {
-    /** Same-basename possibilities, not verified relocation instructions. */
-    candidates: string[];
-    /** Whether the classifier withheld additional possible destinations. */
-    candidates_truncated: boolean;
-    /** Unique holder and field pairs referencing this path before projection. */
-    link_count: number;
-    /** Whether the bounded holder list omits any link. */
-    items_truncated: boolean;
-    /** Number of links on nonterminal holders for this path. */
-    active_link_count: number;
+/** Same-basename possibilities, not verified relocation instructions. */
+candidates: string[];
+/** Whether the classifier withheld additional possible destinations. */
+candidates_truncated: boolean;
+/** Unique holder and field pairs referencing this path before projection. */
+link_count: number;
+/** Whether the bounded holder list omits any link. */
+items_truncated: boolean;
+/** Number of links on nonterminal holders for this path. */
+active_link_count: number;
 }
 /** Full-population counters and a bounded, consistently structured worklist. */
 export interface LinkedFileRepairReport {
-    /** Distinct stale path count, also the unprojected worklist row count. */
-    missing_linked_path_rows_count: number;
-    /** Paths with owners and candidates joined before either is truncated. */
-    missing_linked_path_rows: LinkedFileRepairRow[];
-    /** Whether any complete path row is omitted. */
-    missing_linked_path_rows_truncated: boolean;
-    /** Unique path, holder and field triples across every lifecycle state. */
-    missing_linked_links_count: number;
-    /** Missing links whose holders are actionable under the workspace registry. */
-    active_missing_linked_links_count: number;
-    /** Missing links on holders with the configured close status. */
-    legacy_closed_missing_linked_links_count: number;
-    /** Missing links on all terminal holders, including the closed subset. */
-    legacy_terminal_missing_linked_links_count: number;
-    /** Distinct paths referenced by at least one active holder. */
-    active_missing_linked_paths_count: number;
+/** Distinct stale path count, also the unprojected worklist row count. */
+missing_linked_path_rows_count: number;
+/** Paths with owners and candidates joined before either is truncated. */
+missing_linked_path_rows: LinkedFileRepairRow[];
+/** Whether any complete path row is omitted. */
+missing_linked_path_rows_truncated: boolean;
+/** Unique path, holder and field triples across every lifecycle state. */
+missing_linked_links_count: number;
+/** Missing links whose holders are actionable under the workspace registry. */
+active_missing_linked_links_count: number;
+/** Missing links on holders with the configured close status. */
+legacy_closed_missing_linked_links_count: number;
+/** Missing links on all terminal holders, including the closed subset. */
+legacy_terminal_missing_linked_links_count: number;
+/** Distinct paths referenced by at least one active holder. */
+active_missing_linked_paths_count: number;
 }
 /**
  * Build an active-first repair worklist with deterministic path/holder sorting. Unknown

package/dist/sdk/governance/merge-receipt-history.d.ts

@@ -2,51 +2,51 @@
 export declare const DURABLE_MERGE_RECEIPT_INTRODUCED_AT = "2026-08-09T16:15:18.000Z";
 /** One receipt reference discovered at an immutable history coordinate. */
 export interface HistoryMergeReceiptReference {
-    /** Item whose history contains the summary. */
-    itemId: string;
-    /** One-based history line containing the summary. */
-    line: number;
-    /** Privacy-safe receipt identifier. */
-    receiptId: string;
-    /** Whether the summary is a complete supported preferred-era record. */
-    legacySummaryAccepted: boolean;
-    /** Timestamp of the history event that introduced the reference, when valid. */
-    eventTimestamp?: string;
+/** Item whose history contains the summary. */
+itemId: string;
+/** One-based history line containing the summary. */
+line: number;
+/** Privacy-safe receipt identifier. */
+receiptId: string;
+/** Whether the summary is a complete supported preferred-era record. */
+legacySummaryAccepted: boolean;
+/** Timestamp of the history event that introduced the reference, when valid. */
+eventTimestamp?: string;
 }
 /** Audited disposition for one receipt that a pre-durable writer could never publish. */
 export interface HistoryMergeReceiptDisposition {
-    /** Item whose history contains both the original reference and disposition. */
-    itemId: string;
-    /** Receipt identity explicitly accepted as unrecoverable. */
-    receiptId: string;
-    /** One-based coordinate of the original merge event. */
-    originalHistoryLine: number;
-    /** Timestamp copied from the original merge event for exact matching. */
-    originalEventTimestamp: string;
-    /** One-based coordinate of the later audit event that records this disposition. */
-    auditHistoryLine: number;
-    /** Closed reason vocabulary for this exceptional compatibility path. */
-    reason: "legacy_clone_local_only";
+/** Item whose history contains both the original reference and disposition. */
+itemId: string;
+/** Receipt identity explicitly accepted as unrecoverable. */
+receiptId: string;
+/** One-based coordinate of the original merge event. */
+originalHistoryLine: number;
+/** Timestamp copied from the original merge event for exact matching. */
+originalEventTimestamp: string;
+/** One-based coordinate of the later audit event that records this disposition. */
+auditHistoryLine: number;
+/** Closed reason vocabulary for this exceptional compatibility path. */
+reason: "legacy_clone_local_only";
 }
 /** Missing-reference coordinate returned to bounded integrity diagnostics. */
 export interface MissingHistoryMergeReceiptReference {
-    /** Item whose history contains the unresolved reference. */
-    item_id: string;
-    /** One-based history line containing the unresolved reference. */
-    history_line: number;
-    /** Safe identifier when the source value is suitable for diagnostics. */
-    receipt_id?: string;
-    /** Digest used instead of an unsafe identifier. */
-    receipt_reference_hash?: string;
+/** Item whose history contains the unresolved reference. */
+item_id: string;
+/** One-based history line containing the unresolved reference. */
+history_line: number;
+/** Safe identifier when the source value is suitable for diagnostics. */
+receipt_id?: string;
+/** Digest used instead of an unsafe identifier. */
+receipt_reference_hash?: string;
 }
 /** Partitioned compatibility outcome for all scanned history references. */
 export interface HistoryMergeReceiptReferenceClassification {
-    /** References requiring authoritative external evidence. */
-    missing: MissingHistoryMergeReceiptReference[];
-    /** Complete preferred-era summaries accepted without impossible migration. */
-    acceptedLegacyCount: number;
-    /** Pre-durable references accepted by a later explicit audited disposition. */
-    acceptedDispositionCount: number;
+/** References requiring authoritative external evidence. */
+missing: MissingHistoryMergeReceiptReference[];
+/** Complete preferred-era summaries accepted without impossible migration. */
+acceptedLegacyCount: number;
+/** Pre-durable references accepted by a later explicit audited disposition. */
+acceptedDispositionCount: number;
 }
 /** Return whether one summary is a complete, self-contained preferred-era receipt. */
 export declare function isLegacyMergeReceiptSummary(value: Record<string, unknown>, historyItemId: string): boolean;

package/dist/sdk/governance/provenance-health.d.ts

@@ -1,85 +1,85 @@
 import type { HistoryEntry } from "../../types/index.js";
 /** Aggregated resolver attempts for one harness provenance dimension. */
 export interface ProvenanceResolverHealthOutcome {
-    /** Detected harness namespace. */
-    harness: string;
-    /** Provenance dimension resolved by the bounded resolver. */
-    dimension: string;
-    /** Built-in resolver name. */
-    resolver: string;
-    /** Events on which the resolver was actually attempted. */
-    attempts: number;
-    /** Attempted events that produced a bounded value. */
-    successes: number;
+/** Detected harness namespace. */
+harness: string;
+/** Provenance dimension resolved by the bounded resolver. */
+dimension: string;
+/** Built-in resolver name. */
+resolver: string;
+/** Events on which the resolver was actually attempted. */
+attempts: number;
+/** Attempted events that produced a bounded value. */
+successes: number;
 }
 /** Aggregate for legacy provenance values that violate the bounded domain. */
 export interface ProvenanceValueHealthFinding {
-    /** Detected harness namespace. */
-    harness: string;
-    /** Provenance dimension containing the invalid value. */
-    dimension: string;
-    /** Privacy-safe invalid-value class. */
-    kind: "boolean" | "single_digit";
-    /** Events containing this invalid value class. */
-    count: number;
+/** Detected harness namespace. */
+harness: string;
+/** Provenance dimension containing the invalid value. */
+dimension: string;
+/** Privacy-safe invalid-value class. */
+kind: "boolean" | "single_digit";
+/** Events containing this invalid value class. */
+count: number;
 }
 /** Declares exactly which immutable input supports the resolver counters. */
 export interface ProvenanceHealthSample {
-    /** Sorted file order, then append order; this is not a recent-time window. */
-    scope: "history_prefix";
-    /** Maximum nonblank events inspected. */
-    event_limit: number;
-    /** Maximum bytes read across all streams. */
-    byte_limit: number;
-    /** Bytes consumed, including a possible incomplete final line. */
-    bytes_read: number;
-    /** Nonblank events inspected, including malformed rows. */
-    events_read: number;
-    /** Whether an event or byte ceiling stopped this scan. */
-    truncated: boolean;
-    /** Unreadable files or history directories omitted from the scan. */
-    unreadable_sources: number;
-    /** Nonblank rows that could not be decoded as event objects. */
-    malformed_events: number;
-    /** Earliest valid event timestamp in the sample, normalized to UTC. */
-    earliest_event_at: string | null;
-    /** Latest valid event timestamp in the sample, normalized to UTC. */
-    latest_event_at: string | null;
-    /** False if any byte/event bound, unreadable source, or malformed row omitted input. */
-    complete: boolean;
+/** Sorted file order, then append order; this is not a recent-time window. */
+scope: "history_prefix";
+/** Maximum nonblank events inspected. */
+event_limit: number;
+/** Maximum bytes read across all streams. */
+byte_limit: number;
+/** Bytes consumed, including a possible incomplete final line. */
+bytes_read: number;
+/** Nonblank events inspected, including malformed rows. */
+events_read: number;
+/** Whether an event or byte ceiling stopped this scan. */
+truncated: boolean;
+/** Unreadable files or history directories omitted from the scan. */
+unreadable_sources: number;
+/** Nonblank rows that could not be decoded as event objects. */
+malformed_events: number;
+/** Earliest valid event timestamp in the sample, normalized to UTC. */
+earliest_event_at: string | null;
+/** Latest valid event timestamp in the sample, normalized to UTC. */
+latest_event_at: string | null;
+/** False if any byte/event bound, unreadable source, or malformed row omitted input. */
+complete: boolean;
 }
 /** Bounded provenance health result suitable for `pm health` adapters. */
 export interface ProvenanceResolverHealthScan {
-    /** Stable resolver outcome aggregates. */
-    outcomes: ProvenanceResolverHealthOutcome[];
-    /** Bounds, observed time range, and completeness of the input population. */
-    sample: ProvenanceHealthSample;
-    /** Aggregated invalid legacy values without retaining the values themselves. */
-    invalid_values: ProvenanceValueHealthFinding[];
-    /** Advisory warnings for attempted resolvers with no success. */
-    warnings: string[];
-    /** Number of nonblank history events inspected. */
-    events_read: number;
-    /** Whether an event or byte ceiling omitted history input. */
-    truncated: boolean;
+/** Stable resolver outcome aggregates. */
+outcomes: ProvenanceResolverHealthOutcome[];
+/** Bounds, observed time range, and completeness of the input population. */
+sample: ProvenanceHealthSample;
+/** Aggregated invalid legacy values without retaining the values themselves. */
+invalid_values: ProvenanceValueHealthFinding[];
+/** Advisory warnings for attempted resolvers with no success. */
+warnings: string[];
+/** Number of nonblank history events inspected. */
+events_read: number;
+/** Whether an event or byte ceiling omitted history input. */
+truncated: boolean;
 }
 /** Privacy-safe receipt for an explicit provenance normalization pass. */
 export interface ProvenanceNormalizationReceipt {
-    /** Whether at least one immutable event required normalization. */
-    changed: boolean;
-    /** Immutable events whose invalid provenance observations were removed. */
-    events_changed: number;
-    /** Total invalid observations removed without retaining their values. */
-    observations_removed: number;
-    /** Aggregate invalid-value classes removed by the pass. */
-    invalid_values: ProvenanceValueHealthFinding[];
+/** Whether at least one immutable event required normalization. */
+changed: boolean;
+/** Immutable events whose invalid provenance observations were removed. */
+events_changed: number;
+/** Total invalid observations removed without retaining their values. */
+observations_removed: number;
+/** Aggregate invalid-value classes removed by the pass. */
+invalid_values: ProvenanceValueHealthFinding[];
 }
 /** Normalized entries plus the privacy-safe mutation receipt. */
 export interface ProvenanceNormalizationResult {
-    /** History entries with invalid bounded observations removed. */
-    entries: HistoryEntry[];
-    /** Aggregate mutation receipt; never includes an observed value. */
-    receipt: ProvenanceNormalizationReceipt;
+/** History entries with invalid bounded observations removed. */
+entries: HistoryEntry[];
+/** Aggregate mutation receipt; never includes an observed value. */
+receipt: ProvenanceNormalizationReceipt;
 }
 /**
  * Remove only provenance observations whose values violate the bounded domain.

package/dist/sdk/governance/reindex.d.ts

@@ -3,41 +3,41 @@ import type { ItemDocument, PmSettings } from "../../types/index.js";
 type ReindexMode = "keyword" | "semantic" | "hybrid";
 /** Documents the reindex options payload exchanged by command, SDK, and package integrations. */
 export interface ReindexOptions {
-    /** Value that configures or reports mode for this contract. */
-    mode?: string;
-    /** Value that configures or reports progress for this contract. */
-    progress?: boolean;
-    /** Value that configures or reports full for this contract. */
-    full?: boolean;
+/** Value that configures or reports mode for this contract. */
+mode?: string;
+/** Value that configures or reports progress for this contract. */
+progress?: boolean;
+/** Value that configures or reports full for this contract. */
+full?: boolean;
 }
 /** Documents the reindex result payload exchanged by command, SDK, and package integrations. */
 export interface ReindexResult {
-    /** Whether the operation completed without a blocking failure. */
-    ok: boolean;
-    /** Value that configures or reports mode for this contract. */
-    mode: ReindexMode;
-    /** Value that configures or reports total items for this contract. */
-    total_items: number;
-    /** Value that configures or reports semantic for this contract. */
-    semantic: {
-        enabled: boolean;
-        stale_items: number;
-        unchanged_items: number;
-        embedded_items: number;
-        vector_upserted: number;
-        batches_completed: number;
-        /** Actual built-in provider requests, splits, throughput, and byte ceiling. */
-        batching?: EmbeddingBatchReceipt;
-    };
-    /** Value that configures or reports artifacts for this contract. */
-    artifacts: {
-        manifest: string;
-        embeddings: string;
-    };
-    /** Value that configures or reports warnings for this contract. */
-    warnings: string[];
-    /** ISO 8601 timestamp recording when generated occurred. */
-    generated_at: string;
+/** Whether the operation completed without a blocking failure. */
+ok: boolean;
+/** Value that configures or reports mode for this contract. */
+mode: ReindexMode;
+/** Value that configures or reports total items for this contract. */
+total_items: number;
+/** Value that configures or reports semantic for this contract. */
+semantic: {
+enabled: boolean;
+stale_items: number;
+unchanged_items: number;
+embedded_items: number;
+vector_upserted: number;
+batches_completed: number;
+/** Actual built-in provider requests, splits, throughput, and byte ceiling. */
+batching?: EmbeddingBatchReceipt;
+};
+/** Value that configures or reports artifacts for this contract. */
+artifacts: {
+manifest: string;
+embeddings: string;
+};
+/** Value that configures or reports warnings for this contract. */
+warnings: string[];
+/** ISO 8601 timestamp recording when generated occurred. */
+generated_at: string;
 }
 declare function shouldEmitReindexProgress(options: ReindexOptions): boolean;
 declare function emitReindexProgress(enabled: boolean, message: string): void;
@@ -45,93 +45,93 @@ declare function parseMode(raw: string | undefined): ReindexMode;
 declare function hydrateDocuments(pmRoot: string, candidates: CachedDocumentCandidate[], schema: PmSettings["schema"], warnings: string[], itemIds?: Set<string>): Promise<ItemDocument[]>;
 declare function buildKeywordRecord(document: ItemDocument, mode: ReindexMode, corpusFields?: string[]): Record<string, unknown>;
 type ExtensionEmbedBatch = (context: {
-    inputs: string[];
-    settings: PmSettings;
-    model: string;
+inputs: string[];
+settings: PmSettings;
+model: string;
 }) => Promise<number[][]> | number[][];
 type ExtensionEmbedOne = (context: {
-    input: string;
-    settings: PmSettings;
-    model: string;
+input: string;
+settings: PmSettings;
+model: string;
 }) => Promise<number[]> | number[];
 type ExtensionVectorUpsert = (context: {
-    points: Array<{
-        id: string;
-        vector: number[];
-        payload: Record<string, unknown>;
-    }>;
-    settings: PmSettings;
+points: Array<{
+id: string;
+vector: number[];
+payload: Record<string, unknown>;
+}>;
+settings: PmSettings;
 }) => Promise<void> | void;
 type ExtensionVectorDelete = (context: {
-    ids: string[];
-    settings: PmSettings;
+ids: string[];
+settings: PmSettings;
 }) => Promise<void> | void;
 interface ExtensionVectorAdapter {
-    adapterName: string;
-    upsert?: ExtensionVectorUpsert;
-    delete?: ExtensionVectorDelete;
+adapterName: string;
+upsert?: ExtensionVectorUpsert;
+delete?: ExtensionVectorDelete;
 }
 interface ReindexEmbeddingExecutionResult {
-    vectors: number[][];
-    embeddingIdentity: VectorizationEmbeddingIdentity;
+vectors: number[][];
+embeddingIdentity: VectorizationEmbeddingIdentity;
 }
 /** Public contract for test only, shared by SDK and presentation-layer consumers. */
 export declare const _testOnly: {
-    shouldEmitReindexProgress: typeof shouldEmitReindexProgress;
-    emitReindexProgress: typeof emitReindexProgress;
-    parseMode: typeof parseMode;
-    hydrateDocuments: typeof hydrateDocuments;
-    buildKeywordRecord: typeof buildKeywordRecord;
-    resolveExtensionSearchEmbedding: typeof resolveExtensionSearchEmbedding;
-    resolveExtensionVectorAdapter: typeof resolveExtensionVectorAdapter;
-    assertVector: typeof assertVector;
-    executeExtensionEmbedding: typeof executeExtensionEmbedding;
-    resolveExtensionEmbeddingModel: typeof resolveExtensionEmbeddingModel;
-    resolveReindexEmbeddingIdentity: typeof resolveReindexEmbeddingIdentity;
-    executeReindexEmbedding: typeof executeReindexEmbedding;
-    collectLedgerOrphanIds: typeof collectLedgerOrphanIds;
-    resetVectorStoreForReindex: typeof resetVectorStoreForReindex;
-    pruneReindexOrphanVectors: typeof pruneReindexOrphanVectors;
-    upsertReindexVectors: typeof upsertReindexVectors;
+shouldEmitReindexProgress: typeof shouldEmitReindexProgress;
+emitReindexProgress: typeof emitReindexProgress;
+parseMode: typeof parseMode;
+hydrateDocuments: typeof hydrateDocuments;
+buildKeywordRecord: typeof buildKeywordRecord;
+resolveExtensionSearchEmbedding: typeof resolveExtensionSearchEmbedding;
+resolveExtensionVectorAdapter: typeof resolveExtensionVectorAdapter;
+assertVector: typeof assertVector;
+executeExtensionEmbedding: typeof executeExtensionEmbedding;
+resolveExtensionEmbeddingModel: typeof resolveExtensionEmbeddingModel;
+resolveReindexEmbeddingIdentity: typeof resolveReindexEmbeddingIdentity;
+executeReindexEmbedding: typeof executeReindexEmbedding;
+collectLedgerOrphanIds: typeof collectLedgerOrphanIds;
+resetVectorStoreForReindex: typeof resetVectorStoreForReindex;
+pruneReindexOrphanVectors: typeof pruneReindexOrphanVectors;
+upsertReindexVectors: typeof upsertReindexVectors;
 };
 declare function resolveExtensionSearchEmbedding(settings: PmSettings): {
-    name: string;
-    embedBatch?: ExtensionEmbedBatch;
-    embed?: ExtensionEmbedOne;
+name: string;
+embedBatch?: ExtensionEmbedBatch;
+embed?: ExtensionEmbedOne;
 } | null;
 declare function resolveExtensionVectorAdapter(settings: PmSettings): ExtensionVectorAdapter | null;
 declare function assertVector(value: unknown, context: string): number[];
 declare function executeExtensionEmbedding(extensionEmbedding: {
-    name: string;
-    embedBatch?: ExtensionEmbedBatch;
-    embed?: ExtensionEmbedOne;
+name: string;
+embedBatch?: ExtensionEmbedBatch;
+embed?: ExtensionEmbedOne;
 }, settings: PmSettings, corpusInputs: string[]): Promise<number[][]>;
 declare function resolveExtensionEmbeddingModel(settings: PmSettings): string;
 declare function resolveReindexEmbeddingIdentity(settings: PmSettings, activeEmbeddingProvider: ReturnType<typeof resolveEmbeddingProviders>["active"], extensionEmbedding: {
-    name: string;
+name: string;
 } | null): VectorizationEmbeddingIdentity;
 declare function collectLedgerOrphanIds(ledgerEntries: Record<string, string>, currentIds: Set<string>): string[];
 /** Embed the selected corpus through extension or built-in providers, preserving cardinality and execution receipts. */
 declare function executeReindexEmbedding(settings: PmSettings, requestedMode: "keyword" | "semantic" | "hybrid", activeEmbeddingProvider: ReturnType<typeof resolveEmbeddingProviders>["active"], extensionEmbedding: {
-    name: string;
-    embedBatch?: ExtensionEmbedBatch;
-    embed?: ExtensionEmbedOne;
+name: string;
+embedBatch?: ExtensionEmbedBatch;
+embed?: ExtensionEmbedOne;
 } | null, documents: ItemDocument[], semanticWarnings: string[], semanticSummary: ReindexResult["semantic"], progressEnabled: boolean): Promise<ReindexEmbeddingExecutionResult>;
 declare function resetVectorStoreForReindex(activeVectorStore: ReturnType<typeof resolveVectorStores>["active"], extensionVectorAdapter: ExtensionVectorAdapter | null, ledgerEntries: Record<string, string>, settings: PmSettings, semanticWarnings: string[], vectorDimension?: number): Promise<void>;
 declare function pruneReindexOrphanVectors(activeVectorStore: ReturnType<typeof resolveVectorStores>["active"], extensionVectorAdapter: ExtensionVectorAdapter | null, orphanIds: string[], settings: PmSettings, semanticWarnings: string[]): Promise<void>;
 declare function upsertReindexVectors(params: {
-    requestedMode: ReindexMode;
-    activeVectorStore: ReturnType<typeof resolveVectorStores>["active"];
-    extensionVectorAdapter: ExtensionVectorAdapter | null;
-    settings: PmSettings;
-    points: Array<{
-        id: string;
-        vector: number[];
-        payload: Record<string, unknown>;
-    }>;
-    semanticWarnings: string[];
-    semanticSummary: ReindexResult["semantic"];
-    progressEnabled: boolean;
+requestedMode: ReindexMode;
+activeVectorStore: ReturnType<typeof resolveVectorStores>["active"];
+extensionVectorAdapter: ExtensionVectorAdapter | null;
+settings: PmSettings;
+points: Array<{
+id: string;
+vector: number[];
+payload: Record<string, unknown>;
+}>;
+semanticWarnings: string[];
+semanticSummary: ReindexResult["semantic"];
+progressEnabled: boolean;
 }): Promise<void>;
 /** Implements run reindex for the public runtime surface of this module. */
 export declare function runReindex(options: ReindexOptions, global: GlobalOptions): Promise<ReindexResult>;