agent-hive 0.1.0

package/README.md

@@ -0,0 +1,95 @@
+# claude-colony
+
+**기존 Git 레포에 붙이는 AI 개발 파이프라인 서버.**
+
+서버를 띄우면 Claude 세션이 워커/리뷰어로 자율 동작하며
+이슈 관리 → 개발 → PR → 코드 리뷰 → 머지 요청까지 자동화합니다.
+머지는 반드시 유저가 직접 승인합니다.
+
+## 어떻게 동작하나
+
+```
+npx claude-colony init --repo owner/repo --target-repo ./my-project --token ghp_xxx
+npx claude-colony start
+```
+
+```
+┌─────────────────────────────────────────────────┐
+│  claude-colony server                           │
+│                                                 │
+│  ┌──────────┐    PR 생성    ┌──────────┐        │
+│  │  워커     │ ───────────→ │  리뷰어   │        │
+│  │  세션     │ ←─────────── │  세션     │        │
+│  └──────────┘  코멘트 핑퐁  └──────────┘        │
+│       │                          │              │
+│       ▼                          ▼              │
+│  ┌──────────────────────────────────────┐       │
+│  │  GitHub (Issues, PR, Webhook)        │       │
+│  └──────────────────────────────────────┘       │
+│       │                                         │
+│       ▼                                         │
+│  ┌──────────────────────────────────────┐       │
+│  │  Obsidian vault (선택)               │       │
+│  │  작업 기록 축적 + SSoT 승격          │       │
+│  └──────────────────────────────────────┘       │
+│                                                 │
+└─────────────────────────────────────────────────┘
+        │
+        ▼
+   유저가 최종 머지 승인
+```
+
+## 핵심 기능
+
+- **워커 세션** — 브랜치별로 스폰, 코드 작성, PR 생성
+- **리뷰어 세션** — PR 트리거로 자동 스폰, 코드 리뷰, 워커와 핑퐁
+- **이슈 관리** — GitHub Issues 자동 생성/라벨링/close
+- **장기 기억** — Obsidian vault에 작업 기록 축적, 컨텍스트 유실 방지
+- **머지 보호** — init 시 브랜치 보호 규칙 자동 설정, AI가 머지 불가
+
+## 왜 쓰는가
+
+| 문제 | claude-colony의 해결 |
+|------|----------------------|
+| AI가 코드 리뷰 없이 머지 | 워커-리뷰어 분리 + 유저 최종 승인 강제 |
+| 새 세션이 이전 맥락을 모름 | 작업 기록서 + SSoT로 컨텍스트 복원 |
+| 이슈/PR 수동 관리 | 자동 생성, 라벨링, 연결, close |
+| AI 에이전트 설정이 복잡 | `npx claude-colony init` 한 줄로 끝 |
+
+## 빠른 시작
+
+```bash
+# 1. 초기화 (config 생성 + GitHub 브랜치 보호 설정)
+npx claude-colony init \
+  --repo owner/repo \
+  --target-repo /path/to/repo \
+  --token ghp_xxx
+
+# 2. 서버 시작
+npx claude-colony start
+```
+
+## 문서
+
+- [설치 및 설정 가이드](docs/setup.md)
+- [프로젝트 명세](claude-colony-SPEC.md)
+- [코드 컨벤션](CONVENTIONS.md)
+
+## 프로젝트 구조
+
+```
+src/
+├── cli.ts              ← CLI 진입점 (init, start)
+├── index.ts            ← 서버 진입점
+├── config.ts           ← 설정 로드/검증
+├── commands/
+│   └── init.ts         ← init 명령어
+├── core/               ← 세션 스폰, 로거, 이벤트 감시
+├── github/             ← Webhook, Issues, PR
+├── obsidian/           ← Vault 초기화, 기록서, SSoT
+└── prompts/            ← 워커/리뷰어 규칙 템플릿
+```
+
+## 라이센스
+
+MIT

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.js

@@ -0,0 +1,61 @@
+#!/usr/bin/env node
+import { logger } from './core/logger.js';
+import { ColonyError } from './core/errors.js';
+const USAGE_TEXT = `Usage: claude-colony <command> [options]
+
+Commands:
+  init          Initialize a new colony project
+  get <issue>   Fetch a GitHub issue and spawn a Worker+Reviewer team
+
+Options:
+  --help  Show this help message
+
+Init options:
+  --repo <owner/repo>        GitHub repository (required)
+  --target-repo <path>       Path to local repository (required)
+  --base-branch <branch>     Base branch name (default: main)
+  --obsidian-vault <path>    Obsidian vault path (optional)
+
+Get examples:
+  claude-colony get 42
+  claude-colony get #42
+  claude-colony get https://github.com/owner/repo/issues/42`;
+function parseCommand(args) {
+    const positional = args.filter((a) => !a.startsWith('--'));
+    return positional[0];
+}
+function hasFlag(args, flag) {
+    return args.includes(flag);
+}
+async function run() {
+    const args = process.argv.slice(2);
+    if (hasFlag(args, '--help') || args.length === 0) {
+        logger.info(USAGE_TEXT);
+        return;
+    }
+    const command = parseCommand(args);
+    if (command === 'init') {
+        const { runInit } = await import('./commands/init.js');
+        await runInit(args);
+        return;
+    }
+    if (command === 'get') {
+        const { runGet } = await import('./commands/get.js');
+        const getArgs = args.filter((a) => a !== 'get');
+        await runGet(getArgs);
+        return;
+    }
+    logger.error(`Unknown command: ${command}`);
+    logger.info(USAGE_TEXT);
+    process.exit(1);
+}
+run().catch((err) => {
+    if (err instanceof ColonyError) {
+        logger.error(err.message, { code: err.code });
+    }
+    else {
+        logger.error('Fatal error', { error: String(err) });
+    }
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,MAAM,UAAU,GAAG;;;;;;;;;;;;;;;;;;4DAkByC,CAAC;AAE7D,SAAS,YAAY,CAAC,IAAc;IAClC,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;IAC3D,OAAO,UAAU,CAAC,CAAC,CAAC,CAAC;AACvB,CAAC;AAED,SAAS,OAAO,CAAC,IAAc,EAAE,IAAY;IAC3C,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AAC7B,CAAC;AAED,KAAK,UAAU,GAAG;IAChB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAEnC,IAAI,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjD,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACxB,OAAO;IACT,CAAC;IAED,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IAEnC,IAAI,OAAO,KAAK,MAAM,EAAE,CAAC;QACvB,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;QACvD,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;QACpB,OAAO;IACT,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,EAAE,CAAC;QACtB,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAC;QACrD,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC;QAChD,MAAM,MAAM,CAAC,OAAO,CAAC,CAAC;QACtB,OAAO;IACT,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,oBAAoB,OAAO,EAAE,CAAC,CAAC;IAC5C,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACxB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;IAC3B,IAAI,GAAG,YAAY,WAAW,EAAE,CAAC;QAC/B,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;IAChD,CAAC;SAAM,CAAC;QACN,MAAM,CAAC,KAAK,CAAC,aAAa,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACtD,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/commands/get.d.ts

@@ -0,0 +1,2 @@
+export declare function runGet(args: string[]): Promise<void>;
+//# sourceMappingURL=get.d.ts.map

package/dist/commands/get.js

@@ -0,0 +1,39 @@
+import { loadConfig } from '../config.js';
+import { GithubError } from '../core/errors.js';
+import { logger } from '../core/logger.js';
+import { spawnLeadSession } from '../core/session-spawner.js';
+import { getIssue } from '../github/issues.js';
+import { initVault } from '../obsidian/vault-init.js';
+function parseIssueRef(input) {
+    const urlMatch = input.match(/github\.com\/[\w.-]+\/[\w.-]+\/issues\/(\d+)/);
+    if (urlMatch)
+        return urlMatch[1];
+    const shortMatch = input.match(/^[\w.-]+\/[\w.-]+#(\d+)$/);
+    if (shortMatch)
+        return shortMatch[1];
+    if (/^\d+$/.test(input))
+        return input;
+    if (/^#\d+$/.test(input))
+        return input.slice(1);
+    throw new GithubError(`Invalid issue reference: ${input}`);
+}
+export async function runGet(args) {
+    const issueRef = args.find((a) => !a.startsWith('--'));
+    if (!issueRef) {
+        throw new GithubError('Usage: claude-colony get <issue-number-or-url>');
+    }
+    const config = await loadConfig();
+    if (config.obsidian) {
+        await initVault(config);
+    }
+    const issueNumber = parseIssueRef(issueRef);
+    const issue = await getIssue(config, issueNumber);
+    logger.info(`Issue #${issue.number}: ${issue.title}`);
+    await spawnLeadSession({
+        config,
+        issueNumber: issue.number,
+        issueTitle: issue.title,
+        issueBody: issue.body,
+    });
+}
+//# sourceMappingURL=get.js.map

package/dist/commands/get.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get.js","sourceRoot":"","sources":["../../src/commands/get.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAEtD,SAAS,aAAa,CAAC,KAAa;IAClC,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAC7E,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC;IAEjC,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC;IAC3D,IAAI,UAAU;QAAE,OAAO,UAAU,CAAC,CAAC,CAAC,CAAC;IAErC,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACtC,IAAI,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAEhD,MAAM,IAAI,WAAW,CAAC,4BAA4B,KAAK,EAAE,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,IAAc;IACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;IACvD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,WAAW,CAAC,gDAAgD,CAAC,CAAC;IAC1E,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,UAAU,EAAE,CAAC;IAElC,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACpB,MAAM,SAAS,CAAC,MAAM,CAAC,CAAC;IAC1B,CAAC;IAED,MAAM,WAAW,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;IAC5C,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAElD,MAAM,CAAC,IAAI,CAAC,UAAU,KAAK,CAAC,MAAM,KAAK,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;IAEtD,MAAM,gBAAgB,CAAC;QACrB,MAAM;QACN,WAAW,EAAE,KAAK,CAAC,MAAM;QACzB,UAAU,EAAE,KAAK,CAAC,KAAK;QACvB,SAAS,EAAE,KAAK,CAAC,IAAI;KACtB,CAAC,CAAC;AACL,CAAC"}

package/dist/commands/init.d.ts

@@ -0,0 +1,2 @@
+export declare function runInit(args: string[]): Promise<void>;
+//# sourceMappingURL=init.d.ts.map

package/dist/commands/init.js

@@ -0,0 +1,64 @@
+import { writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { ConfigError } from '../core/errors.js';
+import { logger } from '../core/logger.js';
+import { initVault } from '../obsidian/vault-init.js';
+const DEFAULT_BASE_BRANCH = 'main';
+function getArgValue(args, flag) {
+    const idx = args.indexOf(flag);
+    if (idx === -1 || idx + 1 >= args.length)
+        return undefined;
+    return args[idx + 1];
+}
+function parseInitArgs(args) {
+    const repo = getArgValue(args, '--repo');
+    const targetRepo = getArgValue(args, '--target-repo');
+    if (!repo)
+        throw new ConfigError('--repo is required (e.g., owner/repo)');
+    if (!targetRepo)
+        throw new ConfigError('--target-repo is required (e.g., /path/to/repo)');
+    return {
+        repo,
+        targetRepo,
+        baseBranch: getArgValue(args, '--base-branch') ?? DEFAULT_BASE_BRANCH,
+        obsidianVault: getArgValue(args, '--obsidian-vault') ?? '',
+    };
+}
+function buildConfigJson(options) {
+    const config = {
+        targetRepo: options.targetRepo,
+        github: {
+            repo: options.repo,
+            baseBranch: options.baseBranch,
+        },
+    };
+    if (options.obsidianVault) {
+        config.obsidian = {
+            vaultPath: options.obsidianVault,
+        };
+    }
+    return JSON.stringify(config, null, 2);
+}
+export async function runInit(args) {
+    const options = parseInitArgs(args);
+    const outputDir = process.cwd();
+    const configContent = buildConfigJson(options);
+    await writeFile(path.join(outputDir, 'colony.config.json'), configContent, 'utf-8');
+    logger.info('Created colony.config.json');
+    if (options.obsidianVault) {
+        const tempConfig = {
+            targetRepo: options.targetRepo,
+            github: { repo: options.repo, baseBranch: options.baseBranch },
+            obsidian: { vaultPath: options.obsidianVault },
+        };
+        await initVault(tempConfig);
+        logger.info('Obsidian vault initialized', { path: options.obsidianVault });
+    }
+    logger.info('Initialization complete', {
+        repo: options.repo,
+        targetRepo: options.targetRepo,
+        baseBranch: options.baseBranch,
+        obsidian: options.obsidianVault || 'disabled',
+    });
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"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"}

package/dist/config.d.ts

@@ -0,0 +1,15 @@
+export interface GithubConfig {
+    repo: string;
+    baseBranch: string;
+}
+export interface ObsidianConfig {
+    vaultPath: string;
+}
+export interface ColonyConfig {
+    targetRepo: string;
+    github: GithubConfig;
+    obsidian?: ObsidianConfig;
+}
+export { ConfigError } from './core/errors.js';
+export declare function loadConfig(configDir?: string): Promise<ColonyConfig>;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.js

@@ -0,0 +1,52 @@
+import { readFile } from 'node:fs/promises';
+import path from 'node:path';
+import dotenv from 'dotenv';
+import { ConfigError } from './core/errors.js';
+function loadEnv(configDir) {
+    dotenv.config({ path: path.join(configDir, '.env') });
+}
+async function loadConfigFile(configDir) {
+    const configPath = path.join(configDir, 'colony.config.json');
+    try {
+        const content = await readFile(configPath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch {
+        return {};
+    }
+}
+function validateConfig(config) {
+    if (!config.targetRepo) {
+        throw new ConfigError('targetRepo is required in colony.config.json');
+    }
+    if (!config.github.repo) {
+        throw new ConfigError('github.repo is required in colony.config.json');
+    }
+    if (config.obsidian && !config.obsidian.vaultPath) {
+        throw new ConfigError('obsidian.vaultPath is required when obsidian is configured');
+    }
+}
+export { ConfigError } from './core/errors.js';
+export async function loadConfig(configDir) {
+    const dir = configDir ?? process.cwd();
+    loadEnv(dir);
+    const raw = await loadConfigFile(dir);
+    const config = {
+        targetRepo: raw.targetRepo ?? '',
+        github: {
+            repo: raw.github?.repo ?? '',
+            baseBranch: raw.github?.baseBranch ?? 'main',
+        },
+    };
+    if (raw.obsidian) {
+        if (raw.obsidian.vaultPath) {
+            config.obsidian = { vaultPath: raw.obsidian.vaultPath };
+        }
+        else {
+            throw new ConfigError('obsidian.vaultPath is required when obsidian is configured');
+        }
+    }
+    validateConfig(config);
+    return config;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,MAAM,MAAM,QAAQ,CAAC;AAE5B,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAuB/C,SAAS,OAAO,CAAC,SAAiB;IAChC,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;AACxD,CAAC;AAED,KAAK,UAAU,cAAc,CAAC,SAAiB;IAC7C,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,oBAAoB,CAAC,CAAC;IAC9D,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QACpD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAc,CAAC;IAC1C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,SAAS,cAAc,CAAC,MAAoB;IAC1C,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;QACvB,MAAM,IAAI,WAAW,CAAC,8CAA8C,CAAC,CAAC;IACxE,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QACxB,MAAM,IAAI,WAAW,CAAC,+CAA+C,CAAC,CAAC;IACzE,CAAC;IAED,IAAI,MAAM,CAAC,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC;QAClD,MAAM,IAAI,WAAW,CAAC,4DAA4D,CAAC,CAAC;IACtF,CAAC;AACH,CAAC;AAED,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,SAAkB;IACjD,MAAM,GAAG,GAAG,SAAS,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAEvC,OAAO,CAAC,GAAG,CAAC,CAAC;IACb,MAAM,GAAG,GAAG,MAAM,cAAc,CAAC,GAAG,CAAC,CAAC;IAEtC,MAAM,MAAM,GAAiB;QAC3B,UAAU,EAAE,GAAG,CAAC,UAAU,IAAI,EAAE;QAChC,MAAM,EAAE;YACN,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,IAAI,EAAE;YAC5B,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,IAAI,MAAM;SAC7C;KACF,CAAC;IAEF,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC;QACjB,IAAI,GAAG,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC;YAC3B,MAAM,CAAC,QAAQ,GAAG,EAAE,SAAS,EAAE,GAAG,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC;QAC1D,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,WAAW,CAAC,4DAA4D,CAAC,CAAC;QACtF,CAAC;IACH,CAAC;IAED,cAAc,CAAC,MAAM,CAAC,CAAC;IAEvB,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/core/errors.d.ts

@@ -0,0 +1,14 @@
+export declare class ColonyError extends Error {
+    readonly code: string;
+    constructor(message: string, code: string);
+}
+export declare class ConfigError extends ColonyError {
+    constructor(message: string);
+}
+export declare class GithubError extends ColonyError {
+    constructor(message: string);
+}
+export declare class ObsidianError extends ColonyError {
+    constructor(message: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/core/errors.js

@@ -0,0 +1,27 @@
+export class ColonyError extends Error {
+    code;
+    constructor(message, code) {
+        super(message);
+        this.code = code;
+        this.name = 'ColonyError';
+    }
+}
+export class ConfigError extends ColonyError {
+    constructor(message) {
+        super(message, 'CONFIG_ERROR');
+        this.name = 'ConfigError';
+    }
+}
+export class GithubError extends ColonyError {
+    constructor(message) {
+        super(message, 'GITHUB_ERROR');
+        this.name = 'GithubError';
+    }
+}
+export class ObsidianError extends ColonyError {
+    constructor(message) {
+        super(message, 'OBSIDIAN_ERROR');
+        this.name = 'ObsidianError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/core/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,WAAY,SAAQ,KAAK;IAGlB;IAFlB,YACE,OAAe,EACC,IAAY;QAE5B,KAAK,CAAC,OAAO,CAAC,CAAC;QAFC,SAAI,GAAJ,IAAI,CAAQ;QAG5B,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF;AAED,MAAM,OAAO,WAAY,SAAQ,WAAW;IAC1C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;QAC/B,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF;AAED,MAAM,OAAO,WAAY,SAAQ,WAAW;IAC1C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;QAC/B,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF;AAED,MAAM,OAAO,aAAc,SAAQ,WAAW;IAC5C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC;QACjC,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF"}

package/dist/core/logger.d.ts

@@ -0,0 +1,7 @@
+export declare const logger: {
+    debug: (message: string, context?: Record<string, unknown>) => void;
+    info: (message: string, context?: Record<string, unknown>) => void;
+    warn: (message: string, context?: Record<string, unknown>) => void;
+    error: (message: string, context?: Record<string, unknown>) => void;
+};
+//# sourceMappingURL=logger.d.ts.map

package/dist/core/logger.js

@@ -0,0 +1,37 @@
+const LOG_LEVEL_PRIORITY = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+};
+function formatLog(entry) {
+    const ctx = entry.context ? ` ${JSON.stringify(entry.context)}` : '';
+    return `[${entry.timestamp}] [${entry.level.toUpperCase()}] ${entry.message}${ctx}`;
+}
+function createLogger(minLevel = 'info') {
+    function log(level, message, context) {
+        if (LOG_LEVEL_PRIORITY[level] < LOG_LEVEL_PRIORITY[minLevel])
+            return;
+        const entry = {
+            level,
+            message,
+            timestamp: new Date().toISOString(),
+            context,
+        };
+        const formatted = formatLog(entry);
+        if (level === 'error') {
+            process.stderr.write(formatted + '\n');
+        }
+        else {
+            process.stdout.write(formatted + '\n');
+        }
+    }
+    return {
+        debug: (message, context) => log('debug', message, context),
+        info: (message, context) => log('info', message, context),
+        warn: (message, context) => log('warn', message, context),
+        error: (message, context) => log('error', message, context),
+    };
+}
+export const logger = createLogger();
+//# sourceMappingURL=logger.js.map

package/dist/core/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/core/logger.ts"],"names":[],"mappings":"AAEA,MAAM,kBAAkB,GAA6B;IACnD,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;CACT,CAAC;AASF,SAAS,SAAS,CAAC,KAAe;IAChC,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACrE,OAAO,IAAI,KAAK,CAAC,SAAS,MAAM,KAAK,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,KAAK,CAAC,OAAO,GAAG,GAAG,EAAE,CAAC;AACtF,CAAC;AAED,SAAS,YAAY,CAAC,WAAqB,MAAM;IAM/C,SAAS,GAAG,CAAC,KAAe,EAAE,OAAe,EAAE,OAAiC;QAC9E,IAAI,kBAAkB,CAAC,KAAK,CAAC,GAAG,kBAAkB,CAAC,QAAQ,CAAC;YAAE,OAAO;QAErE,MAAM,KAAK,GAAa;YACtB,KAAK;YACL,OAAO;YACP,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,OAAO;SACR,CAAC;QAEF,MAAM,SAAS,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;QAEnC,IAAI,KAAK,KAAK,OAAO,EAAE,CAAC;YACtB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;QACzC,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;IAED,OAAO;QACL,KAAK,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC;QAC3D,IAAI,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC;QACzD,IAAI,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC;QACzD,KAAK,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC;KAC5D,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC"}

package/dist/core/session-spawner.d.ts

@@ -0,0 +1,9 @@
+import type { ColonyConfig } from '../config.js';
+export interface LeadSessionOptions {
+    config: ColonyConfig;
+    issueNumber: number;
+    issueTitle: string;
+    issueBody: string;
+}
+export declare function spawnLeadSession(options: LeadSessionOptions): Promise<void>;
+//# sourceMappingURL=session-spawner.d.ts.map

package/dist/core/session-spawner.js

@@ -0,0 +1,73 @@
+import { spawn } from 'node:child_process';
+import { readFile } from 'node:fs/promises';
+import path from 'node:path';
+import { logger } from './logger.js';
+async function loadPromptFile(filename) {
+    const filePath = path.join(import.meta.dirname ?? '.', '..', 'prompts', filename);
+    return readFile(filePath, 'utf-8');
+}
+function renderTemplate(template, vars) {
+    let result = template;
+    for (const [key, value] of Object.entries(vars)) {
+        result = result.replaceAll(`{${key}}`, value);
+    }
+    return result;
+}
+function buildVaultSection(config) {
+    if (!config.obsidian) {
+        return 'Obsidian vault는 비활성화 상태입니다.';
+    }
+    return [
+        `Vault 경로: ${config.obsidian.vaultPath}`,
+        '- 작업 기록은 vault/sessions/ 에 저장한다.',
+        '- 컨벤션/패턴은 vault/context/CLAUDE.md 를 참조한다.',
+        '- 중요 결정사항은 [SSoT] 태그로 기록하여 승격 대상으로 표시한다.',
+    ].join('\n');
+}
+async function buildLeadPrompt(options) {
+    const [leadTemplate, workerRules, reviewerRules] = await Promise.all([
+        loadPromptFile('lead.md'),
+        loadPromptFile('worker.md'),
+        loadPromptFile('reviewer.md'),
+    ]);
+    return renderTemplate(leadTemplate, {
+        repo: options.config.github.repo,
+        'target-repo': options.config.targetRepo,
+        'base-branch': options.config.github.baseBranch,
+        'issue-number': String(options.issueNumber),
+        'issue-title': options.issueTitle,
+        'issue-body': options.issueBody,
+        'worker-rules': workerRules,
+        'reviewer-rules': reviewerRules,
+        'vault-section': buildVaultSection(options.config),
+    });
+}
+export async function spawnLeadSession(options) {
+    const prompt = await buildLeadPrompt(options);
+    logger.info('Spawning lead session...', {
+        issue: `#${options.issueNumber}`,
+        repo: options.config.github.repo,
+    });
+    return new Promise((resolve, reject) => {
+        const child = spawn('claude', ['-p', prompt], {
+            cwd: options.config.targetRepo,
+            stdio: 'inherit',
+            env: {
+                ...process.env,
+                CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS: '1',
+            },
+        });
+        child.on('error', (err) => {
+            reject(new Error(`Failed to spawn claude: ${err.message}`));
+        });
+        child.on('exit', (code) => {
+            if (code === 0) {
+                resolve();
+            }
+            else {
+                reject(new Error(`Lead session exited with code ${code}`));
+            }
+        });
+    });
+}
+//# sourceMappingURL=session-spawner.js.map

package/dist/core/session-spawner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-spawner.js","sourceRoot":"","sources":["../../src/core/session-spawner.ts"],"names":[],"mappings":"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"}

package/dist/github/issues.d.ts

@@ -0,0 +1,26 @@
+import type { ColonyConfig } from '../config.js';
+declare const IssueLabel: {
+    readonly Backlog: "backlog";
+    readonly InProgress: "in-progress";
+    readonly Blocked: "blocked";
+};
+type IssueLabel = (typeof IssueLabel)[keyof typeof IssueLabel];
+export { IssueLabel };
+export interface IssueInfo {
+    number: number;
+    title: string;
+    state: 'open' | 'closed';
+    labels: string[];
+    url: string;
+}
+export declare function getIssue(config: ColonyConfig, issueRef: string): Promise<IssueInfo & {
+    body: string;
+}>;
+export declare function createIssue(config: ColonyConfig, options: {
+    title: string;
+    body: string;
+    labels?: string[];
+}): Promise<IssueInfo>;
+export declare function updateLabel(config: ColonyConfig, issueNumber: number, label: IssueLabel): Promise<void>;
+export declare function closeIssue(config: ColonyConfig, issueNumber: number): Promise<void>;
+//# sourceMappingURL=issues.d.ts.map