@unbrained/pm-cli 2026.7.19 → 2026.7.20

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

@@ -1,5 +1,5 @@
 import type { GlobalOptions } from "../../core/shared/command-types.js";
-declare const GC_SCOPE_VALUES: readonly ["index", "embeddings", "runtime", "locks", "checkpoints"];
+declare const GC_SCOPE_VALUES: readonly ["index", "embeddings", "runtime", "locks", "checkpoints", "transactions"];
 type GcScope = (typeof GC_SCOPE_VALUES)[number];
 /** Documents the gc command options payload exchanged by command, SDK, and package integrations. */
 export interface GcCommandOptions {
@@ -28,6 +28,17 @@ export interface GcCheckpointsSummary {
     /** Value that configures or reports retention days for this contract. */
     retention_days: number;
 }
+/** Documents the gc transactions summary payload exchanged by command, SDK, and package integrations. */
+export interface GcTransactionsSummary {
+    /** Value that configures or reports scanned for this contract. */
+    scanned: number;
+    /** Value that configures or reports removed for this contract. */
+    removed: number;
+    /** Value that configures or reports retained for this contract. */
+    retained: number;
+    /** Value that configures or reports retention days for this contract. */
+    retention_days: number;
+}
 /** Documents the gc result payload exchanged by command, SDK, and package integrations. */
 export interface GcResult {
     /** Whether the operation completed without a blocking failure. */
@@ -48,6 +59,8 @@ export interface GcResult {
     locks?: GcLocksSummary;
     /** Present only when the checkpoints scope was selected. Summarizes the rollback-checkpoint sweep. */
     checkpoints?: GcCheckpointsSummary;
+    /** Present only when the transactions scope was selected. Summarizes the workspace-transaction journal sweep. */
+    transactions?: GcTransactionsSummary;
     /** ISO 8601 timestamp recording when generated occurred. */
     generated_at: string;
 }

package/dist/sdk/governance/gc.js

@@ -4,10 +4,11 @@
  * Implements the pm gc command surface and its agent-facing runtime behavior.
  */
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="68767a06-5737-53dc-91a4-aa9ef5c8c6a7")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="de71886f-021a-569d-b39a-a2f2818ee3e9")}catch(e){}}();
 import fs from "node:fs/promises";
 import path from "node:path";
 import { runCheckpointGc } from "../../core/checkpoint/checkpoint-gc.js";
+import { runWorkspaceTransactionGc } from "../workspace-transaction-gc.js";
 import { runActiveOnIndexHooks, runActiveOnReadHooks, runActiveOnWriteHooks, } from "../../core/extensions/index.js";
 import { pathExists } from "../../core/fs/fs-utils.js";
 import { runLockGc } from "../../core/lock/lock-gc.js";
@@ -22,6 +23,7 @@ const GC_SCOPE_VALUES = [
     "runtime",
     "locks",
     "checkpoints",
+    "transactions",
 ];
 const GC_TARGETS = [
     {
@@ -171,6 +173,10 @@ function buildGcGuidance(params) {
         params.removed.some((entry) => entry.startsWith("checkpoints/"))) {
         guidance.push('Aged rollback checkpoints were removed; their "pm update-many"/"pm close-many --rollback" windows are no longer recoverable.');
     }
+    if (!params.dryRun &&
+        params.removed.some((entry) => entry.startsWith("transactions/"))) {
+        guidance.push("Aged terminal workspace-transaction journals were removed; replaying those transactionIds re-executes their idempotent steps instead of short-circuiting.");
+    }
     return guidance;
 }
 /** Implements run gc for the public runtime surface of this module. */
@@ -225,6 +231,35 @@ export async function runGc(global, options = {}) {
     // checkpoints/ and removes only rollback checkpoints older than the configured
     // checkpoints.retention_days, retaining active and unparseable files. See
     // core/checkpoint/checkpoint-gc.ts.
+    // The transactions scope sweeps transactions/sdk/ and removes only terminal
+    // (committed/compensated) workspace-transaction journals older than the
+    // shared recovery-receipt retention, retaining in-flight and unparseable
+    // journals. See sdk/workspace-transaction-gc.ts.
+    let transactionsSummary;
+    if (scopes.includes("transactions")) {
+        const retentionDays = settings.checkpoints.retention_days;
+        const transactionResult = await runWorkspaceTransactionGc(pmRoot, {
+            dryRun,
+            retentionDays,
+            hooks: {
+                onRead: (journalPath) => runActiveOnReadHooks({ path: journalPath, scope: "project" }),
+                onWrite: (journalPath) => runActiveOnWriteHooks({
+                    path: journalPath,
+                    scope: "project",
+                    op: "gc:transaction_journal_remove",
+                }),
+            },
+        });
+        removed.push(...transactionResult.removed);
+        retained.push(...transactionResult.retained);
+        warnings.push(...transactionResult.warnings);
+        transactionsSummary = {
+            scanned: transactionResult.scanned,
+            removed: transactionResult.removed.length,
+            retained: transactionResult.retained.length,
+            retention_days: retentionDays,
+        };
+    }
     let checkpointsSummary;
     if (scopes.includes("checkpoints")) {
         const retentionDays = settings.checkpoints.retention_days;
@@ -268,9 +303,10 @@ export async function runGc(global, options = {}) {
         warnings,
         ...(locksSummary ? { locks: locksSummary } : {}),
         ...(checkpointsSummary ? { checkpoints: checkpointsSummary } : {}),
+        ...(transactionsSummary ? { transactions: transactionsSummary } : {}),
         guidance,
         generated_at: nowIso(),
     };
 }
 //# sourceMappingURL=gc.js.map
-//# debugId=68767a06-5737-53dc-91a4-aa9ef5c8c6a7
+//# debugId=de71886f-021a-569d-b39a-a2f2818ee3e9

package/dist/sdk/governance/gc.js.map

@@ -1 +1 @@
-{"version":3,"file":"gc.js","sources":["sdk/governance/gc.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module sdk/governance/gc\n *\n * Implements the pm gc command surface and its agent-facing runtime behavior.\n */\nimport fs from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { runCheckpointGc } from \"../../core/checkpoint/checkpoint-gc.js\";\nimport {\n  runActiveOnIndexHooks,\n  runActiveOnReadHooks,\n  runActiveOnWriteHooks,\n} from \"../../core/extensions/index.js\";\nimport { pathExists } from \"../../core/fs/fs-utils.js\";\nimport { runLockGc } from \"../../core/lock/lock-gc.js\";\nimport { EXIT_CODE } from \"../../core/shared/constants.js\";\nimport type { GlobalOptions } from \"../../core/shared/command-types.js\";\nimport { PmCliError } from \"../../core/shared/errors.js\";\nimport { nowIso } from \"../../core/shared/time.js\";\nimport { getSettingsPath, resolvePmRoot } from \"../../core/store/paths.js\";\nimport { readSettings } from \"../../core/store/settings.js\";\n\nconst GC_SCOPE_VALUES = [\n  \"index\",\n  \"embeddings\",\n  \"runtime\",\n  \"locks\",\n  \"checkpoints\",\n] as const;\ntype GcScope = (typeof GC_SCOPE_VALUES)[number];\n\ninterface GcTarget {\n  scope: GcScope;\n  relativePath: string;\n  kind: \"file\" | \"directory\";\n}\n\nconst GC_TARGETS: readonly GcTarget[] = [\n  {\n    scope: \"index\",\n    relativePath: \"index/manifest.json\",\n    kind: \"file\",\n  },\n  {\n    scope: \"embeddings\",\n    relativePath: \"search/embeddings.jsonl\",\n    kind: \"file\",\n  },\n  {\n    scope: \"embeddings\",\n    relativePath: \"search/vectorization-status.json\",\n    kind: \"file\",\n  },\n  {\n    scope: \"embeddings\",\n    relativePath: \"search/lancedb\",\n    kind: \"directory\",\n  },\n  {\n    // Removing embeddings invalidates the whole semantic index, so the queued\n    // background-refresh work is also meaningless: a worker draining a stale\n    // queue against an empty ledger would rebuild a partial, inconsistent index\n    // (only the queued items vectorized). Clear the queue and its gate so the\n    // next mutation re-seeds from a clean slate. See core/search/background-refresh.ts.\n    scope: \"embeddings\",\n    relativePath: \"search/pending-refresh.json\",\n    kind: \"file\",\n  },\n  {\n    scope: \"embeddings\",\n    relativePath: \"search/pending-refresh.gate.lock\",\n    kind: \"directory\",\n  },\n  {\n    scope: \"runtime\",\n    relativePath: \"runtime/test-runs\",\n    kind: \"directory\",\n  },\n  {\n    scope: \"runtime\",\n    relativePath: \"runtime/history-drift-cache.json\",\n    kind: \"file\",\n  },\n] as const;\n\n/** Documents the gc command options payload exchanged by command, SDK, and package integrations. */\nexport interface GcCommandOptions {\n  /** Value that configures or reports dry run for this contract. */\n  dryRun?: boolean;\n  /** Value that configures or reports scope for this contract. */\n  scope?: string[];\n}\n\n/** Documents the gc locks summary payload exchanged by command, SDK, and package integrations. */\nexport interface GcLocksSummary {\n  /** Value that configures or reports scanned for this contract. */\n  scanned: number;\n  /** Value that configures or reports removed for this contract. */\n  removed: number;\n  /** Value that configures or reports retained for this contract. */\n  retained: number;\n}\n\n/** Documents the gc checkpoints summary payload exchanged by command, SDK, and package integrations. */\nexport interface GcCheckpointsSummary {\n  /** Value that configures or reports scanned for this contract. */\n  scanned: number;\n  /** Value that configures or reports removed for this contract. */\n  removed: number;\n  /** Value that configures or reports retained for this contract. */\n  retained: number;\n  /** Value that configures or reports retention days for this contract. */\n  retention_days: number;\n}\n\n/** Documents the gc result payload exchanged by command, SDK, and package integrations. */\nexport interface GcResult {\n  /** Whether the operation completed without a blocking failure. */\n  ok: boolean;\n  /** Value that configures or reports dry run for this contract. */\n  dry_run: boolean;\n  /** Value that configures or reports scope for this contract. */\n  scope: GcScope[];\n  /** Value that configures or reports removed for this contract. */\n  removed: string[];\n  /** Value that configures or reports retained for this contract. */\n  retained: string[];\n  /** Value that configures or reports warnings for this contract. */\n  warnings: string[];\n  /** Value that configures or reports guidance for this contract. */\n  guidance: string[];\n  /** Present only when the locks scope was selected. Summarizes the stale-lock sweep. */\n  locks?: GcLocksSummary;\n  /** Present only when the checkpoints scope was selected. Summarizes the rollback-checkpoint sweep. */\n  checkpoints?: GcCheckpointsSummary;\n  /** ISO 8601 timestamp recording when generated occurred. */\n  generated_at: string;\n}\n\nfunction isErrno(error: unknown, code: string): boolean {\n  return (\n    typeof error === \"object\" &&\n    error !== null &&\n    \"code\" in error &&\n    (error as { code?: string }).code === code\n  );\n}\n\nasync function removeCacheFile(\n  pmRoot: string,\n  target: GcTarget,\n  dryRun: boolean,\n): Promise<{ removed: boolean; warnings: string[] }> {\n  const relativePath = target.relativePath;\n  const absolutePath = path.join(pmRoot, relativePath);\n  const warnings = await runActiveOnReadHooks({\n    path: absolutePath,\n    scope: \"project\",\n  });\n  try {\n    const stats = await fs.stat(absolutePath);\n    if (target.kind === \"file\" && !stats.isFile()) {\n      return {\n        removed: false,\n        warnings: [...warnings, `not_a_file:${relativePath}`],\n      };\n    }\n    if (target.kind === \"directory\" && !stats.isDirectory()) {\n      return {\n        removed: false,\n        warnings: [...warnings, `not_a_directory:${relativePath}`],\n      };\n    }\n    if (dryRun) {\n      return {\n        removed: true,\n        warnings,\n      };\n    }\n    if (target.kind === \"file\") {\n      await fs.unlink(absolutePath);\n    } else {\n      await fs.rm(absolutePath, { recursive: true, force: true });\n    }\n    const writeWarnings = await runActiveOnWriteHooks({\n      path: absolutePath,\n      scope: \"project\",\n      op: \"gc:remove\",\n    });\n    return {\n      removed: true,\n      warnings: [...warnings, ...writeWarnings],\n    };\n  } catch (error: unknown) {\n    if (isErrno(error, \"ENOENT\")) {\n      return {\n        removed: false,\n        warnings,\n      };\n    }\n    throw error;\n  }\n}\n\nfunction parseScopes(raw: string[] | undefined): GcScope[] {\n  if (!raw || raw.length === 0) {\n    return [...GC_SCOPE_VALUES];\n  }\n  const tokens = raw\n    .flatMap((entry) => entry.split(\",\"))\n    .map((entry) => entry.trim().toLowerCase())\n    .filter((entry) => entry.length > 0);\n  if (tokens.length === 0) {\n    throw new PmCliError(\n      `--scope requires at least one value (${GC_SCOPE_VALUES.join(\",\")})`,\n      EXIT_CODE.USAGE,\n    );\n  }\n  const resolved = new Set<GcScope>();\n  for (const token of tokens) {\n    if (!(GC_SCOPE_VALUES as readonly string[]).includes(token)) {\n      throw new PmCliError(\n        `Invalid --scope value \"${token}\". Expected one or more of: ${GC_SCOPE_VALUES.join(\", \")}`,\n        EXIT_CODE.USAGE,\n      );\n    }\n    resolved.add(token as GcScope);\n  }\n  return GC_SCOPE_VALUES.filter((scope) => resolved.has(scope));\n}\n\nfunction buildGcGuidance(params: {\n  dryRun: boolean;\n  scopes: GcScope[];\n  removed: string[];\n}): string[] {\n  const guidance: string[] = [];\n  if (params.dryRun) {\n    guidance.push(\"Dry-run preview only: no cache artifacts were deleted.\");\n  }\n  const searchScopeSelected =\n    params.scopes.includes(\"index\") || params.scopes.includes(\"embeddings\");\n  const searchArtifactsAffected = params.removed.some(\n    (entry) =>\n      entry === \"index/manifest.json\" ||\n      entry === \"search/embeddings.jsonl\" ||\n      entry === \"search/vectorization-status.json\" ||\n      entry === \"search/lancedb\" ||\n      entry === \"search/pending-refresh.json\" ||\n      entry === \"search/pending-refresh.gate.lock\",\n  );\n  if (searchScopeSelected && searchArtifactsAffected) {\n    guidance.push(\n      'Search artifacts were removed; the semantic index (including any queued background refresh) is invalidated. Run \"pm install search-advanced --project\" if reindex is unavailable, then \"pm reindex --mode keyword\" (and \"--mode semantic\" when semantic search is enabled) before search-heavy workflows.',\n    );\n  }\n  if (params.removed.includes(\"runtime/history-drift-cache.json\")) {\n    guidance.push(\n      'History drift cache was removed; the next \"pm health\" run performs a full history-drift re-scan.',\n    );\n  }\n  if (\n    !params.dryRun &&\n    params.removed.some((entry) => entry.startsWith(\"checkpoints/\"))\n  ) {\n    guidance.push(\n      'Aged rollback checkpoints were removed; their \"pm update-many\"/\"pm close-many --rollback\" windows are no longer recoverable.',\n    );\n  }\n  return guidance;\n}\n\n/** Implements run gc for the public runtime surface of this module. */\nexport async function runGc(\n  global: GlobalOptions,\n  options: GcCommandOptions = {},\n): Promise<GcResult> {\n  const pmRoot = resolvePmRoot(process.cwd(), global.path);\n  if (!(await pathExists(getSettingsPath(pmRoot)))) {\n    throw new PmCliError(\n      `Tracker is not initialized at ${pmRoot}. Run pm init first.`,\n      EXIT_CODE.NOT_FOUND,\n    );\n  }\n\n  const settings = await readSettings(pmRoot);\n  const dryRun = options.dryRun === true;\n  const scopes = parseScopes(options.scope);\n  const selectedTargets = GC_TARGETS.filter((target) =>\n    scopes.includes(target.scope),\n  );\n\n  const removed: string[] = [];\n  const retained: string[] = [];\n  const warnings: string[] = [];\n\n  for (const target of selectedTargets) {\n    const result = await removeCacheFile(pmRoot, target, dryRun);\n    if (result.removed) {\n      removed.push(target.relativePath);\n    } else {\n      retained.push(target.relativePath);\n    }\n    warnings.push(...result.warnings);\n  }\n\n  // The locks scope is not a path-based GC_TARGET: it sweeps the locks/ directory\n  // and removes only locks whose own embedded ttl has expired (crashed-process\n  // debris), retaining active and unparseable locks. See core/lock/lock-gc.ts.\n  let locksSummary: GcLocksSummary | undefined;\n  if (scopes.includes(\"locks\")) {\n    const lockResult = await runLockGc(pmRoot, {\n      dryRun,\n      hooks: {\n        onRead: (lockPath) =>\n          runActiveOnReadHooks({ path: lockPath, scope: \"project\" }),\n        onWrite: (lockPath) =>\n          runActiveOnWriteHooks({\n            path: lockPath,\n            scope: \"project\",\n            op: \"gc:lock_remove\",\n          }),\n      },\n    });\n    removed.push(...lockResult.removed);\n    retained.push(...lockResult.retained);\n    warnings.push(...lockResult.warnings);\n    locksSummary = {\n      scanned: lockResult.scanned,\n      removed: lockResult.removed.length,\n      retained: lockResult.retained.length,\n    };\n  }\n\n  // The checkpoints scope is also not a path-based GC_TARGET: it sweeps\n  // checkpoints/ and removes only rollback checkpoints older than the configured\n  // checkpoints.retention_days, retaining active and unparseable files. See\n  // core/checkpoint/checkpoint-gc.ts.\n  let checkpointsSummary: GcCheckpointsSummary | undefined;\n  if (scopes.includes(\"checkpoints\")) {\n    const retentionDays = settings.checkpoints.retention_days;\n    const checkpointResult = await runCheckpointGc(pmRoot, {\n      dryRun,\n      retentionDays,\n      hooks: {\n        onRead: (checkpointPath) =>\n          runActiveOnReadHooks({ path: checkpointPath, scope: \"project\" }),\n        onWrite: (checkpointPath) =>\n          runActiveOnWriteHooks({\n            path: checkpointPath,\n            scope: \"project\",\n            op: \"gc:checkpoint_remove\",\n          }),\n      },\n    });\n    removed.push(...checkpointResult.removed);\n    retained.push(...checkpointResult.retained);\n    warnings.push(...checkpointResult.warnings);\n    checkpointsSummary = {\n      scanned: checkpointResult.scanned,\n      removed: checkpointResult.removed.length,\n      retained: checkpointResult.retained.length,\n      retention_days: retentionDays,\n    };\n  }\n\n  warnings.push(\n    ...(await runActiveOnIndexHooks({\n      mode: dryRun ? \"gc:dry-run\" : \"gc\",\n      total_items: selectedTargets.length,\n    })),\n  );\n  const guidance = buildGcGuidance({\n    dryRun,\n    scopes,\n    removed,\n  });\n\n  return {\n    ok: warnings.length === 0,\n    dry_run: dryRun,\n    scope: scopes,\n    removed,\n    retained,\n    warnings,\n    ...(locksSummary ? { locks: locksSummary } : {}),\n    ...(checkpointsSummary ? { checkpoints: checkpointsSummary } : {}),\n    guidance,\n    generated_at: nowIso(),\n  };\n}\n"],"names":[],"mappings":"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","debugId":"68767a06-5737-53dc-91a4-aa9ef5c8c6a7"}
+{"version":3,"file":"gc.js","sources":["sdk/governance/gc.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module sdk/governance/gc\n *\n * Implements the pm gc command surface and its agent-facing runtime behavior.\n */\nimport fs from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { runCheckpointGc } from \"../../core/checkpoint/checkpoint-gc.js\";\nimport { runWorkspaceTransactionGc } from \"../workspace-transaction-gc.js\";\nimport {\n  runActiveOnIndexHooks,\n  runActiveOnReadHooks,\n  runActiveOnWriteHooks,\n} from \"../../core/extensions/index.js\";\nimport { pathExists } from \"../../core/fs/fs-utils.js\";\nimport { runLockGc } from \"../../core/lock/lock-gc.js\";\nimport { EXIT_CODE } from \"../../core/shared/constants.js\";\nimport type { GlobalOptions } from \"../../core/shared/command-types.js\";\nimport { PmCliError } from \"../../core/shared/errors.js\";\nimport { nowIso } from \"../../core/shared/time.js\";\nimport { getSettingsPath, resolvePmRoot } from \"../../core/store/paths.js\";\nimport { readSettings } from \"../../core/store/settings.js\";\n\nconst GC_SCOPE_VALUES = [\n  \"index\",\n  \"embeddings\",\n  \"runtime\",\n  \"locks\",\n  \"checkpoints\",\n  \"transactions\",\n] as const;\ntype GcScope = (typeof GC_SCOPE_VALUES)[number];\n\ninterface GcTarget {\n  scope: GcScope;\n  relativePath: string;\n  kind: \"file\" | \"directory\";\n}\n\nconst GC_TARGETS: readonly GcTarget[] = [\n  {\n    scope: \"index\",\n    relativePath: \"index/manifest.json\",\n    kind: \"file\",\n  },\n  {\n    scope: \"embeddings\",\n    relativePath: \"search/embeddings.jsonl\",\n    kind: \"file\",\n  },\n  {\n    scope: \"embeddings\",\n    relativePath: \"search/vectorization-status.json\",\n    kind: \"file\",\n  },\n  {\n    scope: \"embeddings\",\n    relativePath: \"search/lancedb\",\n    kind: \"directory\",\n  },\n  {\n    // Removing embeddings invalidates the whole semantic index, so the queued\n    // background-refresh work is also meaningless: a worker draining a stale\n    // queue against an empty ledger would rebuild a partial, inconsistent index\n    // (only the queued items vectorized). Clear the queue and its gate so the\n    // next mutation re-seeds from a clean slate. See core/search/background-refresh.ts.\n    scope: \"embeddings\",\n    relativePath: \"search/pending-refresh.json\",\n    kind: \"file\",\n  },\n  {\n    scope: \"embeddings\",\n    relativePath: \"search/pending-refresh.gate.lock\",\n    kind: \"directory\",\n  },\n  {\n    scope: \"runtime\",\n    relativePath: \"runtime/test-runs\",\n    kind: \"directory\",\n  },\n  {\n    scope: \"runtime\",\n    relativePath: \"runtime/history-drift-cache.json\",\n    kind: \"file\",\n  },\n] as const;\n\n/** Documents the gc command options payload exchanged by command, SDK, and package integrations. */\nexport interface GcCommandOptions {\n  /** Value that configures or reports dry run for this contract. */\n  dryRun?: boolean;\n  /** Value that configures or reports scope for this contract. */\n  scope?: string[];\n}\n\n/** Documents the gc locks summary payload exchanged by command, SDK, and package integrations. */\nexport interface GcLocksSummary {\n  /** Value that configures or reports scanned for this contract. */\n  scanned: number;\n  /** Value that configures or reports removed for this contract. */\n  removed: number;\n  /** Value that configures or reports retained for this contract. */\n  retained: number;\n}\n\n/** Documents the gc checkpoints summary payload exchanged by command, SDK, and package integrations. */\nexport interface GcCheckpointsSummary {\n  /** Value that configures or reports scanned for this contract. */\n  scanned: number;\n  /** Value that configures or reports removed for this contract. */\n  removed: number;\n  /** Value that configures or reports retained for this contract. */\n  retained: number;\n  /** Value that configures or reports retention days for this contract. */\n  retention_days: number;\n}\n\n/** Documents the gc transactions summary payload exchanged by command, SDK, and package integrations. */\nexport interface GcTransactionsSummary {\n  /** Value that configures or reports scanned for this contract. */\n  scanned: number;\n  /** Value that configures or reports removed for this contract. */\n  removed: number;\n  /** Value that configures or reports retained for this contract. */\n  retained: number;\n  /** Value that configures or reports retention days for this contract. */\n  retention_days: number;\n}\n\n/** Documents the gc result payload exchanged by command, SDK, and package integrations. */\nexport interface GcResult {\n  /** Whether the operation completed without a blocking failure. */\n  ok: boolean;\n  /** Value that configures or reports dry run for this contract. */\n  dry_run: boolean;\n  /** Value that configures or reports scope for this contract. */\n  scope: GcScope[];\n  /** Value that configures or reports removed for this contract. */\n  removed: string[];\n  /** Value that configures or reports retained for this contract. */\n  retained: string[];\n  /** Value that configures or reports warnings for this contract. */\n  warnings: string[];\n  /** Value that configures or reports guidance for this contract. */\n  guidance: string[];\n  /** Present only when the locks scope was selected. Summarizes the stale-lock sweep. */\n  locks?: GcLocksSummary;\n  /** Present only when the checkpoints scope was selected. Summarizes the rollback-checkpoint sweep. */\n  checkpoints?: GcCheckpointsSummary;\n  /** Present only when the transactions scope was selected. Summarizes the workspace-transaction journal sweep. */\n  transactions?: GcTransactionsSummary;\n  /** ISO 8601 timestamp recording when generated occurred. */\n  generated_at: string;\n}\n\nfunction isErrno(error: unknown, code: string): boolean {\n  return (\n    typeof error === \"object\" &&\n    error !== null &&\n    \"code\" in error &&\n    (error as { code?: string }).code === code\n  );\n}\n\nasync function removeCacheFile(\n  pmRoot: string,\n  target: GcTarget,\n  dryRun: boolean,\n): Promise<{ removed: boolean; warnings: string[] }> {\n  const relativePath = target.relativePath;\n  const absolutePath = path.join(pmRoot, relativePath);\n  const warnings = await runActiveOnReadHooks({\n    path: absolutePath,\n    scope: \"project\",\n  });\n  try {\n    const stats = await fs.stat(absolutePath);\n    if (target.kind === \"file\" && !stats.isFile()) {\n      return {\n        removed: false,\n        warnings: [...warnings, `not_a_file:${relativePath}`],\n      };\n    }\n    if (target.kind === \"directory\" && !stats.isDirectory()) {\n      return {\n        removed: false,\n        warnings: [...warnings, `not_a_directory:${relativePath}`],\n      };\n    }\n    if (dryRun) {\n      return {\n        removed: true,\n        warnings,\n      };\n    }\n    if (target.kind === \"file\") {\n      await fs.unlink(absolutePath);\n    } else {\n      await fs.rm(absolutePath, { recursive: true, force: true });\n    }\n    const writeWarnings = await runActiveOnWriteHooks({\n      path: absolutePath,\n      scope: \"project\",\n      op: \"gc:remove\",\n    });\n    return {\n      removed: true,\n      warnings: [...warnings, ...writeWarnings],\n    };\n  } catch (error: unknown) {\n    if (isErrno(error, \"ENOENT\")) {\n      return {\n        removed: false,\n        warnings,\n      };\n    }\n    throw error;\n  }\n}\n\nfunction parseScopes(raw: string[] | undefined): GcScope[] {\n  if (!raw || raw.length === 0) {\n    return [...GC_SCOPE_VALUES];\n  }\n  const tokens = raw\n    .flatMap((entry) => entry.split(\",\"))\n    .map((entry) => entry.trim().toLowerCase())\n    .filter((entry) => entry.length > 0);\n  if (tokens.length === 0) {\n    throw new PmCliError(\n      `--scope requires at least one value (${GC_SCOPE_VALUES.join(\",\")})`,\n      EXIT_CODE.USAGE,\n    );\n  }\n  const resolved = new Set<GcScope>();\n  for (const token of tokens) {\n    if (!(GC_SCOPE_VALUES as readonly string[]).includes(token)) {\n      throw new PmCliError(\n        `Invalid --scope value \"${token}\". Expected one or more of: ${GC_SCOPE_VALUES.join(\", \")}`,\n        EXIT_CODE.USAGE,\n      );\n    }\n    resolved.add(token as GcScope);\n  }\n  return GC_SCOPE_VALUES.filter((scope) => resolved.has(scope));\n}\n\nfunction buildGcGuidance(params: {\n  dryRun: boolean;\n  scopes: GcScope[];\n  removed: string[];\n}): string[] {\n  const guidance: string[] = [];\n  if (params.dryRun) {\n    guidance.push(\"Dry-run preview only: no cache artifacts were deleted.\");\n  }\n  const searchScopeSelected =\n    params.scopes.includes(\"index\") || params.scopes.includes(\"embeddings\");\n  const searchArtifactsAffected = params.removed.some(\n    (entry) =>\n      entry === \"index/manifest.json\" ||\n      entry === \"search/embeddings.jsonl\" ||\n      entry === \"search/vectorization-status.json\" ||\n      entry === \"search/lancedb\" ||\n      entry === \"search/pending-refresh.json\" ||\n      entry === \"search/pending-refresh.gate.lock\",\n  );\n  if (searchScopeSelected && searchArtifactsAffected) {\n    guidance.push(\n      'Search artifacts were removed; the semantic index (including any queued background refresh) is invalidated. Run \"pm install search-advanced --project\" if reindex is unavailable, then \"pm reindex --mode keyword\" (and \"--mode semantic\" when semantic search is enabled) before search-heavy workflows.',\n    );\n  }\n  if (params.removed.includes(\"runtime/history-drift-cache.json\")) {\n    guidance.push(\n      'History drift cache was removed; the next \"pm health\" run performs a full history-drift re-scan.',\n    );\n  }\n  if (\n    !params.dryRun &&\n    params.removed.some((entry) => entry.startsWith(\"checkpoints/\"))\n  ) {\n    guidance.push(\n      'Aged rollback checkpoints were removed; their \"pm update-many\"/\"pm close-many --rollback\" windows are no longer recoverable.',\n    );\n  }\n  if (\n    !params.dryRun &&\n    params.removed.some((entry) => entry.startsWith(\"transactions/\"))\n  ) {\n    guidance.push(\n      \"Aged terminal workspace-transaction journals were removed; replaying those transactionIds re-executes their idempotent steps instead of short-circuiting.\",\n    );\n  }\n  return guidance;\n}\n\n/** Implements run gc for the public runtime surface of this module. */\nexport async function runGc(\n  global: GlobalOptions,\n  options: GcCommandOptions = {},\n): Promise<GcResult> {\n  const pmRoot = resolvePmRoot(process.cwd(), global.path);\n  if (!(await pathExists(getSettingsPath(pmRoot)))) {\n    throw new PmCliError(\n      `Tracker is not initialized at ${pmRoot}. Run pm init first.`,\n      EXIT_CODE.NOT_FOUND,\n    );\n  }\n\n  const settings = await readSettings(pmRoot);\n  const dryRun = options.dryRun === true;\n  const scopes = parseScopes(options.scope);\n  const selectedTargets = GC_TARGETS.filter((target) =>\n    scopes.includes(target.scope),\n  );\n\n  const removed: string[] = [];\n  const retained: string[] = [];\n  const warnings: string[] = [];\n\n  for (const target of selectedTargets) {\n    const result = await removeCacheFile(pmRoot, target, dryRun);\n    if (result.removed) {\n      removed.push(target.relativePath);\n    } else {\n      retained.push(target.relativePath);\n    }\n    warnings.push(...result.warnings);\n  }\n\n  // The locks scope is not a path-based GC_TARGET: it sweeps the locks/ directory\n  // and removes only locks whose own embedded ttl has expired (crashed-process\n  // debris), retaining active and unparseable locks. See core/lock/lock-gc.ts.\n  let locksSummary: GcLocksSummary | undefined;\n  if (scopes.includes(\"locks\")) {\n    const lockResult = await runLockGc(pmRoot, {\n      dryRun,\n      hooks: {\n        onRead: (lockPath) =>\n          runActiveOnReadHooks({ path: lockPath, scope: \"project\" }),\n        onWrite: (lockPath) =>\n          runActiveOnWriteHooks({\n            path: lockPath,\n            scope: \"project\",\n            op: \"gc:lock_remove\",\n          }),\n      },\n    });\n    removed.push(...lockResult.removed);\n    retained.push(...lockResult.retained);\n    warnings.push(...lockResult.warnings);\n    locksSummary = {\n      scanned: lockResult.scanned,\n      removed: lockResult.removed.length,\n      retained: lockResult.retained.length,\n    };\n  }\n\n  // The checkpoints scope is also not a path-based GC_TARGET: it sweeps\n  // checkpoints/ and removes only rollback checkpoints older than the configured\n  // checkpoints.retention_days, retaining active and unparseable files. See\n  // core/checkpoint/checkpoint-gc.ts.\n  // The transactions scope sweeps transactions/sdk/ and removes only terminal\n  // (committed/compensated) workspace-transaction journals older than the\n  // shared recovery-receipt retention, retaining in-flight and unparseable\n  // journals. See sdk/workspace-transaction-gc.ts.\n  let transactionsSummary: GcTransactionsSummary | undefined;\n  if (scopes.includes(\"transactions\")) {\n    const retentionDays = settings.checkpoints.retention_days;\n    const transactionResult = await runWorkspaceTransactionGc(pmRoot, {\n      dryRun,\n      retentionDays,\n      hooks: {\n        onRead: (journalPath) =>\n          runActiveOnReadHooks({ path: journalPath, scope: \"project\" }),\n        onWrite: (journalPath) =>\n          runActiveOnWriteHooks({\n            path: journalPath,\n            scope: \"project\",\n            op: \"gc:transaction_journal_remove\",\n          }),\n      },\n    });\n    removed.push(...transactionResult.removed);\n    retained.push(...transactionResult.retained);\n    warnings.push(...transactionResult.warnings);\n    transactionsSummary = {\n      scanned: transactionResult.scanned,\n      removed: transactionResult.removed.length,\n      retained: transactionResult.retained.length,\n      retention_days: retentionDays,\n    };\n  }\n\n  let checkpointsSummary: GcCheckpointsSummary | undefined;\n  if (scopes.includes(\"checkpoints\")) {\n    const retentionDays = settings.checkpoints.retention_days;\n    const checkpointResult = await runCheckpointGc(pmRoot, {\n      dryRun,\n      retentionDays,\n      hooks: {\n        onRead: (checkpointPath) =>\n          runActiveOnReadHooks({ path: checkpointPath, scope: \"project\" }),\n        onWrite: (checkpointPath) =>\n          runActiveOnWriteHooks({\n            path: checkpointPath,\n            scope: \"project\",\n            op: \"gc:checkpoint_remove\",\n          }),\n      },\n    });\n    removed.push(...checkpointResult.removed);\n    retained.push(...checkpointResult.retained);\n    warnings.push(...checkpointResult.warnings);\n    checkpointsSummary = {\n      scanned: checkpointResult.scanned,\n      removed: checkpointResult.removed.length,\n      retained: checkpointResult.retained.length,\n      retention_days: retentionDays,\n    };\n  }\n\n  warnings.push(\n    ...(await runActiveOnIndexHooks({\n      mode: dryRun ? \"gc:dry-run\" : \"gc\",\n      total_items: selectedTargets.length,\n    })),\n  );\n  const guidance = buildGcGuidance({\n    dryRun,\n    scopes,\n    removed,\n  });\n\n  return {\n    ok: warnings.length === 0,\n    dry_run: dryRun,\n    scope: scopes,\n    removed,\n    retained,\n    warnings,\n    ...(locksSummary ? { locks: locksSummary } : {}),\n    ...(checkpointsSummary ? { checkpoints: checkpointsSummary } : {}),\n    ...(transactionsSummary ? { transactions: transactionsSummary } : {}),\n    guidance,\n    generated_at: nowIso(),\n  };\n}\n"],"names":[],"mappings":"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","debugId":"de71886f-021a-569d-b39a-a2f2818ee3e9"}

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

@@ -0,0 +1,84 @@
+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;
+}
+/** 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;
+}
+/** 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;
+}
+/** 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[];
+}
+/** 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;
+}
+/** 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 containing 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[];
+}
+/**
+ * Scan tracker storage for integrity failures the ordinary read path masks.
+ * `parsedItemIds` are the ids the standard cached list scan successfully
+ * parsed; any on-disk item file whose id is missing from that set is an
+ * unreadable document that `pm get` would hard-error on while list-based
+ * commands silently skip it.
+ */
+export declare function scanStorageIntegrity(pmRoot: string, parsedItemIds: ReadonlySet<string>, typeToFolder: Record<string, string>, itemParseOptions?: StorageIntegrityItemParseOptions): Promise<StorageIntegrityScanResult>;

package/dist/sdk/governance/storage-integrity.js

@@ -0,0 +1,240 @@
+/**
+ * @module sdk/governance/storage-integrity
+ *
+ * Post-merge storage-integrity check for `pm validate`: fails the workspace
+ * when tracker storage is provably corrupted in ways the ordinary read path
+ * silently tolerates — unparseable item documents (skipped by the list scan),
+ * history streams containing unresolved merge-conflict markers, deleted items
+ * silently resurrected by a delete/modify merge, and configuration or schema
+ * files whose parse failure would otherwise fall back to defaults behind a
+ * green gate. This is the detection half of the tracker merge-semantics
+ * contract; the merge drivers in `sdk/merge` are the prevention half.
+ */
+
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="99fdc5e7-d08b-54a7-8169-1385c91f8ed6")}catch(e){}}();
+import fs from "node:fs/promises";
+import path from "node:path";
+import { readFileIfExists } from "../../core/fs/fs-utils.js";
+import { parseItemDocument, } from "../../core/item/item-format.js";
+import { findFirstMergeConflictMarker } from "../../core/shared/conflict-markers.js";
+import { getSettingsPath, ITEM_FILE_EXTENSIONS, } from "../../core/store/paths.js";
+async function listItemFilesOnDisk(pmRoot, typeToFolder) {
+    const folders = [...new Set(Object.values(typeToFolder))];
+    const found = [];
+    await Promise.all(folders.map(async (folder) => {
+        let entries;
+        try {
+            entries = await fs.readdir(path.join(pmRoot, folder));
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            for (const extension of ITEM_FILE_EXTENSIONS) {
+                if (entry.toLowerCase().endsWith(extension)) {
+                    found.push({
+                        relativePath: `${folder}/${entry}`,
+                        id: entry.slice(0, -extension.length),
+                    });
+                    break;
+                }
+            }
+        }
+    }));
+    return found.sort((left, right) => left.relativePath.localeCompare(right.relativePath));
+}
+function scanHistoryStreamContent(accumulator, raw) {
+    const { id, relativePath, liveItemIds, out } = accumulator;
+    out.scanned += 1;
+    const conflictMarker = findFirstMergeConflictMarker(raw);
+    if (conflictMarker) {
+        out.conflictMarkers.push({
+            id,
+            path: relativePath,
+            line: conflictMarker.line,
+            detail: `unresolved merge conflict marker ${conflictMarker.marker}`,
+        });
+        return;
+    }
+    let latestEntry = null;
+    const lines = raw
+        .split(/\r?\n/)
+        .map((line, index) => ({ content: line.trim(), number: index + 1 }))
+        .filter((line) => line.content.length > 0);
+    for (const line of lines) {
+        try {
+            const parsed = JSON.parse(line.content);
+            if (typeof parsed !== "object" ||
+                parsed === null ||
+                Array.isArray(parsed)) {
+                throw new TypeError("history entry must be an object");
+            }
+            latestEntry = parsed;
+        }
+        catch {
+            out.unparseable.push({
+                id,
+                path: relativePath,
+                line: line.number,
+                detail: "history line is not a valid JSON object",
+            });
+            return;
+        }
+    }
+    if (latestEntry === null) {
+        return;
+    }
+    if (latestEntry.op === "delete" && liveItemIds.has(id)) {
+        out.resurrected.push({
+            id,
+            deleted_at: typeof latestEntry.ts === "string" ? latestEntry.ts : "",
+            deleted_by: typeof latestEntry.author === "string" ? latestEntry.author : "",
+        });
+    }
+    if (latestEntry.op === "history_repair" &&
+        Array.isArray(latestEntry.patch) &&
+        latestEntry.patch.length > 0) {
+        out.repairReconciliations += 1;
+    }
+}
+async function scanHistoryStreams(pmRoot, liveItemIds) {
+    const out = {
+        conflictMarkers: [],
+        unparseable: [],
+        resurrected: [],
+        repairReconciliations: 0,
+        scanned: 0,
+    };
+    let entries;
+    try {
+        entries = await fs.readdir(path.join(pmRoot, "history"));
+    }
+    catch {
+        return out;
+    }
+    for (const entry of entries.sort((left, right) => left.localeCompare(right))) {
+        if (!entry.endsWith(".jsonl")) {
+            continue;
+        }
+        const raw = await fs.readFile(path.join(pmRoot, "history", entry), "utf8");
+        scanHistoryStreamContent({
+            id: entry.slice(0, -".jsonl".length),
+            relativePath: `history/${entry}`,
+            liveItemIds,
+            out,
+        }, raw);
+    }
+    return out;
+}
+function describeUnparseableJson(raw) {
+    const conflictMarker = findFirstMergeConflictMarker(raw);
+    if (conflictMarker) {
+        return `unresolved merge conflict marker ${conflictMarker.marker} at line ${conflictMarker.line}`;
+    }
+    try {
+        JSON.parse(raw);
+        return null;
+    }
+    catch (error) {
+        return `invalid JSON (${String(error)})`;
+    }
+}
+async function scanConfigFiles(pmRoot) {
+    const unparseable = [];
+    let scanned = 0;
+    const settingsRaw = await readFileIfExists(getSettingsPath(pmRoot));
+    if (settingsRaw !== null) {
+        scanned += 1;
+        const detail = describeUnparseableJson(settingsRaw);
+        if (detail !== null) {
+            unparseable.push({ path: "settings.json", detail });
+        }
+    }
+    let schemaEntries;
+    try {
+        schemaEntries = await fs.readdir(path.join(pmRoot, "schema"));
+    }
+    catch {
+        return { scanned, unparseable };
+    }
+    for (const entry of schemaEntries.sort((left, right) => left.localeCompare(right))) {
+        if (!entry.endsWith(".json")) {
+            continue;
+        }
+        const raw = await fs.readFile(path.join(pmRoot, "schema", entry), "utf8");
+        scanned += 1;
+        const detail = describeUnparseableJson(raw);
+        if (detail !== null) {
+            unparseable.push({ path: `schema/${entry}`, detail });
+        }
+    }
+    return { scanned, unparseable };
+}
+/**
+ * Scan tracker storage for integrity failures the ordinary read path masks.
+ * `parsedItemIds` are the ids the standard cached list scan successfully
+ * parsed; any on-disk item file whose id is missing from that set is an
+ * unreadable document that `pm get` would hard-error on while list-based
+ * commands silently skip it.
+ */
+export async function scanStorageIntegrity(pmRoot, parsedItemIds, typeToFolder, itemParseOptions = {}) {
+    const itemFiles = await listItemFilesOnDisk(pmRoot, typeToFolder);
+    const idsOnDisk = new Set(itemFiles.map((file) => file.id));
+    const pathsById = new Map();
+    for (const file of itemFiles) {
+        const paths = pathsById.get(file.id);
+        if (paths === undefined) {
+            pathsById.set(file.id, [file.relativePath]);
+        }
+        else {
+            paths.push(file.relativePath);
+        }
+    }
+    const duplicateItemIds = [...pathsById.entries()]
+        .filter(([, paths]) => paths.length > 1)
+        .map(([id, paths]) => ({
+        id,
+        paths: [...paths].sort((left, right) => left.localeCompare(right)),
+    }))
+        .sort((left, right) => left.id.localeCompare(right.id));
+    const unreadableItemFiles = (await Promise.all(itemFiles.map(async (file) => {
+        if (!parsedItemIds.has(file.id)) {
+            return { path: file.relativePath, id: file.id };
+        }
+        try {
+            const absolutePath = path.join(pmRoot, file.relativePath);
+            parseItemDocument(await fs.readFile(absolutePath, "utf8"), {
+                format: absolutePath.toLowerCase().endsWith(".md")
+                    ? "json_markdown"
+                    : "toon",
+                schema: itemParseOptions.schema,
+                extensionFieldNames: itemParseOptions.extensionFieldNames,
+            });
+            return null;
+        }
+        catch {
+            return { path: file.relativePath, id: file.id };
+        }
+    }))).filter((row) => row !== null);
+    // "Live" for resurrection detection means an item file exists on disk —
+    // deleted items keep their history stream but lose the document, so a
+    // delete-terminated stream is only suspicious when the document is back.
+    const historyScan = await scanHistoryStreams(pmRoot, idsOnDisk);
+    const configScan = await scanConfigFiles(pmRoot);
+    return {
+        item_files_on_disk: itemFiles.length,
+        item_ids_on_disk: idsOnDisk.size,
+        parsed_items: parsedItemIds.size,
+        unreadable_item_files: unreadableItemFiles,
+        duplicate_item_ids: duplicateItemIds,
+        history_streams_scanned: historyScan.scanned,
+        history_conflict_marker_streams: historyScan.conflictMarkers,
+        history_unparseable_streams: historyScan.unparseable,
+        resurrected_items: historyScan.resurrected,
+        history_repair_reconciliations: historyScan.repairReconciliations,
+        config_files_scanned: configScan.scanned,
+        unparseable_config_files: configScan.unparseable,
+    };
+}
+//# sourceMappingURL=storage-integrity.js.map
+//# debugId=99fdc5e7-d08b-54a7-8169-1385c91f8ed6

package/dist/sdk/governance/storage-integrity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-integrity.js","sources":["sdk/governance/storage-integrity.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module sdk/governance/storage-integrity\n *\n * Post-merge storage-integrity check for `pm validate`: fails the workspace\n * when tracker storage is provably corrupted in ways the ordinary read path\n * silently tolerates — unparseable item documents (skipped by the list scan),\n * history streams containing unresolved merge-conflict markers, deleted items\n * silently resurrected by a delete/modify merge, and configuration or schema\n * files whose parse failure would otherwise fall back to defaults behind a\n * green gate. This is the detection half of the tracker merge-semantics\n * contract; the merge drivers in `sdk/merge` are the prevention half.\n */\nimport fs from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { readFileIfExists } from \"../../core/fs/fs-utils.js\";\nimport {\n  parseItemDocument,\n  type ItemDocumentFormatOptions,\n} from \"../../core/item/item-format.js\";\nimport { findFirstMergeConflictMarker } from \"../../core/shared/conflict-markers.js\";\nimport {\n  getSettingsPath,\n  ITEM_FILE_EXTENSIONS,\n} from \"../../core/store/paths.js\";\nimport type { HistoryEntry } from \"../../types/index.js\";\n\n/** Documents one unreadable item-file finding surfaced by the storage-integrity check. */\nexport interface UnreadableItemFileRow {\n  /** Tracker-relative path of the item file that failed to parse. */\n  path: string;\n  /** Item id derived from the file name. */\n  id: string;\n}\n\n/** Documents one history-stream finding surfaced by the storage-integrity check. */\nexport interface HistoryStreamIntegrityRow {\n  /** Item id whose history stream is affected. */\n  id: string;\n  /** Tracker-relative path of the history stream. */\n  path: string;\n  /** Line number of the first offending content, when line-addressable. */\n  line?: number;\n  /** Failure detail (conflict marker text or parse failure reason). */\n  detail: string;\n}\n\n/** Documents one resurrection-candidate finding: a live item whose history says it was deleted. */\nexport interface ResurrectedItemRow {\n  /** Live item id whose newest history operation is a delete. */\n  id: string;\n  /** Timestamp of the recorded delete operation. */\n  deleted_at: string;\n  /** Author of the recorded delete operation. */\n  deleted_by: string;\n}\n\n/** Documents one duplicate-item-id finding: one id claimed by multiple item documents (cross-branch add/add collision or duplicated format variant). */\nexport interface DuplicateItemIdRow {\n  /** Item id claimed by more than one on-disk document. */\n  id: string;\n  /** Tracker-relative paths of every document claiming the id, sorted for determinism. */\n  paths: string[];\n}\n\n/** Documents one unparseable configuration/schema file finding. */\nexport interface UnparseableConfigRow {\n  /** Tracker-relative path of the configuration file. */\n  path: string;\n  /** Failure detail (conflict marker location or JSON parse failure). */\n  detail: string;\n}\n\n/** Documents the storage-integrity scan result consumed by the validate check builder. */\nexport interface StorageIntegrityScanResult {\n  /** Number of item files present on disk across all type folders. */\n  item_files_on_disk: number;\n  /** Number of distinct item ids present on disk. */\n  item_ids_on_disk: number;\n  /** Number of items the standard read path successfully parsed. */\n  parsed_items: number;\n  /** Item files whose ids the standard read path could not parse (silently skipped elsewhere). */\n  unreadable_item_files: UnreadableItemFileRow[];\n  /** Ids claimed by more than one item document (post-merge add/add id collisions across type folders or format variants; GH-600). */\n  duplicate_item_ids: DuplicateItemIdRow[];\n  /** Number of history streams scanned. */\n  history_streams_scanned: number;\n  /** History streams containing unresolved merge-conflict markers. */\n  history_conflict_marker_streams: HistoryStreamIntegrityRow[];\n  /** History streams containing an entry that is not a JSON object. */\n  history_unparseable_streams: HistoryStreamIntegrityRow[];\n  /** Live items whose newest history operation is a delete (delete/modify merge resurrection candidates). */\n  resurrected_items: ResurrectedItemRow[];\n  /** Streams whose final entry is a non-empty history_repair reconciliation patch — the post-repair divergence signal (informational, not a failure). */\n  history_repair_reconciliations: number;\n  /** Number of configuration/schema files scanned. */\n  config_files_scanned: number;\n  /** Configuration/schema files that cannot be parsed (silent-defaults fallback risk). */\n  unparseable_config_files: UnparseableConfigRow[];\n}\n\n/** Runtime schema context used to parse every physical item file exactly as the ordinary read path does. */\nexport interface StorageIntegrityItemParseOptions {\n  /** Active runtime schema, including unknown-field policy and custom field definitions. */\n  schema?: ItemDocumentFormatOptions[\"schema\"];\n  /** Item fields contributed by active extensions and therefore valid under a rejecting schema. */\n  extensionFieldNames?: readonly string[];\n}\n\nasync function listItemFilesOnDisk(\n  pmRoot: string,\n  typeToFolder: Record<string, string>,\n): Promise<Array<{ relativePath: string; id: string }>> {\n  const folders = [...new Set(Object.values(typeToFolder))];\n  const found: Array<{ relativePath: string; id: string }> = [];\n  await Promise.all(\n    folders.map(async (folder) => {\n      let entries: string[];\n      try {\n        entries = await fs.readdir(path.join(pmRoot, folder));\n      } catch {\n        return;\n      }\n      for (const entry of entries) {\n        for (const extension of ITEM_FILE_EXTENSIONS) {\n          if (entry.toLowerCase().endsWith(extension)) {\n            found.push({\n              relativePath: `${folder}/${entry}`,\n              id: entry.slice(0, -extension.length),\n            });\n            break;\n          }\n        }\n      }\n    }),\n  );\n  return found.sort((left, right) =>\n    left.relativePath.localeCompare(right.relativePath),\n  );\n}\n\ninterface HistoryStreamScanAccumulator {\n  conflictMarkers: HistoryStreamIntegrityRow[];\n  unparseable: HistoryStreamIntegrityRow[];\n  resurrected: ResurrectedItemRow[];\n  repairReconciliations: number;\n  scanned: number;\n}\n\nfunction scanHistoryStreamContent(\n  accumulator: HistoryStreamAccumulatorInput,\n  raw: string,\n): void {\n  const { id, relativePath, liveItemIds, out } = accumulator;\n  out.scanned += 1;\n  const conflictMarker = findFirstMergeConflictMarker(raw);\n  if (conflictMarker) {\n    out.conflictMarkers.push({\n      id,\n      path: relativePath,\n      line: conflictMarker.line,\n      detail: `unresolved merge conflict marker ${conflictMarker.marker}`,\n    });\n    return;\n  }\n  let latestEntry: HistoryEntry | null = null;\n  const lines = raw\n    .split(/\\r?\\n/)\n    .map((line, index) => ({ content: line.trim(), number: index + 1 }))\n    .filter((line) => line.content.length > 0);\n  for (const line of lines) {\n    try {\n      const parsed = JSON.parse(line.content) as unknown;\n      if (\n        typeof parsed !== \"object\" ||\n        parsed === null ||\n        Array.isArray(parsed)\n      ) {\n        throw new TypeError(\"history entry must be an object\");\n      }\n      latestEntry = parsed as HistoryEntry;\n    } catch {\n      out.unparseable.push({\n        id,\n        path: relativePath,\n        line: line.number,\n        detail: \"history line is not a valid JSON object\",\n      });\n      return;\n    }\n  }\n  if (latestEntry === null) {\n    return;\n  }\n  if (latestEntry.op === \"delete\" && liveItemIds.has(id)) {\n    out.resurrected.push({\n      id,\n      deleted_at: typeof latestEntry.ts === \"string\" ? latestEntry.ts : \"\",\n      deleted_by:\n        typeof latestEntry.author === \"string\" ? latestEntry.author : \"\",\n    });\n  }\n  if (\n    latestEntry.op === \"history_repair\" &&\n    Array.isArray(latestEntry.patch) &&\n    latestEntry.patch.length > 0\n  ) {\n    out.repairReconciliations += 1;\n  }\n}\n\ninterface HistoryStreamAccumulatorInput {\n  id: string;\n  relativePath: string;\n  liveItemIds: Set<string>;\n  out: HistoryStreamScanAccumulator;\n}\n\nasync function scanHistoryStreams(\n  pmRoot: string,\n  liveItemIds: Set<string>,\n): Promise<HistoryStreamScanAccumulator> {\n  const out: HistoryStreamScanAccumulator = {\n    conflictMarkers: [],\n    unparseable: [],\n    resurrected: [],\n    repairReconciliations: 0,\n    scanned: 0,\n  };\n  let entries: string[];\n  try {\n    entries = await fs.readdir(path.join(pmRoot, \"history\"));\n  } catch {\n    return out;\n  }\n  for (const entry of entries.sort((left, right) =>\n    left.localeCompare(right),\n  )) {\n    if (!entry.endsWith(\".jsonl\")) {\n      continue;\n    }\n    const raw = await fs.readFile(path.join(pmRoot, \"history\", entry), \"utf8\");\n    scanHistoryStreamContent(\n      {\n        id: entry.slice(0, -\".jsonl\".length),\n        relativePath: `history/${entry}`,\n        liveItemIds,\n        out,\n      },\n      raw,\n    );\n  }\n  return out;\n}\n\nfunction describeUnparseableJson(raw: string): string | null {\n  const conflictMarker = findFirstMergeConflictMarker(raw);\n  if (conflictMarker) {\n    return `unresolved merge conflict marker ${conflictMarker.marker} at line ${conflictMarker.line}`;\n  }\n  try {\n    JSON.parse(raw);\n    return null;\n  } catch (error) {\n    return `invalid JSON (${String(error)})`;\n  }\n}\n\nasync function scanConfigFiles(pmRoot: string): Promise<{\n  scanned: number;\n  unparseable: UnparseableConfigRow[];\n}> {\n  const unparseable: UnparseableConfigRow[] = [];\n  let scanned = 0;\n  const settingsRaw = await readFileIfExists(getSettingsPath(pmRoot));\n  if (settingsRaw !== null) {\n    scanned += 1;\n    const detail = describeUnparseableJson(settingsRaw);\n    if (detail !== null) {\n      unparseable.push({ path: \"settings.json\", detail });\n    }\n  }\n  let schemaEntries: string[];\n  try {\n    schemaEntries = await fs.readdir(path.join(pmRoot, \"schema\"));\n  } catch {\n    return { scanned, unparseable };\n  }\n  for (const entry of schemaEntries.sort((left, right) =>\n    left.localeCompare(right),\n  )) {\n    if (!entry.endsWith(\".json\")) {\n      continue;\n    }\n    const raw = await fs.readFile(path.join(pmRoot, \"schema\", entry), \"utf8\");\n    scanned += 1;\n    const detail = describeUnparseableJson(raw);\n    if (detail !== null) {\n      unparseable.push({ path: `schema/${entry}`, detail });\n    }\n  }\n  return { scanned, unparseable };\n}\n\n/**\n * Scan tracker storage for integrity failures the ordinary read path masks.\n * `parsedItemIds` are the ids the standard cached list scan successfully\n * parsed; any on-disk item file whose id is missing from that set is an\n * unreadable document that `pm get` would hard-error on while list-based\n * commands silently skip it.\n */\nexport async function scanStorageIntegrity(\n  pmRoot: string,\n  parsedItemIds: ReadonlySet<string>,\n  typeToFolder: Record<string, string>,\n  itemParseOptions: StorageIntegrityItemParseOptions = {},\n): Promise<StorageIntegrityScanResult> {\n  const itemFiles = await listItemFilesOnDisk(pmRoot, typeToFolder);\n  const idsOnDisk = new Set(itemFiles.map((file) => file.id));\n  const pathsById = new Map<string, string[]>();\n  for (const file of itemFiles) {\n    const paths = pathsById.get(file.id);\n    if (paths === undefined) {\n      pathsById.set(file.id, [file.relativePath]);\n    } else {\n      paths.push(file.relativePath);\n    }\n  }\n  const duplicateItemIds: DuplicateItemIdRow[] = [...pathsById.entries()]\n    .filter(([, paths]) => paths.length > 1)\n    .map(([id, paths]) => ({\n      id,\n      paths: [...paths].sort((left, right) => left.localeCompare(right)),\n    }))\n    .sort((left, right) => left.id.localeCompare(right.id));\n  const unreadableItemFiles = (\n    await Promise.all(\n      itemFiles.map(async (file): Promise<UnreadableItemFileRow | null> => {\n        if (!parsedItemIds.has(file.id)) {\n          return { path: file.relativePath, id: file.id };\n        }\n        try {\n          const absolutePath = path.join(pmRoot, file.relativePath);\n          parseItemDocument(await fs.readFile(absolutePath, \"utf8\"), {\n            format: absolutePath.toLowerCase().endsWith(\".md\")\n              ? \"json_markdown\"\n              : \"toon\",\n            schema: itemParseOptions.schema,\n            extensionFieldNames: itemParseOptions.extensionFieldNames,\n          });\n          return null;\n        } catch {\n          return { path: file.relativePath, id: file.id };\n        }\n      }),\n    )\n  ).filter((row): row is UnreadableItemFileRow => row !== null);\n  // \"Live\" for resurrection detection means an item file exists on disk —\n  // deleted items keep their history stream but lose the document, so a\n  // delete-terminated stream is only suspicious when the document is back.\n  const historyScan = await scanHistoryStreams(pmRoot, idsOnDisk);\n  const configScan = await scanConfigFiles(pmRoot);\n  return {\n    item_files_on_disk: itemFiles.length,\n    item_ids_on_disk: idsOnDisk.size,\n    parsed_items: parsedItemIds.size,\n    unreadable_item_files: unreadableItemFiles,\n    duplicate_item_ids: duplicateItemIds,\n    history_streams_scanned: historyScan.scanned,\n    history_conflict_marker_streams: historyScan.conflictMarkers,\n    history_unparseable_streams: historyScan.unparseable,\n    resurrected_items: historyScan.resurrected,\n    history_repair_reconciliations: historyScan.repairReconciliations,\n    config_files_scanned: configScan.scanned,\n    unparseable_config_files: configScan.unparseable,\n  };\n}\n"],"names":[],"mappings":"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","debugId":"99fdc5e7-d08b-54a7-8169-1385c91f8ed6"}

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

@@ -6,7 +6,7 @@ import { type DuplicateIssueCode } from "../../core/governance/issue-codes.js";
 import { type MissingFieldOccurrence } from "../../core/validate/missing-by-type.js";
 import type { ValidateMetadataProfile, ValidateMetadataRequiredField } from "../../types/index.js";
 import { type RelationshipKindRegistry } from "../relationships.js";
-type ValidateCheckName = "metadata" | "resolution" | "lifecycle" | "dependency_references" | "files" | "command_references" | "history_drift" | "format_version";
+type ValidateCheckName = "metadata" | "resolution" | "lifecycle" | "dependency_references" | "files" | "command_references" | "history_drift" | "format_version" | "storage_integrity";
 type ValidateStatus = "ok" | "warn" | "error";
 type ValidateDependencyCycleSeverity = "off" | "warn" | "error";
 type ValidateFileScanMode = "default" | "tracked-all" | "tracked-all-strict";
@@ -40,6 +40,8 @@ export interface ValidateCommandOptions {
     allAffectedIds?: boolean;
     /** Value that configures or reports check history drift for this contract. */
     checkHistoryDrift?: boolean;
+    /** Run the post-merge storage-integrity check (unreadable items, history conflict markers, resurrected items, unparseable config). */
+    checkStorageIntegrity?: boolean;
     /** Value that configures or reports check command references for this contract. */
     checkCommandReferences?: boolean;
     /** Strategy used to control scan behavior. */