zob-harness 0.1.0

package/.pi/factories/project-dna/golden-cases-smoke.json

@@ -0,0 +1,62 @@
+{
+  "schema": "zob.project-dna-golden-suite.v1",
+  "suite_id": "project-dna-5of5-agentic-smoke",
+  "description": "Golden cases for the repo-local ProjectDNA factory smoke. They verify agents-first controls, query stewarding, source-safe scans, quarantine sample posture, and oracle benchmark readiness.",
+  "source_id": "project-dna-factory",
+  "raw_queries_persisted": false,
+  "knowledge_backend_write_enabled": false,
+  "promotion_policy": "proposal_only",
+  "minimum_score": 5,
+  "cases": [
+    {
+      "id": "agentic-control-plane",
+      "intent_id": "project_dna.agentic_control_plane",
+      "query": "agents first project dna factory scripts as tools validation gates",
+      "required_citation_includes": ["factory.json", "README.md"],
+      "required_files_to_read_first": ["factory.json", "README.md"],
+      "expected_patterns": ["project_dna.agentic_control_plane"],
+      "required_safety": ["bounded_context_only", "citation_required", "no_knowledge_backend_write", "proposal_only"],
+      "score_threshold": 5
+    },
+    {
+      "id": "manifest-compute-capture-policy",
+      "intent_id": "project_dna.source_safe_proposal_only",
+      "query": "manifest compute profile capture mode source mutation backend write policy",
+      "required_citation_includes": ["example-project-dna-manifest-v2.json", "schemas/manifest-v2.schema.json"],
+      "required_files_to_read_first": ["example-project-dna-manifest-v2.json", "schemas/manifest-v2.schema.json"],
+      "expected_patterns": ["project_dna.source_safe_proposal_only"],
+      "required_safety": ["bounded_context_only", "citation_required", "no_knowledge_backend_write", "proposal_only"],
+      "score_threshold": 5
+    },
+    {
+      "id": "context-pack-bounded-citations",
+      "intent_id": "project_dna.query_steward_rewrite",
+      "query": "context pack schema bounded citations loading rules query steward",
+      "required_citation_includes": ["schemas/context-pack.schema.json", "README.md"],
+      "required_files_to_read_first": ["schemas/context-pack.schema.json"],
+      "expected_patterns": ["project_dna.query_steward_rewrite"],
+      "required_safety": ["bounded_context_only", "citation_required", "no_knowledge_backend_write", "proposal_only"],
+      "score_threshold": 5
+    },
+    {
+      "id": "ontology-golden-benchmark",
+      "intent_id": "project_dna.golden_case_benchmark",
+      "query": "ontology golden cases benchmark oracle 5 of 5 project dna",
+      "required_citation_includes": ["pi-agentic-ontology.json", "golden-cases-smoke.json"],
+      "required_files_to_read_first": ["pi-agentic-ontology.json", "golden-cases-smoke.json"],
+      "expected_patterns": ["project_dna.ontology_curation", "project_dna.golden_case_benchmark"],
+      "required_safety": ["bounded_context_only", "citation_required", "no_knowledge_backend_write", "proposal_only"],
+      "score_threshold": 5
+    },
+    {
+      "id": "sample-quarantine-pi-like",
+      "intent_id": "project_dna.sample_quarantine_pi_like",
+      "query": "quarantine sample pi-like extension skill agent test no source copy",
+      "required_citation_includes": ["README.md", "factory.json"],
+      "required_files_to_read_first": ["README.md", "factory.json"],
+      "expected_patterns": ["project_dna.sample_quarantine_pi_like"],
+      "required_safety": ["bounded_context_only", "citation_required", "no_knowledge_backend_write", "proposal_only"],
+      "score_threshold": 5
+    }
+  ]
+}

package/.pi/factories/project-dna/pi-agentic-ontology.json

@@ -0,0 +1,88 @@
+{
+  "schema": "zob.project-dna-ontology.v1",
+  "ontology_id": "pi-agentic-project-dna",
+  "description": "Controlled ProjectDNA ontology for agents-first Pi/ZOB harness retrieval. Static concepts are navigation hints; scan artifacts remain source of truth.",
+  "source_safe": true,
+  "raw_bodies_stored": false,
+  "knowledge_backend_write_enabled": false,
+  "promotion_policy": "proposal_only",
+  "concepts": [
+    {
+      "id": "project_dna.agentic_control_plane",
+      "kind": "workflow",
+      "aliases": ["agentic", "agents-first", "orchestrator", "parent-owned", "scripts-as-tools"],
+      "expected_file_hints": ["factory.json", "README.md", "project-dna.md", "SKILL.md"],
+      "expected_artifact_roles": ["agent", "prompt", "skill", "factory"],
+      "minimum_citation_roles": ["source", "doc"]
+    },
+    {
+      "id": "project_dna.ontology_curation",
+      "kind": "pattern",
+      "aliases": ["ontology", "concept", "pattern", "graph", "edge", "node"],
+      "expected_file_hints": ["ontology", "code-knowledge-graph", "architecture-map", "symbol-map"],
+      "expected_artifact_roles": ["schema", "scan", "graph"],
+      "minimum_citation_roles": ["source", "schema"]
+    },
+    {
+      "id": "project_dna.query_steward_rewrite",
+      "kind": "retrieval",
+      "aliases": ["query", "rewrite", "intent", "expanded", "bounded context", "retrieval"],
+      "expected_file_hints": ["query-context.mjs", "query-steward", "context-pack"],
+      "expected_artifact_roles": ["script", "context-pack", "query-result"],
+      "minimum_citation_roles": ["source", "query"]
+    },
+    {
+      "id": "project_dna.golden_case_benchmark",
+      "kind": "benchmark",
+      "aliases": ["golden", "benchmark", "score", "5/5", "oracle", "evaluation"],
+      "expected_file_hints": ["golden-cases", "bench-smoke.mjs", "oracle-review-smoke.mjs"],
+      "expected_artifact_roles": ["golden-case", "benchmark", "oracle"],
+      "minimum_citation_roles": ["benchmark", "oracle"]
+    },
+    {
+      "id": "project_dna.sample_quarantine_pi_like",
+      "kind": "sample",
+      "aliases": ["sample", "quarantine", "new project", "pi-like", "extension", "skill", "agent", "test"],
+      "expected_file_hints": ["generate-sample.mjs", "sample-spec.json", "quarantine", "package.json", "README.md"],
+      "expected_artifact_roles": ["sample", "test", "config"],
+      "minimum_citation_roles": ["sample", "validation"]
+    },
+    {
+      "id": "project_dna.source_safe_proposal_only",
+      "kind": "safety",
+      "aliases": ["read-only", "source safe", "proposal-only", "no backend write", "no promotion", "secret"],
+      "expected_file_hints": ["scan-summary.json", "project-dna-sample-summary.json", "oracle", "validation"],
+      "expected_artifact_roles": ["safety", "validation", "oracle"],
+      "minimum_citation_roles": ["validation", "oracle"]
+    }
+  ],
+  "edge_types": [
+    "contains",
+    "imports",
+    "implements_pattern",
+    "demonstrates_pattern",
+    "tested_by",
+    "documented_by",
+    "validated_by",
+    "cited_by"
+  ],
+  "citation_policy": {
+    "citation_required": true,
+    "prefer_symbol_ranges": true,
+    "broad_citation_max_ratio": 0.5,
+    "raw_body_storage_allowed": false
+  },
+  "agent_lanes": [
+    "project-dna-safety-preflight",
+    "repo-scout",
+    "project-dna-ontology-steward",
+    "architecture-cartographer",
+    "pattern-miner",
+    "symbol-range-curator",
+    "project-dna-test-linker",
+    "project-dna-query-steward",
+    "sample-architect",
+    "project-dna-golden-evaluator",
+    "project-dna-oracle"
+  ]
+}

package/.pi/factories/project-dna/pilot-manifest.json

@@ -0,0 +1,32 @@
+{
+  "factory": "project-dna",
+  "description": "Pilot manifest for ProjectDNA scaffold review across the plan, skill, prompt, and factory definition. Requires successful smoke plus oracle review before execution beyond plan_only.",
+  "items": [
+    {
+      "id": "project-dna-plan",
+      "path": "docs/ZOB_PROJECT_DNA_CODE_KNOWLEDGE_GRAPH_PLAN.md",
+      "metadata": { "source": "local-plan-doc" }
+    },
+    {
+      "id": "project-dna-skill",
+      "path": ".pi/skills/zob-project-dna/SKILL.md",
+      "metadata": { "source": "skill" }
+    },
+    {
+      "id": "project-dna-prompt",
+      "path": ".pi/prompts/project-dna.md",
+      "metadata": { "source": "prompt-template" }
+    },
+    {
+      "id": "project-dna-factory",
+      "path": ".pi/factories/project-dna/factory.json",
+      "metadata": { "source": "factory-definition" }
+    }
+  ],
+  "expectedArtifacts": [
+    "project-dna-summary.json",
+    "project-dna-context-pack.json",
+    "project-dna-readiness.json",
+    "project-dna-capsules.md"
+  ]
+}

package/.pi/factories/project-dna/schemas/benchmark-suite.schema.json

@@ -0,0 +1,27 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://zob.local/project-dna/benchmark-suite.schema.json",
+  "type": "object",
+  "required": ["schema", "scan_dir", "status", "cases", "metrics", "gates"],
+  "properties": {
+    "schema": { "const": "zob.project-dna-benchmark-smoke.v1" },
+    "benchmark_kind": { "type": "string" },
+    "scan_dir": { "type": "string" },
+    "status": { "enum": ["passed", "failed"] },
+    "cases": { "type": "array", "items": { "type": "object" } },
+    "metrics": { "type": "object" },
+    "gates": {
+      "type": "object",
+      "required": ["deterministic_only", "llm_judge_used", "source_project_modified", "knowledge_backend_write_enabled", "promotion_allowed", "human_approval_required"],
+      "properties": {
+        "deterministic_only": { "const": true },
+        "llm_judge_used": { "const": false },
+        "source_project_modified": { "const": false },
+        "knowledge_backend_write_enabled": { "const": false },
+        "promotion_allowed": { "const": false },
+        "human_approval_required": { "const": true }
+      }
+    }
+  },
+  "additionalProperties": true
+}

package/.pi/factories/project-dna/schemas/code-knowledge-graph.schema.json

@@ -0,0 +1,97 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://zob.local/schemas/code-knowledge-graph.v1.json",
+  "title": "ProjectDNA Code Knowledge Graph",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema", "source_id", "nodes", "edges", "citation_required", "promotion"],
+  "properties": {
+    "schema": { "const": "zob.code-knowledge-graph.v1" },
+    "source_id": { "type": "string" },
+    "sample_id": { "type": "string" },
+    "nodes": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": true,
+        "required": ["id", "type", "label"],
+        "properties": {
+          "id": { "type": "string" },
+          "type": {
+            "enum": [
+              "Project",
+              "SourceProject",
+              "SampleProject",
+              "File",
+              "Directory",
+              "Module",
+              "Symbol",
+              "Dependency",
+              "Tool",
+              "Route",
+              "Service",
+              "Queue",
+              "Worker",
+              "DatabaseModel",
+              "Config",
+              "Test",
+              "Pattern",
+              "AntiPattern",
+              "Capsule",
+              "ValidationCommand"
+            ]
+          },
+          "label": { "type": "string" },
+          "path": { "type": "string" },
+          "confidence": { "enum": ["low", "medium", "high"] }
+        }
+      }
+    },
+    "edges": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": true,
+        "required": ["from", "to", "type", "citations"],
+        "properties": {
+          "from": { "type": "string" },
+          "to": { "type": "string" },
+          "type": {
+            "enum": [
+              "contains",
+              "imports",
+              "exports",
+              "calls",
+              "called_by",
+              "configured_by",
+              "tested_by",
+              "implements_pattern",
+              "demonstrates_pattern",
+              "source_equivalent_of",
+              "sample_equivalent_of",
+              "uses_dependency",
+              "uses_tool",
+              "exposes_route",
+              "handles_queue",
+              "runs_worker",
+              "validates_with",
+              "cited_by"
+            ]
+          },
+          "citations": { "type": "array", "items": { "type": "string", "minLength": 1 }, "minItems": 1 }
+        }
+      }
+    },
+    "citation_required": { "const": true },
+    "promotion": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["writeback_policy", "oracle_required"],
+      "properties": {
+        "writeback_policy": { "enum": ["proposal_only", "manual_approval_only"] },
+        "oracle_required": { "const": true },
+        "human_approval_required": { "type": "boolean" }
+      }
+    }
+  }
+}

package/.pi/factories/project-dna/schemas/context-pack.schema.json

@@ -0,0 +1,43 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://zob.local/schemas/project-dna-context-pack.v1.json",
+  "title": "ProjectDNA Context Pack",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema", "query_hash", "answer", "citations", "files_to_read_first", "rules", "gaps", "loading_rules"],
+  "properties": {
+    "schema": { "const": "zob.project-dna-context-pack.v1" },
+    "query_hash": { "type": "string", "pattern": "^[a-fA-F0-9]{64}$" },
+    "query_stored": { "const": false },
+    "answer": { "type": "string" },
+    "citations": { "type": "array", "items": { "type": "string", "minLength": 1 }, "minItems": 1 },
+    "files_to_read_first": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["path", "reason", "citations"],
+        "properties": {
+          "path": { "type": "string" },
+          "line_range": { "type": "string" },
+          "reason": { "type": "string" },
+          "citations": { "type": "array", "items": { "type": "string" }, "minItems": 1 }
+        }
+      }
+    },
+    "rules": { "type": "array", "items": { "type": "string" } },
+    "gaps": { "type": "array", "items": { "type": "string" } },
+    "max_context_tokens": { "type": "integer", "minimum": 1, "maximum": 8000 },
+    "loading_rules": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["bounded_context_only", "citation_required", "agent_loads_entire_project"],
+      "properties": {
+        "bounded_context_only": { "const": true },
+        "citation_required": { "const": true },
+        "agent_loads_entire_project": { "const": false },
+        "writeback_policy": { "enum": ["proposal_only", "manual_approval_only"] }
+      }
+    }
+  }
+}

package/.pi/factories/project-dna/schemas/golden-case.schema.json

@@ -0,0 +1,36 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://zob.local/project-dna/golden-case.schema.json",
+  "type": "object",
+  "required": ["schema", "suite_id", "source_id", "cases", "raw_queries_persisted", "knowledge_backend_write_enabled", "promotion_policy"],
+  "properties": {
+    "schema": { "const": "zob.project-dna-golden-suite.v1" },
+    "suite_id": { "type": "string", "pattern": "^[A-Za-z0-9._-]+$" },
+    "description": { "type": "string" },
+    "source_id": { "type": "string" },
+    "raw_queries_persisted": { "const": false },
+    "knowledge_backend_write_enabled": { "const": false },
+    "promotion_policy": { "const": "proposal_only" },
+    "minimum_score": { "type": "number", "minimum": 0, "maximum": 5 },
+    "cases": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "required": ["id", "intent_id", "query", "required_citation_includes", "required_files_to_read_first", "required_safety", "score_threshold"],
+        "properties": {
+          "id": { "type": "string", "pattern": "^[a-z0-9._-]+$" },
+          "intent_id": { "type": "string" },
+          "query": { "type": "string", "minLength": 1 },
+          "required_citation_includes": { "type": "array", "items": { "type": "string" } },
+          "required_files_to_read_first": { "type": "array", "items": { "type": "string" } },
+          "expected_patterns": { "type": "array", "items": { "type": "string" } },
+          "required_safety": { "type": "array", "items": { "type": "string" } },
+          "score_threshold": { "type": "number", "minimum": 0, "maximum": 5 }
+        },
+        "additionalProperties": true
+      }
+    }
+  },
+  "additionalProperties": true
+}

package/.pi/factories/project-dna/schemas/manifest-v2.schema.json

@@ -0,0 +1,128 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://zob.local/schemas/project-dna-manifest.v2.json",
+  "title": "ProjectDNA Manifest v2",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema",
+    "run_id",
+    "user_note",
+    "capture_goal",
+    "requested_compute_profile",
+    "capture_mode_policy",
+    "source_project",
+    "read_policy",
+    "sample_project",
+    "promotion"
+  ],
+  "properties": {
+    "schema": { "const": "zob.project-dna-manifest.v2" },
+    "run_id": { "type": "string", "pattern": "^[A-Za-z0-9._-]+$" },
+    "user_note": { "type": "string", "minLength": 1, "maxLength": 1000 },
+    "capture_goal": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["source_id", "objective", "bounded_context_only", "citation_required"],
+      "properties": {
+        "source_id": { "type": "string", "pattern": "^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?$" },
+        "objective": { "type": "string", "minLength": 1, "maxLength": 1000 },
+        "bounded_context_only": { "const": true },
+        "citation_required": { "const": true },
+        "allowed_artifact_level": { "enum": ["metadata_only", "cited_facts_only"] }
+      }
+    },
+    "requested_compute_profile": { "enum": ["auto", "low", "medium", "high", "xhigh", "max"] },
+    "compute_caps": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "maxAgents": { "type": "number", "minimum": 1, "maximum": 30 },
+        "maxDelegationDepth": { "type": "number", "minimum": 0, "maximum": 4 },
+        "maxParallel": { "type": "number", "minimum": 1, "maximum": 8 },
+        "maxIterations": { "type": "number", "minimum": 1, "maximum": 5 },
+        "maxDurationMs": { "type": "number", "minimum": 1 },
+        "maxCostUsd": { "type": "number", "minimum": 0 },
+        "maxContextTokens": { "type": "number", "minimum": 1 },
+        "strictBudgetRequired": { "const": true },
+        "oracleRequired": { "const": true }
+      }
+    },
+    "capture_mode_policy": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "mode",
+        "semantic_mode",
+        "metadata_only",
+        "parent_owned_dispatch",
+        "child_direct_dispatch_allowed",
+        "network_access_allowed",
+        "source_mutation_allowed",
+        "knowledge_backend_write_allowed"
+      ],
+      "properties": {
+        "mode": { "enum": ["plan_only", "read_only_scan", "metadata_workflow"] },
+        "semantic_mode": { "enum": ["full_capture", "architecture_only", "targeted_capture", "sample_first", "context_only"] },
+        "targeted_domains": {
+          "type": "array",
+          "items": { "enum": ["architecture", "api", "services", "database", "queues", "workers", "tests", "config", "ui", "agentic_assets", "docs"] },
+          "uniqueItems": true
+        },
+        "large_repo_fallback": { "enum": ["architecture_only", "targeted_capture", "sample_first", "context_only"] },
+        "metadata_only": { "const": true },
+        "parent_owned_dispatch": { "const": true },
+        "child_direct_dispatch_allowed": { "const": false },
+        "network_access_allowed": { "const": false },
+        "source_mutation_allowed": { "const": false },
+        "knowledge_backend_write_allowed": { "const": false },
+        "durable_promotion_allowed": { "const": false }
+      }
+    },
+    "source_project": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["source_id", "path"],
+      "properties": {
+        "source_id": { "type": "string", "pattern": "^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?$" },
+        "path": { "type": "string", "minLength": 1 },
+        "description": { "type": "string", "maxLength": 1000 }
+      }
+    },
+    "read_policy": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["allowed_paths", "forbidden_patterns", "forbid_secret_like_paths", "max_file_bytes", "external_project_scan_allowed"],
+      "properties": {
+        "allowed_paths": { "type": "array", "items": { "type": "string", "minLength": 1 }, "minItems": 1 },
+        "forbidden_patterns": { "type": "array", "items": { "type": "string", "minLength": 1 }, "minItems": 1 },
+        "forbid_secret_like_paths": { "const": true },
+        "max_file_bytes": { "type": "number", "minimum": 1, "maximum": 1048576 },
+        "external_project_scan_allowed": { "const": false }
+      }
+    },
+    "sample_project": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["name", "neutral_domain", "generation_policy", "copy_policy", "quarantine_required"],
+      "properties": {
+        "name": { "type": "string", "pattern": "^[A-Za-z0-9._-]+$" },
+        "neutral_domain": { "type": "string", "minLength": 1 },
+        "generation_policy": { "enum": ["plan_only", "quarantine_only"] },
+        "copy_policy": { "enum": ["structure_and_patterns_only", "no_copy_plan_only"] },
+        "quarantine_required": { "const": true }
+      }
+    },
+    "promotion": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["writeback_policy", "requires_oracle_pass", "requires_human_approval", "durable_promotion_allowed"],
+      "properties": {
+        "writeback_policy": { "const": "proposal_only" },
+        "requires_oracle_pass": { "const": true },
+        "requires_human_approval": { "const": true },
+        "durable_promotion_allowed": { "const": false }
+      }
+    }
+  }
+}

package/.pi/factories/project-dna/schemas/manifest.schema.json

@@ -0,0 +1,77 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://zob.local/schemas/project-dna-manifest.v1.json",
+  "title": "ProjectDNA Manifest",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema", "source_project", "sample_project", "read_policy", "promotion"],
+  "properties": {
+    "schema": { "const": "zob.project-dna-manifest.v1" },
+    "run_id": { "type": "string", "pattern": "^[A-Za-z0-9._-]+$" },
+    "compute_profile": { "enum": ["auto", "low", "medium", "high", "xhigh", "max"], "default": "auto" },
+    "compute_caps": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "maxAgents": { "type": "number", "minimum": 1, "maximum": 30 },
+        "maxDelegationDepth": { "type": "number", "minimum": 0, "maximum": 4 },
+        "maxParallel": { "type": "number", "minimum": 1, "maximum": 8 },
+        "maxIterations": { "type": "number", "minimum": 1, "maximum": 5 },
+        "maxDurationMs": { "type": "number", "minimum": 1 },
+        "maxCostUsd": { "type": "number", "minimum": 0 },
+        "maxContextTokens": { "type": "number", "minimum": 1 },
+        "strictBudgetRequired": { "type": "boolean" },
+        "oracleRequired": { "type": "boolean" }
+      }
+    },
+    "source_project": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["source_id", "path"],
+      "properties": {
+        "source_id": { "type": "string", "pattern": "^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?$" },
+        "path": { "type": "string", "minLength": 1 },
+        "owner": { "type": "string" },
+        "description": { "type": "string" }
+      }
+    },
+    "sample_project": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["name", "neutral_domain", "copy_policy"],
+      "properties": {
+        "name": { "type": "string", "pattern": "^[A-Za-z0-9._-]+$" },
+        "neutral_domain": { "type": "string", "minLength": 1 },
+        "target_stack_policy": { "enum": ["preserve_detected_stack", "explicit_stack", "plan_only"] },
+        "copy_policy": { "enum": ["structure_and_patterns_only", "no_copy_plan_only"] }
+      }
+    },
+    "read_policy": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["allowed_paths", "forbidden_patterns"],
+      "properties": {
+        "allowed_paths": { "type": "array", "items": { "type": "string", "minLength": 1 }, "minItems": 1 },
+        "forbidden_patterns": { "type": "array", "items": { "type": "string", "minLength": 1 }, "minItems": 1 }
+      }
+    },
+    "validation": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "commands": { "type": "array", "items": { "type": "string" } },
+        "allow_command_substitution": { "type": "boolean", "default": false }
+      }
+    },
+    "promotion": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["writeback_policy"],
+      "properties": {
+        "requires_oracle_pass": { "type": "boolean", "default": true },
+        "requires_human_approval": { "type": "boolean", "default": true },
+        "writeback_policy": { "enum": ["proposal_only", "manual_approval_only"] }
+      }
+    }
+  }
+}

package/.pi/factories/project-dna/schemas/ontology.schema.json

@@ -0,0 +1,45 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://zob.local/project-dna/ontology.schema.json",
+  "type": "object",
+  "required": ["schema", "ontology_id", "concepts", "edge_types", "citation_policy", "source_safe", "knowledge_backend_write_enabled", "promotion_policy"],
+  "properties": {
+    "schema": { "const": "zob.project-dna-ontology.v1" },
+    "ontology_id": { "type": "string", "pattern": "^[A-Za-z0-9._-]+$" },
+    "description": { "type": "string" },
+    "source_safe": { "const": true },
+    "raw_bodies_stored": { "const": false },
+    "knowledge_backend_write_enabled": { "const": false },
+    "promotion_policy": { "const": "proposal_only" },
+    "concepts": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "required": ["id", "kind", "aliases", "expected_file_hints", "expected_artifact_roles", "minimum_citation_roles"],
+        "properties": {
+          "id": { "type": "string", "pattern": "^[a-z0-9_.-]+$" },
+          "kind": { "type": "string" },
+          "aliases": { "type": "array", "items": { "type": "string" } },
+          "expected_file_hints": { "type": "array", "items": { "type": "string" } },
+          "expected_artifact_roles": { "type": "array", "items": { "type": "string" } },
+          "minimum_citation_roles": { "type": "array", "items": { "type": "string" } }
+        },
+        "additionalProperties": true
+      }
+    },
+    "edge_types": { "type": "array", "minItems": 1, "items": { "type": "string" } },
+    "citation_policy": {
+      "type": "object",
+      "required": ["citation_required", "prefer_symbol_ranges", "raw_body_storage_allowed"],
+      "properties": {
+        "citation_required": { "const": true },
+        "prefer_symbol_ranges": { "const": true },
+        "broad_citation_max_ratio": { "type": "number", "minimum": 0, "maximum": 1 },
+        "raw_body_storage_allowed": { "const": false }
+      }
+    },
+    "agent_lanes": { "type": "array", "items": { "type": "string" } }
+  },
+  "additionalProperties": true
+}