@tienne/gestalt 0.7.0 → 0.9.0

package/dist/src/memory/user-profile-store.js

@@ -0,0 +1,89 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { homedir } from 'node:os';
+const PROFILE_DIR = '.gestalt';
+const PROFILE_FILENAME = 'profile.json';
+function getProfilePath() {
+    return join(homedir(), PROFILE_DIR, PROFILE_FILENAME);
+}
+function createEmptyProfile() {
+    const now = new Date().toISOString();
+    return {
+        crossRepoPatterns: [],
+        personalPreferences: {},
+        createdAt: now,
+        updatedAt: now,
+    };
+}
+export class UserProfileStore {
+    profilePath;
+    constructor(profilePath) {
+        this.profilePath = profilePath ?? getProfilePath();
+    }
+    read() {
+        if (!existsSync(this.profilePath)) {
+            return createEmptyProfile();
+        }
+        try {
+            const raw = readFileSync(this.profilePath, 'utf-8');
+            return JSON.parse(raw);
+        }
+        catch {
+            return createEmptyProfile();
+        }
+    }
+    write(profile) {
+        const dir = dirname(this.profilePath);
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+        }
+        profile.updatedAt = new Date().toISOString();
+        writeFileSync(this.profilePath, JSON.stringify(profile, null, 2), 'utf-8');
+    }
+    setPreference(key, value) {
+        const profile = this.read();
+        profile.personalPreferences[key] = value;
+        this.write(profile);
+        return profile;
+    }
+    addCrossRepoPattern(pattern) {
+        const profile = this.read();
+        if (!profile.crossRepoPatterns.includes(pattern)) {
+            profile.crossRepoPatterns.push(pattern);
+        }
+        this.write(profile);
+        return profile;
+    }
+    setPreferredModel(model) {
+        const profile = this.read();
+        profile.preferredModel = model;
+        this.write(profile);
+        return profile;
+    }
+    setUserId(userId) {
+        const profile = this.read();
+        profile.userId = userId;
+        this.write(profile);
+        return profile;
+    }
+    merge(partial) {
+        const profile = this.read();
+        const merged = {
+            ...profile,
+            ...partial,
+            crossRepoPatterns: [
+                ...new Set([
+                    ...profile.crossRepoPatterns,
+                    ...(partial.crossRepoPatterns ?? []),
+                ]),
+            ],
+            personalPreferences: {
+                ...profile.personalPreferences,
+                ...(partial.personalPreferences ?? {}),
+            },
+        };
+        this.write(merged);
+        return merged;
+    }
+}
+//# sourceMappingURL=user-profile-store.js.map

package/dist/src/memory/user-profile-store.js.map

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

package/dist/src/spec/passthrough-generator.d.ts

@@ -3,6 +3,7 @@ import { AmbiguityThresholdError, SpecGenerationError } from '../core/errors.js'
 import { type Result } from '../core/result.js';
 import { EventStore } from '../events/store.js';
 import type { AgentRegistry } from '../agent/registry.js';
+export declare const TEXT_INPUT_SESSION_ID = "text-input";
 export interface SpecContext {
     systemPrompt: string;
     specPrompt: string;
@@ -30,5 +31,6 @@ export declare class PassthroughSpecGenerator {
     constructor(eventStore: EventStore, agentRegistry?: AgentRegistry);
     buildSpecContext(session: InterviewSession): SpecContext;
     validateAndStore(session: InterviewSession, externalSpec: ExternalSpec, force?: boolean): Result<Spec, SpecGenerationError | AmbiguityThresholdError>;
+    validateAndStoreFromText(externalSpec: ExternalSpec): Result<Spec, SpecGenerationError>;
 }
 //# sourceMappingURL=passthrough-generator.d.ts.map

package/dist/src/spec/passthrough-generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"passthrough-generator.d.ts","sourceRoot":"","sources":["../../../src/spec/passthrough-generator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,IAAI,EAAkB,MAAM,kBAAkB,CAAC;AAC/E,OAAO,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAEjF,OAAO,EAAE,KAAK,MAAM,EAAW,MAAM,mBAAmB,CAAC;AAEzD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGhD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAK1D,MAAM,WAAW,WAAW;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC/F,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,cAAc,EAAE;QAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;QAAC,SAAS,EAAE,OAAO,EAAE,CAAA;KAAE,CAAC;IAC9D,eAAe,EAAE,OAAO,EAAE,CAAC;CAC5B;AAID,qBAAa,wBAAwB;IAGvB,OAAO,CAAC,UAAU;IAF9B,OAAO,CAAC,aAAa,CAAC,CAAgB;gBAElB,UAAU,EAAE,UAAU,EAAE,aAAa,CAAC,EAAE,aAAa;IAIzE,gBAAgB,CAAC,OAAO,EAAE,gBAAgB,GAAG,WAAW;IA4BxD,gBAAgB,CACd,OAAO,EAAE,gBAAgB,EACzB,YAAY,EAAE,YAAY,EAC1B,KAAK,UAAQ,GACZ,MAAM,CAAC,IAAI,EAAE,mBAAmB,GAAG,uBAAuB,CAAC;CA6D/D"}
+{"version":3,"file":"passthrough-generator.d.ts","sourceRoot":"","sources":["../../../src/spec/passthrough-generator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,IAAI,EAAkB,MAAM,kBAAkB,CAAC;AAC/E,OAAO,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAEjF,OAAO,EAAE,KAAK,MAAM,EAAW,MAAM,mBAAmB,CAAC;AAEzD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGhD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAG1D,eAAO,MAAM,qBAAqB,eAAe,CAAC;AAIlD,MAAM,WAAW,WAAW;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC/F,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,cAAc,EAAE;QAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;QAAC,SAAS,EAAE,OAAO,EAAE,CAAA;KAAE,CAAC;IAC9D,eAAe,EAAE,OAAO,EAAE,CAAC;CAC5B;AAID,qBAAa,wBAAwB;IAGvB,OAAO,CAAC,UAAU;IAF9B,OAAO,CAAC,aAAa,CAAC,CAAgB;gBAElB,UAAU,EAAE,UAAU,EAAE,aAAa,CAAC,EAAE,aAAa;IAIzE,gBAAgB,CAAC,OAAO,EAAE,gBAAgB,GAAG,WAAW;IA4BxD,gBAAgB,CACd,OAAO,EAAE,gBAAgB,EACzB,YAAY,EAAE,YAAY,EAC1B,KAAK,UAAQ,GACZ,MAAM,CAAC,IAAI,EAAE,mBAAmB,GAAG,uBAAuB,CAAC;IA8D9D,wBAAwB,CAAC,YAAY,EAAE,YAAY,GAAG,MAAM,CAAC,IAAI,EAAE,mBAAmB,CAAC;CAgDxF"}

package/dist/src/spec/passthrough-generator.js

@@ -6,6 +6,7 @@ import { specSchema } from './schema.js';
 import { EventType } from '../events/types.js';
 import { INTERVIEW_SYSTEM_PROMPT, buildSpecPrompt } from '../llm/prompts.js';
 import { mergeSystemPrompt, getActiveAgentNames } from '../agent/prompt-resolver.js';
+export const TEXT_INPUT_SESSION_ID = 'text-input';
 // ─── Generator ──────────────────────────────────────────────────
 export class PassthroughSpecGenerator {
     eventStore;
@@ -82,5 +83,38 @@ export class PassthroughSpecGenerator {
             return err(new SpecGenerationError(`Failed to validate spec: ${e instanceof Error ? e.message : String(e)}`));
         }
     }
+    validateAndStoreFromText(externalSpec) {
+        try {
+            const spec = {
+                version: '1.0.0',
+                goal: externalSpec.goal,
+                constraints: externalSpec.constraints,
+                acceptanceCriteria: externalSpec.acceptanceCriteria,
+                ontologySchema: externalSpec.ontologySchema,
+                gestaltAnalysis: externalSpec.gestaltAnalysis,
+                metadata: {
+                    specId: randomUUID(),
+                    interviewSessionId: TEXT_INPUT_SESSION_ID,
+                    ambiguityScore: 0,
+                    generatedAt: new Date().toISOString(),
+                },
+            };
+            const validation = specSchema.safeParse(spec);
+            if (!validation.success) {
+                return err(new SpecGenerationError(`Spec validation failed: ${validation.error.message}`));
+            }
+            this.eventStore.append('spec', spec.metadata.specId, EventType.SPEC_GENERATED, {
+                sessionId: TEXT_INPUT_SESSION_ID,
+                goal: spec.goal,
+                constraintCount: spec.constraints.length,
+                criteriaCount: spec.acceptanceCriteria.length,
+                source: 'text',
+            });
+            return ok(spec);
+        }
+        catch (e) {
+            return err(new SpecGenerationError(`Failed to validate spec: ${e instanceof Error ? e.message : String(e)}`));
+        }
+    }
 }
 //# sourceMappingURL=passthrough-generator.js.map

package/dist/src/spec/passthrough-generator.js.map

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

package/dist/src/spec/templates.d.ts

@@ -0,0 +1,12 @@
+import type { SpecTemplate } from '../core/types.js';
+export declare class SpecTemplateRegistry {
+    get(id: string): SpecTemplate | undefined;
+    list(): SpecTemplate[];
+    has(id: string): boolean;
+    /**
+     * 템플릿을 기반으로 specPrompt를 위한 추가 컨텍스트 문자열 생성.
+     * TextBasedSpecGenerator.buildSpecContext()에서 주입된다.
+     */
+    buildTemplateContext(id: string): string | null;
+}
+//# sourceMappingURL=templates.d.ts.map

package/dist/src/spec/templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../../src/spec/templates.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AA4ErD,qBAAa,oBAAoB;IAC/B,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAIzC,IAAI,IAAI,YAAY,EAAE;IAItB,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAIxB;;;OAGG;IACH,oBAAoB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;CAoBhD"}

package/dist/src/spec/templates.js

@@ -0,0 +1,103 @@
+// ─── Built-in Templates ──────────────────────────────────────────
+const REST_API_TEMPLATE = {
+    id: 'rest-api',
+    name: 'REST API Backend',
+    description: 'RESTful API 백엔드 서비스 — 인증, CRUD, 에러 핸들링 포함',
+    baseConstraints: [
+        'RESTful API 설계 원칙 준수 (HTTP 메서드, 상태 코드)',
+        'JWT 기반 인증/인가',
+        '입력 유효성 검사 및 에러 응답 표준화',
+        'API 버전 관리 (/api/v1/...)',
+        '환경변수 기반 설정 관리 (비밀값 하드코딩 금지)',
+    ],
+    baseAcceptanceCriteria: [
+        'GET /health 엔드포인트가 200 OK와 서버 상태를 반환한다',
+        'POST /auth/login은 유효한 자격증명으로 JWT 토큰을 반환한다',
+        '인증이 필요한 엔드포인트는 유효하지 않은 토큰으로 401을 반환한다',
+        '잘못된 요청에 대해 표준 에러 형식(code, message)을 반환한다',
+        '모든 엔드포인트에 요청/응답 로깅이 동작한다',
+    ],
+    baseOntologyEntities: ['User', 'AuthToken', 'Resource', 'ApiResponse'],
+};
+const REACT_DASHBOARD_TEMPLATE = {
+    id: 'react-dashboard',
+    name: 'React Dashboard',
+    description: 'React 기반 관리자 대시보드 — 차트, 테이블, 필터링 포함',
+    baseConstraints: [
+        'React 18+ 함수형 컴포넌트 + TypeScript',
+        '상태 관리: 서버 상태는 React Query, 클라이언트 상태는 Zustand 또는 Context',
+        '반응형 레이아웃 (모바일/태블릿/데스크탑)',
+        '접근성 (WCAG 2.1 AA) 준수',
+        '컴포넌트 단위 Storybook 문서화',
+    ],
+    baseAcceptanceCriteria: [
+        '대시보드 메인 페이지가 핵심 KPI 카드를 표시한다',
+        '차트/그래프가 데이터 로딩 중 스켈레톤 UI를 보여준다',
+        '테이블에 정렬, 필터링, 페이지네이션이 동작한다',
+        '필터 조건이 URL 쿼리 파라미터에 반영되어 공유 가능하다',
+        '다크 모드 전환이 즉시 적용된다',
+    ],
+    baseOntologyEntities: ['Dashboard', 'Chart', 'DataTable', 'Filter', 'UserPreference'],
+};
+const CLI_TOOL_TEMPLATE = {
+    id: 'cli-tool',
+    name: 'CLI Tool',
+    description: 'Node.js CLI 도구 — 명령어, 옵션, 대화형 프롬프트 포함',
+    baseConstraints: [
+        'Node.js 20+ ESM 모듈',
+        'commander.js 기반 명령어 파싱',
+        '대화형 프롬프트: @inquirer/prompts',
+        'JSON/YAML 설정 파일 지원 (cosmiconfig 또는 동등한 라이브러리)',
+        '0-exit-code: 성공, 1-exit-code: 실패 (UNIX 표준)',
+        'stdout: 결과 데이터만, stderr: 로그/에러',
+    ],
+    baseAcceptanceCriteria: [
+        '`tool --help`가 모든 명령어와 옵션을 출력한다',
+        '`tool --version`이 package.json 버전을 출력한다',
+        '잘못된 옵션 사용 시 명확한 에러 메시지와 exit code 1을 반환한다',
+        '`--quiet` 플래그로 진행 메시지를 숨기고 결과만 출력한다',
+        '설정 파일이 없을 때 기본값으로 동작한다',
+    ],
+    baseOntologyEntities: ['Command', 'Option', 'Config', 'Output'],
+};
+// ─── Registry ────────────────────────────────────────────────────
+const TEMPLATES = new Map([
+    [REST_API_TEMPLATE.id, REST_API_TEMPLATE],
+    [REACT_DASHBOARD_TEMPLATE.id, REACT_DASHBOARD_TEMPLATE],
+    [CLI_TOOL_TEMPLATE.id, CLI_TOOL_TEMPLATE],
+]);
+export class SpecTemplateRegistry {
+    get(id) {
+        return TEMPLATES.get(id);
+    }
+    list() {
+        return [...TEMPLATES.values()];
+    }
+    has(id) {
+        return TEMPLATES.has(id);
+    }
+    /**
+     * 템플릿을 기반으로 specPrompt를 위한 추가 컨텍스트 문자열 생성.
+     * TextBasedSpecGenerator.buildSpecContext()에서 주입된다.
+     */
+    buildTemplateContext(id) {
+        const template = this.get(id);
+        if (!template)
+            return null;
+        const lines = [
+            `## Template: ${template.name}`,
+            `${template.description}`,
+            '',
+            '### Template Base Constraints (merge into spec constraints)',
+            ...template.baseConstraints.map((c) => `- ${c}`),
+            '',
+            '### Template Base Acceptance Criteria (merge into spec ACs)',
+            ...template.baseAcceptanceCriteria.map((ac) => `- ${ac}`),
+            '',
+            '### Suggested Ontology Entities',
+            ...template.baseOntologyEntities.map((e) => `- ${e}`),
+        ];
+        return lines.join('\n');
+    }
+}
+//# sourceMappingURL=templates.js.map

package/dist/src/spec/templates.js.map

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

package/dist/src/spec/text-based-spec-generator.d.ts

@@ -0,0 +1,15 @@
+import type { AgentRegistry } from '../agent/registry.js';
+import type { ProjectMemory } from '../core/types.js';
+export interface TextSpecContext {
+    systemPrompt: string;
+    specPrompt: string;
+    memoryContext?: string;
+    templateId?: string;
+}
+export declare class TextBasedSpecGenerator {
+    private agentRegistry?;
+    private templateRegistry;
+    constructor(agentRegistry?: AgentRegistry);
+    buildSpecContext(text: string, memory?: ProjectMemory, templateId?: string): TextSpecContext;
+}
+//# sourceMappingURL=text-based-spec-generator.d.ts.map

package/dist/src/spec/text-based-spec-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-based-spec-generator.d.ts","sourceRoot":"","sources":["../../../src/spec/text-based-spec-generator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGtD,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AA+CD,qBAAa,sBAAsB;IACjC,OAAO,CAAC,aAAa,CAAC,CAAgB;IACtC,OAAO,CAAC,gBAAgB,CAAuB;gBAEnC,aAAa,CAAC,EAAE,aAAa;IAKzC,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,aAAa,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,eAAe;CAc7F"}

package/dist/src/spec/text-based-spec-generator.js

@@ -0,0 +1,63 @@
+import { INTERVIEW_SYSTEM_PROMPT } from '../llm/prompts.js';
+import { mergeSystemPrompt } from '../agent/prompt-resolver.js';
+import { SpecTemplateRegistry } from './templates.js';
+function buildMemorySection(memory) {
+    if (memory.specHistory.length === 0 && memory.architectureDecisions.length === 0) {
+        return '';
+    }
+    const lines = ['## Prior Project Context (from .gestalt/memory.json)'];
+    if (memory.specHistory.length > 0) {
+        lines.push('\n### Previous Specs');
+        for (const entry of memory.specHistory.slice(-5)) {
+            lines.push(`- [${entry.createdAt.slice(0, 10)}] ${entry.goal} (specId: ${entry.specId})`);
+        }
+    }
+    if (memory.architectureDecisions.length > 0) {
+        lines.push('\n### Architecture Decisions');
+        for (const decision of memory.architectureDecisions) {
+            lines.push(`- ${decision}`);
+        }
+    }
+    return lines.join('\n');
+}
+function buildTextSpecPrompt(text, memoryContext, templateContext) {
+    return `Generate a complete project specification (Spec) from the following description.
+${memoryContext ? `\n${memoryContext}\n` : ''}${templateContext ? `\n${templateContext}\n` : ''}
+## Description
+${text}
+
+Respond with ONLY a JSON object:
+{
+  "goal": "Clear, concise project goal",
+  "constraints": ["constraint 1", "constraint 2"],
+  "acceptanceCriteria": ["criterion 1", "criterion 2"],
+  "ontologySchema": {
+    "entities": [{"name": "EntityName", "description": "what it is", "attributes": ["attr1"]}],
+    "relations": [{"from": "Entity1", "to": "Entity2", "type": "relationship_type"}]
+  },
+  "gestaltAnalysis": [
+    {"principle": "closure|proximity|similarity|figure_ground|continuity", "finding": "what was inferred", "confidence": 0.0-1.0}
+  ]
+}`;
+}
+export class TextBasedSpecGenerator {
+    agentRegistry;
+    templateRegistry;
+    constructor(agentRegistry) {
+        this.agentRegistry = agentRegistry;
+        this.templateRegistry = new SpecTemplateRegistry();
+    }
+    buildSpecContext(text, memory, templateId) {
+        const systemPrompt = mergeSystemPrompt(INTERVIEW_SYSTEM_PROMPT, this.agentRegistry, 'spec');
+        const memoryContext = memory ? buildMemorySection(memory) : undefined;
+        const templateContext = templateId ? this.templateRegistry.buildTemplateContext(templateId) ?? undefined : undefined;
+        const specPrompt = buildTextSpecPrompt(text, memoryContext || undefined, templateContext);
+        return {
+            systemPrompt,
+            specPrompt,
+            memoryContext: memoryContext || undefined,
+            templateId: templateId || undefined,
+        };
+    }
+}
+//# sourceMappingURL=text-based-spec-generator.js.map

package/dist/src/spec/text-based-spec-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-based-spec-generator.js","sourceRoot":"","sources":["../../../src/spec/text-based-spec-generator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAE5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAEhE,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAStD,SAAS,kBAAkB,CAAC,MAAqB;IAC/C,IAAI,MAAM,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,CAAC,qBAAqB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjF,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,KAAK,GAAa,CAAC,sDAAsD,CAAC,CAAC;IAEjF,IAAI,MAAM,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClC,KAAK,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;QACnC,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACjD,KAAK,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,KAAK,CAAC,IAAI,aAAa,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;QAC5F,CAAC;IACH,CAAC;IAED,IAAI,MAAM,CAAC,qBAAqB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5C,KAAK,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;QAC3C,KAAK,MAAM,QAAQ,IAAI,MAAM,CAAC,qBAAqB,EAAE,CAAC;YACpD,KAAK,CAAC,IAAI,CAAC,KAAK,QAAQ,EAAE,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,mBAAmB,CAAC,IAAY,EAAE,aAAsB,EAAE,eAAwB;IACzF,OAAO;EACP,aAAa,CAAC,CAAC,CAAC,KAAK,aAAa,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,eAAe,CAAC,CAAC,CAAC,KAAK,eAAe,IAAI,CAAC,CAAC,CAAC,EAAE;;EAE7F,IAAI;;;;;;;;;;;;;;EAcJ,CAAC;AACH,CAAC;AAED,MAAM,OAAO,sBAAsB;IACzB,aAAa,CAAiB;IAC9B,gBAAgB,CAAuB;IAE/C,YAAY,aAA6B;QACvC,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;QACnC,IAAI,CAAC,gBAAgB,GAAG,IAAI,oBAAoB,EAAE,CAAC;IACrD,CAAC;IAED,gBAAgB,CAAC,IAAY,EAAE,MAAsB,EAAE,UAAmB;QACxE,MAAM,YAAY,GAAG,iBAAiB,CAAC,uBAAuB,EAAE,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;QAE5F,MAAM,aAAa,GAAG,MAAM,CAAC,CAAC,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACtE,MAAM,eAAe,GAAG,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,oBAAoB,CAAC,UAAU,CAAC,IAAI,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;QACrH,MAAM,UAAU,GAAG,mBAAmB,CAAC,IAAI,EAAE,aAAa,IAAI,SAAS,EAAE,eAAe,CAAC,CAAC;QAE1F,OAAO;YACL,YAAY;YACZ,UAAU;YACV,aAAa,EAAE,aAAa,IAAI,SAAS;YACzC,UAAU,EAAE,UAAU,IAAI,SAAS;SACpC,CAAC;IACJ,CAAC;CACF"}

package/package.json

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

package/role-agents/technical-writer/AGENT.md

@@ -32,8 +32,20 @@ When writing Korean developer documentation, follow these conventions observed i
 **Formatting Patterns**
 - Bold key terms on first use: **소모성 아이템**, **비소모성 아이템**
 - Use bullet lists for features, options, and constraints — keep each item concise
+- Use numbered lists when sequence matters — installation steps, API call order, migration procedures
+  — Don't: bullet a 3-step setup where step 2 depends on step 1
+  — Do: number any list where "do these in order" is part of the instruction
 - Separate distinct concepts with `---` horizontal rules
-- End conceptual sections with a "참고해 주세요" callout for edge cases or policy notes
+- Use callout blocks to signal importance — choose the type based on consequence:
+  - 💡 **Tip**: better approach, shortcut, optional improvement
+  - 📝 **Note / 참고**: extra context, exception cases, policy notes — use at the end of conceptual sections
+  - ⚠️ **Warning / 주의**: incorrect usage causes problems (wrong output, wasted time)
+  - 🔴 **Danger / 경고**: data loss, security risk, service outage — reader must not skip this
+  — Don't use Note for Danger: "참고로 이 명령어는 데이터를 삭제해요" understates the risk
+- Write descriptive link text — destination should be clear from the link text alone
+  — Don't: "자세한 내용은 [여기](...)를 참고하세요."
+  — Do: "자세한 내용은 [설치 가이드](...)를 참고하세요."
+  — Don't: "See [this](url)." → Do: "See [API authentication guide](url)."
 
 **Content Principles**
 - Lead with business value or user benefit, follow with technical detail
@@ -46,6 +58,26 @@ When writing Korean developer documentation, follow these conventions observed i
 - Avoid listing terms inline in introductions if they are covered in a dedicated section below — redundant inline lists interrupt flow without adding value
 
 **Korean Sentence Writing**
+
+**핵심 원칙: 영어로 생각하고 번역하지 말 것**
+한국어로 직접 작성한다. "dependency-based execution planning"을 머릿속에서 먼저 영어로 구성한 뒤 번역하면 번역체가 된다.
+
+- ❌ 의존성 기반 실행 계획 수립 → ✅ 의존성에 따라 실행 순서를 정해요
+- ❌ 스태그네이션 감지 메커니즘이 트리거됩니다 → ✅ 답보 상태를 감지하면 자동으로 분기해요
+- ❌ 스포닝 → ✅ 하위 에이전트 생성
+- ❌ 소급 검토 컨텍스트 → ✅ 회고 컨텍스트
+- ❌ 임의 태스크에 적용 가능합니다 → ✅ 모든 태스크에 적용할 수 있어요
+- ❌ 단락(short-circuit) 처리 → ✅ 조기 종료 처리
+- ❌ 수익 체감 패턴 → ✅ 효과 감소 패턴
+
+**기술 용어 3단계 처리**
+
+| 단계 | 사용 기준 | 예시 |
+|------|-----------|------|
+| 영어 그대로 | 한국 개발자들이 영어로 통용하는 용어 | API, CLI, JSON, Git, PR, LLM, DAG |
+| 한국어 + 영어 병기 (첫 등장) | 덜 일반적인 전문 용어의 첫 사용 | 이벤트 소싱(Event Sourcing), 단락 회로 실행(Short-circuit Evaluation) |
+| 한국어만 | 자연스러운 한국어 표현이 있는 경우 | 버전 관리 (버저닝 ❌), 배포 (디플로이먼트 ❌) |
+
 - Reader is the subject: write so the developer is the actor — use active constructions
   — Don't: "설정이 완료되어야 합니다." → Do: "설정을 완료하세요."
   — Don't: "이 라이브러리는 초기화를 수행해요." → Do: "이 명령어로 초기화하세요."
@@ -206,7 +238,11 @@ When writing documentation, produce:
 - Callout blocks for important notes, warnings, or tips
 
 When reviewing existing documentation, provide:
-- Specific issues by section (clarity / structure / completeness / consistency)
-- Rewrite suggestions for unclear passages
+- Issues classified by severity:
+  - **Blocker**: reader can misunderstand, follow wrong steps, or miss a critical risk — must fix before publish
+  - **Fix**: clarity, consistency, or structural problem — fix when possible
+  - **Suggest**: improvement idea — optional, at author's discretion
+- Specific location (section name or quoted passage) for each issue
+- Rewrite suggestions for all Blocker and Fix items
 - Missing content checklist
 - Overall readability assessment

package/skills/execute/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: execute
-version: "1.1.0"
+version: "1.2.0"
 description: "Gestalt-driven execution planner that transforms a Spec into a validated ExecutionPlan"
 triggers:
   - "execute"
@@ -350,3 +350,68 @@ role_match/role_consensus로 얻은 `roleGuidance`를 참조해 태스크를 수
 | `hard_cap` | structural 3회 + contextual 3회 실패 |
 | `caller` | `{ action: "evolve", terminateReason: "caller" }` |
 | `human_escalation` | 4개 lateral persona 소진 |
+
+---
+
+## 공통 진행 패널
+
+Execute 파이프라인 실행 중 Claude Code Task 패널에 실시간 상태를 표시한다. 패널 업데이트는 best-effort — 실패가 태스크 실행 흐름을 중단시켜서는 안 된다.
+
+### Planning 단계 시작 시 (`start` 응답 수신 후)
+
+`TaskCreate`로 실행 패널을 생성하고, 반환된 taskId를 세션 동안 보관한다.
+
+```
+subject: "Gestalt Execute: {spec.goal 앞 40자}"
+description: "Planning 중 | 단계 1/4 | figure_ground"
+activeForm: "실행 계획 수립 중"
+```
+
+### Planning 각 단계 후 (`plan_step` 응답 수신 시마다)
+
+`TaskUpdate`로 현재 Planning 단계를 업데이트한다.
+
+```
+description: "Planning 중 | 단계 {stepsCompleted}/4 | {currentPrinciple}"
+```
+
+### Execution 시작 후 (`execute_start` 응답 수신 후)
+
+Planning 패널 태스크를 완료하고, 새 Execution 패널 태스크를 생성한다.
+
+```
+subject: "Gestalt Execute: {spec.goal 앞 40자}"
+description: "0/{totalTasks} 완료 | 현재: 시작 대기 중 | 실패: 0개 | 그룹 0/{parallelGroupCount}"
+activeForm: "태스크 실행 중"
+```
+
+`plan_complete` 응답의 `planSummary.totalTasks`와 `planSummary.parallelGroupCount`를 활용한다.
+
+### 각 태스크 완료 후 (`execute_task` 응답 수신 시마다)
+
+`TaskUpdate`로 진행 상황을 업데이트한다.
+
+```
+description: "{completedCount}/{totalTasks} 완료 | 현재: {nextTask.title or '완료'} | 실패: {failedCount}개 | 그룹 {groupIndex}/{totalGroups}"
+```
+
+- `completedCount`: 지금까지 제출한 taskResult 수
+- `nextTask`: 응답의 `nextTaskId`로 다음 태스크 이름 추론
+- `failedCount`: status가 `failed`인 taskResult 수
+- `groupIndex/totalGroups`: `plan_complete` 응답의 `parallelGroups` 기준
+
+`allTasksCompleted === true` 이면 description에 "전체 완료" 표시 후 `TaskUpdate`로 status를 completed로 변경한다.
+
+### 평가/진화 단계
+
+- `evaluate` 시작: description에 "평가 중 — structural 검사" 추가
+- structural 통과: "평가 중 — contextual 검사" 로 업데이트
+- 평가 완료(success): `TaskUpdate({ status: "completed", description: "완료 | score: {overallScore} | alignment: {goalAlignment}" })`
+- Evolve 진입: description에 "개선 중 (generation {N})" 추가
+
+### 오류/에스컬레이션 시
+
+```
+status: "completed"
+description: "종료: {terminationReason} | 최고 점수: {bestScore}"
+```

package/skills/interview/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: interview
-version: "1.0.0"
+version: "1.1.0"
 description: "Gestalt-driven interview to clarify project requirements"
 triggers:
   - "interview"
@@ -80,3 +80,38 @@ API 키 없이 MCP 서버 실행 시 자동 활성화. LLM 작업을 caller가
 | `questionPrompt` | string | 다음 질문 생성용 프롬프트 |
 | `scoringPrompt` | string? | 모호성 점수 산출용 프롬프트 (respond 후에만 포함) |
 | `roundNumber` | number | 현재 라운드 번호 |
+
+---
+
+## 공통 진행 패널
+
+인터뷰 진행 중 Claude Code Task 패널에 실시간 상태를 표시한다. 패널 업데이트는 best-effort — 업데이트 실패가 인터뷰 흐름을 중단시켜서는 안 된다.
+
+### 시작 시 (`start` 응답 수신 직후)
+
+`TaskCreate`를 호출해 진행 패널을 생성하고, 반환된 taskId를 세션 동안 보관한다.
+
+```
+subject: "Gestalt 인터뷰: {topic}"
+description: "라운드 1/{maxRounds} | 원리: {currentPrinciple} | 모호성: 측정 전"
+activeForm: "인터뷰 진행 중"
+```
+
+### 각 라운드 후 (`respond` 응답 수신 시마다)
+
+`TaskUpdate`로 description을 최신 상태로 갱신한다. 모호성 점수는 추이 형식으로 표시한다.
+
+```
+description: "라운드 {roundNumber}/{maxRounds} | 원리: {currentPrinciple} | 모호성: {score1} → {score2} → {latestScore}"
+```
+
+ambiguityScore.isReady === true 이면 description에 "✓ 준비 완료" 표시를 추가한다.
+
+### 완료 시 (`complete` 응답 수신 후)
+
+`TaskUpdate`로 status를 completed로 변경한다.
+
+```
+status: "completed"
+description: "총 {totalRounds}라운드 완료 | 최종 모호성: {finalAmbiguityScore}"
+```

package/skills/spec/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: spec
-version: "1.0.0"
+version: "1.1.0"
 description: "Generate a Spec specification from a completed interview"
 triggers:
   - "generate spec"
@@ -90,3 +90,35 @@ ges_generate_spec({
 - `gestaltAnalysis[].confidence`: 0.0 ~ 1.0
 - `ontologySchema.entities[]`: `{ name: string(min 1), description: string, attributes: string[] }`
 - `ontologySchema.relations[]`: `{ from: string(min 1), to: string(min 1), type: string(min 1) }`
+
+---
+
+## 공통 진행 패널
+
+Spec 생성 중 Claude Code Task 패널에 상태를 표시한다. best-effort — 패널 실패가 Spec 생성을 막아서는 안 된다.
+
+### 시작 시 (1단계 `ges_generate_spec` 호출 전)
+
+`TaskCreate`로 패널을 생성한다.
+
+```
+subject: "Spec 생성 중"
+description: "인터뷰 세션 {sessionId} 기반 Spec 구성 중..."
+activeForm: "Spec 생성 중"
+```
+
+### 완료 시 (2단계 `ges_generate_spec` 응답 수신 후)
+
+`TaskUpdate`로 status를 completed로 변경한다.
+
+```
+status: "completed"
+description: "Spec 생성 완료 | specId: {spec.metadata.specId}"
+```
+
+실패 시(error 반환):
+
+```
+status: "completed"
+description: "Spec 생성 실패: {error}"
+```