@unbrained/pm-cli 2026.10.13 → 2026.10.15

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

@@ -9,86 +9,86 @@ 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;
+version:number;
 /** Exact author literals mapped to canonical harness namespaces. */
-aliases: Readonly<Record<string, string>>;
+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[];
+harness?:string | readonly string[];
 /** Privacy-safe invocation fingerprint. */
-agentInstance?: string | readonly string[];
+agentInstance?:string | readonly string[];
 /** Dimension predicates expressed as exact `dimension=value` pairs. */
-provenance?: string | readonly string[];
+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;
+item_id?:string;
 /** Optional one-based stream version supplied by a collection reader. */
-version?: number;
+version?:number;
 /** Immutable event timestamp. */
-ts: string;
+ts:string;
 /** Immutable mutation operation. */
-op: string;
+op:string;
 /** Original, byte-preserved author literal. */
-author: string;
+author:string;
 /** Recorded author selection source when available. */
-author_source?: HistoryEntry["author_source"];
+author_source?:HistoryEntry["author_source"];
 /** Recorded harness or read-time alias interpretation. */
-agent_harness?: string;
+agent_harness?:string;
 /** Whether the harness was recorded, interpreted, or remains unresolved. */
-harness_source: "recorded" | "vocabulary" | "unresolved";
+harness_source:"recorded" | "vocabulary" | "unresolved";
 /** Vocabulary revision used for this interpretation. */
-vocabulary_version: number;
+vocabulary_version:number;
 /** Privacy-safe invocation fingerprint. */
-agent_instance?: string;
+agent_instance?:string;
 /** Every recorded extensible provenance observation, without patch payloads. */
-agent_provenance: NonNullable<HistoryEntry["agent_provenance"]>;
+agent_provenance:NonNullable<HistoryEntry["agent_provenance"]>;
 /** Optional event message. */
-message?: string;
+message?:string;
 }
 /** Constant-size provenance coverage report over an inspected history set. */
 export interface HistoryProvenanceSummary {
 /** Number of immutable entries inspected. */
-entries: number;
+entries:number;
 /** Vocabulary revision used for legacy interpretation. */
-vocabulary_version: number;
+vocabulary_version:number;
 /** Recorded or interpreted harness coverage. */
-harness: {
+harness:{
 /** Entries resolving to a canonical harness. */
-resolved: number;
+resolved:number;
 /** Entries without a recorded or interpreted harness. */
-unresolved: number;
+unresolved:number;
 /** Most frequent unresolved author literals, bounded to twenty rows. */
-unresolved_authors: Array<{
-author: string;
-entries: number;
+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;
+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;
+export declare const DEFAULT_AUTHOR_IDENTITY_VOCABULARY:AuthorIdentityVocabulary;
 /** Resolve the extensible dimension vocabulary declared by built-ins and workspace descriptors. */
-export declare function resolveHistoryProvenanceDimensions(descriptors?: readonly HarnessSignalDescriptor[]): string[];
+export declare function resolveHistoryProvenanceDimensions(descriptors?:readonly HarnessSignalDescriptor[]):string[];
 /** Parse and validate exact provenance dimension predicates. */
-export declare function parseHistoryProvenanceFilters(filters: HistoryProvenanceFilters, dimensions?: readonly string[]): Map<string, Set<string>>;
+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;
-}): HistoryProvenanceRow;
+export declare function projectHistoryProvenance(entry:HistoryEntry,vocabulary?:AuthorIdentityVocabulary,coordinates?:{
+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;
+export declare function historyEntryMatchesProvenance(entry:HistoryEntry,filters:HistoryProvenanceFilters,vocabulary?:AuthorIdentityVocabulary,dimensions?:readonly string[]):boolean;
 /** Compile shared provenance predicates once for efficient history scans. */
-export declare function compileHistoryProvenanceMatcher(filters: HistoryProvenanceFilters, vocabulary?: AuthorIdentityVocabulary, dimensions?: readonly string[]): (entry: HistoryEntry) => boolean;
+export declare function compileHistoryProvenanceMatcher(filters:HistoryProvenanceFilters,vocabulary?:AuthorIdentityVocabulary,dimensions?:readonly string[]):(entry:HistoryEntry) => boolean;
 /** Summarize identity and dimension completeness without returning event rows. */
-export declare function summarizeHistoryProvenance(entries: readonly HistoryEntry[], vocabulary?: AuthorIdentityVocabulary, dimensions?: readonly string[]): HistoryProvenanceSummary;
+export declare function summarizeHistoryProvenance(entries:readonly HistoryEntry[],vocabulary?:AuthorIdentityVocabulary,dimensions?:readonly string[]):HistoryProvenanceSummary;

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

@@ -1,51 +1,51 @@
-import { applyHistoryPatch, ensureMaterializedHistoryTarget, extractPatchFailureContext, replayHistoryToTarget, resolveHistoryTarget, type ResolvedHistoryTarget } from "../core/history/projection.js";
+import { applyHistoryPatch,ensureMaterializedHistoryTarget,extractPatchFailureContext,replayHistoryToTarget,resolveHistoryTarget,type ResolvedHistoryTarget } from "../core/history/projection.js";
 import { readHistoryEntries } from "../core/history/read.js";
-import type { HistoryEntry, ItemDocument } from "../types/index.js";
-export { findHistoryIdentityDiscontinuities, type HistoryIdentityDiscontinuity, } from "../core/history/identity.js";
+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;
+pmRoot?:string;
 /** Working directory used when discovering the nearest tracker. */
-cwd?: string;
+cwd?:string;
 }
 /** Verified historical item projection returned by {@link getItemAt}. */
 export interface GetItemAtResult {
 /** Reconstructed canonical item document at the selected version. */
-document: ItemDocument;
+document:ItemDocument;
 /** Always true, preventing consumers from confusing this with current state. */
-reconstructed: true;
+reconstructed:true;
 /** Durable one-based version; null when a legacy checkpoint lost its mapping. */
-as_of_version: number | null;
+as_of_version:number | null;
 /** Timestamp of the final included history entry. */
-as_of_timestamp: string;
+as_of_timestamp:string;
 /** Normalized target resolution metadata shared with restore. */
-target: ResolvedHistoryTarget;
+target:ResolvedHistoryTarget;
 /** Total number of entries currently available in the stream. */
-history_length: number;
+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;
+ok:boolean;
 /** Number of entries verified. */
-entries: number;
+entries:number;
 /** Stable verification errors in encounter order. */
-errors: string[];
+errors:string[];
 /** Hash produced by the newest entry, when one exists. */
-latest_after_hash?: string;
+latest_after_hash?:string;
 /** Canonical hash of the supplied current document. */
-current_item_hash?: string;
+current_item_hash?:string;
 /** Whether the supplied document matches the newest history hash. */
-current_matches_latest?: boolean;
+current_matches_latest?:boolean;
 /** Whether every governed workspace singleton matches the latest replayed state. */
-workspace_state_matches_latest?: boolean;
+workspace_state_matches_latest?:boolean;
 /** Governed singleton paths whose JSON differs from the replayed value. */
-workspace_state_mismatches?: string[];
+workspace_state_mismatches?:string[];
 /** Governed singleton paths absent from disk. */
-workspace_state_missing?: string[];
+workspace_state_missing?:string[];
 /** Governed singleton paths unreadable as safe workspace-local JSON. */
-workspace_state_unreadable?: string[];
+workspace_state_unreadable?:string[];
 }
 /**
  * Verify a history chain and optionally compare it with a current document.
@@ -54,10 +54,10 @@ workspace_state_unreadable?: string[];
  * aggregate multiple configuration files and therefore have no single item
  * document to compare.
  */
-export declare function verifyHistoryEntries(history: HistoryEntry[], currentDocument?: ItemDocument): HistoryVerificationResult;
+export declare function verifyHistoryEntries(history:HistoryEntry[],currentDocument?:ItemDocument):HistoryVerificationResult;
 /**
  * Reconstruct one item at a one-based version or ISO timestamp without locks,
  * item writes, history writes, or derived-index mutations.
  */
-export declare function getItemAt(id: string, target: string, options?: GetItemAtOptions): Promise<GetItemAtResult>;
-export { applyHistoryPatch, ensureMaterializedHistoryTarget, extractPatchFailureContext, readHistoryEntries, replayHistoryToTarget, resolveHistoryTarget, };
+export declare function getItemAt(id:string,target:string,options?:GetItemAtOptions):Promise<GetItemAtResult>;
+export { applyHistoryPatch,ensureMaterializedHistoryTarget,extractPatchFailureContext,readHistoryEntries,replayHistoryToTarget,resolveHistoryTarget,};

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

@@ -1,110 +1,110 @@
-export { resolveHistorySubject, type HistorySubject, } from "./history/subject.js";
+export { resolveHistorySubject,type HistorySubject,} from "./history/subject.js";
 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;
+literal?:string[] | string;
 /** Value that configures or reports regex for this contract. */
-regex?: string[] | string;
+regex?:string[] | string;
 /** Value that configures or reports replacement for this contract. */
-replacement?: string;
+replacement?:string;
 /** 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;
 }
 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;
+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 patterns for this contract. */
-patterns: {
+patterns:{
 /** Number of unique literal matchers accepted without disclosing their values. */
-literal_count: number;
+literal_count:number;
 /** Number of unique regular-expression matchers accepted without disclosing their source. */
-regex_count: number;
+regex_count:number;
 /** Total number of accepted matchers across both matcher kinds. */
-total_count: number;
+total_count:number;
 /** Whether the canonical default replacement was selected implicitly. */
-replacement_is_default: boolean;
+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[];
+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;
+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[];
+warnings:string[];
 /** ISO 8601 timestamp recording when generated occurred. */
-generated_at: string;
+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;
+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;
 };
-declare function applyRegexRule(value: string, rule: RegexRule, replacement: string): {
-value: string;
-replacements: number;
+declare function applyRegexRule(value:string,rule:RegexRule,replacement:string):{
+value:string;
+replacements:number;
 };
-declare function redactStringValue(value: string, rules: RedactionRule[], replacement: string): {
-value: string;
-replacements: number;
+declare function redactStringValue(value:string,rules:RedactionRule[],replacement:string):{
+value:string;
+replacements:number;
 };
-declare function redactUnknownValue(value: unknown, rules: RedactionRule[], replacement: string): {
-value: unknown;
-replacements: number;
+declare function redactUnknownValue(value:unknown,rules:RedactionRule[],replacement:string):{
+value:unknown;
+replacements:number;
 };
-declare function hasItemMetadata(replay: ReplayDocument): boolean;
+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>;
+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;
+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;
 };