# v0.4.0-rc.7 Release Notes

## Version

`v0.4.0-rc.7`

## Dist Tag

`next`

`0.4.0-rc.7` is a next-channel prerelease for the default OpenCode developer MCP
bundle and external CodeGraph wrapper surface. `latest` did not move.

Registry `persona-harness@next` points at `0.4.0-rc.7` with gitHead
`640b8d3833e8de12657cdebf4ff0bc2877878c6d`.

## Summary

This candidate packages the post-rc6 developer MCP bundle work already accepted
by QA and External Smoke from a fresh local/current tarball:

- default `ph bootstrap backend` registers remote `grep_app`, remote `context7`,
  and a local PH CodeGraph wrapper MCP for OpenCode;
- `--no-developer-mcp` skips the bundle;
- `--no-codegraph` keeps the remote bundle entries and omits the CodeGraph
  wrapper;
- `--codegraph-preview` remains compatible with wrapper-backed CodeGraph
  registration;
- existing `.opencode/opencode.json` plugin, agent, custom MCP, and top-level
  entries are preserved;
- PH does not run `codegraph init` and does not create `.codegraph/`;
- no fake `git_bash` or `lsp` MCP surfaces are registered.

## Package-Surface Evidence

Default developer MCP bundle External local/current tarball smoke PASS:

- source HEAD: `a9dcf044ff423fc4b94e549d365febe0844ab960`
  (`a9dcf04 feat(cli): add developer MCP bundle`);
- source type: fresh local/current tarball only, not registry `@next`;
- package/version at smoke time: `persona-harness@0.4.0-rc.6`;
- tarball:
  `/Users/yongtae/Desktop/persona-harness-artifacts/archive/2026-06-24-desktop-persona-runs/developer-mcp-bundle-a9dcf04-20260701-125655/persona-harness-0.4.0-rc.6.tgz`;
- npm shasum: `24631c91d8ad4791ab7b8a3ca139312ddd8989eb`;
- sha256:
  `7adc96fdbd14bf9447f70ff8de7dc3fe0192c8d875516aaabbd454170d12936a`;
- package includes `packages/codegraph-mcp/bin/codegraph-mcp.mjs`,
  `packages/codegraph-mcp/lib/codegraph-core.mjs`, root bin
  `ph-codegraph-mcp`, and optional dependency metadata for
  `@colbymchenry/codegraph@1.1.6`;
- default init/bootstrap registers remote `grep_app`, remote `context7`, and
  local PH `codegraph` wrapper;
- `--no-developer-mcp`, `--no-codegraph`, `--codegraph-preview`, and config
  preservation passed;
- missing-binary CodeGraph unavailable facade passed framed and newline MCP:
  protocol-alive, `tools/list` status-only, `tools/call status` and unknown tool
  returned `isError:true` unavailable payloads, no fake indexed/search tools, and
  clean stderr;
- `opencode mcp list --pure` showed `grep_app`, `context7`, and `codegraph`
  connected.

In this smoke, CodeGraph connected means the PH wrapper/facade stayed
protocol-alive. It does not mean usable indexing, effectiveness, navigation
benefit, or token savings.

## Boundaries

This is a next-channel prerelease only. Post-publish registry verification and
registry-only package-surface smoke both passed for the package/runtime surfaces
listed here.

Do not claim:

- token-saving, provider-token saving, product efficacy, or navigation benefit;
- PH-owned CodeGraph, CodeGraph replacement, or OMO parity/replacement;
- Codex support;
- fake `git_bash` or `lsp` MCP coverage;
- `.codegraph` auto-init;
- model/eval/native dispatch evidence;
- generated app certification, broad reliability, or a closure guarantee.

R-CG.2 already proved one real external CodeGraph MCP tool call, but its bounded
Java/Spring A/B was worse with CodeGraph ON. That measurement remains
effectiveness deferred/no-keep and is not an rc7 benefit claim.

## Post-Publish Registry Facts

Observed after publish:

- `persona-harness@0.4.0-rc.7` exists on npm;
- registry gitHead: `640b8d3833e8de12657cdebf4ff0bc2877878c6d`;
- registry shasum: `9d6cb2167fbbf5aa3bdb925b4ec2b6d3652ccd07`;
- dist-tags: `next=0.4.0-rc.7`, `latest=0.3.9-alpha.8`,
  `alpha=0.3.9-alpha.8`;
- local and origin tag `v0.4.0-rc.7` point at
  `640b8d3833e8de12657cdebf4ff0bc2877878c6d`.

## Registry Package-Surface Smoke

External registry-only package-surface smoke PASS:

- package source: registry `persona-harness@next`;
- installed package/version: `persona-harness@0.4.0-rc.7`;
- registry gitHead: `640b8d3833e8de12657cdebf4ff0bc2877878c6d`;
- registry shasum: `9d6cb2167fbbf5aa3bdb925b4ec2b6d3652ccd07`;
- dist-tags observed: `next=0.4.0-rc.7`, `latest=0.3.9-alpha.8`,
  `alpha=0.3.9-alpha.8`;
- archive:
  `/Users/yongtae/Desktop/persona-harness-artifacts/archive/2026-06-24-desktop-persona-runs/rc7-registry-developer-mcp-20260701-134918`;
- work root: `/tmp/persona-rc7-registry-developer-mcp-20260701-134918`;
- package entries included `ph-codegraph-mcp`,
  `packages/codegraph-mcp/bin/codegraph-mcp.mjs`,
  `packages/codegraph-mcp/lib/codegraph-core.mjs`, and optional dependency
  metadata for `@colbymchenry/codegraph@1.1.6`;
- default `ph init --default backend` plus `ph bootstrap backend --force`
  registered remote `grep_app`, remote `context7`, and local PH `codegraph`
  wrapper;
- no fake `git_bash` or `lsp` MCP entries were registered;
- no `.codegraph` directory was auto-created;
- `--no-developer-mcp` registered no bundle entries;
- `--no-codegraph` kept `grep_app` and `context7` while omitting `codegraph`;
- existing `.opencode/opencode.json` plugin, agent, custom MCP, and top-level
  entries were preserved;
- missing-binary CodeGraph facade passed framed and newline JSON-RPC:
  protocol-alive, `tools/list` status-only, `tools/call status` unavailable
  with `isError:true`, search/unknown tool unavailable/error, no fake
  indexed/search tools, and clean stderr;
- `opencode mcp list --pure` exited 0 and showed `grep_app`, `context7`, and
  `codegraph` connected.

In this registry smoke, CodeGraph connected means the PH wrapper/facade stayed
protocol-alive. It is not indexing, navigation-benefit, token-saving,
provider-token saving, or product-efficacy evidence.