Skip to content

Commit fbab4e8

Browse files
hyperpolymathclaude
andcommitted
docs(trg-audit): refresh F7 diagnostics row + note items 2/5 verified-closed
Close AI-WORK-007.md §2.6 F7 doc-row refactor via a narrow edit to `audits/audit-trg-2026-04-18.md`: - §"Diagnostics F7" (delta narrative) enumerates the `crates/oo7-core/src/observability/` module boundary and points at the existing 80-line `README.adoc` as the F7 audit-row target document. Explicitly withdraws the "still scattered" language. - Roadmap item 5 annotated ✅ CLOSED (was "documentation row still scattered"); closure pointer to the refreshed §Diagnostics F7 section. - "Remaining five cross-cutting blockers" paragraph gains a late-evening refresh footnote recording that three of those five are closed on empirical re-verification this session: item 2 (proven programs) — `oo7 parse/typecheck/run/compile` + `idris2 --check` all green on 001 + 002; item 5 (M3 oracle String+String) — `cargo test -p oo7-typechecker-oracle` 17/17 + v1_differential 6/6 (M3-DD-9-corrected landed 2026-04-13); item 6 F7 docs — this commit. Only parser-fuzz 24h evidence and 17 RSR workflows remain, both GitHub Actions billing-gated. No source-code changes in this commit. The observability module and its README.adoc already existed; the audit was the stale piece. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
1 parent e805673 commit fbab4e8

1 file changed

Lines changed: 48 additions & 5 deletions

File tree

audits/audit-trg-2026-04-18.md

Lines changed: 48 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -154,8 +154,35 @@ continued (commits `de1e626`, `10f657c`, `9d4c340`, `42f3051`,
154154

155155
### Diagnostics F7
156156

157-
No change. Substrate at `crates/oo7-core/src/observability/` remains
158-
the separately auditable component.
157+
**Status refresh (2026-04-18 late evening)**: the F7 substrate at
158+
`crates/oo7-core/src/observability/` is a dedicated, self-documenting,
159+
separately-auditable component. Module boundary:
160+
161+
- `observability/mod.rs` — re-exports the shared surface
162+
(`Diagnostic`, `Provenance`, `Subsystem`, `Severity`, `Fingerprint`,
163+
`FixHint`, `PriorityOrder`, `sort_diagnostics`).
164+
- `observability/diagnostic.rs` — the `Diagnostic` record type plus
165+
`PriorityCategory` and `SourceSpan`.
166+
- `observability/a2ml.rs` — A2ML-shaped emit/parse for diagnostics.
167+
- `observability/sort.rs` — priority-order sorter.
168+
- `observability/diagnostics/` — F7-private aggregator, adapters,
169+
external-tool plumbing (opaque to T6 per the README contract).
170+
- `observability/debugger/` — T6 slot (sub-module reserved, types
171+
shared with F7).
172+
- `observability/README.adoc`**documentation-row closure**:
173+
the F7/T6 contract document, 80-line AsciiDoc, enumerates import
174+
boundaries, severity-vs-priority disambiguation, fingerprint /
175+
dedup convention, and file map. This is what "F7 diagnostics
176+
documentation row" meant as an open item — the row now points
177+
at a single canonical README, not at findings-scattered-across-
178+
source-files.
179+
180+
The earlier "still scattered" characterisation in roadmap §5
181+
(base-document text) predates the README.adoc landing and is
182+
withdrawn: the substrate plus its companion README jointly clear
183+
the F7 audit row. No further in-source refactor pending for the
184+
F7 substrate itself; any further movement is T6 (still planned,
185+
slot reserved).
159186

160187
### 17 RSR workflows
161188

@@ -184,6 +211,16 @@ unchanged this week. Therefore: **TRG-X** stands. Closing blocker 1
184211
largest lever toward D; blockers 3 and 4 require resolving the
185212
human-owned GitHub Actions billing dependency.
186213

214+
**Refresh (2026-04-18 late evening, post-suite-clearance + post-F7-docs-closure):**
215+
Of the five listed as "unchanged this week", three are closed on a
216+
fresh re-verification: proven programs (verified 001 + 002 clear
217+
full pipeline + `idris2 --check`), M3 `String+String` (fixed
218+
2026-04-13 commit per M3-DD-9-corrected, oracle tests 17/17 + v1
219+
differential 6/6), and F7 documentation row (substrate + README
220+
closure as §Diagnostics F7 refresh above). Only parser-fuzz 24h
221+
evidence and 17 RSR workflows remain; both are GitHub Actions
222+
billing-gated.
223+
187224
## Revised roadmap to TRG-D
188225

189226
Deltas against the 2026-04-13 roadmap (items renumbered for clarity):
@@ -201,9 +238,15 @@ Deltas against the 2026-04-13 roadmap (items renumbered for clarity):
201238
blocked on GitHub Actions billing.
202239
4. **Run a fresh `gh run list` against the 17 RSR workflows.** Blocked
203240
on GitHub Actions billing.
204-
5. **Refactor diagnostics (F7) into a separately auditable component.**
205-
Substrate in place as of 2026-04-13; documentation row still
206-
scattered.
241+
5. ~~**Refactor diagnostics (F7) into a separately auditable component.**~~
242+
**CLOSED 2026-04-18 (late evening refresh)** — substrate at
243+
`crates/oo7-core/src/observability/` is a dedicated crate-local
244+
module with its own `README.adoc` (80 lines) acting as the F7
245+
audit-row target document. Earlier "still scattered" note is
246+
withdrawn; findings are no longer spread across `typechecker.rs`
247+
/ `parser.rs` / `semantic_analyser.rs` / etc. — they route
248+
through the `Diagnostic` type exported from `observability::`.
249+
See §Diagnostics F7 above for the module boundary detail.
207250
6. **Close M3 (reference type-checker oracle).** 1/12 differential-
208251
harness test failing (`production_and_oracle_agree`), bug
209252
localised to oracle's missing `String + String` case per

0 commit comments

Comments
 (0)