archctx-contracts 0.4.0 → 0.4.2

package/fixtures/valid/archctx-capabilities.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": "archcontext.capabilities/v1",
-  "package": { "name": "archctx", "version": "0.4.0" },
+  "package": { "name": "archctx", "version": "0.4.2" },
   "protocols": {
     "projectionRequest": "archcontext.projection-request/v1",
     "projectionResult": "archcontext.projection-result/v1",

package/fixtures/valid/product-version-manifest.json

@@ -2,7 +2,7 @@
   "schemaVersion": "archcontext.product-version-manifest/v1",
   "product": {
     "name": "archctx",
-    "version": "0.4.0",
+    "version": "0.4.2",
     "distribution": "one-package"
   },
   "packageManager": "bun@1.3.10",
@@ -12,25 +12,25 @@
   "surfaces": {
     "cli": {
       "packageName": "@archcontext/surfaces",
-      "version": "0.4.0",
+      "version": "0.4.2",
       "entrypoint": "archctx"
     },
     "daemon": {
       "packageName": "@archcontext/local-runtime",
-      "version": "0.4.0",
+      "version": "0.4.2",
       "entrypoint": "archctx daemon start",
       "rpcSchemaVersion": "archcontext.runtime-rpc/v1"
     },
     "mcp": {
       "packageName": "@archcontext/surfaces",
-      "version": "0.4.0",
+      "version": "0.4.2",
       "entrypoint": "archctx mcp",
       "transport": "stdio"
     }
   },
   "schemas": {
     "schemaSetVersion": "2026-06-25.al0-ledger",
-    "contractsPackageVersion": "0.4.0",
+    "contractsPackageVersion": "0.4.2",
     "reviewChallenge": "archcontext.review-challenge/v2",
     "attestation": "archcontext.attestation/v2",
     "deviceIdentity": "archcontext.device-identity/v1",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "archctx-contracts",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "private": false,
   "type": "module",
   "license": "Apache-2.0",

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

@@ -24,7 +24,8 @@
       "items": { "$ref": "#/$defs/repoPath" }
     },
     "expected": { "$ref": "#/$defs/expectedSnapshot" },
-    "adoptionPlanId": { "type": "string", "pattern": "^adoption_plan\\.[a-zA-Z0-9_.-]+$" }
+    "adoptionPlanId": { "type": "string", "pattern": "^adoption_plan\\.[a-zA-Z0-9_.-]+$" },
+    "acceptedChange": { "$ref": "#/$defs/acceptedChange" }
   },
   "allOf": [
     {
@@ -46,6 +47,45 @@
         ]
       }
     },
+    "acceptedChange": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["changeSetId", "eventId", "reasonCodes", "affectedNodeIds"],
+      "properties": {
+        "changeSetId": { "type": "string", "minLength": 1 },
+        "eventId": { "type": "string", "minLength": 1 },
+        "reasonCodes": {
+          "type": "array",
+          "minItems": 1,
+          "uniqueItems": true,
+          "description": "Canonical wire order is lexicographic and is enforced by projectionRequestInvariantIssues.",
+          "items": {
+            "enum": [
+              "constraint-changed",
+              "entrypoint-changed",
+              "interface-changed",
+              "lifecycle-changed",
+              "node-added",
+              "node-moved",
+              "node-removed",
+              "node-renamed",
+              "ownership-changed",
+              "relation-changed",
+              "responsibility-changed",
+              "risk-boundary-changed",
+              "verified-flow-proof-changed"
+            ]
+          }
+        },
+        "affectedNodeIds": {
+          "type": "array",
+          "minItems": 1,
+          "uniqueItems": true,
+          "description": "Canonical wire order is lexicographic and is enforced by projectionRequestInvariantIssues.",
+          "items": { "type": "string", "minLength": 1 }
+        }
+      }
+    },
     "expectedSnapshot": {
       "type": "object",
       "additionalProperties": false,

package/src/product-version.ts

@@ -1,5 +1,5 @@
 export const ARCHCONTEXT_PRODUCT_NAME = "archctx";
-export const ARCHCONTEXT_PRODUCT_VERSION = "0.4.0";
+export const ARCHCONTEXT_PRODUCT_VERSION = "0.4.2";
 export const ARCHCONTEXT_PACKAGE_MANAGER = "bun@1.3.10";
 export const ARCHCONTEXT_NODE_RANGE = ">=24 <26";
 export const LOCAL_RUNTIME_RPC_SCHEMA_VERSION = "archcontext.runtime-rpc/v1";

package/src/projection.ts

@@ -79,6 +79,7 @@ export interface ProjectionRequestV1 {
   changedPaths: string[];
   expected: ProjectionExpectedSnapshotV1;
   adoptionPlanId?: string;
+  acceptedChange?: AcceptedArchitectureChangeReferenceV1;
 }
 
 export interface ProjectionSnapshotV1 extends ProjectionExpectedSnapshotV1 {
@@ -193,12 +194,31 @@ export function archctxCapabilities(packageVersion: string): ArchctxCapabilities
 export function projectionRequestInvariantIssues(input: ProjectionRequestV1): string[] {
   const issues = [
     ...sortedUniqueIssues("targets", input.targets),
-    ...sortedUniqueIssues("changedPaths", input.changedPaths)
+    ...sortedUniqueIssues("changedPaths", input.changedPaths),
+    ...(input.acceptedChange
+      ? [
+          ...sortedUniqueIssues("acceptedChange.reasonCodes", input.acceptedChange.reasonCodes),
+          ...sortedUniqueIssues("acceptedChange.affectedNodeIds", input.acceptedChange.affectedNodeIds)
+        ]
+      : [])
   ];
   if (input.targets.length === 0) issues.push("targets must contain at least one projection target");
   if (!/^[a-zA-Z0-9_.:-]+$/.test(input.requestId)) issues.push("requestId must use the stable identifier character set");
   if (input.mode === "adopt" && !input.adoptionPlanId) issues.push("adoptionPlanId is required when mode=adopt");
   if (input.mode !== "adopt" && input.adoptionPlanId !== undefined) issues.push("adoptionPlanId is only allowed when mode=adopt");
+  if (input.acceptedChange) {
+    if (input.acceptedChange.changeSetId.trim() === "") issues.push("acceptedChange.changeSetId must not be empty");
+    if (input.acceptedChange.eventId.trim() === "") issues.push("acceptedChange.eventId must not be empty");
+    if (input.acceptedChange.reasonCodes.length === 0) issues.push("acceptedChange.reasonCodes must contain at least one reason");
+    if (input.acceptedChange.affectedNodeIds.length === 0) issues.push("acceptedChange.affectedNodeIds must contain at least one node");
+    const allowedReasons = new Set<string>(ARCHITECTURE_MAJOR_CHANGE_REASON_CODES);
+    for (const reason of input.acceptedChange.reasonCodes) {
+      if (!allowedReasons.has(reason)) issues.push(`acceptedChange.reasonCodes contains unsupported reason: ${reason}`);
+    }
+    for (const nodeId of input.acceptedChange.affectedNodeIds) {
+      if (nodeId.trim() === "") issues.push("acceptedChange.affectedNodeIds must not contain empty node ids");
+    }
+  }
   return issues;
 }