archctx 0.1.3 → 0.1.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "archctx",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "Local architecture context CLI for agentic coding workflows.",
   "private": false,
   "type": "module",
@@ -10,6 +10,9 @@
   },
   "files": [
     "bin",
+    "assets",
+    "schemas",
+    "NOTICE.md",
     "README.md"
   ],
   "homepage": "https://archcontext.repoharness.com",
@@ -21,6 +24,7 @@
     "node": ">=24 <26"
   },
   "dependencies": {
-    "@colbymchenry/codegraph": "1.0.1"
+    "@colbymchenry/codegraph": "1.0.1",
+    "@node-rs/jieba": "^2.0.1"
   }
 }

package/schemas/cloud/attestation-v2.schema.json

@@ -0,0 +1,85 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://archctx.repoharness.com/schemas/cloud/attestation-v2.schema.json",
+  "title": "AttestationV2",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "attestationId", "challengeId", "installationId", "repositoryId", "pullRequestNumber", "headSha", "baseSha", "mergeBaseSha", "headTreeOid", "worktreeDigest", "modelDigest", "policyDigest", "codeFactsDigest", "reviewDigest", "result", "execution", "runtime", "nonce", "startedAt", "completedAt", "expiresAt", "signature"],
+  "properties": {
+    "schemaVersion": { "const": "archcontext.attestation/v2" },
+    "attestationId": { "type": "string" },
+    "challengeId": { "type": "string" },
+    "installationId": { "type": "integer", "minimum": 1 },
+    "repositoryId": { "type": "integer", "minimum": 1 },
+    "pullRequestNumber": { "type": "integer", "minimum": 1 },
+    "headSha": { "type": "string", "pattern": "^[a-f0-9]{40,64}$" },
+    "baseSha": { "type": "string", "pattern": "^[a-f0-9]{40,64}$" },
+    "mergeBaseSha": { "type": "string", "pattern": "^[a-f0-9]{40,64}$" },
+    "headTreeOid": { "type": "string" },
+    "worktreeDigest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "modelDigest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "policyDigest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "codeFactsDigest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "reviewDigest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "result": { "type": "string", "enum": ["pass", "fail", "error"] },
+    "errorCode": { "type": "string", "enum": ["RUNTIME_VERSION_UNSUPPORTED", "HEAD_UNAVAILABLE", "WORKTREE_NOT_CLEAN", "CODEGRAPH_FAILED", "POLICY_INVALID", "REVIEW_INCOMPLETE"] },
+    "execution": {
+      "type": "object",
+      "oneOf": [
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["trustLevel", "source", "principalId", "publicKeyId"],
+          "properties": {
+            "trustLevel": { "const": "developer" },
+            "source": { "const": "clean-commit-worktree" },
+            "principalId": { "type": "string" },
+            "publicKeyId": { "type": "string" }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["trustLevel", "source", "principalId", "publicKeyId", "runnerId", "workflowRef", "runId", "runAttempt"],
+          "properties": {
+            "trustLevel": { "const": "organization" },
+            "source": { "const": "organization-runner-checkout" },
+            "principalId": { "type": "string" },
+            "publicKeyId": { "type": "string" },
+            "runnerId": { "type": "string", "pattern": "^runner_[A-Za-z0-9_.-]+$" },
+            "workflowRef": {
+              "type": "string",
+              "pattern": "^[^/\\s]+/[^/\\s]+/\\.github/workflows/[^@\\s]+@(refs/(heads|tags)/[^@\\s]+|[a-fA-F0-9]{40})$"
+            },
+            "runId": { "type": "string", "pattern": "^[1-9][0-9]*$" },
+            "runAttempt": { "type": "integer", "minimum": 1 }
+          }
+        }
+      ]
+    },
+    "runtime": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["version", "buildDigest", "codeGraphVersion", "capabilitiesDigest"],
+      "properties": {
+        "version": { "type": "string" },
+        "buildDigest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+        "codeGraphVersion": { "type": "string" },
+        "capabilitiesDigest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }
+      }
+    },
+    "nonce": { "type": "string" },
+    "startedAt": { "type": "string" },
+    "completedAt": { "type": "string" },
+    "expiresAt": { "type": "string" },
+    "signature": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["algorithm", "value"],
+      "properties": {
+        "algorithm": { "type": "string", "enum": ["ed25519"] },
+        "value": { "type": "string" }
+      }
+    }
+  }
+}

package/schemas/cloud/attestation.schema.json

@@ -0,0 +1,49 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://archctx.repoharness.com/schemas/cloud/attestation.schema.json",
+  "title": "Attestation",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "attestationId", "challengeId", "repository", "headSha", "worktreeDigest", "reviewDigest", "device", "issuedAt", "expiresAt", "trustLevel", "signature"],
+  "properties": {
+    "schemaVersion": { "const": "archcontext.attestation/v1" },
+    "attestationId": { "type": "string" },
+    "challengeId": { "type": "string" },
+    "repository": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["provider", "owner", "name", "visibility"],
+      "properties": {
+        "provider": { "type": "string", "enum": ["github"] },
+        "owner": { "type": "string" },
+        "name": { "type": "string" },
+        "visibility": { "type": "string", "enum": ["public", "private"] }
+      }
+    },
+    "headSha": { "type": "string" },
+    "worktreeDigest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "reviewDigest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "device": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["deviceId", "publicKeyId"],
+      "properties": {
+        "deviceId": { "type": "string" },
+        "publicKeyId": { "type": "string" }
+      }
+    },
+    "issuedAt": { "type": "string" },
+    "expiresAt": { "type": "string" },
+    "trustLevel": { "type": "string", "enum": ["developer", "organization"] },
+    "signature": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["alg", "value"],
+      "properties": {
+        "alg": { "type": "string", "enum": ["ed25519"] },
+        "value": { "type": "string" }
+      }
+    },
+    "extensions": { "type": "object", "additionalProperties": true }
+  }
+}

package/schemas/cloud/check-delivery.schema.json

@@ -0,0 +1,25 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://archctx.repoharness.com/schemas/cloud/check-delivery.schema.json",
+  "title": "CheckDelivery",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "deliveryId", "challengeId", "checkName", "headSha", "status", "attemptCount", "createdAt", "updatedAt"],
+  "properties": {
+    "schemaVersion": { "const": "archcontext.check-delivery/v1" },
+    "deliveryId": { "type": "string" },
+    "challengeId": { "type": "string" },
+    "checkRunId": { "type": ["string", "null"] },
+    "checkName": { "type": "string", "enum": ["ArchContext / Developer Review", "ArchContext / Organization Runner"] },
+    "headSha": { "type": "string", "pattern": "^[a-f0-9]{40,64}$" },
+    "status": { "type": "string", "enum": ["PENDING", "PUBLISHED", "RETRYING", "DEAD_LETTER"] },
+    "attemptCount": { "type": "integer", "minimum": 0 },
+    "nextAttemptAt": { "type": ["string", "null"] },
+    "lastErrorCode": {
+      "type": ["string", "null"],
+      "enum": ["CHALLENGE_NOT_FOUND", "CHALLENGE_EXPIRED", "CHALLENGE_SUPERSEDED", "CHALLENGE_ALREADY_CONSUMED", "NONCE_MISMATCH", "REPOSITORY_MISMATCH", "PULL_REQUEST_MISMATCH", "HEAD_SHA_MISMATCH", "BASE_SHA_MISMATCH", "TREE_OID_MISMATCH", "TRUST_LEVEL_MISMATCH", "DIGEST_INVALID", "RUNNER_NOT_FOUND", "RUNNER_REVOKED", "RUNNER_SCOPE_MISMATCH", "WORKFLOW_REF_MISMATCH", "DEVICE_REVOKED", "RUNTIME_VERSION_UNSUPPORTED", "SIGNATURE_INVALID", "PAYLOAD_PRIVACY_VIOLATION", null]
+    },
+    "createdAt": { "type": "string" },
+    "updatedAt": { "type": "string" }
+  }
+}

package/schemas/cloud/cloud-egress-envelope.schema.json

@@ -0,0 +1,19 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://archctx.repoharness.com/schemas/cloud/cloud-egress-envelope.schema.json",
+  "title": "CloudEgressEnvelope",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "requestId", "category", "method", "host", "pathTemplate", "statusCode", "latencyMs", "recordedAt"],
+  "properties": {
+    "schemaVersion": { "const": "archcontext.cloud-egress/v1" },
+    "requestId": { "type": "string" },
+    "category": { "type": "string", "enum": ["github.metadata", "github.pull-head", "github.check-list-for-ref", "github.check-create", "github.check-update"] },
+    "method": { "type": "string", "enum": ["GET", "POST", "PATCH"] },
+    "host": { "type": "string", "enum": ["api.github.com"] },
+    "pathTemplate": { "type": "string" },
+    "statusCode": { "type": "integer", "minimum": 100, "maximum": 599 },
+    "latencyMs": { "type": "integer", "minimum": 0 },
+    "recordedAt": { "type": "string" }
+  }
+}

package/schemas/cloud/device-identity.schema.json

@@ -0,0 +1,18 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://archctx.repoharness.com/schemas/cloud/device-identity.schema.json",
+  "title": "DeviceIdentity",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "deviceId", "accountId", "publicKeyId", "publicKeyFingerprint", "status", "createdAt"],
+  "properties": {
+    "schemaVersion": { "const": "archcontext.device-identity/v1" },
+    "deviceId": { "type": "string" },
+    "accountId": { "type": "string" },
+    "publicKeyId": { "type": "string" },
+    "publicKeyFingerprint": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "status": { "type": "string", "enum": ["active", "revoked"] },
+    "createdAt": { "type": "string" },
+    "revokedAt": { "type": ["string", "null"] }
+  }
+}

package/schemas/cloud/entitlement.schema.json

@@ -0,0 +1,24 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://archctx.repoharness.com/schemas/cloud/entitlement.schema.json",
+  "title": "Entitlement",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "entitlementId", "accountId", "plan", "billingInterval", "privateRepositoryScope", "issuedAt"],
+  "properties": {
+    "schemaVersion": { "const": "archcontext.entitlement/v1" },
+    "entitlementId": { "type": "string" },
+    "accountId": { "type": "string" },
+    "plan": { "type": "string", "enum": ["free", "pro"] },
+    "billingInterval": { "type": "string", "enum": ["none", "monthly", "annual"] },
+    "privateRepositoryScope": {
+      "type": "string",
+      "enum": ["public-only", "user-all-private-repositories"]
+    },
+    "repositoryNumericIds": { "type": "array", "items": { "type": "integer", "minimum": 1 } },
+    "issuedAt": { "type": "string" },
+    "validUntil": { "type": "string" },
+    "offlineUntil": { "type": "string" },
+    "extensions": { "type": "object", "additionalProperties": true }
+  }
+}

package/schemas/cloud/governance-key-status.schema.json

@@ -0,0 +1,19 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://archctx.repoharness.com/schemas/cloud/governance-key-status.schema.json",
+  "title": "GovernanceKeyStatus",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "publicKeyId", "ownerKind", "ownerId", "fingerprint", "status", "createdAt"],
+  "properties": {
+    "schemaVersion": { "const": "archcontext.governance-key-status/v1" },
+    "publicKeyId": { "type": "string" },
+    "ownerKind": { "type": "string", "enum": ["device", "runner"] },
+    "ownerId": { "type": "string" },
+    "fingerprint": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "status": { "type": "string", "enum": ["active", "rotating", "revoked"] },
+    "createdAt": { "type": "string" },
+    "rotatedAt": { "type": ["string", "null"] },
+    "revokedAt": { "type": ["string", "null"] }
+  }
+}

package/schemas/cloud/org-runner-identity.schema.json

@@ -0,0 +1,21 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://archctx.repoharness.com/schemas/cloud/org-runner-identity.schema.json",
+  "title": "OrgRunnerIdentity",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "runnerId", "installationId", "publicKeyId", "publicKeyFingerprint", "status", "createdAt"],
+  "properties": {
+    "schemaVersion": { "const": "archcontext.org-runner-identity/v1" },
+    "runnerId": { "type": "string" },
+    "installationId": { "type": "integer", "minimum": 1 },
+    "repositoryNumericIds": { "type": "array", "items": { "type": "integer", "minimum": 1 } },
+    "publicKeyId": { "type": "string" },
+    "publicKeyFingerprint": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "status": { "type": "string", "enum": ["active", "revoked"] },
+    "createdAt": { "type": "string" },
+    "rotatedAt": { "type": "string" },
+    "revokedAt": { "type": "string" },
+    "extensions": { "type": "object", "additionalProperties": true }
+  }
+}

package/schemas/cloud/review-challenge-v2.schema.json

@@ -0,0 +1,23 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://archctx.repoharness.com/schemas/cloud/review-challenge-v2.schema.json",
+  "title": "ReviewChallengeV2",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "challengeId", "installationId", "repositoryId", "pullRequestNumber", "headSha", "baseSha", "nonce", "requiredTrust", "policyProfileId", "createdAt", "expiresAt", "status"],
+  "properties": {
+    "schemaVersion": { "const": "archcontext.review-challenge/v2" },
+    "challengeId": { "type": "string" },
+    "installationId": { "type": "integer", "minimum": 1 },
+    "repositoryId": { "type": "integer", "minimum": 1 },
+    "pullRequestNumber": { "type": "integer", "minimum": 1 },
+    "headSha": { "type": "string", "pattern": "^[a-f0-9]{40,64}$" },
+    "baseSha": { "type": "string", "pattern": "^[a-f0-9]{40,64}$" },
+    "nonce": { "type": "string" },
+    "requiredTrust": { "type": "string", "enum": ["developer", "organization"] },
+    "policyProfileId": { "type": "string" },
+    "createdAt": { "type": "string" },
+    "expiresAt": { "type": "string" },
+    "status": { "type": "string", "enum": ["PENDING", "LEASED", "SUBMITTED", "VERIFIED", "REJECTED", "SUPERSEDED", "EXPIRED"] }
+  }
+}

package/schemas/cloud/runner-identity.schema.json

@@ -0,0 +1,42 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://archctx.repoharness.com/schemas/cloud/runner-identity.schema.json",
+  "title": "RunnerIdentity",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "runnerId", "installationId", "repositoryIds", "workflowRef", "publicKeyId", "publicKeyFingerprint", "status", "createdAt"],
+  "properties": {
+    "schemaVersion": { "const": "archcontext.runner-identity/v1" },
+    "runnerId": { "type": "string" },
+    "installationId": { "type": "integer", "minimum": 1 },
+    "repositoryIds": { "type": "array", "minItems": 0, "items": { "type": "integer", "minimum": 1 } },
+    "scope": {
+      "oneOf": [
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["kind", "repositoryIds"],
+          "properties": {
+            "kind": { "const": "repository" },
+            "repositoryIds": { "type": "array", "minItems": 1, "items": { "type": "integer", "minimum": 1 } }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["kind"],
+          "properties": {
+            "kind": { "const": "organization" }
+          }
+        }
+      ]
+    },
+    "workflowRef": { "type": "string" },
+    "publicKeyId": { "type": "string" },
+    "publicKeyFingerprint": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "status": { "type": "string", "enum": ["active", "rotating", "revoked"] },
+    "createdAt": { "type": "string" },
+    "rotatedAt": { "type": ["string", "null"] },
+    "revokedAt": { "type": ["string", "null"] }
+  }
+}

package/schemas/integrations/adapter-fidelity.schema.json

@@ -0,0 +1,21 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://archctx.repoharness.com/schemas/integrations/adapter-fidelity.schema.json",
+  "title": "AdapterFidelityRule",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "id", "direction", "importScope", "nativeIsSourceOfTruth", "reverseSync", "protectedNativeFields"],
+  "properties": {
+    "schemaVersion": { "const": "archcontext.adapter-fidelity/v1" },
+    "id": { "type": "string", "pattern": "^adapter-fidelity\\.[a-z0-9][a-z0-9-]*$" },
+    "direction": { "const": "export-first" },
+    "importScope": { "const": "initialization-only" },
+    "nativeIsSourceOfTruth": { "const": true },
+    "reverseSync": { "const": "forbidden" },
+    "protectedNativeFields": {
+      "type": "array",
+      "items": { "type": "string", "enum": ["evidence", "verification", "constraint", "intervention"] },
+      "minItems": 4
+    }
+  }
+}

package/schemas/integrations/chatgpt-ga-tool.schema.json

@@ -0,0 +1,25 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://archctx.repoharness.com/schemas/integrations/chatgpt-ga-tool.schema.json",
+  "title": "ChatGptGaToolContract",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "toolName",
+    "surface",
+    "readOnlyByDefault",
+    "dataClassification",
+    "requiresLocalConfirmationForWrite",
+    "disclosure"
+  ],
+  "properties": {
+    "schemaVersion": { "const": "archcontext.chatgpt-ga-tool/v1" },
+    "toolName": { "type": "string", "pattern": "^archcontext_[a-z0-9_]+$" },
+    "surface": { "type": "string", "enum": ["cloud-metadata", "local-runtime"] },
+    "readOnlyByDefault": { "const": true },
+    "dataClassification": { "type": "string", "enum": ["cloud-metadata", "local-metadata", "local-architecture"] },
+    "requiresLocalConfirmationForWrite": { "type": "boolean" },
+    "disclosure": { "type": "string" }
+  }
+}

package/schemas/integrations/likec4-mapping.schema.json

@@ -0,0 +1,32 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://archctx.repoharness.com/schemas/integrations/likec4-mapping.schema.json",
+  "title": "LikeC4Mapping",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "id", "exportMode", "native", "likec4", "views"],
+  "properties": {
+    "schemaVersion": { "const": "archcontext.likec4-mapping/v1" },
+    "id": { "type": "string", "pattern": "^mapping\\.likec4\\.[a-z0-9][a-z0-9-]*$" },
+    "exportMode": { "const": "export-first" },
+    "native": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["nodeKinds", "relationKinds"],
+      "properties": {
+        "nodeKinds": { "type": "array", "items": { "type": "string" }, "minItems": 1 },
+        "relationKinds": { "type": "array", "items": { "type": "string" }, "minItems": 1 }
+      }
+    },
+    "likec4": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["elementKinds", "relationLabels"],
+      "properties": {
+        "elementKinds": { "type": "array", "items": { "type": "string" }, "minItems": 1 },
+        "relationLabels": { "type": "array", "items": { "type": "string" }, "minItems": 1 }
+      }
+    },
+    "views": { "type": "array", "items": { "type": "string" }, "minItems": 1 }
+  }
+}

package/schemas/integrations/structurizr-mapping.schema.json

@@ -0,0 +1,33 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://archctx.repoharness.com/schemas/integrations/structurizr-mapping.schema.json",
+  "title": "StructurizrMapping",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "id", "exportMode", "native", "structurizr", "views"],
+  "properties": {
+    "schemaVersion": { "const": "archcontext.structurizr-mapping/v1" },
+    "id": { "type": "string", "pattern": "^mapping\\.structurizr\\.[a-z0-9][a-z0-9-]*$" },
+    "exportMode": { "const": "export-first" },
+    "native": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["nodeKinds", "relationKinds"],
+      "properties": {
+        "nodeKinds": { "type": "array", "items": { "type": "string" }, "minItems": 1 },
+        "relationKinds": { "type": "array", "items": { "type": "string" }, "minItems": 1 }
+      }
+    },
+    "structurizr": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["workspace", "model", "views"],
+      "properties": {
+        "workspace": { "type": "string" },
+        "model": { "type": "array", "items": { "type": "string" }, "minItems": 1 },
+        "views": { "type": "array", "items": { "type": "string" }, "minItems": 1 }
+      }
+    },
+    "views": { "type": "array", "items": { "type": "string" }, "minItems": 1 }
+  }
+}

package/schemas/repo/architecture-intervention.schema.json

@@ -0,0 +1,41 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://archctx.repoharness.com/schemas/repo/architecture-intervention.schema.json",
+  "title": "ArchitectureIntervention",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "id", "status", "trigger", "thesis", "targetState", "constraints", "strategy", "completionCriteria"],
+  "properties": {
+    "schemaVersion": { "const": "archcontext.intervention/v1" },
+    "id": { "type": "string", "pattern": "^[a-z][a-z0-9]*(\\.[a-z0-9][a-z0-9-]*)+$" },
+    "status": { "type": "string", "enum": ["proposed", "approved", "in-progress", "complete", "rejected"] },
+    "trigger": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["task", "pressure", "confidence", "signals"],
+      "properties": {
+        "task": { "type": "string" },
+        "pressure": { "type": "string", "enum": ["low", "medium", "high"] },
+        "confidence": { "type": "string", "enum": ["low", "medium", "high"] },
+        "signals": { "type": "array", "items": { "type": "string" } }
+      }
+    },
+    "thesis": { "type": "string" },
+    "targetState": { "type": "object", "additionalProperties": true },
+    "constraints": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["real", "inherited"],
+      "properties": {
+        "real": { "type": "array", "items": { "type": "string" } },
+        "inherited": { "type": "array", "items": { "type": "string" } }
+      }
+    },
+    "strategy": { "type": "object", "additionalProperties": true, "required": ["selected"] },
+    "proofPoint": { "type": "object", "additionalProperties": true },
+    "falsifiers": { "type": "array", "items": { "type": "string" } },
+    "killList": { "type": "array", "items": { "type": "object", "additionalProperties": true } },
+    "completionCriteria": { "type": "array", "items": { "type": "string" }, "minItems": 1 },
+    "extensions": { "type": "object", "additionalProperties": true }
+  }
+}

package/schemas/repo/architecture-node.schema.json

@@ -0,0 +1,50 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://archctx.repoharness.com/schemas/repo/architecture-node.schema.json",
+  "title": "ArchitectureNode",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "id", "kind", "name", "status", "summary"],
+  "properties": {
+    "schemaVersion": { "const": "archcontext.node/v1" },
+    "id": { "type": "string", "pattern": "^([a-z][a-z0-9]*(\\.[a-z0-9][a-z0-9-]*)*::)?[a-z][a-z0-9]*(\\.[a-z0-9][a-z0-9-]*)+$" },
+    "kind": {
+      "type": "string",
+      "enum": ["capability", "module", "component", "interface", "event", "datastore", "external-system", "deployment"]
+    },
+    "name": { "type": "string" },
+    "status": { "type": "string", "enum": ["active", "planned", "deprecated", "removed"] },
+    "parent": { "type": "string", "pattern": "^([a-z][a-z0-9]*(\\.[a-z0-9][a-z0-9-]*)*::)?[a-z][a-z0-9]*(\\.[a-z0-9][a-z0-9-]*)+$" },
+    "summary": { "type": "string" },
+    "responsibilities": { "type": "array", "items": { "type": "string" }, "minItems": 1 },
+    "source": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "include": { "type": "array", "items": { "type": "string" } },
+        "exclude": { "type": "array", "items": { "type": "string" } },
+        "entrypoints": { "type": "array", "items": { "type": "string" } }
+      }
+    },
+    "ownership": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "lifecycle": { "type": "array", "items": { "type": "string" } },
+        "data": { "type": "array", "items": { "type": "string" } }
+      }
+    },
+    "interfaces": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "provides": { "type": "array", "items": { "type": "string" } },
+        "consumes": { "type": "array", "items": { "type": "string" } }
+      }
+    },
+    "criticality": { "type": "string", "enum": ["low", "medium", "high", "critical"] },
+    "riskDomains": { "type": "array", "items": { "type": "string" } },
+    "notes": { "type": "array", "items": { "type": "string" } },
+    "extensions": { "type": "object", "additionalProperties": true }
+  }
+}

package/schemas/repo/architecture-relation.schema.json

@@ -0,0 +1,26 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://archctx.repoharness.com/schemas/repo/architecture-relation.schema.json",
+  "title": "ArchitectureRelation",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "id", "kind", "source", "target", "intent"],
+  "properties": {
+    "schemaVersion": { "const": "archcontext.relation/v1" },
+    "id": { "type": "string", "pattern": "^([a-z][a-z0-9]*(\\.[a-z0-9][a-z0-9-]*)*::)?[a-z][a-z0-9]*(\\.[a-z0-9][a-z0-9-]*)+$" },
+    "kind": {
+      "type": "string",
+      "enum": ["depends-on", "calls", "publishes", "subscribes", "reads", "writes", "implements", "deployed-on"]
+    },
+    "source": { "type": "string", "pattern": "^([a-z][a-z0-9]*(\\.[a-z0-9][a-z0-9-]*)*::)?[a-z][a-z0-9]*(\\.[a-z0-9][a-z0-9-]*)+$" },
+    "target": { "type": "string", "pattern": "^([a-z][a-z0-9]*(\\.[a-z0-9][a-z0-9-]*)*::)?[a-z][a-z0-9]*(\\.[a-z0-9][a-z0-9-]*)+$" },
+    "via": { "type": "string", "pattern": "^([a-z][a-z0-9]*(\\.[a-z0-9][a-z0-9-]*)*::)?[a-z][a-z0-9]*(\\.[a-z0-9][a-z0-9-]*)+$" },
+    "protocol": { "type": "string" },
+    "synchrony": { "type": "string", "enum": ["synchronous", "asynchronous", "batch"] },
+    "intent": { "type": "string" },
+    "allowedData": { "type": "array", "items": { "type": "string" } },
+    "forbiddenData": { "type": "array", "items": { "type": "string" } },
+    "criticality": { "type": "string", "enum": ["low", "medium", "high", "critical"] },
+    "extensions": { "type": "object", "additionalProperties": true }
+  }
+}