onto-mcp 0.3.2 → 0.4.0

package/dist/core-runtime/evolve/commands/start.test.js

@@ -1,396 +0,0 @@
-import { describe, it, expect, beforeEach, afterEach, vi } from "vitest";
-import { mkdtempSync, writeFileSync, readFileSync, rmSync, mkdirSync, existsSync } from "node:fs";
-import { join } from "node:path";
-import { tmpdir } from "node:os";
-import { executeStart, findExistingScope } from "./start.js";
-import { readEvents } from "../../scope-runtime/event-store.js";
-import { reduce } from "../../scope-runtime/reducer.js";
-import { createScope } from "../../scope-runtime/scope-manager.js";
-import { appendScopeEvent } from "../../scope-runtime/event-pipeline.js";
-let projectDir;
-let scopesDir;
-beforeEach(() => {
-    projectDir = mkdtempSync(join(tmpdir(), "sprint-start-"));
-    scopesDir = join(projectDir, "scopes");
-    mkdirSync(scopesDir, { recursive: true });
-});
-afterEach(() => {
-    rmSync(projectDir, { recursive: true, force: true });
-});
-function makeInput(overrides = {}) {
-    return {
-        rawInput: "튜터 차단 기능 추가",
-        projectRoot: projectDir,
-        scopesDir,
-        scopeId: "SC-TEST-001",
-        title: "튜터 차단 기능",
-        ...overrides,
-    };
-}
-describe("executeStart", () => {
-    it("creates scope and records events with local source", async () => {
-        // Create a local source directory
-        const srcDir = join(projectDir, "app-src");
-        mkdirSync(srcDir, { recursive: true });
-        writeFileSync(join(srcDir, "app.ts"), 'import { foo } from "./foo";');
-        writeFileSync(join(srcDir, "foo.ts"), "export const foo = 1;");
-        const result = await executeStart(makeInput({
-            rawInput: `튜터 차단 --add-dir ${srcDir}`,
-        }));
-        expect(result.success).toBe(true);
-        if (!result.success)
-            return;
-        // Verify scope was created
-        expect(result.paths.scopeId).toBe("SC-TEST-001");
-        // Verify scan results
-        const startResult = result;
-        expect(startResult.scanResults).toHaveLength(1);
-        expect(startResult.scanResults[0].files.length).toBeGreaterThanOrEqual(2);
-        expect(startResult.totalFiles).toBeGreaterThanOrEqual(2);
-        // Verify source_hashes uses {type}:{identifier} keys
-        const hashKeys = Object.keys(startResult.sourceHashes);
-        expect(hashKeys.length).toBe(1);
-        expect(hashKeys[0]).toMatch(/^add-dir:/);
-        // Verify events were recorded
-        const events = readEvents(result.paths.events);
-        const types = events.map(e => e.type);
-        expect(types).toContain("scope.created");
-        expect(types).toContain("grounding.started");
-        expect(types).toContain("grounding.completed");
-        // Verify state
-        const state = reduce(events);
-        expect(state.current_state).toBe("grounded");
-        expect(state.title).toBe("튜터 차단 기능");
-        expect(state.grounding_sources).toHaveLength(1);
-        // Verify reality-snapshot.json was written
-        const snapshot = JSON.parse(readFileSync(result.paths.realitySnapshot, "utf-8"));
-        expect(snapshot.scope_id).toBe("SC-TEST-001");
-        expect(snapshot.source_hashes).toEqual(startResult.sourceHashes);
-        // Verify sources.yaml was written
-        const sourcesContent = readFileSync(result.paths.sourcesYaml, "utf-8");
-        expect(sourcesContent).toContain("add-dir");
-    });
-    it("merges .sprint-kit.yaml defaults with /start flags", async () => {
-        // Create .sprint-kit.yaml with a default source
-        const defaultSrcDir = join(projectDir, "default-src");
-        mkdirSync(defaultSrcDir, { recursive: true });
-        writeFileSync(join(defaultSrcDir, "default.ts"), "const d = 1;");
-        writeFileSync(join(projectDir, ".sprint-kit.yaml"), `default_sources:\n  - type: add-dir\n    path: ${defaultSrcDir}\n    description: default source\n`);
-        // Add another source via /start flag
-        const flagSrcDir = join(projectDir, "flag-src");
-        mkdirSync(flagSrcDir, { recursive: true });
-        writeFileSync(join(flagSrcDir, "flag.ts"), "const f = 1;");
-        const result = await executeStart(makeInput({
-            rawInput: `기능 추가 --add-dir ${flagSrcDir}`,
-        }));
-        expect(result.success).toBe(true);
-        if (!result.success)
-            return;
-        // Both sources scanned
-        const mergeResult = result;
-        expect(mergeResult.scanResults).toHaveLength(2);
-        expect(Object.keys(mergeResult.sourceHashes)).toHaveLength(2);
-    });
-    it("fails when no sources are specified", async () => {
-        const result = await executeStart(makeInput({
-            rawInput: "기능 추가",
-        }));
-        expect(result.success).toBe(false);
-        if (result.success)
-            return;
-        expect(result.step).toBe("resolve_sources");
-        expect(result.reason).toContain("소스가 없습니다");
-    });
-    it("reports scan errors without stopping", async () => {
-        // Create one valid source
-        const srcDir = join(projectDir, "valid-src");
-        mkdirSync(srcDir, { recursive: true });
-        writeFileSync(join(srcDir, "app.ts"), "const a = 1;");
-        const result = await executeStart(makeInput({
-            rawInput: `기능 추가 --add-dir ${srcDir} --add-dir /nonexistent/path`,
-        }));
-        expect(result.success).toBe(true);
-        if (!result.success)
-            return;
-        // One success, one empty (nonexistent path returns empty, not error)
-        expect(result.scanResults).toHaveLength(2);
-    });
-    it("calls onProgress callback", async () => {
-        const srcDir = join(projectDir, "src");
-        mkdirSync(srcDir, { recursive: true });
-        writeFileSync(join(srcDir, "a.ts"), "const a = 1;");
-        const messages = [];
-        const result = await executeStart(makeInput({
-            rawInput: `차단 --add-dir ${srcDir}`,
-            onProgress: (msg) => messages.push(msg),
-        }));
-        expect(result.success).toBe(true);
-        expect(messages.length).toBeGreaterThanOrEqual(2);
-        expect(messages[0]).toContain("소스 스캔을 시작합니다");
-        expect(messages[messages.length - 1]).toContain("소스 스캔 완료");
-    });
-    it("uses experience as default entry_mode", async () => {
-        const srcDir = join(projectDir, "src");
-        mkdirSync(srcDir, { recursive: true });
-        writeFileSync(join(srcDir, "a.ts"), "const a = 1;");
-        const result = await executeStart(makeInput({
-            rawInput: `차단 --add-dir ${srcDir}`,
-        }));
-        expect(result.success).toBe(true);
-        if (!result.success)
-            return;
-        const state = reduce(readEvents(result.paths.events));
-        expect(state.entry_mode).toBe("experience");
-    });
-});
-// ─── 3-path branching tests (TCOV-2) ───
-describe("executeStart — Path A: New scope", () => {
-    it("returns StartInitResult with action: initialized, creates brief.md", async () => {
-        const result = await executeStart({
-            rawInput: "",
-            projectRoot: projectDir,
-            scopesDir,
-            projectName: "test-project",
-        });
-        expect(result.success).toBe(true);
-        expect(result).toHaveProperty("action", "initialized");
-        const initResult = result;
-        expect(initResult.scopeId).toMatch(/^test-project-\d{8}-\d{3}$/);
-        expect(initResult.briefPath).toBeDefined();
-        expect(existsSync(initResult.briefPath)).toBe(true);
-        const briefContent = readFileSync(initResult.briefPath, "utf-8");
-        expect(briefContent).toContain("변경 목적");
-        expect(briefContent).toContain("대상 사용자");
-        expect(briefContent).toContain("기대 결과");
-    });
-});
-describe("executeStart — Path B: Brief filled", () => {
-    it("reads brief, validates, creates scope.created event, starts grounding", async () => {
-        // Step 1: Create scope via Path A
-        const initResult = await executeStart({
-            rawInput: "",
-            projectRoot: projectDir,
-            scopesDir,
-            projectName: "brief-test",
-        });
-        // Step 2: Create a source directory
-        const srcDir = join(projectDir, "src-for-brief");
-        mkdirSync(srcDir, { recursive: true });
-        writeFileSync(join(srcDir, "app.ts"), "const x = 1;");
-        // Step 3: Fill in the brief with required fields + additional source
-        const filledBrief = `# brief-test — Brief
-
-## 변경 목적 (필수)
-사용자 차단 기능을 추가해야 합니다.
-
-## 대상 사용자 (필수)
-일반 사용자
-
-## 기대 결과 (필수)
-차단된 사용자가 매칭에서 제외됩니다.
-
-## 포함 범위
-
-## 제외 범위
-
-## 제약 및 참고사항
-
-## 소스
-
-### 자동 로드 (환경설정)
-- 환경설정 파일(.sprint-kit.yaml)이 없거나 소스가 정의되지 않았습니다.
-
-### 추가 소스
-- [x] 앱 소스 (add-dir: ${srcDir})
-`;
-        writeFileSync(initResult.briefPath, filledBrief, "utf-8");
-        // Step 4: Run /start again with the same projectName
-        const result = await executeStart({
-            rawInput: "",
-            projectRoot: projectDir,
-            scopesDir,
-            projectName: "brief-test",
-        });
-        expect(result.success).toBe(true);
-        // Path B returns StartResult (not StartInitResult)
-        expect(result).not.toHaveProperty("action", "initialized");
-        expect(result).not.toHaveProperty("action", "resume_info");
-        if (!result.success)
-            return;
-        if ("action" in result && (result.action === "initialized" || result.action === "resume_info"))
-            return;
-        // Verify events were recorded
-        const events = readEvents(result.paths.events);
-        const types = events.map(e => e.type);
-        expect(types).toContain("scope.created");
-        expect(types).toContain("grounding.started");
-        expect(types).toContain("grounding.completed");
-        const state = reduce(events);
-        expect(state.current_state).toBe("grounded");
-        expect(state.title).toBe("사용자 차단 기능을 추가해야 합니다.");
-    });
-});
-describe("executeStart — Path B: Brief incomplete → exploration conversation mode", () => {
-    it("succeeds with briefValidation indicating missing fields", async () => {
-        // Step 1: Create scope via Path A
-        const initResult = await executeStart({
-            rawInput: "",
-            projectRoot: projectDir,
-            scopesDir,
-            projectName: "incomplete-brief",
-        });
-        // Step 2: Leave brief mostly empty (only fill purpose, leave others blank)
-        const incompleteBrief = `# incomplete-brief — Brief
-
-## 변경 목적 (필수)
-기능 추가
-
-## 대상 사용자 (필수)
-
-## 기대 결과 (필수)
-
-## 소스
-
-### 자동 로드 (환경설정)
-- 없음
-
-### 추가 소스
-`;
-        writeFileSync(initResult.briefPath, incompleteBrief, "utf-8");
-        // Step 2.5: Create a local source and .sprint-kit.yaml so grounding can proceed
-        const srcDir = join(projectDir, "src-incomplete");
-        mkdirSync(srcDir, { recursive: true });
-        writeFileSync(join(srcDir, "index.ts"), "export const x = 1;");
-        writeFileSync(join(projectDir, ".sprint-kit.yaml"), `default_sources:\n  - type: add-dir\n    path: ${srcDir}\n    description: test source\n`);
-        // Step 3: Run /start again — should succeed with briefValidation
-        const result = await executeStart({
-            rawInput: "",
-            projectRoot: projectDir,
-            scopesDir,
-            projectName: "incomplete-brief",
-        });
-        expect(result.success).toBe(true);
-        const success = result;
-        expect(success.briefValidation).toBeDefined();
-        expect(success.briefValidation.isComplete).toBe(false);
-        expect(success.briefValidation.missingFields).toContain("대상 사용자");
-        expect(success.briefValidation.missingFields).toContain("기대 결과");
-        expect(success.totalFiles).toBeGreaterThan(0);
-    });
-});
-describe("executeStart — Path C: Resume with events", () => {
-    it("returns StartResumeResult with current state info", async () => {
-        // Step 1: Create and execute a full start to get events
-        const srcDir = join(projectDir, "src-resume");
-        mkdirSync(srcDir, { recursive: true });
-        writeFileSync(join(srcDir, "a.ts"), "const a = 1;");
-        const scopeId = "resume-test-20260310-001";
-        const firstResult = await executeStart({
-            rawInput: `테스트 --add-dir ${srcDir}`,
-            projectRoot: projectDir,
-            scopesDir,
-            scopeId,
-            title: "Resume 테스트",
-        });
-        expect(firstResult.success).toBe(true);
-        // Step 2: Set up findExistingScope to find this scope
-        // Create .sprint-kit.yaml to not interfere
-        // Manually run executeStart with the same scopeId pattern
-        // Since findExistingScope uses normalized project name, we simulate by
-        // calling executeStart with the exact scopeId (backward compat path triggers on scopeId+title)
-        // Instead, let's use the new interface: create a matching directory name
-        // Read events to verify they exist
-        if (!firstResult.success)
-            return;
-        if ("action" in firstResult && firstResult.action === "initialized")
-            return;
-        const events = readEvents(firstResult.paths.events);
-        expect(events.length).toBeGreaterThan(0);
-        // Step 3: Now call again using the same scopeId+title (triggers backward compat path)
-        // For Path C testing, we need projectName-based lookup
-        // The existing scope dir is "resume-test-20260310-001", and findExistingScope
-        // searches for `{normalized}-{YYYYMMDD}-{NNN}` pattern.
-        // We can call findExistingScope directly to confirm, then trigger Path C via
-        // a new scope creation with the right name pattern.
-        // Actually, let's create a scope with known events using createScope + appendScopeEvent
-        const scopeId2 = "pathc-20260310-001";
-        mkdirSync(join(scopesDir, scopeId2), { recursive: true });
-        const paths2 = createScope(scopesDir, scopeId2);
-        appendScopeEvent(paths2, {
-            type: "scope.created",
-            actor: "user",
-            payload: { title: "Path C 테스트", description: "d", entry_mode: "experience" },
-        });
-        // Now executeStart with projectName "pathc" should find the existing scope
-        const resumeResult = await executeStart({
-            rawInput: "",
-            projectRoot: projectDir,
-            scopesDir,
-            projectName: "pathc",
-        });
-        expect(resumeResult.success).toBe(true);
-        expect(resumeResult).toHaveProperty("action", "resume_info");
-        const resume = resumeResult;
-        expect(resume.scopeId).toBe(scopeId2);
-        expect(resume.currentState).toBe("draft");
-        expect(resume.nextAction).toBeDefined();
-    });
-});
-describe("findExistingScope", () => {
-    it("returns most recent matching scope", () => {
-        // Create multiple matching directories
-        mkdirSync(join(scopesDir, "myapp-20260310-001"), { recursive: true });
-        mkdirSync(join(scopesDir, "myapp-20260310-002"), { recursive: true });
-        mkdirSync(join(scopesDir, "myapp-20260310-003"), { recursive: true });
-        const result = findExistingScope(scopesDir, "myapp");
-        expect(result).toBe("myapp-20260310-003");
-    });
-    it("returns null when no matching scope exists", () => {
-        const result = findExistingScope(scopesDir, "nonexistent");
-        expect(result).toBeNull();
-    });
-    it("returns null when scopesDir does not exist", () => {
-        const result = findExistingScope(join(projectDir, "no-such-dir"), "anything");
-        expect(result).toBeNull();
-    });
-    it("ignores non-matching directories", () => {
-        mkdirSync(join(scopesDir, "other-20260310-001"), { recursive: true });
-        mkdirSync(join(scopesDir, "target-20260310-001"), { recursive: true });
-        const result = findExistingScope(scopesDir, "target");
-        expect(result).toBe("target-20260310-001");
-    });
-});
-// ─── ScanSkipped integration test (ETag cache hit) ───
-describe("ScanSkipped integration (ETag cache hit)", () => {
-    it("reuses cached hash when scanTarball returns ScanSkipped", async () => {
-        // Mock scanTarball to return ScanSkipped for github-tarball source
-        const { scanTarball } = await import("../../readers/scan-tarball.js");
-        const scanTarballSpy = vi.spyOn(await import("../../readers/scan-tarball.js"), "scanTarball");
-        scanTarballSpy.mockResolvedValue({
-            skipped: true,
-            source: { type: "github-tarball", url: "https://github.com/acme/repo" },
-            cached_hash: "cached-hash-abc",
-        });
-        // Also need a local source so grounding doesn't fail (needs at least 1 scanResult or scanSkipped)
-        const srcDir = join(projectDir, "local-src");
-        mkdirSync(srcDir, { recursive: true });
-        writeFileSync(join(srcDir, "app.ts"), "const a = 1;");
-        // Create .sprint-kit.yaml with github-tarball source
-        writeFileSync(join(projectDir, ".sprint-kit.yaml"), `default_sources:\n  - type: github-tarball\n    url: https://github.com/acme/repo\n    description: test repo\n`);
-        const result = await executeStart(makeInput({
-            rawInput: `기능 추가 --add-dir ${srcDir}`,
-        }));
-        expect(result.success).toBe(true);
-        if (!result.success)
-            return;
-        // Verify cached hash is in sourceHashes
-        expect(result.sourceHashes["github-tarball:https://github.com/acme/repo"]).toBe("cached-hash-abc");
-        // Verify grounding.completed event contains the cached hash in source_hashes
-        const events = readEvents(result.paths.events);
-        const groundingCompleted = events.find(e => e.type === "grounding.completed");
-        expect(groundingCompleted).toBeDefined();
-        expect(groundingCompleted.payload.source_hashes["github-tarball:https://github.com/acme/repo"])
-            .toBe("cached-hash-abc");
-        scanTarballSpy.mockRestore();
-    });
-});

package/dist/core-runtime/evolve/config/project-config.js

@@ -1,99 +0,0 @@
-import { readFileSync, existsSync, writeFileSync } from "node:fs";
-import { join } from "node:path";
-import { parse, stringify } from "yaml";
-import { z } from "zod";
-import { getLogger } from "../../logger.js";
-import { sourceKey } from "../../readers/types.js";
-// ─── Zod Schemas ───
-/**
- * usage_hint: when this source should be loaded into agent context.
- * - grounding_only: read once during grounding (default if omitted)
- * - context: re-inject into agent context at surface generation and compile
- * - full: always available (grounding + surface + compile + apply)
- */
-const usageHintSchema = z.enum(["grounding_only", "context", "full"]).optional();
-const sourceEntrySchema = z.discriminatedUnion("type", [
-    z.object({ type: z.literal("add-dir"), path: z.string(), description: z.string().optional(), usage_hint: usageHintSchema }),
-    z.object({ type: z.literal("github-tarball"), url: z.string(), description: z.string().optional(), usage_hint: usageHintSchema }),
-    z.object({ type: z.literal("figma-mcp"), file_key: z.string(), description: z.string().optional(), usage_hint: usageHintSchema }),
-    z.object({ type: z.literal("obsidian-vault"), path: z.string(), description: z.string().optional(), usage_hint: usageHintSchema }),
-    z.object({ type: z.literal("mcp"), provider: z.string(), description: z.string().optional(), usage_hint: usageHintSchema, tools: z.array(z.string()).optional(), query_policy: z.record(z.string(), z.unknown()).optional() }),
-]);
-export const projectConfigSchema = z.object({
-    default_sources: z.array(sourceEntrySchema),
-    target_stack: z.record(z.string(), z.string()).optional(),
-    apply_enabled: z.boolean().optional(),
-});
-const CONFIG_FILENAME = ".sprint-kit.yaml";
-// ─── Load .sprint-kit.yaml ───
-export function loadProjectConfig(projectRoot) {
-    const configPath = join(projectRoot, CONFIG_FILENAME);
-    if (!existsSync(configPath)) {
-        return { default_sources: [] };
-    }
-    try {
-        const raw = readFileSync(configPath, "utf-8");
-        const parsed = parse(raw);
-        if (!parsed || !Array.isArray(parsed.default_sources)) {
-            return { default_sources: [] };
-        }
-        const result = projectConfigSchema.safeParse(parsed);
-        if (!result.success) {
-            const issues = result.error.issues.map((i) => `  - ${i.path.join(".")}: ${i.message}`).join("\n");
-            getLogger().warn(`.sprint-kit.yaml 검증 실패. 기본값(빈 소스)으로 대체합니다.\n${issues}`);
-            return { default_sources: [] };
-        }
-        return {
-            default_sources: result.data.default_sources,
-            target_stack: result.data.target_stack,
-            apply_enabled: result.data.apply_enabled,
-        };
-    }
-    catch (error) {
-        getLogger().debug("loadProjectConfig: failed to load config", { path: configPath, error });
-        return { default_sources: [] };
-    }
-}
-// ─── Resolve Sources (merge defaults + additional, dedup) ───
-export function resolveSources(defaults, additional) {
-    const seen = new Map();
-    for (const entry of defaults) {
-        seen.set(sourceKey(entry), entry);
-    }
-    for (const entry of additional) {
-        seen.set(sourceKey(entry), entry);
-    }
-    return Array.from(seen.values());
-}
-// ─── Write / Read sources.yaml ───
-export function writeSourcesYaml(filePath, sources) {
-    const content = stringify({ sources });
-    writeFileSync(filePath, content, "utf-8");
-}
-export function readSourcesYaml(filePath) {
-    if (!existsSync(filePath)) {
-        return [];
-    }
-    const raw = readFileSync(filePath, "utf-8");
-    const parsed = parse(raw);
-    if (!parsed || !Array.isArray(parsed.sources)) {
-        return [];
-    }
-    return parsed.sources;
-}
-export function parseStartInput(text) {
-    const sources = [];
-    let description = text;
-    // --add-dir <path> (supports quoted paths)
-    description = description.replace(/--add-dir\s+(?:"([^"]+)"|(\S+))/g, (_, q, u) => { sources.push({ type: "add-dir", path: q ?? u }); return ""; });
-    // --github <url> (supports quoted urls)
-    description = description.replace(/--github\s+(?:"([^"]+)"|(\S+))/g, (_, q, u) => { sources.push({ type: "github-tarball", url: q ?? u }); return ""; });
-    // --figma <file_key> (supports quoted keys)
-    description = description.replace(/--figma\s+(?:"([^"]+)"|(\S+))/g, (_, q, u) => { sources.push({ type: "figma-mcp", file_key: q ?? u }); return ""; });
-    // --obsidian <path> (supports quoted paths)
-    description = description.replace(/--obsidian\s+(?:"([^"]+)"|(\S+))/g, (_, q, u) => { sources.push({ type: "obsidian-vault", path: q ?? u }); return ""; });
-    return {
-        description: description.replace(/\s+/g, " ").trim(),
-        sources,
-    };
-}

package/dist/core-runtime/evolve/config/project-config.test.js

@@ -1,170 +0,0 @@
-import { describe, it, expect, beforeEach, afterEach } from "vitest";
-import { mkdirSync, writeFileSync, rmSync } from "node:fs";
-import { join } from "node:path";
-import { loadProjectConfig, resolveSources, writeSourcesYaml, readSourcesYaml, parseStartInput, } from "./project-config.js";
-import { setLogger, silentLogger } from "../../logger.js";
-const TMP = join(import.meta.dirname ?? ".", ".tmp-config-test");
-beforeEach(() => {
-    mkdirSync(TMP, { recursive: true });
-    setLogger(silentLogger);
-});
-afterEach(() => rmSync(TMP, { recursive: true, force: true }));
-// ─── loadProjectConfig ───
-describe("loadProjectConfig", () => {
-    it("returns empty when no config file", () => {
-        expect(loadProjectConfig(TMP).default_sources).toEqual([]);
-    });
-    it("loads sources from .sprint-kit.yaml", () => {
-        writeFileSync(join(TMP, ".sprint-kit.yaml"), `default_sources:\n  - type: add-dir\n    path: ./src\n    description: code\n`);
-        const config = loadProjectConfig(TMP);
-        expect(config.default_sources).toHaveLength(1);
-        expect(config.default_sources[0]).toEqual({ type: "add-dir", path: "./src", description: "code" });
-    });
-    it("returns empty for invalid yaml", () => {
-        writeFileSync(join(TMP, ".sprint-kit.yaml"), "other_key: value\n");
-        expect(loadProjectConfig(TMP).default_sources).toEqual([]);
-    });
-    it("returns empty for empty file", () => {
-        writeFileSync(join(TMP, ".sprint-kit.yaml"), "");
-        expect(loadProjectConfig(TMP).default_sources).toEqual([]);
-    });
-});
-// ─── resolveSources ───
-describe("resolveSources", () => {
-    it("merges defaults and additional", () => {
-        const d = [{ type: "add-dir", path: "./src" }];
-        const a = [{ type: "github-tarball", url: "https://github.com/org/repo" }];
-        expect(resolveSources(d, a)).toHaveLength(2);
-    });
-    it("deduplicates, additional wins", () => {
-        const d = [{ type: "add-dir", path: "./src", description: "old" }];
-        const a = [{ type: "add-dir", path: "./src", description: "new" }];
-        const result = resolveSources(d, a);
-        expect(result).toHaveLength(1);
-        expect(result[0].description).toBe("new");
-    });
-    it("handles empty inputs", () => {
-        expect(resolveSources([], [{ type: "add-dir", path: "./src" }])).toHaveLength(1);
-        expect(resolveSources([{ type: "add-dir", path: "./src" }], [])).toHaveLength(1);
-    });
-});
-// ─── sources.yaml roundtrip ───
-describe("sources.yaml", () => {
-    it("write then read preserves entries", () => {
-        const sources = [
-            { type: "add-dir", path: "./src", description: "code" },
-            { type: "figma-mcp", file_key: "xyz" },
-        ];
-        const filePath = join(TMP, "sources.yaml");
-        writeSourcesYaml(filePath, sources);
-        expect(readSourcesYaml(filePath)).toEqual(sources);
-    });
-    it("returns empty for missing file", () => {
-        expect(readSourcesYaml(join(TMP, "nope.yaml"))).toEqual([]);
-    });
-});
-// ─── parseStartInput ───
-describe("parseStartInput", () => {
-    it("description only", () => {
-        const r = parseStartInput("튜터 차단 기능 추가");
-        expect(r.description).toBe("튜터 차단 기능 추가");
-        expect(r.sources).toEqual([]);
-    });
-    it("--add-dir", () => {
-        const r = parseStartInput("튜터 차단 --add-dir /projects/app/src");
-        expect(r.description).toBe("튜터 차단");
-        expect(r.sources).toEqual([{ type: "add-dir", path: "/projects/app/src" }]);
-    });
-    it("--github", () => {
-        const r = parseStartInput("기능 추가 --github https://github.com/org/repo");
-        expect(r.description).toBe("기능 추가");
-        expect(r.sources).toEqual([{ type: "github-tarball", url: "https://github.com/org/repo" }]);
-    });
-    it("--figma", () => {
-        const r = parseStartInput("화면 --figma abc123");
-        expect(r.description).toBe("화면");
-        expect(r.sources).toEqual([{ type: "figma-mcp", file_key: "abc123" }]);
-    });
-    it("--obsidian", () => {
-        const r = parseStartInput("정책 --obsidian /vaults/co");
-        expect(r.description).toBe("정책");
-        expect(r.sources).toEqual([{ type: "obsidian-vault", path: "/vaults/co" }]);
-    });
-    it("multiple flags", () => {
-        const r = parseStartInput("차단 --add-dir /app --figma xyz --github https://g.com/r");
-        expect(r.description).toBe("차단");
-        const types = r.sources.map(s => s.type).sort();
-        expect(types).toEqual(["add-dir", "figma-mcp", "github-tarball"]);
-    });
-    it("--add-dir with quoted path containing spaces", () => {
-        const r = parseStartInput('튜터 차단 --add-dir "/path with spaces"');
-        expect(r.description).toBe("튜터 차단");
-        expect(r.sources).toEqual([{ type: "add-dir", path: "/path with spaces" }]);
-    });
-    it("--add-dir without quotes still works", () => {
-        const r = parseStartInput("튜터 차단 --add-dir /simple/path");
-        expect(r.description).toBe("튜터 차단");
-        expect(r.sources).toEqual([{ type: "add-dir", path: "/simple/path" }]);
-    });
-    it("--github with quoted url", () => {
-        const r = parseStartInput('기능 --github "https://github.com/org/my repo"');
-        expect(r.description).toBe("기능");
-        expect(r.sources).toEqual([{ type: "github-tarball", url: "https://github.com/org/my repo" }]);
-    });
-    it("--figma with quoted key", () => {
-        const r = parseStartInput('화면 --figma "key with space"');
-        expect(r.description).toBe("화면");
-        expect(r.sources).toEqual([{ type: "figma-mcp", file_key: "key with space" }]);
-    });
-    it("--obsidian with quoted path", () => {
-        const r = parseStartInput('정책 --obsidian "/vault path/notes"');
-        expect(r.description).toBe("정책");
-        expect(r.sources).toEqual([{ type: "obsidian-vault", path: "/vault path/notes" }]);
-    });
-});
-// ─── Zod validation ───
-describe("loadProjectConfig — Zod validation", () => {
-    it("rejects invalid source type and returns empty", () => {
-        writeFileSync(join(TMP, ".sprint-kit.yaml"), `default_sources:\n  - type: invalid-type\n    path: ./src\n`);
-        const config = loadProjectConfig(TMP);
-        expect(config.default_sources).toEqual([]);
-    });
-    it("rejects missing required field (path for add-dir) and returns empty", () => {
-        writeFileSync(join(TMP, ".sprint-kit.yaml"), `default_sources:\n  - type: add-dir\n`);
-        const config = loadProjectConfig(TMP);
-        expect(config.default_sources).toEqual([]);
-    });
-    it("rejects missing required field (url for github-tarball) and returns empty", () => {
-        writeFileSync(join(TMP, ".sprint-kit.yaml"), `default_sources:\n  - type: github-tarball\n`);
-        const config = loadProjectConfig(TMP);
-        expect(config.default_sources).toEqual([]);
-    });
-    it("rejects missing required field (file_key for figma-mcp) and returns empty", () => {
-        writeFileSync(join(TMP, ".sprint-kit.yaml"), `default_sources:\n  - type: figma-mcp\n`);
-        const config = loadProjectConfig(TMP);
-        expect(config.default_sources).toEqual([]);
-    });
-    it("logs warning on validation failure", () => {
-        const warnings = [];
-        setLogger({
-            debug: () => { },
-            info: () => { },
-            warn: (msg) => { warnings.push(msg); },
-            error: () => { },
-        });
-        writeFileSync(join(TMP, ".sprint-kit.yaml"), `default_sources:\n  - type: unknown-type\n    path: ./src\n`);
-        loadProjectConfig(TMP);
-        expect(warnings.length).toBeGreaterThan(0);
-        expect(warnings[0]).toContain("검증 실패");
-        setLogger(silentLogger);
-    });
-    it("accepts valid config with all source types", () => {
-        writeFileSync(join(TMP, ".sprint-kit.yaml"), `default_sources:\n` +
-            `  - type: add-dir\n    path: ./src\n    description: code\n` +
-            `  - type: github-tarball\n    url: https://github.com/org/repo\n` +
-            `  - type: figma-mcp\n    file_key: abc\n` +
-            `  - type: obsidian-vault\n    path: /vault\n`);
-        const config = loadProjectConfig(TMP);
-        expect(config.default_sources).toHaveLength(4);
-    });
-});