chore(release): prepare v0.2.0 (#56)

Author: chicoxyzzy

codexadapter/adapter_test.go

@@ -682,23 +682,15 @@ fi
 printf '{"method":"permission/requested","params":{"toolCall":{"toolCallId":"tool-1","title":"Run tests","kind":"execute","rawInput":{"command":"go test ./..."}},"options":[{"optionId":"allow","name":"Allow","kind":"allow_once"},{"optionId":"reject","name":"Reject","kind":"reject_once"}]}}\n'
 printf '{"method":"item/completed","params":{"item":{"type":"agent_message","id":"msg-1","text":"allowed"}}}\n'
 	`)
-	client := acptest.NewClient(t, codexadapter.NewServer("test"))
-	client.Request("initialize", map[string]any{})
-	createdResponses := client.Send(map[string]any{
-		"jsonrpc": "2.0",
-		"id":      2,
-		"method":  "session/new",
-		"params":  map[string]any{"cwd": t.TempDir()},
-	})
+	client := acptest.NewLiveClient(t, codexadapter.NewServer("test"), acptest.WithAutoAllowPermissions())
+	client.Request("initialize", "initialize", map[string]any{}, time.Second)
+	createdResponses := client.Request("new-session", "session/new", map[string]any{"cwd": t.TempDir()}, time.Second)
 	var session struct {
 		SessionID string `json:"sessionId"`
 	}
-	createdResponses[1].ResultInto(t, &session)
+	createdResponses[len(createdResponses)-1].ResultInto(t, &session)
 
-	responses := client.SendRaw(strings.Join([]string{
-		`{"jsonrpc":"2.0","id":3,"method":"session/prompt","params":{"sessionId":"` + session.SessionID + `","prompt":[{"type":"text","text":"hello"}]}}`,
-		`{"jsonrpc":"2.0","id":"server-1","result":{"outcome":{"outcome":"selected","optionId":"allow"}}}`,
-	}, "\n") + "\n")
+	responses := client.PromptText("prompt", session.SessionID, "hello", time.Second)
 	if len(responses) != 6 {
 		t.Fatalf("responses = %#v, want tool start + permission + answer + tool finish + session info + prompt result", responses)
 	}

docs/RELEASE.md

@@ -18,12 +18,11 @@ make snapshot
 
 ## Tagging
 
-Use semantic version tags, including alpha prereleases while the adapter is not
-production-ready:
+Use semantic version tags. Add a prerelease suffix only for prerelease builds:
 
 ```sh
-git tag v0.1.0-alpha.1
-git push origin v0.1.0-alpha.1
+git tag v0.2.0
+git push origin v0.2.0
 ```
 
 Pushing a `v*` tag runs `.github/workflows/release.yml`, which uses GoReleaser
@@ -40,7 +39,7 @@ generates GitHub artifact attestations from that checksum file using
 Download the archive and checksum file for the tag:
 
 ```sh
-tag=v0.1.0-alpha.30
+tag=v0.2.0
 version="${tag#v}"
 archive="codex-acp-adapter_${version}_linux_amd64.tar.gz"
 

docs/ROADMAP.md

@@ -81,7 +81,7 @@
   `review --uncommitted` command, `/init` stays on the normal `codex exec`
   prompt path, and additional commands need parity tests before being exposed
 - continue hardening auth/session/prompt/cancel/config/tool mappings with
-  source-shaped parser fixtures and real Hecate release-binary smoke tests;
+  source-shaped parser fixtures and real Hecate embedded-adapter smoke tests;
   native MCP lifecycle and tool-approval edge cases remain deeper parity work
 - port the edge cases recorded in `SOURCE_REVIEW.md`
 
@@ -90,7 +90,6 @@
 - checksum-backed release archives with GitHub artifact attestations from the
   tag workflow
 - keep `docs/STABLE_READINESS.md` current until the stable gate is green
-- keep Hecate registry/Dockerfile pins pointed at the released
-  `codex-acp-adapter` binary, and run Hecate's ACP adapter release smoke after
-  every adapter release bump
+- keep Hecate's Go module pin pointed at the released adapter tag, and run
+  Hecate's built-in adapter integration tests after every adapter release bump
 - no Hecate runtime launch path depends on a package-manager adapter wrapper

docs/STABLE_READINESS.md

@@ -1,28 +1,40 @@
 # Stable Readiness
 
-This adapter reaches `v0.1.0` when the command-backed ACP v1 contract is stable
-enough for operators to depend on directly. Stable does not mean every draft ACP
-RFD or Codex-native edge case is implemented; those remain tracked future work
-unless they are part of the contract below.
+The `v0.1.0` release established the command-backed ACP v1 contract that
+operators can depend on directly. Every later stable release preserves that
+baseline and may add compatible surfaces. Stable does not mean every draft ACP
+RFD or provider-native edge case is implemented; those remain tracked future
+work unless they are part of the contract below.
 
-## Required Gate Before `v0.1.0`
+## Required Gate For Every Stable Release
+
+Before tagging:
 
 - `make release-check` passes on the release commit.
 - `make real-cli-smoke` passes on a prepared machine with an authenticated
   Codex CLI.
-- The Hecate ACP adapter release-binary smoke passes after Hecate is pinned to
-  the candidate release.
-- Release archives have checksums and GitHub artifact attestations generated by
-  the tag workflow.
-- Every `Required` row in the stable-scope matrix is covered. `Future` rows are
-  non-blocking for `v0.1.0`.
+- Required GitHub checks pass on the exact commit that will be tagged.
+- Every `Required` row in the parity matrix is covered. `Future` rows are
+  non-blocking.
+
+Immediately after tagging:
+
+- The tag workflow publishes the expected release archives and
+  `checksums.txt`.
+- Every release archive passes checksum and GitHub artifact-attestation
+  verification.
+- Hecate is pinned to the stable module tag and its built-in adapter integration
+  checks pass before Hecate consumes the release.
 
-## Stable Scope
+Tags are immutable. If a post-tag gate fails, do not adopt the release; correct
+the problem and publish a patch release.
+
+## Stable Baseline
 
 The `v0.1.0` contract covers stable ACP v1 session methods, prompt streaming,
 config selectors, MCP server config handoff into Codex CLI, stable
 `session/request_permission` handling, cancellation, release provenance, and
-Hecate's release-binary smoke.
+Hecate's embedded-adapter integration.
 
 Draft ACP RFDs, including MCP-over-ACP and Elicitation, are not stable blockers.
 Provider-native MCP lifecycle hooks, permission elicitations beyond stable
@@ -32,22 +44,21 @@ as required gates.
 
 ## Parity Matrix
 
-| Surface            | Current state                                                                                                                                             | Automated coverage                                                                                  | `v0.1.0` decision                                                                            |
+| Surface            | Current state                                                                                                                                             | Automated coverage                                                                                  | Stable-release decision                                                                      |
 | ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- |
 | ACP initialize     | Adapter metadata, auth/logout, MCP, prompt, and stable session capabilities are advertised.                                                               | Unit tests plus shared kit initialize conformance.                                                   | Required; covered.                                                                          |
 | Auth and logout    | ACP `authenticate` maps to `codex login`; ACP `logout` maps to `codex logout`.                                                                            | Unit tests, fake bridge tests, and opt-in real CLI smoke.                                            | Required shape covered; destructive auth-cycle smoke remains operator opt-in.                |
 | Session lifecycle  | `session/new`, `session/list`, `session/load`, `session/resume`, `session/fork`, `session/close`, and `session/delete` work for command-backed sessions. | Unit tests, portable upstream parity checks, and opt-in real CLI list/load smoke.                     | Required; Codex-native durable restore across adapter restarts is future work.               |
 | Prompt streaming   | Codex JSONL maps to ACP assistant text, reasoning, usage, stop reasons, and tool updates.                                                                 | Source-shaped parser fixtures, command bridge tests, and opt-in real CLI prompt/tool smoke.           | Required; covered for real shell/file update flow.                                          |
 | Config selectors   | Static model, reasoning, sandbox, approval-policy, and web-search selectors are exposed and updateable.                                                    | Unit tests and portable selector parity checks.                                                      | Required as static selectors; runtime discovery is future work.                              |
-| MCP handoff        | ACP stdio/HTTP MCP server config maps to Codex CLI config overrides.                                                                                      | Unit tests, Hecate release-binary smoke, and opt-in real CLI stdio MCP echo-tool smoke.               | Required handoff covered; draft MCP-over-ACP/provider lifecycle hooks are future work.       |
-| Permissions        | Stable ACP permission requests plus denied/rejected/blocked provider tool results map to ACP permission/tool state.                                      | Source-shaped parser fixtures, grant/reject/cancel tests, Hecate release-binary smoke, and opt-in real CLI permission auto-approval. | Required stable permission flow covered; elicitation-style prompts are future work.          |
-| Cancellation       | ACP cancel terminates active command-backed prompts and drops post-cancel stream chunks.                                                                  | Unit tests, command bridge tests, portable parity checks, Hecate release-binary smoke, and opt-in real CLI cancellation smoke. | Required; covered for normal real CLI cancellation/no double-settle.                         |
-| Release artifacts  | GoReleaser archives are checksum-verified and provenance-attested by the tag workflow.                                                                    | Release workflow doc test and `make release-check`; release verification uses `gh attestation verify`. | Required once the first stable release is published and verified.                            |
-| Hecate integration | Hecate bundles released binaries and runs release-binary smoke against them.                                                                              | Hecate `just test-acp-release-smoke`.                                                                | Required for every Hecate adapter pin bump.                                                  |
-
-## Stable Decision
-
-Cut `v0.1.0` after the required rows pass on the release commit, the real CLI
-smoke passes on an authenticated local machine, and Hecate's release-binary
-smoke passes against the candidate release. Future rows should stay documented,
-but they do not block the stable adapter tag.
+| MCP handoff        | ACP stdio/HTTP MCP server config maps to Codex CLI config overrides.                                                                                      | Unit tests, Hecate embedded-adapter tests, and opt-in real CLI stdio MCP echo-tool smoke.              | Required handoff covered; draft MCP-over-ACP/provider lifecycle hooks are future work.       |
+| Permissions        | Stable ACP permission requests plus denied/rejected/blocked provider tool results map to ACP permission/tool state.                                      | Source-shaped parser fixtures, grant/reject/cancel tests, Hecate embedded-adapter tests, and opt-in real CLI permission auto-approval. | Required stable permission flow covered; elicitation-style prompts are future work.          |
+| Cancellation       | ACP cancel terminates active command-backed prompts and drops post-cancel stream chunks.                                                                  | Unit tests, command bridge tests, portable parity checks, Hecate embedded-adapter tests, and opt-in real CLI cancellation smoke. | Required; covered for normal real CLI cancellation/no double-settle.                         |
+| Release artifacts  | GoReleaser archives are checksum-verified and provenance-attested by the tag workflow.                                                                    | Release workflow doc test and `make release-check`; release verification uses `gh attestation verify`. | Required for every stable release.                                                           |
+| Hecate integration | Hecate compiles the versioned Go adapter library into its binary.                                                                                         | Hecate agent-adapter tests and `just test-acp-real-embedded codex`.                                  | Required for every Hecate adapter pin bump.                                                  |
+
+## Release Decision
+
+Cut a stable tag only after every pre-tag gate passes. Treat it as ready for
+Hecate consumption only after every post-tag gate passes. Future rows should
+stay documented, but they do not block a stable adapter release.

docs/TESTING.md

@@ -2,9 +2,9 @@
 
 This repository tests the adapter scaffold, the subprocess-backed ACP runtime
 bridge, and the native Codex CLI command bridge Hecate uses today. Hecate's
-replacement path is covered by Hecate release-binary smoke tests; this adapter
-repo still tracks deeper vendor-native parity before calling the adapter
-production-grade.
+embedded path is covered by its agent-adapter integration tests and opt-in
+authenticated embedded smoke; this adapter repo still tracks deeper
+vendor-native parity before calling the adapter production-grade.
 
 ## Covered Today
 

go.mod

@@ -12,7 +12,7 @@ require (
 )
 
 require (
-	github.com/hecatehq/acp-adapter-kit v0.1.1-0.20260717083303-8510f612270d
+	github.com/hecatehq/acp-adapter-kit v0.2.0
 	github.com/inconshreveable/mousetrap v1.1.0 // indirect
 	github.com/spf13/pflag v1.0.9 // indirect
 )

go.sum

@@ -1,8 +1,8 @@
 github.com/coder/acp-go-sdk v0.13.5 h1:LI9jq5xon7xslaYlnoktvTVyDlE37yIk2daT7N9ASYk=
 github.com/coder/acp-go-sdk v0.13.5/go.mod h1:yKzM/3R9uELp4+nBAwwtkS0aN1FOFjo11CNPy37yFko=
 github.com/cpuguy83/go-md2man/v2 v2.0.6/go.mod h1:oOW0eioCTA6cOiMLiUPZOpcVxMig6NIQQ7OS05n1F4g=
-github.com/hecatehq/acp-adapter-kit v0.1.1-0.20260717083303-8510f612270d h1:cDHoW7nujGNHTujpynDUcFM8j0cCLuArSJWvONT6mKo=
-github.com/hecatehq/acp-adapter-kit v0.1.1-0.20260717083303-8510f612270d/go.mod h1:tqRmkI7UfnabJsmhj6GrQdTdX2GwtYcCobiSPZl8ERo=
+github.com/hecatehq/acp-adapter-kit v0.2.0 h1:mDbizsflcQOSLzxS+RBUj4HqvohEOC/bO7EdOm+bztI=
+github.com/hecatehq/acp-adapter-kit v0.2.0/go.mod h1:tqRmkI7UfnabJsmhj6GrQdTdX2GwtYcCobiSPZl8ERo=
 github.com/inconshreveable/mousetrap v1.1.0 h1:wN+x4NVGpMsO7ErUn/mUI3vEoE6Jt13X2s0bqwp9tc8=
 github.com/inconshreveable/mousetrap v1.1.0/go.mod h1:vpF70FUmC8bwa3OWnCshd2FqLfsEA9PFc4w1p2J65bw=
 github.com/russross/blackfriday/v2 v2.1.0/go.mod h1:+Rmxgy9KzJVeS9/2gXHxylqXiyQDYRxCVz55jmeOWTM=

internal/app/release_docs_test.go

@@ -37,9 +37,11 @@ func TestReleaseDocsDescribeStableReadinessGate(t *testing.T) {
 
 	stable := readRepoText(t, "docs/STABLE_READINESS.md")
 	for _, want := range []string{
+		"Required Gate For Every Stable Release",
 		"make release-check",
 		"make real-cli-smoke",
-		"Hecate ACP adapter release-binary smoke",
+		"Hecate compiles the versioned Go adapter library",
+		"test-acp-real-embedded",
 		"Parity Matrix",
 		"Release artifacts",
 		"gh attestation verify",