@unbrained/pm-cli 2026.10.12 → 2026.10.14

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

@@ -2,14 +2,14 @@ import type { GlobalOptions } from "../core/shared/command-types.js";
 import { type HistoryCompactBulkResult, type HistoryCompactResult } from "./history-compact.js";
 /** Minimal action context required by MCP history maintenance adapters. */
 export interface HistoryMcpActionContext {
-    /** Optional positional item id used by single-stream mode. */
-    id?: string;
-    /** Alias-rich MCP options normalized by the selected history adapter. */
-    options: Record<string, unknown>;
-    /** Force flag forwarded to integrity-sensitive maintenance engines. */
-    force?: boolean;
-    /** Global tracker and output controls shared with native command handlers. */
-    global: GlobalOptions;
+/** Optional positional item id used by single-stream mode. */
+id?: string;
+/** Alias-rich MCP options normalized by the selected history adapter. */
+options: Record<string, unknown>;
+/** Force flag forwarded to integrity-sensitive maintenance engines. */
+force?: boolean;
+/** Global tracker and output controls shared with native command handlers. */
+global: GlobalOptions;
 }
 /** Dispatch single-stream or all-stream history repair from an MCP payload. */
 export declare function runMcpHistoryRepairAction(context: HistoryMcpActionContext): Promise<unknown>;

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

@@ -8,72 +8,72 @@ import { type HarnessSignalDescriptor } from "../core/shared/author.js";
 import type { HistoryEntry } from "../types.js";
 /** Versioned, workspace-owned interpretation of legacy author spellings. */
 export interface AuthorIdentityVocabulary {
-    /** Reproducible revision included in projections and summaries. */
-    version: number;
-    /** Exact author literals mapped to canonical harness namespaces. */
-    aliases: Readonly<Record<string, string>>;
+/** Reproducible revision included in projections and summaries. */
+version: number;
+/** Exact author literals mapped to canonical harness namespaces. */
+aliases: Readonly<Record<string, string>>;
 }
 /** Read predicates shared by history, activity, events, and SDK consumers. */
 export interface HistoryProvenanceFilters {
-    /** Canonical recorded or vocabulary-resolved harness namespace. */
-    harness?: string | readonly string[];
-    /** Privacy-safe invocation fingerprint. */
-    agentInstance?: string | readonly string[];
-    /** Dimension predicates expressed as exact `dimension=value` pairs. */
-    provenance?: string | readonly string[];
+/** Canonical recorded or vocabulary-resolved harness namespace. */
+harness?: string | readonly string[];
+/** Privacy-safe invocation fingerprint. */
+agentInstance?: string | readonly string[];
+/** Dimension predicates expressed as exact `dimension=value` pairs. */
+provenance?: string | readonly string[];
 }
 /** Patch-free identity and provenance projection for one immutable event. */
 export interface HistoryProvenanceRow {
-    /** Optional history stream subject supplied by a collection reader. */
-    item_id?: string;
-    /** Optional one-based stream version supplied by a collection reader. */
-    version?: number;
-    /** Immutable event timestamp. */
-    ts: string;
-    /** Immutable mutation operation. */
-    op: string;
-    /** Original, byte-preserved author literal. */
-    author: string;
-    /** Recorded author selection source when available. */
-    author_source?: HistoryEntry["author_source"];
-    /** Recorded harness or read-time alias interpretation. */
-    agent_harness?: string;
-    /** Whether the harness was recorded, interpreted, or remains unresolved. */
-    harness_source: "recorded" | "vocabulary" | "unresolved";
-    /** Vocabulary revision used for this interpretation. */
-    vocabulary_version: number;
-    /** Privacy-safe invocation fingerprint. */
-    agent_instance?: string;
-    /** Every recorded extensible provenance observation, without patch payloads. */
-    agent_provenance: NonNullable<HistoryEntry["agent_provenance"]>;
-    /** Optional event message. */
-    message?: string;
+/** Optional history stream subject supplied by a collection reader. */
+item_id?: string;
+/** Optional one-based stream version supplied by a collection reader. */
+version?: number;
+/** Immutable event timestamp. */
+ts: string;
+/** Immutable mutation operation. */
+op: string;
+/** Original, byte-preserved author literal. */
+author: string;
+/** Recorded author selection source when available. */
+author_source?: HistoryEntry["author_source"];
+/** Recorded harness or read-time alias interpretation. */
+agent_harness?: string;
+/** Whether the harness was recorded, interpreted, or remains unresolved. */
+harness_source: "recorded" | "vocabulary" | "unresolved";
+/** Vocabulary revision used for this interpretation. */
+vocabulary_version: number;
+/** Privacy-safe invocation fingerprint. */
+agent_instance?: string;
+/** Every recorded extensible provenance observation, without patch payloads. */
+agent_provenance: NonNullable<HistoryEntry["agent_provenance"]>;
+/** Optional event message. */
+message?: string;
 }
 /** Constant-size provenance coverage report over an inspected history set. */
 export interface HistoryProvenanceSummary {
-    /** Number of immutable entries inspected. */
-    entries: number;
-    /** Vocabulary revision used for legacy interpretation. */
-    vocabulary_version: number;
-    /** Recorded or interpreted harness coverage. */
-    harness: {
-        /** Entries resolving to a canonical harness. */
-        resolved: number;
-        /** Entries without a recorded or interpreted harness. */
-        unresolved: number;
-        /** Most frequent unresolved author literals, bounded to twenty rows. */
-        unresolved_authors: Array<{
-            author: string;
-            entries: number;
-        }>;
-    };
-    /** Availability counts for every observed or declared dimension. */
-    dimensions: Array<{
-        dimension: string;
-        observed: number;
-        unavailable: number;
-        legacy_missing: number;
-    }>;
+/** Number of immutable entries inspected. */
+entries: number;
+/** Vocabulary revision used for legacy interpretation. */
+vocabulary_version: number;
+/** Recorded or interpreted harness coverage. */
+harness: {
+/** Entries resolving to a canonical harness. */
+resolved: number;
+/** Entries without a recorded or interpreted harness. */
+unresolved: number;
+/** Most frequent unresolved author literals, bounded to twenty rows. */
+unresolved_authors: Array<{
+author: string;
+entries: number;
+}>;
+};
+/** Availability counts for every observed or declared dimension. */
+dimensions: Array<{
+dimension: string;
+observed: number;
+unavailable: number;
+legacy_missing: number;
+}>;
 }
 /** Default interpretation used when a legacy workspace has no vocabulary. */
 export declare const DEFAULT_AUTHOR_IDENTITY_VOCABULARY: AuthorIdentityVocabulary;
@@ -83,8 +83,8 @@ export declare function resolveHistoryProvenanceDimensions(descriptors?: readonl
 export declare function parseHistoryProvenanceFilters(filters: HistoryProvenanceFilters, dimensions?: readonly string[]): Map<string, Set<string>>;
 /** Project one immutable entry without its JSON Patch or document hashes. */
 export declare function projectHistoryProvenance(entry: HistoryEntry, vocabulary?: AuthorIdentityVocabulary, coordinates?: {
-    itemId?: string;
-    version?: number;
+itemId?: string;
+version?: number;
 }): HistoryProvenanceRow;
 /** Test one immutable entry against shared provenance predicates. */
 export declare function historyEntryMatchesProvenance(entry: HistoryEntry, filters: HistoryProvenanceFilters, vocabulary?: AuthorIdentityVocabulary, dimensions?: readonly string[]): boolean;

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

@@ -4,48 +4,48 @@ import type { HistoryEntry, ItemDocument } from "../types/index.js";
 export { findHistoryIdentityDiscontinuities, type HistoryIdentityDiscontinuity, } from "../core/history/identity.js";
 /** Workspace resolution controls accepted by {@link getItemAt}. */
 export interface GetItemAtOptions {
-    /** Explicit tracker root, equivalent to the CLI global `--pm-path`. */
-    pmRoot?: string;
-    /** Working directory used when discovering the nearest tracker. */
-    cwd?: string;
+/** Explicit tracker root, equivalent to the CLI global `--pm-path`. */
+pmRoot?: string;
+/** Working directory used when discovering the nearest tracker. */
+cwd?: string;
 }
 /** Verified historical item projection returned by {@link getItemAt}. */
 export interface GetItemAtResult {
-    /** Reconstructed canonical item document at the selected version. */
-    document: ItemDocument;
-    /** Always true, preventing consumers from confusing this with current state. */
-    reconstructed: true;
-    /** Durable one-based version; null when a legacy checkpoint lost its mapping. */
-    as_of_version: number | null;
-    /** Timestamp of the final included history entry. */
-    as_of_timestamp: string;
-    /** Normalized target resolution metadata shared with restore. */
-    target: ResolvedHistoryTarget;
-    /** Total number of entries currently available in the stream. */
-    history_length: number;
+/** Reconstructed canonical item document at the selected version. */
+document: ItemDocument;
+/** Always true, preventing consumers from confusing this with current state. */
+reconstructed: true;
+/** Durable one-based version; null when a legacy checkpoint lost its mapping. */
+as_of_version: number | null;
+/** Timestamp of the final included history entry. */
+as_of_timestamp: string;
+/** Normalized target resolution metadata shared with restore. */
+target: ResolvedHistoryTarget;
+/** Total number of entries currently available in the stream. */
+history_length: number;
 }
 /** Verification projection shared by CLI history reads and SDK consumers. */
 export interface HistoryVerificationResult {
-    /** Whether the hash chain and optional current document both verify. */
-    ok: boolean;
-    /** Number of entries verified. */
-    entries: number;
-    /** Stable verification errors in encounter order. */
-    errors: string[];
-    /** Hash produced by the newest entry, when one exists. */
-    latest_after_hash?: string;
-    /** Canonical hash of the supplied current document. */
-    current_item_hash?: string;
-    /** Whether the supplied document matches the newest history hash. */
-    current_matches_latest?: boolean;
-    /** Whether every governed workspace singleton matches the latest replayed state. */
-    workspace_state_matches_latest?: boolean;
-    /** Governed singleton paths whose JSON differs from the replayed value. */
-    workspace_state_mismatches?: string[];
-    /** Governed singleton paths absent from disk. */
-    workspace_state_missing?: string[];
-    /** Governed singleton paths unreadable as safe workspace-local JSON. */
-    workspace_state_unreadable?: string[];
+/** Whether the hash chain and optional current document both verify. */
+ok: boolean;
+/** Number of entries verified. */
+entries: number;
+/** Stable verification errors in encounter order. */
+errors: string[];
+/** Hash produced by the newest entry, when one exists. */
+latest_after_hash?: string;
+/** Canonical hash of the supplied current document. */
+current_item_hash?: string;
+/** Whether the supplied document matches the newest history hash. */
+current_matches_latest?: boolean;
+/** Whether every governed workspace singleton matches the latest replayed state. */
+workspace_state_matches_latest?: boolean;
+/** Governed singleton paths whose JSON differs from the replayed value. */
+workspace_state_mismatches?: string[];
+/** Governed singleton paths absent from disk. */
+workspace_state_missing?: string[];
+/** Governed singleton paths unreadable as safe workspace-local JSON. */
+workspace_state_unreadable?: string[];
 }
 /**
  * Verify a history chain and optionally compare it with a current document.

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

@@ -3,108 +3,108 @@ import { type ReplayDocument } from "../core/history/replay.js";
 import type { GlobalOptions } from "../core/shared/command-types.js";
 /** Documents the history redact command options payload exchanged by command, SDK, and package integrations. */
 export interface HistoryRedactCommandOptions {
-    /** Value that configures or reports literal for this contract. */
-    literal?: string[] | string;
-    /** Value that configures or reports regex for this contract. */
-    regex?: string[] | string;
-    /** Value that configures or reports replacement for this contract. */
-    replacement?: string;
-    /** Value that configures or reports dry run for this contract. */
-    dryRun?: boolean;
-    /** 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 force for this contract. */
-    force?: boolean;
+/** Value that configures or reports literal for this contract. */
+literal?: string[] | string;
+/** Value that configures or reports regex for this contract. */
+regex?: string[] | string;
+/** Value that configures or reports replacement for this contract. */
+replacement?: string;
+/** Value that configures or reports dry run for this contract. */
+dryRun?: boolean;
+/** 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 force for this contract. */
+force?: boolean;
 }
 interface RegexRule {
-    kind: "regex";
-    source: string;
-    flags: string;
+kind: "regex";
+source: string;
+flags: string;
 }
 interface LiteralRule {
-    kind: "literal";
-    value: string;
+kind: "literal";
+value: string;
 }
 type RedactionRule = RegexRule | LiteralRule;
 /** Documents the history redact result payload exchanged by command, SDK, and package integrations. */
 export interface HistoryRedactResult {
-    /** Stable identifier used to reference this record across commands and storage. */
-    id: string;
-    /** Value that configures or reports dry run for this contract. */
-    dry_run: boolean;
-    /** Value that configures or reports changed for this contract. */
-    changed: boolean;
-    /** Value that configures or reports patterns for this contract. */
-    patterns: {
-        /** Number of unique literal matchers accepted without disclosing their values. */
-        literal_count: number;
-        /** Number of unique regular-expression matchers accepted without disclosing their source. */
-        regex_count: number;
-        /** Total number of accepted matchers across both matcher kinds. */
-        total_count: number;
-        /** Whether the canonical default replacement was selected implicitly. */
-        replacement_is_default: boolean;
-    };
-    /** Value that configures or reports history for this contract. */
-    history: {
-        path: string;
-        entries_scanned: number;
-        entries_changed: number;
-        replacements: number;
-        hash_mismatches_before: number;
-        hash_mismatches_after: number;
-        preexisting_hash_mismatches: number;
-        audit_entry_added: boolean;
-        verify_ok: boolean;
-        verify_errors: string[];
-    };
-    /** Value that configures or reports item for this contract. */
-    item: {
-        existed_before: boolean;
-        exists_after: boolean;
-        path_before: string | null;
-        path_after: string | null;
-        changed: boolean;
-    };
-    /** Value that configures or reports warnings for this contract. */
-    warnings: string[];
-    /** ISO 8601 timestamp recording when generated occurred. */
-    generated_at: string;
+/** Stable identifier used to reference this record across commands and storage. */
+id: string;
+/** Value that configures or reports dry run for this contract. */
+dry_run: boolean;
+/** Value that configures or reports changed for this contract. */
+changed: boolean;
+/** Value that configures or reports patterns for this contract. */
+patterns: {
+/** Number of unique literal matchers accepted without disclosing their values. */
+literal_count: number;
+/** Number of unique regular-expression matchers accepted without disclosing their source. */
+regex_count: number;
+/** Total number of accepted matchers across both matcher kinds. */
+total_count: number;
+/** Whether the canonical default replacement was selected implicitly. */
+replacement_is_default: boolean;
+};
+/** Value that configures or reports history for this contract. */
+history: {
+path: string;
+entries_scanned: number;
+entries_changed: number;
+replacements: number;
+hash_mismatches_before: number;
+hash_mismatches_after: number;
+preexisting_hash_mismatches: number;
+audit_entry_added: boolean;
+verify_ok: boolean;
+verify_errors: string[];
+};
+/** Value that configures or reports item for this contract. */
+item: {
+existed_before: boolean;
+exists_after: boolean;
+path_before: string | null;
+path_after: string | null;
+changed: boolean;
+};
+/** Value that configures or reports warnings for this contract. */
+warnings: string[];
+/** ISO 8601 timestamp recording when generated occurred. */
+generated_at: string;
 }
 declare function normalizeStringArrayInput(value: string[] | string | undefined): string[];
 declare function normalizeRegexFlags(flags: string): string;
 declare function parseRegexRule(spec: string): RegexRule;
 declare function buildRedactionRules(literalInput: string[] | string | undefined, regexInput: string[] | string | undefined): RedactionRule[];
 declare function applyLiteralRule(value: string, literal: string, replacement: string): {
-    value: string;
-    replacements: number;
+value: string;
+replacements: number;
 };
 declare function applyRegexRule(value: string, rule: RegexRule, replacement: string): {
-    value: string;
-    replacements: number;
+value: string;
+replacements: number;
 };
 declare function redactStringValue(value: string, rules: RedactionRule[], replacement: string): {
-    value: string;
-    replacements: number;
+value: string;
+replacements: number;
 };
 declare function redactUnknownValue(value: unknown, rules: RedactionRule[], replacement: string): {
-    value: unknown;
-    replacements: number;
+value: unknown;
+replacements: number;
 };
 declare function hasItemMetadata(replay: ReplayDocument): boolean;
 /** Implements run history redact for the public runtime surface of this module. */
 export declare function runHistoryRedact(id: string, options: HistoryRedactCommandOptions, global: GlobalOptions): Promise<HistoryRedactResult>;
 /** Public contract for test only, shared by SDK and presentation-layer consumers. */
 export declare const _testOnly: {
-    applyLiteralRule: typeof applyLiteralRule;
-    applyRegexRule: typeof applyRegexRule;
-    buildRedactionRules: typeof buildRedactionRules;
-    hasItemMetadata: typeof hasItemMetadata;
-    normalizeRegexFlags: typeof normalizeRegexFlags;
-    normalizeStringArrayInput: typeof normalizeStringArrayInput;
-    parseRegexRule: typeof parseRegexRule;
-    redactStringValue: typeof redactStringValue;
-    redactUnknownValue: typeof redactUnknownValue;
+applyLiteralRule: typeof applyLiteralRule;
+applyRegexRule: typeof applyRegexRule;
+buildRedactionRules: typeof buildRedactionRules;
+hasItemMetadata: typeof hasItemMetadata;
+normalizeRegexFlags: typeof normalizeRegexFlags;
+normalizeStringArrayInput: typeof normalizeStringArrayInput;
+parseRegexRule: typeof parseRegexRule;
+redactStringValue: typeof redactStringValue;
+redactUnknownValue: typeof redactUnknownValue;
 };