@eir-labs/coltrane 0.24.5 → 0.24.7

package/dist/src/cli.d.ts

@@ -31,7 +31,7 @@ export interface CliIO {
     /** Injected for tests. Production reads stdin for `--input -`. */
     stdin?: () => string;
 }
-export declare const USAGE = "coltrane 0.24.5\n\n  coltrane validate                     load the genome; exit non-zero on load errors\n  coltrane dispatch <standard>          run a standard\n  coltrane monitor <gig-id>             report a gig's progress\n  coltrane logs <gig-id>                per-chair logs for a gig\n  coltrane abort <gig-id>               stop a running gig\n  coltrane trace <output-id>            walk an output's provenance\n  coltrane simulate <standard>          cost/shape a standard without running it\n  coltrane health                       engine + store health\n  coltrane serve                        run the MCP server on stdio\n  coltrane enqueue <standard>           queue a gig on the LOCAL file queue (no store, no key)\n                                        (env: COLTRANE_QUEUE_DIR \u2014 its absence is the whole\n                                         difference between local and hosted)\n  coltrane work                         claim one queued gig from the org store and run it\n  coltrane work --check                  report whether this box's drain environment is configured\n                                        and exit without claiming (0 ready, 1 not ready)\n                                        (env: COLTRANE_STORE_URL, COLTRANE_STORE_ANON,\n                                         COLTRANE_AGENT_TOKEN; results drain via\n                                         COLTRANE_DRAIN_URL + COLTRANE_DRAIN_KEY;\n                                         checkpoints under COLTRANE_WORKER_CHECKPOINTS,\n                                         default ~/.coltrane/worker-checkpoints;\n                                         exit 0 complete or parked, 1 failed, 3 queue empty)\n\nOptions\n  --input <json|@file|->                dispatch payload; @file reads a file, - reads stdin\n  --depth <skim|standard|deep>          tighten the per-chair turn cap\n  --budget <dollars>                    per-gig ceiling; the run stops when it is gone\n  --reuse                               allow chair-level reuse of prior sealed outputs\n  --resume <gig-id>                     continue a gig that died mid-pipeline\n  --approve <role>=<json|@file>         a human chair's verdict; repeat once per chair\n  --as <name>                           who is approving; sealed as the verdict's author\n  --wait                                block until the run finishes\n  --follow                              poll until the gig reaches a terminal state\n  --direction <upstream|downstream|both>  for trace\n  --json                                print the raw result to stdout\n  --genome <path>                       genome root (default: $COLTRANE_GENOME or cwd)\n  --help, --version\n\nA dispatch that reaches a chair a HUMAN holds parks: it names the waiting chair and exits 0,\nbecause a gig waiting on a person is not a failed gig. Approve it on the resume \u2014\n\n  coltrane dispatch <standard> --resume <gig> \\\n      --approve approve=@verdict.json --as eugene\n\n--input is NOT required on an approve-only resume: when every remaining chair is human the\ncheckpoint's recorded payload stands and the omission inherits it. If you DO pass --input it is\nchecked against the checkpoint, and a disagreement still refuses the resume.\n";
+export declare const USAGE = "coltrane 0.24.7\n\n  coltrane validate                     load the genome; exit non-zero on load errors\n  coltrane dispatch <standard>          run a standard\n  coltrane monitor <gig-id>             report a gig's progress\n  coltrane logs <gig-id>                per-chair logs for a gig\n  coltrane abort <gig-id>               stop a running gig\n  coltrane trace <output-id>            walk an output's provenance\n  coltrane simulate <standard>          cost/shape a standard without running it\n  coltrane health                       engine + store health\n  coltrane serve                        run the MCP server on stdio\n  coltrane enqueue <standard>           queue a gig on the LOCAL file queue (no store, no key)\n                                        (env: COLTRANE_QUEUE_DIR \u2014 its absence is the whole\n                                         difference between local and hosted)\n  coltrane work                         claim one queued gig from the org store and run it\n  coltrane work --check                  report whether this box's drain environment is configured\n                                        and exit without claiming (0 ready, 1 not ready)\n                                        (env: COLTRANE_STORE_URL, COLTRANE_STORE_ANON,\n                                         COLTRANE_AGENT_TOKEN; results drain via\n                                         COLTRANE_DRAIN_URL + COLTRANE_DRAIN_KEY;\n                                         checkpoints under COLTRANE_WORKER_CHECKPOINTS,\n                                         default ~/.coltrane/worker-checkpoints;\n                                         exit 0 complete or parked, 1 failed, 3 queue empty)\n\nOptions\n  --input <json|@file|->                dispatch payload; @file reads a file, - reads stdin\n  --depth <skim|standard|deep>          tighten the per-chair turn cap\n  --budget <dollars>                    per-gig ceiling; the run stops when it is gone\n  --reuse                               allow chair-level reuse of prior sealed outputs\n  --resume <gig-id>                     continue a gig that died mid-pipeline\n  --approve <role>=<json|@file>         a human chair's verdict; repeat once per chair\n  --as <name>                           who is approving; sealed as the verdict's author\n  --wait                                block until the run finishes\n  --follow                              poll until the gig reaches a terminal state\n  --direction <upstream|downstream|both>  for trace\n  --json                                print the raw result to stdout\n  --genome <path>                       genome root (default: $COLTRANE_GENOME or cwd)\n  --help, --version\n\nA dispatch that reaches a chair a HUMAN holds parks: it names the waiting chair and exits 0,\nbecause a gig waiting on a person is not a failed gig. Approve it on the resume \u2014\n\n  coltrane dispatch <standard> --resume <gig> \\\n      --approve approve=@verdict.json --as eugene\n\n--input is NOT required on an approve-only resume: when every remaining chair is human the\ncheckpoint's recorded payload stands and the omission inherits it. If you DO pass --input it is\nchecked against the checkpoint, and a disagreement still refuses the resume.\n";
 interface Parsed {
     cmd: string | undefined;
     positional: string[];

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

package/institutions/coltrane.json

@@ -141,7 +141,17 @@
       "kind": "steve",
       "is_institution": false,
       "skill_slugs": [],
-      "status": "active",
+      "status": "retired",
+      "named_from_forebear": null,
+      "auth_user_id": null
+    },
+    {
+      "slug": "blakey",
+      "name": "Blakey",
+      "kind": "steve",
+      "is_institution": false,
+      "skill_slugs": [],
+      "status": "named",
       "named_from_forebear": "blakey-art",
       "auth_user_id": null
     }
@@ -213,10 +223,10 @@
     {
       "id": "coltrane.seat.change-author",
       "chair_id": "coltrane.chair.change-author",
-      "agent_slug": "coltrane-proposer",
+      "agent_slug": "blakey",
       "org_slug": "eir-labs",
       "contract_caps": [],
-      "witnessed_by": null
+      "witnessed_by": "chain 000005; Documenso #1916732 (executed 2026-08-23T11:48:05Z, sha256:b8abd86e00c021321a2b4f5f4dd8c9346125a44cd8a521aaa8460be498ae6a53)"
     }
   ],
   "forebears": [
@@ -315,7 +325,7 @@
     {
       "institution_slug": "coltrane",
       "edge_type": "descends-from",
-      "from_node": "agent:bandleader",
+      "from_node": "agent:blakey",
       "to_node": "forebear:blakey-art",
       "kind": "attribution",
       "source": {
@@ -329,9 +339,9 @@
           "American National Biography, \"Blakey, Art (1919-1990), jazz drummer and bandleader\", doi:10.1093/anb/9780198606697.article.1802592 (retrieved 2026-08-20)",
           "Grove Music Online, Lewis Porter, \"Blakey, Art (jazz)\", doi:10.1093/gmo/9781561592630.article.j046400 (retrieved 2026-08-20)"
         ],
-        "attributed_disposition": "running a band as an institution that outlives its players: seating them, developing them, releasing them onward across roughly two dozen Jazz Messengers lineups from 1954 to 1990, while the band itself persisted as the durable thing. The seat calls the tune, judges the take and stops the band; it does not play.",
+        "attributed_disposition": "running a band as an institution that outlives its players: seating them, developing them, releasing them onward across roughly two dozen Jazz Messengers lineups from 1954 to 1990, while the band itself persisted as the durable thing. Re-read at the naming of Blakey (2026-08-23) for the change-author chair's CREATE mandate: the drum chair DRIVES the band and BUILDS the players — hard-swinging daily work, graduating members forward — which is the chair's build-and-open-PR practice. The prior 'calls the tune, judges the take... does not play' reading belonged to the retired pre-ritual config (PLAN+JUDGE) and was found behaviorally mismatched by the ritual's scribe (naming record e0b13933…).",
         "evidence_grade": "attestation",
-        "note": "The two reference-work DOIs were dereferenced through api.crossref.org on 2026-08-20 and returned matching author, year and title. The recording details are carried from the standard Blue Note discography and were NOT independently dereferenced, so this edge is graded attestation rather than archive."
+        "note": "The two reference-work DOIs were dereferenced through api.crossref.org on 2026-08-20 and returned matching author, year and title. The recording details are carried from the standard Blue Note discography and were NOT independently dereferenced, so this edge is graded attestation rather than archive. RE-HOMED 2026-08-23: from_node agent:bandleader -> agent:blakey at the naming ritual's seal (Documenso #1916732, sha256:b8abd86e…6a53; chain 000005) — one forebear, one holder, per the uniqueness invariant; the pre-ritual config retired."
       }
     }
   ]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eir-labs/coltrane",
-  "version": "0.24.5",
+  "version": "0.24.7",
   "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/square-review-v0.json

@@ -0,0 +1,60 @@
+{
+  "slug": "square-review-v0",
+  "domain": "spec-drafting",
+  "status": "active",
+  "agent_slugs": [
+    "context-reader",
+    "spec-reviewer"
+  ],
+  "phases": [
+    {
+      "name": "sense-merge",
+      "chairs": [
+        {
+          "role": "sense-merge",
+          "agent_slug": "context-reader",
+          "depends_on": [],
+          "input_contract": [
+            "change-request"
+          ],
+          "output_contract": [
+            "change-context"
+          ],
+          "optional_outputs": [],
+          "required_skills": []
+        }
+      ],
+      "intent": "On each merge to the reviewed line, sense the change-set and frame its context for review — what changed, where, and under which laws."
+    },
+    {
+      "name": "review-turns",
+      "chairs": [
+        {
+          "role": "review-turns",
+          "agent_slug": "spec-reviewer",
+          "depends_on": [
+            "sense-merge"
+          ],
+          "input_contract": [
+            "change-set",
+            "change-context"
+          ],
+          "output_contract": [
+            "change-verdict"
+          ],
+          "optional_outputs": [],
+          "required_skills": []
+        }
+      ],
+      "intent": "Read the change-set turn by turn and seal the review verdict, admitted to the lineage in daylight — a panel of peer review conducted where all may see it."
+    }
+  ],
+  "input_types": [
+    "change-request",
+    "change-set"
+  ],
+  "output_types": [
+    "change-verdict"
+  ],
+  "description": "The public square's review law (WO-002, Article the First): on merge, a change-set is read turn by turn on the cheap open path and its verdict admitted to the lineage in daylight. Model-agnostic by design — cheap enough to run without cease; no chair pins a tier. Phase graph proven by the founder's work-order validator before deliberation; created through deliberation-before-amendment-v1 (refused, cured, accepted). Generalization task identified in the executed order: parameterize the reviewed repository after the Coltrane instance runs."
+}