archctx 0.5.7 → 0.5.9

package/assets/catalog.yaml

@@ -1,7 +1,7 @@
 {
   "schemaVersion": "archcontext.practice-catalog-manifest/v1",
   "catalogVersion": "2026.06.0",
-  "productVersion": "0.5.7",
+  "productVersion": "0.5.9",
   "generatedAt": "1970-01-01T00:00:00.000Z",
   "entries": [
     {
@@ -389,5 +389,5 @@
     "structurizr.dsl",
     "twelve-factor"
   ],
-  "catalogDigest": "sha256:35eeb95a2e4270ef948c699bf3049f4abcdc09f7639751485eb04dd5f81e2aa7"
+  "catalogDigest": "sha256:7838ef15b3da8f2c4528b7eadcbf9263adeee2e95ca2608c5819fd2b0b3708f9"
 }

package/bin/archctx.mjs

@@ -897,6 +897,9 @@ function projectionResultInvariantIssues(input) {
       issues.push(`${prefix} unchanged requires equal non-null digests`);
     }
   }
+  if (input.priorCommittedApplies) {
+    issues.push(...projectionPriorCommittedAppliesIssues(input.priorCommittedApplies, input.requestId));
+  }
   const { receiptDigest, ...receiptPayload } = input;
   if (projectionResultReceiptDigest(receiptPayload) !== receiptDigest)
     issues.push("receiptDigest must match the canonical projection result payload");
@@ -915,6 +918,45 @@ function projectionResultInvariantIssues(input) {
   }
   return issues;
 }
+function projectionPriorCommittedAppliesIssues(input, requestId) {
+  const issues = sortedUniqueIssues("priorCommittedApplies.changeSetId", input.map((entry) => entry.changeSetId));
+  if (input.length === 0)
+    issues.push("priorCommittedApplies must be omitted instead of empty");
+  for (const [index, entry] of input.entries()) {
+    const prefix = `priorCommittedApplies[${index}]`;
+    issues.push(...sortedUniqueIssues(`${prefix}.files.path`, entry.files.map((file) => file.path)));
+    if (entry.requestId !== requestId)
+      issues.push(`${prefix}.requestId must match the projection result requestId`);
+    if (entry.changeSetId.trim() === "")
+      issues.push(`${prefix}.changeSetId must not be empty`);
+    if (!ISO_INSTANT.test(entry.committedAt))
+      issues.push(`${prefix}.committedAt must be an ISO-8601 UTC instant`);
+    if (entry.files.length === 0)
+      issues.push(`${prefix}.files must name at least one committed file`);
+    if (entry.applyId === undefined !== (entry.lookupKey === undefined)) {
+      issues.push(`${prefix}.applyId and lookupKey must be present together or both absent`);
+    }
+    for (const field of ["applyId", "lookupKey"]) {
+      const value = entry[field];
+      if (value !== undefined && !SHA256_DIGEST.test(value))
+        issues.push(`${prefix}.${field} must be a SHA-256 digest`);
+    }
+    for (const [fileIndex, file] of entry.files.entries()) {
+      const filePrefix = `${prefix}.files[${fileIndex}]`;
+      if (!isRepoRelativePosixPath(file.path))
+        issues.push(`${filePrefix}.path must be a repository-relative POSIX path`);
+      if (!PROJECTION_PRIOR_COMMITTED_APPLY_OPERATIONS.includes(file.operation)) {
+        issues.push(`${filePrefix}.operation must be a supported committed operation`);
+      }
+      const expectsMissing = file.operation === "delete";
+      if (expectsMissing && file.hash !== "missing")
+        issues.push(`${filePrefix}.hash must be "missing" for a delete`);
+      if (!expectsMissing && !SHA256_DIGEST.test(file.hash))
+        issues.push(`${filePrefix}.hash must be a SHA-256 body digest`);
+    }
+  }
+  return issues;
+}
 function projectionResultReceiptDigest(input) {
   const refreshSignals = input.refreshSignals.map(({ projectionReceiptDigest: _projectionReceiptDigest, ...signal }) => signal);
   return digestJson({ ...input, refreshSignals });
@@ -1126,10 +1168,11 @@ function sortedUniqueIssues(label, values) {
   const expected = [...new Set(values)].sort();
   return expected.length === values.length && expected.every((value, index) => value === values[index]) ? [] : [`${label} must be sorted and unique`];
 }
-var PROJECTION_REQUEST_SCHEMA_VERSION = "archcontext.projection-request/v1", PROJECTION_RESULT_SCHEMA_VERSION = "archcontext.projection-result/v2", PROJECTION_APPLY_IDENTITY_SCHEMA_VERSION = "archcontext.projection-apply-identity/v1", PROJECTION_APPLY_RECOVERY_BINDING_SCHEMA_VERSION = "archcontext.projection-apply-recovery-binding/v1", PROJECTION_APPLY_RECOVERY_INTENT_SCHEMA_VERSION = "archcontext.projection-apply-recovery-intent/v1", PROJECTION_APPLY_RECOVERY_PROOF_SCHEMA_VERSION = "archcontext.projection-apply-recovery-proof/v1", PROJECTION_APPLY_RECOVERY_RESULT_SCHEMA_VERSION = "archcontext.projection-apply-recovery-result/v1", ARCHITECTURE_REFRESH_SIGNAL_SCHEMA_VERSION = "archcontext.architecture-refresh-signal/v1", ARCHCTX_CAPABILITIES_SCHEMA_VERSION = "archcontext.capabilities/v1", ARCHITECTURE_DOCS_RENDERER_VERSION = "archcontext.docs-renderer/v4", AGENT_CONTEXT_RENDERER_VERSION = "archcontext.agent-context-renderer/v1", PROJECTION_MODES, PROJECTION_TARGETS, ARCHITECTURE_MAJOR_CHANGE_REASON_CODES, ARCHCTX_FEATURES;
+var PROJECTION_REQUEST_SCHEMA_VERSION = "archcontext.projection-request/v1", PROJECTION_RESULT_SCHEMA_VERSION = "archcontext.projection-result/v2", PROJECTION_APPLY_IDENTITY_SCHEMA_VERSION = "archcontext.projection-apply-identity/v1", PROJECTION_APPLY_RECOVERY_BINDING_SCHEMA_VERSION = "archcontext.projection-apply-recovery-binding/v1", PROJECTION_APPLY_RECOVERY_INTENT_SCHEMA_VERSION = "archcontext.projection-apply-recovery-intent/v1", PROJECTION_APPLY_RECOVERY_PROOF_SCHEMA_VERSION = "archcontext.projection-apply-recovery-proof/v1", PROJECTION_APPLY_RECOVERY_RESULT_SCHEMA_VERSION = "archcontext.projection-apply-recovery-result/v1", ARCHITECTURE_REFRESH_SIGNAL_SCHEMA_VERSION = "archcontext.architecture-refresh-signal/v1", ARCHCTX_CAPABILITIES_SCHEMA_VERSION = "archcontext.capabilities/v1", ARCHITECTURE_DOCS_RENDERER_VERSION = "archcontext.docs-renderer/v4", AGENT_CONTEXT_RENDERER_VERSION = "archcontext.agent-context-renderer/v1", PROJECTION_MODES, PROJECTION_PRIOR_COMMITTED_APPLY_OPERATIONS, PROJECTION_TARGETS, ARCHITECTURE_MAJOR_CHANGE_REASON_CODES, ARCHCTX_FEATURES, SHA256_DIGEST, ISO_INSTANT;
 var init_projection = __esm(() => {
   init_schema();
   PROJECTION_MODES = ["check", "plan", "apply", "adopt"];
+  PROJECTION_PRIOR_COMMITTED_APPLY_OPERATIONS = ["delete", "write"];
   PROJECTION_TARGETS = ["agent-context", "architecture-docs"];
   ARCHITECTURE_MAJOR_CHANGE_REASON_CODES = [
     "constraint-changed",
@@ -1152,11 +1195,14 @@ var init_projection = __esm(() => {
     "module-statistics-v1",
     "projection-apply-receipt-v1",
     "projection-apply-recovery-v1",
+    "projection-prior-committed-applies-v1",
     "projection-protocol-v2",
     "recommendation-v3",
     "refactor-assessment-v1",
     "refactor-resolution-v1"
   ];
+  SHA256_DIGEST = /^sha256:[a-f0-9]{64}$/;
+  ISO_INSTANT = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d{1,3})?Z$/;
 });
 
 // packages/contracts/src/product-version.ts
@@ -1213,7 +1259,7 @@ function productVersionManifest() {
     }
   };
 }
-var ARCHCONTEXT_PRODUCT_NAME = "archctx", ARCHCONTEXT_PRODUCT_VERSION = "0.5.7", ARCHCONTEXT_PACKAGE_MANAGER = "bun@1.4.0", ARCHCONTEXT_NODE_RANGE = ">=22.22 <26", LOCAL_RUNTIME_RPC_SCHEMA_VERSION = "archcontext.runtime-rpc/v1", ARCHCONTEXT_SCHEMA_SET_VERSION = "2026-07-11.explorer-view-v2";
+var ARCHCONTEXT_PRODUCT_NAME = "archctx", ARCHCONTEXT_PRODUCT_VERSION = "0.5.9", ARCHCONTEXT_PACKAGE_MANAGER = "bun@1.4.0", ARCHCONTEXT_NODE_RANGE = ">=22.22 <26", LOCAL_RUNTIME_RPC_SCHEMA_VERSION = "archcontext.runtime-rpc/v1", ARCHCONTEXT_SCHEMA_SET_VERSION = "2026-07-11.explorer-view-v2";
 
 // packages/contracts/src/refactor.ts
 function refactorProposalDigest(proposal) {
@@ -2558,7 +2604,7 @@ var init_src2 = __esm(() => {
 
 // node_modules/.bun/@colbymchenry+codegraph@1.5.0/node_modules/@colbymchenry/codegraph/npm-sdk.js
 var require_npm_sdk = __commonJS(function(exports, module) {
-  var __dirname = "/Users/ancienttwo/Projects/arch-context/.claude/worktrees/release-0.5.7/node_modules/.bun/@colbymchenry+codegraph@1.5.0/node_modules/@colbymchenry/codegraph";
+  var __dirname = "/Users/ancienttwo/Projects/arch-context-wt-release-0.5.9/node_modules/.bun/@colbymchenry+codegraph@1.5.0/node_modules/@colbymchenry/codegraph";
   var path = __require("path");
   var os = __require("os");
   var fs = __require("fs");
@@ -17517,11 +17563,14 @@ class ChangeSetEngine {
         if (options.faultAfterOperations && applied >= options.faultAfterOperations)
           throw new Error("fault-injection");
       }
-      for (const projection3 of deps.projection.planGeneratedProjection(root)) {
-        await this.applyFileOperation(root, projection3.path, projection3.expectedHash, projection3.body, projection3.operation, backups, journalId, applied + 1, agentContextPaths);
-        applied += 1;
-        if (options.faultAfterOperations && applied >= options.faultAfterOperations)
-          throw new Error("fault-injection");
+      const explicitProjectionOnly = draft.operations.length > 0 && draft.operations.every((operation) => (operation.op === "render_projection" || operation.op === "render_agent_context") && operation.projectionFiles !== undefined && operation.projectionFiles.length > 0);
+      if (!explicitProjectionOnly) {
+        for (const projection3 of deps.projection.planGeneratedProjection(root)) {
+          await this.applyFileOperation(root, projection3.path, projection3.expectedHash, projection3.body, projection3.operation, backups, journalId, applied + 1, agentContextPaths);
+          applied += 1;
+          if (options.faultAfterOperations && applied >= options.faultAfterOperations)
+            throw new Error("fault-injection");
+        }
       }
       await this.validateModel(root, draft, deps, "after");
       const commit = await options.afterModelValidatedBeforeCommit?.({ root, draft, journalId });
@@ -17581,7 +17630,8 @@ class ChangeSetEngine {
         tempPath,
         backupPath,
         existed,
-        operation
+        operation,
+        bodyHash: operation === "delete_entity" ? "missing" : digestJson({ body })
       });
     }
     backups.push(backup);
@@ -27222,6 +27272,32 @@ class SqliteLocalStore {
       ...recoveryProof ? { recoveryProof } : {}
     };
   }
+  async listCommittedChangeSetsForTaskSession(root, taskSessionId) {
+    const db = await this.database();
+    const canonicalRoot = canonicalRepositoryRoot2(root);
+    const rows = db.prepare(`SELECT journal.journal_id, journal.changeset_id, journal.root, journal.metadata_json, journal.files_json,
+              journal.completed_at, journal.updated_at, receipt.apply_id, receipt.lookup_key
+        FROM changeset_journal journal
+        LEFT JOIN projection_apply_receipts receipt ON receipt.journal_id = journal.journal_id
+        WHERE journal.status = 'committed'
+        ORDER BY journal.completed_at ASC, journal.journal_id ASC`).all();
+    const matched = [];
+    for (const row of rows) {
+      if (canonicalRepositoryRoot2(String(row.root)) !== canonicalRoot)
+        continue;
+      const journalId = String(row.journal_id);
+      if (readChangeSetJournalTaskSessionId(String(row.metadata_json), journalId) !== taskSessionId)
+        continue;
+      matched.push({
+        journalId,
+        changeSetId: String(row.changeset_id),
+        committedAt: String(row.completed_at ?? row.updated_at),
+        ...row.apply_id === null || row.apply_id === undefined ? {} : { applyId: String(row.apply_id), lookupKey: String(row.lookup_key) },
+        files: committedChangeSetJournalFiles(String(row.files_json), journalId)
+      });
+    }
+    return matched;
+  }
   async consumeProjectionApplyReceiptRecovery(proof) {
     const db = await this.database();
     db.exec("BEGIN IMMEDIATE");
@@ -30880,6 +30956,59 @@ function changeSetMetadata(draft) {
     idempotencyKey: draft.idempotencyKey
   };
 }
+function readChangeSetJournalTaskSessionId(metadataJson, journalId) {
+  let metadata;
+  try {
+    metadata = JSON.parse(metadataJson);
+  } catch {
+    throw new Error(`changeset-journal-metadata-malformed: ${journalId}`);
+  }
+  if (!isJsonRecord(metadata))
+    throw new Error(`changeset-journal-metadata-malformed: ${journalId}`);
+  const reason = metadata.reason;
+  if (!isJsonRecord(reason) || typeof reason.taskSessionId !== "string" || reason.taskSessionId === "") {
+    throw new Error(`changeset-journal-reason-malformed: ${journalId}`);
+  }
+  return reason.taskSessionId;
+}
+function committedChangeSetFileOperation(operation, journalId, path) {
+  switch (operation) {
+    case "delete_entity":
+      return "delete";
+    case "create_entity":
+    case "update_entity_fields":
+    case "write_policy":
+    case "write_waiver":
+    case "render_projection":
+    case "render_agent_context":
+      return "write";
+    default:
+      throw new Error(`changeset-journal-file-malformed: ${journalId}:${path}:${operation}`);
+  }
+}
+function committedChangeSetJournalFiles(filesJson, journalId) {
+  let parsed;
+  try {
+    parsed = JSON.parse(filesJson);
+  } catch {
+    throw new Error(`changeset-journal-files-malformed: ${journalId}`);
+  }
+  if (!Array.isArray(parsed))
+    throw new Error(`changeset-journal-files-malformed: ${journalId}`);
+  return parsed.map((entry) => {
+    if (!isJsonRecord(entry) || typeof entry.path !== "string" || typeof entry.operation !== "string") {
+      throw new Error(`changeset-journal-file-malformed: ${journalId}`);
+    }
+    if (typeof entry.bodyHash !== "string" || entry.bodyHash === "") {
+      throw new Error(`changeset-journal-file-body-hash-missing: ${journalId}:${entry.path}`);
+    }
+    return {
+      path: entry.path,
+      operation: committedChangeSetFileOperation(entry.operation, journalId, entry.path),
+      hash: entry.bodyHash
+    };
+  }).sort((left, right) => left.path < right.path ? -1 : left.path > right.path ? 1 : 0);
+}
 function readChangeSetJournalMetadata(db, journalId) {
   const row = db.prepare("SELECT metadata_json FROM changeset_journal WHERE journal_id = ?").get(journalId);
   if (!row)
@@ -34081,6 +34210,34 @@ class ArchctxDaemon {
       ...inspection ?? {}
     });
   }
+  async listProjectionPriorCommittedApplies(root, requestId) {
+    this.assertRunning();
+    await this.openSession(root);
+    let committed;
+    try {
+      committed = await this.localStore.listCommittedChangeSetsForTaskSession(root, requestId);
+    } catch (error) {
+      return errorEnvelope("projection.prior-committed-applies", "AC_PRECONDITION_FAILED", error instanceof Error ? error.message : String(error));
+    }
+    const byChangeSetId = new Map;
+    for (const entry of committed) {
+      if (entry.files.length === 0)
+        continue;
+      byChangeSetId.set(entry.changeSetId, {
+        ...entry.applyId === undefined || entry.lookupKey === undefined ? {} : { applyId: entry.applyId, lookupKey: entry.lookupKey },
+        requestId,
+        changeSetId: entry.changeSetId,
+        committedAt: entry.committedAt,
+        files: entry.files
+      });
+    }
+    const applies = [...byChangeSetId.values()].sort((left, right) => left.changeSetId < right.changeSetId ? -1 : left.changeSetId > right.changeSetId ? 1 : 0);
+    const issues = applies.length === 0 ? [] : projectionPriorCommittedAppliesIssues(applies, requestId);
+    if (issues.length > 0) {
+      return errorEnvelope("projection.prior-committed-applies", "AC_SCHEMA_INVALID", `projection prior committed applies invariant failed: ${issues.join("; ")}`);
+    }
+    return okEnvelope("projection.prior-committed-applies", { applies });
+  }
   async recoverProjectionApply(root, intent) {
     this.assertRunning();
     const intentIssues = projectionApplyRecoveryIntentInvariantIssues(intent);
@@ -36900,6 +37057,9 @@ class RuntimeRpcClient {
   inspectProjectionApplyReceipt(root, lookupKey) {
     return this.call("inspectProjectionApplyReceipt", [root, lookupKey]);
   }
+  listProjectionPriorCommittedApplies(root, requestId) {
+    return this.call("listProjectionPriorCommittedApplies", [root, requestId]);
+  }
   recoverProjectionApply(root, intent) {
     return this.call("recoverProjectionApply", [root, intent]);
   }
@@ -37258,6 +37418,8 @@ class ArchctxRuntimeRpcServer {
         return this.daemon.applyUpdate(params[0], params[1]);
       case "inspectProjectionApplyReceipt":
         return this.daemon.inspectProjectionApplyReceipt(params[0], params[1]);
+      case "listProjectionPriorCommittedApplies":
+        return this.daemon.listProjectionPriorCommittedApplies(params[0], params[1]);
       case "recoverProjectionApply":
         return this.daemon.recoverProjectionApply(params[0], params[1]);
       case "ledgerState":
@@ -39509,6 +39671,9 @@ class RuntimeRpcClient2 {
   inspectProjectionApplyReceipt(root, lookupKey) {
     return this.call("inspectProjectionApplyReceipt", [root, lookupKey]);
   }
+  listProjectionPriorCommittedApplies(root, requestId) {
+    return this.call("listProjectionPriorCommittedApplies", [root, requestId]);
+  }
   recoverProjectionApply(root, intent) {
     return this.call("recoverProjectionApply", [root, intent]);
   }
@@ -40156,6 +40321,16 @@ async function runCliUnchecked(command2 = "help", args2 = [], cwd, deps = {}) {
   try {
     switch (command2) {
       case "init":
+        if (args2.includes("--help") || args2.includes("-h")) {
+          return okEnvelope("help", {
+            usage: "archctx init [--name <product-name>]",
+            description: "Initialize the repository architecture model and generated projection.",
+            options: {
+              "--name <product-name>": "Product name (default: ArchContext Project).",
+              "--help, -h": "Show help without initializing the repository."
+            }
+          });
+        }
         return (await runtime()).init(cwd, readFlag(args2, "--name") ?? "ArchContext Project");
       case "sync":
         return (await runtime()).sync(cwd, readRepeatedFlag(args2, "--changed"));
@@ -41110,7 +41285,7 @@ function architectureProjectionProfile(args2) {
   }
   return profile;
 }
-async function runArchitectureDocsAdoptionCommand(args2, root, daemon, projection3, profile, generatedAt, protocolRequest) {
+async function runArchitectureDocsAdoptionCommand(args2, root, daemon, projection3, profile, generatedAt, protocolRequest, priorCommittedApplies = []) {
   if (profile !== REPO_HARNESS_PROJECTION_PROFILE) {
     return errorEnvelope("docs.adopt", "AC_SCHEMA_INVALID", `docs adopt requires --profile ${REPO_HARNESS_PROJECTION_PROFILE}`);
   }
@@ -41162,7 +41337,7 @@ async function runArchitectureDocsAdoptionCommand(args2, root, daemon, projectio
     return errorEnvelope("docs.adopt", "AC_PRECONDITION_FAILED", `projection-adoption-fixed-point-unproven: drift=${drift}; rejected=${reasons}; digest=${canonical.plan.projectionDigest === canonicalFirst.plan.projectionDigest ? "stable" : "changed"}`);
   }
   if (protocolRequest) {
-    return applyProjectionProtocolFixedPoint(protocolRequest, projection3, canonical, adoption2.changeSetId, root, daemon);
+    return applyProjectionProtocolFixedPoint(protocolRequest, projection3, canonical, adoption2.changeSetId, root, daemon, priorCommittedApplies);
   }
   const filesByPath = new Map;
   for (const file of canonical.files)
@@ -41186,7 +41361,7 @@ async function runArchitectureDocsAdoptionCommand(args2, root, daemon, projectio
     apply: applied.data
   });
 }
-async function applyProjectionProtocolFixedPoint(request, input, fixedPoint, changeSetId, root, daemon) {
+async function applyProjectionProtocolFixedPoint(request, input, fixedPoint, changeSetId, root, daemon, priorCommittedApplies) {
   const committedFiles = projectionProtocolFilesForExpectedOutput(root, fixedPoint);
   const committedSignals = request.acceptedChange ? input.plan.refreshSignals.map((signal) => ({
     ...signal,
@@ -41204,7 +41379,7 @@ async function applyProjectionProtocolFixedPoint(request, input, fixedPoint, cha
   const appliedResult = projectionProtocolResult(request, input, "applied", fixedPoint, applyIdentity, {
     files: committedFiles,
     refreshSignals: committedSignals
-  });
+  }, priorCommittedApplies);
   let recoveryBinding;
   if (applyIdentity) {
     try {
@@ -41290,6 +41465,15 @@ async function runProjectionProtocolCommand(args2, cwd, daemon) {
   }
   const root = findRepositoryRoot(cwd);
   const generatedAt = new Date(0).toISOString();
+  let priorCommittedApplies;
+  try {
+    const listed = await daemon.listProjectionPriorCommittedApplies(root, request.requestId);
+    if (!listed.ok)
+      return listed;
+    priorCommittedApplies = parseProjectionPriorCommittedApplies(listed.data, request.requestId);
+  } catch (error) {
+    return errorEnvelope("projection.run", "AC_PRECONDITION_FAILED", `projection prior committed apply lookup failed: ${error instanceof Error ? error.message : String(error)}`);
+  }
   if (request.mode === "apply" && request.acceptedChange) {
     try {
       assertProjectionExpectedSnapshotAgainstModel(request, root, loadNativeModelFromArchContext(root));
@@ -41316,7 +41500,7 @@ async function runProjectionProtocolCommand(args2, cwd, daemon) {
   }
   const blocked = projectionProtocolHumanStatus(request, projection3);
   if (blocked)
-    return projectionProtocolEnvelope(request, projection3, blocked);
+    return projectionProtocolEnvelope(request, projection3, blocked, projection3, priorCommittedApplies);
   if (request.mode === "adopt") {
     const expectedWorktreeDigest = computeWorktreeDigest(root);
     const adopted = await runArchitectureDocsAdoptionCommand([
@@ -41330,7 +41514,7 @@ async function runProjectionProtocolCommand(args2, cwd, daemon) {
       expectedWorktreeDigest,
       "--task-session-id",
       request.requestId
-    ], root, daemon, projection3, REPO_HARNESS_PROJECTION_PROFILE, generatedAt, request);
+    ], root, daemon, projection3, REPO_HARNESS_PROJECTION_PROFILE, generatedAt, request, priorCommittedApplies);
     if (!adopted.ok)
       return adopted;
     return adopted;
@@ -41346,10 +41530,23 @@ async function runProjectionProtocolCommand(args2, cwd, daemon) {
     } catch (error) {
       return errorEnvelope("projection.run", "AC_PRECONDITION_FAILED", error instanceof Error ? error.message : String(error));
     }
-    return applyProjectionProtocolFixedPoint(request, projection3, fixedPointProjection, changeSetId, root, daemon);
+    return applyProjectionProtocolFixedPoint(request, projection3, fixedPointProjection, changeSetId, root, daemon, priorCommittedApplies);
   }
   const status = projection3.plan.drift.ok ? "noop" : "planned";
-  return projectionProtocolEnvelope(request, projection3, status);
+  return projectionProtocolEnvelope(request, projection3, status, projection3, priorCommittedApplies);
+}
+function parseProjectionPriorCommittedApplies(value, requestId) {
+  if (!value || typeof value !== "object" || Array.isArray(value))
+    throw new Error("prior committed apply reply must be an object");
+  const applies = value.applies;
+  if (!Array.isArray(applies))
+    throw new Error("prior committed apply reply must carry an applies array");
+  if (applies.length === 0)
+    return [];
+  const issues = projectionPriorCommittedAppliesIssues(applies, requestId);
+  if (issues.length > 0)
+    throw new Error(`prior committed apply invariant failed: ${issues.join("; ")}`);
+  return applies;
 }
 async function runProjectionApplyRecoveryCommand(args2, cwd, daemon) {
   const raw = readFlag(args2, "--request-json");
@@ -41537,10 +41734,10 @@ function projectionProtocolHumanStatus(request, projection3) {
     return "adoption-required";
   return otherRejection || humanSignal ? "human-action-required" : null;
 }
-function projectionProtocolEnvelope(request, input, status, output = input) {
-  return projectionProtocolResultEnvelope(projectionProtocolResult(request, input, status, output));
+function projectionProtocolEnvelope(request, input, status, output, priorCommittedApplies) {
+  return projectionProtocolResultEnvelope(projectionProtocolResult(request, input, status, output, undefined, undefined, priorCommittedApplies));
 }
-function projectionProtocolResult(request, input, status, output = input, applyReceipt, overrides) {
+function projectionProtocolResult(request, input, status, output = input, applyReceipt, overrides, priorCommittedApplies = []) {
   const inputSnapshot = projectionProtocolSnapshot(request, input.plan.provenance);
   const outputSnapshot = projectionProtocolSnapshot(request, output.plan.provenance);
   const files = overrides?.files ?? projectionProtocolFiles(input);
@@ -41567,7 +41764,8 @@ function projectionProtocolResult(request, input, status, output = input, applyR
     files,
     humanActions,
     refreshSignals,
-    ...applyReceipt ? { applyReceipt } : {}
+    ...applyReceipt ? { applyReceipt } : {},
+    ...priorCommittedApplies.length > 0 ? { priorCommittedApplies } : {}
   };
   const receiptDigest = projectionResultReceiptDigest(withoutReceipt);
   const result = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "archctx",
-  "version": "0.5.7",
+  "version": "0.5.9",
   "description": "Local architecture context CLI for agentic coding workflows.",
   "private": false,
   "type": "module",

package/schemas/runtime/archctx-capabilities.schema.json

@@ -39,7 +39,7 @@
       "type": "array",
       "minItems": 3,
       "uniqueItems": true,
-      "items": { "enum": ["architecture-docs-renderer-v2", "architecture-refresh-signal-v1", "module-statistics-v1", "projection-apply-receipt-v1", "projection-apply-recovery-v1", "projection-protocol-v2", "recommendation-v3", "refactor-assessment-v1", "refactor-resolution-v1"] }
+      "items": { "enum": ["architecture-docs-renderer-v2", "architecture-refresh-signal-v1", "module-statistics-v1", "projection-apply-receipt-v1", "projection-apply-recovery-v1", "projection-prior-committed-applies-v1", "projection-protocol-v2", "recommendation-v3", "refactor-assessment-v1", "refactor-resolution-v1"] }
     }
   }
 }

package/schemas/runtime/projection-result.schema.json

@@ -16,6 +16,7 @@
     "humanActions": { "type": "array", "items": { "$ref": "#/$defs/humanAction" } },
     "refreshSignals": { "type": "array", "description": "Canonical wire order is by signalId and cross-object receipt/snapshot bindings are enforced by projectionResultInvariantIssues.", "items": { "$ref": "#/$defs/refreshSignal" } },
     "applyReceipt": { "$ref": "#/$defs/applyIdentity" },
+    "priorCommittedApplies": { "type": "array", "minItems": 1, "description": "Omitted, never empty. Canonical wire order is by changeSetId and is enforced by projectionResultInvariantIssues.", "items": { "$ref": "#/$defs/priorCommittedApply" } },
     "receiptDigest": { "$ref": "#/$defs/digest" }
   },
   "allOf": [
@@ -166,6 +167,45 @@
         "affectedNodeIds": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "minLength": 1 } }
       }
     },
+    "priorCommittedApply": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["requestId", "changeSetId", "committedAt", "files"],
+      "properties": {
+        "applyId": { "$ref": "#/$defs/digest" },
+        "lookupKey": { "$ref": "#/$defs/digest" },
+        "requestId": { "type": "string", "pattern": "^[a-zA-Z0-9_.:-]+$", "minLength": 1 },
+        "changeSetId": { "type": "string", "minLength": 1 },
+        "committedAt": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d{1,3})?Z$" },
+        "files": {
+          "type": "array",
+          "minItems": 1,
+          "description": "Canonical wire order is by path and is enforced by projectionResultInvariantIssues.",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["path", "operation", "hash"],
+            "properties": {
+              "path": {
+                "type": "string",
+                "minLength": 1,
+                "not": { "anyOf": [{ "pattern": "^/" }, { "pattern": "\\\\" }, { "pattern": "(^|/)\\.\\.(/|$)" }] }
+              },
+              "operation": { "enum": ["delete", "write"] },
+              "hash": { "type": "string", "pattern": "^(?:sha256:[a-f0-9]{64}|missing)$" }
+            },
+            "allOf": [
+              {
+                "if": { "properties": { "operation": { "const": "delete" } }, "required": ["operation"] },
+                "then": { "properties": { "hash": { "const": "missing" } } },
+                "else": { "properties": { "hash": { "$ref": "#/$defs/digest" } } }
+              }
+            ]
+          }
+        }
+      },
+      "dependentRequired": { "applyId": ["lookupKey"], "lookupKey": ["applyId"] }
+    },
     "applyIdentity": {
       "type": "object",
       "additionalProperties": false,