open-multi-agent-kit 0.98.3 → 0.98.5

package/docs/adaptorch-onboarding.md

@@ -0,0 +1,80 @@
+# OMK / WPL → AdaptOrch 안내
+
+AdaptOrch는 OMK와 별개의 선택적 서비스입니다. OMK와 MIT 라이선스의
+`omk-adaptorch-wpl` 사용에 가입이나 유료 플랜은 필요하지 않습니다.
+이 경로는 웹사이트 방문을 돕는 CRM 유입 경로이며, 계정 생성이나 리드 저장을
+대신 수행하는 CRM 클라이언트가 아닙니다.
+
+## CLI에서 시작
+
+```bash
+omk doctor adaptorch --links
+omk doctor adaptorch --links --json
+```
+
+`--links`는 API 키 없이 작동합니다. 환경의 API 키나 API URL을 읽거나 검증하지
+않으며, HTTP 요청·브라우저 열기·파일 저장·run 제출을 하지 않습니다.
+JSON 출력의 `mode: "links"`, `networkAccess: false`, `accountRequired: false`는
+이 **로컬 안내 명령**의 상태입니다. 웹사이트의 요금이나 가입 조건을 뜻하지 않습니다.
+
+| 행동 | 목적지 | 용도 |
+| --- | --- | --- |
+| Plans / local Starter | `https://adaptorch.com/#pricing` | 로컬 평가와 호스티드 플랜 비교 |
+| Sign up | `https://adaptorch.com/app/signup` | 사용자가 직접 가입 |
+| Team / private-runner contact | `https://adaptorch.com/#bookDemo` | 팀·사설 러너 상담 |
+| Claim boundary | `https://adaptorch.com/claim-boundary` | 검증 범위와 한계 확인 |
+
+실제 출력 URL에는 아래의 고정 UTM 태그가 붙습니다. 사용자가 링크를 열면 해당
+태그가 웹사이트로 전달됩니다. OMK 자체는 클릭을 관찰하거나 추적 요청을 보내지 않습니다.
+
+계정을 만든 뒤 API 연결을 확인하려면 키를 안전하게 설정하고 별도로 실행합니다.
+
+```bash
+omk doctor adaptorch
+omk doctor adaptorch --json
+```
+
+이 명령은 설정된 API의 `GET /v1/whoami`에 인증 요청을 보냅니다.
+종료 코드 `0`은 API 인증 성공, `1`은 미설정, `2`는 잘못된 설정이나 연결 실패입니다.
+인증 성공은 코드 검증, WPL 자동 실행, 배포 승인을 뜻하지 않습니다.
+`--links`의 성공 종료 코드는 API 연결 여부와 무관합니다.
+
+## WPL 소비자에서 사용
+
+```typescript
+import { getAdaptOrchLinks } from "omk-adaptorch-wpl";
+
+const links = getAdaptOrchLinks(); // 기본 표면: wpl
+// 사용자가 요청한 도움말이나 별도 제품 안내 화면에서 렌더링합니다.
+console.log(links.plans, links.signup, links.contact, links.claimBoundary);
+```
+
+`getAdaptOrchLinks("doctor")`는 CLI 유입용입니다. 함수는 매번 독립적인 링크 객체를
+반환하고 네트워크·환경 변수·사용자 파일에 접근하지 않습니다.
+링크를 판정 카드의 `next_actions`나 서명된 receipt에 삽입하지 마세요.
+가입·결제 여부는 `canApply`, `shouldSubmit`, 사람 검토 요구를 바꾸지 않습니다.
+
+## CRM 유입 구분과 개인정보 경계
+
+- `utm_source=omk`
+- `utm_campaign=omk-adaptorch-wpl`
+- CLI: `utm_medium=cli`, `utm_content=doctor-{action}`
+- WPL: `utm_medium=library`, `utm_content=wpl-{action}`
+- `{action}`: `plans`, `signup`, `contact`, `claim-boundary`
+
+허용된 값만 사용합니다. 이메일, API 키, 프롬프트, diff, 저장소 경로, 세션 ID,
+run ID를 URL에 추가하지 않습니다. 가격은 코드에 고정하지 않고 웹사이트가 소유합니다.
+
+사이트 운영 측에서는 사용자 동의와 개인정보 처리 정책에 따라 UTM 보존,
+가입 완료·상담 제출·활성화 이벤트를 연결해야 합니다. 이 변경은 해당 서버의
+CRM 저장, 이메일 발송, 결제, 전환율을 구현하거나 검증하지 않습니다.
+단순 링크 생성 횟수를 방문자 수나 가입 전환으로 집계하면 안 됩니다.
+
+## 검증과 관련 문서
+
+- `test/adaptorch-onboarding.test.ts`: 키 미접근, HTTP 미호출, 옵션 순서, JSON 계약
+- `test/adaptorch-doctor-cli.test.ts`: 기존 연결 검사와 종료 코드 회귀
+- `packages/adaptorch-wpl/test/service-links.test.ts`: 공개 export, 고정 목적지·UTM, 임의 입력 거부
+- [Correctness Wall](correctness-wall.md): 적용·제출 게이트
+- [AdaptOrch Preview](adaptorch-preview.md): 계획과 실제 실행 구분
+- [하네스 개선 우선순위](harness-improvements.md): 이번 점검 범위와 후속 과제

package/docs/containerization.md

@@ -22,6 +22,18 @@ There are two general isolation options:
 1. run the whole `omk` process inside an isolated environment, or
 2. run `omk` on the host and route tool execution into an isolated environment.
 
+### Policy composition
+
+`mergeSandboxPolicy(base, override)` keeps the stronger enforcement mode and accepts
+only a root inside the base root. An override cannot silently turn `enforce` into
+`audit`/`off` or move the workspace elsewhere. Broader mode/root changes require the
+trusted caller's explicit `{ allowBroaden: true }`; the flag is not user authentication.
+These pure policy checks do not replace backend enforcement or isolate extension code.
+
+Evidence configuration also fails closed: `FailClosedMergeGate` rejects empty,
+sparse, or invalid gate lists and snapshots the supplied array. Later changes to
+that array cannot remove the checks. This does not authenticate arbitrary gate code.
+
 ## Choose a pattern
 
 | Pattern | What is isolated | Best for | Notes |

package/docs/context-files.md

@@ -0,0 +1,97 @@
+# User context setup
+
+OMK's shared defaults are provider-neutral, editable markdown. They do not ship
+an operator's personal configuration, install skills, or enable external services.
+
+## Initialize an installed OMK
+
+```bash
+omk init --global --dry-run
+omk init --global
+```
+
+The first command previews the operation without creating even the target directory.
+The second creates missing documents in `~/.omk/agent/`. Both are offline and return
+before migrations, settings, credentials, sessions, extensions, and model startup.
+There is no install hook: installing or updating the npm package does not alter
+user instructions, including when installed with `--ignore-scripts`.
+
+Choose another user config directory with the existing environment override:
+
+```bash
+OMK_CODING_AGENT_DIR="/path/to/omk-config" omk init --global --dry-run
+OMK_CODING_AGENT_DIR="/path/to/omk-config" omk init --global
+```
+
+Use the same override when starting OMK. PowerShell users can set
+`$env:OMK_CODING_AGENT_DIR` before running the commands. Paths with spaces and
+non-ASCII characters are supported. The destination must be a real directory,
+not a file or symlink; parent directories should be trusted and user-controlled.
+New files use owner-only permissions on POSIX. Existing directory modes are unchanged.
+
+`--global` is required; `init` without a scope or with unsupported flags exits `2`.
+`--help` exits `0`. Setup and preservation succeed with `0`; file or template errors
+exit `1`. `--offline` is accepted but not needed for this command.
+
+## Documents and loading
+
+| File | Purpose | Loading |
+| --- | --- | --- |
+| `AGENTS.md` | Work, verification, permissions, skills, runtime identity | Preferred global context entry point |
+| `INTERNET.md` | Source selection, freshness, citations, network permissions | Read on demand when web work is needed |
+| `CLAUDE.md` | Thin interoperability entry point referring to `AGENTS.md` | OMK fallback; another host needs explicit configuration |
+
+OMK's entry-point search order within each directory is `AGENTS.md`, `AGENTS.MD`,
+`CLAUDE.md`, then `CLAUDE.MD`; only the first readable file is used. Global context
+loads before ancestor and working-directory context. Markdown links and Claude Code
+`@` imports are not expanded by OMK. `INTERNET.md` and `SOUL.md` are not automatically
+loaded by filename. The starter `AGENTS.md` tells the agent to read `INTERNET.md`
+when relevant, so ordinary coding tasks do not carry the whole web guide.
+
+Existing compatibility files `AGENTS.override.md`, `AGENTS.GODMODE.md`, `GODMODE.md`,
+and `ENI.override.md` are also discovered in global and ancestor directories.
+Setup does not generate, import, modify, or delete them. Review old files yourself
+when migrating: installing a new guide does not retire an old override.
+
+`--no-context-files` disables discovery. Claude models inside OMK omit discovered
+context by default; `OMK_CLAUDE_CONTEXT_FILES=1` restores it. Setup does not change
+that provider behavior or write the environment override. See [Usage](usage.md#context-files)
+and [Environment variables](environment-variables.md).
+
+## Preserve and customize
+
+- No `--force` or automatic overwrite mode is provided. Re-running setup preserves
+  existing files, including symlinks and directories at a document filename.
+- If any case variant of `AGENTS.md` or `CLAUDE.md` already exists, setup skips both
+  entry-point templates. This avoids shadowing a Claude-only or uppercase setup,
+  and avoids a new compatibility import pointing to the wrong filename.
+- A missing `INTERNET.md` can still be created. Any existing case variant is preserved.
+- `settings.json`, authentication, models, MCP configuration, installed packages,
+  skills, shell profiles, other hosts' directories, and project files are untouched.
+- Required templates are read before writing. An I/O failure while writing can leave
+  earlier files created; setup is not a multi-file transaction. Review the output
+  before retrying. Exclusive file creation prevents overwriting a concurrent file.
+
+Back up existing documents before manually merging the defaults. Put project commands
+in the project's `AGENTS.md`, local preferences in your global file or
+`AGENTS.override.md`, and no credentials in either. Keep changes small and reload
+with `/reload` or restart OMK. Already-recorded conversation text is not erased by reload.
+
+For optional user-installed skills and `defaultActiveSkills`, see [Skills](skills.md)
+and [Settings](settings.md). Neither a skill nor a markdown policy grants tool access.
+
+## Distribution and interoperability
+
+The templates live in [`examples/context/`](../examples/context/) inside the package.
+Existing npm `files` and binary asset-copy rules include `examples/`; the initializer
+resolves that directory from the installed package, not from a developer's checkout.
+`OMK_PACKAGE_DIR` retains its documented package-root override.
+
+The same templates can be reviewed and copied manually from a source checkout.
+`CLAUDE.md` uses a sibling `@AGENTS.md` import for Claude Code, but OMK does not install
+it into `~/.claude/`. Opt into sharing from that host with an import to the actual
+file path. Other hosts retain their own tool names, hooks, permission model, and
+configuration; using a Claude model in OMK is not running Claude Code.
+
+Public defaults are authored in the repository. Do not create a distribution by
+copying a maintainer's agent home, credentials, private skills, or session history.

package/docs/correctness-wall.md

@@ -25,6 +25,14 @@ Structured next steps on the verdict card: **Apply**, **Deep Check**, **Regenera
 
 **Can apply** vs **should submit** are separate gates on the verification receipt: mechanical apply safety is not the same as trusting downstream submission.
 
+`shouldSubmit` is fail-closed: it requires `canApply`, non-preview evaluation,
+non-empty run IDs, and `CONFIRMED` outcome adjudication. Missing evidence,
+verifier errors, corroborated failures, and previews never authorize submission.
+If a deep check was requested, it must also complete. Its evidence must carry
+non-blank digest and command values and exit code `0`; completion cannot clear
+an existing policy requirement for human review. Local apply policy is unchanged.
+These are evidence gates, not release, merge, or deployment authorization.
+
 ## Fast wall vs deep wall
 
 - **Fast wall (default):** Pure policy — diff paths, scope globs, secret-shaped lines, preview-only limits (`BATCH1_NO_DOCKER_RUNNER`). No Docker runner in batch 1.

package/docs/custom-provider.md

@@ -238,6 +238,37 @@ For Anthropic-compatible providers using `api: "anthropic-messages"`, set `compa
 > Use `mistral-conversations` for native Mistral models.
 > If you intentionally route Mistral-compatible/custom endpoints through `openai-completions`, set `compat` flags explicitly as needed.
 
+### ChatGPT Web through codex-chatgpt-web
+
+[codex-chatgpt-web](https://github.com/miuuyy/codex-chatgpt-web) runs a loopback Responses bridge (`http://127.0.0.1:17841/v1`) that drives a signed-in ChatGPT Web session from its own launcher. It was written for the Codex CLI, so it refuses a turn that lacks Codex's `client_metadata["x-codex-turn-metadata"]` (`thread_id`, `turn_id`) and the matching `turn_id` on the current user item. Set `compat.sendCodexTurnMetadata: true` on an `openai-responses` provider and OMK sends both: `thread_id` is the OMK session id and `turn_id` is derived from the latest user message, so tool rounds replay the same id and the next prompt starts a new browser turn.
+
+```json
+{
+  "providers": {
+    "codex-chatgpt-web": {
+      "baseUrl": "http://127.0.0.1:17841/v1",
+      "api": "openai-responses",
+      "apiKey": "codex-chatgpt-web",
+      "compat": { "sendCodexTurnMetadata": true },
+      "models": [
+        { "id": "chatgpt-web/high", "name": "ChatGPT Web — High", "reasoning": true, "input": ["text", "image"], "contextWindow": 80000, "maxTokens": 32768 },
+        { "id": "chatgpt-web/pro", "name": "ChatGPT Web — Pro", "reasoning": true, "input": ["text", "image"], "contextWindow": 95000, "maxTokens": 32768, "thinkingLevelMap": { "max": "max" } }
+      ]
+    }
+  }
+}
+```
+
+The bridge ignores the bearer value for `chatgpt-web/*` models (the browser session is the credential), so any placeholder key satisfies OMK's key check. Each `chatgpt-web/*` id pins one ChatGPT mode (`luna`, `think`, `light`, `medium`, `high`, `extra-high`, `pro`, plus `zero-risk` / `zero-risk-pro` for the launcher's manual mode); the bridge fixes the effort per id and ignores the request's `reasoning.effort`, and `pro`/`extra-high` fail explicitly unless the signed-in account exposes them. In the launcher's browser-only mode the model cannot call OMK tools; full mode routes tool calls back through the bridge's MCP connector.
+
+OMK's coding-agent supplies its resolved session cwd as a trusted `workspace-write` Codex environment when this compatibility flag is enabled. Direct `omk-ai` callers must pass an absolute `options.cwd` to enable Full harness tools; an absent or relative cwd deliberately carries no filesystem authority, so Full mode fails closed. Bridge 5.0.x binds that environment to the turn metadata (`sandbox`, `workspaces`) and the adjacent `<environment_context>` item; OMK emits exactly that pair, verified against launcher 5.0.4 in full mode with a tool round trip.
+
+**Keep the rows in step with the launcher.** The bridge's `/v1/models` document is the only account-aware source, and it publishes two numbers per row: `context_window` is the ceiling past which the bridge rejects a turn, and `auto_compact_token_limit` is the budget it expects a client to compact within (Codex's effective window, 85% of the ceiling). OMK's `contextWindow` drives OMK's own compaction policy (`compaction.maxUsageRatio`, default 0.9, plus output reserves), so the row carries the **budget**: `contextWindow: 80000` above is the launcher's Plus High budget under a 90,000 ceiling, `95000` the Pro budget (ceiling 111,193, or 112,193 for `chatgpt-web/pro`), and a Pro account with Bigger Context advertises 285,000 under 333,579 / 336,579. With the budget in place OMK compacts at about 90% of it, comfortably inside what the bridge accepts. `omk provider sync codex-chatgpt-web` reads the document and rewrites the provider's `chatgpt-web/*` rows (`name`, `contextWindow`, `reasoning`, `input`), preserving `maxTokens`, `cost`, `thinkingLevelMap`, other keys, other providers, and the file's indentation, and records where the numbers came from as `bridgeCatalog` on the provider (`bridgeVersion`, `clientVersion`, `syncedAt`, and each row's `contextCeilings`). `--dry-run` reports the drift without writing and `--json` emits one document; a launcher upgrade or a changed ceiling is recorded even when no row moves. The bridge forwards `/v1/models` to the Codex backend, so the command authenticates with OMK's `openai-codex` OAuth (`/login openai-codex`) and sends a `client_version` (`--client-version`, `OMK_CODEX_CLIENT_VERSION`, `codex --version`, then OMK's last verified version): the backend hides models from clients it considers too old. `omk provider doctor codex-chatgpt-web --level 1` reports the `models-endpoint` probe as failed for this bridge because it probes with the placeholder bearer; use `provider sync --dry-run` as the bridge health check instead.
+
+Effort is chosen by the slug, not by OMK's thinking level: `chatgpt-web/pro` runs every turn at ChatGPT's Pro effort (verified on launcher 5.0.4: the browser trace records the effort control switching to a distinct label for medium, high, and pro turns), so pick the `pro` row when you want the maximum. The response length is not capped by OMK either: the bridge accepts `max_output_tokens` but never applies it to a browser turn, so `maxTokens` only sizes OMK's own compaction-summary and context-governor budgets.
+
+When the launcher is not running, a turn on a bridge model fails with a message that names the launcher instead of the SDK's generic connection error.
+
 ### Auth Header
 
 If your provider expects `Authorization: Bearer <key>` but doesn't use a standard API, set `authHeader: true`:
@@ -721,6 +752,10 @@ interface ProviderModelConfig {
     thinkingFormat?: "openai" | "openrouter" | "deepseek" | "together" | "zai" | "qwen" | "qwen-chat-template";
     cacheControlFormat?: "anthropic";
 
+    // openai-responses
+    sendSessionIdHeader?: boolean;
+    sendCodexTurnMetadata?: boolean;
+
     // anthropic-messages
     supportsEagerToolInputStreaming?: boolean;
     supportsLongCacheRetention?: boolean;

package/docs/development.md

@@ -56,11 +56,36 @@ Never use `__dirname` directly for package assets.
 ## Testing
 
 ```bash
-./test.sh                         # Run non-LLM tests (no API keys needed)
-npm test                          # Run all tests
-npm test -- test/specific.test.ts # Run specific test
+./test.sh                         # Run the non-LLM suite when a full run is intended
+# Narrow, offline regression from the repository root:
+LIVE_E2E=0 node node_modules/vitest/dist/cli.js --run packages/coding-agent/test/adaptorch-onboarding.test.ts
 ```
 
+The root `vitest.config.ts` delegates to each package's Vitest project. This
+preserves package-local setup files and source aliases; a root invocation must
+not silently test stale `dist` dependencies. The coding-agent project resolves
+`omk-adaptorch-wpl` to its source entrypoint during tests.
+
+Package-local targeted commands continue to work, for example from
+`packages/coding-agent`:
+
+```bash
+LIVE_E2E=0 node ../../node_modules/vitest/dist/cli.js --run test/adaptorch-onboarding.test.ts
+```
+
+Keep explicit file filters for routine work. A keyless regression pass is not a
+live-provider or release verification, and unfiltered suites may include e2e tests.
+
+## Commit checks
+
+The pre-commit hook validates the working tree without changing the selected
+index. It never auto-stages checker edits or unstaged hunks. If a checker changes
+the index, the hook fails and asks you to review the selection again; it does not
+restore or discard those changes. The checks still run against the working tree,
+not an isolated staged snapshot, so review partially staged changes separately.
+
+Hook regression: `node --test scripts/test/pre-commit-index.test.mjs`.
+
 ## Project Structure
 
 ```

package/docs/environment-variables.md

@@ -82,6 +82,8 @@ These variables are read by OMK itself. The four built-in harness flags below ar
 | `OMK_SKIP_VERSION_CHECK` | Disable the latest-version request |
 | `OMK_TELEMETRY` | Override install/update telemetry and provider attribution headers: `1`/`true`/`yes` or `0`/`false`/`no` |
 | `OMK_SHARE_VIEWER_URL` | Override the base URL used by `/share` |
+| `PI_DISABLE_INPUT_REDACTION` | Stop masking credentials on the way to the model and the session. Persistence and report boundaries still mask |
+| `OMK_DISABLE_REDACTION` | Alias for the input-redaction opt-out when `PI_DISABLE_INPUT_REDACTION` is unset. Only `1`/`true`/`yes`/`on` enable it. Forced persistence/report redaction remains active; this does not disable masking everywhere |
 | `OMK_HARDWARE_CURSOR` | Set to `1` to show the hardware cursor; see [Terminal setup](terminal-setup.md) |
 | `OMK_CONTEXT_GOVERNOR` | Context Budget V2 process override: `1` forces it on and `0` forces it off; otherwise the global `contextBudget.enabled` setting applies |
 | `OMK_CONTEXT_GOVERNOR_CACHE` | Set to `memory` to keep representations, negative results, and plans in session memory instead of persisting representations per workspace |

package/docs/grok-harness.md

@@ -68,6 +68,10 @@ Do not select `grok-imagine-image`, `grok-imagine-image-quality`, `grok-imagine-
 
 Use the normal OMK lane grant model: grant the smallest skill and MCP surface that matches the task, and keep media exceptions explicit.
 
+For each non-queued native `xai` request started through `AgentSession.prompt()`, OMK calls `selectGrokHarnessSkills()` against the live discovered skill descriptions after ordinary prompt-template expansion. It merges up to three matches with explicit/settings selections and rebuilds that turn's `<active_skills>` marker.
+
+The pure `selectSkills()` scorer uses the task plus independent camelCase-aware path-to-skill-name signals, weak 0.35 / strong 0.7 thresholds, deterministic input-order ties, and first-name-wins deduplication. Explicit-only skills are never auto-selected. `headroom` is added only for lexical pressure cues or the session's measured context-pressure bucket. A task with no signals yields an empty automatic grant rather than the full allowlist. Messages queued through `steer`, `followUp`, or `prompt(..., { streamingBehavior })` retain the active run's system prompt; they do not trigger a second skill-selection rebuild.
+
 | Task class | Skills | MCP |
 | --- | --- | --- |
 | Multi-package or repo-context work | `packages`; add `headroom` only under context pressure | none by default |

package/docs/harness-boundaries.md

@@ -0,0 +1,154 @@
+# 벤치마크 실패에서 다시 나눈 하네스 책임
+
+2026-09-09. 대상은 Terminal-Bench 2.1의 **중단된 Flash 24-task 개발용 비교**다.
+새 오케스트레이터를 추가하는 대신, 기존 런타임에서 입력·권한·실행·완료 판정의 책임을
+분리한다. 이 문서는 구현한 경계와 후속 설계를 구분하며 성능 우위를 주장하지 않는다.
+
+## 1. 무엇을 고쳐야 하는가
+
+비공개 실행 `tb21-flash24-20260908T151234Z-pYN3`의 결과·요청 원장·세션 메타데이터를
+읽기 전용으로 재집계했다. 고정 dataset SHA는 `5c8eadf1f393183288fa08b8f73ca9a469cc5e00`,
+실행 소스 HEAD는 `29624c3962d00cc8355191265e7827d9fdf0f3ad`다. 실행에는 미커밋 코드가
+포함됐으므로 HEAD만으로 실행물을 재현할 수 없다. 실행 manifest의 파일 해시가 별도로 필요하다.
+
+| 관측 | 확인된 사실 | 설계 결정 |
+| --- | --- | --- |
+| 완료 범위 | 43/48시행. A 21개, B 22개 | 같은 21쌍만 비교. 미완료 5개를 실패·성공으로 채우지 않음 |
+| 같은 21쌍 해결 | OMK 7, Terminus-2 10 | 최종 24개 점수나 공식 순위가 아님 |
+| OMK 비정상 종료 4건 | 모두 `read`의 image 결과 다음 공급자 계약 거부 | 도구 관측값이 모델 선택을 변경하지 않게 함 |
+| 시간 초과 | OMK 4, Terminus 3 | 원인별 시간 분해 뒤에만 deadline 정책 변경 |
+| 같은 21쌍 요청 | OMK 574, Terminus 617 | 이전 Pro 실험의 요청 증폭 결론을 그대로 재사용하지 않음 |
+| 같은 21쌍 기록된 입력 토큰 | OMK 9,523,530, Terminus 22,752,932 | 토큰 감소만으로 품질·비용 개선을 판정하지 않음 |
+| 동일 tool 인수 반복 | OMK 완료 시행에서 최대 3회 | 반복 차단 임계값을 일괄 낮출 근거 없음 |
+| 중단 상태 | 소유 프로세스가 없는데 `state.json`은 running | supervisor 상태와 살아 있는 실행 소유권을 분리 |
+| 별도 WSL 측정 | OMK 8세션과 자식 프로세스 PSS 약15.8GiB, SwapPSS 약6.4GiB | MCP 시작 전 자원 입장 제어가 필요. benchmark만의 점유량이 아님 |
+
+이미지 실패 4건은 자동 라우팅→계약 거부까지 확인한 인과 경로다. 아래 수정으로 그
+종료 원인을 없애도 네 task가 해결된다는 뜻은 아니다. 시간 초과 중 `tune-mjcf`의
+기록된 gateway 시간은 약120초, `db-wal-recovery`는 약712초였다. 나머지 시간을 모두
+도구 낭비라고 추정하지 않는다. 대기·tool·검증·호스트 압박 측정이 더 필요하다.
+
+## 2. 선택한 구조
+
+```text
+원본 session / tool artifact                         [보관·재생]
+              │
+사용자가 선택한 모델 + 명시적 사용자 첨부             [모델 선택]
+              │
+ProviderInputProjection                             [전송 표현]
+  ├─ 지원하는 입력: 유지
+  └─ text-only + tool image: 명시적 미관측 안내
+              │
+ModelContract → provider-specific payload check      [허용·거부]
+              │
+SDK/provider → tool execution → 실행 관측             [실행]
+              │
+classifyRunTermination → durable run journal          [시도 종료]
+              │
+prompt_settled (retry·continuation 종료 후)            [프롬프트 종료]
+              │
+CLI exit status ── text / JSON renderer               [보고]
+```
+
+원본 보관은 입력 변환과 별개다. 계약 검사는 입력을 해석하거나 임의 모델을 선택하지 않는다.
+`agent_end`는 재시도 전의 시도 종료일 수 있으므로 CLI의 최종 판정으로 바로 쓰지 않는다.
+종료 코드 0이나 `prompt_settled=completed`도 외부 verifier의 해결 판정과는 다르다.
+
+선행연구는 [SWE-agent의 ACI 연구](https://arxiv.org/abs/2405.15793v3)의 초록을 확인했다.
+모델과 도구 사이의 인터페이스를 먼저 고친다는 방향의 참고 자료이며, 이 변경의 구현
+세부사항이나 TB 성능 이득을 증명하는 자료가 아니다. 새 학습형 라우터·judge·앙상블은
+이번 실패 원인을 해결하지 않으므로 추가하지 않는다.
+
+## 3. 이번에 구현한 경계
+
+### 입력 표현: provider-input.ts
+
+`packages/agent/src/provider-input.ts`는 `projectToolImagesForModel()`을 제공한다.
+계약이 있는 core/SDK 경로에서만 사용한다.
+
+- text-only 모델의 `toolResult` 이미지 블록만 텍스트 안내로 바꾼다. 시각 내용을
+  추측하거나 OCR 결과를 만들어 내지 않는다.
+- 기존 text, tool-call ID, 오류 여부와 순서를 유지한다. 원본 세션의 image는 수정하지 않는다.
+- 현재 모델이 이미지 입력을 지원하면 그대로 전송한다. 사용자 첨부는 자동 제거하지 않는다.
+- 계약 모드에서는 **tool 이미지로 자동 vision 모델을 선택하지 않는다**. 사용자 이미지가
+  있는 경우는 기존 vision 라우트를 검사하고, 허용된 vision 모델이면 모든 첨부를 유지한다.
+- 계약 없는 일반 제품 경로는 기존 자동 vision 라우팅을 유지한다.
+- core의 `provider_request.omittedToolImages`는 해당 요청에서 생략한 이미지 수다.
+  누적 제거량이나 이미지 해석 성공률이 아니다. SDK 요약은 동일 변환을 쓰지만 아직 이
+  core 사건 원장의 소비자가 아니므로 별도의 완전한 요청 원장으로 주장하지 않는다.
+
+이는 원본 이미지 메모리를 줄이는 변경이 아니다. read producer의 decode/resize나
+세션 내 base64 저장을 없애지 않았다. 그 부분은 아래 artifact-reference 후속 단위다.
+
+### 원인 분류: session-run-termination.ts
+
+기존 `AgentSession`의 종료 원인 분류를 별도 순수 함수로 옮겼다. 세션 수명주기와
+원장 append 책임은 그대로 두고, 시계·모델·관측된 거부/timeout을 분류기에 전달한다.
+
+`provider_denied(contract-violation)`가 관측된 core run은 문자열 추측보다 먼저
+`configuration.invalid`, `retryable=false`로 분류한다. 계약을 완화하거나 다른 모델로
+전환하는 재시도는 추가하지 않는다. 다음 run에서 원인을 초기화한다.
+이전 로그의 `retryable=true`는 잘못된 안내였으며, 그것만으로 실제 재시도 지출이
+발생했다고 주장하지 않는다. SDK/사용자 정의 stream의 모든 오류까지 이 사건으로
+변환한 것은 아니다.
+
+### CLI 결과: print-mode.ts
+
+최종 실패 판단은 renderer 바깥에 둔다. 각 `session.prompt()`가 끝난 뒤
+`prompt_settled` 결과를 확인한다. 이 사건이 없는 호환 경로에서는 해당 프롬프트의
+assistant error/abort와 typed termination을 확인한다.
+
+text와 JSON 모두 실패 시 종료 코드 1을 반환하고 후속 CLI 프롬프트를 실행하지 않는다.
+내부 재시도에서 한 번 실패했어도 최종 settlement가 성공이면 실패로 고정하지 않는다.
+실행 전부터 존재하던 이전 termination을 새 프롬프트의 실패로 재사용하지 않는다.
+
+## 4. 다음 고도화: 작은 독립 단위로 구현
+
+아래는 **설계이며 아직 구현하지 않았다**. 이번 실행이나 기본 설정에 몰래 적용하지 않는다.
+
+| 단위 | 기존 책임과 연결 지점 | 수용 기준·중단 기준 |
+| --- | --- | --- |
+| H1: 실행 소유권·재개 | benchmark supervisor, `run-journal-store.ts` | PID뿐 아니라 boot ID+process start+heartbeat로 소유권 식별. 중단 시 미확정 요청·원본 결과 보존. 재시도는 새 attempt이며 사용자 승인 필요 |
+| H2: 공유 시간 예산 | prompt 수명주기, provider signal, `tool-timeout.ts` | 단조 시계 deadline 하나를 모든 대기에 전달. 남은 예산에서 검증·정리 시간을 예약. queue/model/tool/cleanup 구간 측정; fake-clock·child 종료·부분 결과 보존 검사 통과 전 활성화 금지 |
+| H3: artifact-reference 입력 | read producer, 세션 저장, provider-input | 큰 이미지/출력을 파일·digest·MIME·크기 참조로 보관. text-only 요청은 decoding 이전에 metadata만 사용. 원본 회수·권한·수명·재생 동일성을 검사하며 조용한 정보 손실 금지 |
+| H4: MCP 입장 제어 | MCP manager의 spawn, 기존 resource admission | 사용자 선택 loadout에서 필요할 때 시작. 실제 소유 child에만 종료·유휴회수 적용. 다른 세션·인증·프로젝트 경계를 공유하지 않음. host memory pressure와 startup 비용을 전후 측정 |
+| H5: 단일 요청 원장 | core 사건+SDK 요약+provider HTTP 경계 | run/trial/attempt/request ID로 시작·완료·거부·미확정을 연결. 시간창 귀속 금지. 사용량 결측을0으로 대체하지 않음. redaction·append 실패는 평가 completeness에 반영 |
+
+H1→H2→H3/H4→H5 순으로 무조건 전부 재작성하지 않는다. 먼저 각각의 현재 호출 경로와
+검사로 최소 diff를 정한다. H2는 “더 빨리 포기하기”가 목표가 아니며, H4는 머신 전체의
+프로세스나 Docker를 일괄 종료하는 기능이 아니다. global MCP pool은 인증 격리 비용이
+크므로 첫 구현에서 제외한다.
+
+## 5. 검증과 주장 범위
+
+이번 회귀는 공개 합성 입력만 사용했다. benchmark task 이름에 따라 동작을 바꾸거나
+원본 정답·verifier를 모델에 노출하지 않았다. 원본 실행물·결과·STOP 상태는 그대로다.
+
+| 검증 | 증명하는 범위 |
+| --- | --- |
+| core 이미지 회귀 | text-only 모델 유지, 원본 불변, idempotent 입력, 사용자 이미지 거부/허용, legacy 라우팅 유지 |
+| SDK 요약 회귀 | 요약에도 동일한 이미지 projection, 계약 거부 후 다음 허용 run 복구 |
+| 실제 소스 CLI + loopback HTTP | 실제 read image→두 번째 모델 요청 성공, raw 이벤트의 원본 image 보존, 최종 요청에 image payload 없음 |
+| CLI text/JSON 회귀 | 금지 모델의 네트워크0·exit1, settlement 실패 전파, 실패 후 후속 프롬프트 중단, 내부 복구 성공 보존 |
+| 기존 런타임 회귀 | auth/network/quota/abort/tool/persistence/compaction 분류와 기존 계약 유지 |
+
+구현 전에는 core 이미지 2개, SDK 요약/분류 2개, CLI 결과 5개 요구 검사가 실제 실패했다.
+직접 검토 중 사용자 이미지로 허용된 vision 모델을 선택했을 때 tool image까지 제거되는
+문제를 별도 RED로 발견하고 수정했다. 테스트 타입/fixture 오류는 제품 RED에 합산하지 않는다.
+
+실행 명령은 해당 package 디렉터리 기준이다. 메모리 부담을 줄이기 위해 worker 1로 실행한다.
+
+```bash
+# packages/agent
+node ../../node_modules/vitest/dist/cli.js --run test/provider-input.test.ts test/provider-request-boundary.test.ts --maxWorkers=1 --no-file-parallelism
+# packages/coding-agent
+node ../../node_modules/vitest/dist/cli.js --run test/sdk-model-contract.test.ts test/print-mode.test.ts test/model-contract-wire-cli.test.ts test/agent-session-termination-runtime.test.ts --maxWorkers=1 --no-file-parallelism
+# repository root
+node_modules/.bin/tsgo --noEmit --pretty false
+npm run check
+```
+
+실제 모델 재호출·벤치마크 재개·WSL 재시작·빌드/설치·커밋은 이번 작업에서 하지 않는다.
+본 변경은 중단된 24-task 결과를 보정하지 않는다. 재측정 전에 실행 snapshot과 양 arm의
+동일 조건을 다시 고정해야 한다. 현재 본 적 있는 24개는 개발 집합으로 유지하고,
+일반화 주장은 별도의 사전 고정 확인 평가로 검증한다.

package/docs/harness-improvements.md

@@ -0,0 +1,90 @@
+# OMK 하네스 개선 점검 — 2026-09-05
+
+기준은 `60f520f0c1`에서 시작한 현재 작업 트리입니다. 시작 시 다른 작업의
+미커밋 변경이 존재했으며 이를 보존했습니다. 아래는 주요 실행 경로에 대한
+소스·로컬 회귀 테스트 점검이지, 전체 코드 감사나 성능·SOTA 인증이 아닙니다.
+이번 변경은 작업 트리 상태이며 배포·릴리스된 기능으로 간주하지 않습니다.
+
+## 이번에 수정한 항목
+
+| 우선순위 | 관찰한 문제 | 수정과 증거 |
+| --- | --- | --- |
+| P0 | WPL의 `shouldSubmit`이 BLOCKED 여부만 확인해 preview·증거 부족·검증기 오류도 제출 가능으로 표시 | `b2c-mapper.ts`에서 적용 가능 + non-preview + run ID + `CONFIRMED`를 모두 요구. `submission-gates.test.ts`로 실패·누락·성공 대조 |
+| P0 | deep runner의 음수·비정수·실패 종료 코드와 공백 증거가 완료로 인정됨 | `deep-wall.ts`에서 비어 있지 않은 digest/command와 종료 코드 `0` 요구. `deep-wall-gates.test.ts` |
+| P0 | 완료된 deep check가 기존 BLOCKED/INCONCLUSIVE의 사람 검토 요구를 삭제 | `evaluate-correctness-wall.ts`가 기존 검토 요구를 유지하고, 요청한 deep check가 불가능하면 제출을 보류 |
+| P1 | 같은 테스트가 패키지 디렉터리에서는 통과하지만 저장소 루트에서는 오래된 WPL `dist`를 읽어 실패 | 루트 Vitest 프로젝트 설정과 coding-agent의 WPL 소스 alias 추가. 루트 실행에서 7개 실패를 재현한 뒤 같은 테스트 통과 |
+| P1 | WPL 사용자용 웹 가입·상담 접점과 키 없는 CLI 안내가 없음 | `getAdaptOrchLinks()`와 `omk doctor adaptorch --links [--json]` 추가. 고정 URL·UTM만 제공하며 정책 판정과 분리 |
+
+WPL의 `canApply`와 기존 shadow/soft/hard 적용 정책은 바꾸지 않았습니다.
+증거 요건을 충족한 `shouldSubmit=true`도 사람의 커밋·병합·배포 승인을 대신하지 않습니다.
+CTA를 verdict, 서명 receipt, 모델 프롬프트 또는 tool 실행 게이트에 끼워 넣지 않았습니다.
+
+## 다음 개선 순서
+
+| 우선순위 | 영역 / 현재 근거 | 후속 작업과 완료 기준 |
+| --- | --- | --- |
+| P0 | 전체 정적 검사: 아래 기존 파일의 Biome 오류 4개와 module-size 초과 5개 | 해당 변경 소유자가 수정한 뒤 `npm run check` 전체를 다시 통과시킬 것. 이번 작업 밖의 diff나 크기 baseline을 임의 수정하지 않음 |
+| P1 | 완료·취소·재시도: `prompt-settlement.ts`, `session-termination.ts`, `tool-timeout-settlement.ts` | 중간 `agent_end`와 최종 완료를 계속 분리. timeout 후 계속 쓰는 도구, 큐 취소, 중단 복원 조합을 실제 세션 경계 회귀에 추가 |
+| P1 | 컨텍스트·스킬: Context Budget V2와 Grok의 요청별 skill 선택은 별도 경로 | 공급자별 컨텍스트 비용·캐시 적중·compaction 후 명시 규칙 보존을 같은 작업으로 비교. 일반 공급자로 확장하기 전에 explicit-only 권한과 토큰 상한 회귀 확보 |
+| P1 | 공급자·도구 계약: `tool-schema`와 종료 원인 분류 테스트 | 인증/모델 미지원/환경 실패를 후보 코드 실패와 계속 구분. JSON schema 정규화와 tool pair 수선 후 공급자별 키 없는 cassette 회귀를 일관된 진입점에서 실행 |
+| P2 | 자원·스케줄링: DAG scheduler, resource admission의 현재 테스트 | `observe` 데이터를 먼저 수집하고 p95 지연·메모리·중복 도구 실행을 측정. adaptive 기본값 변경이나 자동 fan-out은 별도 승인·비교 실험 이후 |
+| P2 | 구조: 큰 session/interactive 모듈과 버전이 다른 런타임 설명 | 동작 변경과 파일 이동을 분리하고 역할별 모듈 크기·import-cycle 기준을 유지. 오래된 문서는 실제 소비자·기본값·revision에 묶어 갱신 |
+| P2 | CRM: 이번 변경은 링크 전달까지만 구현 | 사이트 측 동의 기반 UTM 보존 → 가입/상담 제출 → 첫 사용 이벤트를 연결하고, 로컬 평가와 호스티드 사용을 분리 집계. 링크 출력은 전환이 아님 |
+
+측정은 [Turn metrics](metrics.md)의 동일 모델·공급자·작업·예산 비교 계약을 따릅니다.
+회귀 테스트 통과만으로 더 빠르다거나 정확도가 높아졌다고 주장하지 않습니다.
+AdaptOrch 브리지는 계속 기본 비활성·advisory이며, WPL은 기본 CLI에서
+자동 dispatch/polling 루프가 되지 않습니다.
+
+## 검증 기록
+
+- 제출/deep-check 신규 회귀: 수정 전 **25개 중 17개 실패**, 수정 후 모두 통과.
+- CRM 안내 신규 회귀: 수정 전 **8개 중 7개 실패**, 수정 후 모두 통과.
+- WPL 관련 **9개 파일 / 68개 테스트 통과**. 변경한 mapper, deep wall, evaluator,
+  service links 네 모듈의 V8 커버리지: **lines 98.74%, branches 94.7%, functions 100%**.
+  `service-links.ts`는 모든 지표 100%.
+- coding-agent 하네스/컨텍스트/자원/브리지/벽 회귀 **13개 파일 / 154개 통과**.
+- 기존 doctor + 신규 offline handoff **2개 파일 / 20개 통과**.
+- 실제 소스 CLI 진입점 3개 시나리오와 agent scheduler/timeout/harness,
+  AI tool schema를 루트에서 함께 실행: **5개 파일 / 48개 통과**.
+- 최종 루트 통합 실행: 위의 **29개 파일 / 290개 테스트 모두 통과**, 종료 코드 `0`.
+- 루트 `node_modules/.bin/tsgo --noEmit`: 종료 코드 `0`. 변경 TypeScript 13개 파일의 LSP 오류 없음.
+- 변경 소스·테스트 Biome 검사와 범위 지정 `git diff --check`: 종료 코드 `0`.
+- `check:doc-links`, `check:feature-claims`, `check:private-home`, `check:import-cycles`:
+  각각 별도 실행에서 종료 코드 `0`. private-home 검사는 추적 중인 파일 범위입니다.
+- `npm run check`: 종료 코드 `1`, 아래 기존 파일의 import 정렬/포맷 오류 4개에서 중단.
+  이후 연결된 전체 게이트가 실행됐다고 간주하지 않습니다.
+- 별도 `npm run check:module-size`: 종료 코드 `1`, 이번에 수정하지 않은 아래 5개 모듈이
+  기존 baseline을 초과. 새 baseline을 등록해 오류를 숨기지 않았습니다.
+
+전체 검사를 막은 이번 작업 밖의 파일:
+
+- `packages/ai/src/utils/oauth/meta.ts`
+- `packages/ai/test/openai-responses-codex-turn-metadata.test.ts`
+- `packages/coding-agent/test/mcp/tools.test.ts`
+- `packages/coding-agent/test/session-termination.test.ts`
+
+Module-size 초과 파일 (현재 pure LOC / baseline):
+
+- `packages/agent/src/harness/reverse-skill.ts`: 905 / 792
+- `packages/ai/src/types.ts`: 362 / 361
+- `packages/coding-agent/src/core/model-registry.ts`: 886 / 885
+- `packages/coding-agent/src/core/provider-usage.ts`: 996 / 994
+- `packages/coding-agent/src/modes/interactive/interactive-mode.ts`: 5574 / 5473
+
+주요 신규 계약 재실행:
+
+```bash
+LIVE_E2E=0 node node_modules/vitest/dist/cli.js --run \
+  packages/adaptorch-wpl/test/submission-gates.test.ts \
+  packages/adaptorch-wpl/test/deep-wall-gates.test.ts \
+  packages/adaptorch-wpl/test/service-links.test.ts \
+  packages/coding-agent/test/adaptorch-onboarding.test.ts \
+  packages/coding-agent/test/adaptorch-doctor-cli.test.ts \
+  packages/coding-agent/test/adaptorch-links-cli.test.ts
+```
+
+명시적으로 미검증: 실제 Docker runner, 실제 인증 API 요청, 사이트 가입·상담
+저장, 클릭/전환 집계, 유료 provider 실행, 전체 e2e, 설치된 배포본/TUI 반영.
+벤치마크·AdaptOrch 실행·배포·커밋은 수행하지 않았습니다.
+CRM 사용법과 개인정보 경계는 [AdaptOrch 안내](adaptorch-onboarding.md)를 참조하세요.

package/docs/json.md

@@ -75,6 +75,25 @@ Followed by events as they occur:
 {"type":"agent_end","messages":[...]}
 ```
 
+## Completion and exit status
+
+`agent_end` closes an attempt, not necessarily the whole prompt: retries and
+continuations may still run. Use `prompt_settled` for the final prompt outcome
+(`completed`, `failed`, or `aborted`). Neither event proves task correctness.
+
+Print mode returns exit code **1** for a final failed or aborted prompt in both
+text and JSON output. If several CLI prompts were supplied, it stops at the first
+failed prompt instead of hiding it with a later success. An internally recovered
+attempt followed by a completed prompt still exits successfully. No prompt is an
+argument error (exit code **2**).
+
+Keep `pipefail` when filtering events, or the filter can hide OMK's nonzero status:
+
+```bash
+set -o pipefail
+omk --mode json "List files" | jq -c 'select(.type == "prompt_settled")'
+```
+
 ## Example
 
 ```bash

package/docs/keybindings.md

@@ -87,7 +87,7 @@ Modifier combinations: `ctrl+shift+x`, `alt+ctrl+x`, `ctrl+shift+alt+x`, `ctrl+1
 | `app.exit` | `ctrl+d` | Exit (when editor empty) |
 | `app.suspend` | `ctrl+z` (none on Windows) | Suspend to background |
 | `app.editor.external` | `ctrl+g` | Open in external editor (`$VISUAL` or `$EDITOR`) |
-| `app.clipboard.pasteImage` | `ctrl+v` (`alt+v` on Windows) | Paste image from clipboard |
+| `app.clipboard.pasteImage` | `ctrl+v`, `alt+v` | Paste image from clipboard; use `alt+v` when Windows Terminal consumes `ctrl+v` |
 
 ### Sessions
 
@@ -118,7 +118,7 @@ Modifier combinations: `ctrl+shift+x`, `alt+ctrl+x`, `ctrl+shift+alt+x`, `ctrl+1
 
 | Keybinding id | Default | Description |
 |--------|---------|-------------|
-| `app.tools.expand` | `ctrl+o` | Collapse or expand tool output |
+| `app.tools.expand` | `ctrl+o` | Collapse or expand tool output and typed failure details |
 | `app.message.followUp` | `alt+enter` | Queue follow-up message |
 | `app.message.dequeue` | `alt+up` | Restore queued messages to editor |