# v0.3.8-alpha.4 Release Notes

## Version

`v0.3.8-alpha.4`

## 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 focused workflow/check/report guidance hardening release for the v0.3.8 line.

It includes the post-`0.3.8-alpha.3` fixes for:

- review-report template plus pending `req-*` continuation guidance;
- Gradle wrapper-first verification guidance;
- backend-shape recognition for repository ports, repository adapters, and flat DTO names;
- Windows path separator normalization in backend-shape evidence.

This release is not a generated app product quality certification. Full OpenCode end-to-end implementation quality remains a separate smoke target.

## Changed

- Clarified continuation guidance when `.persona/workflow/review-report.md` is still a template and workflow tickets such as `req-1` remain pending.
- Updated Java/Spring verification guidance to prefer the project Gradle wrapper first, then system Gradle only when a wrapper is not present and Gradle is genuinely installed.
- Kept fake Gradle shims out of the recommended path.
- Improved backend-shape recognition for:
  - `TaskRepository` as a domain repository port;
  - `JdbcTaskRepository implements TaskRepository` as an infrastructure repository adapter;
  - flat DTO names such as `CreateTaskRequest` and `TaskResponse`.
- Normalized backend-shape paths so Windows `\` separators do not create path-evidence false positives.

## External Smoke

Windows backend-shape fixture-v2 recheck result: successful for the narrow backend-shape fixture criteria.

Install/source:

- install source: local current `npm pack`, not registry;
- HEAD: `31fb91a fix(cli): normalize backend shape paths`;
- package version during smoke: `0.3.8-alpha.3`;
- archive: `/Users/yongtae/Desktop/persona-harness-artifacts/archive/2026-06-24-desktop-persona-runs/windows-backend-shape-v2-recheck-20260625-130647`.

Observed:

- `npx ph review backend-shape` exited 0.
- Backend-shape report was generated.
- `Domain repository port` passed with `TaskRepository.java`.
- `Infrastructure repository adapter` passed with `JdbcTaskRepository.java`.
- `DTO boundary` passed with `CreateTaskRequest.java` and `TaskResponse.java`.
- The previous Windows path separator false positive was not reproduced.

Remaining limits:

- The remaining WARN items came from the minimal fixture's missing application/controller/service files and missing Gradle runtime.
- Those WARN items were outside this narrow recheck's success criteria.
- This smoke does not certify generated app product quality.
- Full OpenCode end-to-end implementation quality remains a separate smoke target.

## Verification

Repository verification from the release prep worktree:

```bash
npm test
npm run typecheck
npm run build
npm pack --dry-run
npm run check:docs
```

Observed result on 2026-06-25:

- `npm test`: passed. Scope diagnostics PASS, docs taxonomy diagnostics PASS, 55 files / 342 tests.
- `npm run typecheck`: passed.
- `npm run build`: passed.
- `npm pack --dry-run`: passed for `persona-harness@0.3.8-alpha.4`.
  - Filename: `persona-harness-0.3.8-alpha.4.tgz`
  - Shasum: `c084f6187a7f41a170399435e1674d9627291117`
  - Total files: 329
- `npm run check:docs`: passed.

## Known Gaps

- This release improves workflow/check/report guidance and backend-shape evidence recognition; it does not certify generated application quality.
- Full OpenCode end-to-end implementation quality still requires separate smoke coverage.
- The backend-shape fixture-v2 smoke used a local pack from current HEAD, not a registry install.
- Minimal fixture WARNs around application/controller/service coverage and Gradle runtime availability remain outside the narrow backend-shape recheck.

## Recommended Before Publish

- Publish only as a prerelease alpha.
- Keep release messaging focused on workflow/check/report guidance and backend-shape false-positive reduction.
- Do not describe this release as full OpenCode implementation success or product-quality certification.