@eir-labs/coltrane 0.24.36 → 0.24.38

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.36";
+export declare const COLTRANE_VERSION = "0.24.38";
 /**
  * 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.36";
+export const COLTRANE_VERSION = "0.24.38";
 /**
  * The commit this engine checkout is sitting on, or null when it can't be determined.
  *

package/domain_types/session-analysis.json

@@ -0,0 +1,59 @@
+{
+  "slug": "session-analysis",
+  "version": 1,
+  "extends": "Interpretation",
+  "domain": "session-review",
+  "status": "active",
+  "schema": {
+    "type": "object",
+    "properties": {
+      "where_the_cost_went": {
+        "type": "array",
+        "description": "each finding {finding, evidence, value} — which token class, which tool, which phase carried the bill",
+        "items": {
+          "type": "object"
+        }
+      },
+      "where_the_time_went": {
+        "type": "array",
+        "items": {
+          "type": "object"
+        }
+      },
+      "rework": {
+        "type": "array",
+        "description": "work that had to be done twice, with the census evidence that shows it (errors, denials, repeated operator corrections)",
+        "items": {
+          "type": "object"
+        }
+      },
+      "said_vs_done": {
+        "type": "array",
+        "description": "where the operator's messages and the tool histogram disagree — what was asked for versus what the session spent itself on",
+        "items": {
+          "type": "object"
+        }
+      },
+      "turning_points": {
+        "type": "array",
+        "description": "the moments the session changed direction, each anchored to an operator message",
+        "items": {
+          "type": "object"
+        }
+      },
+      "caveats": {
+        "type": "array",
+        "description": "what the census cannot show, stated so the writer does not fill the gap",
+        "items": {
+          "type": "string"
+        }
+      }
+    }
+  },
+  "required_fields": [
+    "where_the_cost_went",
+    "rework",
+    "turning_points",
+    "caveats"
+  ]
+}

package/domain_types/session-census.json

@@ -0,0 +1,72 @@
+{
+  "slug": "session-census",
+  "version": 1,
+  "extends": "Signal",
+  "domain": "session-review",
+  "status": "active",
+  "schema": {
+    "type": "object",
+    "properties": {
+      "transcript": {
+        "type": "string"
+      },
+      "bytes": {
+        "type": "number"
+      },
+      "records": {
+        "type": "number"
+      },
+      "span": {
+        "type": "object",
+        "description": "{first, last} timestamps of the transcript"
+      },
+      "turns": {
+        "type": "object",
+        "description": "assistant turns and the token classes they reported, plus the peak context"
+      },
+      "tools": {
+        "type": "array",
+        "description": "{name, calls}, most-called first",
+        "items": {
+          "type": "object"
+        }
+      },
+      "operator_messages": {
+        "type": "array",
+        "description": "the operator's own messages, identical ones collapsed to {text, count, first, last} — a repeated cron prompt is one decision said many times",
+        "items": {
+          "type": "object"
+        }
+      },
+      "interruptions": {
+        "type": "number"
+      },
+      "denials": {
+        "type": "array",
+        "items": {
+          "type": "object"
+        }
+      },
+      "errors": {
+        "type": "array",
+        "items": {
+          "type": "object"
+        }
+      },
+      "error": {
+        "type": "string",
+        "description": "set when the transcript could not be read; the census is then a refusal, not an empty count"
+      },
+      "source": {
+        "type": "string"
+      }
+    }
+  },
+  "required_fields": [
+    "transcript",
+    "records",
+    "turns",
+    "tools",
+    "operator_messages"
+  ]
+}

package/domain_types/session-review-verdict.json

@@ -0,0 +1,48 @@
+{
+  "slug": "session-review-verdict",
+  "version": 1,
+  "extends": "Verdict",
+  "domain": "session-review",
+  "status": "active",
+  "schema": {
+    "type": "object",
+    "properties": {
+      "pass": {
+        "type": "boolean"
+      },
+      "unsupported_claims": {
+        "type": "array",
+        "description": "claims whose evidence path is absent from the census, or whose value disagrees with it",
+        "items": {
+          "type": "object"
+        }
+      },
+      "misquoted_decisions": {
+        "type": "array",
+        "description": "decisions whose quote does not appear verbatim in the census's operator messages",
+        "items": {
+          "type": "object"
+        }
+      },
+      "omissions": {
+        "type": "array",
+        "description": "what the census carries that the review does not mention and should",
+        "items": {
+          "type": "string"
+        }
+      },
+      "checks": {
+        "type": "array",
+        "items": {
+          "type": "object"
+        }
+      }
+    }
+  },
+  "required_fields": [
+    "pass",
+    "checks",
+    "unsupported_claims",
+    "misquoted_decisions"
+  ]
+}

package/domain_types/session-review.json

@@ -0,0 +1,86 @@
+{
+  "slug": "session-review",
+  "version": 1,
+  "extends": "Artifact",
+  "domain": "session-review",
+  "status": "active",
+  "schema": {
+    "type": "object",
+    "properties": {
+      "title": {
+        "type": "string"
+      },
+      "span": {
+        "type": "string",
+        "description": "the session's start and end, from the census"
+      },
+      "what_happened": {
+        "type": "string",
+        "description": "the arc of the session in plain prose: what was asked, what was built, what was decided"
+      },
+      "what_it_cost": {
+        "type": "string",
+        "description": "the measured shape of the spend and the context, from the census and the ledger rows carried in"
+      },
+      "what_went_wrong": {
+        "type": "string",
+        "description": "defects, dead ends, wasted work and their causes — named, not softened"
+      },
+      "decisions": {
+        "type": "array",
+        "description": "the operator's decisions, each quoted from their own message in the census",
+        "items": {
+          "type": "object",
+          "properties": {
+            "decision": {
+              "type": "string"
+            },
+            "quote": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "decision",
+            "quote"
+          ]
+        }
+      },
+      "open": {
+        "type": "array",
+        "description": "what the session left open",
+        "items": {
+          "type": "string"
+        }
+      },
+      "claims": {
+        "type": "array",
+        "description": "every factual claim the prose makes, paired with the census path or ledger field that supports it",
+        "items": {
+          "type": "object",
+          "properties": {
+            "text": {
+              "type": "string"
+            },
+            "evidence": {
+              "type": "string"
+            },
+            "value": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "text",
+            "evidence"
+          ]
+        }
+      }
+    }
+  },
+  "required_fields": [
+    "title",
+    "what_happened",
+    "what_it_cost",
+    "what_went_wrong",
+    "claims"
+  ]
+}

package/domain_types/session-target.json

@@ -0,0 +1,26 @@
+{
+  "slug": "session-target",
+  "version": 1,
+  "extends": "Signal",
+  "domain": "session-review",
+  "status": "active",
+  "schema": {
+    "type": "object",
+    "properties": {
+      "transcript": {
+        "type": "string",
+        "description": "absolute path to one Claude Code session transcript (.jsonl)"
+      },
+      "label": {
+        "type": "string",
+        "description": "what this session was, in the operator's words — carried, never inferred"
+      },
+      "source": {
+        "type": "string"
+      }
+    }
+  },
+  "required_fields": [
+    "transcript"
+  ]
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eir-labs/coltrane",
-  "version": "0.24.36",
+  "version": "0.24.38",
   "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",