Skip to content

feat: ph shell-hook + harness guard + docs restructure (v0.2.1)#5

Merged
weijt606 merged 1 commit into
mainfrom
v0.2.1
Apr 8, 2026
Merged

feat: ph shell-hook + harness guard + docs restructure (v0.2.1)#5
weijt606 merged 1 commit into
mainfrom
v0.2.1

Conversation

@weijt606

@weijt606 weijt606 commented Apr 8, 2026

Copy link
Copy Markdown
Owner

What's New

ph shell-hook — zero-config auto-wrap (3 new commands)

Installs a shell preexec hook that automatically intercepts claude/claw/codex/opencode commands and transparently routes them through ph wrap --auto-evolve — no manual prefix needed.

ph shell-hook install      # one-time setup, writes to ~/.zshrc
ph shell-hook status       # check installation state
ph shell-hook uninstall    # clean removal

Harness existence guard

The orchestrator now checks whether the Proposer actually generated harness.py before evaluation. Gives a clear error instead of a cryptic FileNotFoundError.

Documentation restructure

  • Batch search loop diagram moved to Step 4; auto-evolution flow diagram moved to Step 6
  • "How It Works" section simplified to text explanation with cross-references
  • Full shell-hook usage documentation added to both READMEs

Changes

  • cli.py — +147 lines: shell-hook command group (install/uninstall/status, hook script, helpers)
  • orchestrator.py — +6 lines: harness.py existence guard
  • test_evolution.py — +79 lines: 8 new tests (TestShellHook class)
  • README.md / README_CN.md — diagram relocation + shell-hook docs
  • CHANGELOG.md — v0.2.1 entry
  • Version bump: 0.2.0 → 0.2.1

Validation

  • 173 tests passed, ruff clean
  • Manual smoke test: shell-hook install/status/uninstall, wrap, traces

@weijt606
weijt606 merged commit 9edd609 into main Apr 8, 2026
3 checks passed
@weijt606
weijt606 deleted the v0.2.1 branch May 20, 2026 12:24
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