@unbrained/pm-cli 2026.10.11 → 2026.10.13

package/dist/sdk/history/maintenance.d.ts

@@ -8,64 +8,64 @@ import type { HistorySubject } from "./subject.js";
 export type HistoryMaintenanceOperation = "history-redact" | "history-repair" | "history-compact";
 /** Shared execution controls for a preview or audited stream rewrite. */
 export interface HistoryMaintenanceOptions {
-    /** Compute and verify the plan without acquiring a write lock or persisting it. */
-    dryRun?: boolean;
-    /** Explicit principal override; otherwise use the workspace identity policy. */
-    author?: string;
-    /** Explicit ownership or stale-lock override passed through the existing governance checks. */
-    force?: boolean;
+/** Compute and verify the plan without acquiring a write lock or persisting it. */
+dryRun?: boolean;
+/** Explicit principal override; otherwise use the workspace identity policy. */
+author?: string;
+/** Explicit ownership or stale-lock override passed through the existing governance checks. */
+force?: boolean;
 }
 /** Inputs captured before a transform, bound to the later under-lock drift checks. */
 export interface HistoryMaintenanceSnapshot {
-    /** Original bytes used to decode `entries`, never a second independent read. */
-    raw: string;
-    /** Original stream, including historical anchors and immutable record evidence. */
-    entries: HistoryEntry[];
-    /** Chain verdict for the original entries; repair may deliberately accept drift. */
-    verification: ReturnType<typeof verifyHistoryChain>;
-    /** Current item bytes and document, or null for a deleted item's retained history. */
-    loadedItem: Awaited<ReturnType<typeof readLocatedItem>> | null;
-    /** Resolved identity shared by audit entry construction and lock ownership. */
-    author: string;
+/** Original bytes used to decode `entries`, never a second independent read. */
+raw: string;
+/** Original stream, including historical anchors and immutable record evidence. */
+entries: HistoryEntry[];
+/** Chain verdict for the original entries; repair may deliberately accept drift. */
+verification: ReturnType<typeof verifyHistoryChain>;
+/** Current item bytes and document, or null for a deleted item's retained history. */
+loadedItem: Awaited<ReturnType<typeof readLocatedItem>> | null;
+/** Resolved identity shared by audit entry construction and lock ownership. */
+author: string;
 }
 /** Verified outcome supplied to the operation's existing public result renderer. */
 export interface HistoryMaintenanceOutcome {
-    /** Verification of the exact planned entries before persistence. */
-    verification: ReturnType<typeof verifyHistoryChain>;
-    /** Governance and write-hook warnings, empty for a preview or unchanged plan. */
-    warnings: string[];
+/** Verification of the exact planned entries before persistence. */
+verification: ReturnType<typeof verifyHistoryChain>;
+/** Governance and write-hook warnings, empty for a preview or unchanged plan. */
+warnings: string[];
 }
 /** Operation-owned transform with optional transactional item changes and receipt checks. */
 export interface HistoryMaintenancePlan<Result> {
-    /** Whether the transformation warrants persistence when not previewing. */
-    changed: boolean;
-    /** Final stream including any operation-specific baseline or audit marker. */
-    rewrittenEntries: HistoryEntry[];
-    /** Additional evidence check executed under the lock before any write. */
-    beforeWrite?: () => Promise<void>;
-    /** Override only when history and item bytes must share a rollback transaction. */
-    applyRewrite?: (verified: VerifiedHistoryRewriteState) => Promise<void>;
-    /** Override when the operation must also dispatch item hooks or derived-index warnings. */
-    afterWrite?: () => Promise<string[]>;
-    /** Preserve the operation's public report shape after preview or application completes. */
-    report: (outcome: HistoryMaintenanceOutcome) => Result;
+/** Whether the transformation warrants persistence when not previewing. */
+changed: boolean;
+/** Final stream including any operation-specific baseline or audit marker. */
+rewrittenEntries: HistoryEntry[];
+/** Additional evidence check executed under the lock before any write. */
+beforeWrite?: () => Promise<void>;
+/** Override only when history and item bytes must share a rollback transaction. */
+applyRewrite?: (verified: VerifiedHistoryRewriteState) => Promise<void>;
+/** Override when the operation must also dispatch item hooks or derived-index warnings. */
+afterWrite?: () => Promise<string[]>;
+/** Preserve the operation's public report shape after preview or application completes. */
+report: (outcome: HistoryMaintenanceOutcome) => Result;
 }
 /** Resolved workspace and transform supplied by built-ins or SDK integrations. */
 export interface HistoryMaintenanceParams<Result> {
-    /** Initialized tracker root whose settings and subject were resolved by the caller. */
-    pmRoot: string;
-    /** Live item or retained deleted-item history selected for maintenance. */
-    subject: HistorySubject;
-    /** Workspace policy used consistently for the snapshot and locked write. */
-    settings: PmSettings;
-    /** Active item-folder mapping, including package-provided types. */
-    typeRegistry: ItemTypeRegistry;
-    /** Maintenance policy whose diagnostic and hook compatibility must be preserved. */
-    operation: HistoryMaintenanceOperation;
-    /** Preview and ownership controls. */
-    options: HistoryMaintenanceOptions;
-    /** Pure planning or evidence reads; persistence belongs in the returned transaction callbacks. */
-    transform: (snapshot: HistoryMaintenanceSnapshot) => HistoryMaintenancePlan<Result> | Promise<HistoryMaintenancePlan<Result>>;
+/** Initialized tracker root whose settings and subject were resolved by the caller. */
+pmRoot: string;
+/** Live item or retained deleted-item history selected for maintenance. */
+subject: HistorySubject;
+/** Workspace policy used consistently for the snapshot and locked write. */
+settings: PmSettings;
+/** Active item-folder mapping, including package-provided types. */
+typeRegistry: ItemTypeRegistry;
+/** Maintenance policy whose diagnostic and hook compatibility must be preserved. */
+operation: HistoryMaintenanceOperation;
+/** Preview and ownership controls. */
+options: HistoryMaintenanceOptions;
+/** Pure planning or evidence reads; persistence belongs in the returned transaction callbacks. */
+transform: (snapshot: HistoryMaintenanceSnapshot) => HistoryMaintenancePlan<Result> | Promise<HistoryMaintenancePlan<Result>>;
 }
 /** Verify every transform before writing and reject concurrent item or stream changes under the lock. */
 export declare function runHistoryMaintenance<Result>(params: HistoryMaintenanceParams<Result>): Promise<Result>;

package/dist/sdk/history/salvage.d.ts

@@ -5,31 +5,31 @@ import type { HistorySubject } from "../history-redact.js";
 import type { HistoryRepairCommandOptions, HistoryRepairResult } from "../history-repair.js";
 /** Evidence describing only the discarded suffix, without retaining its contents. */
 export interface HistorySalvageReceipt {
-    /** One-based physical line where invalid trailing bytes begin. */
-    first_invalid_line: number;
-    /** UTF-8 bytes removed from the suffix. */
-    discarded_bytes: number;
-    /** SHA-256 of the removed bytes for local backup comparison. */
-    discarded_sha256: string;
-    /** Number of complete verified records retained. */
-    retained_entries: number;
+/** One-based physical line where invalid trailing bytes begin. */
+first_invalid_line: number;
+/** UTF-8 bytes removed from the suffix. */
+discarded_bytes: number;
+/** SHA-256 of the removed bytes for local backup comparison. */
+discarded_sha256: string;
+/** Number of complete verified records retained. */
+retained_entries: number;
 }
 /**
  * Select a hash-verified prefix. Any parseable JSON after the first invalid
  * line makes the corruption interior and therefore unsalvageable by truncation.
  */
 export declare function inspectHistoryTail(raw: string): {
-    entries: HistoryEntry[];
-    prefix: string;
-    receipt: HistorySalvageReceipt | null;
-    itemHashVersion: HistoryItemHashVersion;
+entries: HistoryEntry[];
+prefix: string;
+receipt: HistorySalvageReceipt | null;
+itemHashVersion: HistoryItemHashVersion;
 };
 /** Salvage one explicitly selected stream under its normal ownership and lock policy. */
 export declare function salvageHistoryTail(params: {
-    pmRoot: string;
-    subject: HistorySubject;
-    settings: PmSettings;
-    typeRegistry: ItemTypeRegistry;
-    options: HistoryRepairCommandOptions;
-    author: string;
+pmRoot: string;
+subject: HistorySubject;
+settings: PmSettings;
+typeRegistry: ItemTypeRegistry;
+options: HistoryRepairCommandOptions;
+author: string;
 }): Promise<HistoryRepairResult>;

package/dist/sdk/history/subject.d.ts

@@ -2,18 +2,18 @@ import { locateItem } from "../../core/store/item-store.js";
 import type { PmSettings } from "../../types/index.js";
 /** Resolve initialized workspace policy once for single-stream and bulk maintenance. */
 export declare function resolveHistoryWorkspace(pmPath: string | undefined): Promise<{
-    pmRoot: string;
-    settings: PmSettings;
-    typeRegistry: import("../../core/item/type-registry.js").ItemTypeRegistry;
+pmRoot: string;
+settings: PmSettings;
+typeRegistry: import("../../core/item/type-registry.js").ItemTypeRegistry;
 }>;
 /** Canonical stream address, retaining item location only when the current item exists. */
 export interface HistorySubject {
-    /** Stable identifier used to reference this record across commands and storage. */
-    id: string;
-    /** Filesystem path used for history resolution. */
-    historyPath: string;
-    /** Current item location, or null when only a deleted item's history remains. */
-    located: Awaited<ReturnType<typeof locateItem>>;
+/** Stable identifier used to reference this record across commands and storage. */
+id: string;
+/** Filesystem path used for history resolution. */
+historyPath: string;
+/** Current item location, or null when only a deleted item's history remains. */
+located: Awaited<ReturnType<typeof locateItem>>;
 }
 /** Resolve a current item first, then retained streams under normalized and raw legacy IDs. */
 export declare function resolveHistorySubject(pmRoot: string, id: string, settings: PmSettings, typeToFolder: Record<string, string>): Promise<HistorySubject>;

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

@@ -9,103 +9,103 @@ import type { HistoryEntry, ItemMetadata } from "../types/index.js";
 import { type AgentProvenanceDescriptorCoverage, type AgentProvenanceDimensionCoverage } from "./provenance.js";
 /** Bounded immutable-history window controls shared by analytics surfaces. */
 export interface HistoryAnalyticsWindowOptions {
-    /** Inclusive ISO timestamp or negative day/hour duration such as -30d. */
-    since?: string;
-    /** Maximum indexed events consumed across all pages. */
-    eventLimit?: number;
-    /** Minimum denominator required before a rate is reported. */
-    minimumSample?: number;
+/** Inclusive ISO timestamp or negative day/hour duration such as -30d. */
+since?: string;
+/** Maximum indexed events consumed across all pages. */
+eventLimit?: number;
+/** Minimum denominator required before a rate is reported. */
+minimumSample?: number;
 }
 /** Read receipt proving how much immutable history contributed. */
 export interface HistoryAnalyticsWindowReceipt {
-    /** Inclusive lower bound used for the scan. */
-    since: string;
-    /** Number of indexed immutable events inspected. */
-    events: number;
-    /** Whether the configured event ceiling omitted matching rows. */
-    truncated: boolean;
-    /** Cursor that resumes after the last inspected event when truncated. */
-    next_cursor?: string;
-    /** Derived read source. */
-    source: "history_event_index";
+/** Inclusive lower bound used for the scan. */
+since: string;
+/** Number of indexed immutable events inspected. */
+events: number;
+/** Whether the configured event ceiling omitted matching rows. */
+truncated: boolean;
+/** Cursor that resumes after the last inspected event when truncated. */
+next_cursor?: string;
+/** Derived read source. */
+source: "history_event_index";
 }
 /** Live declared-versus-observed provenance report. */
 export interface ProvenanceCoverageAnalytics {
-    /** Descriptor coverage for every declared dimension. */
-    descriptors: AgentProvenanceDescriptorCoverage[];
-    /** Per-harness availability over the bounded event window. */
-    observations: AgentProvenanceDimensionCoverage[];
-    /** Declared dimensions with enough explicit samples but no observations. */
-    inert: Array<{
-        harness: string;
-        dimension: string;
-        explicit_samples: number;
-    }>;
-    /** Dimensions no configured harness declares. */
-    undeclared: string[];
-    /** Stable warning codes suitable for health/gate adapters. */
-    warnings: string[];
-    /** Bounded source receipt. */
-    window: HistoryAnalyticsWindowReceipt;
+/** Descriptor coverage for every declared dimension. */
+descriptors: AgentProvenanceDescriptorCoverage[];
+/** Per-harness availability over the bounded event window. */
+observations: AgentProvenanceDimensionCoverage[];
+/** Declared dimensions with enough explicit samples but no observations. */
+inert: Array<{
+harness: string;
+dimension: string;
+explicit_samples: number;
+}>;
+/** Dimensions no configured harness declares. */
+undeclared: string[];
+/** Stable warning codes suitable for health/gate adapters. */
+warnings: string[];
+/** Bounded source receipt. */
+window: HistoryAnalyticsWindowReceipt;
 }
 /** One bounded attribution bucket with honest denominator states. */
 export interface FleetAttributionRow {
-    /** Recorded grouping value. */
-    value: string;
-    /** Immutable events attributed to the bucket. */
-    events: number;
-    /** State-changing events attributed to the bucket. */
-    state_events: number;
-    /** Annotation/evidence events attributed to the bucket. */
-    annotation_events: number;
-    /** Terminal transitions attributed to the bucket. */
-    closes: number;
-    /** Active transitions after a terminal transition in the observed window. */
-    reopens: number;
-    /** Issue items linked discovered_from to work closed by this bucket. */
-    defect_escapes: number;
-    /** Terminal transitions per observed day, or null for insufficient samples. */
-    throughput_per_day: number | null;
-    /** Reopens divided by closes, or null for insufficient samples. */
-    rework_rate: number | null;
-    /** Defect escapes divided by closes, or null for insufficient samples. */
-    defect_escape_rate: number | null;
-    /** Denominator state preventing tiny samples from masquerading as rates. */
-    sample_status: "available" | "insufficient";
+/** Recorded grouping value. */
+value: string;
+/** Immutable events attributed to the bucket. */
+events: number;
+/** State-changing events attributed to the bucket. */
+state_events: number;
+/** Annotation/evidence events attributed to the bucket. */
+annotation_events: number;
+/** Terminal transitions attributed to the bucket. */
+closes: number;
+/** Active transitions after a terminal transition in the observed window. */
+reopens: number;
+/** Issue items linked discovered_from to work closed by this bucket. */
+defect_escapes: number;
+/** Terminal transitions per observed day, or null for insufficient samples. */
+throughput_per_day: number | null;
+/** Reopens divided by closes, or null for insufficient samples. */
+rework_rate: number | null;
+/** Defect escapes divided by closes, or null for insufficient samples. */
+defect_escape_rate: number | null;
+/** Denominator state preventing tiny samples from masquerading as rates. */
+sample_status: "available" | "insufficient";
 }
 /** One supported fleet grouping dimension. */
 export interface FleetAttributionDimension {
-    /** Stable dimension name. */
-    dimension: "harness" | "model" | "author_source";
-    /** Whether at least one event supplied this dimension. */
-    status: "available" | "unavailable";
-    /** Deterministically sorted bounded aggregate rows. */
-    rows: FleetAttributionRow[];
+/** Stable dimension name. */
+dimension: "harness" | "model" | "author_source";
+/** Whether at least one event supplied this dimension. */
+status: "available" | "unavailable";
+/** Deterministically sorted bounded aggregate rows. */
+rows: FleetAttributionRow[];
 }
 /** Observational fleet analytics derived only from immutable history. */
 export interface FleetAttributionAnalytics {
-    /** Grouped analytics for every supported provenance dimension. */
-    dimensions: FleetAttributionDimension[];
-    /** Minimum close denominator required for rates. */
-    minimum_sample: number;
-    /** Safety statement retained in every transport. */
-    policy: "observational_only_not_for_authorization_or_routing";
-    /** Bounded source receipt. */
-    window: HistoryAnalyticsWindowReceipt;
+/** Grouped analytics for every supported provenance dimension. */
+dimensions: FleetAttributionDimension[];
+/** Minimum close denominator required for rates. */
+minimum_sample: number;
+/** Safety statement retained in every transport. */
+policy: "observational_only_not_for_authorization_or_routing";
+/** Bounded source receipt. */
+window: HistoryAnalyticsWindowReceipt;
 }
 /** One immutable history entry paired with its owning tracked item. */
 export interface HistoryAnalyticsEvent {
-    /** Tracked item owning the immutable event. */
-    item_id: string;
-    /** Immutable history entry consumed by analytics. */
-    entry: HistoryEntry;
+/** Tracked item owning the immutable event. */
+item_id: string;
+/** Immutable history entry consumed by analytics. */
+entry: HistoryEntry;
 }
 /** Reusable bounded history read shared across multiple analytics projections. */
 export interface HistoryAnalyticsWindow {
-    /** Immutable events retained by the configured bound. */
-    events: HistoryAnalyticsEvent[];
-    /** Receipt describing the bounded source read. */
-    receipt: HistoryAnalyticsWindowReceipt;
+/** Immutable events retained by the configured bound. */
+events: HistoryAnalyticsEvent[];
+/** Receipt describing the bounded source read. */
+receipt: HistoryAnalyticsWindowReceipt;
 }
 declare function parseHistoryAnalyticsLimit(value: number | undefined): number;
 declare function parseMinimumSample(value: number | undefined): number;
@@ -129,13 +129,13 @@ export declare function runFleetAttributionAnalytics(pmRoot: string, items: read
 export declare function projectFleetAttributionAnalytics(window: HistoryAnalyticsWindow, items: readonly Pick<ItemMetadata, "id" | "type" | "dependencies">[], terminalStatuses: ReadonlySet<string>, options?: Pick<HistoryAnalyticsWindowOptions, "minimumSample">): FleetAttributionAnalytics;
 /** Pure seams for deterministic analytics and negative-control tests. */
 export declare const _testOnlyHistoryAnalytics: {
-    annotationOperation: typeof annotationOperation;
-    buildFleetDimension: typeof buildFleetDimension;
-    parseHistoryAnalyticsLimit: typeof parseHistoryAnalyticsLimit;
-    parseMinimumSample: typeof parseMinimumSample;
-    provenanceValue: typeof provenanceValue;
-    resolveHistoryAnalyticsSince: typeof resolveHistoryAnalyticsSince;
-    resolveHistoryWindowDays: typeof resolveHistoryWindowDays;
-    statusFromEntry: typeof statusFromEntry;
+annotationOperation: typeof annotationOperation;
+buildFleetDimension: typeof buildFleetDimension;
+parseHistoryAnalyticsLimit: typeof parseHistoryAnalyticsLimit;
+parseMinimumSample: typeof parseMinimumSample;
+provenanceValue: typeof provenanceValue;
+resolveHistoryAnalyticsSince: typeof resolveHistoryAnalyticsSince;
+resolveHistoryWindowDays: typeof resolveHistoryWindowDays;
+statusFromEntry: typeof statusFromEntry;
 };
 export {};

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

@@ -3,54 +3,54 @@ import { type BulkIdsValue } from "../core/io/bulk-ids-input.js";
 import type { GlobalOptions } from "../core/shared/command-types.js";
 /** Documents the history compact command options payload exchanged by command, SDK, and package integrations. */
 export interface HistoryCompactCommandOptions {
-    /** Value that configures or reports before for this contract. */
-    before?: 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 before for this contract. */
+before?: 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;
 }
 type HistoryCompactBoundaryKind = "default" | "version" | "timestamp";
 /** Documents the history compact result payload exchanged by command, SDK, and package integrations. */
 export interface HistoryCompactResult {
-    /** 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 compact boundary for this contract. */
-    compact_boundary: {
-        kind: HistoryCompactBoundaryKind;
-        before: string | null;
-        entries_compacted: number;
-        entries_retained: number;
-        first_retained_entry: number | null;
-    };
-    /** Value that configures or reports history for this contract. */
-    history: {
-        path: string;
-        entries_scanned: number;
-        entries_after: number;
-        baseline_entry_added: boolean;
-        audit_entry_added: boolean;
-        verify_ok: boolean;
-        verify_errors: string[];
-    };
-    /** Value that configures or reports item for this contract. */
-    item: {
-        exists: boolean;
-        path: string | null;
-        matched_chain_before: boolean | null;
-    };
-    /** 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 compact boundary for this contract. */
+compact_boundary: {
+kind: HistoryCompactBoundaryKind;
+before: string | null;
+entries_compacted: number;
+entries_retained: number;
+first_retained_entry: number | null;
+};
+/** Value that configures or reports history for this contract. */
+history: {
+path: string;
+entries_scanned: number;
+entries_after: number;
+baseline_entry_added: boolean;
+audit_entry_added: boolean;
+verify_ok: boolean;
+verify_errors: string[];
+};
+/** Value that configures or reports item for this contract. */
+item: {
+exists: boolean;
+path: string | null;
+matched_chain_before: boolean | null;
+};
+/** Value that configures or reports warnings for this contract. */
+warnings: string[];
+/** ISO 8601 timestamp recording when generated occurred. */
+generated_at: string;
 }
 /** Implements run history compact for the public runtime surface of this module. */
 export declare function runHistoryCompact(id: string, options: HistoryCompactCommandOptions, global: GlobalOptions): Promise<HistoryCompactResult>;
@@ -58,74 +58,74 @@ export declare function runHistoryCompact(id: string, options: HistoryCompactCom
 export declare const HISTORY_COMPACT_BULK_DEFAULT_MIN_ENTRIES = 3;
 /** Documents the bulk history compact command options payload exchanged by command, SDK, and package integrations. */
 export interface HistoryCompactBulkCommandOptions {
-    /** Value that configures or reports ids for this contract. */
-    ids?: BulkIdsValue;
-    /** Value that configures or reports scope for this contract. */
-    scope?: HistoryCompactScope;
-    /** Value that configures or reports all over for this contract. */
-    allOver?: number;
-    /** Value that configures or reports min entries for this contract. */
-    minEntries?: number;
-    /** 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 ids for this contract. */
+ids?: BulkIdsValue;
+/** Value that configures or reports scope for this contract. */
+scope?: HistoryCompactScope;
+/** Value that configures or reports all over for this contract. */
+allOver?: number;
+/** Value that configures or reports min entries for this contract. */
+minEntries?: number;
+/** 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;
 }
 /** Per-item outcome row in a bulk compaction pass. */
 export interface HistoryCompactBulkItemResult {
-    /** Stable identifier used to reference this record across commands and storage. */
-    id: string;
-    /** Value that configures or reports outcome for this contract. */
-    outcome: "compacted" | "skipped" | "errored";
-    /** Value that configures or reports entries before for this contract. */
-    entries_before: number;
-    /** Value that configures or reports entries after for this contract. */
-    entries_after: number | null;
-    /** Value that configures or reports skip reason for this contract. */
-    skip_reason: HistoryCompactBulkSkipReason | null;
-    /** Value that configures or reports changed for this contract. */
-    changed: boolean;
-    /** Value that configures or reports error for this contract. */
-    error: string | null;
+/** Stable identifier used to reference this record across commands and storage. */
+id: string;
+/** Value that configures or reports outcome for this contract. */
+outcome: "compacted" | "skipped" | "errored";
+/** Value that configures or reports entries before for this contract. */
+entries_before: number;
+/** Value that configures or reports entries after for this contract. */
+entries_after: number | null;
+/** Value that configures or reports skip reason for this contract. */
+skip_reason: HistoryCompactBulkSkipReason | null;
+/** Value that configures or reports changed for this contract. */
+changed: boolean;
+/** Value that configures or reports error for this contract. */
+error: string | null;
 }
 /** Documents the bulk history compact result payload exchanged by command, SDK, and package integrations. */
 export interface HistoryCompactBulkResult {
-    /** Value that configures or reports bulk for this contract. */
-    bulk: true;
-    /** Value that configures or reports dry run for this contract. */
-    dry_run: boolean;
-    /** Value that configures or reports mode for this contract. */
-    mode: "ids" | "scan";
-    /** Value that configures or reports scope for this contract. */
-    scope: HistoryCompactScope | null;
-    /** Value that configures or reports criteria for this contract. */
-    criteria: {
-        min_entries: number;
-        all_over: number | null;
-        policy_threshold_applied: boolean;
-    };
-    /** Value that configures or reports totals for this contract. */
-    totals: {
-        streams_considered: number;
-        selected: number;
-        items_compacted: number;
-        items_skipped: number;
-        items_errored: number;
-    };
-    /** Value that configures or reports results for this contract. */
-    results: HistoryCompactBulkItemResult[];
-    /** ISO 8601 timestamp recording when generated occurred. */
-    generated_at: string;
+/** Value that configures or reports bulk for this contract. */
+bulk: true;
+/** Value that configures or reports dry run for this contract. */
+dry_run: boolean;
+/** Value that configures or reports mode for this contract. */
+mode: "ids" | "scan";
+/** Value that configures or reports scope for this contract. */
+scope: HistoryCompactScope | null;
+/** Value that configures or reports criteria for this contract. */
+criteria: {
+min_entries: number;
+all_over: number | null;
+policy_threshold_applied: boolean;
+};
+/** Value that configures or reports totals for this contract. */
+totals: {
+streams_considered: number;
+selected: number;
+items_compacted: number;
+items_skipped: number;
+items_errored: number;
+};
+/** Value that configures or reports results for this contract. */
+results: HistoryCompactBulkItemResult[];
+/** ISO 8601 timestamp recording when generated occurred. */
+generated_at: string;
 }
 /** Enforce the `pm history-compact` target contract shared by the CLI and MCP surfaces: exactly one selection mode — a single item `<id>`, an explicit `--ids` list, or a scan selector (`--all-over` / `--closed` / `--all-streams`). */
 export declare function assertHistoryCompactTarget(id: string | undefined, bulk: {
-    ids?: string[];
-    allOver?: number;
-    scope?: HistoryCompactScope;
+ids?: string[];
+allOver?: number;
+scope?: HistoryCompactScope;
 }): void;
 /**
  * Bulk history compaction: compact every history stream matching the requested