@jjlabsio/claude-crew 0.1.3

package/hud/index.mjs

@@ -0,0 +1,375 @@
+#!/usr/bin/env node
+/**
+ * CREW HUD - Statusline for claude-crew plugin
+ *
+ * Displays:
+ *   Top:    repo:<name> | branch:<branch> | model:<model>
+ *   Middle: [CREW#x.y.z] ctx:<pct>% | agents:<n> | skill:<name> | session:<duration>
+ *
+ * Receives JSON on stdin from Claude Code.
+ */
+
+import { execSync } from 'node:child_process';
+import { readFileSync, existsSync } from 'node:fs';
+import { join, dirname, basename } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+// ---------------------------------------------------------------------------
+// ANSI helpers
+// ---------------------------------------------------------------------------
+const RESET = '\x1b[0m';
+const bold = (s) => `\x1b[1m${s}\x1b[22m`;
+const dim = (s) => `\x1b[2m${s}\x1b[22m`;
+const yellow = (s) => `\x1b[33m${s}\x1b[39m`;
+const red = (s) => `\x1b[31m${s}\x1b[39m`;
+const green = (s) => `\x1b[32m${s}\x1b[39m`;
+const cyan = (s) => `\x1b[36m${s}\x1b[39m`;
+const magenta = (s) => `\x1b[35m${s}\x1b[39m`;
+
+const SEPARATOR = dim(' | ');
+
+// ---------------------------------------------------------------------------
+// Read stdin (with timeout)
+// ---------------------------------------------------------------------------
+async function readStdin(timeoutMs = 1000) {
+  if (process.stdin.isTTY) return null;
+  return new Promise((resolve) => {
+    let data = '';
+    const timer = setTimeout(() => resolve(data || null), timeoutMs);
+    process.stdin.setEncoding('utf-8');
+    process.stdin.on('data', (chunk) => { data += chunk; });
+    process.stdin.on('end', () => { clearTimeout(timer); resolve(data || null); });
+    process.stdin.on('error', () => { clearTimeout(timer); resolve(null); });
+  });
+}
+
+// ---------------------------------------------------------------------------
+// Version
+// ---------------------------------------------------------------------------
+function getVersion() {
+  try {
+    const __dirname = dirname(fileURLToPath(import.meta.url));
+    const pkgPath = join(__dirname, '..', 'package.json');
+    if (existsSync(pkgPath)) {
+      return JSON.parse(readFileSync(pkgPath, 'utf-8')).version || '0.0.0';
+    }
+  } catch { /* ignore */ }
+  return '0.0.0';
+}
+
+// ---------------------------------------------------------------------------
+// Git helpers
+// ---------------------------------------------------------------------------
+function gitExec(cmd, cwd) {
+  try {
+    return execSync(cmd, { cwd, encoding: 'utf-8', timeout: 3000, stdio: ['pipe', 'pipe', 'pipe'] }).trim();
+  } catch { return null; }
+}
+
+function getGitRepo(cwd) {
+  // In worktrees, --show-toplevel returns the worktree path.
+  // Use the remote origin URL to get the real repo name.
+  const remoteUrl = gitExec('git remote get-url origin', cwd);
+  if (remoteUrl) {
+    // Handle both https and ssh formats
+    const match = remoteUrl.match(/\/([^/]+?)(?:\.git)?$/);
+    if (match) return match[1];
+  }
+  // Fallback: use the main worktree (common dir) basename
+  const commonDir = gitExec('git rev-parse --git-common-dir', cwd);
+  if (commonDir) {
+    // commonDir is like /path/to/repo/.git
+    const repoDir = dirname(commonDir.replace(/\/.git$/, '') || commonDir);
+    return basename(repoDir === '.' ? commonDir : commonDir.replace(/\/.git$/, ''));
+  }
+  const topLevel = gitExec('git rev-parse --show-toplevel', cwd);
+  return topLevel ? basename(topLevel) : null;
+}
+
+function getGitBranch(cwd) {
+  return gitExec('git rev-parse --abbrev-ref HEAD', cwd);
+}
+
+function hasUncommittedChanges(cwd) {
+  const status = gitExec('git status --porcelain', cwd);
+  return status ? status.length > 0 : false;
+}
+
+function hasUnpushedCommits(cwd) {
+  const count = gitExec('git rev-list --count @{u}..HEAD', cwd);
+  return count ? parseInt(count, 10) > 0 : false;
+}
+
+// ---------------------------------------------------------------------------
+// Model name
+// ---------------------------------------------------------------------------
+function formatModel(stdin) {
+  if (!stdin?.model) return null;
+  const display = stdin.model.display_name || '';
+  if (display) return display;
+  // Fallback: parse from model id
+  const id = stdin.model.id || '';
+  if (id.includes('opus')) return 'Opus';
+  if (id.includes('sonnet')) return 'Sonnet';
+  if (id.includes('haiku')) return 'Haiku';
+  return id;
+}
+
+// ---------------------------------------------------------------------------
+// Context percentage
+// ---------------------------------------------------------------------------
+function getContextPercent(stdin) {
+  if (!stdin?.context_window) return 0;
+  if (stdin.context_window.used_percentage != null) {
+    return Math.round(stdin.context_window.used_percentage);
+  }
+  if (stdin.context_window.current_usage && stdin.context_window.context_window_size) {
+    const used = stdin.context_window.current_usage.input_tokens +
+      (stdin.context_window.current_usage.cache_creation_input_tokens || 0) +
+      (stdin.context_window.current_usage.cache_read_input_tokens || 0);
+    return Math.round((used / stdin.context_window.context_window_size) * 100);
+  }
+  return 0;
+}
+
+function colorizeContext(pct) {
+  const color = pct >= 85 ? red : pct >= 70 ? yellow : green;
+  return `ctx:${color(`${pct}%`)}`;
+}
+
+// ---------------------------------------------------------------------------
+// Transcript parsing (agents + skills)
+// ---------------------------------------------------------------------------
+function parseTranscript(transcriptPath) {
+  const result = { agents: [], lastSkill: null, sessionStart: null };
+  if (!transcriptPath || !existsSync(transcriptPath)) return result;
+
+  try {
+    const content = readFileSync(transcriptPath, 'utf-8');
+    const lines = content.split('\n').filter(Boolean);
+
+    // Map of tool_use_id -> agent info
+    const agentMap = new Map();
+
+    for (const line of lines) {
+      let entry;
+      try { entry = JSON.parse(line); } catch { continue; }
+
+      // Session start time
+      if (!result.sessionStart && entry.timestamp) {
+        result.sessionStart = new Date(entry.timestamp);
+      }
+
+      // Track agents
+      if (entry.type === 'tool_use' || entry.type === 'assistant') {
+        const content = entry.message?.content;
+        if (Array.isArray(content)) {
+          for (const block of content) {
+            if (block.type === 'tool_use') {
+              // Agent start
+              if (block.name === 'Agent' || block.name === 'proxy_Agent') {
+                const id = block.id;
+                if (id) {
+                  const input = block.input || {};
+                  const agentType = input.subagent_type || input.type || 'general';
+                  const model = input.model || null;
+                  const description = input.description || input.prompt?.slice(0, 50) || '';
+                  agentMap.set(id, {
+                    id,
+                    type: agentType,
+                    model,
+                    description,
+                    startTime: entry.timestamp ? new Date(entry.timestamp) : new Date(),
+                    status: 'running',
+                  });
+                }
+              }
+              // Skill invocation
+              if (block.name === 'Skill' || block.name === 'proxy_Skill') {
+                const skillName = block.input?.skill || block.input?.name;
+                if (skillName) {
+                  result.lastSkill = skillName;
+                }
+              }
+            }
+          }
+        }
+      }
+
+      // Agent completion — tool_result can appear as a top-level entry
+      // or inside a "user" message content array
+      if (entry.type === 'tool_result') {
+        const toolUseId = entry.tool_use_id;
+        if (toolUseId && agentMap.has(toolUseId)) {
+          agentMap.get(toolUseId).status = 'completed';
+        }
+      }
+      if (entry.type === 'user') {
+        const content = entry.message?.content;
+        if (Array.isArray(content)) {
+          for (const block of content) {
+            if (block.type === 'tool_result') {
+              const toolUseId = block.tool_use_id;
+              if (toolUseId && agentMap.has(toolUseId)) {
+                agentMap.get(toolUseId).status = 'completed';
+              }
+            }
+          }
+        }
+      }
+    }
+
+    result.agents = [...agentMap.values()].filter(a => a.status === 'running');
+  } catch { /* ignore parse errors */ }
+
+  return result;
+}
+
+// ---------------------------------------------------------------------------
+// Agent model name (short)
+// ---------------------------------------------------------------------------
+function shortModelName(model) {
+  if (!model) return '?';
+  const m = model.toLowerCase();
+  if (m.includes('opus')) return 'Opus';
+  if (m.includes('sonnet')) return 'Sonnet';
+  if (m.includes('haiku')) return 'Haiku';
+  return model;
+}
+
+// ---------------------------------------------------------------------------
+// Agent duration formatting
+// ---------------------------------------------------------------------------
+function formatAgentDuration(startTime) {
+  const ms = Date.now() - startTime.getTime();
+  const seconds = Math.floor(ms / 1000);
+  const minutes = Math.floor(seconds / 60);
+  if (seconds < 60) return `${seconds}s`;
+  return `${minutes}m`;
+}
+
+// ---------------------------------------------------------------------------
+// Agent multiline rendering
+// ---------------------------------------------------------------------------
+function renderAgentsMultiLine(agents, maxLines = 5) {
+  if (agents.length === 0) return { headerPart: null, detailLines: [] };
+
+  const headerPart = `agents:${cyan(String(agents.length))}`;
+
+  // Sort by newest first
+  const sorted = [...agents].sort((a, b) => b.startTime.getTime() - a.startTime.getTime());
+  const displayCount = Math.min(sorted.length, maxLines);
+  const detailLines = [];
+
+  sorted.slice(0, maxLines).forEach((a, index) => {
+    const isLast = index === displayCount - 1 && sorted.length <= maxLines;
+    const prefix = isLast ? '\u2514\u2500' : '\u251c\u2500';
+
+    const name = a.type.padEnd(12);
+    const model = shortModelName(a.model).padEnd(8);
+    const duration = formatAgentDuration(a.startTime).padStart(4);
+    const desc = a.description.length > 40 ? a.description.slice(0, 37) + '...' : a.description;
+
+    detailLines.push(
+      `${dim(prefix)} ${cyan(name)}${model}${dim(duration)}   ${desc}`
+    );
+  });
+
+  if (sorted.length > maxLines) {
+    const remaining = sorted.length - maxLines;
+    detailLines.push(`${dim(`\u2514\u2500 +${remaining} more...`)}`);
+  }
+
+  return { headerPart, detailLines };
+}
+
+// ---------------------------------------------------------------------------
+// Session duration
+// ---------------------------------------------------------------------------
+function formatDuration(startDate) {
+  if (!startDate) return null;
+  const ms = Date.now() - startDate.getTime();
+  const minutes = Math.floor(ms / 60000);
+  if (minutes < 60) return `${minutes}m`;
+  const hours = Math.floor(minutes / 60);
+  const remainMinutes = minutes % 60;
+  return `${hours}h${remainMinutes}m`;
+}
+
+function colorizeSession(startDate) {
+  if (!startDate) return `session:${green('0m')}`;
+  const ms = Date.now() - startDate.getTime();
+  const minutes = Math.floor(ms / 60000);
+  const formatted = formatDuration(startDate);
+  const color = minutes > 120 ? red : minutes > 60 ? yellow : green;
+  return `session:${color(formatted)}`;
+}
+
+// ---------------------------------------------------------------------------
+// Main
+// ---------------------------------------------------------------------------
+async function main() {
+  const raw = await readStdin();
+  if (!raw) {
+    console.log('[CREW] no stdin');
+    return;
+  }
+
+  let stdin;
+  try { stdin = JSON.parse(raw); } catch {
+    console.log('[CREW] invalid stdin');
+    return;
+  }
+
+  const cwd = stdin.cwd || process.cwd();
+  const version = getVersion();
+
+  // --- Top line ---
+  const topElements = [];
+
+  const repo = getGitRepo(cwd);
+  if (repo) topElements.push(`repo:${cyan(repo)}`);
+
+  const branch = getGitBranch(cwd);
+  if (branch) {
+    const dirty = hasUncommittedChanges(cwd);
+    const unpushed = hasUnpushedCommits(cwd);
+    const branchDisplay = dirty ? `${branch}*` : branch;
+    const branchColor = unpushed ? yellow : cyan;
+    topElements.push(`branch:${branchColor(branchDisplay)}`);
+  }
+
+  const model = formatModel(stdin);
+  if (model) topElements.push(`model:${cyan(model)}`);
+
+  // --- Middle line ---
+  const midElements = [];
+
+  midElements.push(bold(`[CREW#${version}]`));
+
+  const ctxPct = getContextPercent(stdin);
+  midElements.push(colorizeContext(ctxPct));
+
+  const transcript = parseTranscript(stdin.transcript_path);
+
+  const { headerPart, detailLines } = renderAgentsMultiLine(transcript.agents);
+  if (headerPart) {
+    midElements.push(headerPart);
+  }
+
+  if (transcript.lastSkill) {
+    midElements.push(`skill:${magenta(transcript.lastSkill)}`);
+  }
+
+  midElements.push(colorizeSession(transcript.sessionStart));
+
+  // --- Output ---
+  const outputLines = [];
+  outputLines.push(topElements.join(SEPARATOR));
+  outputLines.push(midElements.join(SEPARATOR));
+  outputLines.push(...detailLines);
+
+  console.log(outputLines.filter(Boolean).join('\n'));
+}
+
+main();

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@jjlabsio/claude-crew",
+  "version": "0.1.3",
+  "description": "1인 SaaS 개발자를 위한 멀티 에이전트 오케스트레이션 — 개발, 마케팅, 일정을 한 대화에서 통합 관리",
+  "author": "Jaejin Song <wowlxx28@gmail.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/jjlabsio/claude-crew.git"
+  },
+  "keywords": [
+    "claude-code",
+    "plugin",
+    "multi-agent",
+    "orchestration",
+    "solo-developer"
+  ],
+  "files": [
+    ".claude-plugin/",
+    "agents/",
+    "skills/",
+    "hooks/",
+    "hud/",
+    "scripts/",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {},
+  "devDependencies": {
+    "changelogen": "^0.6.2"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/scripts/setup-hud.mjs

@@ -0,0 +1,89 @@
+#!/usr/bin/env node
+/**
+ * CREW Session Start Hook
+ *
+ * Checks if statusLine is configured for CREW HUD.
+ * If not, automatically sets it up.
+ * Reads stdin JSON from Claude Code (SessionStart hook input).
+ */
+
+import { existsSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+
+// ---------------------------------------------------------------------------
+// Read stdin (with timeout)
+// ---------------------------------------------------------------------------
+async function readStdin(timeoutMs = 3000) {
+  if (process.stdin.isTTY) return null;
+  return new Promise((resolve) => {
+    let data = '';
+    const timer = setTimeout(() => resolve(data || null), timeoutMs);
+    process.stdin.setEncoding('utf-8');
+    process.stdin.on('data', (chunk) => { data += chunk; });
+    process.stdin.on('end', () => { clearTimeout(timer); resolve(data || null); });
+    process.stdin.on('error', () => { clearTimeout(timer); resolve(null); });
+  });
+}
+
+// ---------------------------------------------------------------------------
+// Main
+// ---------------------------------------------------------------------------
+async function main() {
+  // Consume stdin (required by hook protocol)
+  await readStdin();
+
+  const configDir = process.env.CLAUDE_CONFIG_DIR || join(homedir(), '.claude');
+  const settingsPath = join(configDir, 'settings.json');
+  const pluginRoot = process.env.CLAUDE_PLUGIN_ROOT;
+
+  if (!pluginRoot) {
+    // Not running as a plugin — skip
+    console.log(JSON.stringify({ continue: true }));
+    return;
+  }
+
+  const hudCommand = `node "${pluginRoot}/hud/index.mjs"`;
+
+  try {
+    let settings = {};
+    if (existsSync(settingsPath)) {
+      settings = JSON.parse(readFileSync(settingsPath, 'utf-8'));
+    }
+
+    // Check if statusLine is already set to crew HUD
+    const currentCommand = settings.statusLine?.command || '';
+    if (currentCommand.includes('crew') && currentCommand.includes('hud/index.mjs')) {
+      // Already configured
+      console.log(JSON.stringify({ continue: true }));
+      return;
+    }
+
+    // Set statusLine to crew HUD
+    settings.statusLine = {
+      type: 'command',
+      command: hudCommand,
+    };
+
+    writeFileSync(settingsPath, JSON.stringify(settings, null, 2));
+
+    console.log(JSON.stringify({
+      continue: true,
+      hookSpecificOutput: {
+        hookEventName: 'SessionStart',
+        additionalContext: 'CREW HUD가 자동 설정되었습니다. 다음 세션부터 statusline에 표시됩니다.',
+      },
+    }));
+  } catch (e) {
+    // Non-fatal — don't block session start
+    console.log(JSON.stringify({
+      continue: true,
+      hookSpecificOutput: {
+        hookEventName: 'SessionStart',
+        additionalContext: `CREW HUD 자동 설정 실패: ${e.message}. /crew-setup을 수동 실행해주세요.`,
+      },
+    }));
+  }
+}
+
+main();

package/skills/crew/SKILL.md

@@ -0,0 +1,187 @@
+---
+name: crew
+description: crew-plan과 crew-dev를 연결하는 오케스트레이터 — 유저 요청을 받아 PR 생성까지
+---
+
+## 역할
+
+유저 요청을 받아 crew-plan(계획)과 crew-dev(구현)를 순차 실행하여 PR을 생성한다.
+코드를 작성하지 않는다. 에이전트에게 위임한다.
+
+---
+
+## 절대 금지
+
+- 코드를 직접 작성, 수정, 검토하지 않는다.
+- 기획, 계획, 검증을 직접 수행하지 않는다. 해당 에이전트에게 위임한다.
+- 에이전트가 FAIL을 냈을 때 합리화하여 통과시키지 않는다.
+
+---
+
+## 실행 순서
+
+### Step 1 — 초기 셋업
+
+`.crew/` 폴더가 없으면 생성한다.
+
+```bash
+mkdir -p .crew/plans
+```
+
+### Step 2 — 의도 분류
+
+유저 요청을 2가지로 분류한다:
+
+| 유형 | 기준 | PM 관여 | 예시 |
+|------|------|---------|------|
+| **유저 가치** | 유저가 변화를 인지함 | O | 기능 추가, UI 변경, 플로우 수정 |
+| **엔지니어링** | 유저가 변화를 인지하지 못함 | X | 리팩토링, 마이그레이션, 버그 수정, 인프라, 성능, 테스트 |
+
+분류 기준: **"이 작업의 결과를 유저(사용자)가 인지하는가?"**
+
+애매하면 유저에게 물어본다.
+
+### Step 3 — task-id 생성
+
+task-id를 생성한다. 형식: `{간결한-영문-슬러그}` (예: `add-search-filter`, `fix-auth-timeout`)
+
+```bash
+mkdir -p .crew/plans/{task-id}
+```
+
+### Step 4 — crew-plan 실행
+
+crew-plan 파이프라인을 실행한다.
+
+오케스트레이터가 crew-plan에 전달할 정보:
+- task-id
+- 의도 유형 (유저 가치 / 엔지니어링)
+- 유저 요청 원문 (brief.md 작성용)
+
+crew-plan의 반환을 확인한다:
+- **COMPLETE** → contract.md 경로를 확인하고 Step 5로 진행
+- **ESCALATE** → 유저에게 에스컬레이션 내용을 전달하고, 유저 응답에 따라 재시도 또는 보류
+
+### Step 5 — crew-dev 실행
+
+crew-dev 파이프라인을 실행한다.
+
+오케스트레이터가 crew-dev에 전달할 정보:
+- task-id
+
+crew-dev의 반환을 확인한다:
+- **COMPLETE** → PR URL을 유저에게 전달
+- **ESCALATE** → 유저에게 에스컬레이션 내용을 전달하고, 유저 응답에 따라 재시도 또는 보류
+
+### Step 6 — 완료 보고
+
+유저에게 최종 결과를 보고한다:
+- task-id
+- PR URL
+- 주요 변경 사항 요약
+
+---
+
+## 에스컬레이션 처리
+
+에스컬레이션은 유저에게 선택지를 제시하고 응답을 기다린다.
+유저 응답에 따라:
+
+- **재시도**: 해당 파이프라인의 실패 지점부터 재실행
+- **수정**: 유저가 직접 파일을 수정한 후 재실행
+- **보류**: 상태를 BLOCKED으로 갱신하고 종료
+
+---
+
+## 산출물 파일 구조
+
+```
+.crew/plans/{task-id}/
+  # crew-plan 산출물
+  brief.md          # 오케스트레이터: 유저 원본 요청
+  spec.md           # PM: 수용 기준, 스코프 (유저 가치 유형만)
+  analysis.md       # TechLead: 사전 분석 결과
+  plan.md           # Planner: 구현 계획
+  review.md         # PlanEvaluator: 검증 결과 (최신)
+  plan-{n}.md       # 실패한 계획 아카이브
+  review-{n}.md     # 실패한 리뷰 아카이브
+  contract.md       # 최종 계약 (PASS 시만 생성)
+  .loop_count       # 계획 루프 카운터
+
+  # crew-dev 산출물
+  dev-log.md        # Dev: 구현 진행 로그
+  review-report.md  # CodeReviewer: 코드 리뷰 결과 (최신)
+  qa-report.md      # QA: 실행 검증 결과 (최신)
+  review-report-{n}.md  # FAIL 시 아카이브
+  qa-report-{n}.md      # FAIL 시 아카이브
+  .dev_loop_count       # 개발 루프 카운터
+```
+
+---
+
+## contract.md 구조
+
+PlanEvaluator PASS 후 crew-plan이 생성한다.
+
+```markdown
+# 스프린트 계약: {task-id}
+
+생성일: {date}
+유형: {유저 가치 | 엔지니어링}
+
+## 목표
+{한 문장}
+
+## 수용 기준
+- [ ] {testable 기준 1}
+- [ ] {testable 기준 2}
+
+## 가드레일
+### Must
+- {TechLead가 정의한 필수 사항}
+
+### Must NOT
+- {TechLead가 정의한 금지 사항}
+
+## 검증 시나리오
+
+### {시나리오 1 제목}
+- 조건: {사전 상태}
+- 행위: {실행할 것}
+- 기대 결과: {검증할 것}
+
+## 참조 문서
+- 사전 분석: .crew/plans/{task-id}/analysis.md
+- 구현 계획: .crew/plans/{task-id}/plan.md
+
+## 검증 이력
+PlanEvaluator PASS — review.md 참조
+
+## 상태
+ACTIVE
+```
+
+---
+
+## 에이전트 라인업
+
+### crew-plan
+| 에이전트 | 모델 | 역할 |
+|----------|------|------|
+| PM | Opus | 유저 인터뷰, spec.md 작성 (유저 가치만) |
+| TechLead | Opus | 사전 분석, 아키텍처 방향, 가드레일 |
+| Planner | Opus | 계획 문서 작성 |
+| PlanEvaluator | Sonnet | E1-E4 하드 임계값 검증 |
+
+### crew-dev
+| 에이전트 | 모델 | 역할 |
+|----------|------|------|
+| Dev | Opus | 코드 구현 + 자체 검증 |
+| CodeReviewer | Opus | 코드 품질 + 가드레일 위반 판정 |
+| QA | Sonnet | 실행 검증 (빌드/테스트/E2E) |
+
+### 공유 서브에이전트
+| 에이전트 | 모델 | 역할 |
+|----------|------|------|
+| Explorer | Haiku | 코드베이스 탐색 (병렬, Read-only) |
+| Researcher | Sonnet | 외부 정보 조사 (필요시만, Read-only) |