@eir-labs/coltrane 0.24.33 → 0.24.35

package/domain_types/release-note.json

@@ -0,0 +1,66 @@
+{
+  "slug": "release-note",
+  "version": 1,
+  "extends": "Artifact",
+  "domain": "release",
+  "status": "active",
+  "schema": {
+    "type": "object",
+    "properties": {
+      "version": {
+        "type": "string"
+      },
+      "headline": {
+        "type": "string",
+        "description": "one line a reader can scan in a list, in plain language; names what changed, never 'various improvements'"
+      },
+      "plain_md": {
+        "type": "string",
+        "description": "the plain register: what this release means for someone using coltrane, in their words (a tool they call, a flag they pass, a variable they set). No internal vocabulary, no gig ids, no costs."
+      },
+      "formal_md": {
+        "type": "string",
+        "description": "the formal register: version, tag, date, bump, the commits by subject, the law counts at both ends, and each surface change as it stands in the record"
+      },
+      "claims": {
+        "type": "array",
+        "description": "every factual claim the prose makes, each paired with the field of the release-record that supports it. A claim with no evidence is what the verify seat refuses.",
+        "items": {
+          "type": "object",
+          "properties": {
+            "text": {
+              "type": "string",
+              "description": "the claim as the prose states it"
+            },
+            "evidence": {
+              "type": "string",
+              "description": "the record path that supports it, e.g. surface.cli_flags.added[0] or laws.after"
+            },
+            "value": {
+              "type": "string",
+              "description": "the value read at that path"
+            }
+          },
+          "required": [
+            "text",
+            "evidence"
+          ]
+        }
+      },
+      "unreadable": {
+        "type": "array",
+        "description": "the surfaces the record marks unread, named for the reader so a gap is stated rather than implied",
+        "items": {
+          "type": "string"
+        }
+      }
+    }
+  },
+  "required_fields": [
+    "version",
+    "headline",
+    "plain_md",
+    "formal_md",
+    "claims"
+  ]
+}

package/domain_types/release-record.json

@@ -0,0 +1,59 @@
+{
+  "slug": "release-record",
+  "version": 1,
+  "extends": "Signal",
+  "domain": "release",
+  "status": "active",
+  "schema": {
+    "type": "object",
+    "properties": {
+      "version": {
+        "type": "string",
+        "description": "the semver this release carries, without the v prefix"
+      },
+      "tag": {
+        "type": "string"
+      },
+      "date": {
+        "type": "string",
+        "description": "the tag's commit date, ISO"
+      },
+      "bump": {
+        "type": "string",
+        "description": "major | minor | patch, derived from the range's commit subjects"
+      },
+      "commits": {
+        "type": "array",
+        "description": "{sha, subject}, oldest first, for the range since the previous tag",
+        "items": {
+          "type": "object"
+        }
+      },
+      "laws": {
+        "type": "object",
+        "description": "{before, after, files} read from scripts/laws.sh at each end; null where a count could not be read"
+      },
+      "surface": {
+        "type": "object",
+        "description": "per surface (mcp_tools, mcp_tool_args, cli_flags, env_vars, domain_types) a sorted {added, removed}, or null when that surface could not be read at this tag"
+      },
+      "surface_unread": {
+        "type": "array",
+        "description": "the surfaces whose file was present but yielded nothing readable",
+        "items": {
+          "type": "string"
+        }
+      },
+      "source": {
+        "type": "string"
+      }
+    }
+  },
+  "required_fields": [
+    "version",
+    "tag",
+    "date",
+    "commits",
+    "surface"
+  ]
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eir-labs/coltrane",
-  "version": "0.24.33",
+  "version": "0.24.35",
   "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",
@@ -61,7 +61,8 @@
       "types": "./dist/src/genome_schema.d.ts",
       "import": "./dist/src/genome_schema.js",
       "default": "./dist/src/genome_schema.js"
-    }
+    },
+    "./releases.json": "./releases.json"
   },
   "files": [
     "dist/src",
@@ -76,13 +77,14 @@
     "tours",
     "evals",
     "README.md",
-    "LICENSE"
+    "LICENSE",
+    "releases.json"
   ],
   "publishConfig": {
     "access": "public"
   },
   "scripts": {
-    "build": "tsc && cp src/skill_runner.mjs dist/src/ && chmod +x dist/src/server_entry.js dist/src/server_relay.js dist/src/cli_entry.js",
+    "build": "tsc && cp src/skill_runner.mjs dist/src/ && chmod +x dist/src/server_entry.js dist/src/server_relay.js dist/src/cli_entry.js && node scripts/emit_releases.mjs --allow-unavailable",
     "dev": "tsc --watch",
     "prepare": "npm run build",
     "test": "bash scripts/laws.sh",