Handoff seeds: issue/hypothesis schemas, templates, round-trip corpus

packages/extension/handoff-seeds/hypothesis-seed.schema.json

@@ -0,0 +1,23 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "amicode:handoff-seeds/hypothesis-seed.schema.json",
+  "title": "Hypothesis handoff seed (dev closes → research picks up)",
+  "description": "Typed cross-campaign currency for a code-side observation that deserves an experiment. Rendered to the vault hypothesis-card convention by the committed hypothesis-seed template; filed by the receiving side into the vault. Evidence pointers are vault-relative paths that must resolve at validation time. String fields are single-line so the template render is total.",
+  "type": "object",
+  "properties": {
+    "kind": {
+      "const": "hypothesis",
+      "description": "Fixed discriminator; bound mechanically to this field set (the masquerade test)."
+    },
+    "observation": { "type": "string", "minLength": 1, "pattern": "^[^\\n\\r]*$" },
+    "evidence": {
+      "type": "array",
+      "minItems": 1,
+      "uniqueItems": true,
+      "items": { "type": "string", "minLength": 1, "pattern": "^[^\\n\\r]*$" }
+    },
+    "suggested_experiment": { "type": "string", "minLength": 1, "pattern": "^[^\\n\\r]*$" }
+  },
+  "required": ["kind", "observation", "evidence", "suggested_experiment"],
+  "additionalProperties": false
+}

packages/extension/handoff-seeds/hypothesis-seed.template.md

@@ -0,0 +1,15 @@
+---
+type: hypothesis
+date: {{date}}
+source: handoff-seed
+status: open
+evidence:
+{{evidence}}
+tags: [hypothesis, handoff]
+---
+
+<!-- handoff-seed kind=hypothesis v1 -->
+
+# {{observation}}
+
+**Suggested experiment:** {{suggested_experiment}}

packages/extension/handoff-seeds/issue-seed.schema.json

@@ -0,0 +1,25 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "amicode:handoff-seeds/issue-seed.schema.json",
+  "title": "Issue handoff seed (research closes → dev picks up)",
+  "description": "Typed cross-campaign currency for a research finding that needs code. Rendered to the write-an-issue decision surface by the committed issue-seed template; filed by the receiving side through the normal issue flow. Evidence pointers are vault-relative paths that must resolve at validation time. String fields are single-line so the template render is total.",
+  "type": "object",
+  "properties": {
+    "kind": {
+      "const": "issue",
+      "description": "Fixed discriminator; bound mechanically to this field set (the masquerade test)."
+    },
+    "title": { "type": "string", "minLength": 1, "pattern": "^[^\\n\\r]*$" },
+    "motivation": { "type": "string", "minLength": 1, "pattern": "^[^\\n\\r]*$" },
+    "evidence": {
+      "type": "array",
+      "minItems": 1,
+      "uniqueItems": true,
+      "items": { "type": "string", "minLength": 1, "pattern": "^[^\\n\\r]*$" }
+    },
+    "suggested_repo": { "type": "string", "minLength": 1, "pattern": "^[^\\n\\r]*$" },
+    "suggested_tier": { "enum": ["chore", "standard", "PRD"] }
+  },
+  "required": ["kind", "title", "motivation", "evidence", "suggested_repo", "suggested_tier"],
+  "additionalProperties": false
+}

packages/extension/handoff-seeds/issue-seed.template.md

@@ -0,0 +1,25 @@
+---
+kind: {{kind}}
+suggested_repo: {{suggested_repo}}
+suggested_tier: {{suggested_tier}}
+evidence:
+{{evidence}}
+---
+
+<!-- handoff-seed kind=issue v1 -->
+
+# {{title}}
+
+> [!IMPORTANT]
+> **Problem** — {{motivation}}
+> **Approach** — Typed handoff from a research campaign; file through the normal issue flow at the suggested tier.
+> **Scope** — in: the seeded ask · out: filing agency (the receiving side files it)
+
+## Acceptance Criteria
+- [ ] The filed issue carries the seed's evidence pointers, resolved at handoff time
+
+## Prior Art
+- Evidence pointers ride the frontmatter `evidence` list; each resolved at validation time.
+
+## Source
+- Handoff issue seed, rendered from the committed template.