eduevidence 5.2.0 → 6.2.0

package/schemas/vNext/gap-priority.schema.json

@@ -0,0 +1,54 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "GapPriority",
+  "description": "Ranking of one knowledge gap for research attention (engine/autoresearch/gap_priority.py). Combines decision sensitivity, current uncertainty, directness deficit, applicability, availability and risk minus cost into a score, and names the next research mode. Produced by controllers.select_gap(), not by an LLM.",
+  "type": "object",
+  "required": [
+    "gap_id",
+    "dvi_band",
+    "cost_band",
+    "decision_material",
+    "drivers",
+    "next_research_mode",
+    "score"
+  ],
+  "properties": {
+    "gap_id": {
+      "type": "string"
+    },
+    "dvi_band": {
+      "enum": [
+        "HIGH",
+        "MEDIUM",
+        "LOW"
+      ]
+    },
+    "cost_band": {
+      "enum": [
+        "HIGH",
+        "MEDIUM",
+        "LOW"
+      ]
+    },
+    "decision_material": {
+      "type": "boolean"
+    },
+    "drivers": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "next_research_mode": {
+      "enum": [
+        "secondary_evidence_search",
+        "defer",
+        "empirical_evidence_needed"
+      ]
+    },
+    "score": {
+      "type": "integer"
+    }
+  },
+  "additionalProperties": false
+}

package/schemas/vNext/negative-search-record.schema.json

@@ -0,0 +1,68 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "NegativeSearchRecord",
+  "description": "A search that legitimately returned nothing usable (engine/autoresearch/contracts.py NegativeSearchRecord). Zero-result searches are recorded rather than discarded: without them, absence of evidence is indistinguishable from failure to look, and retrieval saturation cannot be judged. Written by ResearchMemory.append_negative_search().",
+  "type": "object",
+  "required": [
+    "negative_search_id",
+    "research_iteration_id",
+    "gap_id",
+    "queries",
+    "providers",
+    "candidate_count",
+    "fetched_count",
+    "eligible_count",
+    "conclusion"
+  ],
+  "properties": {
+    "negative_search_id": {
+      "type": "string"
+    },
+    "research_iteration_id": {
+      "type": "string"
+    },
+    "gap_id": {
+      "type": "string"
+    },
+    "queries": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "providers": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "candidate_count": {
+      "type": "integer",
+      "minimum": 0
+    },
+    "fetched_count": {
+      "type": "integer",
+      "minimum": 0
+    },
+    "eligible_count": {
+      "const": 0
+    },
+    "exclusion_reasons": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "integer",
+        "minimum": 0
+      }
+    },
+    "scope": {
+      "type": "object"
+    },
+    "searched_at": {
+      "type": "string"
+    },
+    "conclusion": {
+      "const": "no_eligible_evidence_found_within_search_scope"
+    }
+  },
+  "additionalProperties": false
+}

package/schemas/vNext/research-iteration.schema.json

@@ -0,0 +1,87 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "ResearchIteration",
+  "description": "One autoresearch loop iteration (engine/autoresearch/contracts.py ResearchIteration, persisted by ResearchMemory.append_iteration). Records which knowledge gap was attacked, the strategy and budget used, what was retrieved and validated, whether a new GraphRevision was created, and how the loop stopped. Written by scripts/research_auto_cli.py.",
+  "type": "object",
+  "required": [
+    "iteration_id",
+    "project_id",
+    "base_graph_revision",
+    "gap_id",
+    "strategy",
+    "status"
+  ],
+  "properties": {
+    "iteration_id": {
+      "type": "string"
+    },
+    "project_id": {
+      "type": "string"
+    },
+    "base_graph_revision": {
+      "type": "integer",
+      "minimum": 0
+    },
+    "gap_id": {
+      "type": "string"
+    },
+    "gap_lineage_key": {
+      "type": [
+        "string",
+        "null"
+      ],
+      "pattern": "^KGK-"
+    },
+    "strategy": {
+      "type": "object"
+    },
+    "validated_evidence_ids": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "negative_search_ids": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "evidence_gain": {
+      "type": "object"
+    },
+    "new_graph_revision": {
+      "type": [
+        "integer",
+        "null"
+      ]
+    },
+    "decision_snapshot_id": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "status": {
+      "enum": [
+        "completed_gain",
+        "completed_no_gain",
+        "search_saturated",
+        "empirical_needed",
+        "budget_exhausted",
+        "tool_failure",
+        "invalid"
+      ]
+    },
+    "started_at": {
+      "type": "string"
+    },
+    "completed_at": {
+      "type": [
+        "string",
+        "null"
+      ]
+    }
+  },
+  "additionalProperties": true
+}

package/schemas/vNext/research-strategy.schema.json

@@ -0,0 +1,62 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "ResearchStrategy",
+  "description": "The planned attack on one knowledge gap (engine/autoresearch/contracts.py ResearchStrategy). Names the experiment type, the hypothesis it tests, the expected gain, and the research budget. strategy_id/hypothesis/expected_gain are required by ResearchStrategy.validate().",
+  "type": "object",
+  "required": [
+    "strategy_id",
+    "experiment_type",
+    "hypothesis",
+    "expected_gain",
+    "budget"
+  ],
+  "properties": {
+    "strategy_id": {
+      "type": "string",
+      "minLength": 1
+    },
+    "experiment_type": {
+      "enum": [
+        "TARGETED_RETRIEVAL",
+        "COUNTER_EVIDENCE_RETRIEVAL",
+        "APPLICABILITY_RETRIEVAL",
+        "TEMPORAL_REFRESH",
+        "CITATION_CHAINING",
+        "SCREENING_PRIORITY",
+        "SOURCE_RECOVERY"
+      ]
+    },
+    "hypothesis": {
+      "type": "string",
+      "minLength": 1
+    },
+    "expected_gain": {
+      "type": "string",
+      "minLength": 1
+    },
+    "budget": {
+      "type": "object",
+      "required": [
+        "max_queries",
+        "max_candidates",
+        "max_fulltext_fetches"
+      ],
+      "properties": {
+        "max_queries": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "max_candidates": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "max_fulltext_fetches": {
+          "type": "integer",
+          "minimum": 0
+        }
+      },
+      "additionalProperties": false
+    }
+  },
+  "additionalProperties": false
+}

package/schemas/vNext/skill-experiment.schema.json

@@ -0,0 +1,90 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "SkillExperiment",
+  "description": "One bounded self-evolution experiment (engine/autoevolve/core.py). Pairs a hypothesis and mutation scope with the baseline and candidate evaluation ids and the protected-tree hashes before and after, then records the promotion verdict. Automatic KEEP requires runner-owned isolation and an intact protected tree.",
+  "type": "object",
+  "required": [
+    "experiment_id",
+    "session_id",
+    "parent_skill_revision",
+    "hypothesis",
+    "mutation_scope",
+    "status"
+  ],
+  "properties": {
+    "experiment_id": {
+      "type": "string"
+    },
+    "session_id": {
+      "type": "string"
+    },
+    "parent_skill_revision": {
+      "type": "string"
+    },
+    "hypothesis": {
+      "type": "string",
+      "minLength": 1
+    },
+    "mutation_scope": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "minItems": 1
+    },
+    "changed_files": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "candidate_commit": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "baseline_eval_id": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "candidate_eval_id": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "protected_hash_before": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "protected_hash_after": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "status": {
+      "enum": [
+        "created",
+        "KEEP",
+        "REJECT",
+        "RETEST",
+        "HUMAN_REVIEW",
+        "CRASH",
+        "INVALID"
+      ]
+    },
+    "promotion_reason": {
+      "type": "string"
+    },
+    "complexity_delta": {
+      "type": "number"
+    }
+  },
+  "additionalProperties": false
+}

package/schemas/vNext/task-spec.schema.json

@@ -0,0 +1,156 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "TaskSpec",
+  "description": "A dispatchable unit of work for one role (engine/orchestration.py TaskSpec). Fixes the stage, role, evidence axis, run and base revision, the granted capabilities, forbidden actions, budget, expected outputs and the output contract. Delegated specs are staging-only: canonical-state artifacts are refused by construction.",
+  "type": "object",
+  "required": [
+    "task_id",
+    "run_id",
+    "base_revision",
+    "stage",
+    "role",
+    "role_profile",
+    "objective",
+    "reason_for_delegation",
+    "evidence_axis",
+    "inputs",
+    "input_artifacts",
+    "allowed_capabilities",
+    "forbidden_actions",
+    "scope",
+    "budget",
+    "expected_outputs",
+    "output_contract",
+    "termination",
+    "execution_mode",
+    "independent",
+    "read_only",
+    "timeout_seconds",
+    "token_budget",
+    "metadata"
+  ],
+  "properties": {
+    "task_id": {
+      "type": "string",
+      "minLength": 1
+    },
+    "run_id": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "base_revision": {
+      "type": [
+        "integer",
+        "null"
+      ],
+      "minimum": 0
+    },
+    "stage": {
+      "enum": [
+        "frame",
+        "retrieve",
+        "extract",
+        "challenge",
+        "audit",
+        "adjudicate",
+        "applicability",
+        "intervene",
+        "evaluate"
+      ]
+    },
+    "role": {
+      "type": "string"
+    },
+    "role_profile": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "objective": {
+      "type": "string",
+      "minLength": 1
+    },
+    "reason_for_delegation": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "evidence_axis": {
+      "type": "string",
+      "minLength": 1
+    },
+    "inputs": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "input_artifacts": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "allowed_capabilities": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "forbidden_actions": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "scope": {
+      "type": "object"
+    },
+    "budget": {
+      "type": "object"
+    },
+    "expected_outputs": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "output_contract": {
+      "type": "object"
+    },
+    "termination": {
+      "type": "object"
+    },
+    "execution_mode": {
+      "enum": [
+        "local",
+        "delegated"
+      ]
+    },
+    "independent": {
+      "type": "boolean"
+    },
+    "read_only": {
+      "type": "boolean"
+    },
+    "timeout_seconds": {
+      "type": "integer",
+      "minimum": 1
+    },
+    "token_budget": {
+      "type": [
+        "integer",
+        "null"
+      ],
+      "minimum": 1
+    },
+    "metadata": {
+      "type": "object"
+    }
+  },
+  "additionalProperties": false
+}

package/schemas/vNext/worker-result.schema.json

@@ -0,0 +1,60 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "WorkerResult",
+  "description": "The lead process's verdict on one worker's submission (engine/worker_result.py). validate_worker_output() reconstructs this from untrusted worker output: any worker-supplied validated flag is ignored, canonical-state artifacts are rejected, and only results that pass here may enter a Judge context.",
+  "type": "object",
+  "required": [
+    "task_id",
+    "status",
+    "staging_artifacts",
+    "validated",
+    "validation_issues",
+    "metrics",
+    "summary"
+  ],
+  "properties": {
+    "task_id": {
+      "type": "string",
+      "minLength": 1
+    },
+    "status": {
+      "enum": [
+        "completed",
+        "failed",
+        "blocked"
+      ]
+    },
+    "staging_artifacts": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": [
+          "artifact_type"
+        ],
+        "properties": {
+          "artifact_type": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "additionalProperties": true
+      }
+    },
+    "validated": {
+      "type": "boolean"
+    },
+    "validation_issues": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "metrics": {
+      "type": "object"
+    },
+    "summary": {
+      "type": "string"
+    }
+  },
+  "additionalProperties": false
+}