@eir-labs/coltrane 0.4.0

package/domain_types/novelty-analysis.json

@@ -0,0 +1,28 @@
+{
+  "slug": "novelty-analysis",
+  "version": 1,
+  "extends": "Interpretation",
+  "domain": "patent-triage",
+  "status": "active",
+  "schema": {
+    "type": "object",
+    "properties": {
+      "matrix": {
+        "type": "array"
+      },
+      "coverage_fraction": {
+        "type": "number"
+      },
+      "obviousness_combinations": {
+        "type": "array"
+      },
+      "caveat": {
+        "type": "string"
+      }
+    }
+  },
+  "required_fields": [
+    "matrix",
+    "claims"
+  ]
+}

package/domain_types/novelty-verdict.json

@@ -0,0 +1,35 @@
+{
+  "slug": "novelty-verdict",
+  "version": 1,
+  "extends": "Judgment",
+  "domain": "patent-triage",
+  "status": "active",
+  "schema": {
+    "type": "object",
+    "properties": {
+      "invention_id": {
+        "type": "string"
+      },
+      "nearest_prior_art": {
+        "type": "array"
+      },
+      "coverage_fraction": {
+        "type": "number"
+      },
+      "verdict": {
+        "type": "string"
+      },
+      "rationale": {
+        "type": "string"
+      },
+      "caveat": {
+        "type": "string"
+      }
+    }
+  },
+  "required_fields": [
+    "verdict",
+    "rationale",
+    "criteria"
+  ]
+}

package/domain_types/parsed-conversation-trace.json

@@ -0,0 +1,38 @@
+{
+  "slug": "parsed-conversation-trace",
+  "version": 1,
+  "extends": "Signal",
+  "domain": "self_judge",
+  "status": "active",
+  "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" },
+      "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" }
+          }
+        }
+      },
+      "notes": { "type": "string" }
+    }
+  },
+  "required_fields": [
+    "transcript_present",
+    "turns",
+    "source"
+  ]
+}

package/domain_types/pattern-extraction.json

@@ -0,0 +1,62 @@
+{
+  "slug": "pattern-extraction",
+  "version": 1,
+  "extends": "Interpretation",
+  "domain": "seeding",
+  "status": "active",
+  "description": "Implicit patterns extracted from a cohort of repo-surveys. Names workflow shapes, agent-like roles, recurrent operations, and domain-data shapes the user repeatedly works with — without committing to any specific draft yet. The 'what is the SHAPE of this user's work' read.",
+  "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')." },
+
+      "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"] }
+          },
+          "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." }
+          },
+          "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" } }
+          },
+          "required": ["shape_name", "evidence_repos"]
+        }
+      },
+
+      "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_fields": []
+}

package/domain_types/prior-art-hit.json

@@ -0,0 +1,50 @@
+{
+  "slug": "prior-art-hit",
+  "version": 1,
+  "extends": "Signal",
+  "domain": "patent-triage",
+  "status": "active",
+  "schema": {
+    "type": "object",
+    "properties": {
+      "source": {
+        "type": "string"
+      },
+      "url": {
+        "type": "string"
+      },
+      "title": {
+        "type": "string"
+      },
+      "snippet": {
+        "type": "string"
+      },
+      "publication_date": {
+        "type": "string"
+      },
+      "kind": {
+        "type": "string"
+      },
+      "relevance_score": {
+        "type": "number"
+      },
+      "verified": {
+        "type": "boolean"
+      },
+      "verification_method": {
+        "type": "string",
+        "enum": [
+          "fetch",
+          "snippet"
+        ]
+      },
+      "caveat": {
+        "type": "string"
+      }
+    }
+  },
+  "required_fields": [
+    "source",
+    "title"
+  ]
+}

package/domain_types/project-charter.json

@@ -0,0 +1,71 @@
+{
+  "slug": "project-charter",
+  "version": 1,
+  "extends": "Plan",
+  "domain": "bootstrap",
+  "status": "active",
+  "description": "The charter for a coltrane-flavored project. Emitted by problem-definer at the discover→define seam. The charter governs which preseed template is unrolled, which behavioral primitives are project-default, and which standards the project ships with.",
+  "schema": {
+    "type": "object",
+    "properties": {
+      "id": { "type": "string" },
+      "name": { "type": "string" },
+      "use_case": {
+        "type": "string",
+        "enum": ["code-changes", "research-briefs", "operations", "mixed", "bare"]
+      },
+      "template": { "type": "string" },
+
+      "scope": {
+        "type": "string",
+        "description": "What the project will do."
+      },
+      "success_criteria": {
+        "type": "string",
+        "description": "How we will know it worked."
+      },
+      "non_goals": {
+        "type": "string",
+        "description": "What this project is explicitly NOT."
+      },
+
+      "preseed_agents": {
+        "type": "array",
+        "items": { "type": "string" },
+        "description": "Slugs of agents to ship in the scaffolded .coltrane/agents/."
+      },
+      "preseed_standards": {
+        "type": "array",
+        "items": { "type": "string" },
+        "description": "Slugs of standards to ship in .coltrane/standards/."
+      },
+      "preseed_skills": {
+        "type": "array",
+        "items": { "type": "string" },
+        "description": "Slugs of skills to ship in .coltrane/skills/."
+      },
+      "default_model_tier": {
+        "type": "string",
+        "enum": ["economy", "standard", "premium"],
+        "default": "standard"
+      },
+      "default_code_tool_access": {
+        "type": "string",
+        "enum": ["none", "read", "write", "full"],
+        "default": "read"
+      },
+
+      "outcome": {
+        "type": ["string", "null"],
+        "enum": [null, "completed", "partial", "refined", "aborted", "unverified"],
+        "description": "Set at DELIVER. unverified = outcome cannot be computed."
+      },
+      "outcome_at": {
+        "type": ["string", "null"],
+        "format": "date-time"
+      }
+    },
+    "required": ["id", "name", "use_case", "scope", "steps"]
+  },
+  "required_fields": []
+}

package/domain_types/provisional-draft.json

@@ -0,0 +1,34 @@
+{
+  "slug": "provisional-draft",
+  "version": 1,
+  "extends": "Artifact",
+  "domain": "patent-triage",
+  "status": "active",
+  "schema": {
+    "type": "object",
+    "properties": {
+      "invention_id": {
+        "type": "string"
+      },
+      "markdown_text": {
+        "type": "string"
+      },
+      "sections": {
+        "type": "object"
+      },
+      "estimated_filing_cost_usd": {
+        "type": "number"
+      },
+      "recommended_next_step": {
+        "type": "string"
+      },
+      "caveat": {
+        "type": "string"
+      }
+    }
+  },
+  "required_fields": [
+    "markdown_text",
+    "validation_criteria"
+  ]
+}

package/domain_types/raw-note.json

@@ -0,0 +1,19 @@
+{
+  "slug": "raw-note",
+  "version": 1,
+  "extends": "Signal",
+  "domain": "demo",
+  "status": "active",
+  "schema": {
+    "type": "object",
+    "properties": {
+      "text": {
+        "type": "string"
+      }
+    }
+  },
+  "required_fields": [
+    "text",
+    "source"
+  ]
+}

package/domain_types/repo-survey.json

@@ -0,0 +1,28 @@
+{
+  "slug": "repo-survey",
+  "version": 1,
+  "extends": "Signal",
+  "domain": "seeding",
+  "status": "active",
+  "description": "Survey-level snapshot of a single repo found while seeding from local work. Scope-bounded: signals only, no deep code read. Captures the SHAPE of the user's work at this repo without committing to mechanism.",
+  "schema": {
+    "type": "object",
+    "properties": {
+      "repo_path":          { "type": "string", "description": "Absolute path to the repo on disk." },
+      "repo_name":          { "type": "string", "description": "Basename of the repo directory." },
+      "primary_language":   { "type": ["string", "null"], "description": "Inferred from file-extension distribution + manifest files. Null if mixed/unclear." },
+      "manifest_files":     { "type": "array", "items": { "type": "string" }, "description": "Detected manifest files: package.json, pyproject.toml, Cargo.toml, go.mod, etc." },
+      "readme_h1":          { "type": ["string", "null"], "description": "First H1 line of README (≤200 chars), if present." },
+      "readme_first_lines": { "type": ["string", "null"], "description": "First 200 chars of README body for context." },
+      "has_claude_md":      { "type": "boolean", "description": "Whether the repo has a CLAUDE.md." },
+      "has_dot_claude":     { "type": "boolean", "description": "Whether the repo has a .claude/ directory (subagents, commands, hooks)." },
+      "has_dot_coltrane":   { "type": "boolean", "description": "Whether the repo has a .coltrane/ directory (already coltrane-flavored)." },
+      "commit_rhythm_30d":  { "type": ["integer", "null"], "description": "Number of commits in the last 30 days." },
+      "last_commit_at":     { "type": ["string", "null"], "format": "date-time" },
+      "top_directories":    { "type": "array", "items": { "type": "string" }, "description": "Top-level subdirectory names (e.g. src/, tests/, docs/) — structural hint." },
+      "survey_completeness": { "type": "string", "enum": ["complete", "partial", "shallow"], "description": "Honest signal-bound: did we hit the scan limits or get clean reads on every channel?" }
+    },
+    "required": ["repo_path", "repo_name", "survey_completeness", "source"]
+  },
+  "required_fields": []
+}

package/domain_types/seeding-verdict.json

@@ -0,0 +1,70 @@
+{
+  "slug": "seeding-verdict",
+  "version": 1,
+  "extends": "Verdict",
+  "domain": "seeding",
+  "status": "active",
+  "description": "The DELIVER-phase verdict of seed-from-local-repos-v0. Names which drafts the user accepted, which they rejected, which they refined — and what landed in the active fleet.",
+  "schema": {
+    "type": "object",
+    "properties": {
+      "input_refs":       { "type": "array", "items": { "type": "string" }, "description": "References to all draft-* outputs this verdict resolves." },
+      "repos_surveyed":   { "type": "integer", "description": "Total repo-survey signals consumed." },
+      "patterns_extracted": { "type": "integer", "description": "Total pattern-extraction interpretations produced." },
+
+      "drafts_proposed": {
+        "type": "object",
+        "properties": {
+          "agents":     { "type": "integer" },
+          "standards":  { "type": "integer" },
+          "domain_types": { "type": "integer" }
+        }
+      },
+      "drafts_accepted": {
+        "type": "object",
+        "properties": {
+          "agents":     { "type": "integer" },
+          "standards":  { "type": "integer" },
+          "domain_types": { "type": "integer" }
+        }
+      },
+      "drafts_rejected": {
+        "type": "object",
+        "properties": {
+          "agents":     { "type": "integer" },
+          "standards":  { "type": "integer" },
+          "domain_types": { "type": "integer" }
+        }
+      },
+      "drafts_refined": {
+        "type": "object",
+        "description": "Drafts the user edited before accepting — re-proposed and adopted in modified form.",
+        "properties": {
+          "agents":     { "type": "integer" },
+          "standards":  { "type": "integer" },
+          "domain_types": { "type": "integer" }
+        }
+      },
+
+      "pass":   { "type": "boolean", "description": "True if ≥1 draft of each kind (agent/standard/type) was accepted, OR the user explicitly approves the empty-result verdict." },
+      "checks": {
+        "type": "array",
+        "items": {
+          "type": "object",
+          "properties": {
+            "name":   { "type": "string" },
+            "method": { "type": "string", "description": "How the check was performed. Required by the Verdict core invariant (#227/#228) — this item schema previously omitted it, so a maximally schema-valid seeding-verdict was unsealable." },
+            "passed": { "type": "boolean" },
+            "note":   { "type": "string" }
+          },
+          "required": ["name", "method", "passed"]
+        }
+      },
+
+      "outcome":          { "type": "string", "enum": ["completed", "partial", "refined", "aborted"] },
+      "next_step_hint":   { "type": "string", "description": "What to run next." }
+    },
+    "required": ["input_refs", "repos_surveyed", "pass", "checks", "outcome"]
+  },
+  "required_fields": []
+}

package/domain_types/soft-verdict.json

@@ -0,0 +1,55 @@
+{
+  "slug": "soft-verdict",
+  "version": 1,
+  "extends": "Interpretation",
+  "domain": "self_judge",
+  "status": "active",
+  "schema": {
+    "type": "object",
+    "properties": {
+      "criteria": {
+        "type": "object",
+        "properties": {
+          "parent_context_preservation": {
+            "type": "object",
+            "properties": {
+              "score": { "type": ["number", "null"] },
+              "rationale": { "type": "string" }
+            }
+          },
+          "child_stay_on_task": {
+            "type": "object",
+            "properties": {
+              "score": { "type": ["number", "null"] },
+              "rationale": { "type": "string" }
+            }
+          },
+          "inter_turn_coherence": {
+            "type": "object",
+            "properties": {
+              "score": { "type": ["number", "null"] },
+              "rationale": { "type": "string" }
+            }
+          },
+          "graceful_degradation": {
+            "type": "object",
+            "properties": {
+              "score": { "type": ["number", "null"] },
+              "rationale": { "type": "string" }
+            }
+          }
+        }
+      },
+      "overall_verdict_shade": {
+        "type": "string",
+        "enum": ["pass", "mixed", "fail", "not-judgeable"]
+      },
+      "top_insight": { "type": "string" }
+    }
+  },
+  "required_fields": [
+    "criteria",
+    "overall_verdict_shade",
+    "claims"
+  ]
+}

package/domain_types/summary.json

@@ -0,0 +1,19 @@
+{
+  "slug": "summary",
+  "version": 1,
+  "extends": "Interpretation",
+  "domain": "demo",
+  "status": "active",
+  "schema": {
+    "type": "object",
+    "properties": {
+      "gist": {
+        "type": "string"
+      }
+    }
+  },
+  "required_fields": [
+    "gist",
+    "claims"
+  ]
+}

package/domain_types/triage-verdict.json

@@ -0,0 +1,59 @@
+{
+  "slug": "triage-verdict",
+  "version": 1,
+  "extends": "Verdict",
+  "domain": "patent-triage",
+  "status": "active",
+  "schema": {
+    "type": "object",
+    "properties": {
+      "invention_id": {
+        "type": "string"
+      },
+      "recommended": {
+        "type": "string",
+        "enum": [
+          "FILEABLE",
+          "REFINE-FIRST",
+          "NOT-FILEABLE",
+          "INSUFFICIENT-EVIDENCE"
+        ]
+      },
+      "rationale": {
+        "type": "string"
+      },
+      "tests_passed": {
+        "type": "array"
+      },
+      "tests_failed": {
+        "type": "array"
+      },
+      "next_step": {
+        "type": "string"
+      },
+      "caveat": {
+        "type": "string"
+      },
+      "gated": {
+        "type": "boolean"
+      },
+      "gate_reasons": {
+        "type": "array"
+      },
+      "original_recommended": {
+        "type": "string"
+      },
+      "has_patent_coverage": {
+        "type": "boolean"
+      },
+      "survival_count": {
+        "type": "number"
+      }
+    }
+  },
+  "required_fields": [
+    "recommended",
+    "rationale",
+    "checks"
+  ]
+}

package/domain_types/user-flow-transcript.json

@@ -0,0 +1,43 @@
+{
+  "slug": "user-flow-transcript",
+  "version": 1,
+  "extends": "Signal",
+  "domain": "self_judge",
+  "status": "active",
+  "schema": {
+    "type": "object",
+    "properties": {
+      "transcript_present": { "type": "boolean" },
+      "turn_count": { "type": "number" },
+      "turns": {
+        "type": "array",
+        "items": {
+          "type": "object",
+          "properties": {
+            "turn_idx": { "type": "number" },
+            "user_intent": { "type": "string" },
+            "claude_response": { "type": "string" },
+            "tool_calls": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "tool_name": { "type": "string" },
+                  "args": { "type": ["object", "null"] }
+                }
+              }
+            },
+            "post_turn_genome_state": { "type": ["object", "null"] },
+            "malformed_input": { "type": "boolean" }
+          }
+        }
+      },
+      "notes": { "type": "string" }
+    }
+  },
+  "required_fields": [
+    "transcript_present",
+    "turns",
+    "source"
+  ]
+}