@coordiation/agent 0.1.0 → 1.0.0-rc.1

package/production-record.schema.json

@@ -0,0 +1,127 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://coordiation.com/schemas/production-record.schema.json",
+  "title": "Coordiation Production record",
+  "type": "object",
+  "required": ["schemaVersion", "id", "kind", "stage", "status", "derivedFrom", "acceptanceCriteria", "evidence", "body"],
+  "properties": {
+    "schemaVersion": { "const": "1.0" },
+    "id": { "type": "string", "pattern": "^DEPLOY-[0-9]{3}$" },
+    "kind": { "const": "production-record" },
+    "stage": { "const": "production" },
+    "status": { "enum": ["draft", "approved", "superseded"] },
+    "derivedFrom": { "type": "array", "minItems": 1, "items": { "type": "string", "pattern": "^RELEASE-[0-9]{3}$" }, "uniqueItems": true },
+    "acceptanceCriteria": { "type": "array", "minItems": 4, "items": { "type": "string", "pattern": "^AC-[0-9]{3}$" }, "uniqueItems": true },
+    "evidence": { "type": "array", "items": { "type": "string", "pattern": "^EVIDENCE-[0-9]{3}$" }, "uniqueItems": true },
+    "body": {
+      "type": "object",
+      "required": ["capability", "deployment", "authority", "configuration", "rollout", "healthChecks", "healthStatus", "monitoring", "monitoringStatus", "rollback", "requiredEvidence", "incidents", "feedback", "productionBlockers", "openDecisions"],
+      "properties": {
+        "capability": { "type": "string", "minLength": 1 },
+        "deployment": {
+          "type": "object",
+          "required": ["id", "environment", "releaseId", "version", "candidateId", "sourceRevision", "status", "completedAt"],
+          "properties": {
+            "id": { "type": "string", "minLength": 1 },
+            "environment": { "type": "string", "pattern": "^[a-z0-9][a-z0-9-]*$" },
+            "releaseId": { "type": "string", "pattern": "^RELEASE-[0-9]{3}$" },
+            "version": { "type": "string", "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+(?:-[0-9A-Za-z.-]+)?$" },
+            "candidateId": { "type": "string", "minLength": 1 },
+            "sourceRevision": { "type": "string", "minLength": 7, "maxLength": 128 },
+            "status": { "enum": ["planned", "deployed", "failed"] },
+            "completedAt": { "type": ["string", "null"], "format": "date-time" }
+          },
+          "additionalProperties": false
+        },
+        "authority": {
+          "type": "object",
+          "required": ["releaseApprovalRequired", "releaseId", "rule"],
+          "properties": {
+            "releaseApprovalRequired": { "const": true },
+            "releaseId": { "type": "string", "pattern": "^RELEASE-[0-9]{3}$" },
+            "rule": { "type": "string", "minLength": 1 }
+          },
+          "additionalProperties": false
+        },
+        "configuration": {
+          "type": "object",
+          "required": ["requiredVariableNames", "secretValuesStored", "validation"],
+          "properties": {
+            "requiredVariableNames": { "type": "array", "items": { "type": "string", "pattern": "^[A-Z][A-Z0-9_]*$" }, "uniqueItems": true },
+            "secretValuesStored": { "const": false },
+            "validation": { "type": "string", "minLength": 1 }
+          },
+          "additionalProperties": false
+        },
+        "rollout": {
+          "type": "object",
+          "required": ["strategy", "batches", "currentBatch", "pauseConditions"],
+          "properties": {
+            "strategy": { "type": "string", "minLength": 1 },
+            "batches": { "type": "array", "minItems": 2 },
+            "currentBatch": { "type": "string", "minLength": 1 },
+            "pauseConditions": { "type": "array", "minItems": 2, "items": { "type": "string" } }
+          },
+          "additionalProperties": false
+        },
+        "healthChecks": {
+          "type": "array",
+          "minItems": 3,
+          "items": {
+            "type": "object",
+            "required": ["id", "signal", "successCondition"],
+            "properties": {
+              "id": { "type": "string", "pattern": "^RELEASE-[0-9]{3}-HEALTH-[0-9]{3}$" },
+              "signal": { "type": "string", "minLength": 1 },
+              "successCondition": { "type": "string", "minLength": 1 }
+            },
+            "additionalProperties": false
+          }
+        },
+        "healthStatus": { "enum": ["pending", "healthy", "unhealthy"] },
+        "monitoring": {
+          "type": "object",
+          "required": ["signals", "alerts", "observationWindow"],
+          "properties": {
+            "signals": { "type": "array", "minItems": 4, "items": { "type": "string" }, "uniqueItems": true },
+            "alerts": {
+              "type": "array",
+              "minItems": 2,
+              "items": {
+                "type": "object",
+                "required": ["signal", "condition", "owner"],
+                "properties": {
+                  "signal": { "type": "string", "minLength": 1 },
+                  "condition": { "type": "string", "minLength": 1 },
+                  "owner": { "type": "string", "minLength": 1 }
+                },
+                "additionalProperties": false
+              }
+            },
+            "observationWindow": { "type": "string", "minLength": 1 }
+          },
+          "additionalProperties": false
+        },
+        "monitoringStatus": { "enum": ["pending", "active", "degraded"] },
+        "rollback": {
+          "type": "object",
+          "required": ["candidate", "triggers", "steps", "owner", "readiness"],
+          "properties": {
+            "candidate": { "type": "string", "minLength": 1 },
+            "triggers": { "type": "array", "minItems": 2, "items": { "type": "string" } },
+            "steps": { "type": "array", "minItems": 3, "items": { "type": "string" } },
+            "owner": { "type": "string", "minLength": 1 },
+            "readiness": { "enum": ["pending", "ready", "not-ready"] }
+          },
+          "additionalProperties": false
+        },
+        "requiredEvidence": { "type": "array", "const": ["deployment", "health", "monitoring", "rollback-readiness"] },
+        "incidents": { "type": "array" },
+        "feedback": { "type": "array" },
+        "productionBlockers": { "type": "array" },
+        "openDecisions": { "type": "array" }
+      },
+      "additionalProperties": false
+    }
+  }
+}

package/prototype-contract.schema.json

@@ -0,0 +1,115 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://coordiation.com/schemas/prototype-contract.schema.json",
+  "title": "Coordiation interactive prototype contract",
+  "type": "object",
+  "required": ["schemaVersion", "id", "kind", "stage", "status", "revision", "derivedFrom", "acceptanceCriteria", "body"],
+  "properties": {
+    "schemaVersion": { "const": "1.0" },
+    "id": { "type": "string", "pattern": "^PROTO-[0-9]{3}$" },
+    "kind": { "const": "prototype-contract" },
+    "stage": { "const": "prototype" },
+    "status": { "enum": ["draft", "approved", "superseded"] },
+    "revision": { "type": "integer", "minimum": 1 },
+    "derivedFrom": { "type": "array", "minItems": 1, "items": { "type": "string", "pattern": "^UX-[0-9]{3}$" } },
+    "acceptanceCriteria": { "type": "array", "minItems": 4, "items": { "type": "string", "pattern": "^AC-[0-9]{3}$" }, "uniqueItems": true },
+    "body": {
+      "type": "object",
+      "required": ["capability", "fidelity", "frameworkContract", "componentPlan", "layoutContract", "statePreviews", "interactionMap", "viewportMatrix", "motionContract", "mockAdapter", "evidenceRequirements", "openDecisions"],
+      "properties": {
+        "capability": { "type": "string", "minLength": 1 },
+        "fidelity": { "type": "string", "minLength": 1 },
+        "frameworkContract": {
+          "type": "object",
+          "required": ["css", "components", "icons", "runtime"],
+          "properties": {
+            "css": { "type": "string", "pattern": "@coordiation/css" },
+            "components": { "type": "string", "pattern": "@coordiation/ui" },
+            "icons": { "type": "string", "pattern": "@coordiation/icons" },
+            "runtime": { "type": "string" }
+          },
+          "additionalProperties": false
+        },
+        "componentPlan": {
+          "type": "array",
+          "minItems": 5,
+          "items": {
+            "type": "object",
+            "required": ["registryId", "role"],
+            "properties": {
+              "registryId": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" },
+              "role": { "type": "string", "minLength": 1 }
+            },
+            "additionalProperties": false
+          }
+        },
+        "layoutContract": {
+          "type": "object",
+          "required": ["shell", "content", "rules"],
+          "properties": {
+            "shell": { "$ref": "#/$defs/classes" },
+            "content": { "$ref": "#/$defs/classes" },
+            "rules": { "type": "array", "minItems": 1, "items": { "type": "string" } }
+          },
+          "additionalProperties": false
+        },
+        "statePreviews": {
+          "type": "array",
+          "minItems": 5,
+          "items": {
+            "type": "object",
+            "required": ["id", "fixture", "purpose", "visibleContent", "availableActions", "componentIds"],
+            "properties": {
+              "id": { "type": "string" },
+              "fixture": { "type": "string" },
+              "purpose": { "type": "string" },
+              "visibleContent": { "type": "array", "items": { "type": "string" } },
+              "availableActions": { "type": "array", "items": { "type": "string" } },
+              "componentIds": { "type": "array", "minItems": 5, "items": { "type": "string" } }
+            },
+            "additionalProperties": false
+          }
+        },
+        "interactionMap": { "type": "array", "minItems": 4 },
+        "viewportMatrix": {
+          "type": "array",
+          "minItems": 3,
+          "items": {
+            "type": "object",
+            "required": ["width", "label", "requirement"],
+            "properties": {
+              "width": { "enum": [320, 768, 1280] },
+              "label": { "type": "string" },
+              "requirement": { "type": "string" }
+            },
+            "additionalProperties": false
+          }
+        },
+        "motionContract": {
+          "type": "object",
+          "required": ["classes", "rules"],
+          "properties": {
+            "classes": { "$ref": "#/$defs/classes" },
+            "rules": { "type": "array", "minItems": 1, "items": { "type": "string" } }
+          }
+        },
+        "mockAdapter": { "type": "object", "required": ["policy", "fixtures", "reset"] },
+        "evidenceRequirements": {
+          "type": "object",
+          "required": ["screenshots", "keyboardPath", "accessibility", "acceptanceCriteria"],
+          "properties": {
+            "screenshots": { "type": "array", "minItems": 15 },
+            "keyboardPath": { "type": "string", "minLength": 1 },
+            "accessibility": { "type": "string", "minLength": 1 },
+            "acceptanceCriteria": { "type": "array", "minItems": 4 }
+          }
+        },
+        "openDecisions": { "type": "array" }
+      },
+      "additionalProperties": false
+    }
+  },
+  "$defs": {
+    "classes": { "type": "array", "minItems": 1, "items": { "type": "string", "pattern": "(^|:)co-" } }
+  }
+}

package/qa-report.schema.json

@@ -0,0 +1,87 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://coordiation.com/schemas/qa-report.schema.json",
+  "title": "Coordiation QA report",
+  "type": "object",
+  "required": ["schemaVersion", "id", "kind", "stage", "status", "derivedFrom", "acceptanceCriteria", "evidence", "body"],
+  "properties": {
+    "schemaVersion": { "const": "1.0" },
+    "id": { "type": "string", "pattern": "^QA-[0-9]{3}$" },
+    "kind": { "const": "qa-report" },
+    "stage": { "const": "qa" },
+    "status": { "enum": ["draft", "approved", "superseded"] },
+    "derivedFrom": { "type": "array", "minItems": 1, "items": { "type": "string", "pattern": "^DEV-[0-9]{3}$" }, "uniqueItems": true },
+    "acceptanceCriteria": { "type": "array", "minItems": 4, "items": { "type": "string", "pattern": "^AC-[0-9]{3}$" }, "uniqueItems": true },
+    "evidence": { "type": "array", "items": { "type": "string", "pattern": "^EVIDENCE-[0-9]{3}$" }, "uniqueItems": true },
+    "body": {
+      "type": "object",
+      "required": ["capability", "strategy", "testCases", "stateCoverage", "viewportCoverage", "accessibilityChecklist", "securityChecklist", "regressionScope", "requiredEvidence", "releaseBlockers", "openDecisions"],
+      "properties": {
+        "capability": { "type": "string", "minLength": 1 },
+        "strategy": { "type": "string", "minLength": 1 },
+        "testCases": {
+          "type": "array",
+          "minItems": 4,
+          "items": {
+            "type": "object",
+            "required": ["id", "criterionId", "statement", "preconditions", "steps", "expected", "evidenceTypes"],
+            "properties": {
+              "id": { "type": "string", "pattern": "^QA-[0-9]{3}-CASE-[0-9]{3}$" },
+              "criterionId": { "type": "string", "pattern": "^AC-[0-9]{3}$" },
+              "statement": { "type": "string", "minLength": 1 },
+              "preconditions": { "type": "array", "minItems": 1, "items": { "type": "string" } },
+              "steps": { "type": "array", "minItems": 1, "items": { "type": "string" } },
+              "expected": { "type": "string", "minLength": 1 },
+              "evidenceTypes": { "type": "array", "minItems": 1, "items": { "enum": ["functional", "visual", "accessibility", "security", "regression"] }, "uniqueItems": true }
+            },
+            "additionalProperties": false
+          }
+        },
+        "stateCoverage": {
+          "type": "array",
+          "minItems": 5,
+          "items": {
+            "type": "object",
+            "required": ["stateId", "fixture", "checks"],
+            "properties": {
+              "stateId": { "type": "string", "minLength": 1 },
+              "fixture": { "type": "string", "minLength": 1 },
+              "checks": { "type": "array", "minItems": 3, "items": { "type": "string" } }
+            },
+            "additionalProperties": false
+          }
+        },
+        "viewportCoverage": {
+          "type": "array",
+          "minItems": 3,
+          "items": {
+            "type": "object",
+            "required": ["width", "label", "requirement"],
+            "properties": {
+              "width": { "enum": [320, 768, 1280] },
+              "label": { "type": "string", "minLength": 1 },
+              "requirement": { "type": "string", "minLength": 1 }
+            }
+          }
+        },
+        "accessibilityChecklist": { "type": "array", "minItems": 7, "items": { "type": "string" } },
+        "securityChecklist": { "type": "array", "minItems": 5, "items": { "type": "string" } },
+        "regressionScope": {
+          "type": "object",
+          "required": ["components", "utilities", "upstreamArtifacts", "requirement"],
+          "properties": {
+            "components": { "type": "array", "items": { "type": "string" } },
+            "utilities": { "type": "array", "items": { "type": "string" } },
+            "upstreamArtifacts": { "type": "array", "items": { "type": "string" } },
+            "requirement": { "type": "string", "minLength": 1 }
+          },
+          "additionalProperties": false
+        },
+        "requiredEvidence": { "type": "array", "const": ["functional", "visual", "accessibility", "security", "regression"] },
+        "releaseBlockers": { "type": "array" },
+        "openDecisions": { "type": "array" }
+      },
+      "additionalProperties": false
+    }
+  }
+}

package/release-record.schema.json

@@ -0,0 +1,141 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://coordiation.com/schemas/release-record.schema.json",
+  "title": "Coordiation release record",
+  "type": "object",
+  "required": ["schemaVersion", "id", "kind", "stage", "status", "derivedFrom", "acceptanceCriteria", "evidence", "body"],
+  "properties": {
+    "schemaVersion": { "const": "1.0" },
+    "id": { "type": "string", "pattern": "^RELEASE-[0-9]{3}$" },
+    "kind": { "const": "release-record" },
+    "stage": { "const": "release" },
+    "status": { "enum": ["draft", "approved", "superseded"] },
+    "derivedFrom": { "type": "array", "minItems": 1, "items": { "type": "string", "pattern": "^QA-[0-9]{3}$" }, "uniqueItems": true },
+    "acceptanceCriteria": { "type": "array", "minItems": 4, "items": { "type": "string", "pattern": "^AC-[0-9]{3}$" }, "uniqueItems": true },
+    "evidence": { "type": "array", "items": { "type": "string", "pattern": "^EVIDENCE-[0-9]{3}$" }, "uniqueItems": true },
+    "body": {
+      "type": "object",
+      "required": ["capability", "version", "candidate", "changelog", "compatibility", "migration", "environment", "rollout", "healthChecks", "rollback", "requiredEvidence", "releaseBlockers", "openDecisions"],
+      "properties": {
+        "capability": { "type": "string", "minLength": 1 },
+        "version": { "type": "string", "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+(?:-[0-9A-Za-z.-]+)?$" },
+        "candidate": {
+          "type": "object",
+          "required": ["id", "snapshotSha256", "sourceQa", "acceptanceCriteria"],
+          "properties": {
+            "id": { "type": "string", "minLength": 1 },
+            "snapshotSha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+            "sourceQa": {
+              "type": "object",
+              "required": ["id", "revision"],
+              "properties": {
+                "id": { "type": "string", "pattern": "^QA-[0-9]{3}$" },
+                "revision": { "type": "integer", "minimum": 1 }
+              },
+              "additionalProperties": false
+            },
+            "acceptanceCriteria": { "type": "array", "minItems": 4, "items": { "type": "string", "pattern": "^AC-[0-9]{3}$" }, "uniqueItems": true }
+          },
+          "additionalProperties": false
+        },
+        "changelog": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "type": "object",
+            "required": ["type", "summary", "requirementIds"],
+            "properties": {
+              "type": { "enum": ["feature", "fix", "change", "deprecation", "security"] },
+              "summary": { "type": "string", "minLength": 1 },
+              "requirementIds": { "type": "array", "minItems": 1, "items": { "type": "string", "pattern": "^AC-[0-9]{3}$" }, "uniqueItems": true }
+            },
+            "additionalProperties": false
+          }
+        },
+        "compatibility": {
+          "type": "object",
+          "required": ["framework", "coordiation", "breakingChanges", "support"],
+          "properties": {
+            "framework": { "type": "string", "minLength": 1 },
+            "coordiation": { "type": "array", "minItems": 1, "items": { "type": "string" }, "uniqueItems": true },
+            "breakingChanges": { "type": "array" },
+            "support": { "type": "string", "minLength": 1 }
+          },
+          "additionalProperties": false
+        },
+        "migration": {
+          "type": "object",
+          "required": ["required", "steps", "reversibility"],
+          "properties": {
+            "required": { "type": "boolean" },
+            "steps": { "type": "array", "minItems": 1, "items": { "type": "string" } },
+            "reversibility": { "type": "string", "minLength": 1 }
+          },
+          "additionalProperties": false
+        },
+        "environment": {
+          "type": "object",
+          "required": ["variableNames", "secretValuesStored", "validation"],
+          "properties": {
+            "variableNames": { "type": "array", "items": { "type": "string", "pattern": "^[A-Z][A-Z0-9_]*$" }, "uniqueItems": true },
+            "secretValuesStored": { "const": false },
+            "validation": { "type": "string", "minLength": 1 }
+          },
+          "additionalProperties": false
+        },
+        "rollout": {
+          "type": "object",
+          "required": ["strategy", "batches", "pauseConditions"],
+          "properties": {
+            "strategy": { "type": "string", "minLength": 1 },
+            "batches": {
+              "type": "array",
+              "minItems": 2,
+              "items": {
+                "type": "object",
+                "required": ["name", "audience", "percentage"],
+                "properties": {
+                  "name": { "type": "string", "minLength": 1 },
+                  "audience": { "type": "string", "minLength": 1 },
+                  "percentage": { "type": "number", "minimum": 0, "maximum": 100 }
+                },
+                "additionalProperties": false
+              }
+            },
+            "pauseConditions": { "type": "array", "minItems": 2, "items": { "type": "string" } }
+          },
+          "additionalProperties": false
+        },
+        "healthChecks": {
+          "type": "array",
+          "minItems": 3,
+          "items": {
+            "type": "object",
+            "required": ["id", "signal", "successCondition"],
+            "properties": {
+              "id": { "type": "string", "pattern": "^RELEASE-[0-9]{3}-HEALTH-[0-9]{3}$" },
+              "signal": { "type": "string", "minLength": 1 },
+              "successCondition": { "type": "string", "minLength": 1 }
+            },
+            "additionalProperties": false
+          }
+        },
+        "rollback": {
+          "type": "object",
+          "required": ["triggers", "steps", "owner", "maximumDecisionTime"],
+          "properties": {
+            "triggers": { "type": "array", "minItems": 2, "items": { "type": "string" } },
+            "steps": { "type": "array", "minItems": 3, "items": { "type": "string" } },
+            "owner": { "type": "string", "minLength": 1 },
+            "maximumDecisionTime": { "type": "string", "minLength": 1 }
+          },
+          "additionalProperties": false
+        },
+        "requiredEvidence": { "type": "array", "const": ["candidate", "release-notes", "rollback-validation"] },
+        "releaseBlockers": { "type": "array" },
+        "openDecisions": { "type": "array" }
+      },
+      "additionalProperties": false
+    }
+  }
+}

package/schema-registry.json

@@ -0,0 +1,29 @@
+{
+  "schemaVersion": "1.0",
+  "kind": "coordiation-schema-registry",
+  "currentLifecycleVersion": "1.0",
+  "supportedLifecycleVersions": ["1.0"],
+  "policy": {
+    "major": "Breaking field, identifier, gate, or semantic changes require an explicit migration.",
+    "minor": "Additive optional fields and new artifact capabilities remain backward-compatible.",
+    "patch": "Clarifications and validation fixes may not change valid artifact meaning.",
+    "unknown": "Unknown versions are rejected instead of being guessed or silently rewritten."
+  },
+  "schemas": [
+    "product-project.schema.json",
+    "lifecycle.schema.json",
+    "artifact.schema.json",
+    "traceability.schema.json",
+    "approvals.schema.json",
+    "evidence.schema.json",
+    "interview.schema.json",
+    "capability-template.schema.json",
+    "ux-contract.schema.json",
+    "prototype-contract.schema.json",
+    "development-contract.schema.json",
+    "qa-report.schema.json",
+    "release-record.schema.json",
+    "production-record.schema.json",
+    "lifecycle-adapter.schema.json"
+  ]
+}

package/src/hardening.js

@@ -0,0 +1,69 @@
+import schemaRegistry from "../schema-registry.json" with { type: "json" };
+
+const ALLOWED_ADAPTER_HOOKS = new Set(["artifact.created", "artifact.revised", "evidence.recorded", "gate.checked", "artifact.approved"]);
+const lifecycleAdapters = new Map();
+
+function adapterManifest(value) {
+  const manifest = value?.manifest ?? value;
+  const id = String(manifest?.id ?? "").trim().toLowerCase();
+  const version = String(manifest?.version ?? "").trim();
+  const capabilities = [...new Set(manifest?.capabilities ?? [])];
+  const hooks = [...new Set(manifest?.hooks ?? [])];
+  if (!/^[a-z0-9][a-z0-9-]*$/.test(id)) throw new Error("Lifecycle adapter id must use lowercase letters, numbers, and hyphens.");
+  if (!/^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$/.test(version)) throw new Error("Lifecycle adapter version must use semantic versioning.");
+  if (!capabilities.every((entry) => typeof entry === "string" && entry.trim())) throw new Error("Lifecycle adapter capabilities must be non-empty strings.");
+  if (!hooks.every((hook) => ALLOWED_ADAPTER_HOOKS.has(hook))) throw new Error(`Lifecycle adapter hooks must be one of: ${[...ALLOWED_ADAPTER_HOOKS].join(", ")}.`);
+  return { id, version, capabilities, hooks };
+}
+
+export function getSchemaCompatibility(version = schemaRegistry.currentLifecycleVersion) {
+  const requestedVersion = String(version ?? "").trim();
+  const compatible = schemaRegistry.supportedLifecycleVersions.includes(requestedVersion);
+  return {
+    schemaVersion: schemaRegistry.schemaVersion,
+    kind: "coordiation-schema-compatibility",
+    requestedVersion,
+    currentVersion: schemaRegistry.currentLifecycleVersion,
+    supportedVersions: schemaRegistry.supportedLifecycleVersions,
+    compatible,
+    mode: compatible ? (requestedVersion === schemaRegistry.currentLifecycleVersion ? "current" : "compatible") : "migration-required",
+    policy: schemaRegistry.policy,
+  };
+}
+
+export function assertSchemaCompatibility(version) {
+  const result = getSchemaCompatibility(version);
+  if (!result.compatible) throw new Error(`Unsupported Coordiation lifecycle schema ${result.requestedVersion || "(missing)"}. Current supported version: ${result.currentVersion}. Run an explicit migration before reading or writing artifacts.`);
+  return result;
+}
+
+export function registerLifecycleAdapter(definition, handlers = definition?.handlers ?? {}, { overwrite = false } = {}) {
+  const manifest = adapterManifest(definition);
+  if (lifecycleAdapters.has(manifest.id) && !overwrite) throw new Error(`Lifecycle adapter already registered: ${manifest.id}.`);
+  for (const hook of manifest.hooks) if (typeof handlers[hook] !== "function") throw new Error(`Lifecycle adapter ${manifest.id} requires a function handler for ${hook}.`);
+  lifecycleAdapters.set(manifest.id, { manifest, handlers: Object.fromEntries(manifest.hooks.map((hook) => [hook, handlers[hook]])) });
+  return manifest;
+}
+
+export function listLifecycleAdapters() {
+  return [...lifecycleAdapters.values()].map(({ manifest }) => structuredClone(manifest)).sort((left, right) => left.id.localeCompare(right.id));
+}
+
+export function unregisterLifecycleAdapter(id) {
+  return lifecycleAdapters.delete(String(id ?? "").trim().toLowerCase());
+}
+
+export async function dispatchLifecycleAdapterHook(hook, payload, { adapterIds } = {}) {
+  if (!ALLOWED_ADAPTER_HOOKS.has(hook)) throw new Error(`Unknown lifecycle adapter hook: ${hook}.`);
+  const selected = adapterIds ? new Set(adapterIds.map((id) => String(id).trim().toLowerCase())) : null;
+  const results = [];
+  for (const { manifest, handlers } of lifecycleAdapters.values()) {
+    if (selected && !selected.has(manifest.id)) continue;
+    if (!manifest.hooks.includes(hook)) continue;
+    const output = await handlers[hook](structuredClone(payload), structuredClone(manifest));
+    results.push({ adapterId: manifest.id, hook, output: output ?? null });
+  }
+  return { schemaVersion: schemaRegistry.schemaVersion, kind: "coordiation-adapter-dispatch", hook, results };
+}
+
+export { schemaRegistry };

package/src/index.js

@@ -177,7 +177,7 @@ export function createContextPack(topic, manifest) {
   if (!definition) throw new Error(`Unknown context topic: ${topic}. Available: ${Object.keys(contextPacks).join(", ")}`);
   const currentUtilities = manifest?.coordiation?.frequentUtilities ?? [];
   const relevantUtilities = currentUtilities.filter(({ candidate }) => definition.utilityHints.some((hint) => candidate.includes(hint.replace(/^.*:/, "").replace(/^co-/, "")))).slice(0, 15);
-  return {
+  const pack = {
     schemaVersion: AGENT_SCHEMA_VERSION,
     kind: "coordiation-context-pack",
     topic: normalized,
@@ -195,6 +195,13 @@ export function createContextPack(topic, manifest) {
     checks: definition.checks,
     workflow: ["inspect project", "reuse registered primitives", "generate literal classes", "validate checks", "run project build"],
   };
+  pack.contextBudget = { bytes: 0, estimatedTokens: 0, targetTokens: 1200, withinTarget: true };
+  for (let iteration = 0; iteration < 3; iteration += 1) {
+    const bytes = Buffer.byteLength(JSON.stringify(pack));
+    const estimatedTokens = Math.ceil(bytes / 4);
+    pack.contextBudget = { bytes, estimatedTokens, targetTokens: 1200, withinTarget: estimatedTokens <= 1200 };
+  }
+  return pack;
 }
 
 export async function writeAgentManifest(manifest, { cwd = process.cwd(), output = AGENT_MANIFEST_PATH } = {}) {
@@ -205,3 +212,41 @@ export async function writeAgentManifest(manifest, { cwd = process.cwd(), output
   await writeFile(destination, `${JSON.stringify(manifest, null, 2)}\n`);
   return compactPath(root, destination);
 }
+
+export {
+  LIFECYCLE_GATES,
+  LIFECYCLE_SCHEMA_VERSION,
+  LIFECYCLE_STAGES,
+  approveLifecycleArtifact,
+  checkLifecycleGate,
+  createDevelopmentContract,
+  createProductionRecord,
+  createPrototypeContract,
+  createQaReport,
+  createReleaseRecord,
+  createUxContract,
+  getLifecycleStatus,
+  getTraceability,
+  initializeLifecycleProject,
+  interviewTemplates,
+  listCapabilityTemplates,
+  registerCapabilityTemplate,
+  recordDevelopmentEvidence,
+  recordLifecycleEvidence,
+  recordProductionEvidence,
+  recordQaEvidence,
+  recordReleaseEvidence,
+  reviseLifecycleArtifact,
+  resolveCapabilityTemplate,
+  runRequirementInterview,
+} from "./lifecycle.js";
+
+export {
+  assertSchemaCompatibility,
+  dispatchLifecycleAdapterHook,
+  getSchemaCompatibility,
+  listLifecycleAdapters,
+  registerLifecycleAdapter,
+  schemaRegistry,
+  unregisterLifecycleAdapter,
+} from "./hardening.js";