@unbrained/pm-cli 2026.10.13 → 2026.10.15

package/dist/sdk/history-repair.d.ts

@@ -12,187 +12,187 @@ import { type ProvenanceNormalizationReceipt } from "./governance/provenance-hea
 /** Documents the history repair command options payload exchanged by command, SDK, and package integrations. */
 export interface HistoryRepairCommandOptions {
 /** Remove only an invalid trailing suffix after a verified prefix; never re-anchor or reconcile. */
-salvageTail?: boolean;
+salvageTail?:boolean;
 /** Value that configures or reports dry run for this contract. */
-dryRun?: boolean;
+dryRun?:boolean;
 /** Value that configures or reports author for this contract. */
-author?: string;
+author?:string;
 /** Human-readable explanation suitable for logs and agent-facing output. */
-message?: string;
+message?:string;
 /** Value that configures or reports force for this contract. */
-force?: boolean;
+force?:boolean;
 /** Audit operation label used by specialized SDK workflows such as merge reconciliation. */
-auditOperation?: string;
+auditOperation?:string;
 /** Structured audit context attached to the synthetic reconciliation event. */
-auditContext?: Record<string, unknown>;
+auditContext?:Record<string,unknown>;
 /** Per-item audit contexts used by bulk specialized reconciliation workflows. */
-auditContextById?: Record<string, Record<string, unknown>>;
+auditContextById?:Record<string,Record<string,unknown>>;
 /** Add an audit event even when replay and the current item already match. */
-forceAuditEntry?: boolean;
+forceAuditEntry?:boolean;
 /** Remove bounded-domain-invalid provenance observations and record an aggregate privacy-safe audit receipt. */
-normalizeProvenance?: boolean;
+normalizeProvenance?:boolean;
 /** Internal receipt evidence revalidated against the exact item snapshot used by this repair. */
-mergeReceiptProof?: {
-gitWorkspaceRoot: string | null;
-receipts: MergeDecisionReceipt[];
+mergeReceiptProof?:{
+gitWorkspaceRoot:string | null;
+receipts:MergeDecisionReceipt[];
 };
 /** Internal per-item receipt proof index used by bounded bulk reconciliation. */
-mergeReceiptProofById?: Record<string, {
-gitWorkspaceRoot: string | null;
-receipts: MergeDecisionReceipt[];
+mergeReceiptProofById?:Record<string,{
+gitWorkspaceRoot:string | null;
+receipts:MergeDecisionReceipt[];
 }>;
 /** Restored-origin evidence checked against the same item snapshot protected by the rewrite transaction. */
-mergeAbandonmentProof?: {
+mergeAbandonmentProof?:{
 /** Git workspace containing the tracked item. */
-gitWorkspaceRoot: string;
+gitWorkspaceRoot:string;
 /** Authoritative receipt whose original rebase state must match. */
-receipt: MergeDecisionReceipt;
+receipt:MergeDecisionReceipt;
 };
 }
 /** Documents the history repair result payload exchanged by command, SDK, and package integrations. */
 export interface HistoryRepairResult {
 /** Present when invalid trailing bytes were selected for explicit salvage. */
-salvage?: HistorySalvageReceipt;
+salvage?:HistorySalvageReceipt;
 /** Stable identifier used to reference this record across commands and storage. */
-id: string;
+id:string;
 /** Value that configures or reports dry run for this contract. */
-dry_run: boolean;
+dry_run:boolean;
 /** Value that configures or reports changed for this contract. */
-changed: boolean;
+changed:boolean;
 /** Value that configures or reports history for this contract. */
-history: {
-path: string;
-entries_scanned: number;
-chain_drift_before: boolean;
-entries_rehashed: number;
-entries_patch_repaired: number;
-converted_replace_to_add: number;
-skipped_ops: number;
-reconciled_with_item: boolean;
-audit_entry_added: boolean;
-verify_ok: boolean;
-verify_errors: string[];
-item_hash_version_before: number | null;
-item_hash_version_after: number;
-version_disposition: "preserved" | "selected_for_ambiguous_stream";
+history:{
+path:string;
+entries_scanned:number;
+chain_drift_before:boolean;
+entries_rehashed:number;
+entries_patch_repaired:number;
+converted_replace_to_add:number;
+skipped_ops:number;
+reconciled_with_item:boolean;
+audit_entry_added:boolean;
+verify_ok:boolean;
+verify_errors:string[];
+item_hash_version_before:number | null;
+item_hash_version_after:number;
+version_disposition:"preserved" | "selected_for_ambiguous_stream";
 };
 /** Value that configures or reports item for this contract. */
-item: {
-exists: boolean;
-path: string | null;
-matched_chain_before: boolean | null;
+item:{
+exists:boolean;
+path:string | null;
+matched_chain_before:boolean | null;
 };
 /** Privacy-safe receipt for the explicitly requested provenance normalization mode. */
-provenance_normalization: ProvenanceNormalizationReceipt & {
-requested: boolean;
+provenance_normalization:ProvenanceNormalizationReceipt & {
+requested:boolean;
 };
 /** Present when reconciling the chain with the on-disk item discards the replayed effect of earlier history events (GH-603): names the reverted fields and the authors whose mutations the reconciliation overwrites, so cross-author data loss after a lossy merge is loud instead of silent. */
-reconciliation?: HistoryRepairReconciliationReport;
+reconciliation?:HistoryRepairReconciliationReport;
 /** Present when merge reconciliation supplied receipt evidence for this item. */
-merge_receipt_proof?: MergeReceiptProofResult;
+merge_receipt_proof?:MergeReceiptProofResult;
 /** Value that configures or reports warnings for this contract. */
-warnings: string[];
+warnings:string[];
 /** ISO 8601 timestamp recording when generated occurred. */
-generated_at: string;
+generated_at:string;
 }
 /** Fail-closed proof that clone-local driver receipts exactly cover the current reconciliation fields and values. */
 export interface MergeReceiptProofResult {
 /** Whether exact receipt identity, path, field, and value-hash evidence proves the snapshot. */
-trusted: boolean;
+trusted:boolean;
 /** Stable explanation for the trust decision. */
-reason: "trusted_merge_driver_hash_evidence" | "git_workspace_unavailable" | "item_path_unavailable" | "no_item_receipts" | "no_receipt_set_proves_snapshot";
+reason:"trusted_merge_driver_hash_evidence" | "git_workspace_unavailable" | "item_path_unavailable" | "no_item_receipts" | "no_receipt_set_proves_snapshot";
 /** Exact receipt identities accepted as proof; empty when proof is refused. */
-receipt_ids: string[];
+receipt_ids:string[];
 }
 /** Documents one history event attributed to fields changed by reconciliation. */
 export interface HistoryRepairDiscardedEvent {
 /** 1-based index of the event in the (re-anchored) history stream. */
-index: number;
+index:number;
 /** Timestamp of the attributed event. */
-ts: string;
+ts:string;
 /** Author whose mutation is being classified. */
-author: string;
+author:string;
 /** Operation label of the discarded event. */
-op: string;
+op:string;
 /** Reconciled fields this event last wrote. */
-fields: string[];
+fields:string[];
 }
 /** Documents the repair reconciliation data-loss report exchanged by command, SDK, and package integrations. */
 export interface HistoryRepairReconciliationReport {
 /** Total number of fields changed by the reconciliation patch. */
-reconciled_field_count: number;
+reconciled_field_count:number;
 /** Every field changed by the reconciliation patch. */
-reconciled_fields: string[];
+reconciled_fields:string[];
 /** Number of fields the reconciliation patch reverts relative to the replayed chain. */
-reverted_field_count: number;
+reverted_field_count:number;
 /** Fields whose replayed values the reconciliation overwrites with the on-disk item's values. */
-reverted_fields: string[];
+reverted_fields:string[];
 /** Newest history events that last wrote each reverted field — the mutations being discarded. */
-discarded_events: HistoryRepairDiscardedEvent[];
+discarded_events:HistoryRepairDiscardedEvent[];
 /** Distinct authors whose mutations the reconciliation discards. */
-discarded_authors: string[];
+discarded_authors:string[];
 /** Number of changed fields whose replayed value remains present in the on-disk item. */
-preserved_field_count: number;
+preserved_field_count:number;
 /** Changed fields whose replayed value remains present after reconciliation. */
-preserved_fields: string[];
+preserved_fields:string[];
 /** Newest history events whose effects remain preserved by reconciliation. */
-preserved_events: HistoryRepairDiscardedEvent[];
+preserved_events:HistoryRepairDiscardedEvent[];
 /** Distinct authors whose reconciled mutations remain preserved. */
-preserved_authors: string[];
+preserved_authors:string[];
 /** How to recover a discarded mutation instead of accepting the revert. */
-recovery_hint: string | null;
+recovery_hint:string | null;
 }
 /** Compute which chain-vs-item differences preserve replayed context and which genuinely discard it. */
-export declare function analyzeReconciliationDiscard(entries: HistoryEntry[], finalReplay: ReplayDocument, currentItemReplay: ReplayDocument): HistoryRepairReconciliationReport | undefined;
+export declare function analyzeReconciliationDiscard(entries:HistoryEntry[],finalReplay:ReplayDocument,currentItemReplay:ReplayDocument):HistoryRepairReconciliationReport | undefined;
 /** Implements run history repair for the public runtime surface of this module. */
-export declare function runHistoryRepair(id: string, options: HistoryRepairCommandOptions, global: GlobalOptions): Promise<HistoryRepairResult>;
+export declare function runHistoryRepair(id:string,options:HistoryRepairCommandOptions,global:GlobalOptions):Promise<HistoryRepairResult>;
 /** Documents the history repair all stream result payload exchanged by command, SDK, and package integrations. */
 export interface HistoryRepairAllStreamResult {
 /** Stable identifier used to reference this record across commands and storage. */
-id: string;
+id:string;
 /** Value that configures or reports outcome for this contract. */
-outcome: "repaired" | "skipped_clean" | "failed";
+outcome:"repaired" | "skipped_clean" | "failed";
 /** Value that configures or reports entries rehashed for this contract. */
-entries_rehashed?: number;
+entries_rehashed?:number;
 /** Value that configures or reports entries patch repaired for this contract. */
-entries_patch_repaired?: number;
+entries_patch_repaired?:number;
 /** Value that configures or reports reconciled with item for this contract. */
-reconciled_with_item?: boolean;
+reconciled_with_item?:boolean;
 /** Cross-author data-loss detail when reconciliation overwrites replayed mutations. */
-reconciliation?: HistoryRepairReconciliationReport;
+reconciliation?:HistoryRepairReconciliationReport;
 /** Exact receipt proof used to authorize this stream, when supplied. */
-merge_receipt_proof?: MergeReceiptProofResult;
+merge_receipt_proof?:MergeReceiptProofResult;
 /** Stream-specific repair warnings retained by the bulk workflow. */
-warnings?: string[];
+warnings?:string[];
 /** Value that configures or reports error for this contract. */
-error?: string;
+error?:string;
 }
 /** Documents the history repair all result payload exchanged by command, SDK, and package integrations. */
 export interface HistoryRepairAllResult {
 /** Value that configures or reports all for this contract. */
-all: true;
+all:true;
 /** Value that configures or reports dry run for this contract. */
-dry_run: boolean;
+dry_run:boolean;
 /** Value that configures or reports scanned streams for this contract. */
-scanned_streams: number;
+scanned_streams:number;
 /** Value that configures or reports drifted streams for this contract. */
-drifted_streams: number;
+drifted_streams:number;
 /** Streams selected only because invalid provenance required normalization. */
-provenance_invalid_streams: number;
+provenance_invalid_streams:number;
 /** One compact row per drifted or provenance-normalization target. */
-streams: HistoryRepairAllStreamResult[];
+streams:HistoryRepairAllStreamResult[];
 /** Value that configures or reports totals for this contract. */
-totals: {
-repaired: number;
-skipped_clean: number;
-failed: number;
+totals:{
+repaired:number;
+skipped_clean:number;
+failed:number;
 };
 /** Value that configures or reports warnings for this contract. */
-warnings: string[];
+warnings:string[];
 /** ISO 8601 timestamp recording when generated occurred. */
-generated_at: string;
+generated_at:string;
 }
 /** Enforce the `pm history-repair` target contract shared by the CLI and MCP surfaces: exactly one of an item `<id>` or `--all` must be provided. */
-export declare function assertHistoryRepairTarget(id: string | undefined, all: boolean): void;
+export declare function assertHistoryRepairTarget(id:string | undefined,all:boolean):void;
 /** Bulk drift repair: scan every item's history stream with the same drift scan `pm health` uses, then run the audited single-stream repair (ownership check, lock, no-drift verification, audit marker) for each drifted stream. One failing stream never aborts the rest; failures are collected per row and the caller decides the exit code from `totals.failed`. */
-export declare function runHistoryRepairAll(options: HistoryRepairCommandOptions, global: GlobalOptions): Promise<HistoryRepairAllResult>;
+export declare function runHistoryRepairAll(options:HistoryRepairCommandOptions,global:GlobalOptions):Promise<HistoryRepairAllResult>;

package/dist/sdk/improvement-ledger-validation.d.ts

@@ -1,3 +1,3 @@
 import type { ImprovementLedgerDocument } from "./improvement-ledger.js";
 /** Parse and validate a serialized improvement-ledger singleton. */
-export declare function parseImprovementLedgerDocument(raw: string | null): ImprovementLedgerDocument;
+export declare function parseImprovementLedgerDocument(raw:string | null):ImprovementLedgerDocument;

package/dist/sdk/improvement-ledger.d.ts

@@ -4,136 +4,136 @@ export type ImprovementDirection = "higher" | "lower" | "target";
 /** One immutable quantitative observation retained by the workspace ledger. */
 export interface ImprovementObservation {
 /** Content-derived observation identity. */
-id: string;
+id:string;
 /** Stable, agent-readable metric name. */
-metric: string;
+metric:string;
 /** Finite observed numeric value. */
-value: number;
+value:number;
 /** Direction in which later values improve. */
-direction: ImprovementDirection;
+direction:ImprovementDirection;
 /** Optional domain unit such as count, ms, bytes, or percent. */
-unit?: string;
+unit?:string;
 /** Required target when direction is target; optional gate threshold otherwise. */
-threshold?: number;
+threshold?:number;
 /** ISO timestamp at which the value was observed. */
-observed_at: string;
+observed_at:string;
 /** Git commit, caller revision, or explicit unversioned marker. */
-revision: string;
+revision:string;
 /** How the revision value was obtained. */
-revision_source: "caller" | "git" | "unversioned";
+revision_source:"caller" | "git" | "unversioned";
 /** Attributed actor that recorded the observation. */
-author: string;
+author:string;
 /** Optional tracked item owning the measurement. */
-item_id?: string;
+item_id?:string;
 /** Optional producing instrument or gate name. */
-source?: string;
+source?:string;
 /** Stable retry key when supplied or derivable from a revision. */
-idempotency_key?: string;
+idempotency_key?:string;
 }
 /** Versioned workspace singleton containing every retained observation. */
 export interface ImprovementLedgerDocument {
 /** Storage contract revision. */
-format_version: 1;
+format_version:1;
 /** Append-only observations in deterministic chronological order. */
-observations: ImprovementObservation[];
+observations:ImprovementObservation[];
 }
 /** Mutation controls accepted by {@link recordImprovementObservation}. */
 export interface RecordImprovementObservationOptions {
 /** Stable metric name. */
-metric: string;
+metric:string;
 /** Finite observed numeric value. */
-value: number;
+value:number;
 /** Direction in which later values improve. */
-direction?: ImprovementDirection;
+direction?:ImprovementDirection;
 /** Optional domain unit. */
-unit?: string;
+unit?:string;
 /** Target or gate threshold associated with this observation. */
-threshold?: number;
+threshold?:number;
 /** Optional producing instrument or gate name. */
-source?: string;
+source?:string;
 /** Optional tracked item owning the observation. */
-itemId?: string;
+itemId?:string;
 /** Explicit source revision; otherwise git HEAD is resolved when available. */
-revision?: string;
+revision?:string;
 /** Explicit observation time, primarily for reproducible importers. */
-observedAt?: string;
+observedAt?:string;
 /** Explicit retry identity. */
-idempotencyKey?: string;
+idempotencyKey?:string;
 /** Intentional author override. */
-author?: string;
+author?:string;
 /** Human-readable audit rationale. */
-message?: string;
+message?:string;
 }
 /** Receipt returned after recording or replaying one observation. */
 export interface RecordImprovementObservationResult {
 /** Whether a new observation was appended. */
-changed: boolean;
+changed:boolean;
 /** Recorded or idempotently replayed observation. */
-observation: ImprovementObservation;
+observation:ImprovementObservation;
 /** Workspace-relative singleton path. */
-ledger_path: "improvement-ledger.json";
+ledger_path:"improvement-ledger.json";
 }
 /** Bounded read controls for {@link readImprovementLedger}. */
 export interface ReadImprovementLedgerOptions {
 /** Explicit tracker root, equivalent to global --pm-path. */
-pmRoot?: string;
+pmRoot?:string;
 /** Working directory used for implicit tracker discovery. */
-cwd?: string;
+cwd?:string;
 /** Optional exact metric filter. */
-metric?: string;
+metric?:string;
 /** Optional tracked owner filter. */
-itemId?: string;
+itemId?:string;
 /** Inclusive ISO timestamp lower bound. */
-since?: string;
+since?:string;
 /** Maximum newest observations returned. */
-limit?: number;
+limit?:number;
 }
 /** One baseline-to-latest trend computed without rewriting observations. */
 export interface ImprovementTrend {
 /** Stable metric name. */
-metric: string;
+metric:string;
 /** Direction used to interpret the delta. */
-direction: ImprovementDirection;
+direction:ImprovementDirection;
 /** Oldest matching observation. */
-baseline: ImprovementObservation;
+baseline:ImprovementObservation;
 /** Newest matching observation. */
-latest: ImprovementObservation;
+latest:ImprovementObservation;
 /** Latest value minus baseline value. */
-delta: number;
+delta:number;
 /** Whether the latest value improved over the baseline. */
-improved: boolean;
+improved:boolean;
 /** Number of observations contributing to the trend. */
-sample_count: number;
+sample_count:number;
 }
 /** Bounded ledger page plus complete aggregate trend metadata. */
 export interface ImprovementLedgerResult {
 /** Newest-first observation page. */
-observations: ImprovementObservation[];
+observations:ImprovementObservation[];
 /** Matching observation count before the page limit. */
-total: number;
+total:number;
 /** Whether older matching rows were omitted. */
-truncated: boolean;
+truncated:boolean;
 /** Trends for every matching metric, sorted by metric name. */
-trends: ImprovementTrend[];
+trends:ImprovementTrend[];
 /** Read provenance for deterministic consumers. */
-source: "audited_workspace_singleton";
+source:"audited_workspace_singleton";
 }
-declare function normalizeMetricName(value: string): string;
-declare function normalizeDirection(value: ImprovementDirection | undefined): ImprovementDirection;
-declare function parseObservationLimit(value: number | undefined): number;
-declare function trendForMetric(observations: ImprovementObservation[]): ImprovementTrend;
+declare function normalizeMetricName(value:string):string;
+declare function normalizeDirection(value:ImprovementDirection | undefined):ImprovementDirection;
+declare function parseObservationLimit(value:number | undefined):number;
+declare function trendForMetric(observations:ImprovementObservation[]):ImprovementTrend;
 /** Record one audited observation, returning an idempotent receipt on retry. */
-export declare function recordImprovementObservation(options: RecordImprovementObservationOptions, global?: {
-path?: string;
-}): Promise<RecordImprovementObservationResult>;
+export declare function recordImprovementObservation(options:RecordImprovementObservationOptions,global?:{
+path?:string;
+}):Promise<RecordImprovementObservationResult>;
 /** Read a bounded newest-first observation page and derive complete trends. */
-export declare function readImprovementLedger(options?: ReadImprovementLedgerOptions): Promise<ImprovementLedgerResult>;
+export declare function readImprovementLedger(options?:ReadImprovementLedgerOptions):Promise<ImprovementLedgerResult>;
 /** Pure helpers exposed for storage and trend contract tests. */
-export declare const _testOnlyImprovementLedger: {
-normalizeMetricName: typeof normalizeMetricName;
-normalizeDirection: typeof normalizeDirection;
-parseLedger: typeof parseLedger;
-parseObservationLimit: typeof parseObservationLimit;
-trendForMetric: typeof trendForMetric;
+export declare const _testOnlyImprovementLedger:{
+normalizeMetricName:typeof normalizeMetricName;
+normalizeDirection:typeof normalizeDirection;
+parseLedger:typeof parseLedger;
+parseObservationLimit:typeof parseObservationLimit;
+trendForMetric:typeof trendForMetric;
 };
 export {};