Files

T

Jon Chery 64e5321c96 fix(audit): post-v0.12 audit remediation — checkpoint typo + report template + ARCHITECTURE drift

---ci---
project: orca
phase: 28
milestone: v0.12
status: complete
---

Post-milestone audit (v0.11.28 milestone release) found 3 issues; this
commit remediates all three and tags the result v0.11.29 per the
feature-milestone progressive-patch rule (v0.11.x patch line; no
separate v0.12.0 tag per ROADMAP).

1. CHECKPOINT.json typo: key "phases_shiped" -> "phases_shipped"
   (missing 'p' made the 29-phase shipped list unreachable). All 29
   phases P0..P28 now readable by canonical key.

2. Missing audit artifact: opencode/ci/references/report-template.md
   created. Binding template covering all 5 audit steps + verdict
   convention (PASS/WARN/FAIL). Satisfies audit Step 5 check #4
   (report-template exists).

3. ARCHITECTURE.md drift: removed stale internal/orch/ reference
   (package never existed; replaced by internal/sshpush/ in v0.9).
   Appended "v0.9-v0.12 Component Addendum" documenting all 25 packages
   introduced across v0.9-v0.12 (workload/runtime, state/persistence,
   transport/bootstrap, security/identity layers). ARCHITECTURE.md now
   matches actual code structure.

Re-audit PASS: all 6 audit checks green; project state fully
reconstructable from git log.

2026-08-07 18:05:50 +00:00

3.1 KiB

Raw Blame History

Phase Audit Report Template

Use this template for CIAgent audit reports (ciagent-audit workflow). Fill each section; mark N/A where a check does not apply (e.g. no active phase branch after milestone completion). Keep verdicts binding: PASS / FAIL / WARN only — no soft language.

Phase Audit — ()

Project: Milestone: —

Date: Branch: <current branch> Result: <PASS / WARN / FAIL> —

Step 1 — Reconstruction Test

Latest ---ci--- block (HEAD): project: <slug>, phase: <N>, milestone: <ver>, status: <stage> — <matches / mismatches> CHECKPOINT.json (phase: <N>, stage: <stage>).
config.json milestone: <ver> — <matches / mismatches>.
make verify-reqs → — ROADMAP ↔ REQUIREMENTS <consistent / inconsistent>.
/ commits have ---ci--- blocks (<%> commit discipline).

Step 2 — .ciagent/ File Discipline

config.json: <valid / invalid> JSON, required fields <present / missing>: .
PROJECT.md: required sections <present / missing>: <What This Is / Requirements / Constraints / Key Decisions>.
ROADMAP.md: phases <match / mismatch> git branches; <merged=complete, active=in-progress>.
REQUIREMENTS.md: traceability matrix <complete / incomplete>; REQ references.
ARCHITECTURE.md: components <match / mismatch> actual code structure; .
PERSONAS.md: roster <current / stale>.

Step 3 — Branch Hygiene

Phase branches: active, merged, orphan.
Milestone branches: active, merged.
Orphan branches (no ---ci--- commits): <list or "none">.
Stale merged branches (should be deleted): <list or "none">.

Step 4 — Commit Discipline

Total commits: ; with ---ci---: ; without: (<pre-convention legacy, acceptable / unexpected — investigate>).
Stale decisions (D-series in .ciagent/ >50 commits old, not reflected in code): <list or "none">.
Unresolved escalations older than timeout: <list or "none">.

Step 5 — Audit Checks

HEAD not on main when phase/milestone branches exist — <PASS / N/A / FAIL>: .
CHECKPOINT.json exists — <PASS / FAIL>.
CHECKPOINT.json consistent with git status — <PASS / FAIL>: .
Report template exists (opencode/ci/references/report-template.md) — <PASS / FAIL>.
No pending escalations — <PASS / FAIL>: <detail; auto-resolved is OK>.
Milestone version in config consistent — <PASS / FAIL>: config= vs ROADMAP= vs checkpoint=.

Issues

List each issue with severity (P0 blocking / P1 fix-soon / P2 nice-to-have):

[P0] — — .
[P1] — — .
[P2] — — .

If no issues: "All checks passed. Project state is fully reconstructable from git log."

Recommendations

Verdict Convention

PASS — all checks green; no P0/P1 issues. Ship proceeds.
WARN — no P0; one or more P1/P2. Ship proceeds; issues logged for follow-up.
FAIL — any P0 issue. Ship blocked; resolve and re-audit.

3.1 KiB Raw Blame History