okstra 0.81.0 → 0.82.1

package/docs/kr/cli.md

@@ -328,7 +328,7 @@ Lead runtime independence boundary:
 - Codex host: `okstra run` 이 `codex-run` -> `codex-dispatch` 를 orchestration 합니다.
 - generic terminal + tmux: `okstra run` 이 `render-bundle --lead-runtime external` -> `okstra team dispatch` -> `okstra team await` 를 orchestration 합니다.
 
-`okstra install` / `ensure-installed` / `doctor` / `render-bundle` 도 `auto` 를 기본값으로 받지만, host signal 이 없는 plain terminal 에서는 host 지정이 필요합니다. 그래서 Claude Code skill 들은 `--runtime claude-code` / `--lead-runtime claude-code` 를 명시합니다. 단, `okstra install` 의 스킬 복사 대상은 runtime resolution 이 아니라 agent home 존재 여부입니다. `~/.claude` 와 `~/.codex` 가 있으면 둘 다 설치하고, 둘 다 없을 때만 `~/.omp/agent` 를 fallback 으로 사용합니다.
+`doctor` / `render-bundle` 도 `auto` 를 기본값으로 받지만, host signal 이 없는 plain terminal 에서는 host 지정이 필요합니다. `okstra install` / `ensure-installed` 는 예외입니다. 설치는 runtime host 가 아니라 agent home 기준으로 공유 runtime 과 skill target 을 배치하므로, host signal 이 없어도 `auto` 요청과 미해결 상태를 manifest 에 기록하고 설치를 계속합니다. 스킬 복사 대상은 runtime resolution 이 아니라 agent home 존재 여부입니다. Claude Code skill 들은 `--runtime claude-code` / `--lead-runtime claude-code` 를 명시하므로 실행 단계에서 host auto-detection 에 의존하지 않습니다. `~/.claude` 와 `~/.codex` 가 있으면 둘 다 설치하고, 둘 다 없을 때만 `~/.omp/agent` 를 fallback 으로 사용합니다.
 
 `installed-runtimes.json` 은 schemaVersion 2 로 `installRequest`, `runtimeResolution`, `installedRuntimes`, `installedAssets` 를 분리합니다. `installed-skills.json` 은 schemaVersion 2 target 목록(`provider`, `root`, `skills`)으로 Claude/Codex/OMP skill target 을 기록하며, uninstall 은 이 target 목록을 기준으로 제거합니다. 이전 `codexAdapter` / `externalAdapter` 는 v1 manifest read 호환 경로에서만 해석됩니다.
 
@@ -624,7 +624,7 @@ chmod +x ~/.local/bin/okstra-ctl
 |---|---|
 | `okstra paths [--field <name>\|--shell]` | package/runtime/home/bin/pythonpath/version 경로 출력 |
 | `okstra install [--runtime claude-code\|codex\|external\|all] [--refresh\|--dry-run\|--link <repo>]` | runtime, templates, skills, agents 설치/갱신. 기본 runtime 은 `auto`; 스킬 대상은 runtime 이 아니라 기존 home 기준이다. `~/.claude` 가 있으면 Claude skills + agents, `~/.codex` 가 있으면 Codex skills, 둘 다 없고 `~/.omp/agent` 가 있으면 OMP skills 를 설치한다 |
-| `okstra ensure-installed [--runtime claude-code\|codex\|external\|all] [-q]` | 설치 상태 확인, stale이면 같은 runtime 으로 재설치. 존재하는 skill target 의 drift 만 검사한다 |
+| `okstra ensure-installed [--runtime claude-code\|codex\|external\|all] [-q]` | 설치 상태 확인, stale이면 같은 runtime 으로 재설치. 기본 `auto` 는 host signal 이 없어도 설치를 계속하며, 존재하는 skill target 의 drift 만 검사한다 |
 | `okstra uninstall [--purge -y]` | 설치 자산 제거. 기본값은 `installed-skills.json` target 목록과 `installed-agents.json` 기준으로 제거하고 사용자 데이터는 보존 |
 | `okstra doctor [--runtime claude-code\|codex\|external\|all] [--phase <phase>] [--json]` | runtime + Python import + skill/agent 설치 진단. `codex` / `external` runtime 은 Claude skill checks 를 제외한다. `--phase` 는 `implementation`, `final-verification`, `release-handoff`, `improvement-discovery` 실행 전 readiness 체크를 추가한다 |
 | `okstra setup --project-id <id>` | 현재 프로젝트의 `.okstra/project.json` 생성/갱신 |

package/docs/project-structure-overview.md

@@ -131,7 +131,7 @@ Runtime/install asset changes follow this checklist:
 
 `--link <repo>` mode is for development and symlinks installed files back to repo sources.
 
-`src/runtime-resolver.mjs` is the single reference point for runtime auto-detection. `okstra install` defaults to `--runtime auto`, records the request and resolution in `installed-runtimes.json` schemaVersion 2, and still copies the shared runtime payload from the installed package `runtime/` tree. Skill targets are discovered from existing agent homes: `~/.claude` and `~/.codex` are both populated when present; `~/.omp/agent` is the fallback only when neither exists. Dynamic capabilities such as `tmux` and `codex` CLI availability are checked by `doctor` and `run`, not frozen into the install manifest. Claude Code skills pass explicit `--runtime claude-code` / `--lead-runtime claude-code` so they never depend on host auto-detection.
+`src/runtime-resolver.mjs` is the single reference point for runtime auto-detection. `okstra install` defaults to `--runtime auto`, records the request and any successful resolution in `installed-runtimes.json` schemaVersion 2, and still copies the shared runtime payload from the installed package `runtime/` tree even when host detection is unavailable. Skill targets are discovered from existing agent homes: `~/.claude` and `~/.codex` are both populated when present; `~/.omp/agent` is the fallback only when neither exists. Dynamic capabilities such as `tmux` and `codex` CLI availability are checked by `doctor` and `run`, not frozen into the install manifest. Claude Code skills pass explicit `--runtime claude-code` / `--lead-runtime claude-code` so they never depend on host auto-detection.
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "okstra",
-  "version": "0.81.0",
+  "version": "0.82.1",
   "description": "Multi-agent cross-verification orchestrator runtime + Claude Code skills.",
   "license": "MIT",
   "author": "devonshin",

package/runtime/BUILD.json

@@ -1,5 +1,5 @@
 {
-  "package": "0.81.0",
-  "builtAt": "2026-06-14T17:44:49.025Z",
+  "package": "0.82.1",
+  "builtAt": "2026-06-15T04:53:43.767Z",
   "repoRoot": "/home/runner/work/okstra/okstra"
 }

package/src/install.mjs

@@ -62,7 +62,7 @@ Effect (copy mode):
   ${"$HOME"}/.codex/skills/<name>  <- skills when ${"$HOME"}/.codex exists
   ${"$HOME"}/.omp/agent/skills/<name> <- skills fallback when Claude/Codex homes are absent
   ${"$HOME"}/.claude/agents/<worker>.md <- worker agents when ${"$HOME"}/.claude exists
-  ${"$HOME"}/.okstra/installed-runtimes.json <- manifest of installed runtime adapters
+  ${"$HOME"}/.okstra/installed-runtimes.json <- install request/resolution manifest
   ${"$HOME"}/.okstra/installed-skills.json   <- target-aware manifest of installed skills
   ${"$HOME"}/.okstra/installed-agents.json   <- manifest of installed workers
   ${"$HOME"}/.okstra/version       <- installed package version stamp
@@ -86,6 +86,9 @@ worker wrapper scripts without modifying the user's global settings.
 Worker agent definitions are installed into ${"$HOME"}/.claude/agents/ only
 when ${"$HOME"}/.claude exists, so Claude Code's subagent discovery can pick
 them up. Codex/OMP skill targets receive skill markdown only.
+
+Default auto runtime installation does not require host detection; it still
+installs shared runtime files and any agent-home skill targets it finds.
 `;
 
 const ENSURE_USAGE = `okstra ensure-installed — idempotent install check
@@ -125,6 +128,31 @@ export function validateInstallRuntime(value) {
   return runtime;
 }
 
+function resolveInstallRuntime(runtime, command) {
+  const resolution = resolveRuntime({
+    requestedRuntime: runtime,
+    command,
+    env: process.env,
+    capabilities: { tmuxAvailable: Boolean(process.env.TMUX) },
+  });
+  if (resolution.ok || runtime !== "auto") return resolution;
+  return {
+    ok: false,
+    requestedRuntime: "auto",
+    resolvedRuntime: null,
+    host: "unknown",
+    confidence: "none",
+    reason: resolution.reason,
+    fallbackFrom: null,
+    warnings: [resolution.reason],
+  };
+}
+
+function formatInstallRuntimeLabel(runtime, resolution) {
+  if (resolution.resolvedRuntime) return `${runtime} -> ${resolution.resolvedRuntime}`;
+  return `${runtime} (host unresolved; installing target assets)`;
+}
+
 async function hashFile(path) {
   const buf = await fs.readFile(path);
   return createHash("sha256").update(buf).digest("hex");
@@ -725,17 +753,11 @@ export async function runInstall(args) {
   const pkgRoot = getPackageRoot();
   const runtimeRoot = join(pkgRoot, "runtime");
   const paths = await resolvePaths();
-  const runtimeResolution = resolveRuntime({
-    requestedRuntime: opts.runtime,
-    command: "install",
-    env: process.env,
-    capabilities: { tmuxAvailable: Boolean(process.env.TMUX) },
-  });
-  if (!runtimeResolution.ok) {
+  const runtimeResolution = resolveInstallRuntime(opts.runtime, "install");
+  if (!runtimeResolution.ok && opts.runtime !== "auto") {
     process.stderr.write(`error: ${runtimeResolution.reason}\n`);
     return 2;
   }
-  const resolvedRuntime = runtimeResolution.resolvedRuntime;
 
   if (!opts.dryRun) {
     await fs.mkdir(paths.home, { recursive: true });
@@ -754,7 +776,7 @@ export async function runInstall(args) {
 
   if (!opts.quiet) {
     process.stdout.write(`installing okstra runtime (package ${paths.package})\n`);
-    process.stdout.write(`  runtime: ${opts.runtime} -> ${resolvedRuntime}\n`);
+    process.stdout.write(`  runtime: ${formatInstallRuntimeLabel(opts.runtime, runtimeResolution)}\n`);
     process.stdout.write(`  source: ${runtimeRoot}\n`);
     process.stdout.write(`  home:   ${paths.home}\n`);
   }
@@ -949,13 +971,8 @@ export async function runEnsureInstalled(args) {
     return 2;
   }
   const paths = await resolvePaths();
-  const runtimeResolution = resolveRuntime({
-    requestedRuntime: opts.runtime,
-    command: "ensure-installed",
-    env: process.env,
-    capabilities: { tmuxAvailable: Boolean(process.env.TMUX) },
-  });
-  if (!runtimeResolution.ok) {
+  const runtimeResolution = resolveInstallRuntime(opts.runtime, "ensure-installed");
+  if (!runtimeResolution.ok && opts.runtime !== "auto") {
     process.stderr.write(`error: ${runtimeResolution.reason}\n`);
     return 2;
   }