@tienne/gestalt 0.84.2 → 0.86.0

package/dist/src/memory/project-memory-store.js

@@ -1,5 +1,8 @@
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { existsSync } from 'node:fs';
 import { join, dirname } from 'node:path';
+import { withFileLock } from '../core/file-lock.js';
+import { isPlainObject, readJsonOrQuarantine, writeJsonAtomic } from '../core/json-file.js';
+import { log } from '../core/log.js';
 const MEMORY_FILENAME = '.gestalt/memory.json';
 const MEMORY_VERSION = '1.0.0';
 function detectRepoRoot(startDir) {
@@ -33,139 +36,113 @@ export class ProjectMemoryStore {
         this.repoRoot = detectRepoRoot(cwd ?? process.cwd());
         this.memoryPath = join(this.repoRoot, MEMORY_FILENAME);
     }
+    /**
+     * 메모리를 읽는다. 읽기 자체가 실패하면 빈 메모리를 돌려준다.
+     *
+     * 인터뷰에 맥락을 끼워 넣는 자리라 여기서 던지면 인터뷰가 멈춘다. 고쳐 쓰는 경로는
+     * 이 메서드 대신 `load()`를 직접 불러, 못 읽은 채로 빈 메모리를 덮어쓰지 않는다.
+     * 잠금 없이 읽으므로 깨진 파일을 옮기지 않는다. 옮기는 건 잠금을 쥔 `update()`만 한다.
+     */
     read() {
-        if (!existsSync(this.memoryPath)) {
-            return createEmptyMemory(this.repoRoot);
-        }
         try {
-            const raw = readFileSync(this.memoryPath, 'utf-8');
-            const parsed = JSON.parse(raw);
-            // v1 → v2 자동 마이그레이션: architectureDecisions string[] → ArchitectureDecision[]
-            if (Array.isArray(parsed.architectureDecisions)) {
-                parsed.architectureDecisions = parsed.architectureDecisions.map((item) => {
-                    if (typeof item === 'string') {
-                        return {
-                            decision: item,
-                            rationale: '',
-                            specId: '',
-                            timestamp: new Date().toISOString(),
-                        };
-                    }
-                    return item;
-                });
-            }
-            return parsed;
+            return this.load({ quarantine: false });
         }
-        catch {
+        catch (e) {
+            log(`${this.memoryPath}를 읽지 못했어요:`, e);
             return createEmptyMemory(this.repoRoot);
         }
     }
-    write(memory) {
-        const dir = dirname(this.memoryPath);
-        if (!existsSync(dir)) {
-            mkdirSync(dir, { recursive: true });
-        }
-        memory.lastUpdated = new Date().toISOString();
-        writeFileSync(this.memoryPath, JSON.stringify(memory, null, 2), 'utf-8');
+    load(options) {
+        const raw = readJsonOrQuarantine(this.memoryPath, isPlainObject, options);
+        if (raw === undefined)
+            return createEmptyMemory(this.repoRoot);
+        const parsed = raw;
+        const memory = {
+            ...createEmptyMemory(this.repoRoot),
+            ...parsed,
+            specHistory: Array.isArray(parsed.specHistory) ? parsed.specHistory : [],
+            executionHistory: Array.isArray(parsed.executionHistory) ? parsed.executionHistory : [],
+            architectureDecisions: Array.isArray(parsed.architectureDecisions)
+                ? parsed.architectureDecisions
+                : [],
+            compressedContexts: Array.isArray(parsed.compressedContexts)
+                ? parsed.compressedContexts
+                : undefined,
+        };
+        // v1 → v2 자동 마이그레이션: architectureDecisions string[] → ArchitectureDecision[]
+        memory.architectureDecisions = memory.architectureDecisions.map((item) => {
+            if (typeof item === 'string') {
+                return {
+                    decision: item,
+                    rationale: '',
+                    specId: '',
+                    timestamp: new Date().toISOString(),
+                };
+            }
+            return item;
+        });
+        return memory;
+    }
+    /**
+     * 잠금을 쥔 채 읽고 고쳐 쓴다.
+     *
+     * 워크트리나 프로세스 여럿이 같은 메모리에 동시에 기록하면, 잠금 없이는 늦게 쓴 쪽이
+     * 먼저 쓴 쪽의 항목을 덮는다.
+     */
+    update(mutate) {
+        return withFileLock(`${this.memoryPath}.lock`, ({ stillMine }) => {
+            const memory = this.load({ quarantine: true });
+            mutate(memory);
+            if (!stillMine()) {
+                throw new Error('메모리 잠금을 뺏겨서 안 썼어요. 다시 불러주세요');
+            }
+            memory.lastUpdated = new Date().toISOString();
+            writeJsonAtomic(this.memoryPath, memory);
+            return memory;
+        }, { busyMessage: '메모리 파일이 잠겨 있어서 못 고쳤어요' });
     }
     addSpec(entry) {
-        const memory = this.read();
-        // Prevent duplicate specId entries
-        const exists = memory.specHistory.some((s) => s.specId === entry.specId);
-        if (!exists) {
-            memory.specHistory.push(entry);
-        }
-        this.write(memory);
-        return memory;
+        return this.update((memory) => {
+            // Prevent duplicate specId entries
+            const exists = memory.specHistory.some((s) => s.specId === entry.specId);
+            if (!exists) {
+                memory.specHistory.push(entry);
+            }
+        });
     }
     addExecution(record) {
-        const memory = this.read();
-        // Prevent duplicate executeSessionId entries
-        const exists = memory.executionHistory.some((e) => e.executeSessionId === record.executeSessionId);
-        if (!exists) {
-            memory.executionHistory.push(record);
-        }
-        this.write(memory);
-        return memory;
+        return this.update((memory) => {
+            // Prevent duplicate executeSessionId entries
+            const exists = memory.executionHistory.some((e) => e.executeSessionId === record.executeSessionId);
+            if (!exists) {
+                memory.executionHistory.push(record);
+            }
+        });
     }
     addArchitectureDecision(decision) {
-        const memory = this.read();
-        // decision 내용 기준 중복 방지 (같은 결정을 중복 기록하지 않음)
-        const exists = memory.architectureDecisions.some((d) => d.decision === decision.decision);
-        if (!exists) {
-            memory.architectureDecisions.push(decision);
-        }
-        this.write(memory);
-        return memory;
+        return this.update((memory) => {
+            // decision 내용 기준 중복 방지 (같은 결정을 중복 기록하지 않음)
+            const exists = memory.architectureDecisions.some((d) => d.decision === decision.decision);
+            if (!exists) {
+                memory.architectureDecisions.push(decision);
+            }
+        });
     }
     addCompressedContext(sessionId, summary) {
-        const memory = this.read();
-        if (!memory.compressedContexts) {
-            memory.compressedContexts = [];
-        }
-        // Replace existing entry for same sessionId
-        const idx = memory.compressedContexts.findIndex((c) => c.sessionId === sessionId);
-        const entry = { sessionId, summary, compressedAt: new Date().toISOString() };
-        if (idx >= 0) {
-            memory.compressedContexts[idx] = entry;
-        }
-        else {
-            memory.compressedContexts.push(entry);
-        }
-        this.write(memory);
-        return memory;
-    }
-    async searchSimilarSpecs(query, topK = 3) {
-        const { searchSimilarSpecs } = await import('./semantic-search.js');
-        const memory = this.read();
-        return searchSimilarSpecs(query, memory, topK);
-    }
-    /**
-     * local과 remote ProjectMemory를 머지한다.
-     *
-     * - specHistory: specId 기준 dedupe (remote에 없는 local 항목 추가)
-     * - executionHistory: executeSessionId 기준 dedupe (동일 방식)
-     * - architectureDecisions: timestamp+decision 기준 dedupe
-     * - 그 외 스칼라 필드: local 값 우선, lastUpdated는 최신값
-     */
-    mergeMemory(local, remote) {
-        // specHistory: specId 기준 dedupe — remote 기준에서 local에만 있는 항목 추가
-        const remoteSpecIds = new Set(remote.specHistory.map((s) => s.specId));
-        const mergedSpecHistory = [
-            ...remote.specHistory,
-            ...local.specHistory.filter((s) => !remoteSpecIds.has(s.specId)),
-        ];
-        // executionHistory: executeSessionId 기준 dedupe
-        const remoteExecIds = new Set(remote.executionHistory.map((e) => e.executeSessionId));
-        const mergedExecutionHistory = [
-            ...remote.executionHistory,
-            ...local.executionHistory.filter((e) => !remoteExecIds.has(e.executeSessionId)),
-        ];
-        // architectureDecisions: timestamp+decision 기준 dedupe
-        const remoteDecisionKeys = new Set(remote.architectureDecisions.map((d) => `${d.timestamp}::${d.decision}`));
-        const mergedArchitectureDecisions = [
-            ...remote.architectureDecisions,
-            ...local.architectureDecisions.filter((d) => !remoteDecisionKeys.has(`${d.timestamp}::${d.decision}`)),
-        ];
-        // compressedContexts: sessionId 기준 dedupe (remote 우선)
-        const localContexts = local.compressedContexts ?? [];
-        const remoteContexts = remote.compressedContexts ?? [];
-        const remoteContextIds = new Set(remoteContexts.map((c) => c.sessionId));
-        const mergedContexts = [
-            ...remoteContexts,
-            ...localContexts.filter((c) => !remoteContextIds.has(c.sessionId)),
-        ];
-        // lastUpdated: 더 최신 값 사용
-        const lastUpdated = local.lastUpdated > remote.lastUpdated ? local.lastUpdated : remote.lastUpdated;
-        return {
-            version: local.version,
-            repoRoot: local.repoRoot,
-            specHistory: mergedSpecHistory,
-            executionHistory: mergedExecutionHistory,
-            architectureDecisions: mergedArchitectureDecisions,
-            compressedContexts: mergedContexts.length > 0 ? mergedContexts : undefined,
-            lastUpdated,
-        };
+        return this.update((memory) => {
+            if (!memory.compressedContexts) {
+                memory.compressedContexts = [];
+            }
+            // Replace existing entry for same sessionId
+            const idx = memory.compressedContexts.findIndex((c) => c.sessionId === sessionId);
+            const entry = { sessionId, summary, compressedAt: new Date().toISOString() };
+            if (idx >= 0) {
+                memory.compressedContexts[idx] = entry;
+            }
+            else {
+                memory.compressedContexts.push(entry);
+            }
+        });
     }
     getRepoRoot() {
         return this.repoRoot;

package/dist/src/memory/project-memory-store.js.map

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

package/dist/src/memory/semantic-search.d.ts

@@ -1,11 +1,14 @@
 import type { ProjectMemory, SpecHistoryEntry } from '../core/types.js';
+/** @internal 테스트에서 모듈 상태를 비운다 */
+export declare function resetSemanticSearchState(): void;
 /**
  * ProjectMemory의 specHistory에서 query와 시맨틱으로 유사한 상위 K개를 반환한다.
  *
  * @param query  검색 쿼리 문자열
  * @param memory ProjectMemory 인스턴스
  * @param topK   반환할 최대 항목 수 (기본값: 3)
+ * @param minScore 이 값보다 유사도가 낮은 항목은 버린다 (기본값: 0)
  * @returns      cosine similarity 내림차순으로 정렬된 SpecHistoryEntry[]
  */
-export declare function searchSimilarSpecs(query: string, memory: ProjectMemory, topK?: number): Promise<SpecHistoryEntry[]>;
+export declare function searchSimilarSpecs(query: string, memory: ProjectMemory, topK?: number, minScore?: number): Promise<SpecHistoryEntry[]>;
 //# sourceMappingURL=semantic-search.d.ts.map

package/dist/src/memory/semantic-search.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"semantic-search.d.ts","sourceRoot":"","sources":["../../../src/memory/semantic-search.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAoCxE;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,aAAa,EACrB,IAAI,SAAI,GACP,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAmB7B"}
+{"version":3,"file":"semantic-search.d.ts","sourceRoot":"","sources":["../../../src/memory/semantic-search.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAuExE,iCAAiC;AACjC,wBAAgB,wBAAwB,IAAI,IAAI,CAM/C;AAID;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,aAAa,EACrB,IAAI,SAAI,EACR,QAAQ,SAAI,GACX,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAqB7B"}

package/dist/src/memory/semantic-search.js

@@ -15,40 +15,87 @@ function cosineSimilarity(a, b) {
     const denom = Math.sqrt(normA) * Math.sqrt(normB);
     return denom === 0 ? 0 : dot / denom;
 }
-/**
- * EmbeddingService lazy-load 래퍼.
- * 모델 로드가 무거우므로 첫 호출 시에만 import한다.
- */
-let embeddingServiceInstance = null;
-async function getEmbeddingService() {
-    if (!embeddingServiceInstance) {
-        const { EmbeddingService } = await import('../knowledge-base/embedding.js');
-        embeddingServiceInstance = new EmbeddingService();
+// EmbeddingService의 all-MiniLM-L6-v2는 영어로만 학습됐다. 한글 문장끼리는 주제가 달라도
+// 0.6~0.8이 나와 엉뚱한 스펙이 상위로 올라온다. 한글로 확인했고 같은 이유로 가나와 한자도 뺀다.
+// 틀린 맥락을 넣느니 아예 안 넣는다
+const UNSUPPORTED_SCRIPT = /[\u1100-\u11FF\u3040-\u30FF\u3130-\u318F\u4E00-\u9FFF\uAC00-\uD7AF]/;
+// 모델을 못 받는 환경에서 start마다 다시 받으려 들지 않게, 로딩에 실패하면 이 시간 동안 재시도하지 않는다
+const RETRY_AFTER_FAILURE_MS = 5 * 60 * 1000;
+let servicePromise = null;
+let modelReady = false;
+let modelLoading = false;
+let lastFailureAt = 0;
+// goal 벡터는 스펙이 바뀌지 않는 한 같으므로 start마다 다시 임베딩하지 않는다
+const goalVectors = new Map();
+function getEmbeddingService() {
+    servicePromise ??= import('../knowledge-base/embedding.js').then(({ EmbeddingService }) => new EmbeddingService(), (e) => {
+        servicePromise = null;
+        throw e;
+    });
+    return servicePromise;
+}
+// 모델이 아직 안 올라왔으면 한 번에 하나만 받게 한다. 로딩 중에 들어온 호출은 기다리지 않고
+// 실패로 돌려 호출부가 바로 폴백하게 한다 — 기다려 봐야 호출부 제한 시간에 걸린다.
+// 재시도 대기(RETRY_AFTER_FAILURE_MS)는 로딩 실패에만 건다. 올라온 뒤의 임베딩 실패는 다음 호출에서 그냥 다시 해본다
+async function embedTexts(texts) {
+    const service = await getEmbeddingService();
+    if (!modelReady) {
+        if (modelLoading)
+            throw new Error('embedding model is still loading');
+        if (Date.now() - lastFailureAt < RETRY_AFTER_FAILURE_MS) {
+            throw new Error('embedding model failed to load recently');
+        }
+        modelLoading = true;
+        try {
+            await service.ensureLoaded();
+            modelReady = true;
+        }
+        catch (e) {
+            lastFailureAt = Date.now();
+            throw e;
+        }
+        finally {
+            modelLoading = false;
+        }
     }
-    return embeddingServiceInstance;
+    return service.embedBatch(texts);
 }
+/** @internal 테스트에서 모듈 상태를 비운다 */
+export function resetSemanticSearchState() {
+    servicePromise = null;
+    modelReady = false;
+    modelLoading = false;
+    lastFailureAt = 0;
+    goalVectors.clear();
+}
+const vectorKey = (e) => `${e.specId}\0${e.goal}`;
 /**
  * ProjectMemory의 specHistory에서 query와 시맨틱으로 유사한 상위 K개를 반환한다.
  *
  * @param query  검색 쿼리 문자열
  * @param memory ProjectMemory 인스턴스
  * @param topK   반환할 최대 항목 수 (기본값: 3)
+ * @param minScore 이 값보다 유사도가 낮은 항목은 버린다 (기본값: 0)
  * @returns      cosine similarity 내림차순으로 정렬된 SpecHistoryEntry[]
  */
-export async function searchSimilarSpecs(query, memory, topK = 3) {
-    const entries = memory.specHistory;
+export async function searchSimilarSpecs(query, memory, topK = 3, minScore = 0) {
+    if (UNSUPPORTED_SCRIPT.test(query))
+        return [];
+    const entries = memory.specHistory.filter((e) => !UNSUPPORTED_SCRIPT.test(e.goal));
     if (entries.length === 0)
         return [];
-    const service = await getEmbeddingService();
-    // query + 각 항목의 goal을 한 번에 배치 임베딩
-    const texts = [query, ...entries.map((e) => e.goal)];
-    const vectors = await service.embedBatch(texts);
+    const uncached = entries.filter((e) => !goalVectors.has(vectorKey(e)));
+    const vectors = await embedTexts([query, ...uncached.map((e) => e.goal)]);
+    uncached.forEach((e, idx) => goalVectors.set(vectorKey(e), vectors[idx + 1]));
     const queryVec = vectors[0];
-    const scored = entries.map((entry, idx) => ({
+    const scored = entries.map((entry) => ({
         entry,
-        score: cosineSimilarity(queryVec, vectors[idx + 1]),
+        score: cosineSimilarity(queryVec, goalVectors.get(vectorKey(entry))),
     }));
     scored.sort((a, b) => b.score - a.score);
-    return scored.slice(0, topK).map((s) => s.entry);
+    return scored
+        .filter((s) => s.score >= minScore)
+        .slice(0, topK)
+        .map((s) => s.entry);
 }
 //# sourceMappingURL=semantic-search.js.map

package/dist/src/memory/semantic-search.js.map

@@ -1 +1 @@
-{"version":3,"file":"semantic-search.js","sourceRoot":"","sources":["../../../src/memory/semantic-search.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,SAAS,gBAAgB,CAAC,CAAW,EAAE,CAAW;IAChD,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IACtD,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAE,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC;QACrB,KAAK,IAAI,CAAC,CAAC,CAAC,CAAE,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC;QACvB,KAAK,IAAI,CAAC,CAAC,CAAC,CAAE,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC;IACzB,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClD,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,KAAK,CAAC;AACvC,CAAC;AAED;;;GAGG;AACH,IAAI,wBAAwB,GAC1B,IAAI,CAAC;AAEP,KAAK,UAAU,mBAAmB;IAGhC,IAAI,CAAC,wBAAwB,EAAE,CAAC;QAC9B,MAAM,EAAE,gBAAgB,EAAE,GAAG,MAAM,MAAM,CAAC,gCAAgC,CAAC,CAAC;QAC5E,wBAAwB,GAAG,IAAI,gBAAgB,EAAE,CAAC;IACpD,CAAC;IACD,OAAO,wBAAwB,CAAC;AAClC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,KAAa,EACb,MAAqB,EACrB,IAAI,GAAG,CAAC;IAER,MAAM,OAAO,GAAG,MAAM,CAAC,WAAW,CAAC;IACnC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEpC,MAAM,OAAO,GAAG,MAAM,mBAAmB,EAAE,CAAC;IAE5C,kCAAkC;IAClC,MAAM,KAAK,GAAG,CAAC,KAAK,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IACrD,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IAEhD,MAAM,QAAQ,GAAG,OAAO,CAAC,CAAC,CAAE,CAAC;IAC7B,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;QAC1C,KAAK;QACL,KAAK,EAAE,gBAAgB,CAAC,QAAQ,EAAE,OAAO,CAAC,GAAG,GAAG,CAAC,CAAE,CAAC;KACrD,CAAC,CAAC,CAAC;IAEJ,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;IAEzC,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;AACnD,CAAC"}
+{"version":3,"file":"semantic-search.js","sourceRoot":"","sources":["../../../src/memory/semantic-search.ts"],"names":[],"mappings":"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"}

package/dist/src/resilience/lateral.d.ts

@@ -1,4 +1,4 @@
-import type { Spec, EvaluationResult, EvolutionGeneration } from '../core/types.js';
+import type { Spec, EvaluationResult, EvolutionGeneration, HumanGate, HumanGateOptionId } from '../core/types.js';
 import type { StagnationPattern, LateralPersonaName, LateralContext, EscalationContext } from './types.js';
 /**
  * pattern에 매핑된 1순위 persona를 먼저 시도하고,
@@ -17,4 +17,11 @@ export declare function buildEscalationContext(triedPersonas: LateralPersonaName
     taskId: string;
     title: string;
 }): EscalationContext;
+/**
+ * escalation을 사람이 답할 게이트로 바꾼다. 선택지는 recommendedSolutions의 세 방향에 abort를 더한 것이고
+ * 세션을 이어가는 쪽을 앞에 둔다.
+ */
+export declare function buildEscalationGate(escalation: EscalationContext): HumanGate;
+/** 이 선택지로 해소하면 세션이 이어지는가. 아니면 세션을 종료한다 */
+export declare function gateOptionResumesSession(optionId: HumanGateOptionId): boolean;
 //# sourceMappingURL=lateral.d.ts.map

package/dist/src/resilience/lateral.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lateral.d.ts","sourceRoot":"","sources":["../../../src/resilience/lateral.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACpF,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,cAAc,EACd,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAYpB;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,iBAAiB,EAC1B,aAAa,EAAE,kBAAkB,EAAE,GAClC,kBAAkB,GAAG,IAAI,CAiB3B;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,kBAAkB,EAC3B,OAAO,EAAE,iBAAiB,EAC1B,IAAI,EAAE,IAAI,EACV,gBAAgB,EAAE,gBAAgB,EAClC,gBAAgB,EAAE,mBAAmB,EAAE,EACvC,aAAa,EAAE,MAAM,GACpB,cAAc,CAkBhB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,aAAa,EAAE,kBAAkB,EAAE,EACnC,gBAAgB,EAAE,gBAAgB,EAClC,gBAAgB,EAAE,mBAAmB,EAAE,EACvC,WAAW,CAAC,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC9C,iBAAiB,CA+BnB"}
+{"version":3,"file":"lateral.d.ts","sourceRoot":"","sources":["../../../src/resilience/lateral.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,IAAI,EACJ,gBAAgB,EAChB,mBAAmB,EACnB,SAAS,EACT,iBAAiB,EAClB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,cAAc,EACd,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAYpB;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,iBAAiB,EAC1B,aAAa,EAAE,kBAAkB,EAAE,GAClC,kBAAkB,GAAG,IAAI,CAiB3B;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,kBAAkB,EAC3B,OAAO,EAAE,iBAAiB,EAC1B,IAAI,EAAE,IAAI,EACV,gBAAgB,EAAE,gBAAgB,EAClC,gBAAgB,EAAE,mBAAmB,EAAE,EACvC,aAAa,EAAE,MAAM,GACpB,cAAc,CAkBhB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,aAAa,EAAE,kBAAkB,EAAE,EACnC,gBAAgB,EAAE,gBAAgB,EAClC,gBAAgB,EAAE,mBAAmB,EAAE,EACvC,WAAW,CAAC,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC9C,iBAAiB,CA+BnB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,iBAAiB,GAAG,SAAS,CAsC5E;AAED,0CAA0C;AAC1C,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAE7E"}

package/dist/src/resilience/lateral.js

@@ -1,3 +1,4 @@
+import { randomUUID } from 'node:crypto';
 import { STAGNATION_PERSONA_MAP } from './types.js';
 import { getLateralSystemPrompt, buildLateralPrompt } from './prompts.js';
 /** 모든 persona 이름 (순회 순서) */
@@ -53,11 +54,11 @@ export function buildEscalationContext(triedPersonas, evaluationResult, evolutio
         .map((v) => `AC[${v.acIndex}]: ${v.gaps.join(', ')}`);
     const firstUnsatisfiedAC = unsatisfiedACs[0];
     const recommendedSolutions = [
-        '태스크를 더 작은 단위로 분해한 뒤 새 스펙으로 `execute start`를 재시작하세요.',
+        '태스크를 더 작은 단위로 분해한 뒤 새 스펙으로 `execute start`를 재시작하세요. (`gate_resolve` optionId=restart)',
         firstUnsatisfiedAC
-            ? `"${firstUnsatisfiedAC}" — 해당 acceptance criteria를 수정한 뒤 \`evolve_patch\`로 재실행하세요.`
-            : '해당 acceptance criteria를 수정한 뒤 `evolve_patch`로 재실행하세요.',
-        '이 태스크를 수동으로 처리한 뒤 `execute_task` 액션으로 결과를 제출하세요.',
+            ? `"${firstUnsatisfiedAC}" — 해당 acceptance criteria를 수정한 뒤 \`evolve_patch\`로 재실행하세요. (\`gate_resolve\` optionId=patch_spec)`
+            : '해당 acceptance criteria를 수정한 뒤 `evolve_patch`로 재실행하세요. (`gate_resolve` optionId=patch_spec)',
+        '이 태스크를 수동으로 처리한 뒤 `evaluate`로 다시 검증하세요. (`gate_resolve` optionId=manual_task)',
     ];
     return {
         phase: 'evolving',
@@ -74,4 +75,51 @@ export function buildEscalationContext(triedPersonas, evaluationResult, evolutio
         recommendedSolutions,
     };
 }
+/**
+ * escalation을 사람이 답할 게이트로 바꾼다. 선택지는 recommendedSolutions의 세 방향에 abort를 더한 것이고
+ * 세션을 이어가는 쪽을 앞에 둔다.
+ */
+export function buildEscalationGate(escalation) {
+    const where = escalation.blockedTask
+        ? `"${escalation.blockedTask.title}" 태스크에서`
+        : '평가 단계에서';
+    return {
+        gateId: `gate-${randomUUID()}`,
+        question: `${where} lateral persona ${escalation.triedPersonas.length}개를 다 써도 성공 기준에 못 닿았어요 (최고 점수 ${escalation.bestScore.toFixed(2)}). 어떻게 진행할까요?`,
+        options: [
+            {
+                id: 'patch_spec',
+                label: 'acceptance criteria나 제약을 고쳐 evolve_patch로 다시 돌린다',
+                nextAction: 'evolve_patch',
+            },
+            {
+                id: 'manual_task',
+                label: '막힌 태스크를 사람이 직접 처리하고 evaluate로 다시 검증한다',
+                nextAction: 'evaluate',
+            },
+            {
+                id: 'restart',
+                label: '태스크를 더 잘게 쪼갠 새 스펙으로 다시 시작한다 (이 세션은 종료된다)',
+                nextAction: 'start',
+            },
+            {
+                id: 'abort',
+                label: '여기서 멈춘다 (이 세션은 실패로 종료된다)',
+                nextAction: null,
+            },
+        ],
+        context: {
+            blockedTask: escalation.blockedTask,
+            triedPersonas: escalation.triedPersonas,
+            bestScore: escalation.bestScore,
+            unresolved: escalation.suggestions,
+        },
+        status: 'open',
+        openedAt: new Date().toISOString(),
+    };
+}
+/** 이 선택지로 해소하면 세션이 이어지는가. 아니면 세션을 종료한다 */
+export function gateOptionResumesSession(optionId) {
+    return optionId === 'patch_spec' || optionId === 'manual_task';
+}
 //# sourceMappingURL=lateral.js.map

package/dist/src/resilience/lateral.js.map

@@ -1 +1 @@
-{"version":3,"file":"lateral.js","sourceRoot":"","sources":["../../../src/resilience/lateral.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAE1E,4BAA4B;AAC5B,MAAM,YAAY,GAAyB;IACzC,gBAAgB;IAChB,YAAY;IACZ,aAAa;IACb,YAAY;CACb,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAC5B,OAA0B,EAC1B,aAAmC;IAEnC,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,aAAa,CAAC,CAAC;IAErC,4BAA4B;IAC5B,MAAM,OAAO,GAAG,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAChD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;QACxB,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,iBAAiB;IACjB,KAAK,MAAM,OAAO,IAAI,YAAY,EAAE,CAAC;QACnC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;YACxB,OAAO,OAAO,CAAC;QACjB,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CACjC,OAA2B,EAC3B,OAA0B,EAC1B,IAAU,EACV,gBAAkC,EAClC,gBAAuC,EACvC,aAAqB;IAErB,OAAO;QACL,YAAY,EAAE,sBAAsB,CAAC,OAAO,CAAC;QAC7C,aAAa,EAAE,kBAAkB,CAC/B,OAAO,EACP,OAAO,EACP,IAAI,EACJ,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,CACd;QACD,KAAK,EAAE,UAAU;QACjB,KAAK,EAAE,SAAS;QAChB,OAAO;QACP,OAAO;QACP,aAAa;QACb,cAAc,EAAE,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,eAAe,CAAC;KAC/D,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CACpC,aAAmC,EACnC,gBAAkC,EAClC,gBAAuC,EACvC,WAA+C;IAE/C,MAAM,MAAM,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC;IAC9D,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,YAAY,CAAC;IAE1F,MAAM,cAAc,GAAG,gBAAgB,CAAC,aAAa;SAClD,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;SAC3B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,OAAO,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAExD,MAAM,kBAAkB,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;IAC7C,MAAM,oBAAoB,GAAG;QAC3B,qDAAqD;QACrD,kBAAkB;YAChB,CAAC,CAAC,IAAI,kBAAkB,6DAA6D;YACrF,CAAC,CAAC,uDAAuD;QAC3D,kDAAkD;KACnD,CAAC;IAEF,OAAO;QACL,KAAK,EAAE,UAAU;QACjB,KAAK,EAAE,kBAAkB;QACzB,OAAO,EAAE,OAAO,aAAa,CAAC,MAAM,wHAAwH;QAC5J,aAAa;QACb,SAAS;QACT,oBAAoB,EAAE,gBAAgB;QACtC,WAAW,EAAE;YACX,GAAG,gBAAgB,CAAC,eAAe;YACnC,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,eAAe,EAAE,EAAE,CAAC;SACnD;QACD,WAAW;QACX,oBAAoB;KACrB,CAAC;AACJ,CAAC"}
+{"version":3,"file":"lateral.js","sourceRoot":"","sources":["../../../src/resilience/lateral.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tienne/gestalt",
-  "version": "0.84.2",
+  "version": "0.86.0",
   "description": "TypeScript AI Development Harness - Gestalt psychology-driven requirement clarification",
   "repository": {
     "type": "git",
@@ -28,7 +28,7 @@
   "scripts": {
     "dev": "tsx bin/gestalt.ts",
     "build": "tsc -p tsconfig.build.json",
-    "postbuild": "rm -rf dist/plugin && mkdir -p dist/plugin && cp -r plugin/agents plugin/role-agents plugin/review-agents plugin/personas plugin/skills dist/plugin/ && cp -r schemas dist/ && cp package.json dist/ && chmod +x dist/bin/gestalt.js && pnpm run verify:plugin && pnpm run verify:rules && pnpm run verify:output-style",
+    "postbuild": "rm -rf dist/plugin && mkdir -p dist/plugin && cp -r plugin/agents plugin/role-agents plugin/review-agents plugin/personas plugin/skills dist/plugin/ && cp -r schemas dist/ && cp package.json dist/ && chmod +x dist/bin/gestalt.js && pnpm run verify:plugin && pnpm run verify:rules && pnpm run verify:rule-overlap && pnpm run verify:output-style",
     "verify:plugin": "tsx scripts/verify-plugin-assets.ts",
     "prepublishOnly": "pnpm build",
     "test": "vitest run",
@@ -43,7 +43,8 @@
     "version:sync": "tsx scripts/sync-version.ts",
     "postversion": "pnpm run version:sync && pnpm run build:output-style",
     "verify:rules": "tsx scripts/verify-rule-refs.ts",
-    "gate": "pnpm typecheck && pnpm verify:rules && pnpm lint && pnpm format:check && pnpm build && pnpm test",
+    "verify:rule-overlap": "tsx scripts/verify-rule-overlap.ts",
+    "gate": "pnpm typecheck && pnpm verify:rules && pnpm verify:rule-overlap && pnpm lint && pnpm format:check && pnpm build && pnpm test",
     "humanize:baseline": "tsx scripts/humanize-baseline.ts",
     "build:output-style": "tsx scripts/build-output-style.ts",
     "verify:output-style": "tsx scripts/build-output-style.ts --dry-run"

package/plugin/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "gestalt",
-  "version": "0.84.2",
+  "version": "0.86.0",
   "description": "Gestalt psychology-driven AI development harness. Transforms scattered requirements into structured, validated specifications through interactive interviews.",
   "author": {
     "name": "tienne"

package/plugin/.mcp.json

@@ -2,7 +2,7 @@
   "mcpServers": {
     "gestalt": {
       "command": "npx",
-      "args": ["-y", "@tienne/gestalt@0.84.2", "serve"],
+      "args": ["-y", "@tienne/gestalt@0.86.0", "serve"],
       "startup_timeout_sec": 180,
       "tool_timeout_sec": 900
     }

package/plugin/mcp.json

@@ -2,7 +2,7 @@
   "mcpServers": {
     "gestalt": {
       "command": "npx",
-      "args": ["-y", "@tienne/gestalt@0.84.2", "serve"],
+      "args": ["-y", "@tienne/gestalt@0.86.0", "serve"],
       "startup_timeout_sec": 180,
       "tool_timeout_sec": 900
     }