@jjlabsio/claude-crew 0.1.46 → 0.1.48

package/.claude-plugin/marketplace.json

@@ -11,7 +11,7 @@
       "name": "claude-crew",
       "source": "./",
       "description": "오케스트레이터 + PM, 플래너, 개발, QA, 마케팅 에이전트 팀으로 단일 제품의 개발과 마케팅을 통합 관리",
-      "version": "0.1.46",
+      "version": "0.1.48",
       "author": {
         "name": "Jaejin Song",
         "email": "wowlxx28@gmail.com"
@@ -28,5 +28,5 @@
       "category": "workflow"
     }
   ],
-  "version": "0.1.46"
+  "version": "0.1.48"
 }

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-crew",
-  "version": "0.1.46",
+  "version": "0.1.48",
   "description": "1인 SaaS 개발자를 위한 멀티 에이전트 오케스트레이션 — 개발, 마케팅, 일정을 한 대화에서 통합 관리",
   "author": {
     "name": "Jaejin Song",

package/data/provider-catalog.json

@@ -44,7 +44,7 @@
     "explorer": { "codex_sandbox": "read-only" },
     "researcher": { "codex_sandbox": "read-only" },
     "qa": { "codex_sandbox": "read-only" },
-    "dev": { "codex_sandbox": "workspace-write" },
+    "dev": { "codex_sandbox": "workspace-write", "codex_network_access": true },
     "code-reviewer": { "codex_sandbox": "read-only" }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jjlabsio/claude-crew",
-  "version": "0.1.46",
+  "version": "0.1.48",
   "description": "1인 SaaS 개발자를 위한 멀티 에이전트 오케스트레이션 — 개발, 마케팅, 일정을 한 대화에서 통합 관리",
   "author": "Jaejin Song <wowlxx28@gmail.com>",
   "license": "MIT",

package/scripts/crew-codex/lib/codex.mjs

@@ -56,7 +56,7 @@ function cleanCodexStderr(stderr) {
 
 /** @returns {ThreadStartParams} */
 function buildThreadParams(cwd, options = {}) {
-  return {
+  const params = {
     cwd,
     model: options.model ?? null,
     approvalPolicy: options.approvalPolicy ?? "never",
@@ -65,17 +65,25 @@ function buildThreadParams(cwd, options = {}) {
     ephemeral: options.ephemeral ?? true,
     experimentalRawEvents: false
   };
+  if (options.networkAccess) {
+    params.networkAccess = true;
+  }
+  return params;
 }
 
 /** @returns {ThreadResumeParams} */
 function buildResumeParams(threadId, cwd, options = {}) {
-  return {
+  const params = {
     threadId,
     cwd,
     model: options.model ?? null,
     approvalPolicy: options.approvalPolicy ?? "never",
     sandbox: options.sandbox ?? "read-only"
   };
+  if (options.networkAccess) {
+    params.networkAccess = true;
+  }
+  return params;
 }
 
 /** @returns {UserInput[]} */
@@ -977,6 +985,7 @@ export async function runAppServerTurn(cwd, options = {}) {
       const response = await resumeThread(client, options.resumeThreadId, cwd, {
         model: options.model,
         sandbox: options.sandbox,
+        networkAccess: options.networkAccess,
         ephemeral: false
       });
       threadId = response.thread.id;
@@ -985,6 +994,7 @@ export async function runAppServerTurn(cwd, options = {}) {
       const response = await startThread(client, cwd, {
         model: options.model,
         sandbox: options.sandbox,
+        networkAccess: options.networkAccess,
         ephemeral: options.persistThread ? false : true,
         threadName: options.persistThread ? options.threadName : options.threadName ?? null
       });

package/scripts/crew-codex-companion.mjs

@@ -73,7 +73,7 @@ function printUsage() {
   console.log(
     [
       "Usage:",
-      "  node scripts/crew-codex-companion.mjs task [--background] [--write] [--expect-crew-result] [--resume-last|--resume|--fresh] [--model <model|spark>] [--effort <none|minimal|low|medium|high|xhigh>] [prompt]",
+      "  node scripts/crew-codex-companion.mjs task [--background] [--write] [--network-access] [--expect-crew-result] [--resume-last|--resume|--fresh] [--model <model|spark>] [--effort <none|minimal|low|medium|high|xhigh>] [prompt]",
       "  node scripts/crew-codex-companion.mjs status [job-id] [--all] [--json]",
       "  node scripts/crew-codex-companion.mjs result [job-id] [--json]",
       "  node scripts/crew-codex-companion.mjs cancel [job-id] [--json]"
@@ -341,6 +341,7 @@ async function executeTaskRun(request) {
     model: request.model,
     effort: request.effort,
     sandbox: request.write ? "workspace-write" : "read-only",
+    networkAccess: Boolean(request.networkAccess),
     onProgress: request.onProgress,
     persistThread: true,
     threadName: resumeThreadId ? null : buildPersistentTaskThreadName(request.prompt || DEFAULT_CONTINUE_PROMPT)
@@ -455,13 +456,14 @@ function buildTaskJob(workspaceRoot, taskMetadata, write) {
   });
 }
 
-function buildTaskRequest({ cwd, model, effort, prompt, write, resumeLast, expectCrewResult, jobId }) {
+function buildTaskRequest({ cwd, model, effort, prompt, write, networkAccess, resumeLast, expectCrewResult, jobId }) {
   return {
     cwd,
     model,
     effort,
     prompt,
     write,
+    networkAccess,
     resumeLast,
     expectCrewResult,
     jobId
@@ -591,7 +593,7 @@ function enqueueBackgroundTask(cwd, job, request) {
 async function handleTask(argv) {
   const { options, positionals } = parseCommandInput(argv, {
     valueOptions: ["model", "effort", "cwd", "prompt-file"],
-    booleanOptions: ["json", "write", "expect-crew-result", "resume-last", "resume", "fresh", "background"],
+    booleanOptions: ["json", "write", "network-access", "expect-crew-result", "resume-last", "resume", "fresh", "background"],
     aliasMap: {
       m: "model"
     }
@@ -609,6 +611,7 @@ async function handleTask(argv) {
     throw new Error("Choose either --resume/--resume-last or --fresh.");
   }
   const write = Boolean(options.write);
+  const networkAccess = Boolean(options["network-access"]);
   const expectCrewResult = Boolean(options["expect-crew-result"]);
   const taskMetadata = buildTaskRunMetadata({
     prompt,
@@ -626,6 +629,7 @@ async function handleTask(argv) {
       effort,
       prompt,
       write,
+      networkAccess,
       resumeLast,
       expectCrewResult,
       jobId: job.id
@@ -645,6 +649,7 @@ async function handleTask(argv) {
         effort,
         prompt,
         write,
+        networkAccess,
         resumeLast,
         expectCrewResult,
         jobId: job.id,

package/scripts/lib/dispatch.mjs

@@ -264,6 +264,10 @@ function buildTaskArgs(input, promptFile) {
     args.push("--write");
   }
 
+  if (input.resolved?.codex_network_access) {
+    args.push("--network-access");
+  }
+
   if (input.resolved?.model) {
     args.push("--model", input.resolved.model);
   }

package/scripts/lib/resolve.mjs

@@ -23,6 +23,7 @@ export function resolveRole(input) {
   if (!["read-only", "workspace-write"].includes(codexSandbox)) {
     throw new Error(`Missing codex_sandbox for role ${role}`);
   }
+  const codexNetworkAccess = catalog?.agent_runtime?.[role]?.codex_network_access === true;
 
   const warnings = [];
   const workspaceAccess = contract?.capabilities?.workspaceAccess;
@@ -38,6 +39,7 @@ export function resolveRole(input) {
     model,
     reasoning: provider === "codex" ? defaults.reasoning ?? null : null,
     codex_sandbox: codexSandbox,
+    codex_network_access: codexNetworkAccess,
     contract,
     dispatch: {
       path: provider === "codex" ? "codex" : "claude",

package/scripts/setup-hud.mjs

@@ -11,6 +11,7 @@ import { execSync } from 'node:child_process';
 import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'node:fs';
 import { join, dirname } from 'node:path';
 import { homedir } from 'node:os';
+import { PLUGIN_ROOT } from './lib/pluginRoot.mjs';
 
 // ---------------------------------------------------------------------------
 // Read stdin (with timeout)
@@ -33,6 +34,39 @@ function gitExec(cmd, cwd) {
   } catch { return null; }
 }
 
+function readPluginVersion() {
+  const packageJson = JSON.parse(readFileSync(join(PLUGIN_ROOT, 'package.json'), 'utf-8'));
+  return packageJson.version;
+}
+
+function updatePluginRootCache(pluginRoot) {
+  try {
+    const crewDir = join(homedir(), '.claude', 'crew');
+    const cachePath = join(crewDir, 'plugin-root.json');
+
+    let shouldWrite = !existsSync(cachePath);
+    if (!shouldWrite) {
+      try {
+        const current = JSON.parse(readFileSync(cachePath, 'utf-8'));
+        shouldWrite = current.pluginRoot !== pluginRoot;
+      } catch {
+        shouldWrite = true;
+      }
+    }
+
+    if (!shouldWrite) return;
+
+    mkdirSync(crewDir, { recursive: true });
+    writeFileSync(cachePath, JSON.stringify({
+      pluginRoot,
+      version: readPluginVersion(),
+      updatedAt: new Date().toISOString(),
+    }, null, 2));
+  } catch {
+    // Best-effort cache for runner fallback. HUD setup must continue on failure.
+  }
+}
+
 // ---------------------------------------------------------------------------
 // Main
 // ---------------------------------------------------------------------------
@@ -74,6 +108,8 @@ async function main() {
       writeFileSync(localSettingsPath, JSON.stringify(localSettings, null, 2));
     }
 
+    updatePluginRootCache(pluginRoot);
+
     console.log(JSON.stringify({ continue: true }));
   } catch (e) {
     console.log(JSON.stringify({

package/skills/crew-agent-runner/SKILL.md

@@ -7,20 +7,33 @@ description: 모든 crew 에이전트 dispatch의 중앙 규약 — provider별
 
 crew 업무 스킬은 에이전트 provider별 호출 세부사항을 직접 구현하지 않고 이 중앙 규약을 따른다. 본 스킬은 prepare, resolve, dispatch, resume, followup 주입, retry/fallback/escalate 판단의 공통 표면을 정의한다.
 
-설치 후 drift 차단용 pre-commit hook은 `node scripts/crew-agent-runner.mjs install-hooks`로 설치한다.
+설치 후 drift 차단용 pre-commit hook은 `node "$CREW_ROOT/scripts/crew-agent-runner.mjs" install-hooks`로 설치한다.
 (plugin 개발자 전용 — 사용자는 호출하지 않습니다. build/validate는 plugin source repo의 drift 차단 도구입니다.)
 
 ## Dispatch 절차
 
 업무 스킬(crew-plan/crew-interview/crew-dev)이 role을 실행해야 할 때 본 절차를 따른다.
 
+### Step 0. Runner 경로 결정
+
+오케스트레이터는 runner 호출 전에 plugin root를 결정하고, 결정된 경로를 `CREW_ROOT`로 사용한다.
+
+Fallback 체인 (순서 중요):
+
+1. `$CLAUDE_PLUGIN_ROOT`가 있으면 사용한다. 정상 Claude Code plugin 환경이므로 추가 검증하지 않는다.
+2. `~/.claude/crew/plugin-root.json`의 `pluginRoot`를 읽는다. 해당 경로에 `scripts/crew-agent-runner.mjs`가 존재하면 사용하고, 없으면 다음 fallback으로 진행한다.
+3. `git rev-parse --show-toplevel` 결과를 dev 환경 전용 후보로 사용한다. 해당 경로의 `package.json`에서 `name`이 `@jjlabsio/claude-crew`인지 검증하고, 맞으면 사용한다. 아니면 다음 fallback으로 진행한다.
+4. 모든 fallback이 실패하면 `'/crew-setup을 먼저 실행하세요'` 에러 메시지로 중단한다.
+
+이후 모든 runner 호출은 `node "$CREW_ROOT/scripts/crew-agent-runner.mjs"` 형식을 사용한다.
+
 ### 1. request 객체 작성
 
 `{ role, inputs (path+content), instruction, successGate, failureHandling, taskId }` 형태의 임시 JSON 파일을 작성한다.
 
 ### 2. prepare
 
-오케스트레이터는 `node "$CLAUDE_PLUGIN_ROOT/scripts/crew-agent-runner.mjs" prepare --role <role> --request-file <request-file> --json`을 실행한다.
+오케스트레이터는 `node "$CREW_ROOT/scripts/crew-agent-runner.mjs" prepare --role <role> --request-file <request-file> --json`을 실행한다.
 prepare는 provider/model/contract를 해석하고 다음 action 중 하나를 반환한다.
 
 ### 3a. dispatch action
@@ -67,8 +80,8 @@ capability를 넘어선 도구 요청이다. 오케스트레이터가 `contract.
 
 ### Codex 경로
 
-1. `node scripts/crew-agent-runner.mjs render-followup --previous-result <file> --new-input <file>` 실행 → followup prompt 문자열 → 임시 파일에 저장.
-2. `node scripts/crew-agent-runner.mjs dispatch --role <role> --request-file <new-request-with-followup-prompt> --resume-handle <agent_handle> --json` 실행.
+1. `node "$CREW_ROOT/scripts/crew-agent-runner.mjs" render-followup --previous-result <file> --new-input <file>` 실행 → followup prompt 문자열 → 임시 파일에 저장.
+2. `node "$CREW_ROOT/scripts/crew-agent-runner.mjs" dispatch --role <role> --request-file <new-request-with-followup-prompt> --resume-handle <agent_handle> --json` 실행.
    - 내부적으로 runner가 `crew-codex-companion.mjs task-resume-candidate`로 thread 일치 검증 후 `task --resume-last`를 호출하고 AgentResult를 정규화한다.
 3. AgentResult JSON을 받아 다음 상태 처리.
 

package/skills/crew-setup/SKILL.md

@@ -102,6 +102,27 @@ push는 하지 않는다.
 
 ---
 
+## Step 2b — Plugin Root 영속화
+
+`$CLAUDE_PLUGIN_ROOT`가 살아있는 setup 시점에 runner fallback용 plugin root를 사용자 데이터 영역에 저장한다.
+
+1. `~/.claude/crew/` 디렉토리가 없으면 생성한다.
+2. `~/.claude/crew/plugin-root.json`을 다음 형식으로 쓴다. 기존 파일이 있으면 덮어쓴다.
+   ```json
+   {
+     "pluginRoot": "<$CLAUDE_PLUGIN_ROOT 값>",
+     "version": "<현재 플러그인 버전>",
+     "updatedAt": "<ISO timestamp>"
+   }
+   ```
+3. plugin 자체 데이터인 version은 plugin root 기준 `package.json`에서 읽는다.
+
+**주의**:
+- plugin root는 `$CLAUDE_PLUGIN_ROOT` 값을 사용한다.
+- `~/.claude/crew/plugin-root.json`은 사용자 데이터이므로 home 기준 경로에 저장한다.
+
+---
+
 ## Step 3 — Provider 설정
 
 에이전트별로 어떤 provider(claude/codex)와 model을 사용할지 설정한다.