Files
Kill_LIFE/ai-agentic-embedded-base/specs/contracts/ops_kill_life_erp_registry.json
T
kxkm 1c6c1952e8 fix+feat: restore CI/PIO regressions, 30-entry HF dataset, new tests & hardware
Regressions fixed (aa916de simplification):
- firmware/platformio.ini: restore esp32s3_waveshare (pioarduino platform,
  lib_deps: ArduinoJson/ESP32_Display_Panel/ESP32-audioI2S/IO_Expander,
  BOARD_HAS_PSRAM, I2S pins), restore esp32s3_qemu (extends waveshare +
  QEMU_BUILD), fix default_envs=esp32s3_waveshare, keep build_dir=/tmp/kl_pio_build
- .github/workflows/ci.yml: restore firmware-native (112 Unity tests),
  firmware-build (esp32s3_waveshare artifact), firmware-sim (Wokwi gated),
  hardware-export (KiCad ERC + SVG/PDF/netlist + KiBot + compliance)
- .gitignore: add .kibot-venv/ and .pio-venv/ (prevent committing venvs)

Dataset (HuggingFace clemsail/kill-life-embedded-qa v2):
- generate_hf_dataset.py: rag_query timeout 30s->120s (LLM takes ~45s),
  rag_search timeout 15s->30s; resolves intermittent server-busy failures
- 30 entries (10+10+5+5) -- 100% coverage vs 21/40 previously

Firmware tests (112/112):
- 4 suites: test_basic (39), test_modules (32), test_radio_state (26),
  test_wifi_state (15); test_logic.cpp now a stub (content moved to test_basic)

Hardware:
- esp32_minimal.kicad_pcb, esp32s3_enclosure.FCStd/.step, gen_pcb.py,
  gen_enclosure.py, REGISTRY.md, ERC reports for all design blocks

MCP tools:
- apify_mcp.py: +5 Kill_LIFE tools (fetch_espressif_docs, fetch_kicad_library_info,
  fetch_platformio_registry, ingest_to_rag, get_runtime_info)
- mcp_runtime_status.py: fix classify_overall -- accept_degraded respected for
  failed checks, task annotations, optional_degraded logic cleaned up
- deploy/cad/docker-compose.yml: path mascarade->mascarade-main

Specs & docs:
- docs/plans/TODO_2026-03-26.md, TODO_2026-03-27.md
- ai-agentic-embedded-base/specs: arch, tasks, intake, spec updates
- docs/playbooks/kicad_happy_hw_bom_forge.md

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-26 22:14:33 +01:00

210 lines
6.3 KiB
JSON

{
"contract_version": "ops-kill-life-erp-v1",
"updated_at": "2026-03-22",
"ops_surface": {
"name": "L'electronrare Ops",
"url": "https://www.lelectronrare.fr/ops",
"role": "ERP",
"description": "Business and operational governance layer for priorities, actions, CRM workflow, launch workflow, and operator-level arbitration."
},
"system_of_record": {
"tracking_root": "/Users/electron/Documents/Lelectron_rare/Kill_LIFE",
"mascarade_root": "/Users/electron/Documents/Projets/mascarade"
},
"layers": [
{
"id": "PLM",
"name": "Product Lifecycle Management",
"owner_agent": "PLM-Archivist",
"purpose": "Specifications, plans, contracts, diagrams, design memory"
},
{
"id": "ERP",
"name": "L'electronrare Ops",
"owner_agent": "Ops-Governor",
"purpose": "Resource governance, machine allocation, ownership, secret scopes, priorities"
},
{
"id": "MES",
"name": "Kill_LIFE Cockpit",
"owner_agent": "SyncOps",
"purpose": "Execution, lots, operator lane, daily alignment, handoffs"
},
{
"id": "WMS",
"name": "Artifacts and Operational Memory",
"owner_agent": "Artifact-Curator",
"purpose": "Artifacts, logs, datasets, handoff outputs, retention"
},
{
"id": "DCS",
"name": "Runtime and Mesh Control",
"owner_agent": "Runtime-Guard",
"purpose": "Runtimes, SSH mesh, dispatch P2P, health checks, load balancing"
}
],
"machines": [
{
"label": "tower",
"host": "clems@192.168.0.120",
"canonical_root": "/home/clems/mascarade",
"runtime_roots": ["/home/clems/mascarade", "/home/clems/mascarade-main"],
"role": "primary-heavy",
"criticality": "high",
"owner_agent": "Runtime-Guard",
"priority_order": 1,
"load_policy": "prefer-heavy",
"secret_scope": ["router", "governance"],
"ports": [3100, 8000, 11434]
},
{
"label": "photon",
"host": "root@192.168.0.119",
"canonical_root": "/root/mascarade-main",
"runtime_roots": ["/root/mascarade-main"],
"role": "vm-governance-reserve",
"criticality": "medium",
"owner_agent": "Ops-Governor",
"priority_order": 5,
"load_policy": "avoid-heavy",
"secret_scope": ["router", "governance"],
"ports": [3000, 3100]
},
{
"label": "kxkm",
"host": "kxkm@kxkm-ai",
"canonical_root": "/home/kxkm/mascarade",
"runtime_roots": ["/home/kxkm/mascarade", "/home/kxkm/mascarade-main"],
"role": "interactive-ai",
"criticality": "high",
"owner_agent": "Ops-Governor",
"priority_order": 2,
"load_policy": "secondary-heavy",
"secret_scope": ["router", "governance"],
"ports": [3000, 3100, 8080, 11434]
},
{
"label": "cils",
"host": "cils@100.126.225.111",
"canonical_root": "/Users/cils/mascarade-main",
"runtime_roots": ["/Users/cils/mascarade-main", "/Users/cils/mascarade"],
"role": "non-essential-burst",
"criticality": "medium",
"owner_agent": "Runtime-Guard",
"priority_order": 3,
"load_policy": "burst-only",
"secret_scope": ["router", "governance"],
"ports": [11434]
},
{
"label": "local",
"host": "local",
"canonical_root": "/Users/electron/Documents/Projets/mascarade",
"runtime_roots": ["/Users/electron/Documents/Projets/mascarade"],
"role": "control-and-fallback",
"criticality": "medium",
"owner_agent": "SyncOps",
"priority_order": 4,
"load_policy": "fallback",
"secret_scope": ["router", "governance"],
"ports": []
}
],
"secret_scopes": [
{
"name": "router",
"env_var": "MISTRAL_API_KEY",
"owner_agent": "Ops-Governor",
"consumer_scope": "Mascarade router and Studio integrations",
"storage": [
"/Users/electron/Documents/Projets/mascarade/.env",
"mesh .env via tools/cockpit/mascarade_mesh_env_sync.sh"
]
},
{
"name": "governance",
"env_var": "MISTRAL_GOVERNANCE_API_KEY",
"owner_agent": "KillLife-Bridge",
"consumer_scope": "Kill_LIFE governance scripts and Mistral operator tooling",
"storage": [
"~/.kill-life/mistral.env",
"mesh secret files via tools/cockpit/kill_life_mistral_governance_sync.sh"
]
}
],
"modules": [
{
"path": "docs/",
"layer": "PLM",
"owner_agent": "PLM-Archivist",
"purpose": "Plans, contracts, diagrams, research"
},
{
"path": "specs/",
"layer": "PLM",
"owner_agent": "PLM-Archivist",
"purpose": "Task backlog, contracts, structured specifications"
},
{
"path": "tools/cockpit/full_operator_lane.sh",
"layer": "MES",
"owner_agent": "SyncOps",
"purpose": "Primary operator lane"
},
{
"path": "tools/cockpit/run_alignment_daily.sh",
"layer": "MES",
"owner_agent": "SyncOps",
"purpose": "Daily alignment and reporting"
},
{
"path": "tools/cockpit/lot_chain.sh",
"layer": "MES",
"owner_agent": "SyncOps",
"purpose": "Lot sequencing and resumption"
},
{
"path": "tools/cockpit/machine_registry.sh",
"layer": "ERP",
"owner_agent": "Ops-Governor",
"purpose": "Machine and capacity registry"
},
{
"path": "tools/cockpit/mascarade_mesh_env_sync.sh",
"layer": "ERP",
"owner_agent": "Ops-Governor",
"purpose": "Router secret propagation"
},
{
"path": "tools/cockpit/kill_life_mistral_governance_sync.sh",
"layer": "ERP",
"owner_agent": "KillLife-Bridge",
"purpose": "Governance secret propagation"
},
{
"path": "artifacts/",
"layer": "WMS",
"owner_agent": "Artifact-Curator",
"purpose": "Artifacts, logs, reports, watchboards"
},
{
"path": "tools/cockpit/dataset_audit_tui.sh",
"layer": "WMS",
"owner_agent": "Dataset-Curator",
"purpose": "Dataset audit and preflight"
},
{
"path": "tools/cockpit/mesh_sync_preflight.sh",
"layer": "DCS",
"owner_agent": "Runtime-Guard",
"purpose": "Mesh preflight and dispatch readiness"
},
{
"path": "tools/cockpit/mascarade_runtime_health.sh",
"layer": "DCS",
"owner_agent": "Runtime-Guard",
"purpose": "Mascarade and Ollama runtime health"
}
]
}