# v0.3.2-alpha.0 Release Notes

## Version

`v0.3.2-alpha.0`

## Dist Tag

`alpha`

During the alpha pilot, `latest` is also synchronized to the current alpha build to avoid stale default installs. This is not a stable support claim.

## npm Package

`persona-harness@0.3.2-alpha.0`

## Summary

This alpha reduces AI workflow forgetfulness in short TUI implementation requests. It adds a single `ph workflow implement` rail and makes README read coverage a workflow evidence gate before an agent can report completion.

## What Changed

- Added `ph workflow implement` as the single AI-facing implementation rail.
- Added README chunk-read instructions to the rail:
  - `npx ph bearshell --shell 'wc -l README.md'`
  - `npx ph bearshell --shell 'sed -n "1,220p" README.md'`
  - continuation ranges such as `221-440`.
- Added read coverage diagnostics to `ph workflow check`.
- Added a `ph workflow finish implement` failure when `README.md` exists but `README ranges read` is empty.
- Updated injection, plan prompts, next/resume output, root README, and Korean README to point agents to `npx ph workflow implement`.
- Kept `ph workflow start implement` and `ph plan --implement` as lower-level compatibility surfaces.

## Install

```bash
npm install -D persona-harness@alpha
npx ph init
```

## Supported Scope

- Java/Spring backend MVP.
- Gradle-first backend workflow.
- OpenCode plugin injection for Java/Spring backend Clean Code guidance.
- AI-facing workflow rail and report lifecycle.
- Report-only diagnostics and workflow evidence gates.

## Not Supported

- Generated app product-quality certification.
- Rule compliance enforcement through AST/linter/build gates.
- Frontend, infra, or desktop productization.
- Full Test -> Feat -> Refactor workflow.
- `ph bearshell` sandboxing.

## Verification

Commands run before release:

```bash
npm test
npm run typecheck
npm run build
npm run report:rules
npm run check:scope:strict
npm run check:injection-value
npm pack --dry-run
npm publish --dry-run --tag alpha
```

Result:

- `npm test`: pass, 36 test files and 224 tests.
- `npm run typecheck`: pass.
- `npm run build`: pass.
- `npm run report:rules`: pass, PersonaHarnessRule diagnostics PASS with 0 findings.
- `npm run check:scope:strict`: pass, MVP scope diagnostics PASS with 0 findings in STRICT mode.
- `npm run check:injection-value`: pass, current window 3/3 with expected decision `continue-java-mvp`.
- `npm pack --dry-run`: pass, 220 files, 225.5 kB package size, 864.1 kB unpacked size.
- `npm publish --dry-run --tag alpha`: pass for `persona-harness@0.3.2-alpha.0`.

## Package Contents Notes

- Includes `dist`, `README.md`, language README files, `LICENSE`, `CHANGELOG.md`, `.persona/harness.jsonc`, `.persona/rules`, current release docs, and the Java programming shared-skill reference subset.
- Excludes generated evidence, experiments, `.persona-test-fixtures`, inactive OMO reference skills, and Java no-excuse fixture files from package contents.

## Known Gaps

- README range coverage is evidence discipline, not semantic proof that the agent understood the README.
- OpenCode behavior still varies by model and runtime context.
- This release does not make `ph` a standalone agent runner; it is a workflow surface for OpenCode/Codex-style agents.
- codegraph-first guidance is AI-facing guidance only; Persona Harness does not install or require a codegraph MCP server.

## Release Automation

- `[ ]` tag matches `package.json` version
- `[ ]` GitHub Actions verify job passed
- `[ ]` npm publish job passed
- `[ ]` GitHub release notes were created

## Next

- Fresh install smoke with `persona-harness@alpha`.
- External tester retry focused on whether short TUI requests now follow `ph workflow implement`.