@tienne/gestalt 0.15.1 → 0.15.2

package/CLAUDE.md

@@ -7,9 +7,9 @@
 ## Architecture
 - **Interview Engine**: 게슈탈트 원리 기반 Q&A로 해상도 점수를 0.8 이상으로 높임
 - **Spec Generator**: 완료된 인터뷰에서 구조화된 프로젝트 스펙(Spec) 생성
-- **Execute Engine**: Spec→ExecutionPlan 변환 (Figure-Ground→Closure→Proximity→Continuity)
+- **Execute Engine**: Spec→ExecutionPlan 변환 (Figure-Ground→Closure→Proximity→Continuity). 설계상 **항상 Passthrough 모드** — Claude Code가 도구(Bash/Edit 등)로 실제 파일 수정·코드 실행을 수행하므로 LLM 주체가 됨 (API 키 유무 무관)
 - **Resilience Engine**: Stagnation 감지 → Lateral Thinking Personas → Human Escalation
-- **MCP Server**: stdio transport, API 키 없으면 Passthrough 모드 자동 활성화
+- **MCP Server**: stdio transport, API 키 없으면 Passthrough 모드 자동 활성화 (Execute는 항상 Passthrough)
 - **Skill System**: SKILL.md 기반 확장, chokidar hot-reload
 - **Code Knowledge Graph**: 정적 분석 → 의존성 그래프 → Blast-Radius 영향 파일 추출
 - **Event Store**: better-sqlite3 WAL 모드 이벤트 소싱

package/README.ko.md

@@ -79,6 +79,8 @@ Gestalt는 코드를 작성하기 전에 요구사항을 함께 구체화해줘
 
 Gestalt는 **MCP 서버**로 실행돼요. Claude Code를 통해 사용할 경우 Claude Code가 LLM 역할을 담당해요 — Gestalt는 프롬프트와 컨텍스트를 반환하고, 실제 추론은 Claude Code가 해요. 서버 자체는 별도 API 호출을 하지 않아요.
 
+> **참고해 주세요** — Execute 단계는 API 키 설정 여부와 무관하게 **항상 Passthrough 모드**로 동작해요. Execute는 Claude Code의 도구(Bash, Edit 등)로 실제 파일 수정과 코드 실행을 수행하기 때문에, Claude Code가 LLM 주체가 되는 게 설계 의도예요. 자체 LLM으로 대체하는 모드는 따로 없어요(미구현이 아니라 설계상 그래요).
+
 ```
 Claude Code
        │
@@ -286,6 +288,8 @@ Spec에서 실행 계획을 만들어 실행해요:
 /execute
 ```
 
+> Execute는 **항상 Passthrough 모드**로 동작해요 — 실제 파일 수정과 코드 실행은 Claude Code가 도구(Bash, Edit 등)로 수행해요. API 키를 설정해도 Execute가 자체 LLM 모드로 바뀌지 않아요. 그런 모드는 설계상 존재하지 않아요.
+
 **Planning 단계**에서 4가지 게슈탈트 원리를 고정 순서로 적용해요:
 
 | 단계 | 원리 | 역할 |

package/README.md

@@ -96,6 +96,8 @@ Gestalt addresses this before any code is written. It runs a structured intervie
 
 Gestalt runs as an MCP server. Claude Code acts as the LLM: Gestalt returns prompts and context, and Claude Code does the reasoning. The server makes no API calls.
 
+> **Note:** The Execute stage **always runs in Passthrough mode**, regardless of whether an API key is configured. Execute carries out real file edits and code execution through Claude Code's tools (Bash, Edit, etc.), so Claude Code must be the LLM that drives it — this is by design, not a missing feature.
+
 ```
 You (in Claude Code)
        │
@@ -273,6 +275,8 @@ Transform the Spec into a dependency-aware execution plan and run it:
 /execute
 ```
 
+> Execute **always runs in Passthrough mode** — Claude Code performs the actual file edits and code execution through its tools (Bash, Edit, etc.). Configuring an API key does not switch Execute to a self-contained LLM mode; there is no such mode by design.
+
 **Planning** applies four Gestalt principles in a fixed sequence:
 
 | Step | Principle | What it does |

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tienne/gestalt",
-  "version": "0.15.1",
+  "version": "0.15.2",
   "description": "TypeScript AI Development Harness - Gestalt psychology-driven requirement clarification",
   "type": "module",
   "main": "./dist/src/index.js",

package/dist/src/execute/orchestrators/evaluation.d.ts

@@ -0,0 +1,27 @@
+import type { EvaluationResult, StructuralResult } from '../../core/types.js';
+import { ExecuteError } from '../../core/errors.js';
+import { type Result } from '../../core/result.js';
+import { EventStore } from '../../events/store.js';
+import { ExecuteSessionManager } from '../session.js';
+import type { AgentRegistry } from '../../agent/registry.js';
+import type { RoleAgentRegistry } from '../../agent/role-agent-registry.js';
+import type { PassthroughEvaluateResult } from './types.js';
+export declare class EvaluationOrchestrator {
+    private sessionManager;
+    private agentRegistry?;
+    constructor(sessionManager: ExecuteSessionManager, _eventStore: EventStore, agentRegistry?: AgentRegistry | undefined, _roleAgentRegistry?: RoleAgentRegistry);
+    /**
+     * Call 1: Start evaluation → returns structural commands to run.
+     */
+    startEvaluation(sessionId: string): Result<PassthroughEvaluateResult, ExecuteError>;
+    /**
+     * Call 2: Submit structural results → returns contextual context or short-circuits.
+     */
+    submitStructuralResult(sessionId: string, structuralResult: StructuralResult): Result<PassthroughEvaluateResult, ExecuteError>;
+    /**
+     * Call 3: Submit contextual evaluation result → completes session.
+     */
+    submitEvaluation(sessionId: string, evaluationResult: EvaluationResult): Result<PassthroughEvaluateResult, ExecuteError>;
+    private buildContextualEvaluateContext;
+}
+//# sourceMappingURL=evaluation.d.ts.map

package/dist/src/execute/orchestrators/evaluation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluation.d.ts","sourceRoot":"","sources":["../../../../src/execute/orchestrators/evaluation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkB,gBAAgB,EAAqB,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACjH,OAAO,EAAE,YAAY,EAAgD,MAAM,sBAAsB,CAAC;AAClG,OAAO,EAAE,KAAK,MAAM,EAAW,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAKtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAG7D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAC5E,OAAO,KAAK,EAA6B,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAEvF,qBAAa,sBAAsB;IAE/B,OAAO,CAAC,cAAc;IAEtB,OAAO,CAAC,aAAa,CAAC;gBAFd,cAAc,EAAE,qBAAqB,EAC7C,WAAW,EAAE,UAAU,EACf,aAAa,CAAC,EAAE,aAAa,YAAA,EACrC,kBAAkB,CAAC,EAAE,iBAAiB;IAGxC;;OAEG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC,yBAAyB,EAAE,YAAY,CAAC;IA2EnF;;OAEG;IACH,sBAAsB,CACpB,SAAS,EAAE,MAAM,EACjB,gBAAgB,EAAE,gBAAgB,GACjC,MAAM,CAAC,yBAAyB,EAAE,YAAY,CAAC;IAsDlD;;OAEG;IACH,gBAAgB,CACd,SAAS,EAAE,MAAM,EACjB,gBAAgB,EAAE,gBAAgB,GACjC,MAAM,CAAC,yBAAyB,EAAE,YAAY,CAAC;IAsDlD,OAAO,CAAC,8BAA8B;CAwBvC"}

package/dist/src/execute/orchestrators/evaluation.js

@@ -0,0 +1,169 @@
+import { ExecuteSessionNotFoundError, EvaluationError } from '../../core/errors.js';
+import { ok, err } from '../../core/result.js';
+import { EXECUTE_EVALUATION_SYSTEM_PROMPT, buildContextualEvaluationPrompt, } from '../prompts.js';
+import { mergeSystemPrompt } from '../../agent/prompt-resolver.js';
+import { codeGraphEngine } from '../../code-graph/index.js';
+export class EvaluationOrchestrator {
+    sessionManager;
+    agentRegistry;
+    constructor(sessionManager, _eventStore, agentRegistry, _roleAgentRegistry) {
+        this.sessionManager = sessionManager;
+        this.agentRegistry = agentRegistry;
+    }
+    /**
+     * Call 1: Start evaluation → returns structural commands to run.
+     */
+    startEvaluation(sessionId) {
+        try {
+            const session = this.sessionManager.get(sessionId);
+            if (session.status !== 'executing') {
+                return err(new EvaluationError(`Cannot start evaluation: session status is "${session.status}", expected "executing"`));
+            }
+            if (!session.executionPlan) {
+                return err(new EvaluationError('No execution plan found'));
+            }
+            this.sessionManager.startStructuralEvaluation(sessionId);
+            let commands = [
+                { name: 'lint', command: 'npm run lint' },
+                { name: 'build', command: 'npm run build' },
+                { name: 'test', command: 'npm test' },
+            ];
+            // blast-radius 기반 테스트 필터링: codeGraphRepoRoot가 설정되고 DB가 존재할 때
+            if (session.codeGraphRepoRoot && codeGraphEngine.dbExists(session.codeGraphRepoRoot)) {
+                try {
+                    const blastResult = codeGraphEngine.blastRadius(session.codeGraphRepoRoot, {
+                        base: 'HEAD~1',
+                    });
+                    const testFiles = blastResult.impactedFiles.filter((f) => f.includes('.test.') || f.includes('.spec.') || f.includes('__tests__'));
+                    if (testFiles.length > 0) {
+                        commands = commands.map((cmd) => {
+                            if (cmd.name === 'test') {
+                                return { ...cmd, command: `${cmd.command} -- ${testFiles.join(' ')}` };
+                            }
+                            return cmd;
+                        });
+                    }
+                    else {
+                        // 변경된 테스트 파일 없음 → 테스트 스킵
+                        commands = commands.map((cmd) => {
+                            if (cmd.name === 'test') {
+                                return { ...cmd, command: 'echo "No affected tests"' };
+                            }
+                            return cmd;
+                        });
+                    }
+                }
+                catch {
+                    // blast-radius 실패 시 기존 전체 테스트로 fallback (graceful degradation)
+                }
+            }
+            return ok({
+                session: this.sessionManager.get(sessionId),
+                stage: 'structural',
+                structuralContext: {
+                    phase: 'evaluating',
+                    stage: 'structural',
+                    commands,
+                    message: 'Run these structural checks and submit results. Adapt commands to your project (e.g., pnpm/yarn). All must pass to proceed to contextual evaluation.',
+                },
+            });
+        }
+        catch (e) {
+            if (e instanceof ExecuteSessionNotFoundError)
+                return err(e);
+            return err(new EvaluationError(`Failed to start evaluation: ${e instanceof Error ? e.message : String(e)}`));
+        }
+    }
+    /**
+     * Call 2: Submit structural results → returns contextual context or short-circuits.
+     */
+    submitStructuralResult(sessionId, structuralResult) {
+        try {
+            const session = this.sessionManager.get(sessionId);
+            if (session.status !== 'executing' || session.evaluateStage !== 'structural') {
+                return err(new EvaluationError(`Cannot submit structural result: expected stage "structural", got "${session.evaluateStage ?? 'none'}"`));
+            }
+            this.sessionManager.completeStructuralStage(sessionId, structuralResult);
+            // Short-circuit if structural checks failed
+            if (!structuralResult.allPassed) {
+                const failedCommands = structuralResult.commands
+                    .filter((c) => c.exitCode !== 0)
+                    .map((c) => `${c.name} (exit ${c.exitCode})`)
+                    .join(', ');
+                this.sessionManager.shortCircuitEvaluation(sessionId, `Structural checks failed: ${failedCommands}`);
+                return ok({
+                    session: this.sessionManager.get(sessionId),
+                    stage: 'complete',
+                    shortCircuited: true,
+                    evaluationResult: this.sessionManager.get(sessionId).evaluationResult,
+                });
+            }
+            // Structural passed → advance to contextual stage
+            this.sessionManager.startContextualEvaluation(sessionId);
+            const updatedSession = this.sessionManager.get(sessionId);
+            const contextualContext = this.buildContextualEvaluateContext(updatedSession);
+            return ok({
+                session: updatedSession,
+                stage: 'contextual',
+                contextualContext,
+            });
+        }
+        catch (e) {
+            if (e instanceof ExecuteSessionNotFoundError)
+                return err(e);
+            return err(new EvaluationError(`Failed to submit structural result: ${e instanceof Error ? e.message : String(e)}`));
+        }
+    }
+    /**
+     * Call 3: Submit contextual evaluation result → completes session.
+     */
+    submitEvaluation(sessionId, evaluationResult) {
+        try {
+            const session = this.sessionManager.get(sessionId);
+            if (session.status !== 'executing' || session.evaluateStage !== 'contextual') {
+                return err(new EvaluationError(`Cannot submit evaluation: expected stage "contextual", got "${session.evaluateStage ?? 'none'}"`));
+            }
+            // Validate evaluation covers all ACs
+            const acCount = session.spec.acceptanceCriteria.length;
+            const verifiedIndices = new Set(evaluationResult.verifications.map((v) => v.acIndex));
+            for (let i = 0; i < acCount; i++) {
+                if (!verifiedIndices.has(i)) {
+                    return err(new EvaluationError(`AC index ${i} is not verified`));
+                }
+            }
+            // Validate score ranges
+            if (evaluationResult.overallScore < 0 || evaluationResult.overallScore > 1) {
+                return err(new EvaluationError(`overallScore must be between 0 and 1, got ${evaluationResult.overallScore}`));
+            }
+            if (evaluationResult.goalAlignment < 0 || evaluationResult.goalAlignment > 1) {
+                return err(new EvaluationError(`goalAlignment must be between 0 and 1, got ${evaluationResult.goalAlignment}`));
+            }
+            this.sessionManager.completeEvaluation(sessionId, evaluationResult);
+            return ok({
+                session: this.sessionManager.get(sessionId),
+                stage: 'complete',
+                evaluationResult,
+            });
+        }
+        catch (e) {
+            if (e instanceof ExecuteSessionNotFoundError)
+                return err(e);
+            return err(new EvaluationError(`Failed to submit evaluation: ${e instanceof Error ? e.message : String(e)}`));
+        }
+    }
+    buildContextualEvaluateContext(session) {
+        const plan = session.executionPlan;
+        const evaluatePrompt = buildContextualEvaluationPrompt(session.spec, plan.classifiedACs, session.taskResults, session.structuralResult);
+        return {
+            systemPrompt: mergeSystemPrompt(EXECUTE_EVALUATION_SYSTEM_PROMPT, this.agentRegistry, 'evaluate'),
+            evaluatePrompt,
+            phase: 'evaluating',
+            stage: 'contextual',
+            spec: session.spec,
+            taskResults: session.taskResults,
+            classifiedACs: plan.classifiedACs,
+            structuralResult: session.structuralResult,
+        };
+    }
+}
+//# sourceMappingURL=evaluation.js.map

package/dist/src/execute/orchestrators/evaluation.js.map

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

package/dist/src/execute/orchestrators/evolution.d.ts

@@ -0,0 +1,50 @@
+import type { TaskExecutionResult, FixTask, SpecPatch } from '../../core/types.js';
+import { ExecuteError } from '../../core/errors.js';
+import { type Result } from '../../core/result.js';
+import { EventStore } from '../../events/store.js';
+import { ExecuteSessionManager } from '../session.js';
+import type { AgentRegistry } from '../../agent/registry.js';
+import type { LateralResult } from '../../resilience/types.js';
+import type { RoleAgentRegistry } from '../../agent/role-agent-registry.js';
+import type { PassthroughEvolveFixResult, PassthroughEvolvePatchResult, PassthroughReExecuteResult } from './types.js';
+export declare class EvolutionOrchestrator {
+    private sessionManager;
+    private eventStore;
+    private agentRegistry?;
+    constructor(sessionManager: ExecuteSessionManager, eventStore: EventStore, agentRegistry?: AgentRegistry | undefined, _roleAgentRegistry?: RoleAgentRegistry);
+    /**
+     * evolve_fix: Structural 실패 시 fix context를 반환하거나, fix 결과를 제출한다.
+     * - fixTasks 없으면: fixContext 반환 (caller가 fix 생성)
+     * - fixTasks 있으면: fix 기록 후 re-evaluate를 위한 상태 복원
+     */
+    startStructuralFix(sessionId: string, fixTasks?: FixTask[]): Result<PassthroughEvolveFixResult, ExecuteError>;
+    /**
+     * evolve: Contextual evolution 시작.
+     * - evaluationResult에서 gap 분석 후 evolveContext 반환
+     * - caller가 SpecPatch를 생성
+     * - terminateReason='caller'이면 즉시 종료
+     */
+    startContextualEvolve(sessionId: string, terminateReason?: 'caller'): Result<PassthroughEvolveFixResult, ExecuteError>;
+    /**
+     * evolve_patch: Spec 패치 제출 → 검증 → 적용 → impacted tasks 식별 → re-execute context 반환
+     */
+    submitSpecPatch(sessionId: string, patch: SpecPatch): Result<PassthroughEvolvePatchResult, ExecuteError>;
+    /**
+     * evolve_re_execute: Re-execution 중 태스크 결과 제출
+     */
+    submitReExecuteTaskResult(sessionId: string, taskResult: TaskExecutionResult): Result<PassthroughReExecuteResult, ExecuteError>;
+    /**
+     * evolve_lateral: 다음 lateral persona를 suggest하거나 human_escalation 반환.
+     * evolve에서 자동 분기되지만, caller가 명시적으로 다음 persona를 요청할 때도 사용.
+     */
+    startLateralEvolve(sessionId: string): Result<PassthroughEvolveFixResult, ExecuteError>;
+    /**
+     * evolve_lateral_result: Lateral thinking 결과(specPatch) 제출.
+     * completeLateral() 후 기존 submitSpecPatch() 위임.
+     */
+    submitLateralResult(sessionId: string, lateralResult: LateralResult): Result<PassthroughEvolvePatchResult, ExecuteError>;
+    private countStructuralFixes;
+    private buildReExecuteContext;
+    private buildNextReExecuteTaskContext;
+}
+//# sourceMappingURL=evolution.d.ts.map

package/dist/src/execute/orchestrators/evolution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evolution.d.ts","sourceRoot":"","sources":["../../../../src/execute/orchestrators/evolution.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkB,mBAAmB,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACnG,OAAO,EACL,YAAY,EAGb,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,KAAK,MAAM,EAAW,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAEnD,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AActD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAQ7D,OAAO,KAAK,EAAE,aAAa,EAAsB,MAAM,2BAA2B,CAAC;AACnF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAC5E,OAAO,KAAK,EAEV,0BAA0B,EAC1B,4BAA4B,EAC5B,0BAA0B,EAC3B,MAAM,YAAY,CAAC;AAEpB,qBAAa,qBAAqB;IAE9B,OAAO,CAAC,cAAc;IACtB,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,aAAa,CAAC;gBAFd,cAAc,EAAE,qBAAqB,EACrC,UAAU,EAAE,UAAU,EACtB,aAAa,CAAC,EAAE,aAAa,YAAA,EACrC,kBAAkB,CAAC,EAAE,iBAAiB;IAGxC;;;;OAIG;IACH,kBAAkB,CAChB,SAAS,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE,OAAO,EAAE,GACnB,MAAM,CAAC,0BAA0B,EAAE,YAAY,CAAC;IAmDnD;;;;;OAKG;IACH,qBAAqB,CACnB,SAAS,EAAE,MAAM,EACjB,eAAe,CAAC,EAAE,QAAQ,GACzB,MAAM,CAAC,0BAA0B,EAAE,YAAY,CAAC;IAoHnD;;OAEG;IACH,eAAe,CACb,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,SAAS,GACf,MAAM,CAAC,4BAA4B,EAAE,YAAY,CAAC;IAqErD;;OAEG;IACH,yBAAyB,CACvB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,mBAAmB,GAC9B,MAAM,CAAC,0BAA0B,EAAE,YAAY,CAAC;IAoCnD;;;OAGG;IACH,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC,0BAA0B,EAAE,YAAY,CAAC;IAkFvF;;;OAGG;IACH,mBAAmB,CACjB,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,aAAa,GAC3B,MAAM,CAAC,4BAA4B,EAAE,YAAY,CAAC;IAwBrD,OAAO,CAAC,oBAAoB;IAM5B,OAAO,CAAC,qBAAqB;IA6C7B,OAAO,CAAC,6BAA6B;CA4CtC"}