1{
2  "$schema": "https://json-schema.org/draft/2020-12/schema",
3  "title": "RunManifest",
4  "description": "Manifest for a single research run. Created at init, updated throughout.",
5  "type": "object",
6  "required": ["version", "query", "mode", "started_at", "report_dir", "artifact_paths"],
7  "properties": {
8    "version": {
9      "type": "string",
10      "const": "3.0.0"
11    },
12    "query": {
13      "type": "string",
14      "description": "Original research question"
15    },
16    "mode": {
17      "type": "string",
18      "enum": ["quick", "standard", "deep", "ultradeep"]
19    },
20    "started_at": {
21      "type": "string",
22      "format": "date-time"
23    },
24    "finished_at": {
25      "type": ["string", "null"],
26      "format": "date-time",
27      "default": null
28    },
29    "assumptions": {
30      "type": "array",
31      "items": {
32        "type": "object",
33        "required": ["assumption_id", "text", "materiality", "status"],
34        "properties": {
35          "assumption_id": {
36            "type": "string",
37            "pattern": "^asm_[0-9a-f]{8}$"
38          },
39          "text": { "type": "string" },
40          "materiality": {
41            "type": "string",
42            "enum": ["low", "medium", "high"]
43          },
44          "status": {
45            "type": "string",
46            "enum": ["implicit", "user_confirmed", "evidence_validated"]
47          }
48        },
49        "additionalProperties": false
50      },
51      "default": []
52    },
53    "provider_config": {
54      "type": "object",
55      "properties": {
56        "primary": {
57          "type": "string",
58          "description": "Primary search provider (e.g. WebSearch)"
59        },
60        "scholarly": {
61          "type": ["string", "null"],
62          "description": "Scholarly API provider if configured (e.g. openalex, semantic_scholar)"
63        }
64      },
65      "default": { "primary": "search-cli", "scholarly": null }
66    },
67    "report_dir": {
68      "type": "string",
69      "description": "Absolute path to the report directory"
70    },
71    "artifact_paths": {
72      "type": "object",
73      "required": ["sources", "evidence", "claims", "report"],
74      "properties": {
75        "sources": { "type": "string", "default": "sources.jsonl" },
76        "evidence": { "type": "string", "default": "evidence.jsonl" },
77        "claims": { "type": "string", "default": "claims.jsonl" },
78        "report": { "type": "string", "default": "report.md" }
79      },
80      "additionalProperties": false
81    },
82    "continuation": {
83      "type": ["object", "null"],
84      "description": "Populated when resuming a previous run",
85      "properties": {
86        "previous_run_manifest": { "type": "string" },
87        "resumed_at": { "type": "string", "format": "date-time" },
88        "sections_completed": {
89          "type": "array",
90          "items": { "type": "string" }
91        }
92      },
93      "default": null
94    }
95  },
96  "additionalProperties": false
97}
98