# v0.3.8-alpha.1 Release Notes

## Version

`v0.3.8-alpha.1`

## Dist Tag

`alpha`

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

## Summary

This alpha is a QA hardening release for the v0.3.8 workflow reliability track.

It adds coverage around the transitions that matter most for AI-facing workflow discipline:

- prompt-only requirements should become draft/backlog/tickets instead of direct implementation;
- report-filled state should be visible to `workflow check` and `workflow finish implement`;
- rail-compliance should remain report-only but observable;
- intent routing should be tested at the actual hook boundary.

## Added

- Prompt-only requirements workflow transition coverage:
  - capture;
  - draft;
  - approve;
  - split;
  - next;
  - finish blocking when pending tickets remain.
- Parser-level workflow report status tests covering Markdown status variants and read coverage fields.
- Direct `RailComplianceTracker` unit tests.
- `createPhase0Hooks` `experimental.chat.messages.transform` hook-boundary tests for:
  - requirements;
  - programming;
  - debug;
  - review;
  - refactor;
  - git.
- Clean tarball workflow smoke report for:
  - `ph bootstrap backend`;
  - `ph workflow split`;
  - `ph workflow next`;
  - `ph workflow continue`;
  - `ph workflow finish implement`;
  - `ph workflow check`;
  - `ph doctor`.

## Changed

- Release confidence is now based on integration, parser, runtime tracker, and hook-boundary coverage rather than only happy-path CLI smoke.
- Generated Java/Spring app quality remains outside the release guarantee. It is still handled through injection guidance and report-only review surfaces.

## Verification

Repository verification from the current worktree:

```bash
npm test
npm run typecheck
npm run build
npm pack --dry-run
```

Observed result on 2026-06-24:

- `npm test`: passed, 51 files / 326 tests.
- `npm run typecheck`: passed.
- `npm run build`: passed.
- Clean tarball workflow smoke: passed for Persona Harness command surfaces.

## Known Gaps

- This release does not certify generated app product quality.
- This release does not add AST/linter/enforcement gates.
- This release does not add frontend/infra productization.
- Clean tarball smoke did not run a full OpenCode generated Java/Spring app implementation.
- Long multi-step README implementation still needs continuation workflow observation in real external use.

## Next

- Publish `persona-harness@0.3.8-alpha.1` with the `alpha` tag after final approval.
- Run one external user test with:
  - `npm install -D persona-harness@alpha`;
  - `npx ph bootstrap backend` or `npx ph init`;
  - short TUI request;
  - `ph workflow check`;
  - evidence/report review.