{
  "canon_meta": {
    "canon_id": "devon-project-scope",
    "version": "1.0.0",
    "status": "ACTIVE",
    "owner": "YEFF",
    "system_name": "Devon",
    "canonical_order_mode": "DEPLOYMENT_ORDER_ONLY",
    "last_updated_utc": "2026-03-22T00:00:00Z"
  },
  "project_scope": {
    "mission": "Devon is a first-party cognitive development control plane designed to architect, validate, generate, canonize, execute, benchmark, observe and promote software changes across first-party infrastructure using sandbox-first execution and evidence-based status.\n",
    "primary_goal": "Build a deployment-first canonical system where every module, technology, server, sandbox, memory partition and validation step is governed by observable evidence and strict PASS/FAIL/MISSING rules.\n",
    "operating_principles": [
      "deployment_order_first",
      "evidence_before_decision",
      "sandbox_before_production",
      "first_party_infrastructure_only",
      "no_status_without_observable_evidence",
      "contracts_before_installation",
      "policy_before_execution",
      "benchmark_before_promotion",
      "rollback_readiness_mandatory"
    ]
  },
  "scope": {
    "in_scope": [
      "canonical panel architecture",
      "deployment-order governance",
      "module contracts",
      "technology pipelines",
      "memory routing and partition governance",
      "multi-server orchestration under YEFF control",
      "sandbox mirroring per project",
      "policy and audit",
      "benchmark and promotion gates",
      "operator panel"
    ],
    "out_of_scope": [
      "third-party unmanaged infrastructure",
      "direct production-first development",
      "status inference without evidence",
      "ad-hoc deployment outside canonical order"
    ]
  },
  "deployment_order_official": {
    "stages": [
      {
        "stage_id": 0,
        "name": "host_readiness",
        "description": "Host baseline, filesystem, user context, python/git/docker readiness, directory canon."
      },
      {
        "stage_id": 1,
        "name": "canon_control_plane",
        "description": "Canon files, scope, deployment order, contracts, registries, pipelines."
      },
      {
        "stage_id": 2,
        "name": "server_registry",
        "description": "Register first-party nodes, roles, access policies, capabilities and allowed projects."
      },
      {
        "stage_id": 3,
        "name": "foundation_infrastructure",
        "description": "Base OS/runtime services, containers, networking, proxy, secrets, persistent volumes."
      },
      {
        "stage_id": 4,
        "name": "storage_state",
        "description": "Structured state, cache, vector state, artifact storage."
      },
      {
        "stage_id": 5,
        "name": "memory_control_plane",
        "description": "Memory router, partition registry, namespace rules, retention and audit."
      },
      {
        "stage_id": 6,
        "name": "core_runtime",
        "description": "API runtime, environment loading, router registry, health endpoints."
      },
      {
        "stage_id": 7,
        "name": "observability_audit_base",
        "description": "Logs, metrics, traces, evidence collection and audit events."
      },
      {
        "stage_id": "08",
        "name": "remote_access_orchestration",
        "description": "Remote runners, SSH policies, execution permissions, node health."
      },
      {
        "stage_id": "09",
        "name": "sandbox_orchestration",
        "description": "Project sandbox creation, mirroring, sanitization, paridade and rollback readiness."
      },
      {
        "stage_id": 10,
        "name": "cognition_base",
        "description": "Embeddings, retrieval, reasoning support, attention/goals, multimodal adapters."
      },
      {
        "stage_id": 11,
        "name": "engineering_modules",
        "description": "Architect, Planner, Generator, Canonizer, Validator/CI, Executor, Artifact Canon Layer, Skill Registry."
      },
      {
        "stage_id": 12,
        "name": "governance_policy",
        "description": "Policy rules, safety, scope enforcement, self-monitoring."
      },
      {
        "stage_id": 13,
        "name": "benchmark_learning",
        "description": "Benchmark runner, RL engine, learning loop, promotion gates."
      },
      {
        "stage_id": 14,
        "name": "operator_panel",
        "description": "UI, evidence drawers, dependency graph, validation timeline, contract explorer."
      },
      {
        "stage_id": 15,
        "name": "promotion_rollback",
        "description": "Production promotion, rollback validation, final audit."
      }
    ]
  },
  "canonical_files_index": [
    {
      "file": "00_project_scope_canonical.yaml",
      "purpose": "master summary and governance root"
    },
    {
      "file": "01_deployment_order_canonical.yaml",
      "purpose": "official install/configuration sequence"
    },
    {
      "file": "02_panel_canonical_tree.yaml",
      "purpose": "panel cards, sections and navigation tree"
    },
    {
      "file": "03_card_contract_minimums.yaml",
      "purpose": "mandatory contract schema for every card/module"
    },
    {
      "file": "04_memory_canonical_architecture.yaml",
      "purpose": "memory control plane, routing and partition model"
    },
    {
      "file": "05_server_registry_canonical.yaml",
      "purpose": "first-party multi-server model and node contracts"
    },
    {
      "file": "06_sandbox_environment_canonical.yaml",
      "purpose": "sandbox mirroring model and promotion path"
    },
    {
      "file": "07_subcategory_pipelines.yaml",
      "purpose": "deployment pipelines per category/subcategory"
    }
  ],
  "infrastructure_model": {
    "topology": "control_plane_plus_first_party_nodes",
    "control_plane_host": "devon_server",
    "node_policy": "first_party_only",
    "allowed_node_roles": [
      "control-plane",
      "sandbox-host",
      "production-host",
      "shared-services",
      "benchmark-runner",
      "storage-node"
    ],
    "future_hypotheses": [
      "dedicated_sandbox_host",
      "dedicated_benchmark_host",
      "dedicated_storage_host"
    ]
  },
  "memory_policy_summary": {
    "model": "dynamic_partitioned_memory",
    "fixed_partition_count": false,
    "fixed_partition_classes": true,
    "required_partition_classes": [
      "global",
      "project",
      "run",
      "event",
      "artifact",
      "benchmark",
      "policy"
    ],
    "routing_mandatory_keys": [
      "project_id",
      "workspace_id",
      "run_id",
      "event_id",
      "artifact_id",
      "correlation_id"
    ]
  },
  "sandbox_policy_summary": {
    "mode": "sandbox_first",
    "production_direct_changes_allowed": false,
    "required_capabilities": [
      "create_sandbox",
      "mirror_project_environment",
      "sanitize_sensitive_data",
      "validate_parity",
      "run_validation_suite",
      "promote_with_rollback"
    ]
  },
  "status_rules_global": {
    "PASS": "observable evidence exists and functional validation passes",
    "FAIL": "observable evidence exists and validation fails",
    "MISSING": "observable evidence does not exist"
  },
  "next_canonical_step": {
    "required_after_bootstrap": [
      "review_and_freeze_contracts",
      "expand_technology_mappings",
      "create_canonical_matrix_v1",
      "implement_panel_reader"
    ]
  }
}