project_boundaries.json

{
  "version": 1,
  "canonical_destinations": {
    "work_state": "doc/templates/TODO.md",
    "phase_intent": "plan.md",
    "peer_dialogue": "teams/*.md",
    "machine_policy_data": "beside_consumer",
    "runtime_evidence": ["teams/runtime/output/", "tools/HME/runtime/"],
    "objective_invariants": "tools/HME/scripts/verify_coherence/",
    "product_behavior": "src/"
  },
  "path_classes": {
    "hot": ["tools/HME/proxy/", "tools/HME/event_kernel/"],
    "cold": ["teams/rounds/", "tools/HME/scripts/verify_coherence/", "log/todo/", "doc/"],
    "state": ["tools/HME/runtime/", "teams/runtime/", "tmp/"],
    "policy": ["config/", "tools/HME/*.json", ".env"]
  },
  "subsystems": {
    "product_src": {
      "path_class": "hot",
      "owns": ["product behavior", "application runtime logic"],
      "does_not_own": ["HME hook policy", "mesh orchestration", "coherence verification"],
      "entrypoints": ["src"],
      "canonical_outputs": []
    },
    "proxy": {
      "path_class": "hot",
      "owns": ["request/response adaptation", "routing", "context pressure", "stream rewriting"],
      "does_not_own": ["project strategy", "TODO state", "mesh debate orchestration", "HCI suite execution"],
      "entrypoints": ["tools/HME/proxy"],
      "canonical_outputs": ["tools/HME/runtime/"]
    },
    "event_kernel_hooks": {
      "path_class": "hot",
      "owns": ["host hook entry", "event dispatch", "host protocol normalization"],
      "does_not_own": ["product behavior", "deep review rounds", "phase planning"],
      "entrypoints": ["tools/HME/event_kernel"],
      "canonical_outputs": ["log/hme-hook-exec.jsonl", "tools/HME/runtime/"]
    },
    "mesh_teams": {
      "path_class": "cold",
      "owns": ["peer consultation", "review rounds", "dialogue channels"],
      "does_not_own": ["hot-path routing", "hook schema", "product implementation"],
      "entrypoints": ["teams", "teams/rounds"],
      "canonical_outputs": ["teams/runtime/output/", "teams/*.md"]
    },
    "hci_verifiers": {
      "path_class": "cold",
      "owns": ["objective coherence checks", "regression prevention"],
      "does_not_own": ["business logic", "runtime routing decisions", "user intent"],
      "entrypoints": ["tools/HME/scripts/verify_coherence"],
      "canonical_outputs": ["tools/HME/runtime/metrics/"]
    },
    "todo_plan_ledgers": {
      "path_class": "cold",
      "owns": ["approved work tracking", "phase intent", "todo archival"],
      "does_not_own": ["runtime evidence", "peer channel dialogue", "machine policy"],
      "entrypoints": ["doc/templates/TODO.md", "plan.md", "log/todo"],
      "canonical_outputs": ["log/todo/"]
    },
    "runtime_state_logs": {
      "path_class": "state",
      "owns": ["ephemeral runtime state", "diagnostic evidence", "append-only logs"],
      "does_not_own": ["canonical phase intent", "approved work state", "source policy"],
      "entrypoints": ["tools/HME/runtime", "teams/runtime", "log", "tmp"],
      "canonical_outputs": ["tools/HME/runtime/", "teams/runtime/output/", "log/", "tmp/"]
    },
    "docs_templates": {
      "path_class": "cold",
      "owns": ["minimal human-facing templates", "operator reference"],
      "does_not_own": ["machine policy", "runtime facts", "implementation state"],
      "entrypoints": ["doc"],
      "canonical_outputs": ["doc/"]
    },
    "config_policy": {
      "path_class": "policy",
      "owns": ["human-tuned machine policy", "environment defaults", "model registry"],
      "does_not_own": ["runtime measurements", "dialogue", "test results"],
      "entrypoints": ["config", ".env", "tools/HME/project_boundaries.json"],
      "canonical_outputs": ["config/", ".env", "tools/HME/*.json"]
    }
  },
  "hot_path_forbidden_import_prefixes": [
    "teams/rounds/",
    "tools/HME/scripts/verify_coherence/"
  ],
  "hot_path_forbidden_markers": [
    "verify-coherence.py",
    "HME_ROUND_PROGRESS_FILE"
  ],
  "hot_path_allowed_files": [
    "tools/HME/proxy/hme_proxy_context_budget.js",
    "tools/HME/proxy/hme_proxy_context_budget.js"
  ]
}