docs(P00): research findings — v1.17 telemetry signal inventory + reference architecture + metric scorecard + deck research

---ci--- project: acdl phase: 0 milestone: v1.17 status: research ---/ci---
2026-08-04 19:12:18 +00:00
parent f55579bea8
commit ca7d41c1ad
4 changed files with 535 additions and 16 deletions
@@ -1,23 +1,24 @@
 ---
 project: acdl
-milestone: v1.16
-generated_at: 2026-07-30
+milestone: v1.17
+generated_at: 2026-08-04
 generator: lead-developer
 verification_toolchain:
  typecheck: "terraform validate && python3 -m py_compile core/**/*.py && python3 -m jsonschema schemas/*.schema.json"
-  test: "bash scripts/run_regression.sh   # 22-capability gate (D-091/D-118)"
+  test: "bash scripts/run_regression.sh   # 22-capability gate (D-091/D-118) + CAP-023/024 (v1.17)"
  build: "bash scripts/run_ci.sh           # full local CI reproduction (lint+test+check-only)"
  note: |
-    Nova (formerly ACDL) has no package.json. The execute/verify/ship
-    workflows substitute `terraform validate` + `python -m py_compile` +
-    JSON Schema validation for npm run typecheck, the regression gate
-    (D-091, 22 capabilities) for npm test, and `bash scripts/run_ci.sh`
-    for npm run build. v1.11 testing is pipeline-driven (D-102);
-    v1.16 is NFR-only (no live apply by default; NOVA_LIFECYCLE_MODE=
-    plan). Roster carries forward from v1.11/v1.14/v1.15 unchanged.
-    frontend-engineer stays inactive (no frontend; decks are markdown =
-    lead-developer territory). No custom personas needed (no new
-    domains — onboarding is backend-engineer + data-engineer territory).
+    v1.17 adds a telemetry/observability layer (metrics emitters, SQLite
+    cold store, PowerBI export, Decision Ledger) + a unified narrative
+    deck + a durable NORTH_STAR.md. Three active personas: lead-developer
+    (coordination + deck narrative co-author), backend-engineer (event
+    emitters, outbox_writer extension, Infracost adapter), data-engineer
+    (SQLite store, schemas, PowerBI views, metrics collector). frontend-
+    engineer stays deactivated (no Nova web UI — dashboards are PowerBI,
+    not a Nova-built frontend; decks are markdown = lead-developer
+    territory). No new custom personas needed — the metrics domain maps
+    cleanly to data-engineer (schema/store/export) + backend-engineer
+    (emitters/instrumentation).
 ---

 # ACDL — Persona Roster (project-level, v1.11 RESTART)
@@ -251,3 +252,134 @@ The regression gate (22 capabilities) must stay **22/22 Verified**
 throughout v1.16 — simplification must not regress any capability
 (D-118). P9 (end of Wave 2) and P21 (milestone complete) run the gate;
 P14 (end of Wave 3) is an offline mid-milestone checkpoint.
+
+---
+
+# v1.17 Persona Roster — Strategic Direction, Leadership Metrics & Unified Story
+
+> v1.17 adds a telemetry/observability layer (P1–P3), a metrics catalog
+> + NORTH_STAR integration (P4), a unified narrative deck (P5), a
+> regression capability (P6), and a final review/ship (P7). Three
+> active personas; frontend-engineer stays deactivated (no Nova web UI
+> — dashboards are PowerBI, not a Nova-built frontend).
+
+## Active personas
+
+### lead-developer
+- **Domain:** coordination + deck narrative
+- **Active:** true
+- **Phase-specific:** false
+- **Reason:** Owns CIAgent metadata, the NORTH_STAR.md authoring
+  process (P0), the milestone decomposition, the unified narrative deck
+  co-authoring (P5 — the deck is markdown, which is lead-developer
+  territory per the established convention), and the final review/ship
+  (P7). Arbitrates persona conflicts (e.g., backend vs data on the
+  emitter/store boundary).
+- **Territory:** `.ciagent/NORTH_STAR.md`, `.ciagent/PROJECT.md`,
+  `.ciagent/REQUIREMENTS.md`, `.ciagent/PLAN.md`, `.ciagent/RESEARCH.md`,
+  `.ciagent/ARCHITECTURE.md`, `docs/presentations/nova-no-humans-platform.md`
+  (NEW — unified deck source of truth), `docs/presentations/nova-no-humans-platform-marp.md`,
+  `docs/presentations/nova-no-humans-platform-talking-points.md`,
+  `docs/METRICS.md`, `docs/metrics/*.md` (per-KPI definition docs).
+
+### backend-engineer
+- **Domain:** backend (event emitters + instrumentation)
+- **Active:** true
+- **Phase-specific:** false
+- **Reason:** Owns the event emitters (P1): the CloudEvents envelope,
+  the per-run manifest writer, the `outbox_writer.py` extension to the
+  SQLite Decision Ledger, the Infracost post-processor, the
+  `hitl_gates.py` attestation event emission, the `confidence_signal.py`
+  decision event emission, the `checkov_adapter.py` policy event
+  emission, and the pytest `--junitxml` addopts change. Also owns the
+  `regression_verify.py` CAP-023/024 additions (P6). The emitter work
+  is the bridge between existing Nova components and the new metrics
+  layer — it touches the code paths that already exist.
+- **Territory:** `core/metrics/event_envelope.py` (NEW),
+  `core/metrics/run_manifest.py` (NEW),
+  `core/metrics/infracost_adapter.py` (NEW),
+  `core/metrics/decision_ledger.py` (NEW — extends outbox_writer),
+  `core/outbox_writer.py` (extend to SQLite),
+  `core/hitl_gates.py` (emit attestation.recorded),
+  `core/confidence_signal.py` (emit ai.decision.made),
+  `adapters/terraform/policy/checkov_adapter.py` (emit policy.evaluated),
+  `scripts/run_platform.sh` (invoke manifest writer + Infracost),
+  `core/regression_verify.py` (CAP-023/024),
+  `pyproject.toml` (addopts --junitxml),
+  `tests/test_metrics_emitters.py` (NEW),
+  `tests/test_decision_ledger.py` (NEW).
+
+### data-engineer
+- **Domain:** data (schema, SQLite store, PowerBI export)
+- **Active:** true
+- **Phase-specific:** false
+- **Reason:** Reactivated with a new territory for v1.17: the metrics
+  collector (P2) and the PowerBI export (P3). Owns the schema design
+  (metrics_*.schema.json), the SQLite cold store (nova_metrics.db), the
+  fact/dimension table design, the 8 deferred placeholder views, and
+  the CSV/JSON export. The data-engineer's schema-first constraint
+  applies: all event types and fact/dim tables have JSON Schema
+  definitions before any code is written. The collector reads files +
+  events → SQLite; the export reads SQLite → CSV/JSON. This is the
+  heaviest data-territory work since v1.11's terraform modules.
+- **Territory:** `core/metrics/collector.py` (NEW),
+  `core/metrics/powerbi_export.py` (NEW),
+  `schemas/metrics_*.schema.json` (NEW — event + fact/dim schemas),
+  `metrics/nova_metrics.db` (NEW — SQLite cold store),
+  `metrics/powerbi/` (NEW — CSV/JSON export dir),
+  `docs/METRICS_VIEWS.md` (NEW — schema doc for PowerBI views),
+  `tests/test_metrics_collector.py` (NEW),
+  `tests/test_powerbi_export.py` (NEW).
+
+## Deactivated personas
+
+### frontend-engineer
+- **Domain:** frontend
+- **Active:** false
+- **Phase-specific:** false
+- **Reason:** v1.17 has no Nova web UI. The leadership dashboards are
+  PowerBI (an external tool that ingests CSV/JSON files), not a
+  Nova-built frontend. The decks are markdown (lead-developer
+  territory). frontend-engineer stays deactivated, consistent with
+  v1.11–v1.16. Reactivates if a future milestone builds a Nova web UI.
+
+### lambda-engineer, platform-engineer, security-engineer
+- **Active:** false (carried forward from v1.11)
+- **Reason:** v1.17 does not touch the Lambda (beyond emitting events
+  from the existing hitl_gates/attestation_matrix), does not do IR-
+  shaped module authoring, and does not touch security adapters beyond
+  emitting policy.evaluated events. The existing components are
+  instrumented, not rewritten.
+
+## v1.17 phase assignment
+
+| Phase | Primary persona | Supporting | Territory |
+|-------|----------------|------------|-----------|
+| P0 pre-execution | lead-developer | — | `.ciagent/NORTH_STAR.md`, `PROJECT.md`, `REQUIREMENTS.md`, `RESEARCH.md`, `ARCHITECTURE.md`, `PERSONAS.md`, `PLAN.md` |
+| P1 event-emitters | backend-engineer | data-engineer (schemas) | `core/metrics/event_envelope.py`, `run_manifest.py`, `decision_ledger.py`, `infracost_adapter.py`, `outbox_writer.py`, `hitl_gates.py`, `confidence_signal.py`, `checkov_adapter.py`, `run_platform.sh`, `pyproject.toml` |
+| P2 metrics-collector | data-engineer | backend-engineer (event formats) | `core/metrics/collector.py`, `schemas/metrics_*.schema.json`, `metrics/nova_metrics.db` |
+| P3 powerbi-export | data-engineer | — | `core/metrics/powerbi_export.py`, `metrics/powerbi/`, `docs/METRICS_VIEWS.md` |
+| P4 metrics-catalog + north-star-integration | lead-developer | data-engineer (metric definitions) | `docs/METRICS.md`, `docs/metrics/*.md`, `PROJECT.md`, `ARCHITECTURE.md`, `config.json` |
+| P5 deck-rebuild | lead-developer | — | `docs/presentations/nova-no-humans-platform*.md`, retire old decks |
+| P6 regression-capability | backend-engineer | data-engineer (CAP-023 schema) | `core/regression_verify.py` (CAP-023, CAP-024) |
+| P7 final-review-ship | lead-developer | all active (review) | `.ciagent/**`, review + audit + ship |
+
+## v1.17 domain priority
+
+`backend → data → lead` (the emitter work in P1 is the foundation;
+data-engineer's collector + export in P2–P3 depends on P1's event
+formats; lead-developer's catalog + deck in P4–P5 depends on the
+metrics being grounded).
+
+## v1.17 verification toolchain
+
+```
+typecheck: terraform validate && python3 -m py_compile core/**/*.py adapters/**/*.py
+test:      bash scripts/run_regression.sh   # 22-capability gate + CAP-023/024 (v1.17)
+build:     bash scripts/run_ci.sh           # full local CI reproduction
+```
+
+The regression gate (22 capabilities + CAP-023 metrics collector +
+CAP-024 deck structure) must pass at P6 and P7. CAP-009 (offline pytest
+suite) must remain Verified after the `--junitxml` addopts change
+(assumption A5).