refactor(evidence): unify formulas with typed evidence

2026-08-25 01:23:04 +02:00
parent d5d65f3659
commit cc30148b69
11 changed files with 342 additions and 38 deletions
@@ -348,6 +348,14 @@ Prerequisite: Phase 3 closed.
   "<concept>"` (or derive it from the evidence/context), present it, and let the
   reviewer approve/reject (`concept_formula_approved`/`concept_formula_rejected`).
   Reflect the approved formula in `schema_linking.json` (`concept_formulas`).
+4. **Formula proposals.** A `kind=formula` result from Evidence search is Published
+Evidence and can be cited with its provenance. If no published formula is suitable and
+you synthesize one for this question, present it to the reviewer and, after their F4
+decision, include `{concept, columns, sql, sources}` in `concept_formulas`. This creates
+a schema-versioned, **session-only Formula proposal**: it helps this session but is not
+Published Evidence, has no `evidence:` ID, is not returned by runtime search, and never
+writes to the workspace repository. A curator must separately import, review, and
+publish it before another session can treat it as Evidence.
 5. Persist the **joins** (and any `concept_formulas`/`open_questions`) with the gate's
   `write_schema_linking` tool — it validates the object against the `SchemaLinking`
   model and writes the file deterministically (never hand-write it, never edit it
@@ -0,0 +1,8 @@
+4. **Formula proposals.** A `kind=formula` result from Evidence search is Published
+Evidence and can be cited with its provenance. If no published formula is suitable and
+you synthesize one for this question, present it to the reviewer and, after their F4
+decision, include `{concept, columns, sql, sources}` in `concept_formulas`. This creates
+a schema-versioned, **session-only Formula proposal**: it helps this session but is not
+Published Evidence, has no `evidence:` ID, is not returned by runtime search, and never
+writes to the workspace repository. A curator must separately import, review, and
+publish it before another session can treat it as Evidence.
@@ -216,6 +216,7 @@ Prerequisite: Phase 3 closed.
   those to joins you derive yourself, and flag to the reviewer any join you need
   that is NOT in the list.
 {{DISAMBIGUATION_SCHEMA_GROUNDING}}
+{{EVIDENCE_FORMULA_PROPOSALS}}
 5. Persist the **joins** (and any `concept_formulas`/`open_questions`) with the gate's
   `write_schema_linking` tool — it validates the object against the `SchemaLinking`
   model and writes the file deterministically (never hand-write it, never edit it