@eir-labs/coltrane 0.24.13 → 0.24.15

package/domain_types/lineage-record.json

@@ -13,14 +13,24 @@
         "items": {
           "type": "object",
           "properties": {
-            "source": { "type": "string" },
+            "source": {
+              "type": "string"
+            },
             "status": {
               "type": "string",
-              "enum": ["reached", "not-reached"]
+              "enum": [
+                "reached",
+                "not-reached"
+              ]
             },
-            "note": { "type": "string" }
+            "note": {
+              "type": "string"
+            }
           },
-          "required": ["source", "status"],
+          "required": [
+            "source",
+            "status"
+          ],
           "additionalProperties": false
         }
       },
@@ -29,11 +39,19 @@
         "items": {
           "type": "object",
           "properties": {
-            "reference": { "type": "string" },
-            "kind": { "type": "string" },
-            "summary": { "type": "string" }
+            "reference": {
+              "type": "string"
+            },
+            "kind": {
+              "type": "string"
+            },
+            "summary": {
+              "type": "string"
+            }
           },
-          "required": ["reference"],
+          "required": [
+            "reference"
+          ],
           "additionalProperties": false
         }
       },
@@ -43,27 +61,62 @@
         "items": {
           "type": "object",
           "properties": {
-            "internal_ref": { "type": "string" },
-            "external_ref": { "type": "string" },
+            "internal_ref": {
+              "type": "string"
+            },
+            "external_ref": {
+              "type": "string"
+            },
             "relation": {
               "type": "string",
-              "enum": ["descends-from", "aligns-with", "diverges-from", "supersedes", "informed-by"]
+              "enum": [
+                "descends-from",
+                "aligns-with",
+                "diverges-from",
+                "supersedes",
+                "informed-by"
+              ]
+            },
+            "grounding_internal": {
+              "type": "string"
+            },
+            "grounding_external": {
+              "type": "string"
             },
-            "grounding_internal": { "type": "string" },
-            "grounding_external": { "type": "string" },
             "strength": {
               "type": "string",
-              "enum": ["dereferenceable-both-sides", "structural-correspondence", "conceptual-analogy"],
+              "enum": [
+                "dereferenceable-both-sides",
+                "structural-correspondence",
+                "conceptual-analogy"
+              ],
               "$comment": "Per-edge grounding strength: HOW firmly this connection is drawn, ordinal from dereferenceable-both-sides (strongest) to conceptual-analogy (weakest). It is ORTHOGONAL to CitationSchema.evidence_grade (src/genome_schema.ts:293-309), which grades the source's fetch status (archive|attestation) and is never laundered upward. Both endpoints can be archive-grade while the edge between them is a loose conceptual-analogy. Do NOT collapse strength into evidence_grade — that obvious future 'simplification' would destroy the distinction between a citation-grounded edge and a loose structural or conceptual one."
             }
           },
-          "required": ["internal_ref", "external_ref", "relation", "grounding_internal", "grounding_external", "strength"],
+          "required": [
+            "internal_ref",
+            "external_ref",
+            "relation",
+            "grounding_internal",
+            "grounding_external",
+            "strength"
+          ],
           "additionalProperties": false
         }
       },
-      "gap": { "type": "string" },
-      "alignment_recommendation": { "type": "string" }
+      "gap": {
+        "type": "string"
+      },
+      "alignment_recommendation": {
+        "type": "string"
+      }
     }
   },
-  "required_fields": ["external_body", "internal_inventory", "connections", "gap", "alignment_recommendation"]
+  "required_fields": [
+    "external_body",
+    "internal_inventory",
+    "connections",
+    "gap",
+    "alignment_recommendation"
+  ]
 }

package/domain_types/lineage-verdict.json

@@ -8,9 +8,15 @@
   "schema": {
     "type": "object",
     "properties": {
-      "approver": { "type": "string" },
-      "rationale": { "type": "string" }
+      "approver": {
+        "type": "string"
+      },
+      "rationale": {
+        "type": "string"
+      }
     }
   },
-  "required_fields": ["rationale"]
+  "required_fields": [
+    "rationale"
+  ]
 }

package/domain_types/parsed-conversation-trace.json

@@ -7,27 +7,68 @@
   "schema": {
     "type": "object",
     "properties": {
-      "transcript_path": { "type": "string" },
-      "recorder_log_path": { "type": "string" },
-      "transcript_present": { "type": "boolean" },
-      "recorder_log_present": { "type": "boolean" },
-      "recorder_log_empty": { "type": "boolean" },
+      "transcript_path": {
+        "type": "string"
+      },
+      "recorder_log_path": {
+        "type": "string"
+      },
+      "transcript_present": {
+        "type": "boolean"
+      },
+      "recorder_log_present": {
+        "type": "boolean"
+      },
+      "recorder_log_empty": {
+        "type": "boolean"
+      },
       "turns": {
         "type": "array",
         "items": {
           "type": "object",
           "properties": {
-            "turn_idx": { "type": "number" },
-            "parent_session_id": { "type": ["string", "null"] },
-            "child_session_id": { "type": ["string", "null"] },
-            "prompt": { "type": ["string", "null"] },
-            "response": { "type": ["string", "null"] },
-            "timestamp": { "type": ["string", "null"] },
-            "tool_calls": { "type": "array" }
+            "turn_idx": {
+              "type": "number"
+            },
+            "parent_session_id": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "child_session_id": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "prompt": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "response": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "timestamp": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "tool_calls": {
+              "type": "array"
+            }
           }
         }
       },
-      "notes": { "type": "string" }
+      "notes": {
+        "type": "string"
+      }
     }
   },
   "required_fields": [

package/domain_types/pattern-extraction.json

@@ -8,55 +8,125 @@
   "schema": {
     "type": "object",
     "properties": {
-      "input_refs":          { "type": "array", "items": { "type": "string" }, "description": "References to the repo-survey outputs this extraction is derived from." },
-      "user_signature":      { "type": "string", "description": "One-line characterization of the user's working pattern (e.g., 'rapid cross-domain research with TDD-flavored code changes')." },
-
+      "input_refs": {
+        "type": "array",
+        "items": {
+          "type": "string"
+        },
+        "description": "References to the repo-survey outputs this extraction is derived from."
+      },
+      "user_signature": {
+        "type": "string",
+        "description": "One-line characterization of the user's working pattern (e.g., 'rapid cross-domain research with TDD-flavored code changes')."
+      },
       "recurrent_workflows": {
         "type": "array",
         "description": "Observable multi-step sequences the user runs across repos (e.g., 'fetch dataset → run analysis → write results doc → OTS-stamp').",
         "items": {
           "type": "object",
           "properties": {
-            "name":          { "type": "string" },
-            "steps":         { "type": "array", "items": { "type": "string" } },
-            "evidence_repos": { "type": "array", "items": { "type": "string" }, "description": "Which repos exhibit this pattern." },
-            "frequency":     { "type": "string", "enum": ["once", "occasional", "frequent", "dominant"] }
+            "name": {
+              "type": "string"
+            },
+            "steps": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "evidence_repos": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "Which repos exhibit this pattern."
+            },
+            "frequency": {
+              "type": "string",
+              "enum": [
+                "once",
+                "occasional",
+                "frequent",
+                "dominant"
+              ]
+            }
           },
-          "required": ["name", "steps", "evidence_repos"]
+          "required": [
+            "name",
+            "steps",
+            "evidence_repos"
+          ]
         }
       },
-
       "agent_like_roles": {
         "type": "array",
         "description": "Implicit roles the user plays (or scripts they've written) that map to coltrane agent shapes.",
         "items": {
           "type": "object",
           "properties": {
-            "role":               { "type": "string" },
-            "implicit_primitives": { "type": "array", "items": { "type": "string" }, "description": "Behavioral primitives this role would map to (analyst, executor, etc.)." },
-            "evidence":           { "type": "string", "description": "What in the surveys suggests this role." }
+            "role": {
+              "type": "string"
+            },
+            "implicit_primitives": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "Behavioral primitives this role would map to (analyst, executor, etc.)."
+            },
+            "evidence": {
+              "type": "string",
+              "description": "What in the surveys suggests this role."
+            }
           },
-          "required": ["role", "evidence"]
+          "required": [
+            "role",
+            "evidence"
+          ]
         }
       },
-
       "recurrent_domain_shapes": {
         "type": "array",
         "description": "Data shapes the user repeatedly works with (e.g., 'time-series with channel + bandpass metadata').",
         "items": {
           "type": "object",
           "properties": {
-            "shape_name":   { "type": "string" },
-            "schema_hint":  { "type": "object", "description": "Loose JSON-schema-ish hint, not a binding type definition." },
-            "evidence_repos": { "type": "array", "items": { "type": "string" } }
+            "shape_name": {
+              "type": "string"
+            },
+            "schema_hint": {
+              "type": "object",
+              "description": "Loose JSON-schema-ish hint, not a binding type definition."
+            },
+            "evidence_repos": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
           },
-          "required": ["shape_name", "evidence_repos"]
+          "required": [
+            "shape_name",
+            "evidence_repos"
+          ]
         }
       },
-
-      "confidence_band": { "type": "string", "enum": ["high", "moderate", "low"], "description": "How confident is this read across the survey cohort?" }
+      "confidence_band": {
+        "type": "string",
+        "enum": [
+          "high",
+          "moderate",
+          "low"
+        ],
+        "description": "How confident is this read across the survey cohort?"
+      }
     },
-    "required": ["input_refs", "user_signature", "confidence_band", "claims"]
+    "required": [
+      "input_refs",
+      "user_signature",
+      "confidence_band",
+      "claims"
+    ]
   },
   "required_fields": []
 }

package/domain_types/preview-deployment.json

@@ -8,14 +8,43 @@
   "schema": {
     "type": "object",
     "properties": {
-      "preview_url":   { "type": "string", "description": "The reachable preview URL from POST /v13/deployments (the deployment's url, https-prefixed)." },
-      "commit_sha":    { "type": "string", "description": "The exact commit deployed, sensed from branch HEAD — not read out of the change-set." },
-      "branch":        { "type": "string", "description": "The git branch deployed to the preview target." },
-      "project_id":    { "type": "string", "description": "The Vercel project id (prj_...) the deployment belongs to." },
-      "deployment_id": { "type": "string", "description": "The Vercel deployment id (dpl_...), read later by a promote chair to call the promote API." },
-      "build_status":  { "type": "string", "description": "The last observed Vercel readyState: QUEUED | INITIALIZING | BUILDING | READY | ERROR | CANCELED." },
-      "protection":    { "type": "string", "enum": ["vercel-sso", "supabase-auth", "public"], "description": "How the preview URL is gated. supabase-auth is the phone-reachable mode required at the approval gate." },
-      "inspector_url": { "type": "string", "description": "The Vercel inspector/dashboard URL for the deployment, when the response carried it." }
+      "preview_url": {
+        "type": "string",
+        "description": "The reachable preview URL from POST /v13/deployments (the deployment's url, https-prefixed)."
+      },
+      "commit_sha": {
+        "type": "string",
+        "description": "The exact commit deployed, sensed from branch HEAD — not read out of the change-set."
+      },
+      "branch": {
+        "type": "string",
+        "description": "The git branch deployed to the preview target."
+      },
+      "project_id": {
+        "type": "string",
+        "description": "The Vercel project id (prj_...) the deployment belongs to."
+      },
+      "deployment_id": {
+        "type": "string",
+        "description": "The Vercel deployment id (dpl_...), read later by a promote chair to call the promote API."
+      },
+      "build_status": {
+        "type": "string",
+        "description": "The last observed Vercel readyState: QUEUED | INITIALIZING | BUILDING | READY | ERROR | CANCELED."
+      },
+      "protection": {
+        "type": "string",
+        "enum": [
+          "vercel-sso",
+          "supabase-auth",
+          "public"
+        ],
+        "description": "How the preview URL is gated. supabase-auth is the phone-reachable mode required at the approval gate."
+      },
+      "inspector_url": {
+        "type": "string",
+        "description": "The Vercel inspector/dashboard URL for the deployment, when the response carried it."
+      }
     }
   },
   "required_fields": [

package/domain_types/project-charter.json

@@ -8,14 +8,25 @@
   "schema": {
     "type": "object",
     "properties": {
-      "id": { "type": "string" },
-      "name": { "type": "string" },
+      "id": {
+        "type": "string"
+      },
+      "name": {
+        "type": "string"
+      },
       "use_case": {
         "type": "string",
-        "enum": ["code-changes", "research-briefs", "operations", "mixed", "bare"]
+        "enum": [
+          "code-changes",
+          "research-briefs",
+          "operations",
+          "mixed",
+          "bare"
+        ]
+      },
+      "template": {
+        "type": "string"
       },
-      "template": { "type": "string" },
-
       "scope": {
         "type": "string",
         "description": "What the project will do."
@@ -28,44 +39,76 @@
         "type": "string",
         "description": "What this project is explicitly NOT."
       },
-
       "preseed_agents": {
         "type": "array",
-        "items": { "type": "string" },
+        "items": {
+          "type": "string"
+        },
         "description": "Slugs of agents to ship in the scaffolded .coltrane/agents/."
       },
       "preseed_standards": {
         "type": "array",
-        "items": { "type": "string" },
+        "items": {
+          "type": "string"
+        },
         "description": "Slugs of standards to ship in .coltrane/standards/."
       },
       "preseed_skills": {
         "type": "array",
-        "items": { "type": "string" },
+        "items": {
+          "type": "string"
+        },
         "description": "Slugs of skills to ship in .coltrane/skills/."
       },
       "default_model_tier": {
         "type": "string",
-        "enum": ["economy", "standard", "premium"],
+        "enum": [
+          "economy",
+          "standard",
+          "premium"
+        ],
         "default": "standard"
       },
       "default_code_tool_access": {
         "type": "string",
-        "enum": ["none", "read", "write", "full"],
+        "enum": [
+          "none",
+          "read",
+          "write",
+          "full"
+        ],
         "default": "read"
       },
-
       "outcome": {
-        "type": ["string", "null"],
-        "enum": [null, "completed", "partial", "refined", "aborted", "unverified"],
+        "type": [
+          "string",
+          "null"
+        ],
+        "enum": [
+          null,
+          "completed",
+          "partial",
+          "refined",
+          "aborted",
+          "unverified"
+        ],
         "description": "Set at DELIVER. unverified = outcome cannot be computed."
       },
       "outcome_at": {
-        "type": ["string", "null"],
+        "type": [
+          "string",
+          "null"
+        ],
         "format": "date-time"
       }
     },
-    "required": ["id", "name", "use_case", "scope", "steps"]
+    "required": [
+      "id",
+      "name",
+      "use_case",
+      "scope",
+      "steps"
+    ]
   },
   "required_fields": []
 }

package/domain_types/proof-of-work-contract.json

@@ -0,0 +1,86 @@
+{
+  "slug": "proof-of-work-contract",
+  "version": 1,
+  "extends": "Artifact",
+  "domain": "software-change",
+  "status": "active",
+  "description": "The composed PROOF OF WORK for a work order's reconciliation (WO-F02, Documenso #1917537): the cold map, the hot audit's findings, and a verdict per clause, folded into one contract and written as a sealed output — the engine stamps its content_sha and input_shas, so the contract is content-addressed by construction, never by an agent's own hashing. This is what the sovereign settles against and what a DEFAULT cites: the document that makes 'the work was done' a checkable claim instead of a recollection.",
+  "schema": {
+    "type": "object",
+    "properties": {
+      "work_order_id": {
+        "type": "string",
+        "description": "The chancery_work_order.id this contract reconciles."
+      },
+      "cold_map_ref": {
+        "type": "string",
+        "description": "content_sha (or output id) of the sealed reconciliation-map this contract composes from."
+      },
+      "audit_verdict_ref": {
+        "type": "string",
+        "description": "content_sha (or output id) of the sealed hot-audit change-verdict this contract composes from."
+      },
+      "clause_verdicts": {
+        "type": "array",
+        "minItems": 1,
+        "description": "One verdict per clause of the order — the cold map's row joined with the audit's finding for that clause. Copies only: the composer draws no verdict of its own.",
+        "items": {
+          "type": "object",
+          "properties": {
+            "clause_ref": {
+              "type": "string"
+            },
+            "clause_kind": {
+              "type": "string",
+              "enum": [
+                "article",
+                "terminal",
+                "receipt_due"
+              ]
+            },
+            "receipt_status": {
+              "type": "string",
+              "enum": [
+                "receipted",
+                "absent"
+              ]
+            },
+            "audit_finding": {
+              "type": "string",
+              "description": "The audit's verdict for this clause, verbatim: upheld, refuted (with the refutation), or unaudited (with why — e.g. budget exhausted, receipt absent)."
+            },
+            "evidence_refs": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "The citations the finding rests on — output ids, file paths, URLs probed, check names run."
+            }
+          },
+          "required": [
+            "clause_ref",
+            "receipt_status",
+            "audit_finding"
+          ]
+        }
+      },
+      "proposed_state": {
+        "type": "string",
+        "enum": [
+          "satisfied",
+          "defaulted"
+        ],
+        "description": "What the composed evidence supports — a PROPOSAL only. The adjudicator rules on default; only the sovereign, settling at the human seat, records 'satisfied'."
+      }
+    }
+  },
+  "required_fields": [
+    "work_order_id",
+    "cold_map_ref",
+    "audit_verdict_ref",
+    "clause_verdicts",
+    "proposed_state",
+    "input_refs",
+    "content"
+  ]
+}