archctx-contracts 0.2.0 → 0.2.2

package/schemas/runtime/retrieval-eval.schema.json

@@ -0,0 +1,29 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://archctx.repoharness.com/schemas/runtime/retrieval-eval.schema.json",
+  "title": "RetrievalEvalSet",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "id", "seed", "queries"],
+  "properties": {
+    "schemaVersion": { "const": "archcontext.retrieval-eval/v1" },
+    "id": { "type": "string" },
+    "seed": { "type": "integer", "minimum": 0 },
+    "queries": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["id", "text", "expectedContextIds", "expectedConstraintIds", "prohibitedContextIds"],
+        "properties": {
+          "id": { "type": "string" },
+          "text": { "type": "string" },
+          "expectedContextIds": { "type": "array", "items": { "type": "string" } },
+          "expectedConstraintIds": { "type": "array", "items": { "type": "string" } },
+          "prohibitedContextIds": { "type": "array", "items": { "type": "string" } }
+        }
+      }
+    }
+  }
+}

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

@@ -0,0 +1,48 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://archctx.repoharness.com/schemas/runtime/review-result.schema.json",
+  "title": "ReviewResult",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "reviewId", "taskSessionId", "snapshot", "posture", "result", "summary", "findings"],
+  "properties": {
+    "schemaVersion": { "const": "archcontext.review/v1" },
+    "reviewId": { "type": "string" },
+    "taskSessionId": { "type": "string" },
+    "snapshot": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["headSha", "worktreeDigest", "modelDigest", "codeFactsDigest"],
+      "properties": {
+        "headSha": { "type": "string" },
+        "worktreeDigest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+        "modelDigest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+        "codeFactsDigest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+        "practiceCatalogDigest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+        "practicePolicyDigest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+        "practiceCheckResultDigest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+        "projectionSourceDigest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+        "projectionDigest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+        "projectionRendererVersion": { "type": "string" }
+      }
+    },
+    "posture": { "type": "string", "enum": ["normal", "structural", "intervention", "proof-required"] },
+    "result": { "type": "string", "enum": ["pass", "pass_with_warnings", "fail_action_required"] },
+    "summary": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["errors", "warnings", "notices"],
+      "properties": {
+        "errors": { "type": "integer", "minimum": 0 },
+        "warnings": { "type": "integer", "minimum": 0 },
+        "notices": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "findings": { "type": "array", "items": { "type": "object", "additionalProperties": true } },
+    "practiceViolations": { "type": "array", "items": { "type": "object", "additionalProperties": true } },
+    "waiversApplied": { "type": "array", "items": { "type": "object", "additionalProperties": true } },
+    "actionsRequired": { "type": "array", "items": { "type": "string" } },
+    "cleanup": { "type": "object", "additionalProperties": false, "properties": { "required": { "type": "integer" }, "completed": { "type": "integer" } } },
+    "extensions": { "type": "object", "additionalProperties": true }
+  }
+}

package/schemas/runtime/task-context.schema.json

@@ -0,0 +1,53 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://archctx.repoharness.com/schemas/runtime/task-context.schema.json",
+  "title": "TaskContext",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "task", "posture", "architecturePressure", "refactorConfidence", "relevantNodes", "constraints", "decisions"],
+  "properties": {
+    "schemaVersion": { "const": "archcontext.task-context/v1" },
+    "task": { "type": "string" },
+    "posture": { "type": "string", "enum": ["normal", "structural", "intervention", "proof-required"] },
+    "architecturePressure": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["level", "score", "signals"],
+      "properties": {
+        "level": { "type": "string", "enum": ["low", "medium", "high"] },
+        "score": { "type": "number", "minimum": 0, "maximum": 100 },
+        "signals": { "type": "array", "items": { "type": "string" } }
+      }
+    },
+    "refactorConfidence": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["level", "score", "coverage"],
+      "properties": {
+        "level": { "type": "string", "enum": ["low", "medium", "high"] },
+        "score": { "type": "number", "minimum": 0, "maximum": 100 },
+        "coverage": { "type": "array", "items": { "type": "string" } }
+      }
+    },
+    "relevantNodes": { "type": "array", "items": { "type": "string" } },
+    "constraints": { "type": "array", "items": { "type": "string" } },
+    "decisions": { "type": "array", "items": { "type": "string" } },
+    "realConstraints": { "type": "array", "items": { "type": "string" } },
+    "unknowns": { "type": "array", "items": { "type": "string" } },
+    "recommendedTargetState": { "type": "object", "additionalProperties": true },
+    "requiredCheckpoints": { "type": "array", "items": { "type": "string" } },
+    "resources": { "type": "array", "items": { "type": "object", "additionalProperties": true } },
+    "practiceGuidance": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["schemaVersion", "catalogDigest", "overlayDigest", "matches"],
+      "properties": {
+        "schemaVersion": { "const": "archcontext.practice-guidance/v1" },
+        "catalogDigest": { "type": "string", "pattern": "^sha256:" },
+        "overlayDigest": { "type": "string", "pattern": "^sha256:" },
+        "matches": { "type": "array", "items": { "type": "object", "additionalProperties": true } }
+      }
+    },
+    "extensions": { "type": "object", "additionalProperties": true }
+  }
+}

package/src/ledger.ts

@@ -122,7 +122,8 @@ export type ProjectionTargetType =
   | "architecture-changelog"
   | "diagram-mermaid"
   | "diagram-structurizr"
-  | "diagram-likec4";
+  | "diagram-likec4"
+  | "agent-context";
 export type ProjectionTargetScopeKind = "repository" | "entity" | "relation" | "decision" | "diagram" | "changelog";
 export type ProjectionTargetOwnership = "generated" | "mixed";
 export type ProjectionTargetFormat = "markdown" | "mermaid" | "structurizr-json" | "likec4";

package/src/product-version.ts

@@ -1,5 +1,5 @@
 export const ARCHCONTEXT_PRODUCT_NAME = "archctx";
-export const ARCHCONTEXT_PRODUCT_VERSION = "0.2.0";
+export const ARCHCONTEXT_PRODUCT_VERSION = "0.2.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";