Skip to content

P2E: reconcile parity docs with real verifiers + dogfood wiki (wj-1zm)#9

Merged
gpxl merged 2 commits into
mainfrom
claude/p2e-reconcile-parity
Jul 9, 2026
Merged

P2E: reconcile parity docs with real verifiers + dogfood wiki (wj-1zm)#9
gpxl merged 2 commits into
mainfrom
claude/p2e-reconcile-parity

Conversation

@gpxl

@gpxl gpxl commented Jul 9, 2026

Copy link
Copy Markdown
Owner

Summary

Final bead of the OPT2+ parity arc — reconciles wijzer's documentation and CI
with the reality of the vendored-real-code approach, and validates the
rewritten /wijzer:init by dogfooding it on wijzer itself.

  • Reconciliation: PARITY.md's "Verified by" column pointed at
    aspirational plan artifacts ("golden run (Phase 2)", "Phase-3 scenario").
    Every row now cites the actual verifier — tests/parity-crossvalidate.test.ts,
    the verbatim vendored update-noop.test.ts, the
    tests/build-disciplines.test.ts drift-lock, tests/check-format.test.ts.
    .github/workflows/parity-watch.yml now watches the full vendored spec
    set (adds src/constants.ts + src/agent/types.ts), drops the stale
    tests/noop.test.ts mapping, and its remediation text now drives the real
    re-vendor → regenerate → npm test flow instead of a hand-port workflow
    that no longer applies. README.md states Node is a dev/CI-only
    dependency — the plugin needs no node at user runtime.
  • Test: tests/plugin-structure.test.ts drops two parity-restatement
    assertions (parity-first, wj-1s6) — that coverage now lives where the
    values are actually derived/enforced: tests/build-disciplines.test.ts
    (derivation-time) and tests/check-format.test.ts (format-gate
    enforcement).
  • Dogfood wiki: new openwiki/ (quickstart, architecture/overview,
    parity/overview, skills/overview, .last-update.json) generated by running
    the rewritten /wijzer:init against wijzer's own repo, plus a ## OpenWiki
    pointer appended to CLAUDE.md linking to it.

Validation

  • Golden-run validated two ways in isolated worktrees: dogfooded on wijzer
    itself
    (this PR's openwiki/) and separately against an unfamiliar
    Swift repo
    — both runs passed scripts/check-format.sh with ok:true.
  • Both quality gates passed: code-quality agent (91 tests green, shellcheck
    clean, Fable-5 review) and this commit agent's independent re-run of
    npm test (91/91) and npm run lint (clean).

Commits

  • c0dda6e docs: reconcile parity claims with real verifiers (P2E, wj-1zm)
  • ad9788e docs: dogfood the rewritten /wijzer:init on wijzer itself (P2E, wj-1zm)

Merge policy

Per this repo's Agent Config: squash + delete branch, auto-merge on green
CI (no human approval gate). This PR is not being merged by the commit
agent — leaving that to pr-monitor/CI per policy.

Test plan

  • npm test — 91/91 passed
  • npm run lint — shellcheck clean
  • Code-quality agent: PASS (prior to this commit)
  • Golden-run check-format.sh — ok:true on wijzer and an unfamiliar Swift repo
  • Manual verification

🤖 Generated with Claude Code

gpxl and others added 2 commits July 9, 2026 02:33
PARITY.md's "Verified by" column cited aspirational phase numbers
("golden run (Phase 2)", "Phase-3 scenario") left over from the
pre-vendoring plan. Point each row at what actually verifies it now:
tests/parity-crossvalidate.test.ts, the verbatim vendored
update-noop.test.ts, the tests/build-disciplines.test.ts drift-lock,
and tests/check-format.test.ts.

parity-watch.yml watched only three of the five spec-bearing files
wijzer vendors (missing src/constants.ts and src/agent/types.ts) and
its remediation text described a hand-port workflow that no longer
matches the vendor -> regenerate -> npm test flow. Widen SPEC_FILES
and rewrite the remediation steps to match.

README.md now states Node is a dev/CI-only dependency (running tests
and regenerating the derived reference docs) — the plugin itself
needs no node at user runtime.

tests/plugin-structure.test.ts drops two assertions that just
restated OpenWiki's own numbers back at wijzer's docs (parity-first,
wj-1s6); that coverage already lives in build-disciplines.test.ts
(derivation-time) and check-format.test.ts (format-gate enforcement).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Runs the prompt-driven /wijzer:init skill against wijzer's own repo,
producing openwiki/ (quickstart, architecture/overview, parity/overview,
skills/overview, .last-update.json) and passing scripts/check-format.sh.
This is the golden-run leg of P2E's validation — the CLAUDE.md commit
in this branch adds the "## OpenWiki" pointer this wiki's quickstart is
linked from.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@gpxl
gpxl merged commit 826d237 into main Jul 9, 2026
4 checks passed
@gpxl
gpxl deleted the claude/p2e-reconcile-parity branch July 9, 2026 07:15
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