# v0.4.0 Release Notes

## Version

`v0.4.0`

## Dist Tag

`latest`

`0.4.0` is the official latest-channel release after verified
`0.4.0-rc.10`.

Post-publish registry state:

- `persona-harness@latest`: `0.4.0`;
- gitHead: `af51e8afa3bdb41e3eb3a2abf003d95bfa7c6055`;
- shasum: `45e3b49d162eeed6d9bc443b5b44508c1e956ebf`;
- `next`: `0.4.0-rc.10`;
- `alpha`: `0.3.9-alpha.8`;
- local and remote `v0.4.0` tags point at
  `af51e8afa3bdb41e3eb3a2abf003d95bfa7c6055`.

## Summary

This release packages the verified Persona Harness workflow rail MVP:

- workflow rails, evidence traces, continuation/report lifecycle, and finish
  gates;
- opt-in TDD rail plus read-only `ph workflow tdd`;
- precise conformance blockers including Controller→Repository and
  `service.state-ownership`;
- read-only `ph evidence metrics [--json]`;
- default developer MCP bundle package surfaces;
- opt-in LSP MCP wrapper with unavailable facade and proxy guard.

## Included Behavior

### Workflow Rail And Evidence Gates

Persona Harness provides AI-facing CLI rails for init/bootstrap, plan/continue,
workflow check, report lifecycle, archive, and finish. Finish remains the final
validation gate and is not a generated-app quality certificate.

### TDD Rail

The TDD rail remains opt-in. `ph workflow tdd` is read-only and reports current
ticket red→green status and next action. Evidence writing and blocking remain
with `ph workflow test`, `ph workflow check`, `ph workflow archive <ticket>`,
and `ph workflow finish implement`.

This is not a full TDD framework: it does not scaffold tests, prove test
sufficiency, run coverage, or run mutation testing.

### Conformance Blockers

`0.4.0` includes precise, high-signal Java/Spring blockers such as
Controller→Repository direct dependency and `service.state-ownership`. The
`service.state-ownership` blocker targets Service-owned in-memory state/id
counters such as private `Map`, `AtomicLong`, `nextId`, or `idCounter` fields
with file/class evidence and actionable remediation.

This is not a broad AST/linter product or general architecture-correctness
guarantee.

### Evidence Metrics

`ph evidence metrics [--json]` is a read-only local evidence summary. It reports
available token-usage evidence, structured tool/MCP call names, read chars when
present, and finish pass/fail records.

This is not a token-saving, provider-token-saving, product-efficacy, or
navigation-benefit claim.

### Developer MCP Bundle

Backend bootstrap prepares the default developer MCP bundle package surfaces:
remote `grep_app`, remote `context7`, and the local PH CodeGraph wrapper. The
CodeGraph wrapper is an external optional integration and does not auto-run
`codegraph init` or create `.codegraph/`.

This is not PH-owned CodeGraph, codegraph replacement, OMO parity, Codex
support, token-saving evidence, or navigation-benefit evidence.

### LSP MCP Wrapper

`ph bootstrap backend --lsp-preview` is opt-in. It registers the root
`ph-lsp-mcp` wrapper from `packages/lsp-mcp`. Missing dependencies keep a
protocol-alive unavailable facade with `lsp_status` only. Proxying
symbol/definition/reference-style calls requires both an upstream LSP MCP and a
Java LSP binary such as `jdtls` or an explicit `PH_LSP_JAVA_SERVER`.

No real Java LSP tool-call has been observed yet. This release does not make
LSP default and does not claim LSP effectiveness.

## Post-Publish Registry Smoke

External latest registry smoke installed `persona-harness@latest` as `0.4.0`.

- Archive:
  `/Users/yongtae/Desktop/persona-harness-artifacts/archive/2026-06-24-desktop-persona-runs/v040-latest-registry-package-runtime-20260701-221728`.
- Verified basic CLI clean install/help/init/doctor/bootstrap.
- Verified the default developer MCP bundle package surface.
- Verified the opt-in TDD rail plus read-only `ph workflow tdd`.
- Verified the precise `service.state-ownership` blocker.
- Verified read-only `ph evidence metrics [--json]`.
- Verified the opt-in LSP MCP wrapper unavailable facade and proxy guard.

This is registry package/runtime surface evidence only. It is not a
model/OpenCode implementation run, eval result, token-saving,
provider-token-saving, product-efficacy, navigation-benefit, generated-app
certification, broad reliability, closure guarantee, full TDD/test-sufficiency,
broad AST/linter product, real Java LSP default/effectiveness, Codex support, or
code-nav replacement claim.

## Claim Audit

Do not claim:

- token saving or provider-token saving;
- app/product quality guarantee;
- full TDD framework, scaffolding, coverage, mutation testing, or test
  sufficiency;
- LSP default behavior, LSP effectiveness, or real Java LSP tool-call evidence;
- broad AST/linter product or general architecture correctness;
- broad reliability, closure guarantee, or generated-app certification;
- Codex support;
- code-nav relabeling or replacement.