@eir-labs/coltrane 0.24.1 → 0.24.2

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eir-labs/coltrane",
-  "version": "0.24.1",
+  "version": "0.24.2",
   "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/deliberation-before-amendment-v1.json

@@ -0,0 +1,58 @@
+{
+  "slug": "deliberation-before-amendment-v1",
+  "domain": "spec-drafting",
+  "agent_slugs": [
+    "context-reader",
+    "spec-reviewer"
+  ],
+  "phases": [
+    {
+      "name": "read-proposal",
+      "chairs": [
+        {
+          "role": "read-proposal",
+          "agent_slug": "context-reader",
+          "depends_on": [],
+          "input_contract": [
+            "change-request"
+          ],
+          "output_contract": [
+            "change-context"
+          ],
+          "required_skills": []
+        }
+      ],
+      "intent": "A non-drafting seat frames the proposed amendment before any judgment falls on it. The reader opens the tree the change-request names — the law it would mend, the callsites and tests that bind it — and restates the proposal against that real surface as a change-context, each claim citing a file opened in this run. The reader frames and never judges: it does not decide whether the amendment is sound, does not rule it in or out, and writes no line of the standard. The wall between framing and judgment is the whole point of the two-phase shape; this seat holds the framing side of it."
+    },
+    {
+      "name": "deliberate",
+      "chairs": [
+        {
+          "role": "render-verdict",
+          "agent_slug": "spec-reviewer",
+          "depends_on": [
+            "read-proposal"
+          ],
+          "input_contract": [
+            "red-spec",
+            "change-context"
+          ],
+          "output_contract": [
+            "change-verdict"
+          ],
+          "required_skills": []
+        }
+      ],
+      "intent": "A non-drafting seat deliberates BEFORE the amendment proceeds. Reading the framed change-context and the red-spec, the reviewer judges the proposal on soundness (does it hold and validate on this engine tip), non-vacuity (does it change something real, not restate what already holds), and buildability (can the fix land against the laws as written). The reviewer judges and never drafts: it authors no standard and edits no law — it renders a change-verdict, passing only when all three hold and refusing with the specific hole named otherwise. Judgment lives downstream of framing so a proposal is read before it is ruled on, and the seat that rules never wrote the thing it rules."
+    }
+  ],
+  "input_types": [
+    "change-request",
+    "red-spec"
+  ],
+  "output_types": [
+    "change-verdict"
+  ],
+  "status": "active",
+  "description": "Deliberation before amendment: a proposed change to the institution's own law is framed by a non-drafting reader, then judged by a non-drafting reviewer, before the amendment proceeds. Two seams-separated seats. The read-proposal chair (context-reader, SENSE+INTERPRET) frames the change-request into a change-context grounded in the real tree — it frames and never judges. The deliberate chair (spec-reviewer, VERIFY) then judges soundness, non-vacuity, and buildability from that framing and the red-spec, sealing a change-verdict — it judges and never drafts. This is the thin-canon doctrine made structural: the reader frames, the reviewer judges, and neither drafts the amendment it deliberates on. The two-phase graph also mends the founding finding recorded in docs/founding/RUNBOOK.md: the seed's deliberation-before-amendment-v0 was a sole-VERIFY first phase, refused by the engine's NEEDS_TARGET rule (src/composition.ts) because a VERIFY seat with no upstream phase target cannot compose. Seating the SENSE+INTERPRET reader ahead of the VERIFY reviewer gives that reviewer its upstream target, so the standard loads green under `npx coltrane validate`."
+}