@eir-labs/coltrane 0.24.11 → 0.24.13

package/dist/src/version.d.ts

@@ -1,5 +1,5 @@
 /** Engine semver. Keep in lockstep with package.json `version` (enforced by test). */
-export declare const COLTRANE_VERSION = "0.24.11";
+export declare const COLTRANE_VERSION = "0.24.13";
 /**
  * The commit this engine checkout is sitting on, or null when it can't be determined.
  *

package/dist/src/version.js

@@ -17,7 +17,7 @@ import { existsSync, readFileSync, statSync } from "node:fs";
 import { dirname, join, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 /** Engine semver. Keep in lockstep with package.json `version` (enforced by test). */
-export const COLTRANE_VERSION = "0.24.11";
+export const COLTRANE_VERSION = "0.24.13";
 /**
  * The commit this engine checkout is sitting on, or null when it can't be determined.
  *

package/domain_types/residency-spec.json

@@ -0,0 +1,112 @@
+{
+  "slug": "residency-spec",
+  "version": 1,
+  "extends": "Plan",
+  "domain": "residency",
+  "status": "active",
+  "schema": {
+    "type": "object",
+    "properties": {
+      "resident_identity": {
+        "type": "object",
+        "description": "The named agent holding the seat, speaking under its own identity per the identity law — never a person's.",
+        "properties": {
+          "name": {
+            "type": "string"
+          },
+          "voice": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "name"
+        ]
+      },
+      "seat_contract_source": {
+        "type": "string",
+        "description": "Locator of the handmade contract this spec transcribes (e.g. DESK_BOOT.md at a pinned revision)."
+      },
+      "canonical_repo": {
+        "type": "string",
+        "description": "The single canonical repository identity for the product the resident stewards."
+      },
+      "repo_aliases": {
+        "type": "array",
+        "items": {
+          "type": "string"
+        },
+        "description": "Other names in circulation for the same product, recorded so they cannot silently fork the identity."
+      },
+      "host": {
+        "type": "object",
+        "description": "The box the resident cohabits — the residency is a tenancy, not ownership.",
+        "properties": {
+          "platform_app": {
+            "type": "string"
+          },
+          "machine": {
+            "type": "string"
+          },
+          "shared_paths": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          }
+        }
+      },
+      "cohabitation_boundary": {
+        "type": "array",
+        "items": {
+          "type": "string"
+        },
+        "description": "What the tenant may and may not touch of its host, stated as observable constraints (paths, processes, credentials)."
+      },
+      "laws": {
+        "type": "array",
+        "items": {
+          "type": "string"
+        },
+        "description": "DESK_BOOT.md laws transcribed as governed constraints, each with a locator."
+      },
+      "hands": {
+        "type": "array",
+        "items": {
+          "type": "object",
+          "properties": {
+            "credential_class": {
+              "type": "string"
+            },
+            "grant": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "credential_class",
+            "grant"
+          ]
+        },
+        "description": "Credential grants by class name only, never values; seeded on-estate only per the chancery constraint."
+      },
+      "rails": {
+        "type": "array",
+        "items": {
+          "type": "string"
+        },
+        "description": "Phase gates the resident must pass — park-before-dispatch, deterministic-supervisor execution, toolbar review loop."
+      },
+      "approval_seat": {
+        "type": "string",
+        "description": "Where the spec parks for the sovereign's approval before any build order exists."
+      }
+    }
+  },
+  "required_fields": [
+    "resident_identity",
+    "seat_contract_source",
+    "canonical_repo",
+    "cohabitation_boundary",
+    "hands",
+    "approval_seat"
+  ]
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eir-labs/coltrane",
-  "version": "0.24.11",
+  "version": "0.24.13",
   "description": "A methodology engine \u2014 a typed substrate for defining agents, composing multi-phase standards, dispatching gigs, and sealing every output to a content-addressed ledger. Ships as an MCP server.",
   "type": "module",
   "license": "Apache-2.0",

package/standards/residency-spec-v0.json

@@ -67,6 +67,29 @@
       ],
       "intent": "Compose the buildable specification: architecture, the exact changes with their repositories and gates, preconditions, risks, rollback, and the receipts due — buildable as written, article for article."
     },
+    {
+      "name": "specify",
+      "chairs": [
+        {
+          "role": "specify",
+          "agent_slug": "solution-developer",
+          "depends_on": [
+            "contract",
+            "survey"
+          ],
+          "input_contract": [
+            "subsystem-contract",
+            "repo-survey"
+          ],
+          "output_contract": [
+            "residency-spec"
+          ],
+          "optional_outputs": [],
+          "required_skills": []
+        }
+      ],
+      "intent": "FILL the residency-spec instance the contract obligates: read the surveyed files from disk and populate every field of the residency-spec type — resident_identity, seat_contract_source, canonical_repo, repo_aliases, host, cohabitation_boundary, laws, hands, rails, approval_seat — each entry carrying a locator into a file actually read. The subsystem-contract's obligations are the checklist this phase satisfies; the survey is its ground. No obligation left as a promise: the spec is the artifact, not a description of the artifact."
+    },
     {
       "name": "approve",
       "chairs": [
@@ -75,10 +98,10 @@
           "agent_slug": "",
           "human": true,
           "depends_on": [
-            "contract"
+            "specify"
           ],
           "input_contract": [
-            "subsystem-contract"
+            "residency-spec"
           ],
           "output_contract": [
             "lineage-verdict"