Skip to content

docs(plan): Wave N gap-bridge audit — planning review fixes - #122

Merged
neomatrix369 merged 5 commits into
mainfrom
docs/wave-n-planning-review-fixes
Aug 31, 2026
Merged

docs(plan): Wave N gap-bridge audit — planning review fixes#122
neomatrix369 merged 5 commits into
mainfrom
docs/wave-n-planning-review-fixes

Conversation

@neomatrix369

@neomatrix369 neomatrix369 commented Aug 31, 2026

Copy link
Copy Markdown
Owner

Summary

  • Adds Wave N planning artifacts — audit report, slices 55–57, and GWT-44.9 pile-on update — for the Docs & Internals Gap-Bridge Audit (docs-only planning wave)
  • Applies all nW reviewer blockers found by `nw-documentarist-reviewer` and `nw-acceptance-designer-reviewer`
  • Fixes MCP server visibility in quality-tab filtering — MCP servers are excluded from quality buckets (no Tessl score) but pass through the quality filter and remain visible on all tabs
  • Docs/planning only — no source code, no tests, no config changed (aside from the dashboard fix commits)

Changes

Slice 55 — Disclaimer Placements

  • Dependency header corrected: stale `54` → `44 ✅`
  • GWT-55.3: placement locked to adjacent copy (static HTML prototype has no tooltip infrastructure; decision recorded 2026-08-31)
  • GWT-55.5: D3/D4/D8 verbatim placeholder text inlined; grep-able `pending Mani/legal review` markers on each surface

Slice 56 — Gap Repairs (6 sub-items)

  • Dependency header corrected: stale `54` → `44 ✅`
  • GWT-56a: file locked to `docs/user-guide/prerequisites.md`; grep verification command specified
  • GWT-56b/c/d: Then clauses rewritten from cognitive outcomes to artifact-presence assertions with `grep` verification
  • GWT-56f added (new): scanner×input-type matrix for confirmed B.4 gap (5 scanners × 4 input types; ADR-0003 link)
  • Acceptance criteria and doc audit updated for 6 sub-items (56-a through 56-f)

Slice 57 — sync-docs Skill Update

  • GWT-57a.2: concrete product-name exclusion list (Snyk/Modal/Supabase/Cisco/Tessl/DepShield/Ossprey); grep verification command specified
  • GWT-57b.1: all 8 module names inlined into Then clause with `grep -c` verification

Audit Report (`docs/plan/docs-gap-bridge-audit.md`)

  • Status header updated (56-f, review date 2026-08-31)
  • Temporal disclaimer: clarified review was against `main` + pre-merge slice-44 branch
  • DIVIO row: "Adopted — partial" expanded to enumerate compliant / fixed / deferred items
  • Execution queue: 56-f added as seq-8 (P1/M); existing items renumbered 9/10
  • Not-Now list: setup-commands DIVIO collapse added as Wave O tech debt
  • MD056/MD028 markdownlint errors resolved

TRAIL.md / PROGRESS.md / DECISIONS.md

  • Slice-56 row: description updated to reflect 6 sub-items
  • PROGRESS.md one-liner: "5 gap repairs" → "6 gap repairs (incl. 56-f)"
  • DECISIONS.md: two rows logging reviewer pass dates

Dashboard fix — MCP servers in quality tabs

  • fix(dashboard): matchesQualityTab now short-circuits return true for non-skill items — MCP servers had no quality bucket match and were hidden on every tab (default tab was Quality ≥ 80)
  • docs(dashboard): CHANGELOG, README, and slice-42 spec corrected: "MCP servers are excluded from quality buckets (no Tessl score) but remain visible on all quality tabs"
  • Tests: 3 filter-expectation assertions updated to include MCP servers; 111/111 green

Test Results

Dashboard (JS prototype)

  • Suite: prototypes/dc-dashboard/test/tripwire-status.test.js
  • Result: 111/111 pass, 0 fail
  • Regression check: all pre-existing tests pass; MCP pass-through behavior covered by updated filter assertions (GWT-42.12/13/17)

Quality Gates

  • ./scripts/quality-gates.sh passes locally (pre-push hook ✅)
  • No source/config files changed in planning commits (gate skipped on docs-only commits per hook)
  • Dashboard JS fix: no new complexity, no lint violations, no secrets

Checklist

  • ./scripts/quality-gates.sh passes locally
  • New tests added or updated (MCP pass-through assertions updated — 111/111 green)
  • Docs updated where applicable (CHANGELOG, README, slice-42 spec corrected)
  • No secrets or credentials committed

Closes

Wave N planning phase — all reviewer blockers resolved. Execution of slices 55/56/57 is deferred until slice-44 (PR #99) merges to `main`.

Adds the Wave N planning artifacts (slices 55–57, audit report) and
applies all fixes identified by nw-documentarist-reviewer and
nw-acceptance-designer-reviewer in the post-planning review session.

Key changes:
- slice-55: lock disclaimer placement to adjacent-copy; inline D3/D4/D8
  verbatim placeholder text with grep-able pending-review markers
- slice-56: rewrite GWT-56b/c/d as artifact-presence (not cognitive)
  assertions; add new GWT-56f (scanner×input-type matrix, B.4 gap);
  update acceptance criteria and doc audit for 6 sub-items
- slice-57: concrete product-name exclusion list for GWT-57a.2;
  inline all 8 module names in GWT-57b.1
- audit report: status header, temporal disclaimer, DIVIO enumeration,
  exec queue (56-f seq-8, renumber 57→9/58→10), Not-Now entry for
  setup-commands DIVIO collapse (Wave O tech debt)
- DECISIONS.md: log both reviewer passes (2026-08-31)
- TRAIL.md / PROGRESS.md: update slice-56 description and one-liner
  to reflect 6 sub-items including 56-f
@github-actions

github-actions Bot commented Aug 31, 2026

Copy link
Copy Markdown

code-review-graph review

Overall risk: 0.35 (LOW) — 5 changed function(s)/class(es), 0 affected flow(s), 0 test gap(s)

Risk-scored changes

Risk Level Symbol Location Tested
0.35 low prototypes/dc-dashboard/tripwire-status.js::matchesQualityTab prototypes/dc-dashboard/tripwire-status.js:357 yes
0.25 low prototypes/dc-dashboard/test/tripwire-status.test.js::test:given quality helpers when boundary and type checks then s... prototypes/dc-dashboard/test/tripwire-status.test.js:328 (test)
0.15 low prototypes/dc-dashboard/test/tripwire-status.test.js::test:given mixed quality skills when high tab filter then only ... prototypes/dc-dashboard/test/tripwire-status.test.js:301 (test)
0.15 low prototypes/dc-dashboard/test/tripwire-status.test.js::test:given mixed quality skills when low tab filter then below-... prototypes/dc-dashboard/test/tripwire-status.test.js:310 (test)
0.15 low prototypes/dc-dashboard/test/tripwire-status.test.js::test:given mixed quality skills when unscored tab filter then n... prototypes/dc-dashboard/test/tripwire-status.test.js:319 (test)

Token savings: this graph-backed report used ~71,990 fewer tokens (~98%) than reading every changed file in full (estimated, chars/4 approximation).


Powered by code-review-graph — local-first analysis; no code leaves the CI runner.

…-audit

- Merge extra cells in B.3/B.6/B.7/B.9/B.10 rows (7→6 cols to match header)
- Replace blank line between consecutive blockquotes with bare >
…hiding them

The quality filter was applied to all item types, causing MCP servers to
be invisible in every view since no tab bucket matches a non-skill item.
Quality tabs are a skills-only concept — non-skill items should always be
visible regardless of which quality tab is active.

Fix: matchesQualityTab short-circuits for non-skill items (return true).
Spec: GWT-42.12/13/17 corrected to reflect pass-through intent.
Tests: updated filter expectations to include MCP servers on all tabs.
…le on all tabs, not excluded

Corrects CHANGELOG and README to reflect that MCP servers pass through all
quality buckets (no filtering) rather than being excluded from those tabs.
…ality buckets but visible

The earlier commit fixed the filter bug; these docs now correctly say
MCP servers are excluded from quality score buckets (no Tessl scan) but
pass through the quality tab filter and remain visible in all tab views.
@neomatrix369
neomatrix369 merged commit 3fdb7f8 into main Aug 31, 2026
14 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant