@unbrained/pm-cli 2026.10.11 → 2026.10.13

package/dist/cli.d.ts

@@ -5,9 +5,9 @@ declare function printFastVersionIfRequested(): boolean;
 declare function readPackageVersionForPath(startPath: string): string | undefined;
 /** Public contract for test only, shared by SDK and presentation-layer consumers. */
 export declare const _testOnly: {
-    enableNodeCompileCache: typeof enableNodeCompileCache;
-    findPackageJson: typeof findPackageJson;
-    printFastVersionIfRequested: typeof printFastVersionIfRequested;
-    readPackageVersionForPath: typeof readPackageVersionForPath;
+enableNodeCompileCache: typeof enableNodeCompileCache;
+findPackageJson: typeof findPackageJson;
+printFastVersionIfRequested: typeof printFastVersionIfRequested;
+readPackageVersionForPath: typeof readPackageVersionForPath;
 };
 export {};

package/dist/core/checkpoint/checkpoint-gc.d.ts

@@ -15,47 +15,47 @@
  */
 /** Documents the checkpoint gc scan entry payload exchanged by command, SDK, and package integrations. */
 export interface CheckpointGcEntry {
-    /** Relative path like "checkpoints/update-many/update-many-20260619-abc123.json". */
-    file: string;
-    /** Parsed `created_at`, or null when missing/unparseable. */
-    created_at: string | null;
-    /** floor((now - created_at)/1000), null when unparseable. */
-    age_seconds: number | null;
-    /** True only when classified as expired (older than the retention window). */
-    stale: boolean;
-    /** Value that configures or reports reason for this contract. */
-    reason: "expired" | "active" | "unparseable";
+/** Relative path like "checkpoints/update-many/update-many-20260619-abc123.json". */
+file: string;
+/** Parsed `created_at`, or null when missing/unparseable. */
+created_at: string | null;
+/** floor((now - created_at)/1000), null when unparseable. */
+age_seconds: number | null;
+/** True only when classified as expired (older than the retention window). */
+stale: boolean;
+/** Value that configures or reports reason for this contract. */
+reason: "expired" | "active" | "unparseable";
 }
 /** Documents the checkpoint gc hooks payload exchanged by command, SDK, and package integrations. */
 export interface CheckpointGcHooks {
-    /** Value that configures or reports on read for this contract. */
-    onRead?: (checkpointPath: string) => Promise<string[]> | string[];
-    /** Value that configures or reports on write for this contract. */
-    onWrite?: (checkpointPath: string) => Promise<string[]> | string[];
+/** Value that configures or reports on read for this contract. */
+onRead?: (checkpointPath: string) => Promise<string[]> | string[];
+/** Value that configures or reports on write for this contract. */
+onWrite?: (checkpointPath: string) => Promise<string[]> | string[];
 }
 /** Documents the checkpoint gc options payload exchanged by command, SDK, and package integrations. */
 export interface CheckpointGcOptions {
-    /** Value that configures or reports dry run for this contract. */
-    dryRun: boolean;
-    /** Prune checkpoints older than this many days. Negative values are clamped to zero (prune everything aged); a non-finite value (NaN/Infinity) disables pruning entirely so bad input never deletes recoverable checkpoints. */
-    retentionDays: number;
-    /** Epoch ms; defaults to Date.now() — injectable for deterministic tests. */
-    now?: number;
-    /** Value that configures or reports hooks for this contract. */
-    hooks?: CheckpointGcHooks;
+/** Value that configures or reports dry run for this contract. */
+dryRun: boolean;
+/** Prune checkpoints older than this many days. Negative values are clamped to zero (prune everything aged); a non-finite value (NaN/Infinity) disables pruning entirely so bad input never deletes recoverable checkpoints. */
+retentionDays: number;
+/** Epoch ms; defaults to Date.now() — injectable for deterministic tests. */
+now?: number;
+/** Value that configures or reports hooks for this contract. */
+hooks?: CheckpointGcHooks;
 }
 /** Documents the checkpoint gc result payload exchanged by command, SDK, and package integrations. */
 export interface CheckpointGcResult {
-    /** Number of *.json checkpoint files examined. */
-    scanned: number;
-    /** Relative paths removed (or would-remove under dryRun), sorted by file name asc. */
-    removed: string[];
-    /** Relative paths retained (active OR unparseable — never delete what we can't reason about). */
-    retained: string[];
-    /** Value that configures or reports warnings for this contract. */
-    warnings: string[];
-    /** One per scanned checkpoint file, sorted by file name asc. */
-    entries: CheckpointGcEntry[];
+/** Number of *.json checkpoint files examined. */
+scanned: number;
+/** Relative paths removed (or would-remove under dryRun), sorted by file name asc. */
+removed: string[];
+/** Relative paths retained (active OR unparseable — never delete what we can't reason about). */
+retained: string[];
+/** Value that configures or reports warnings for this contract. */
+warnings: string[];
+/** One per scanned checkpoint file, sorted by file name asc. */
+entries: CheckpointGcEntry[];
 }
 /** Implements run checkpoint gc for the public runtime surface of this module. */
 export declare function runCheckpointGc(pmRoot: string, options: CheckpointGcOptions): Promise<CheckpointGcResult>;

package/dist/core/checkpoint/mutation-checkpoint.d.ts

@@ -1,51 +1,51 @@
 /** Documents the mutation checkpoint item payload exchanged by command, SDK, and package integrations. */
 export interface MutationCheckpointItem {
-    /** Stable identifier used to reference this record across commands and storage. */
-    id: string;
-    /** ISO 8601 timestamp recording when target updated occurred. */
-    target_updated_at: string;
+/** Stable identifier used to reference this record across commands and storage. */
+id: string;
+/** ISO 8601 timestamp recording when target updated occurred. */
+target_updated_at: string;
 }
 /** Documents the loaded mutation checkpoint payload exchanged by command, SDK, and package integrations. */
 export interface LoadedMutationCheckpoint {
-    /** The full on-disk record so callers can read their command-specific fields. */
-    record: Record<string, unknown>;
-    /** Validated item list (id + target_updated_at). */
-    items: MutationCheckpointItem[];
-    /** Absolute path the checkpoint was read from. */
-    path: string;
-    /** Stable identifier used to reference this record across commands and storage. */
-    id: string;
-    /** ISO 8601 timestamp recording when created occurred. */
-    created_at: string;
-    /** Value that configures or reports author for this contract. */
-    author: string;
+/** The full on-disk record so callers can read their command-specific fields. */
+record: Record<string, unknown>;
+/** Validated item list (id + target_updated_at). */
+items: MutationCheckpointItem[];
+/** Absolute path the checkpoint was read from. */
+path: string;
+/** Stable identifier used to reference this record across commands and storage. */
+id: string;
+/** ISO 8601 timestamp recording when created occurred. */
+created_at: string;
+/** Value that configures or reports author for this contract. */
+author: string;
 }
 /** Documents the checkpoint rollback row payload exchanged by command, SDK, and package integrations. */
 export interface CheckpointRollbackRow {
-    /** Stable identifier used to reference this record across commands and storage. */
-    id: string;
-    /** Lifecycle state reported for status. */
-    status: "restored" | "failed";
-    /** Value that configures or reports changed fields for this contract. */
-    changed_fields?: string[];
-    /** Value that configures or reports warnings for this contract. */
-    warnings?: string[];
-    /** Value that configures or reports error for this contract. */
-    error?: string;
+/** Stable identifier used to reference this record across commands and storage. */
+id: string;
+/** Lifecycle state reported for status. */
+status: "restored" | "failed";
+/** Value that configures or reports changed fields for this contract. */
+changed_fields?: string[];
+/** Value that configures or reports warnings for this contract. */
+warnings?: string[];
+/** Value that configures or reports error for this contract. */
+error?: string;
 }
 /** Documents the checkpoint rollback result payload exchanged by command, SDK, and package integrations. */
 export interface CheckpointRollbackResult {
-    /** Value that configures or reports rows for this contract. */
-    rows: CheckpointRollbackRow[];
-    /** Value that configures or reports restored ids for this contract. */
-    restored_ids: string[];
-    /** Number of failed entries represented by this result. */
-    failed_count: number;
+/** Value that configures or reports rows for this contract. */
+rows: CheckpointRollbackRow[];
+/** Value that configures or reports restored ids for this contract. */
+restored_ids: string[];
+/** Number of failed entries represented by this result. */
+failed_count: number;
 }
 /** Restore a single item to its captured pre-mutation timestamp. */
 export type CheckpointRestoreFn = (id: string, targetUpdatedAt: string) => Promise<{
-    changed_fields?: string[];
-    warnings?: string[];
+changed_fields?: string[];
+warnings?: string[];
 }>;
 /** Implements normalize checkpoint id for the public runtime surface of this module. */
 export declare function normalizeCheckpointId(raw: string): string;

package/dist/core/config/nested-settings.d.ts

@@ -26,22 +26,22 @@
 export type NestedSettingKind = "string" | "boolean" | "integer" | "number" | "ratio";
 /** Documents the nested setting descriptor payload exchanged by command, SDK, and package integrations. */
 export interface NestedSettingDescriptor {
-    /** CLI key (snake_case). Kebab-case form is accepted by normalizing `-` → `_`. */
-    key: string;
-    /** Dotted JSON path in PmSettings. */
-    path: string;
-    /** Value shape. */
-    kind: NestedSettingKind;
-    /** Short human-facing summary for `pm config list`. */
-    summary: string;
-    /** Optional accepted values for string settings. */
-    choices?: readonly string[];
-    /** Require a non-empty trimmed string value for string settings. */
-    non_empty?: boolean;
-    /** Optional minimum value for `integer` / `number` kinds. When set, `parseNestedSettingValue` rejects values strictly below `min`. Useful for settings where 0 would be silently ignored by the runtime (batch sizes, timeouts, max-results limits). */
-    min?: number;
-    /** Optional maximum value for `integer` / `number` kinds. When set, `parseNestedSettingValue` rejects values strictly above `max` (bounded knobs like `ids.token_length`). */
-    max?: number;
+/** CLI key (snake_case). Kebab-case form is accepted by normalizing `-` → `_`. */
+key: string;
+/** Dotted JSON path in PmSettings. */
+path: string;
+/** Value shape. */
+kind: NestedSettingKind;
+/** Short human-facing summary for `pm config list`. */
+summary: string;
+/** Optional accepted values for string settings. */
+choices?: readonly string[];
+/** Require a non-empty trimmed string value for string settings. */
+non_empty?: boolean;
+/** Optional minimum value for `integer` / `number` kinds. When set, `parseNestedSettingValue` rejects values strictly below `min`. Useful for settings where 0 would be silently ignored by the runtime (batch sizes, timeouts, max-results limits). */
+min?: number;
+/** Optional maximum value for `integer` / `number` kinds. When set, `parseNestedSettingValue` rejects values strictly above `max` (bounded knobs like `ids.token_length`). */
+max?: number;
 }
 /** Search/provider/vector-store leaves. Order is the display order in `pm config list` and in error hints. */
 export declare const NESTED_SETTING_DESCRIPTORS: readonly NestedSettingDescriptor[];
@@ -49,23 +49,23 @@ export declare const NESTED_SETTING_DESCRIPTORS: readonly NestedSettingDescripto
 export declare function resolveNestedSettingDescriptor(raw: string | undefined): NestedSettingDescriptor | undefined;
 /** Recoverable parsed value with the descriptor it satisfied. */
 export interface NestedSettingParsedValue {
-    /** Value that configures or reports descriptor for this contract. */
-    descriptor: NestedSettingDescriptor;
-    /** Value that configures or reports value for this contract. */
-    value: string | number | boolean;
+/** Value that configures or reports descriptor for this contract. */
+descriptor: NestedSettingDescriptor;
+/** Value that configures or reports value for this contract. */
+value: string | number | boolean;
 }
 /** Throwable validation error returned as a structured result. */
 export interface NestedSettingParseError {
-    /** Human-readable explanation suitable for logs and agent-facing output. */
-    message: string;
+/** Human-readable explanation suitable for logs and agent-facing output. */
+message: string;
 }
 /** Restricts nested setting parse result values accepted by command, SDK, and storage contracts. */
 export type NestedSettingParseResult = {
-    ok: true;
-    parsed: NestedSettingParsedValue;
+ok: true;
+parsed: NestedSettingParsedValue;
 } | {
-    ok: false;
-    error: NestedSettingParseError;
+ok: false;
+error: NestedSettingParseError;
 };
 /**
  * Validate and coerce a raw string value for a nested-leaf setting. The

package/dist/core/config/positional-value.d.ts

@@ -11,30 +11,30 @@
  */
 /** Successful routing of a positional value to a single-value typed flag. */
 export interface ConfigPositionalScalarRouted {
-    /** Value that configures or reports routable for this contract. */
-    routable: true;
-    /** Value that configures or reports flag for this contract. */
-    flag: "format" | "policy";
-    /** Normalized scalar value for single-value flags. */
-    value: string;
+/** Value that configures or reports routable for this contract. */
+routable: true;
+/** Value that configures or reports flag for this contract. */
+flag: "format" | "policy";
+/** Normalized scalar value for single-value flags. */
+value: string;
 }
 /** Successful routing of a positional value to the criteria-list flag. */
 export interface ConfigPositionalListRouted {
-    /** Value that configures or reports routable for this contract. */
-    routable: true;
-    /** Value that configures or reports flag for this contract. */
-    flag: "criterion";
-    /** Criteria-list flag (`--criterion`) value, supplied as a values array. */
-    values: string[];
+/** Value that configures or reports routable for this contract. */
+routable: true;
+/** Value that configures or reports flag for this contract. */
+flag: "criterion";
+/** Criteria-list flag (`--criterion`) value, supplied as a values array. */
+values: string[];
 }
 /** Restricts config positional routed values accepted by command, SDK, and storage contracts. */
 export type ConfigPositionalRouted = ConfigPositionalScalarRouted | ConfigPositionalListRouted;
 /** A key whose value cannot be carried by a single positional (e.g. `context`). */
 export interface ConfigPositionalNotRoutable {
-    /** Value that configures or reports routable for this contract. */
-    routable: false;
-    /** Human/agent-facing reason + the flags to use instead. */
-    reason: string;
+/** Value that configures or reports routable for this contract. */
+routable: false;
+/** Human/agent-facing reason + the flags to use instead. */
+reason: string;
 }
 /** Restricts config positional result values accepted by command, SDK, and storage contracts. */
 export type ConfigPositionalResult = ConfigPositionalRouted | ConfigPositionalNotRoutable;

package/dist/core/diagnostics/remediation.d.ts

@@ -19,12 +19,12 @@
  */
 /** Maps a stable diagnostic warning code to the command and summary that resolve it. */
 export interface RemediationEntry {
-    /** Stable warning-code prefix this entry resolves. A warning matches when it equals this code or begins with `<code>:`. Registry codes are mutually exclusive under that colon-boundary rule (no code is a `:`-delimited prefix of another — e.g. `settings:id_prefix_empty` is distinct from a bare `settings`, which is intentionally not registered), so `resolveRemediation` uses first-match with no ordering dependency. */
-    readonly code: string;
-    /** Executable `pm` command (or imperative) that resolves the finding. May contain an `<id>` placeholder. */
-    readonly command: string;
-    /** One-line description of what the command does / which manual step it covers. */
-    readonly summary: string;
+/** Stable warning-code prefix this entry resolves. A warning matches when it equals this code or begins with `<code>:`. Registry codes are mutually exclusive under that colon-boundary rule (no code is a `:`-delimited prefix of another — e.g. `settings:id_prefix_empty` is distinct from a bare `settings`, which is intentionally not registered), so `resolveRemediation` uses first-match with no ordering dependency. */
+readonly code: string;
+/** Executable `pm` command (or imperative) that resolves the finding. May contain an `<id>` placeholder. */
+readonly command: string;
+/** One-line description of what the command does / which manual step it covers. */
+readonly summary: string;
 }
 /** Registry of every non-extension `pm health` / `pm validate` warning code and its remediation. Extension findings keep their richer, contextual `details.triage.remediation` produced by the extension health triage and are intentionally excluded here (see pm-0hnu: "all non-extension checks"). */
 export declare const REMEDIATION_REGISTRY: readonly RemediationEntry[];

package/dist/core/diagnostics/remediation.js

@@ -1,2 +1,2 @@
-(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="3d7db45e-123f-596b-afc7-b698f2b2f45c")}catch{}})();const REMEDIATION_REGISTRY=Object.freeze([{code:"missing_directory",command:"pm init",summary:"Recreate missing tracker directories (pm init is idempotent and restores the scaffold)."},{code:"settings_read_fs_error",command:"pm config list --json",summary:"settings.json could not be read as a regular file and pm fell back to defaults; repair the reported path or permissions, then re-run."},{code:"settings_read_invalid_json",command:"pm config list --json",summary:"settings.json is not valid JSON and pm fell back to defaults; fix the syntax error in the reported path, then re-run."},{code:"settings_read_invalid_schema",command:"pm config list --json",summary:"settings.json failed schema validation and pm fell back to defaults; correct the reported key in the file, then re-run."},{code:"settings_read_merge_failed",command:"pm config list --json",summary:"Global/project settings could not be merged; reconcile the conflicting keys in the reported settings files."},{code:"settings:id_prefix_empty",command:"pm config list --json",summary:'id_prefix is empty; set a non-empty "id_prefix" in settings.json so generated item ids are well-formed.'},{code:"settings:locks_ttl_non_positive",command:"pm config list --json",summary:'locks.ttl_seconds must be positive; set a positive "locks.ttl_seconds" in settings.json.'},{code:"telemetry_state_invalid_json",command:"pm health --check-telemetry",summary:"Local telemetry state file is corrupt; pm recreates it on the next flush. Advisory only."},{code:"telemetry_queue_invalid_rows",command:"pm health --check-telemetry",summary:"The telemetry queue has unparseable rows; they are skipped on the next flush. Advisory only."},{code:"telemetry_queue_pending",command:"pm health --check-telemetry",summary:"Telemetry events are queued; they flush automatically on the next reachable command. Advisory only."},{code:"telemetry_queue_high_retries",command:"pm telemetry flush",summary:"Some queued telemetry events are near retry exhaustion; flush now and verify endpoint reachability before entries are dropped."},{code:"telemetry_endpoint_probe_failed",command:"pm health --check-telemetry",summary:"The telemetry endpoint is unreachable; events stay queued until it recovers. Advisory only."},{code:"telemetry_endpoint_probe_http_status",command:"pm health --check-telemetry",summary:"The telemetry endpoint returned a non-success status; events stay queued until it recovers. Advisory only."},{code:"telemetry_schema_version_behind",command:"pm health --check-telemetry",summary:"Client schema is behind server; upgrade pm-cli to emit the latest event shape."},{code:"telemetry_otel_export_failing",command:"pm health --check-telemetry",summary:"OTLP trace spans are queued but the traces endpoint export is failing; spans retry automatically on the next reachable command, or set PM_TELEMETRY_OTEL_DISABLED=1 to skip OTLP export. Advisory only."},{code:"merge_driver_configuration_missing",command:"pm merge install",summary:"Install the clone-local Git drivers required by the tracker merge fence."},{code:"merge_driver_configuration_drift",command:"pm merge install",summary:"Reinstall clone-local Git drivers after runtime or package paths change."},{code:"merge_fence_missing",command:"pm merge install",summary:"Install the active tracker's committed Git merge attributes."},{code:"merge_fence_drift",command:"pm merge install",summary:"Restore the active tracker's merge mappings while retaining sibling tracker fences."},{code:"validate_merge_driver_configuration",command:"pm merge install",summary:"Restore missing or drifted clone-local Git merge driver commands."},{code:"integrity_item_unreadable",command:"pm validate --check-files --verbose-diagnostics",summary:"An item file could not be read; restore or repair the file at the reported path."},{code:"integrity_item_parse_failed",command:"pm validate --check-files --verbose-diagnostics",summary:"An item file failed to parse; fix the malformed item metadata at the reported path."},{code:"integrity_item_conflict_marker",command:"pm validate --check-files --verbose-diagnostics",summary:"An item file contains Git conflict markers; resolve the <<<<<<< / >>>>>>> markers at the reported line."},{code:"integrity_history_unreadable",command:"pm history-repair <id>",summary:"A history stream could not be read; re-anchor the affected item's history chain."},{code:"integrity_history_invalid_json",command:"pm history-repair <id>",summary:"A history stream contains invalid JSON; re-anchor the affected item's history chain."},{code:"integrity_history_conflict_marker",command:"pm history-repair <id>",summary:"A history stream contains Git conflict markers; resolve the markers, then re-anchor the chain."},{code:"validate_storage_unreadable_items",command:"pm validate --check-storage-integrity --verbose-diagnostics",summary:"An on-disk item file cannot be parsed (for example a botched merge resolution with stale TOON count headers); repair or restore the file at the reported path \u2014 list commands silently skip it while pm get hard-errors."},{code:"validate_storage_duplicate_item_ids",command:"pm validate --check-storage-integrity --verbose-diagnostics",summary:"One item id is claimed by multiple item documents \u2014 usually two branches minting the same id for different items before merging (GH-600). Keep one document, recreate the other item under a fresh id (pm copy, then delete the colliding file), and consider raising ids.token_length for concurrent multi-agent work."},{code:"validate_storage_history_conflict_markers",command:"pm merge driver history <base> <ours> <theirs>",summary:"A history stream contains unresolved Git conflict markers; re-merge it with the pm history merge driver (or resolve the markers by hand), then run pm history-repair for the item."},{code:"validate_storage_unparseable_history",command:"pm history-repair <id>",summary:"A history stream's newest line is not valid JSONL; repair or restore the stream before further mutations."},{code:"validate_storage_resurrected_items",command:"pm delete <id>",summary:"A live item's newest history operation is a delete: a delete/modify merge silently resurrected it. Decide the winner \u2014 re-delete the item, or keep it and append a mutation documenting the revival."},{code:"validate_storage_unparseable_config",command:"pm merge driver json <base> <ours> <theirs>",summary:"settings.json or a schema file cannot be parsed, so pm silently falls back to defaults; re-merge it with the pm JSON merge driver or fix the file by hand, then rerun pm validate."},{code:"validate_merge_fence_drift",command:"pm merge install",summary:"The committed .gitattributes merge fence no longer matches the active schema's type folders or tracker JSONL stores; rerun pm merge install (and commit .gitattributes) so every tracker artifact keeps its field-aware merge driver."},{code:"validate_storage_tracked_runtime_cache_files",command:"git rm --cached -r -- <tracked-runtime-directories>",summary:"Clone-local tracker runtime artifacts are committed. Run the exact tracked_runtime_cache.remediation_command, commit the index-only removals and managed .gitignore fence, then rerun validation."},{code:"integrity_item_outdated_format_version",command:"pm validate --verbose-diagnostics",summary:"An item predates the current storage format version; a pm storage migration rewrites it. Use --verbose-diagnostics to list the affected items."},{code:"integrity_item_ahead_format_version",command:"npm install -g @unbrained/pm-cli@latest",summary:"An item was written by a newer pm format version than this runtime supports; upgrade pm to read and validate it safely."},{code:"tracked_runtime_cache_files",command:"git rm --cached -r -- <tracked-runtime-directories>",summary:"Clone-local tracker runtime artifacts are committed. Run the exact tracked_runtime_cache.remediation_command from the integrity check, commit the index-only removals, and keep the managed .gitignore fence."},{code:"merge_decisions_unreviewed",command:"pm merge reconcile --dry-run",summary:"Review the pending merge receipts, re-apply any intended discarded values, then run pm merge reconcile; lossy receipts require explicit --force acceptance."},{code:"merge_receipts_pending",command:"pm merge reconcile",summary:"A lossless merge receipt is still pending; run pm merge reconcile to settle it (optionally preview first with --dry-run) so a green health gate certifies receipt settlement, not only intact data."},{code:"merge_receipt_evidence_invalid",command:"pm merge report --include-reconciled --json",summary:"One or more receipt candidates failed bounded-file, schema, identity, or copy-consistency validation; inspect the report's privacy-safe source, receipt id, and reason before repairing only the named evidence."},{code:"merge_receipt_history_reference_missing",command:"pm merge reconcile --dry-run",summary:"Review the bounded coordinates and recover available evidence first; for exact pre-durable clone-local-only references, rerun with --force so pm appends an audited disposition and proves the health finding is cleared without rewriting history."},{code:"validate_merge_decisions_unreviewed",command:"pm merge reconcile --dry-run",summary:"Review the pending merge receipts before reconciliation; history-repair alone does not settle them, and lossy receipts require explicit --force acceptance."},{code:"history_drift_missing_stream",command:"pm history-repair <id>",summary:"The item has no history stream; re-anchor the chain to rebuild it (pm history-repair --all repairs every drifted stream in one pass)."},{code:"history_drift_unreadable_stream",command:"pm history-repair <id>",summary:"The item's history stream is unreadable; re-anchor the chain (pm history-repair --all repairs every drifted stream in one pass)."},{code:"history_drift_hash_mismatch",command:"pm history-repair <id>",summary:"The item's content hash no longer matches its history; re-anchor the chain (pm history-repair --all repairs every drifted stream in one pass)."},{code:"history_drift_chain_mismatch",command:"pm history-repair <id>",summary:"The item's history chain is broken; re-anchor the chain (pm history-repair --all repairs every drifted stream in one pass)."},{code:"history_drift_version_skew",command:"npm install -g @unbrained/pm-cli@latest",summary:"A history stream declares an item hash version this runtime does not support; upgrade pm to verify the chain instead of re-anchoring it."},{code:"history_drift_merge_receipt",command:"pm merge reconcile",summary:"Canonical path, changed-field, and merged-value hash evidence attributes this drift to a pending receipt; run reconciliation (optionally preview first with --dry-run) instead of repairing history directly."},{code:"history_stream_over_compact_threshold",command:"pm history-compact <id>",summary:"The history stream exceeds the configured compaction threshold; compact it (pm history-compact --all-streams sweeps every over-threshold stream in one pass)."},{code:"history_unknown_author_events",command:'pm history-author-acknowledge --all-actionable --attributed-author "<principal>" --reviewer "<reviewer>" --reason "<evidence>"',summary:"Review the actionable coordinates, then record an append-only attribution disposition for the complete current set."},{code:"provenance_value_domain_invalid",command:"pm history-repair --all --normalize-provenance",summary:"Remove invalid bounded provenance observations from affected streams and append privacy-safe aggregate repair receipts."},{code:"validate_history_unknown_author_events",command:'pm history-author-acknowledge --all-actionable --attributed-author "<principal>" --reviewer "<reviewer>" --reason "<evidence>"',summary:"Review the actionable coordinates, then record an append-only attribution disposition for the complete current set."},{code:"locks_stale_count",command:"pm gc --scope locks",summary:"Stale item-claim locks (embedded ttl elapsed) can block mutations; sweep them \u2014 gc retains active and unparseable locks."},{code:"locks_unreadable",command:"pm gc --scope locks --dry-run",summary:"Some lock files could not be read; preview the sweep and inspect the unreadable files manually \u2014 gc never deletes what it cannot read."},{code:"extension_update_health_partial_coverage",command:"pm extension --adopt-all --project",summary:"Update-health coverage is partial because unmanaged extensions were skipped; adopt the existing installs into managed metadata so the update scan covers them (use --global for global-scope extensions, or pm package --adopt-all when working with packages)."},{code:"vectorization_stale_items_remaining",command:"pm health --refresh-vectors",summary:"Some items have stale embeddings; refresh vectors so semantic search results stay current."},{code:"vectorization_embedding_identity_changed",command:"pm reindex --mode semantic",summary:"Embedding provider/model changed since the last index; run a semantic reindex to rebuild vectors."},{code:"validate_metadata_missing_closed_at",command:"pm validate --check-metadata --auto-fix --fix-scope timestamps --dry-run",summary:"Preview closure dates proven by verified lifecycle history; inspect residuals and omit --dry-run to apply only proven dates."},{code:"validate_metadata_missing_acceptance_criteria",command:'pm update <id> --acceptance-criteria "<criteria>"',summary:"Backfill the missing acceptance criteria on the reported item(s)."},{code:"validate_metadata_missing_estimate",command:'pm update <id> --estimate "<estimate>"',summary:"Backfill the missing estimate on the reported item(s)."},{code:"validate_metadata_missing_close_reason",command:'pm update <id> --close-reason "<reason>"',summary:"Backfill the missing close reason on the reported closed item(s)."},{code:"validate_metadata_missing_reviewer",command:'pm update <id> --reviewer "<name>"',summary:"Backfill the missing reviewer on the reported item(s)."},{code:"validate_metadata_missing_risk",command:'pm update <id> --risk "<level>"',summary:"Backfill the missing risk on the reported item(s)."},{code:"validate_metadata_missing_confidence",command:'pm update <id> --confidence "<level>"',summary:"Backfill the missing confidence on the reported item(s)."},{code:"validate_metadata_missing_sprint",command:'pm update <id> --sprint "<sprint>"',summary:"Backfill the missing sprint on the reported item(s)."},{code:"validate_metadata_missing_release",command:'pm update <id> --release "<release>"',summary:"Backfill the missing release on the reported item(s)."},{code:"validate_metadata_custom_profile_missing_required_fields",command:'pm config set metadata-required-fields --criterion "<field>"',summary:"Config-driven finding: the custom metadata profile has no required fields configured and falls back to core, so configure the fields rather than mutating items."},{code:"validate_metadata_duplicate_issue_codes",command:'pm update <id> --title "<distinct title>"',summary:"Two or more items share one logical issue code (GH-235); give each a distinct title so the derived code is unique, or close the redundant item with pm close <id> --duplicate-of <canonical-id> (closed-as-duplicate items are excluded from the check)."},{code:"validate_resolution_missing_fields",command:'pm update <id> --resolution "<how resolved>"',summary:"Backfill resolution / expected_result / actual_result on the reported closed item(s)."},{code:"validate_lifecycle_active_closure_like_metadata",command:"pm update <id> --unset <closure-like-field>",summary:"Clear the closure-like field the validator flags on this active item \u2014 the detail row names it (resolution / actual-result / blocked-reason) \u2014 or close the item if it is actually done."},{code:"validate_lifecycle_active_terminal_parent",command:"pm update <id> --parent <active-parent-id>",summary:"Reopen the terminal parent or move the active child under a non-terminal parent."},{code:"validate_lifecycle_stale_blockers",command:"pm update <id> --unset blocked-by --unset blocked-reason",summary:"Resolve the stale blocker the validator flags: clear blocked-by/blocked-reason when they linger on a non-blocked item or report a resolved blocker; if instead a blocked item is missing blocker context, add the context or move it out of a blocked status."},{code:"validate_lifecycle_dependency_cycles_error",command:"pm update <id> --dep-remove <dep-id>",summary:"Break the dependency cycle by removing one edge from the reported cycle."},{code:"validate_lifecycle_dependency_cycles",command:"pm update <id> --dep-remove <dep-id>",summary:"Break the dependency cycle by removing one edge from the reported cycle."},{code:"validate_hierarchy_parent_cycle_error",command:"pm update <id> --parent <other-id>",summary:"Break the parent-hierarchy cycle by reparenting one item in the reported cycle to a non-cyclic parent (or clear it with pm update <id> --unset parent)."},{code:"validate_hierarchy_parent_cycle",command:"pm update <id> --parent <other-id>",summary:"Break the parent-hierarchy cycle by reparenting one item in the reported cycle to a non-cyclic parent (or clear it with pm update <id> --unset parent)."},{code:"validate_files_missing_linked_paths",command:"pm <files|docs> <id> --remove <path>",summary:"The check spans both item.files and item.docs under one code: restore the missing linked artifact, or unlink it with pm files (linked file) or pm docs (linked doc)."},{code:"validate_files_orphaned_paths",command:"pm <files|docs> <id> --add <path>",summary:"Link the orphaned artifact with pm files (file) or pm docs (doc), or remove it from the workspace."},{code:"validate_files_tracked_all_strict_forces_pm_internals",command:"pm validate --check-files --include-pm-internals",summary:"tracked-all-strict scan flagged pm internals; re-run with --include-pm-internals or a softer --scan-mode."},{code:"validate_history_drift_missing_streams",command:"pm history-repair <id>",summary:"Re-anchor the history chains of the items missing a history stream."},{code:"validate_history_drift_unreadable_streams",command:"pm history-repair <id>",summary:"Re-anchor the history chains of the items with an unreadable history stream."},{code:"validate_history_drift_hash_mismatches",command:"pm history-repair <id>",summary:"Re-anchor the history chains of the items whose content hash drifted."},{code:"validate_history_drift_chain_mismatches",command:"pm history-repair <id>",summary:"Re-anchor the history chains of the items with a broken history chain."},{code:"validate_history_drift_version_skews",command:"npm install -g @unbrained/pm-cli@latest",summary:"One or more history streams declare an item hash version this runtime does not support; upgrade pm to verify the chains instead of re-anchoring them."},{code:"validate_command_references_stale_pm_ids",command:'pm update <id> --replace-tests --test "command=<corrected-command>" [--test ...]',summary:"Correct the stale pm-ID inside the item's linked test command (the check scans tests[].command, not the body). --replace-tests overwrites the entire tests list, so re-include the item's other linked tests in the same call."},{code:"validate_format_version_outdated_items",command:"pm validate --verbose-diagnostics",summary:"One or more items predate the current storage format version; a pm storage migration rewrites them. Use --verbose-diagnostics to list the affected items."},{code:"validate_format_version_ahead_items",command:"npm install -g @unbrained/pm-cli@latest",summary:"One or more items were written by a newer pm format version than this runtime supports; upgrade pm to read and validate them safely."}]);function resolveRemediation(warning){if(typeof warning!="string")return;const normalized=warning.trim();for(const entry of REMEDIATION_REGISTRY)if(normalized===entry.code||normalized.startsWith(`${entry.code}:`))return entry}function buildRemediationMap(warnings){const map={};for(const warning of warnings){const entry=resolveRemediation(warning);entry!==void 0&&!Object.prototype.hasOwnProperty.call(map,entry.code)&&(map[entry.code]=entry.command)}return map}function buildRemediationCommands(warnings){return Object.values(buildRemediationMap(warnings))}export{REMEDIATION_REGISTRY,buildRemediationCommands,buildRemediationMap,resolveRemediation};
+(function(){try{var e=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="270d544f-ac42-559f-ba6a-82f3d3b6c187")}catch{}})();const REMEDIATION_REGISTRY=Object.freeze([{code:"missing_directory",command:"pm init",summary:"Recreate missing tracker directories (pm init is idempotent and restores the scaffold)."},{code:"settings_read_fs_error",command:"pm config list --json",summary:"settings.json could not be read as a regular file and pm fell back to defaults; repair the reported path or permissions, then re-run."},{code:"settings_read_invalid_json",command:"pm config list --json",summary:"settings.json is not valid JSON and pm fell back to defaults; fix the syntax error in the reported path, then re-run."},{code:"settings_read_invalid_schema",command:"pm config list --json",summary:"settings.json failed schema validation and pm fell back to defaults; correct the reported key in the file, then re-run."},{code:"settings_read_merge_failed",command:"pm config list --json",summary:"Global/project settings could not be merged; reconcile the conflicting keys in the reported settings files."},{code:"settings:id_prefix_empty",command:"pm config list --json",summary:'id_prefix is empty; set a non-empty "id_prefix" in settings.json so generated item ids are well-formed.'},{code:"settings:locks_ttl_non_positive",command:"pm config list --json",summary:'locks.ttl_seconds must be positive; set a positive "locks.ttl_seconds" in settings.json.'},{code:"telemetry_state_invalid_json",command:"pm health --check-telemetry",summary:"Local telemetry state file is corrupt; pm recreates it on the next flush. Advisory only."},{code:"telemetry_queue_invalid_rows",command:"pm health --check-telemetry",summary:"The telemetry queue has unparseable rows; they are skipped on the next flush. Advisory only."},{code:"telemetry_queue_pending",command:"pm health --check-telemetry",summary:"Telemetry events are queued; they flush automatically on the next reachable command. Advisory only."},{code:"telemetry_queue_high_retries",command:"pm telemetry flush",summary:"Some queued telemetry events are near retry exhaustion; flush now and verify endpoint reachability before entries are dropped."},{code:"telemetry_endpoint_probe_failed",command:"pm health --check-telemetry",summary:"The telemetry endpoint is unreachable; events stay queued until it recovers. Advisory only."},{code:"telemetry_endpoint_probe_http_status",command:"pm health --check-telemetry",summary:"The telemetry endpoint returned a non-success status; events stay queued until it recovers. Advisory only."},{code:"telemetry_schema_version_behind",command:"pm health --check-telemetry",summary:"Client schema is behind server; upgrade pm-cli to emit the latest event shape."},{code:"telemetry_otel_export_failing",command:"pm health --check-telemetry",summary:"OTLP trace spans are queued but the traces endpoint export is failing; spans retry automatically on the next reachable command, or set PM_TELEMETRY_OTEL_DISABLED=1 to skip OTLP export. Advisory only."},{code:"merge_driver_configuration_missing",command:"pm merge install",summary:"Install the clone-local Git drivers required by the tracker merge fence."},{code:"merge_driver_configuration_drift",command:"pm merge install",summary:"Reinstall clone-local Git drivers after runtime or package paths change."},{code:"merge_fence_missing",command:"pm merge install",summary:"Install the active tracker's committed Git merge attributes."},{code:"merge_fence_drift",command:"pm merge install",summary:"Restore the active tracker's merge mappings while retaining sibling tracker fences."},{code:"validate_merge_driver_configuration",command:"pm merge install",summary:"Restore missing or drifted clone-local Git merge driver commands."},{code:"integrity_item_unreadable",command:"pm validate --check-files --verbose-diagnostics",summary:"An item file could not be read; restore or repair the file at the reported path."},{code:"integrity_item_parse_failed",command:"pm validate --check-files --verbose-diagnostics",summary:"An item file failed to parse; fix the malformed item metadata at the reported path."},{code:"integrity_item_conflict_marker",command:"pm validate --check-files --verbose-diagnostics",summary:"An item file contains Git conflict markers; resolve the <<<<<<< / >>>>>>> markers at the reported line."},{code:"integrity_history_unreadable",command:"pm history-repair <id>",summary:"A history stream could not be read; re-anchor the affected item's history chain."},{code:"integrity_history_invalid_json",command:"pm history-repair <id>",summary:"A history stream contains invalid JSON; re-anchor the affected item's history chain."},{code:"integrity_history_conflict_marker",command:"pm history-repair <id>",summary:"A history stream contains Git conflict markers; resolve the markers, then re-anchor the chain."},{code:"validate_storage_unreadable_items",command:"pm validate --check-storage-integrity --verbose-diagnostics",summary:"An on-disk item file cannot be parsed (for example a botched merge resolution with stale TOON count headers); repair or restore the file at the reported path \u2014 list commands silently skip it while pm get hard-errors."},{code:"validate_storage_duplicate_item_ids",command:"pm validate --check-storage-integrity --verbose-diagnostics",summary:"One item id is claimed by multiple item documents \u2014 usually two branches minting the same id for different items before merging (GH-600). Keep one document, recreate the other item under a fresh id (pm copy, then delete the colliding file), and consider raising ids.token_length for concurrent multi-agent work."},{code:"validate_storage_history_conflict_markers",command:"pm merge driver history <base> <ours> <theirs>",summary:"A history stream contains unresolved Git conflict markers; re-merge it with the pm history merge driver (or resolve the markers by hand), then run pm history-repair for the item."},{code:"validate_storage_unparseable_history",command:"pm history-repair <id>",summary:"A history stream's newest line is not valid JSONL; repair or restore the stream before further mutations."},{code:"validate_storage_resurrected_items",command:"pm delete <id>",summary:"A live item's newest history operation is a delete: a delete/modify merge silently resurrected it. Decide the winner \u2014 re-delete the item, or keep it and append a mutation documenting the revival."},{code:"validate_storage_unparseable_config",command:"pm merge driver json <base> <ours> <theirs>",summary:"settings.json or a schema file cannot be parsed, so pm silently falls back to defaults; re-merge it with the pm JSON merge driver or fix the file by hand, then rerun pm validate."},{code:"validate_merge_fence_drift",command:"pm merge install",summary:"The committed .gitattributes merge fence no longer matches the active schema's type folders or tracker JSONL stores; rerun pm merge install (and commit .gitattributes) so every tracker artifact keeps its field-aware merge driver."},{code:"validate_storage_tracked_runtime_cache_files",command:"git rm --cached -r -- <tracked-runtime-directories>",summary:"Clone-local tracker runtime artifacts are committed. Run the exact tracked_runtime_cache.remediation_command, commit the index-only removals and managed .gitignore fence, then rerun validation."},{code:"integrity_item_outdated_format_version",command:"pm validate --verbose-diagnostics",summary:"An item predates the current storage format version; a pm storage migration rewrites it. Use --verbose-diagnostics to list the affected items."},{code:"integrity_item_ahead_format_version",command:"npm install -g @unbrained/pm-cli@latest",summary:"An item was written by a newer pm format version than this runtime supports; upgrade pm to read and validate it safely."},{code:"tracked_runtime_cache_files",command:"git rm --cached -r -- <tracked-runtime-directories>",summary:"Clone-local tracker runtime artifacts are committed. Run the exact tracked_runtime_cache.remediation_command from the integrity check, commit the index-only removals, and keep the managed .gitignore fence."},{code:"merge_decisions_unreviewed",command:"pm merge reconcile --dry-run",summary:'Review pending receipt summaries, re-apply intended discarded values, then run pm merge reconcile. If proof is unavailable or receipt decisions are lossy, explicit review authority is required for pm merge reconcile --force --message "<reviewed receipt disposition and rationale>"; this records acceptance rather than restoring discarded values.'},{code:"merge_receipts_pending",command:"pm merge reconcile",summary:'A lossless receipt is pending; preview with pm merge reconcile --dry-run, then apply. If no receipt set proves the snapshot, review the summaries and only with explicit authority run pm merge reconcile --force --message "<reviewed receipt disposition and rationale>" to record an audited acceptance.'},{code:"merge_receipt_evidence_invalid",command:"pm merge report --include-reconciled --json",summary:"One or more receipt candidates failed bounded-file, schema, identity, or copy-consistency validation; inspect the report's privacy-safe source, receipt id, and reason before repairing only the named evidence."},{code:"merge_receipt_history_reference_missing",command:"pm merge reconcile --dry-run",summary:"Review the bounded coordinates and recover available evidence first; for exact pre-durable clone-local-only references, rerun with --force so pm appends an audited disposition and proves the health finding is cleared without rewriting history."},{code:"validate_merge_decisions_unreviewed",command:"pm merge reconcile --dry-run",summary:"Review the pending merge receipts before reconciliation; history-repair alone does not settle them, and lossy receipts require explicit --force acceptance."},{code:"history_drift_missing_stream",command:"pm history-repair <id>",summary:"The item has no history stream; re-anchor the chain to rebuild it (pm history-repair --all repairs every drifted stream in one pass)."},{code:"history_drift_unreadable_stream",command:"pm history-repair <id>",summary:"The item's history stream is unreadable; re-anchor the chain (pm history-repair --all repairs every drifted stream in one pass)."},{code:"history_drift_hash_mismatch",command:"pm history-repair <id>",summary:"The item's content hash no longer matches its history; re-anchor the chain (pm history-repair --all repairs every drifted stream in one pass)."},{code:"history_drift_chain_mismatch",command:"pm history-repair <id>",summary:"The item's history chain is broken; re-anchor the chain (pm history-repair --all repairs every drifted stream in one pass)."},{code:"history_drift_version_skew",command:"npm install -g @unbrained/pm-cli@latest",summary:"A history stream declares an item hash version this runtime does not support; upgrade pm to verify the chain instead of re-anchoring it."},{code:"history_drift_merge_receipt",command:"pm merge reconcile",summary:"Canonical path, changed-field, and merged-value hash evidence attributes this drift to a pending receipt; run reconciliation (optionally preview first with --dry-run) instead of repairing history directly."},{code:"history_stream_over_compact_threshold",command:"pm history-compact <id>",summary:"The history stream exceeds the configured compaction threshold; compact it (pm history-compact --all-streams sweeps every over-threshold stream in one pass)."},{code:"history_unknown_author_events",command:'pm history-author-acknowledge --all-actionable --attributed-author "<principal>" --reviewer "<reviewer>" --reason "<evidence>"',summary:"Review the actionable coordinates, then record an append-only attribution disposition for the complete current set."},{code:"provenance_value_domain_invalid",command:"pm history-repair --all --normalize-provenance",summary:"Remove invalid bounded provenance observations from affected streams and append privacy-safe aggregate repair receipts."},{code:"validate_history_unknown_author_events",command:'pm history-author-acknowledge --all-actionable --attributed-author "<principal>" --reviewer "<reviewer>" --reason "<evidence>"',summary:"Review the actionable coordinates, then record an append-only attribution disposition for the complete current set."},{code:"locks_stale_count",command:"pm gc --scope locks",summary:"Stale item-claim locks (embedded ttl elapsed) can block mutations; sweep them \u2014 gc retains active and unparseable locks."},{code:"locks_unreadable",command:"pm gc --scope locks --dry-run",summary:"Some lock files could not be read; preview the sweep and inspect the unreadable files manually \u2014 gc never deletes what it cannot read."},{code:"extension_update_health_partial_coverage",command:"pm extension --adopt-all --project",summary:"Update-health coverage is partial because unmanaged extensions were skipped; adopt the existing installs into managed metadata so the update scan covers them (use --global for global-scope extensions, or pm package --adopt-all when working with packages)."},{code:"vectorization_stale_items_remaining",command:"pm health --refresh-vectors",summary:"Some items have stale embeddings; refresh vectors so semantic search results stay current."},{code:"vectorization_embedding_identity_changed",command:"pm reindex --mode semantic",summary:"Embedding provider/model changed since the last index; run a semantic reindex to rebuild vectors."},{code:"validate_metadata_missing_closed_at",command:"pm validate --check-metadata --auto-fix --fix-scope timestamps --dry-run",summary:"Preview closure dates proven by verified lifecycle history; inspect residuals and omit --dry-run to apply only proven dates."},{code:"validate_metadata_missing_acceptance_criteria",command:'pm update <id> --acceptance-criteria "<criteria>"',summary:"Backfill the missing acceptance criteria on the reported item(s)."},{code:"validate_metadata_missing_estimate",command:'pm update <id> --estimate "<estimate>"',summary:"Backfill the missing estimate on the reported item(s)."},{code:"validate_metadata_missing_close_reason",command:'pm update <id> --close-reason "<reason>"',summary:"Backfill the missing close reason on the reported closed item(s)."},{code:"validate_metadata_missing_reviewer",command:'pm update <id> --reviewer "<name>"',summary:"Backfill the missing reviewer on the reported item(s)."},{code:"validate_metadata_missing_risk",command:'pm update <id> --risk "<level>"',summary:"Backfill the missing risk on the reported item(s)."},{code:"validate_metadata_missing_confidence",command:'pm update <id> --confidence "<level>"',summary:"Backfill the missing confidence on the reported item(s)."},{code:"validate_metadata_missing_sprint",command:'pm update <id> --sprint "<sprint>"',summary:"Backfill the missing sprint on the reported item(s)."},{code:"validate_metadata_missing_release",command:'pm update <id> --release "<release>"',summary:"Backfill the missing release on the reported item(s)."},{code:"validate_metadata_custom_profile_missing_required_fields",command:'pm config set metadata-required-fields --criterion "<field>"',summary:"Config-driven finding: the custom metadata profile has no required fields configured and falls back to core, so configure the fields rather than mutating items."},{code:"validate_metadata_duplicate_issue_codes",command:'pm update <id> --title "<distinct title>"',summary:"Two or more items share one logical issue code (GH-235); give each a distinct title so the derived code is unique, or close the redundant item with pm close <id> --duplicate-of <canonical-id> (closed-as-duplicate items are excluded from the check)."},{code:"validate_resolution_missing_fields",command:'pm update <id> --resolution "<how resolved>"',summary:"Backfill resolution / expected_result / actual_result on the reported closed item(s)."},{code:"validate_lifecycle_active_closure_like_metadata",command:"pm update <id> --unset <closure-like-field>",summary:"Clear the closure-like field the validator flags on this active item \u2014 the detail row names it (resolution / actual-result / blocked-reason) \u2014 or close the item if it is actually done."},{code:"validate_lifecycle_active_terminal_parent",command:"pm update <id> --parent <active-parent-id>",summary:"Reopen the terminal parent or move the active child under a non-terminal parent."},{code:"validate_lifecycle_stale_blockers",command:"pm update <id> --unset blocked-by --unset blocked-reason",summary:"Resolve the stale blocker the validator flags: clear blocked-by/blocked-reason when they linger on a non-blocked item or report a resolved blocker; if instead a blocked item is missing blocker context, add the context or move it out of a blocked status."},{code:"validate_lifecycle_dependency_cycles_error",command:"pm update <id> --dep-remove <dep-id>",summary:"Break the dependency cycle by removing one edge from the reported cycle."},{code:"validate_lifecycle_dependency_cycles",command:"pm update <id> --dep-remove <dep-id>",summary:"Break the dependency cycle by removing one edge from the reported cycle."},{code:"validate_hierarchy_parent_cycle_error",command:"pm update <id> --parent <other-id>",summary:"Break the parent-hierarchy cycle by reparenting one item in the reported cycle to a non-cyclic parent (or clear it with pm update <id> --unset parent)."},{code:"validate_hierarchy_parent_cycle",command:"pm update <id> --parent <other-id>",summary:"Break the parent-hierarchy cycle by reparenting one item in the reported cycle to a non-cyclic parent (or clear it with pm update <id> --unset parent)."},{code:"validate_files_missing_linked_paths",command:"pm <files|docs> <id> --remove <path>",summary:"The check spans both item.files and item.docs under one code: restore the missing linked artifact, or unlink it with pm files (linked file) or pm docs (linked doc)."},{code:"validate_files_orphaned_paths",command:"pm <files|docs> <id> --add <path>",summary:"Link the orphaned artifact with pm files (file) or pm docs (doc), or remove it from the workspace."},{code:"validate_files_tracked_all_strict_forces_pm_internals",command:"pm validate --check-files --include-pm-internals",summary:"tracked-all-strict scan flagged pm internals; re-run with --include-pm-internals or a softer --scan-mode."},{code:"validate_history_drift_missing_streams",command:"pm history-repair <id>",summary:"Re-anchor the history chains of the items missing a history stream."},{code:"validate_history_drift_unreadable_streams",command:"pm history-repair <id>",summary:"Re-anchor the history chains of the items with an unreadable history stream."},{code:"validate_history_drift_hash_mismatches",command:"pm history-repair <id>",summary:"Re-anchor the history chains of the items whose content hash drifted."},{code:"validate_history_drift_chain_mismatches",command:"pm history-repair <id>",summary:"Re-anchor the history chains of the items with a broken history chain."},{code:"validate_history_drift_version_skews",command:"npm install -g @unbrained/pm-cli@latest",summary:"One or more history streams declare an item hash version this runtime does not support; upgrade pm to verify the chains instead of re-anchoring them."},{code:"validate_command_references_stale_pm_ids",command:'pm update <id> --replace-tests --test "command=<corrected-command>" [--test ...]',summary:"Correct the stale pm-ID inside the item's linked test command (the check scans tests[].command, not the body). --replace-tests overwrites the entire tests list, so re-include the item's other linked tests in the same call."},{code:"validate_format_version_outdated_items",command:"pm validate --verbose-diagnostics",summary:"One or more items predate the current storage format version; a pm storage migration rewrites them. Use --verbose-diagnostics to list the affected items."},{code:"validate_format_version_ahead_items",command:"npm install -g @unbrained/pm-cli@latest",summary:"One or more items were written by a newer pm format version than this runtime supports; upgrade pm to read and validate them safely."}]);function resolveRemediation(warning){if(typeof warning!="string")return;const normalized=warning.trim();for(const entry of REMEDIATION_REGISTRY)if(normalized===entry.code||normalized.startsWith(`${entry.code}:`))return entry}function buildRemediationMap(warnings){const map={};for(const warning of warnings){const entry=resolveRemediation(warning);entry!==void 0&&!Object.prototype.hasOwnProperty.call(map,entry.code)&&(map[entry.code]=entry.command)}return map}function buildRemediationCommands(warnings){return Object.values(buildRemediationMap(warnings))}export{REMEDIATION_REGISTRY,buildRemediationCommands,buildRemediationMap,resolveRemediation};
 //# sourceMappingURL=remediation.js.map

package/dist/core/extensions/activation-summary-markdown.d.ts

@@ -27,22 +27,22 @@ import type { ExtensionActivationSummary } from "./activation-summary.js";
  * Options for {@link renderExtensionSurfaceMarkdown}.
  */
 export interface ExtensionSurfaceMarkdownOptions {
-    /**
+/**
      * Heading text for the document title. Defaults to `"Extension surfaces"`.
      * The title always renders as an ATX heading at
      * {@link ExtensionSurfaceMarkdownOptions.headingLevel}; per-surface sections
      * render one level deeper.
      */
-    title?: string;
-    /**
+title?: string;
+/**
      * ATX heading level for the title, an integer in `[1, 6]` (default `2`, i.e.
      * `##`, so the document embeds cleanly under a `# Package` README heading).
      * Section headings render at `headingLevel + 1`, clamped to `6`. Values
      * outside `[1, 6]` throw a {@link RangeError}.
      */
-    headingLevel?: number;
-    /** When `true`, render every surface section even when it has no entries (emitting `_None._` under the heading) and always emit the capabilities line. Defaults to `false`, which omits empty sections so the reference lists only what the package actually contributes. */
-    includeEmpty?: boolean;
+headingLevel?: number;
+/** When `true`, render every surface section even when it has no entries (emitting `_None._` under the heading) and always emit the capabilities line. Defaults to `false`, which omits empty sections so the reference lists only what the package actually contributes. */
+includeEmpty?: boolean;
 }
 /**
  * Render an {@link ExtensionActivationSummary} as a deterministic Markdown

package/dist/core/extensions/activation-summary.d.ts

@@ -40,74 +40,74 @@ import type { ExtensionActivationResult, ExtensionCapability, ExtensionServiceNa
  * appears only in {@link ExtensionActivationSummary.command_overrides}.
  */
 export interface ExtensionActivationSummary {
-    /** Known capabilities the registered surfaces exercise (sorted, de-duplicated). */
-    capabilities: ExtensionCapability[];
-    /** Full command paths declared via `registerCommand`'s definition form. */
-    commands: string[];
-    /** Built-in command paths replaced by an `registerCommand(name, override)` handler. */
-    command_overrides: string[];
-    /**
+/** Known capabilities the registered surfaces exercise (sorted, de-duplicated). */
+capabilities: ExtensionCapability[];
+/** Full command paths declared via `registerCommand`'s definition form. */
+commands: string[];
+/** Built-in command paths replaced by an `registerCommand(name, override)` handler. */
+command_overrides: string[];
+/**
      * Full command paths backed by an extension-provided handler. A superset of
      * {@link ExtensionActivationSummary.commands} that also includes the
      * `<name> import`/`<name> export` paths synthesized for importers/exporters.
      */
-    command_handlers: string[];
-    /** Lifecycle hook kinds with at least one registered hook (canonical order). */
-    hooks: string[];
-    /** Command paths that received extension-registered flags. */
-    flag_commands: string[];
-    /** Custom item-type names registered via `registerItemTypes`. */
-    item_types: string[];
-    /** Custom item-metadata field names registered via `registerItemFields`. */
-    item_fields: string[];
-    /** Custom relationship-kind names registered via `registerRelationshipKinds`. */
-    relationship_kinds?: string[];
-    /** Schema migration ids registered via `registerMigration` (id-less migrations are omitted — they carry no identifier). */
-    migrations: string[];
-    /** Project profile names registered via `registerProfile`. */
-    profiles: string[];
-    /** Importer names registered via `registerImporter`. */
-    importers: string[];
-    /** Exporter names registered via `registerExporter`. */
-    exporters: string[];
-    /** Search-provider names registered via `registerSearchProvider`. */
-    search_providers: string[];
-    /** Vector-store adapter names registered via `registerVectorStoreAdapter`. */
-    vector_store_adapters: string[];
-    /** Assurance provider ids registered via `registerAssuranceMeasurementProvider`. */
-    assurance_providers?: string[];
-    /** Command paths with a parser override registered via `registerParser`. */
-    parser_overrides: string[];
-    /** Built-in service names overridden via `registerService`. */
-    service_overrides: ExtensionServiceName[];
-    /** Output formats with a renderer override registered via `registerRenderer`. */
-    renderer_overrides: OutputRendererFormat[];
-    /** Host-enforced ownership declared by scoped renderers. Omitted when every renderer is global. */
-    renderer_ownership?: Array<{
-        format: OutputRendererFormat;
-        commands: string[];
-        result_discriminator: boolean;
-    }>;
-    /** Count of registered preflight overrides. The surface carries no per-entry identifier, so this is a `number` rather than `string[]` — the only numeric field in the summary. */
-    preflight_overrides: number;
-    /** Command ownership for each registered preflight override. */
-    preflight_ownership: Array<{
-        commands: string[];
-    }>;
+command_handlers: string[];
+/** Lifecycle hook kinds with at least one registered hook (canonical order). */
+hooks: string[];
+/** Command paths that received extension-registered flags. */
+flag_commands: string[];
+/** Custom item-type names registered via `registerItemTypes`. */
+item_types: string[];
+/** Custom item-metadata field names registered via `registerItemFields`. */
+item_fields: string[];
+/** Custom relationship-kind names registered via `registerRelationshipKinds`. */
+relationship_kinds?: string[];
+/** Schema migration ids registered via `registerMigration` (id-less migrations are omitted — they carry no identifier). */
+migrations: string[];
+/** Project profile names registered via `registerProfile`. */
+profiles: string[];
+/** Importer names registered via `registerImporter`. */
+importers: string[];
+/** Exporter names registered via `registerExporter`. */
+exporters: string[];
+/** Search-provider names registered via `registerSearchProvider`. */
+search_providers: string[];
+/** Vector-store adapter names registered via `registerVectorStoreAdapter`. */
+vector_store_adapters: string[];
+/** Assurance provider ids registered via `registerAssuranceMeasurementProvider`. */
+assurance_providers?: string[];
+/** Command paths with a parser override registered via `registerParser`. */
+parser_overrides: string[];
+/** Built-in service names overridden via `registerService`. */
+service_overrides: ExtensionServiceName[];
+/** Output formats with a renderer override registered via `registerRenderer`. */
+renderer_overrides: OutputRendererFormat[];
+/** Host-enforced ownership declared by scoped renderers. Omitted when every renderer is global. */
+renderer_ownership?: Array<{
+format: OutputRendererFormat;
+commands: string[];
+result_discriminator: boolean;
+}>;
+/** Count of registered preflight overrides. The surface carries no per-entry identifier, so this is a `number` rather than `string[]` — the only numeric field in the summary. */
+preflight_overrides: number;
+/** Command ownership for each registered preflight override. */
+preflight_ownership: Array<{
+commands: string[];
+}>;
 }
 /**
  * Options for {@link describeExtensionActivation}.
  */
 export interface DescribeExtensionActivationOptions {
-    /**
+/**
      * Restrict the summary to a single extension by name. Names are matched
      * case-insensitively after trimming, mirroring
      * {@link ./capability-usage.js#collectUsedExtensionCapabilities}. Omit to
      * union across every extension in the activation result.
      */
-    extensionName?: string;
-    /** Restrict the summary to a set of extension names. This supports package aliases that resolve to multiple extensions while keeping the historical single-name option intact. */
-    extensionNames?: readonly string[];
+extensionName?: string;
+/** Restrict the summary to a set of extension names. This supports package aliases that resolve to multiple extensions while keeping the historical single-name option intact. */
+extensionNames?: readonly string[];
 }
 /**
  * Summarize, by name, every registration surface an activation exercised.

package/dist/core/extensions/activation-transaction.d.ts

@@ -5,13 +5,13 @@
  */
 import type { ExtensionCommandRegistry, ExtensionHookRegistry, ExtensionParserRegistry, ExtensionPreflightRegistry, ExtensionRegistrationRegistry, ExtensionRendererRegistry, ExtensionServiceRegistry } from "./extension-types.js";
 interface MutableExtensionActivationState {
-    hooks: ExtensionHookRegistry;
-    commands: ExtensionCommandRegistry;
-    parsers: ExtensionParserRegistry;
-    preflight: ExtensionPreflightRegistry;
-    services: ExtensionServiceRegistry;
-    renderers: ExtensionRendererRegistry;
-    registrations: ExtensionRegistrationRegistry;
+hooks: ExtensionHookRegistry;
+commands: ExtensionCommandRegistry;
+parsers: ExtensionParserRegistry;
+preflight: ExtensionPreflightRegistry;
+services: ExtensionServiceRegistry;
+renderers: ExtensionRendererRegistry;
+registrations: ExtensionRegistrationRegistry;
 }
 /**
  * Return a rollback operation that restores every mutable registry to its