# Agent E2E compatibility repair plan

작성: 2026-10-09. 상태: **최종 v7 — stale status diagnostics와 lifecycle CLI 결과 정정**. 이 문서는 `docs/plans/2026-10-09-quality-hardening.md`의 결과를 대체하거나 수정하지 않는 별도 후속 계획이다. Main은 PowerShell bridge가 아니라 Node child bootstrap을 선택했다. Native probe는 direct Node, CMD, Windows PowerShell 5.1, PowerShell 7에서 정확한 executable, stdin/stdout/stderr byte 전달과 exit code를 통과했다. OpenCode의 directory-first 1-line 수정과 focused test는 이미 working tree에 있으며 이 plan과 독립적으로 검증한다. 새 CLI 결과 표시는 기존 flags를 유지하고 기존 warning/provider-partial fields를 보존하며 `codexStaleEvents`/`claudeStaleEvents`를 additive status diagnostics로 추가한다. 새 JSON `incomplete` field는 추가하지 않는다. 이 문서 수정에서는 버전 변경·commit·push·publish를 수행하지 않는다.

## 목적과 확인된 출발점

llm-wiki-kit은 hook-first, answer-first, file-first living Markdown wiki다. Agent hook은 기존 프로젝트 문서에서 답변에 필요한 문맥을 주고, 사용자가 명시한 재사용 가치가 있는 지식만 프로젝트의 Markdown으로 남긴다. 이 계획은 실제 Agent 앱이 설치된 hook을 실행해 이 흐름을 완성하도록 하며 transcript 저장, 자동 durable page 생성, cloud 의존성, 인증 수단 변경을 추가하지 않는다.

2026-10-09 실제 app 검증은 `0.26.0`, source SHA `c72f92a77ce52a36ffb9006f17a0d3947a57e963`, tarball SHA-256 `45cebdfc9b5215f135ccf115608bc79a2510eb0870740f5c8684dc8623c6c1d3` 후보에서 수행됐다. 운영 결과 `2026-10-09-actual-agent-app-e2e.md`는 Linux Codex와 Git 프로젝트의 OpenCode를 통과로 기록하고, Linux/Windows Claude를 인증 차단으로 구분한다. Windows Codex는 모델 응답과 기존 문서 편집에는 성공했지만 native hook envelope와 turn state가 없어서 installed integration 실패다.

Windows Codex 진단에서는 `SessionStart`, `UserPromptSubmit`, `Stop`의 각 command에서 PowerShell parsing error가 네 개씩 관측됐다. generated command가 quoted executable로 시작했고, 같은 command construction은 `0.25.2`에도 있었다. 임시 profile에서 공백 없는 command로 바꾼 실제 app control은 safe envelope 5종, `Stop`, 기존 문서 편집, `closed/completed` turn state를 만들었다. 이 차이는 generated Windows command 형식이 실패 원인임을 뒷받침한다. 더 좁은 PowerShell parser 기전이나 user trust 거부를 원인으로 단정하지 않는다.

별도의 OpenCode 비-Git fixture에서는 runtime `directory`가 대상 project인데 `worktree`가 filesystem root로 보고되어, bridge가 context를 선택하지 못했다. 이 결함은 공유 working tree에서 이미 `src/templates.js`가 `directory`를 우선하도록 바뀌었고 `test/opencode-provider.test.js`에 focused 회귀 검사가 추가되었다. 이 작은 수정은 계획 수립과 병행해 이미 구현한 상태이며, source/full/installed test로 계속 확인한다. 아직 통과했다고 주장하지 않는다.

Claude의 실제 app은 Linux와 Windows에서 인증 전에 막혔다. 이는 이 코드 결함의 증거가 아니다. 사용자가 요청한 범위에는 동일 provider의 통상적인 계정 복구와 정상 로그인 흐름이 포함되며, 별도 승인을 기다리는 인위적 gate를 두지 않는다. Browser/MFA 등 사용자의 외부 상호작용이 필요하면 해당 단계만 기다린다. 토큰·credential 복사/내보내기, 다른 provider로 전환, 새 API key나 billing/console 설정은 범위 밖이다.

## 동작 의도와 성공 기준

Codex와 Claude Code의 Windows hook은 shell에서 안정적으로 파싱되는 작은 bare `node.exe -e` bootstrap을 실행한다. Bootstrap은 고정된 JavaScript와 Base64 JSON data `{node, script, args}`만 사용하고 `spawnSync`로 payload에 지정된 정확한 Node executable과 설치된 `bin/llm-wiki.js`를 `shell: false`, `stdio: 'inherit'`로 실행한다. 기존 Node stdin/stdout/stderr bytes, working directory, environment와 child exit code가 그대로 이어져야 한다. Agent가 설치 hook을 호출했는지는 실제 app에서 검증한다.

Install/update는 정확히 확인된 이 kit의 오래된 command만 자동 migration한다. Expected current matcher가 있는 unambiguous owned command는 같은 entry 안에서 command만 in-place 갱신하고 user sibling hooks와 metadata를 보존한다. Known legacy default matcher를 current default로 normalize하는 경우에만 pure-owned entry이고 user sibling hook이 없어야 한다. Custom matcher와 multiple kit duplicates는 automatic migration에서 stale로 남긴다. `status`는 이를 current라고 숨기지 않는다. 혼합 command field의 kit/user ownership이 충돌하거나 ambiguous하면 hook object 전체를 보존하고 `stale/unmanaged`로 보고한다; 이를 `invalid`나 `missing required hook`으로 오분류하거나 새 duplicate를 만들지 않는다. Explicit `uninstall`은 matcher가 custom이어도 proven owned command field를 모두 제거하되 user hook fields, siblings, entry metadata는 보존한다. 다만 같은 hook object의 다른 `command`/`commandWindows` field가 user-owned/unknown이면 object 전체를 건드리지 않는다. Explicit `--replace-hooks`는 known matcher와 exact event/provider를 가진 proven kit duplicate를 재조정할 수 있지만, non-command metadata와 nested fields가 모두 동일할 때만 처리한다. Metadata가 다르거나 mixed ownership이면 object 전체를 보존한다. `echo`, 다른 실행 파일, 같은 이름의 사용자 명령은 kit hook으로 간주하지 않는다.

## 범위와 제안 구현

### Windows Codex 및 Claude launcher

- `src/platform.js:commandForNodeScript`의 Windows 분기는 tested Node child bootstrap으로 만든다. 실제 저장 command는 bare `node.exe -e "<fixed JavaScript with single-quoted literals>" <base64-json>`이며 Codex의 `commandWindows`와 Claude의 `command`가 같은 builder를 사용한다. POSIX command byte/behavior는 바꾸지 않는다.
- Outer bare `node.exe`는 provider shell의 Windows executable search order로 해석된다. Installer 실행 시의 PATH와 agent의 PATH/CWD가 같다고 보장하지 않으므로 absolute bootstrap resolution을 주장하지 않는다. Agent PATH에는 신뢰할 수 있는 Node 설치가 있어야 하며, `node.exe`를 찾지 못하면 bootstrap 자체가 시작되지 않아 provider shell의 launch error와 nonzero 결과가 난다. Final actual-app runner는 provider가 실행한 최종 저장 command와 실제 hook 결과를 검사한다. Bootstrap은 payload의 `{node, script, args}`에서 canonical exact child Node binary와 installed CLI script를 읽어 `spawnSync(node, [script, ...args], {shell:false, stdio:'inherit'})`로 실행한다. Parent hook의 stdin/stdout/stderr bytes와 CWD/environment가 그대로 전달되고 child의 exact exit code를 반환한다.
- Bootstrap JavaScript는 고정 source이며 input data만 Base64 JSON으로 전달한다. PATH의 outer Node는 launcher를 시작하는 용도이고, hook 실행은 payload에 들어 있는 exact child Node path로 한 번만 spawn한다. Payload value를 JavaScript source나 shell string에 이어붙이거나 `eval`/dynamic code execution을 하지 않는다. Child `error`, signal, status-null 결과도 nonzero로 안전하게 반환한다.
- Command length는 실제 저장할 outer `node.exe -e ... <base64-json>` 전체를 포함해 **7,000 UTF-16 code units 이하**로 제한한다. 이 값은 `cmd.exe`의 8,191-character 한계보다 1,191 characters 낮다. Provider가 추가할 wrapper는 최대 128 characters로 정량화해 생성 command+측정 wrapper가 8,191 이하인지 검사하고, 나머지 여유도 유지한다. Windows의 32,767-character `CreateProcess` 한계는 목표치가 아니다. 최종 command 길이/escaping 검증은 모든 provider write·backup·설정 mutation 전에 끝낸다. 경계를 넘으면 아무 provider 설정도 바꾸지 않고 명확한 preflight failure를 낸다.
- hook ownership 확인은 command를 실행하지 않는다. Stored outer command의 길이와 정확한 `node.exe -e` prefix/fixed-JS source를 확인한 뒤 bounded Base64 JSON을 decode한다. Payload는 정확한 schema `{node, script, args}`와 제한된 field/type/length를 가져야 한다. `args`는 정확히 `['hook', expectedProvider, expectedEvent]`여야 하고 configured provider file/field와 일치해야 한다. Node identity는 current `process.execPath` 또는 지원되는 `node.exe`와 strict known `node_modules/llm-wiki-kit/bin/llm-wiki.js` package path 조합만 인정한다. Script는 current canonical bin path 또는 해당 strict package path여야 한다. Old `/llm-wiki-kit/bin/` basename/infix만으로 ownership을 인정하지 않는다. Legacy bare `llm-wiki`/`.cmd` command는 실제로 current runtime을 가리키는 resolved CLI shim일 때만 인정한다. 임의 outer executable, arbitrary marker, basename 유사성, 수정된 bootstrap/script, wrong provider/event/field는 ownership 증거가 아니다. Parsed data로 command를 다시 canonical-encode해 원문과 정확히 일치하는지 검사한다. Decoder는 payload/bootstrap을 실행하거나 평가하지 않는다. 기존 known quoted-Node/CMD command의 strict plain signature 검사도 유지한다.
- `src/install.js` lifecycle은 field별 소유권을 구분한다. Current expected matcher를 가진 unambiguous owned command는 user sibling hooks가 있어도 같은 entry 안에서 command만 in-place 갱신한다. Known legacy default matcher를 current default로 normalize하는 경우에만 해당 entry가 pure kit-owned이고 user sibling hook이 없어야 한다. Custom matcher와 multiple owned duplicates는 stale 상태로 남겨 automatic migration하지 않는다. Explicit `--replace-hooks`는 expected matcher/exact provider/event가 동일하고 non-command metadata 및 nested fields가 byte/semantic equality로 동일한 proven kit duplicate만 reconcile한다. Mixed `command`/`commandWindows`에 user/unknown field가 있거나 metadata가 다른 entry는 object 전체를 보존한다. Explicit uninstall은 matcher 변경 여부와 무관하게 확인된 owned command를 제거하되, object 안의 다른 `command`/`commandWindows` field가 user-owned/unknown이면 해당 ambiguous object 전체를 보존한다. Matcher는 automatic migration의 안전조건이며 ownership이 명확한 uninstall의 삭제조건은 아니다.

### CLI가 lifecycle 상태를 소비하는 경로

- 새 install lifecycle warning도 사용자가 확인할 수 있어야 한다. 현재 `src/install.js`는 provider setup partial/stale 상태를 반환하지만, 이를 감싼 nested install/update 결과가 human CLI에서 `installed` 성공처럼 보이고 exit code 0으로 끝날 수 있다. `src/cli.js`는 nested provider install warnings와 provider-partial state를 top-level result에 보존한다. `src/cli-format.js` human formatter는 warning을 보여주고 provider setup failure/partial이면 CLI exit code를 1로 설정한다. Existing JSON warning/provider-partial fields는 유지하고 `codexStaleEvents`/`claudeStaleEvents`는 status에 additive diagnostics로 제공한다. 새 JSON `incomplete` field는 추가하지 않는다.
- `src/cli-format.js`/`src/doctor.js`는 `stale/unmanaged` hook을 `missing` provider hook과 별도로 표시한다. 기존 provider selection, flags, 기존 JSON fields를 유지하고 event별 stale arrays만 status에 추가한다. Unknown/mixed object는 자동 수정하지 않는다.
- 이 consumer integration은 lifecycle warning 전달의 필수 연결이며 범위 확대가 아니다. 기능을 사용자가 볼 수 있는 형식과 command exit로 전달하지 않으면 ownership-safe migration 결과를 완료로 볼 수 없다.

### Provider lifecycle 및 OpenCode 경로 선택

- `src/install.js`의 `hookCommand`, `hookCommandOwnsKitBinary`, `isKitHookEntry`, `addHook`, `removeKitHooks`, `status` 경로를 검토해 생성·인식·업데이트·제거가 같은 소유권 정의를 사용하게 한다. Legacy ownership은 정확한 provider+event group/configured field 안의 known command shape와 알려진 기본 matcher에서만 확인한다. Install/update는 요청한 provider+event group의 허용된 current/known-legacy matcher를 검사한 뒤 unambiguous kit-owned hook의 command field만 in-place 교체한다. Matcher가 사용자가 편집한 custom value면 보존하고 해당 integration은 stale로 남긴다. 혼합 `command`/`commandWindows` 필드 중 하나라도 사용자 소유/알 수 없는 값이거나 ownership이 서로 충돌하는 hook object는 전체를 그대로 보존하고 stale/unmanaged로 보고한다. 이 경우 required provider hook이 단순히 missing이라고 잘못 표시하지 않고 새 duplicate entry도 추가하지 않는다. 두 필드가 모두 확인된 동일 kit hook이면 함께 update/remove한다. 기존 matcher 자체, timeout/prompt와 custom entry metadata, sibling user hooks 및 ordering은 그대로 둔다. Known legacy matcher의 순수 kit hook만 해당 event에서 migration할 수 있으며, matcher/ownership이 모호하거나 kit-owned hook이 여러 개라 안전하게 선택할 수 없으면 자동 편집/삭제하지 않고 stale/ambiguous 진단을 낸다.
- OpenCode bridge는 runtime `directory`가 있으면 그것을 우선하고, 없을 때만 `worktree`, 마지막으로 `process.cwd()`를 사용한다. Hook 경로에서 project를 자동 bootstrap하지 않는다. 기존 initialized-project 정책을 유지한다.
- 현재 OpenCode 변경 `src/templates.js`, `test/opencode-provider.test.js`를 보존해 회귀 검증한다. 추가 변경은 그 test에서 실제로 부족한 조건이 확인될 때만 계획을 다시 검토한다.

### 정확한 소스·테스트·문서 경로

- 구현: `src/platform.js`, `src/install.js`, `src/cli.js`, `src/cli-format.js`, `src/doctor.js`; 이미 있는 OpenCode 수정 `src/templates.js`.
- 새 회귀 계약: `test/windows-hook-command.test.js` (Windows command generation, strict ownership decode, child argument/stdio/exit behavior). 설치 수명주기: `test/update.test.js`, `test/uninstall-safety.test.js`. CLI warning/exit/status contract: `test/cli-hardening.test.js`. OpenCode: `test/opencode-provider.test.js`. Module/package/docs contract가 필요하면 `test/release-contract.test.js`에 추가한다.
- 패키지/native installed verification: `package.json`의 `files`, `scripts/release/verify-features.mjs`, `scripts/windows-runner/verify-release.ps1`를 검토해 `test/windows-hook-command.test.js`를 exact packaged test와 named installed stage `E01`에 연결한다. OpenCode의 `test/opencode-provider.test.js`는 기존 provider/data stage에서 한 번만 실행하고 `E02`를 포함한다. `E01`의 유일한 non-Windows skip title은 `native Windows cross-shell Node launcher preserves byte streams and exit code`이며 `process.platform !== 'win32'`에서만 allowlist한다. Windows에서는 그 test가 skip이면 실패다. Unknown/잘못된 OS skip은 PASS로 합산하지 않는다. 새 test가 import하는 helper는 같은 tarball에 포함하고, test가 packaged runner에 연결되지 않으면 source-only PASS로 기능 검증 완료라고 하지 않는다.
- 사용자 문서: `docs/manual.md`의 Windows provider setup, `docs/security.md`의 encoded command와 실행 경계, `docs/troubleshooting.md`의 stale hook 및 재설치 진단을 실제 구현에 맞춘다. 설명은 Base64가 암호화나 secret storage가 아님을 명시하고 command에 credential을 넣지 않는다. README는 이미지를 포함한 제품 소개를 이번 계획에서 재작성하지 않는다.
- 버전 `0.26.0`과 package schema/dependencies/public CLI flags는 변경하지 않는다. 인증 기능 또는 provider credentials 연동을 추가하지 않는다.

## 테스트 계획

1. 좁은 Linux/source 회귀: `node --test test/windows-hook-command.test.js test/update.test.js test/uninstall-safety.test.js test/cli-hardening.test.js test/opencode-provider.test.js test/release-contract.test.js`.
2. Launcher contract에는 경로 공백·Unicode·따옴표·달러/백틱·쉘 metacharacters, provider/event arguments, bounded Base64 JSON과 canonical command 왕복, malformed/over-bound/modified bootstrap 거부, 임의 command·동일한 `echo` 사용자 hook 보존을 포함한다. 전체 저장 command가 7,000 UTF-16 units 이하이고, 정량화한 128-character provider wrapper를 더해도 `cmd.exe` 8,191-character limit 안에 드는지 경계값에서 확인한다. Parent-run native probe는 direct Node, CMD, Windows PowerShell 5.1, PowerShell 7에서 exact child binary, stdin/stdout/stderr bytes, exit `17`을 통과했다. Packaged Windows test title은 `native Windows cross-shell Node launcher preserves byte streams and exit code`이며, 이 테스트는 생성 command 자체를 Windows PowerShell 5.1과 CMD에서 반드시 실행한다. PowerShell 7과 Bash는 존재할 때 추가 확인한다. Direct Node probe는 별도의 parent-run native evidence이며 packaged-test 필수 host로 세지 않는다. Final actual-app runner는 provider 환경에서 최종 저장 command가 hook을 실행하는지 확인하며 bootstrap executable의 absolute resolution을 주장하지 않는다.
3. Install/update/status/uninstall regression은 legacy stale hook → install → current status, 반복 install 중복 0, 기존 entry/custom metadata/sibling hook 보존, legacy/new owned command만 제거, unrelated same-name user command 보존을 fake home과 temp workspace에서 검사한다. Codex `commandWindows`와 Claude `command`, wrong provider/event/field, `command`/`commandWindows` 혼합 kit/user ownership, custom matcher, same-name `echo`, old package path infix/lookalike user binary를 각각 검사한다. Current matcher의 unambiguous kit command는 user sibling이 있어도 command field만 migration한다. Legacy matcher normalization은 sibling user hook이 없는 pure kit entry에서만 한다. Custom matcher와 multiple duplicates는 automatic migration에서 stale로 보존한다. Explicit `--replace-hooks` duplicate reconciliation은 non-command metadata와 모든 nested fields가 동일한 pure kit entries로 제한하며, 다른 metadata나 mixed ownership은 보존한다. Explicit uninstall은 custom matcher가 있어도 proven kit-owned fields를 제거하되 ambiguous mixed object는 통째로 보존한다.
4. `test/cli-hardening.test.js`는 nested install/provider partial failure 경고가 human output에 나타나고 existing JSON warning/provider-partial fields가 보존되며 exit 1로 전달되는지, 새 JSON `incomplete` field 없이 status JSON에 `codexStaleEvents`/`claudeStaleEvents`가 추가되는지, `status`/doctor가 `stale/unmanaged`와 `missing`을 구분하는지 검사한다. CLI provider/replace flags는 변경하지 않는다.
5. OpenCode 비-Git test는 project `directory`와 다른 `worktree`를 주어 bridge가 directory를 사용함을 확인하고, directory 부재의 worktree fallback과 둘 다 부재의 process cwd fallback도 확인한다. 이후 real OpenCode app run은 비-Git 임시 project에서 context hit과 기존 Markdown 문서 편집을 검증한다.
6. `npm test` 전체를 통과시킨 뒤 새 local commit에서 candidate tarball/manifest를 만든다. `package.json` files allowlist에 새 테스트 및 필요한 helper만 추가하고, feature runner가 정확한 file set을 설치 test에 전달하는지 검증한다. 동일한 tarball SHA와 manifest로 설치 Linux release feature matrix와 native Windows runner의 전체 matrix를 통과시킨다. Runner 결과에 E01/E02가 개별로 표시되어야 하며, exact allowlist 밖 skip/null/unknown result는 통과로 보지 않는다.

## 실제 Agent 검증

- 실제 Windows Codex app은 final candidate의 default installed hook command를 그대로 사용한다. 임시 설정을 수동으로 whitespace-free control command로 편집하지 않는다. 격리된 temporary home/prefix/provider root/project에서 `SessionStart`의 관련 문맥, `UserPromptSubmit`, 실제 tool 실행, 명시적 기존 Markdown page edit, `Stop`, safe envelope와 닫힌 turn state, 원본 source 보존을 확인한다. expected/actual tarball digest와 installed tree가 같아야 시작한다.
- 실제 OpenCode app은 non-Git 임시 project에서 `directory`가 worktree fallback보다 우선해 올바른 context를 제공하는지 확인한다. 모델이 새 durable page를 만들지 않고 지정된 기존 문서를 바꾸며 raw query/transcript는 저장하지 않는지 검사한다.
- 실제 앱용 임시 profile은 user/global hooks나 settings를 교체하지 않는다. 동일 provider owner의 정상 로그인/계정 복구는 이미 승인된 범위에서 수행할 수 있다. Browser/MFA 등 외부 상호작용이 필요할 때에만 해당 사용자 action이 pending이다. Auth file/token은 복사·export·출력·보고서에 기록하지 않고, 다른 provider/API credential 또는 새 console/billing 설정을 사용하지 않는다. Claude auth가 준비되지 않으면 `AUTH_BLOCKED`로 남기며 이 코드 수정의 성공/실패에 합산하지 않는다.
- 기록은 redacted 결과, event 종류/개수, file hash/boolean과 명시적 pass/fail만 포함한다. 전체 stdout/stderr, prompt/transcript, auth settings, private hook logs는 artifact나 wiki로 복사하지 않는다.

## 검토와 release gate

1라운드와 2라운드 모두 shell/command, hook lifecycle/ownership, auth/provenance의 독립 reviewers 세 명이 검토했다. 2라운드는 조건부 수용했다. Main의 최종 v3는 explicit redirected streams proof를 implementation gate로 두었지만, 이후 main-run native Node child bootstrap probe가 direct Node, CMD, Windows PowerShell 5.1, PowerShell 7에서 정확한 binary/stdin/stdout/stderr/exit `17`을 통과했다. 이에 따라 main final v4는 PowerShell bridge를 채택하지 않고 Node bootstrap을 선택한다. Ownership/lifecycle, mixed user/kit preservation, 7,000/8,191 command bounds, exact E01/E02 packaged tests와 OS-only skip, local-only provenance 조건은 유지한다. Reviewer 원문 대신 이 결정과 검증 범위만 기록한다.

후속 main source review는 두 integration 누락을 추가로 확정했다. 첫째, current expected matcher의 unambiguous owned command는 user siblings를 보존하며 in-place 갱신할 수 있고, no-sibling 조건은 legacy default matcher를 current default로 normalize할 때만 적용한다. Duplicate `--replace-hooks` reconciliation은 non-command metadata 및 nested fields가 동일한 pure-owned entries로 한정하며, uninstall은 custom matcher를 이유로 proven owned command를 남기지 않지만 ambiguous mixed object는 통째로 보존한다. 둘째, nested install warning/provider-partial 결과가 human CLI에 `installed` 성공으로 끝나지 않게 `src/cli.js`/`src/cli-format.js`가 기존 JSON warning/partial state를 유지하고 exit 1을 반환하며 `src/doctor.js`/status가 stale/unmanaged와 missing을 구분한다. JSON에 새 `incomplete` field나 CLI flags를 추가하지 않는다. 이는 hook ownership 결과를 사용자에게 전달하는 필수 연결이다.

최종 plan v7은 다음 경계도 명시한다. Status JSON은 기존 fields를 유지하고 `codexStaleEvents`/`claudeStaleEvents`만 additive로 제공하며 `incomplete: true`를 새로 추가하지 않는다. Install setup failure는 기존 provider warning/partial state와 nonzero exit로 나타난다. Packaged native test는 generated command를 Windows PowerShell 5.1과 CMD에서 필수 실행하고 PowerShell 7/Bash는 있으면 보조 실행한다. 별도의 parent-run direct-Node/CMD/PowerShell 5.1/PowerShell 7 probe는 이미 통과했으나 packaged-test host contract와 혼동하지 않는다. `test/uninstall-safety.test.js`가 matcher-edited uninstall 및 user-field preservation 회귀를 포함한다.

Native probe는 direct Node, CMD, Windows PowerShell 5.1, PowerShell 7에서 outer bare `node.exe -e` bootstrap이 exact child Node binary를 호출하고 stdin/stdout/stderr bytes와 exit `17`을 보존함을 확인했다. 이 결과는 launcher 선택 gate를 통과시킨다. 이전 PowerShell bridge probe는 synthetic stderr byte-preservation을 통과하지 못해 선택하지 않았다. 원시 probe 출력은 저장하지 않았다. Default generated command를 쓰는 installed Windows Codex actual-app E2E와 new exact tarball release verification은 여전히 남아 있다. Provider 실행 환경의 PATH 검색이 installer에서 실행한 Node와 같다고 보장하지 않으므로 absolute bootstrap resolution을 주장하지 않으며, actual-app runner가 provider의 최종 command를 확인한다. 이미 반영된 OpenCode directory-first 수정은 이 Windows launcher와 별개다.

최종 후보는 0.26.0의 새 local commit에서 clean clone과 기존 `scripts/release/create-manifest.mjs` 규칙으로 pack한다. Local provenance smoke는 clean clone의 `origin`이 `/apps/llm-wiki-kit` local repository를 가리킬 때 actual local `git ls-remote` branch ref와 source SHA 일치를 확인할 수 있다. 이를 local-only evidence로 기록하고 public GitHub pushed SHA로 표현하지 않는다. Helper가 실제 remote ref와의 일치를 요구하면 그 검사를 약화하거나 우회하지 않는다. Public pushed-SHA 확인은 별도 push authority 이후의 gate다. 동일한 final tarball/manifest bytes로 Linux와 native Windows를 다시 검증하고, tarball/source가 바뀌면 두 플랫폼과 실제 app checks를 반복한다. Local candidate verification은 public registry release 승인이 아니다.

Implementation 후에는 의도된 파일 경로만 명시적으로 stage해 주제별 local commit을 만들 수 있다. 이 요청은 local fix와 검증을 승인하지만 push, tag, npm publish, global install 및 실제 user/global provider settings 수정은 승인하지 않았다. 별도 명시 요청 전에는 수행하지 않는다. Public release를 요청하는 경우 clean pushed source SHA, strict manifest, 동일 tarball의 양 플랫폼 installed checks, 실제 app gate와 registry install smoke가 별도 충족되어야 한다.

## 완료 기준

- Windows Codex와 Claude의 default installed command가 native integration test를 통과하고 old kit command가 update로 현재 형식에 migration된다. User hooks, metadata, stdin/stdout/stderr, CWD와 child exit code를 보존한다.
- Nested provider install warnings and provider-partial state reach human and existing JSON output; setup failure returns exit 1 without adding a new JSON `incomplete` field. `status` distinguishes stale/unmanaged from missing without adding or changing CLI flags.
- OpenCode 비-Git root regression이 source/installed test를 통과하고 실제 app context path가 올바른 directory에서 끝난다.
- focused tests와 full `npm test`가 실패 0이며 source/installed/native test의 skip은 이유와 플랫폼을 분명히 기록한다.
- same exact candidate tarball/manifest가 Linux와 native Windows package matrix를 통과한다. 실제 Windows Codex default launcher E2E가 확인되기 전에는 Windows installed agent compatibility를 완료로 선언하지 않는다. Claude auth 차단은 별도 limitation으로 기록한다.
- Public push/publish는 별도 권한을 기다린다. 동일 provider의 정상 login/recovery는 위에서 정한 승인 범위이며, Browser/MFA 등 외부 사용자 작업만 pending으로 둔다. Token 복사/내보내기, 다른 provider/API key, 새 console/billing 설정은 수행하지 않는다.
