Skip to content

v1.2: Codex compatibility, npx wdym-prompt installer, README flow diagram - #2

Merged
ndisisnd merged 4 commits into
mainfrom
v1.2-codex
Aug 8, 2026
Merged

ndisisnd merged 4 commits into
mainfrom
v1.2-codex

Conversation

@ndisisnd

@ndisisnd ndisisnd commented Aug 8, 2026

Copy link
Copy Markdown
Owner

Why

wdym assumed one host: Claude Code. Under Codex CLI the engine works but the plumbing doesn't — no AskUserQuestion, different skill path, different hook and trust files. v1.2 makes wdym run correctly on either host, gives both hosts one install command, and makes the mental model visible.

Implements improve/v1.2-codex-npx.md (plan and test plan live in improve/, untracked by design).

What changed

Codex runtime compatibility (2e214ad)

  • Emitted block signal line is host-neutral; bench asserts the new wording and bans host filenames in the block
  • Approval gate and --init route through a "present options and stop" ask step — AskUserQuestion when available, plain-text question + end-of-turn otherwise, chosen by tool availability
  • Hook state resolution walks cwd to the repo root and consults $CODEX_HOME; new agents/openai.yaml manifest; allowed-tools: dropped; description triggers front-loaded for Codex's truncated skills list

npx wdym-prompt installer (0686e45)

  • One dependency-free Node CLI wires Claude and/or Codex: skill files, hook entry, trust contract, single canonical pref.json; Codex skill path is a symlink to the canonical copy with copy fallback
  • Byte-idempotent re-runs; collapses pre-existing duplicate hook entries; Codex install is global-only (--codex --local refuses, wires nothing); loud /hooks re-approval notice printed last on every Codex-touching run; --doctor / --uninstall
  • npm files allowlist + prepublishOnly bench gate; nothing published yet

Docs, diagram, release notes (0657e50)

  • README: npx wdym-prompt primary, install.sh demoted to frozen Claude-only, Codex requirements note, Mermaid flow diagram (default theme) with a four-point host-divergence table
  • ARCHITECTURE: two-host model section; RELEASES.md v1.2.0 entry

Installer contract alignment (latest)

  • install.sh and the npx installer now write byte-identical trust-contract text, ending the one-line flap between them

Verification

  • Each landing was implemented by one Opus agent and independently re-verified by a second; review fixed 3 installer bugs (worst: hook dedupe matching any command containing "wdym") and 2 doc inaccuracies before commit
  • 131-assertion sandbox matrix + 54 adversarial assertions, all against throwaway HOMEs; tests/detect_bench.py green; npm pack --dry-run ships no tests/plans/local state; Mermaid parse-checked
  • Still open before tag + npm publish (scripted in improve/v1.2-test.md): live Codex session (AC-1/2/13/18), live Claude no-regression (AC-3), real Node 18 run, GitHub diagram render + one-reader test, publish preflight

🤖 Generated with Claude Code

ndisisnd and others added 4 commits August 9, 2026 00:33
…resolution (WS-A)

Landing 1 of the v1.2 plan: wdym runs correctly under Codex.

- Host-neutral emitted signal line; bench updated in the same change
- "Present options and stop" ask step replaces hard AskUserQuestion dependence
  in the comprehensive gate and --init (chosen by tool availability)
- State resolution walks cwd to repo root and consults $CODEX_HOME
- agents/openai.yaml manifest; allowed-tools dropped; description triggers
  front-loaded for Codex's skills-list truncation
- init/help/commands/heal made host-aware (Codex global-only per D7)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…ode and Codex (WS-B)

Landing 2 of the v1.2 plan.

- Dependency-free Node CLI: host detection, Claude + Codex wiring,
  symlinked Codex skill path with copy fallback, single canonical pref
- Idempotent by command text; collapses the real-world duplicate hook pair
- Codex trust notice printed last on every Codex-touching run
- --doctor / --uninstall; npm files allowlist + prepublishOnly bench gate
- Verified: 131-assertion sandbox matrix + 54 adversarial assertions;
  three bugs fixed in review (over-broad hook dedupe, duplicate contract
  blocks, non-object settings overwrite)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…otes (WS-C/WS-D)

Landing 3 of the v1.2 plan.

- README: npx wdym-prompt as primary install, install.sh demoted to
  frozen Claude-only, Codex requirements note, three-way comparison table
- README: Mermaid flow diagram (default theme, parse-checked) with a
  four-point host divergence table
- ARCHITECTURE: new Two-host model section; ask-step gate; file map
- llms.txt host-neutral; RELEASES.md v1.2.0 entry
- Review fixes: ambiguous-vs-degraded verdict in the diagram; --doctor
  documented as reporting Codex trust "unknown" (not readable from disk)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…px installer

- install.sh and bin/wdym-prompt.js now write byte-identical contract
  text; the one-line flap between installers is gone
- Dev repo CLAUDE.md aligned to the same wording
- Sandbox-verified: stale block refreshed in place, re-run already-current,
  npx over install.sh leaves exactly one block; detect bench green
- Live-verification test plan added as improve/v1.2-test.md (untracked
  by design, improve/ is gitignored)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@ndisisnd
ndisisnd merged commit e1d6fc2 into main Aug 8, 2026
1 check 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