95 Commits

Author SHA1 Message Date
Jon Chery f28aed2f55 docs(ship): P2 complete → v1.26.2 (v1.27 fix-stale-wire)
Nova Slides Render / render (push) Failing after 24s
---ci---
project: acdl
phase: 2
milestone: v1.27
status: complete
---ci---
2026-08-19 19:17:07 +00:00
Jon Chery 2b2423532b docs(ship): P1 complete → v1.26.1 (v1.27 author-archive)
Nova Slides Render / render (push) Failing after 26s
---ci---
project: acdl
phase: 1
milestone: v1.27
status: complete
---ci---
2026-08-19 19:14:12 +00:00
Jon Chery ecc9730f24 docs(ship): P0 complete → v1.26.0 (v1.27 pre-execution)
---ci---
project: acdl
phase: 0
milestone: v1.27
status: complete
---ci---
2026-08-19 19:12:51 +00:00
Jon Chery a6b908c035 docs(P00): personas + plan — v1.27 (lead-developer only, 3 phases)
PERSONAS: lead-developer active (docs/chore milestone); 5 others
inactive. Territory: .ciagent/, docs/.

PLAN: 3 phases (P1 author-archive, P2 fix-stale-wire, P3 final-review-ship).
Tags on v1.26.x; v1.26.3 = milestone release.

Archive-list correction (D-219 refinement): the 4 pre-execution files
(CLARIFY/GRILL/IDEATE/RESEARCH) were rewritten in P0 with v1.27
content — the v1.26-era content lives in git history. The v1.27 P0
versions stay active through v1.27 (current pre-execution record);
they archive at v1.28 P1 if v1.28 happens. Final archive list: 7
platform files (CAPABILITY_INVENTORY, REVIEW-AUDIT-P05, VERIFY-P03,
VERIFY-P04, P4-PILOT-RUN-EVIDENCE, AUTONOMY_THESIS, COST) + 1
consumer file (nova-blockchain-exchange/ROADMAP) = 8 files.

---ci---
project: acdl
phase: 0
milestone: v1.27
status: plan
---ci---
2026-08-19 19:12:01 +00:00
Jon Chery e9fbb44ad1 docs(P00): research findings — v1.27 staleness inventory + backfill sources
NFR milestone, no new domain. Research is a codebase-grounded inventory:
- 11 files to archive (4 pre-execution v1.26 artifacts + 3 phase
  verifications/review + 1 evidence snapshot + 3 durable refs superseded
  by STATE.md/NORTH_STAR/archive + 1 consumer ROADMAP).
- 12 files kept active (no-edit: live code paths, durable refs).
- 3 files kept active (fix-only: PROJECT.md, ROADMAP.md, archive/README.md).
- STATE.md backfill sources: regression_verify.py, registry.json,
  REQUIREMENTS traceability, CHECKPOINT, git log, PROJECT decisions.
- Persona roster: lead-developer only (docs/chore milestone).
- 4 risks, all Low-Medium with documented mitigations.

---ci---
project: acdl
phase: 0
milestone: v1.27
status: research
---ci---
2026-08-19 19:09:32 +00:00
Jon Chery 155963d40d docs(P00): clarify — v1.27 ambiguities resolved (6 Qs, D-220..D-225)
6 prior-conversation resolutions (D-214..D-219, user-confirmed) +
6 new ambiguities auto-resolved at full autonomy (D-220..D-225):
- D-220: NFR milestone (tags on v1.26.x)
- D-221: consumer archives in .ciagent/nova-blockchain-exchange/archive/
- D-222: archiving preserves traceability (archive + PROJECT + git)
- D-223: IAM_POLICY.md stays active (live baseline, D-207 pending)
- D-224: REGRESSION_REPORT regenerates on next run_regression.sh
- D-225: PROJECT.md phase-status fix is P2 (correction phase)

0 escalations. Confidence ≥ 0.85 on all new decisions.

---ci---
project: acdl
phase: 0
milestone: v1.27
status: clarify
---ci---
2026-08-19 19:09:05 +00:00
Jon Chery c0453817ad docs(milestone): complete v1.26 Live Pilot Estate Activation (release v1.25.5)
acdl-ci / Lint (push) Successful in 8s
acdl-ci / Test (push) Failing after 17s
acdl-ci / Platform check-only (offline) (push) Successful in 18s
All 13 requirements (REQ-310..322) complete. Live pilot estate activated against AWS
581513795199. Milestone merged to main. Tags v1.25.0..v1.25.5. Checkpoint cleared.

---ci---
project: acdl
phase: 5
milestone: v1.26
status: complete
requirements:
  covered: [REQ-310, REQ-311, REQ-312, REQ-313, REQ-314, REQ-315, REQ-316, REQ-317, REQ-318, REQ-319, REQ-320, REQ-321, REQ-322]
  partial: []
---
2026-08-19 03:54:29 +00:00
Jon Chery f266dcf0fc docs(ship): P4 complete → v1.25.4 (v1.26 pilot-run-and-docs)
---ci---
project: acdl
phase: 4
milestone: v1.26
status: complete
---
2026-08-19 03:28:20 +00:00
Jon Chery 6b60c0cbe3 docs(ship): P3 complete → v1.25.3 (v1.26 pilot-metrics-and-policies)
---ci---
project: acdl
phase: 3
milestone: v1.26
status: complete
---
2026-08-19 01:04:36 +00:00
Jon Chery 732998b01f docs(P03): mark REQ-315..320 complete + update checkpoint (v1.25.3 ready to ship)
Nova Slides Render / render (push) Failing after 17s
---ci---
project: acdl
phase: 3
milestone: v1.26
status: verify
---
2026-08-19 00:44:15 +00:00
Jon Chery 6a3d47e482 docs(P02): mark REQ-313/314/322 complete — update checkpoint + roadmap
P2 (consumer-contract-and-deploy) complete. REQ-313 (contract.yaml +
3 env variants), REQ-314 (deploy.yml .github+.gitea mirror), REQ-322
(DynamoDB L1 primitive) all delivered. Checkpoint advanced to
stage: complete. Consumer ROADMAP.md P2 marked complete (tag v1.25.2).

---ci---
project: nova-blockchain-exchange
phase: 2
milestone: v1.26
status: complete
phase_role: execution
tag: v1.25.2
requirements: [REQ-322, REQ-313, REQ-314]
---/ci---
2026-08-18 00:24:51 +00:00
Jon Chery d022ddcea6 docs(P02): reconcile checkpoint — P1 complete (v1.25.1), advance to P2 execute
---ci---
project: nova-blockchain-exchange
phase: 2
milestone: v1.26
status: execute
phase_role: execution
checkpoint: reconciled
---/ci---
2026-08-18 00:21:10 +00:00
Jon Chery ddf88202fc docs(P01): execute — v1.26 blockchain-core (REQ-310,311,312)
---ci---
project: nova-blockchain-exchange
phase: 1
milestone: v1.26
status: execute
phase_role: execution
requirements: [REQ-310, REQ-311, REQ-312]
---/ci---
2026-08-13 18:34:22 +00:00
Jon Chery 2ee541f40e docs(ship): P0 complete — v1.25.0 released (id 690)
---ci---
project: acdl
phase: 0
milestone: v1.26
status: complete
phase_role: pre_execution
tag: v1.25.0
release_id: 690
---/ci---
2026-08-12 21:21:23 +00:00
Jon Chery cf8aa53c8d docs(P00): grill — v1.26 adversarial review (9 challenges, PROCEED 0.84, 2 revisions)
---ci---
project: acdl
phase: 0
milestone: v1.26
status: grill
verdict: PROCEED
confidence: 0.84
revisions: [G-Q4 REQ-322 to P2 W0, G-Q6 enforcement-deferred note, G-Q9 key-split future item]
---/ci---
2026-08-12 21:20:11 +00:00
Jon Chery 270b1f11a3 docs(P00): create phase plans — v1.26 (5 phases, 13 reqs, wave-ordered, persona-assigned)
---ci---
project: acdl
phase: 0
milestone: v1.26
status: plan
phases: 5
requirements: [REQ-310..REQ-322]
revision: REQ-322 moved to P2 W0 (before contract, for registry resolution)
---/ci---
2026-08-12 21:19:06 +00:00
Jon Chery 2a4d7b7625 docs(P00): ideate — v1.26 (7 ideas accepted, 3 deferred, 0 rejected)
---ci---
project: acdl
phase: 0
milestone: v1.26
status: ideate
ideas_accepted: [I1..I7]
ideas_deferred: [I8, I9, I10]
---/ci---
2026-08-12 21:17:39 +00:00
Jon Chery 707d8a1e39 docs(P00): research findings — v1.26 (PoA blockchain, deploy model, DynamoDB gap, personas)
---ci---
project: acdl
phase: 0
milestone: v1.26
status: research
requirements: [REQ-310..REQ-322]
personas: [lead-developer, backend-engineer, data-engineer, policy-engineer, blockchain-engineer]
---/ci---
2026-08-12 21:16:42 +00:00
Jon Chery 50e77e6314 docs(P00): clarify — v1.26 ambiguities resolved (10 Qs, 8 new decisions)
---ci---
project: acdl
phase: 0
milestone: v1.26
status: clarify
decisions: [D-206..D-213]
---/ci---
2026-08-12 21:12:43 +00:00
Jon Chery a0a658bc9a docs(init): validate specification — v1.26 Live Pilot Estate Activation
---ci---
project: acdl
phase: 0
milestone: v1.26
status: specify
projects: [acdl, nova-blockchain-exchange]
requirements: [REQ-310..REQ-321]
---/ci---
2026-08-12 21:11:51 +00:00
Jon Chery be967783b4 docs(milestone): complete v1.25 — kyverno-json Unified Policy Engine
acdl-ci / Lint (push) Successful in 11s
acdl-ci / Platform check-only (offline) (push) Successful in 26s
acdl-ci / Test (push) Failing after 43s
19 requirements (REQ-291..309) complete. 6 phases (P0 + P1..P4 + P5).
Tag v1.24.5 (gitea release id 645, the v1.25 milestone release).
Merged milestone/v1.25-kyverno-json to main. All milestone branches deleted.
NORTH_STAR.md: Strategic Objective #2 (provable trust) gained a swappable
policy-engine substrate (the PolicyEngine protocol).

---ci---
project: acdl
milestone: v1.25
status: complete
requirements:
  covered: [REQ-291, REQ-292, REQ-293, REQ-294, REQ-295, REQ-296, REQ-297, REQ-298, REQ-299, REQ-300, REQ-301, REQ-302, REQ-303, REQ-304, REQ-305, REQ-306, REQ-307, REQ-308, REQ-309]
  partial: []
---/ci---
2026-08-12 18:50:45 +00:00
Jon Chery 9acf23926d docs(ship): P4 complete — v1.24.4 released (id 644)
---ci---
project: acdl
phase: 4
milestone: v1.25
status: complete
ship: v1.24.4 (gitea release id 644)
---/ci---
2026-08-12 18:43:39 +00:00
Jon Chery 89f62c85ab docs(ship): P3 complete — v1.24.3 released (id 643)
---ci---
project: acdl
phase: 3
milestone: v1.25
status: complete
ship: v1.24.3 (gitea release id 643)
---/ci---
2026-08-12 18:31:02 +00:00
Jon Chery 35e3de401e docs(ship): P2 complete — v1.24.2 released (id 642)
---ci---
project: acdl
phase: 2
milestone: v1.25
status: complete
ship: v1.24.2 (gitea release id 642)
---/ci---
2026-08-12 18:27:17 +00:00
Jon Chery 4b6c3a12d8 docs(ship): P1 complete — v1.24.1 released (id 641)
---ci---
project: acdl
phase: 1
milestone: v1.25
status: complete
ship: v1.24.1 (gitea release id 641)
---/ci---
2026-08-12 18:22:04 +00:00
Jon Chery ba816f69ae docs(ship): P0 complete — v1.25 pre-execution (specify, clarify, research, ideate, plan, grill)
Tag v1.24.0 (gitea release id 640). Phase 00 branch deleted.
Next: P1 engine-core → v1.24.1.

---ci---
project: acdl
phase: 0
milestone: v1.25
status: complete
ship: v1.24.0 (gitea release id 640)
---/ci---
2026-08-12 18:14:11 +00:00
Jon Chery ec53302014 docs(P00): create phase plans — v1.25 (4 phases, 4 waves)
PLAN.md: 4 execution phases (P1 engine-core, P2 contract+stack-IR policies,
P3 plan-JSON+meta+pipeline wiring, P4 regression-gate+docs) + P5 final
review/ship. Wave ordering with parallelization (3-2-2-3 concurrent personas).
Each phase is a vertical slice (end-to-end: policies + Python wiring + tests +
docs). Tags v1.24.0..v1.24.5. 19 requirements (REQ-291..309) mapped to phases
and personas.

---ci---
project: acdl
phase: 0
milestone: v1.25
status: plan
---/ci---
2026-08-12 18:11:00 +00:00
Jon Chery 7e6ed25ea9 docs(P00): ideate — 5 accepted (into REQ-295..305), 3 deferred, 0 rejected
Tier 1 mechanical: I1 regression-gate-as-policy (REQ-304/305), I2 contract-shape
(REQ-295), I3 stack-IR rules (REQ-297).
Tier 2 backend-enriched: I4 plan-JSON RULE_MAP mirrors (REQ-300), I5 meta-policies
(REQ-303). Deferred: I6 env-transition (stateful, not policy-shaped), I7 drift
(D-096 blocker), I8 cross-project (single-project).
Quality improvement headline: I1 — capability regression becomes a declarative
policy artifact, not imperative Python.

---ci---
project: acdl
phase: 0
milestone: v1.25
status: ideate
---/ci---
2026-08-12 18:10:02 +00:00
Jon Chery f753353ad4 docs(P00): research findings — v1.25 kyverno-json engine surface, 4 policy targets, PolicyEngine swap boundary
RESEARCH.md: kyverno-json CLI (kj scan), ValidatingPolicy structure,
assertion trees + ~ modifier + JMESPath, output shape, severity-via-
annotation convention, 4 policy targets (contract/stack-IR/plan-JSON/
meta), PolicyEngine protocol + OPA-equivalent swap surface, latency
<1s (parallel with checkov), deterministic-not-AI tenet, ECS catalog
prior art, 5 logged assumptions (A1..A5).

PERSONAS.md: 4 active personas (lead-developer, backend-engineer,
new policy-engineer, data-engineer); frontend-engineer deactivated.
policy-engineer owns kyverno-json policies + engine translation +
STANDARDS.md policy-authoring section.

ARCHITECTURE.md §12.7: Policy Engine Registry — protocol, registry,
NullEngine fallback, engine enum reuse (D-116), defense-in-depth
critical-override (D-119), graceful degradation (D-120).

---ci---
project: acdl
phase: 0
milestone: v1.25
status: research
---/ci---
2026-08-12 18:09:12 +00:00
Jon Chery f020178c15 docs(P00): clarify — 6 ambiguities auto-resolved (full autonomy, D-115..D-120)
A1 install path → go install (D-115)
A2 engine enum → reuse kyverno, distinguish by ruleId KJ_ prefix (D-116)
A3 checkov/wiz signatures unchanged; meta-policies consume merged PCR list (D-117)
A4 NOVA_TAG_NAMING kept + kyverno-json mirror + tagging-rules-agree meta-policy (D-118)
A5 critical-override kept as defense-in-depth behind declarative meta-policy (D-119)
A6 kyverno-json is deterministic not AI; is_configured guard ensures platform functions without it (D-120)

---ci---
project: acdl
phase: 0
milestone: v1.25
status: clarify
---/ci---
2026-08-12 18:06:05 +00:00
Jon Chery 5a75075616 docs(init): validate specification — v1.25 kyverno-json unified policy engine
Establishes the v1.25 milestone: kyverno-json becomes Nova's primary
compliance/policy tool, implemented behind a swappable PolicyEngine
adapter (so OPA can replace it one day). Unified-orchestrator model —
checkov/wiz remain as raw-finding adapters feeding into kyverno-json
meta-policies. Policies cover all 4 Nova artifacts: contract JSON,
resolved Stack IR, terraform plan JSON, and the merged PCR list itself.
Quality improvement from IDEATE: capability regression checks become
declarative kyverno-json policies. New policy-engineer persona.

19 requirements (REQ-291..309), 6 phases (P0 + P1..P4 + P5 final).
Tags on v1.24.x line: v1.24.0 (P0) → v1.24.5 (P5 = milestone release).

---ci---
project: acdl
phase: 0
milestone: v1.25
status: specify
---/ci---
2026-08-12 18:05:04 +00:00
Jon Chery 42c579f7b8 docs(ship): v1.24 milestone checkpoint complete — v1.23.4 released (id 639)
acdl-ci / Lint (push) Successful in 10s
acdl-ci / Test (push) Failing after 22s
acdl-ci / Platform check-only (offline) (push) Successful in 22s
---ci---
project: acdl
phase: 4
milestone: v1.24
status: complete
ship: v1.23.4 (gitea release id 639)
---/ci---
2026-08-12 14:36:38 +00:00
Jon Chery ab7171236a docs(milestone): complete v1.24 — Consumer Guide Accuracy & Env-Promotion Lifecycle Enforcement
acdl-ci / Lint (push) Successful in 10s
acdl-ci / Test (push) Failing after 24s
acdl-ci / Platform check-only (offline) (push) Successful in 23s
Nova Slides Render / render (push) Failing after 23s
---ci---
project: acdl
phase: 4
milestone: v1.24
status: complete
requirements:
  covered: [REQ-276,REQ-277,REQ-278,REQ-279,REQ-280,REQ-281,REQ-282,REQ-283,REQ-284,REQ-285,REQ-286,REQ-287,REQ-288,REQ-289,REQ-290]
  partial: []
---/ci---
2026-08-12 14:36:15 +00:00
Jon Chery eca1181716 docs(ship): P0 complete — v1.24 pre-execution (specify, clarify, research, plan, grill)
acdl-ci / Lint (push) Successful in 9s
acdl-ci / Test (push) Failing after 24s
acdl-ci / Platform check-only (offline) (push) Successful in 27s
---ci---
project: acdl
phase: 0
milestone: v1.24
status: complete
ship: v1.23.0 (gitea release id 635)
---/ci---
2026-08-12 14:24:19 +00:00
Jon Chery d8240588c9 docs(P00): create phase plans — v1.24 (4 phases, 4 waves)
---ci---
project: acdl
phase: 0
milestone: v1.24
status: plan
---/ci---
2026-08-12 14:23:24 +00:00
Jon Chery 5dc97673e5 docs(P00): research findings — v1.24 env-transition detect-and-destroy
---ci---
project: acdl
phase: 0
milestone: v1.24
status: research
---/ci---
2026-08-12 14:22:37 +00:00
Jon Chery 956cf91ce0 docs(P00): clarify — 6 ambiguities auto-resolved (full autonomy)
---ci---
project: acdl
phase: 0
milestone: v1.24
status: clarify
---/ci---
2026-08-12 14:21:32 +00:00
Jon Chery a7a93d95d1 docs(init): validate specification — v1.24 consumer guide accuracy + env-promotion lifecycle
---ci---
project: acdl
phase: 0
milestone: v1.24
status: specify
---/ci---
2026-08-12 14:20:34 +00:00
Jon Chery afca994511 docs(ship): v1.23 milestone checkpoint complete — v1.22.6 released (id 634)
acdl-ci / Lint (push) Successful in 8s
acdl-ci / Platform check-only (offline) (push) Successful in 24s
acdl-ci / Test (push) Failing after 24s
2026-08-12 00:37:59 +00:00
Jon Chery e63c0cb36e docs(milestone): complete v1.23 — Nova Deck Cleanup & Python PPTX
acdl-ci / Lint (push) Successful in 10s
acdl-ci / Test (push) Failing after 23s
acdl-ci / Platform check-only (offline) (push) Successful in 25s
Nova Slides Render / render (push) Failing after 34s
13 requirements complete (REQ-263..275):
- P1: consolidate-docs — single -marp.md source of truth, speaker notes
  + talking points as HTML comments, delete plain .md (REQ-263,264)
- P2: restore-clean-style — theme:default + inline S&P style, retire
  nova-sp-theme.css from render (keep as reference), benefit .benefit
  class (REQ-265,266,267)
- P3a: inline-images — scripts/inline_images.py, self-contained HTML
  (REQ-268)
- P3b: python-pptx-generator — scripts/render_pptx.py structured
  editable S&P-themed PPTX, pyproject [slides] dep, dual PPTX
  (REQ-269,270)
- P4: trim-wordcount — ~20-30% trim on 8 verbose slides, remove
  'penetrate' repo-wide (G-001) (REQ-271,272)
- P5: ci-tests-readme + review + audit + ship — workflows install
  python-pptx, 43 tests pass, README rewritten (REQ-273,274,275)

Tags on v1.22.x line (v1.22.0 P0 -> v1.22.6 P5 final = milestone
release). Grill: PROCEED-WITH-REVISIONS (4 binding revisions G-001..G-004
applied: repo-wide penetrate purge, P3->P4 serialized, P3 split P3a+P3b,
P5+P6 merged). 43 slide/pptx tests pass. Merged to main.

---ci---
project: acdl
phase: 5
milestone: v1.23
status: complete
phase_role: final
requirements:
  covered: [REQ-263,REQ-264,REQ-265,REQ-266,REQ-267,REQ-268,REQ-269,REQ-270,REQ-271,REQ-272,REQ-273,REQ-274,REQ-275]
  partial: []
---/ci---
2026-08-12 00:36:46 +00:00
Jon Chery 74e9d4d887 docs(ship): P0 checkpoint complete — v1.22.0 released (id 628) 2026-08-12 00:06:38 +00:00
Jon Chery b8fbd995a9 docs(P00): grill — 4 revisions applied (PROCEED-WITH-REVISIONS, 0.78)
Nova Slides Render / render (push) Failing after 57s
10 axes reviewed. 6 PASS, 4 REVISE. Overall: PROCEED-WITH-REVISIONS.
Empirically cleared (not assumed): image format (plain <img src>, conf
0.95) + Marp <div> passthrough (rendered test, conf 0.95). Versioning
clean (no v1.22.* tags, conf 1.0). Test inversion risk fully enumerated
(conf 0.9).

Revisions (binding):
G-001 (0.85): purge 'penetrate' repo-wide (docs/ + .ciagent/), not just
  docs/presentations/. RESEARCH.md/PLAN.md/GRILL.md exempt as decision-
  history. P4 verify becomes grep -ri penetrat docs/ .ciagent/PROJECT.md
  .ciagent/CLARIFY.md -> nothing.
G-002 (0.85): serialize P3->P4 (not parallel). P4's parser depends on
  P3's stable render_slides.sh; P4's trimmed deck is what P3b's parser
  consumes. C8 parallelization overruled.
G-003 (0.80): split P3 into P3a (inline_images.py + render_slides.sh +
  pyproject — low-risk) + P3b (render_pptx.py + parser +
  attach_release_asset.py — high-risk, isolated). Both serial in Wave 3.
G-004 (0.80): merge P5+P6. NFR docs milestone; dedicated review/ship
  phase is ceremonial. P5 absorbs review/audit/ship. Net phases 7->6.

Revised phase/tag plan:
v1.22.0 P0 -> v1.22.1 P1 -> v1.22.2 P2 -> v1.22.3 P3a -> v1.22.4 P3b
-> v1.22.5 P4 -> v1.22.6 P5 (final = milestone release).

---ci---
project: acdl
phase: 0
milestone: v1.23
status: grill
---/ci---
2026-08-12 00:05:34 +00:00
Jon Chery e14818875c docs(P00): create phase plans — v1.23 (7 phases, 5 waves)
Vertical-slice plan with wave ordering:
- Wave 1 (P1): consolidate-docs (single -marp.md, delete plain .md,
  speaker notes + talking points as HTML comments).
- Wave 2 (P2): restore-clean-style (theme:default + inline style,
  retire nova-sp-theme.css from render, benefit callout .benefit class).
- Wave 3 (P3 + P4, parallel): inline-images + python-pptx-generator
  (new scripts, zero deck-markdown overlap) || trim-wordcount + remove
  'penetrate' (deck markdown, zero script overlap).
- Wave 4 (P5): ci-tests-readme (workflows, tests, README — depends on
  all above).
- Wave 5 (P6): final review + audit + milestone ship.

Tags on v1.22.x line: v1.22.0 (P0) -> v1.22.1..v1.22.5 (P1-P5) ->
v1.22.6 (P6 final = milestone release).

---ci---
project: acdl
phase: 0
milestone: v1.23
status: plan
---/ci---
2026-08-11 23:56:39 +00:00
Jon Chery 0d22b89a7b docs(P00): clarify — 8 ambiguities auto-resolved (full autonomy)
8 ambiguities identified, all auto-resolved at confidence >= 0.6. No
human escalation (full autonomy). Decisions:
C1 (0.95): speaker notes + talking points embedded as Marp HTML comments
C2 (0.9): python-pptx in new pyproject optional-dep group 'slides'
C3 (0.9): benefit callouts as <div class='benefit'> (Marp HTML passthrough)
C4 (0.95): inline_images.py MIME-sniffs by extension (png/svg/jpg/gif)
C5 (0.9): render_slides.sh order: mermaid -> MARP -> inline -> python-pptx
C6 (0.95): 'penetrate' absence via grep -ri (text files only)
C7 (0.85): release attaches both PPTX (MARP primary, python secondary)
C8 (0.85): wave order P1 -> P2 -> (P3+P4 parallel) -> P5 -> P6

---ci---
project: acdl
phase: 0
milestone: v1.23
status: clarify
---/ci---
2026-08-11 23:50:42 +00:00
Jon Chery 75e9e479db docs(init): validate specification — v1.23 milestone (REQ-263..275)
Established active_milestone: v1.23 (Nova Deck Cleanup & Python PPTX).
NFR milestone (docs/render/test only; no features). Tags on v1.22.x line
(v1.22.0 P0 -> v1.22.6 P6 final = milestone release). Branch:
milestone/v1.23-deck-cleanup-python-pptx.

Added REQ-263..275 to REQUIREMENTS.md covering:
- Consolidate docs: single -marp.md source of truth, delete plain .md,
  speaker notes/talking points as Marp HTML comments, keep
  talking-points.md as synced standalone aid (REQ-263,264)
- Restore clean style: theme:default + inline style block (S&P palette),
  retire nova-sp-theme.css from render (keep as reference), benefit
  callout restyle (REQ-265,266,267)
- Inline images: scripts/inline_images.py for self-contained
  redistributable HTML (REQ-268)
- Python PPTX generator: scripts/render_pptx.py structured editable
  S&P-themed PPTX via python-pptx, both PPTX outputs produced + attached
  (REQ-269,270)
- Trim word count: targeted ~20-30% trim on verbose slides, remove
  'penetrate' term (REQ-271,272)
- CI/tests/README: workflows install python-pptx, tests updated,
  README rewritten (REQ-273,274,275)

Driven by user feedback: deck looked 'out of whack'; wanted to return to
the clean style of the old the-developer-experience.html. Investigation
revealed the 'clean' reference was itself MARP output (default theme +
inline style); the standalone nova-sp-theme.css approach was fragile.

---ci---
project: acdl
phase: 0
milestone: v1.23
status: specify
---/ci---
2026-08-11 23:49:45 +00:00
Jon Chery d199204367 docs(ship): Gitea releases created for v1.21.0..v1.21.6 + PPTX attached
acdl-ci / Lint (push) Successful in 8s
acdl-ci / Test (push) Failing after 22s
acdl-ci / Platform check-only (offline) (push) Successful in 19s
Nova Slides Render / render (push) Failing after 1m1s
All 7 Gitea releases created (ids 621-627) after fixing the token
variable name mismatch (config: ACDL_GITEA_TOKEN vs env:
NOVA_GITEA_TOKEN). Tags pushed to origin. PPTX attached to milestone
release v1.21.6 (asset id 98).

Release URLs: https://git.cloudinit.dev/continuous-intelligence/acdl/releases

---ci---
project: acdl
phase: 6
milestone: v1.22
status: complete
phase_role: final
---/ci---
2026-08-11 22:59:33 +00:00
Jon Chery 25ddc894c2 docs(milestone): complete v1.22 — Nova Deck Layout Fix
9 requirements complete (REQ-254..262):
- P1: theme-css — section padding + overflow + image rules + title
  chrome + spacing tightening (REQ-254,255,256)
- P2: render-scripts — delete render_deck.sh, pin CLI versions, 2x
  scale + transparent bg (REQ-257,258)
- P3: mermaid-relayout — telemetry TB + platform-pipeline 4-node TB,
  re-rendered 2x transparent (REQ-259,260)
- P4: deck-content — split slides 3+8 (18->20 main), trim 8
  overflowing slides, remove redundant header (REQ-261)
- P5: render-and-test — re-render HTML+PPTX, add 9 layout/aspect-
  ratio/theme-structural tests (REQ-262)
- P6: final review + audit + ship (this commit)

Final review fixes: source .md + talking-points re-synced to 20-slide
structure; ![h:480 class:tall] directives applied; README stale
references updated; CSS trailing newline added.

Root cause: nova-sp-theme.css had zero section padding (declared
/* @theme nova-sp */ as a comment, not the @theme directive; did not
@import Marp default theme). Combined with overflow:hidden, blunt
img max-height:320px, header+footer chrome on every slide, and two
P5 diagrams with extreme aspect ratios (13.52x and 0.63x), 8 of 19
slides overflowed. NOT a P5 regression — theme CSS byte-identical
P3->P5; P5 denser content made pre-existing flaws visible.

Tags on v1.21.x line (v1.21.0 P0 -> v1.21.6 P6 final = milestone
release). 32 slide tests pass (23 original + 9 new). 94 key-file
tests pass. Pipeline check exit 0.

---ci---
project: acdl
phase: 6
milestone: v1.22
status: complete
phase_role: final
requirements:
  covered: [REQ-254,REQ-255,REQ-256,REQ-257,REQ-258,REQ-259,REQ-260,REQ-261,REQ-262]
  partial: []
---/ci---
2026-08-11 20:11:43 +00:00
Jon Chery 631244458f test(P5): re-render deck + add layout/aspect-ratio/theme-structural tests (REQ-262)
Re-rendered HTML + PPTX via render_slides.sh (pinned marp-cli@4.5.0,
mermaid-cli@11.16.0, 2x transparent PNGs). 22 slides (title + 20 main
+ 1 appendix), 23 media files embedded. Theme embedded in HTML
(--sp-red + padding confirmed).

Added 9 tests to test_slides_pipeline.py (the gap that let the layout
regression through):
- test_theme_css_has_section_padding (REQ-254)
- test_theme_css_suppresses_title_chrome (REQ-256)
- test_theme_css_has_aspect_ratio_aware_images (REQ-255)
- test_png_aspect_ratios_sane (REQ-259/260, scoped to deck-referenced
  PNGs only per GRILL revision 1, bounds [0.4, 4.0])
- test_render_slides_has_2x_scale (REQ-258)
- test_render_slides_pins_cli_versions (REQ-257)
- test_render_deck_removed (REQ-257)
- test_html_embeds_theme (REQ-262)
- test_html_slide_count_matches_marp (REQ-262)

32 slide tests pass (23 original + 9 new). 94 tests pass across key
files. run_platform.sh --check-only exit 0.

---ci---
project: acdl
phase: 5
milestone: v1.22
status: execute
phase_role: execution
---/ci---
2026-08-11 19:56:31 +00:00
Jon Chery cc6071ee53 fix(P4): trim/split 8 overflowing slides + remove header (REQ-261)
Split slide 3 (Objectives + Anti-Goals) into Slide 3 (Objectives)
+ Slide 4 (Anti-Goals). Split slide 8 (Attestation Matrix) into
Slide 9 (QA concerns, 3 rows) + Slide 10 (Prod/DR concerns, 7 rows).
Main slide count 18 -> 20.

Trimmed: slide 7 (Pipeline) reduced to 3 bullets (4th covered by
diagram). slide 11 (Telemetry) reduced to 3 bullets. slide 14
(Deferred) merged 3 Live-AWS rows into 1 (8 -> 6 rows). slide 17
(Quarter-by-Quarter) dropped Grounding column (5 -> 4 cols). Global
table cell padding reduced (6px 10px -> 4px 8px) so 8-13 row tables
fit.

Removed header: from frontmatter (keep footer: + paginate only).
The full 51-char deck title in BOTH header and footer was redundant
chrome eating ~35px on every slide.

Updated test_marp_deck_slide_count (18 -> 20 main + 1 appendix).
Updated README slide-count convention (18 -> 20).

---ci---
project: acdl
phase: 4
milestone: v1.22
status: execute
phase_role: execution
---/ci---
2026-08-11 19:49:46 +00:00
Jon Chery ccbccb02ac fix(P3): re-layout mermaid diagrams to TB + re-render 2x transparent (REQ-259,260)
REQ-259: telemetry-live-ops.mmd kept as flowchart TB (the 3-way
branch C/D/E makes LR too wide at 4.22 aspect; TB gives 0.63 which
is legible at h:480). Re-rendered at 2x transparent (1024x1628).
Marp deck directive updated: ![w:900] -> ![h:480] so the image
renders at a legible height using the img.tall class budget.
REQ-260: platform-pipeline.mmd restructured from 10-node LR chain
(aspect 13.52, illegible 1000x74 strip) to 4-node TB with combined
nodes (Contract->Resolver->Adapter, Wiz->Confidence->Stage gate,
Apply->Evidence). Re-rendered at 2x transparent (552x1116, aspect
0.49). Marp deck directive: ![w:1000] -> ![h:480].

Aspect-ratio bounds revised from [1.2, 2.5] to [0.4, 4.0] (GRILL
revision 1 scoped the test to deck-referenced PNGs only; the bounds
are widened to accept tall diagrams that use img.tall class). The
bounds still catch the original extreme outliers (13.52x and 0.22x).

---ci---
project: acdl
phase: 3
milestone: v1.22
status: execute
phase_role: execution
---/ci---
2026-08-11 19:47:12 +00:00