@unbrained/pm-cli 2026.10.11 → 2026.10.13

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

@@ -1,70 +1,70 @@
 /** One original attempt in a caller-defined recurrence family. */
 export interface ReliabilityAttempt {
-    /** Unique occurrence identity; retries retain the original occurrence separately. */
-    id: string;
-    /** Stable family identity independent of the occurrence's lifecycle. */
-    family: string;
-    /** Recorded start instant, used for half-open window membership. */
-    started_at: string;
-    /** Original outcome; a successful retry must not replace a failure. */
-    outcome: "success" | "failure" | "pending";
-    /** Observed repair instant, when supported by independent evidence. */
-    repaired_at?: string;
-    /** Failure-only cause; omit on success/pending and leave unknown without classification. */
-    cause?: "product" | "infrastructure" | "unknown";
+/** Unique occurrence identity; retries retain the original occurrence separately. */
+id: string;
+/** Stable family identity independent of the occurrence's lifecycle. */
+family: string;
+/** Recorded start instant, used for half-open window membership. */
+started_at: string;
+/** Original outcome; a successful retry must not replace a failure. */
+outcome: "success" | "failure" | "pending";
+/** Observed repair instant, when supported by independent evidence. */
+repaired_at?: string;
+/** Failure-only cause; omit on success/pending and leave unknown without classification. */
+cause?: "product" | "infrastructure" | "unknown";
 }
 /** Explicit population and thresholds for a reproducible reliability query. */
 export interface ReliabilityWindowPolicy {
-    /** Inclusive UTC window boundary. */
-    window_start: string;
-    /** Exclusive UTC window boundary and repair-observation cutoff. */
-    window_end: string;
-    /** Expected families, including families with no observed attempts. */
-    families: readonly string[];
-    /** Maximum permitted original-attempt failure fraction in [0, 1). */
-    max_failure_rate: number;
-    /** Minimum completed attempts required to establish coverage. */
-    min_completed_attempts: number;
+/** Inclusive UTC window boundary. */
+window_start: string;
+/** Exclusive UTC window boundary and repair-observation cutoff. */
+window_end: string;
+/** Expected families, including families with no observed attempts. */
+families: readonly string[];
+/** Maximum permitted original-attempt failure fraction in [0, 1). */
+max_failure_rate: number;
+/** Minimum completed attempts required to establish coverage. */
+min_completed_attempts: number;
 }
 /** Bounded aggregate evidence for one recurrence family. */
 export interface ReliabilityFamilyReport {
-    /** Stable identity from the declared population. */
-    family: string;
-    /** All original attempts in the selected window. */
-    attempts: number;
-    /** Attempts with a terminal original outcome. */
-    completed: number;
-    /** Originally failed attempts, including repaired occurrences. */
-    failed: number;
-    /** Attempts whose original outcome remains pending. */
-    pending: number;
-    /** Null denotes absent completed evidence, distinct from zero failures. */
-    failure_rate: number | null;
-    /** UTC dates carrying at least one original failure. */
-    affected_days: string[];
-    /** Sorted observed repair durations in minutes; missing repairs are excluded. */
-    repair_minutes: number[];
-    /** Failures without a repair observed before the query cutoff. */
-    unresolved: number;
-    /** Cause counts retain unclassified failures instead of guessing attribution. */
-    causes: Record<"product" | "infrastructure" | "unknown", number>;
-    /** Coverage or rate findings that enforce the declared policy. */
-    violations: Array<"insufficient_completed_attempts" | "failure_rate">;
-    /** True only when both coverage and the rate satisfy policy. */
-    ok: boolean;
+/** Stable identity from the declared population. */
+family: string;
+/** All original attempts in the selected window. */
+attempts: number;
+/** Attempts with a terminal original outcome. */
+completed: number;
+/** Originally failed attempts, including repaired occurrences. */
+failed: number;
+/** Attempts whose original outcome remains pending. */
+pending: number;
+/** Null denotes absent completed evidence, distinct from zero failures. */
+failure_rate: number | null;
+/** UTC dates carrying at least one original failure. */
+affected_days: string[];
+/** Sorted observed repair durations in minutes; missing repairs are excluded. */
+repair_minutes: number[];
+/** Failures without a repair observed before the query cutoff. */
+unresolved: number;
+/** Cause counts retain unclassified failures instead of guessing attribution. */
+causes: Record<"product" | "infrastructure" | "unknown", number>;
+/** Coverage or rate findings that enforce the declared policy. */
+violations: Array<"insufficient_completed_attempts" | "failure_rate">;
+/** True only when both coverage and the rate satisfy policy. */
+ok: boolean;
 }
 /** Reproducible aggregate verdict suitable for a package, gate, or recorded measurement. */
 export interface ReliabilityWindowReport {
-    /** Versioned result schema for persisted evidence. */
-    schema: "pm-reliability-window/1";
-    /** Normalized inclusive query boundary. */
-    window_start: string;
-    /** Normalized exclusive query boundary. */
-    window_end: string;
-    /** True only when every expected family satisfies policy. */
-    ok: boolean;
-    /** Reports preserve the caller's declared family order. */
-    families: ReliabilityFamilyReport[];
+/** Versioned result schema for persisted evidence. */
+schema: "pm-reliability-window/1";
+/** Normalized inclusive query boundary. */
+window_start: string;
+/** Normalized exclusive query boundary. */
+window_end: string;
+/** True only when every expected family satisfies policy. */
+ok: boolean;
+/** Reports preserve the caller's declared family order. */
+families: ReliabilityFamilyReport[];
 }
 /**
  * Evaluate original attempts in [start, end), keeping repair and cause evidence separate.

package/dist/sdk/governance/stale-work.d.ts

@@ -1,34 +1,34 @@
 import type { ItemMetadata } from "../../types/index.js";
 /** One unclaimed in-progress item whose recorded activity exceeded policy. */
 export interface StaleInProgressItem {
-    /** Stable item identifier. */
-    id: string;
-    /** Most recent valid item or history timestamp. */
-    last_activity_at: string;
-    /** Whole hours elapsed at scan time. */
-    age_hours: number;
+/** Stable item identifier. */
+id: string;
+/** Most recent valid item or history timestamp. */
+last_activity_at: string;
+/** Whole hours elapsed at scan time. */
+age_hours: number;
 }
 /** Read-only stale-work diagnostic returned to SDK and health consumers. */
 export interface StaleInProgressScan {
-    /** Policy threshold applied by the scan. */
-    threshold_hours: number;
-    /** Number of stale items. */
-    count: number;
-    /** Deterministically ordered stale items. */
-    items: StaleInProgressItem[];
-    /** Agent-facing recovery guidance. */
-    remediation: string;
+/** Policy threshold applied by the scan. */
+threshold_hours: number;
+/** Number of stale items. */
+count: number;
+/** Deterministically ordered stale items. */
+items: StaleInProgressItem[];
+/** Agent-facing recovery guidance. */
+remediation: string;
 }
 /** Inputs for the pure stale-work classifier. */
 export interface InspectStaleInProgressOptions {
-    /** Status id configured as the active lifecycle state. */
-    in_progress_status?: string;
-    /** Age threshold in hours. */
-    threshold_hours: number;
-    /** Scan timestamp, injectable for deterministic tests. */
-    now?: Date;
-    /** Optional latest-history timestamp lookup. */
-    last_history_activity?: (item: ItemMetadata) => string | undefined;
+/** Status id configured as the active lifecycle state. */
+in_progress_status?: string;
+/** Age threshold in hours. */
+threshold_hours: number;
+/** Scan timestamp, injectable for deterministic tests. */
+now?: Date;
+/** Optional latest-history timestamp lookup. */
+last_history_activity?: (item: ItemMetadata) => string | undefined;
 }
 /** Classify stale unclaimed in-progress items without filesystem access. */
 export declare function inspectStaleInProgressItems(items: readonly ItemMetadata[], options: InspectStaleInProgressOptions): StaleInProgressScan;

package/dist/sdk/governance/status-role-diagnostics.d.ts

@@ -8,18 +8,18 @@ import type { ItemMetadata } from "../../types/index.js";
 import { type RuntimeStatusRegistry } from "../../core/schema/runtime-schema.js";
 /** Bounded evidence describing roleless status definitions and affected items. */
 export interface StatusRoleDiagnostics {
-    /** Total number of registered status ids that have no lifecycle role. */
-    roleless_status_count: number;
-    /** Registered status ids that have no lifecycle role. */
-    roleless_statuses: string[];
-    /** Whether roleless status ids were omitted from the bounded sample. */
-    roleless_statuses_truncated: boolean;
-    /** Number of items whose status resolves to a roleless definition. */
-    affected_item_count: number;
-    /** Bounded, deterministic sample of affected item ids. */
-    affected_item_ids: string[];
-    /** Whether affected item ids were omitted from the bounded sample. */
-    affected_item_ids_truncated: boolean;
+/** Total number of registered status ids that have no lifecycle role. */
+roleless_status_count: number;
+/** Registered status ids that have no lifecycle role. */
+roleless_statuses: string[];
+/** Whether roleless status ids were omitted from the bounded sample. */
+roleless_statuses_truncated: boolean;
+/** Number of items whose status resolves to a roleless definition. */
+affected_item_count: number;
+/** Bounded, deterministic sample of affected item ids. */
+affected_item_ids: string[];
+/** Whether affected item ids were omitted from the bounded sample. */
+affected_item_ids_truncated: boolean;
 }
 /** Inspect role registration and affected items without mutating the tracker. */
 export declare function inspectStatusRoleAssignments(statusRegistry: RuntimeStatusRegistry, items: readonly ItemMetadata[], itemLimit?: number): StatusRoleDiagnostics;

package/dist/sdk/governance/storage-integrity.d.ts

@@ -1,78 +1,78 @@
 import { type ItemDocumentFormatOptions } from "../../core/item/item-format.js";
 /** Documents one unreadable item-file finding surfaced by the storage-integrity check. */
 export interface UnreadableItemFileRow {
-    /** Tracker-relative path of the item file that failed to parse. */
-    path: string;
-    /** Item id derived from the file name. */
-    id: string;
+/** Tracker-relative path of the item file that failed to parse. */
+path: string;
+/** Item id derived from the file name. */
+id: string;
 }
 /** Documents one history-stream finding surfaced by the storage-integrity check. */
 export interface HistoryStreamIntegrityRow {
-    /** Item id whose history stream is affected. */
-    id: string;
-    /** Tracker-relative path of the history stream. */
-    path: string;
-    /** Line number of the first offending content, when line-addressable. */
-    line?: number;
-    /** Failure detail (conflict marker text or parse failure reason). */
-    detail: string;
+/** Item id whose history stream is affected. */
+id: string;
+/** Tracker-relative path of the history stream. */
+path: string;
+/** Line number of the first offending content, when line-addressable. */
+line?: number;
+/** Failure detail (conflict marker text or parse failure reason). */
+detail: string;
 }
 /** Documents one resurrection-candidate finding: a live item whose history says it was deleted. */
 export interface ResurrectedItemRow {
-    /** Live item id whose newest history operation is a delete. */
-    id: string;
-    /** Timestamp of the recorded delete operation. */
-    deleted_at: string;
-    /** Author of the recorded delete operation. */
-    deleted_by: string;
+/** Live item id whose newest history operation is a delete. */
+id: string;
+/** Timestamp of the recorded delete operation. */
+deleted_at: string;
+/** Author of the recorded delete operation. */
+deleted_by: string;
 }
 /** Documents one duplicate-item-id finding: one id claimed by multiple item documents (cross-branch add/add collision or duplicated format variant). */
 export interface DuplicateItemIdRow {
-    /** Item id claimed by more than one on-disk document. */
-    id: string;
-    /** Tracker-relative paths of every document claiming the id, sorted for determinism. */
-    paths: string[];
+/** Item id claimed by more than one on-disk document. */
+id: string;
+/** Tracker-relative paths of every document claiming the id, sorted for determinism. */
+paths: string[];
 }
 /** Documents one unparseable configuration/schema file finding. */
 export interface UnparseableConfigRow {
-    /** Tracker-relative path of the configuration file. */
-    path: string;
-    /** Failure detail (conflict marker location or JSON parse failure). */
-    detail: string;
+/** Tracker-relative path of the configuration file. */
+path: string;
+/** Failure detail (conflict marker location or JSON parse failure). */
+detail: string;
 }
 /** Documents the storage-integrity scan result consumed by the validate check builder. */
 export interface StorageIntegrityScanResult {
-    /** Number of item files present on disk across all type folders. */
-    item_files_on_disk: number;
-    /** Number of distinct item ids present on disk. */
-    item_ids_on_disk: number;
-    /** Number of items the standard read path successfully parsed. */
-    parsed_items: number;
-    /** Item files whose ids the standard read path could not parse (silently skipped elsewhere). */
-    unreadable_item_files: UnreadableItemFileRow[];
-    /** Ids claimed by more than one item document (post-merge add/add id collisions across type folders or format variants; GH-600). */
-    duplicate_item_ids: DuplicateItemIdRow[];
-    /** Number of history streams scanned. */
-    history_streams_scanned: number;
-    /** History streams containing unresolved merge-conflict markers. */
-    history_conflict_marker_streams: HistoryStreamIntegrityRow[];
-    /** History streams that cannot be read or contain an entry that is not a JSON object. */
-    history_unparseable_streams: HistoryStreamIntegrityRow[];
-    /** Live items whose newest history operation is a delete (delete/modify merge resurrection candidates). */
-    resurrected_items: ResurrectedItemRow[];
-    /** Streams whose final entry is a non-empty history_repair reconciliation patch — the post-repair divergence signal (informational, not a failure). */
-    history_repair_reconciliations: number;
-    /** Number of configuration/schema files scanned. */
-    config_files_scanned: number;
-    /** Configuration/schema files that cannot be parsed (silent-defaults fallback risk). */
-    unparseable_config_files: UnparseableConfigRow[];
+/** Number of item files present on disk across all type folders. */
+item_files_on_disk: number;
+/** Number of distinct item ids present on disk. */
+item_ids_on_disk: number;
+/** Number of items the standard read path successfully parsed. */
+parsed_items: number;
+/** Item files whose ids the standard read path could not parse (silently skipped elsewhere). */
+unreadable_item_files: UnreadableItemFileRow[];
+/** Ids claimed by more than one item document (post-merge add/add id collisions across type folders or format variants; GH-600). */
+duplicate_item_ids: DuplicateItemIdRow[];
+/** Number of history streams scanned. */
+history_streams_scanned: number;
+/** History streams containing unresolved merge-conflict markers. */
+history_conflict_marker_streams: HistoryStreamIntegrityRow[];
+/** History streams that cannot be read or contain an entry that is not a JSON object. */
+history_unparseable_streams: HistoryStreamIntegrityRow[];
+/** Live items whose newest history operation is a delete (delete/modify merge resurrection candidates). */
+resurrected_items: ResurrectedItemRow[];
+/** Streams whose final entry is a non-empty history_repair reconciliation patch — the post-repair divergence signal (informational, not a failure). */
+history_repair_reconciliations: number;
+/** Number of configuration/schema files scanned. */
+config_files_scanned: number;
+/** Configuration/schema files that cannot be parsed (silent-defaults fallback risk). */
+unparseable_config_files: UnparseableConfigRow[];
 }
 /** Runtime schema context used to parse every physical item file exactly as the ordinary read path does. */
 export interface StorageIntegrityItemParseOptions {
-    /** Active runtime schema, including unknown-field policy and custom field definitions. */
-    schema?: ItemDocumentFormatOptions["schema"];
-    /** Item fields contributed by active extensions and therefore valid under a rejecting schema. */
-    extensionFieldNames?: readonly string[];
+/** Active runtime schema, including unknown-field policy and custom field definitions. */
+schema?: ItemDocumentFormatOptions["schema"];
+/** Item fields contributed by active extensions and therefore valid under a rejecting schema. */
+extensionFieldNames?: readonly string[];
 }
 /**
  * Scan tracker storage for integrity failures the ordinary read path masks.

package/dist/sdk/governance/tracked-runtime-cache.d.ts

@@ -1,16 +1,16 @@
 import { realpath } from "node:fs/promises";
 /** Read-only result describing clone-local tracker artifacts present in Git's index. */
 export interface TrackedRuntimeCacheScan {
-    /** Enclosing Git worktree root, omitted from serialized diagnostics. */
-    git_workspace_root: string | null;
-    /** Tracker root relative to the Git worktree, or null when it is outside Git. */
-    tracker_relative_root: string | null;
-    /** Tracked runtime artifact paths relative to the Git worktree. */
-    tracked_paths: string[];
-    /** Number of tracked runtime artifacts. */
-    tracked_path_count: number;
-    /** Exact index-only remediation command, or null when no artifacts are tracked. */
-    remediation_command: string | null;
+/** Enclosing Git worktree root, omitted from serialized diagnostics. */
+git_workspace_root: string | null;
+/** Tracker root relative to the Git worktree, or null when it is outside Git. */
+tracker_relative_root: string | null;
+/** Tracked runtime artifact paths relative to the Git worktree. */
+tracked_paths: string[];
+/** Number of tracked runtime artifacts. */
+tracked_path_count: number;
+/** Exact index-only remediation command, or null when no artifacts are tracked. */
+remediation_command: string | null;
 }
 /** Resolves a tracker root while retaining a deterministic fallback for missing paths. */
 export declare function resolveCanonicalTrackerRoot(pmRoot: string, resolver?: typeof realpath): Promise<string>;

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

@@ -2,133 +2,133 @@ import { type ExtensionScope, type ManagedExtensionRecord, type ManagedExtension
 import { type GlobalOptions } from "../runtime-primitives.js";
 /** Documents the upgrade command options payload exchanged by command, SDK, and package integrations. */
 export interface UpgradeCommandOptions {
-    /** Managed package scope selected by structured SDK and MCP clients. */
-    scope?: ExtensionScope;
-    /** Value that configures or reports dry run for this contract. */
-    dryRun?: boolean;
-    /** Value that configures or reports cli only for this contract. */
-    cliOnly?: boolean;
-    /** Value that configures or reports packages only for this contract. */
-    packagesOnly?: boolean;
-    /** Value that configures or reports project for this contract. */
-    project?: boolean;
-    /** Value that configures or reports local for this contract. */
-    local?: boolean;
-    /** Value that configures or reports global for this contract. */
-    global?: boolean;
-    /** Value that configures or reports repair for this contract. */
-    repair?: boolean;
-    /** Value that configures or reports tag for this contract. */
-    tag?: string;
-    /** Value that configures or reports package name for this contract. */
-    packageName?: string;
-    /** Value that configures or reports command runner for this contract. */
-    commandRunner?: UpgradeCommandRunner;
+/** Managed package scope selected by structured SDK and MCP clients. */
+scope?: ExtensionScope;
+/** Value that configures or reports dry run for this contract. */
+dryRun?: boolean;
+/** Value that configures or reports cli only for this contract. */
+cliOnly?: boolean;
+/** Value that configures or reports packages only for this contract. */
+packagesOnly?: boolean;
+/** Value that configures or reports project for this contract. */
+project?: boolean;
+/** Value that configures or reports local for this contract. */
+local?: boolean;
+/** Value that configures or reports global for this contract. */
+global?: boolean;
+/** Value that configures or reports repair for this contract. */
+repair?: boolean;
+/** Value that configures or reports tag for this contract. */
+tag?: string;
+/** Value that configures or reports package name for this contract. */
+packageName?: string;
+/** Value that configures or reports command runner for this contract. */
+commandRunner?: UpgradeCommandRunner;
 }
 /** Public contract for test only, shared by SDK and presentation-layer consumers. */
 export declare const _testOnly: {
-    defaultCommandRunner: typeof defaultCommandRunner;
-    isLocalNpmSpec: typeof isLocalNpmSpec;
-    normalizeTarget: typeof normalizeTarget;
-    packageRecordMatchesTarget: typeof packageRecordMatchesTarget;
-    resolveCliPackage: typeof resolveCliPackage;
-    resolvePackageInstallSource: typeof resolvePackageInstallSource;
-    resolveRunnablePackageSource: typeof resolveRunnablePackageSource;
-    resolveScope: typeof resolveScope;
-    resolveTag: typeof resolveTag;
-    packageCommandFor: typeof packageCommandFor;
-    summarize: typeof summarize;
+defaultCommandRunner: typeof defaultCommandRunner;
+isLocalNpmSpec: typeof isLocalNpmSpec;
+normalizeTarget: typeof normalizeTarget;
+packageRecordMatchesTarget: typeof packageRecordMatchesTarget;
+resolveCliPackage: typeof resolveCliPackage;
+resolvePackageInstallSource: typeof resolvePackageInstallSource;
+resolveRunnablePackageSource: typeof resolveRunnablePackageSource;
+resolveScope: typeof resolveScope;
+resolveTag: typeof resolveTag;
+packageCommandFor: typeof packageCommandFor;
+summarize: typeof summarize;
 };
 /** Documents the upgrade command runner result payload exchanged by command, SDK, and package integrations. */
 export interface UpgradeCommandRunnerResult {
-    /** Value that configures or reports stdout for this contract. */
-    stdout: string;
-    /** Value that configures or reports stderr for this contract. */
-    stderr: string;
+/** Value that configures or reports stdout for this contract. */
+stdout: string;
+/** Value that configures or reports stderr for this contract. */
+stderr: string;
 }
 /** Restricts upgrade command runner values accepted by command, SDK, and storage contracts. */
 export type UpgradeCommandRunner = (command: string, args: string[], options?: {
-    cwd?: string;
+cwd?: string;
 }) => Promise<UpgradeCommandRunnerResult>;
 /** Documents the upgrade cli result payload exchanged by command, SDK, and package integrations. */
 export interface UpgradeCliResult {
-    /** Value that configures or reports requested for this contract. */
-    requested: boolean;
-    /** Lifecycle state reported for status. */
-    status: "planned" | "updated" | "failed" | "skipped";
-    /** Value that configures or reports package for this contract. */
-    package: string;
-    /** Value that configures or reports target for this contract. */
-    target: string;
-    /** Value that configures or reports command for this contract. */
-    command: string[];
-    /** Package-owned command migrations relevant to this CLI upgrade plan or outcome. */
-    migration_guidance?: string[];
-    /** Value that configures or reports before version for this contract. */
-    before_version?: string;
-    /** Value that configures or reports after version for this contract. */
-    after_version?: string;
-    /** Value that configures or reports repair for this contract. */
-    repair: boolean;
-    /** Value that configures or reports reason for this contract. */
-    reason?: string;
-    /** Value that configures or reports error for this contract. */
-    error?: string;
+/** Value that configures or reports requested for this contract. */
+requested: boolean;
+/** Lifecycle state reported for status. */
+status: "planned" | "updated" | "failed" | "skipped";
+/** Value that configures or reports package for this contract. */
+package: string;
+/** Value that configures or reports target for this contract. */
+target: string;
+/** Value that configures or reports command for this contract. */
+command: string[];
+/** Package-owned command migrations relevant to this CLI upgrade plan or outcome. */
+migration_guidance?: string[];
+/** Value that configures or reports before version for this contract. */
+before_version?: string;
+/** Value that configures or reports after version for this contract. */
+after_version?: string;
+/** Value that configures or reports repair for this contract. */
+repair: boolean;
+/** Value that configures or reports reason for this contract. */
+reason?: string;
+/** Value that configures or reports error for this contract. */
+error?: string;
 }
 /** Documents the upgrade package result payload exchanged by command, SDK, and package integrations. */
 export interface UpgradePackageResult {
-    /** Value that configures or reports name for this contract. */
-    name: string;
-    /** Value that configures or reports directory for this contract. */
-    directory: string;
-    /** Value that configures or reports scope for this contract. */
-    scope: ExtensionScope;
-    /** Value that configures or reports source for this contract. */
-    source: ManagedExtensionSource;
-    /** Lifecycle state reported for status. */
-    status: "planned" | "updated" | "failed" | "skipped";
-    /** Value that configures or reports command for this contract. */
-    command: string[];
-    /** Value that configures or reports previous version for this contract. */
-    previous_version: string;
-    /** Value that configures or reports installed version for this contract. */
-    installed_version?: string;
-    /** Value that configures or reports reason for this contract. */
-    reason?: string;
-    /** Value that configures or reports error for this contract. */
-    error?: string;
+/** Value that configures or reports name for this contract. */
+name: string;
+/** Value that configures or reports directory for this contract. */
+directory: string;
+/** Value that configures or reports scope for this contract. */
+scope: ExtensionScope;
+/** Value that configures or reports source for this contract. */
+source: ManagedExtensionSource;
+/** Lifecycle state reported for status. */
+status: "planned" | "updated" | "failed" | "skipped";
+/** Value that configures or reports command for this contract. */
+command: string[];
+/** Value that configures or reports previous version for this contract. */
+previous_version: string;
+/** Value that configures or reports installed version for this contract. */
+installed_version?: string;
+/** Value that configures or reports reason for this contract. */
+reason?: string;
+/** Value that configures or reports error for this contract. */
+error?: string;
 }
 /** Documents the upgrade result payload exchanged by command, SDK, and package integrations. */
 export interface UpgradeResult {
-    /** Whether the operation completed without a blocking failure. */
-    ok: boolean;
-    /** Value that configures or reports action for this contract. */
-    action: "upgrade";
-    /** Value that configures or reports dry run for this contract. */
-    dry_run: boolean;
-    /** Value that configures or reports scope for this contract. */
-    scope: ExtensionScope;
-    /** Value that configures or reports target for this contract. */
-    target?: string;
-    /** Value that configures or reports cli for this contract. */
-    cli: UpgradeCliResult;
-    /** Value that configures or reports packages for this contract. */
-    packages: UpgradePackageResult[];
-    /** Value that configures or reports summary for this contract. */
-    summary: {
-        requested_cli: boolean;
-        requested_packages: boolean;
-        planned: number;
-        updated: number;
-        skipped: number;
-        failed: number;
-    };
+/** Whether the operation completed without a blocking failure. */
+ok: boolean;
+/** Value that configures or reports action for this contract. */
+action: "upgrade";
+/** Value that configures or reports dry run for this contract. */
+dry_run: boolean;
+/** Value that configures or reports scope for this contract. */
+scope: ExtensionScope;
+/** Value that configures or reports target for this contract. */
+target?: string;
+/** Value that configures or reports cli for this contract. */
+cli: UpgradeCliResult;
+/** Value that configures or reports packages for this contract. */
+packages: UpgradePackageResult[];
+/** Value that configures or reports summary for this contract. */
+summary: {
+requested_cli: boolean;
+requested_packages: boolean;
+planned: number;
+updated: number;
+skipped: number;
+failed: number;
+};
 }
 declare function resolveScope(options: UpgradeCommandOptions): ExtensionScope;
 declare function normalizeTarget(value: string): string;
 declare function packageRecordMatchesTarget(record: ManagedExtensionRecord, target: string): boolean;
 declare function defaultCommandRunner(command: string, args: string[], options?: {
-    cwd?: string;
+cwd?: string;
 }): Promise<UpgradeCommandRunnerResult>;
 declare function resolveTag(options: UpgradeCommandOptions): string;
 declare function resolveCliPackage(options: UpgradeCommandOptions): string;

package/dist/sdk/governance/validate-history-drift.d.ts

@@ -2,6 +2,6 @@ import type { ValidateCheck } from "./validate.js";
 import type { ValidateItem } from "./validate-item-reader.js";
 /** Build the validation warning and bounded evidence projection for history drift. */
 export declare function buildValidateHistoryDriftCheck(pmRoot: string, items: ValidateItem[], verboseDiagnostics: boolean): Promise<{
-    check: ValidateCheck;
-    warnings: string[];
+check: ValidateCheck;
+warnings: string[];
 }>;