@tienne/gestalt 0.87.0 → 0.88.0

package/dist/src/mcp/tools/code-graph-passthrough.js

@@ -1,5 +1,73 @@
+import { existsSync } from 'node:fs';
+import { extname } from 'node:path';
+import { fileURLToPath } from 'node:url';
 import { log } from '../../core/log.js';
-import { codeGraphEngine } from '../../code-graph/index.js';
+import { codeGraphEngine, MAX_INLINE_PARSE } from '../../code-graph/index.js';
+import { detachedRefreshSpawner, requestRefresh, } from '../../code-graph/hooks/background.js';
+/** 같은 레포에 재색인 프로세스를 연달아 띄우지 않는 간격. 띄운 쪽이 락을 잡기 전 틈을 메운다 */
+const REINDEX_REQUEST_INTERVAL_MS = 30_000;
+/**
+ * 재색인을 맡길 프로세스. 훅이 백그라운드 갱신에 쓰는 엔트리를 `reindex`로 띄운다.
+ * dist에서는 dist/bin/gestalt-hook.js, tsx로 띄운 개발 서버에서는 bin/gestalt-hook.ts다.
+ */
+function defaultReindexSpawner() {
+    const self = fileURLToPath(import.meta.url);
+    const entry = fileURLToPath(new URL(`../../../bin/gestalt-hook${extname(self)}`, import.meta.url));
+    if (!existsSync(entry))
+        return undefined;
+    return detachedRefreshSpawner(entry, 'reindex', process.execArgv);
+}
+let reindexSpawner = null;
+/** 테스트가 재색인 프로세스 대신 끼워 넣는 자리. undefined를 주면 기본으로 돌아간다 */
+export function setReindexSpawner(spawner) {
+    reindexSpawner = spawner ?? null;
+}
+/**
+ * 질의 전에 그래프를 디스크에 맞춘다. 입력 refresh:false나 GESTALT_NO_REFRESH=1이면 끈다.
+ * 실패해도 질의는 막지 않는다. 이전 그래프로라도 답하는 게 아예 못 답하는 것보다 낫다.
+ *
+ * 다시 파싱할 파일이 MAX_INLINE_PARSE를 넘으면(업그레이드 직후 옛 DB, 큰 브랜치 전환)
+ * 이전 그래프로 바로 답하고 재색인은 다른 프로세스에 넘긴다. 큰 레포에서는 콜드 빌드만큼
+ * 걸려서 그 자리에서 돌리면 질의가 그만큼 멈춘다.
+ */
+async function refreshBeforeQuery(input) {
+    if (input.refresh === false || process.env['GESTALT_NO_REFRESH'] === '1') {
+        return { status: 'skipped', reason: 'disabled', durationMs: 0 };
+    }
+    try {
+        const freshness = await codeGraphEngine.refresh(input.repoRoot, {
+            maxInlineParse: MAX_INLINE_PARSE,
+        });
+        if (freshness.status === 'stale' && freshness.reason === 'reindex_pending') {
+            requestReindex(input.repoRoot);
+        }
+        return freshness;
+    }
+    catch (e) {
+        const message = e instanceof Error ? e.message : String(e);
+        log('code-graph refresh failed:', message);
+        return {
+            status: 'stale',
+            reason: 'refresh_failed',
+            message: `최신화 실패로 이전 그래프 기준 (${message})`,
+            durationMs: 0,
+        };
+    }
+}
+function requestReindex(repoRoot) {
+    try {
+        if (reindexSpawner === null)
+            reindexSpawner = defaultReindexSpawner();
+        if (!reindexSpawner) {
+            log('code-graph reindex skipped: gestalt-hook entry not found');
+            return;
+        }
+        requestRefresh(repoRoot, reindexSpawner, REINDEX_REQUEST_INTERVAL_MS);
+    }
+    catch (e) {
+        log('code-graph reindex request failed:', e instanceof Error ? e.message : String(e));
+    }
+}
 /**
  * 임계 파라미터는 co_change 액션만의 것이 아니다. blast_radius와 diff_radius도
  * 같은 신호를 쓰므로 여기서 갈라놓으면 튜닝이 조회에만 먹는다.
@@ -49,21 +117,23 @@ export async function handleCodeGraphPassthrough(input) {
                 };
             }
             case 'blast_radius': {
+                const freshness = await refreshBeforeQuery(input);
                 const result = codeGraphEngine.blastRadius(repoRoot, {
                     changedFiles: input.changedFiles,
                     base: input.base,
                     maxDepth: input.maxDepth,
                     coChange: coChangeTuning(input),
                 });
-                return result;
+                return { ...result, freshness };
             }
             case 'diff_radius': {
+                const freshness = await refreshBeforeQuery(input);
                 const result = codeGraphEngine.diffRadius(repoRoot, {
                     mode: input.diffMode,
                     maxDepth: input.maxDepth,
                     coChange: coChangeTuning(input),
                 });
-                return result;
+                return { ...result, freshness };
             }
             case 'query': {
                 if (!input.pattern) {
@@ -72,19 +142,38 @@ export async function handleCodeGraphPassthrough(input) {
                 if (!input.target) {
                     return { error: 'target is required for query action' };
                 }
+                const freshness = await refreshBeforeQuery(input);
                 const result = codeGraphEngine.query(repoRoot, input.pattern, input.target);
-                return { nodes: result.nodes, edges: result.edges };
+                return { nodes: result.nodes, edges: result.edges, freshness };
             }
             case 'stats': {
+                const freshness = await refreshBeforeQuery(input);
                 const result = codeGraphEngine.stats(repoRoot);
-                return result;
+                return { ...result, freshness };
             }
             case 'co_change': {
+                const freshness = await refreshBeforeQuery(input);
                 const result = codeGraphEngine.coChange(repoRoot, {
                     target: input.target,
                     ...coChangeTuning(input),
                 });
-                return result;
+                return { ...result, freshness };
+            }
+            case 'skeleton': {
+                if (!input.filePath) {
+                    return { error: 'filePath is required for skeleton action' };
+                }
+                const freshness = await refreshBeforeQuery(input);
+                const result = codeGraphEngine.skeleton(repoRoot, input.filePath);
+                // 서버가 text를 그대로 응답 본문으로 쓴다. 첫 줄이 줄인 크기여야 해서다
+                const stale = freshness.status === 'stale' ? `\n(${freshness.message})` : '';
+                return {
+                    text: result.text.replace('\n', `${stale}\n`),
+                    source: result.source,
+                    originalChars: result.originalChars,
+                    skeletonChars: result.skeletonChars,
+                    freshness,
+                };
             }
             case 'db_exists': {
                 const exists = codeGraphEngine.dbExists(repoRoot);

package/dist/src/mcp/tools/code-graph-passthrough.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tienne/gestalt",
-  "version": "0.87.0",
+  "version": "0.88.0",
   "description": "TypeScript AI Development Harness - Gestalt psychology-driven requirement clarification",
   "repository": {
     "type": "git",
@@ -17,7 +17,8 @@
     "node": ">=22.0.0"
   },
   "bin": {
-    "gestalt": "./dist/bin/gestalt.js"
+    "gestalt": "./dist/bin/gestalt.js",
+    "gestalt-hook": "./dist/bin/gestalt-hook.js"
   },
   "files": [
     "dist",
@@ -28,7 +29,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:rule-overlap && 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 dist/bin/gestalt-hook.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",

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

@@ -1,6 +1,6 @@
 {
   "name": "gestalt",
-  "version": "0.87.0",
+  "version": "0.88.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.87.0", "serve"],
+      "args": ["-y", "@tienne/gestalt@0.88.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.87.0", "serve"],
+      "args": ["-y", "@tienne/gestalt@0.88.0", "serve"],
       "startup_timeout_sec": 180,
       "tool_timeout_sec": 900
     }

package/plugin/skills/blast-radius/SKILL.md

@@ -68,6 +68,7 @@ outputs:
   - coChangeTotalMatched
   - riskScore
   - summary
+  - freshness
 ---
 
 # Blast Radius Skill
@@ -84,6 +85,8 @@ outputs:
 /build-graph
 ```
 
+한 번 빌드해두면 그 뒤는 손대지 않아도 됩니다. 질의하기 전에 그래프를 작업 트리에 맞추므로 커밋 안 한 변경까지 반영된 그래프로 답합니다. 그래프 DB가 아예 없으면 자동으로 만들지 않으니 그때만 `/build-graph`를 돌립니다.
+
 ## 실행 방법
 
 ### 기본 (마지막 커밋 변경 파일 자동 감지)
@@ -131,6 +134,7 @@ ges_code_graph {
 | `depthExhausted` | `maxDepth`에 걸려 탐색이 멈췄고 갈 곳이 남아 있었다 |
 | `unexploredNodes` | 그때 다음 홉에서 기다리던 노드 수 |
 | `summary` | 한 줄 요약 |
+| `freshness` | 질의 전 최신화 결과. `status`가 `fresh`(바뀐 것 없음), `refreshed`(반영하고 답함), `stale`(이전 그래프로 답함), `skipped`(DB가 없거나 최신화를 끔) 중 하나 |
 
 ### `rankedFiles`의 출처 표시
 
@@ -184,6 +188,13 @@ ges_code_graph {
    레포 최상위에서 /build-graph를 다시 돌리면 함께 바뀐 파일까지 잡습니다.
 ```
 
+`freshness.status`가 `stale`이면 결과 표시 위에 안내를 붙입니다. 결과는 나오지만 최근에 고친 파일이 빠져 있을 수 있습니다.
+
+```
+⚠️ 이전 그래프 기준으로 본 결과입니다 ({freshness.message}).
+   최근에 고친 파일은 빠져 있을 수 있습니다. 잠시 뒤 다시 부르면 그때 다시 맞춥니다.
+```
+
 `depthExhausted: true`면 위 표시 바로 아래에 한 줄을 덧붙입니다. 빠뜨리지 않습니다.
 
 ```
@@ -225,4 +236,3 @@ ges_code_graph {
    ```
 
    돌아온 순서대로 사용자에게 제시합니다. 스폰이 그 별칭을 거부하면 `sonnet`으로 1회 재시도합니다. 그것도 안 되면 기존 방식(테스트 파일 우선)으로 진행합니다. 폴백 절차는 [`../_shared/agent-model.md`](../_shared/agent-model.md)와 같습니다.
-6. 빌드된 그래프가 오래된 경우 `/build-graph --incremental` 실행을 권장합니다.

package/plugin/skills/diff-radius/SKILL.md

@@ -54,6 +54,7 @@ outputs:
   - coChangeTotalMatched
   - riskScore
   - summary
+  - freshness
 ---
 
 # Diff Radius Skill
@@ -70,6 +71,8 @@ outputs:
 /build-graph
 ```
 
+한 번 빌드해두면 그 뒤는 손대지 않아도 됩니다. 질의하기 전에 그래프를 작업 트리에 맞추므로 커밋 안 한 변경까지 반영된 그래프로 답합니다. 그래프 DB가 아예 없으면 자동으로 만들지 않으니 그때만 `/build-graph`를 돌립니다.
+
 ## 실행 방법
 
 ### 기본 (staged + unstaged 전체)
@@ -123,6 +126,7 @@ ges_code_graph {
 | `coChangeTotalMatched` | 임계를 통과한 이력 이웃 수. `coChangeMatchedCapped`가 꺼져 있으면 하한이 아니라 정확한 수다 |
 | `riskScore` | 위험도 점수 0~1 |
 | `summary` | 한 줄 요약 |
+| `freshness` | 질의 전 최신화 결과. `status`가 `fresh`(바뀐 것 없음), `refreshed`(반영하고 답함), `stale`(이전 그래프로 답함), `skipped`(DB가 없거나 최신화를 끔) 중 하나 |
 
 `rankedFiles` 각 항목의 `origin`은 `both`(import와 이력 양쪽), `history`(이력 전용), `import`(import 전용) 셋이다. `history`는 매니페스트끼리의 약속이나 코드와 그 문서처럼 서로 import하지 않아 파싱으로는 영영 안 잡히는 관계다. 커밋 직전에 "이것도 같이 고쳐야 하지 않나"를 잡아주는 자리라 이 스킬에서 특히 쓸모가 있다.
 
@@ -162,6 +166,13 @@ ges_code_graph {
    레포 최상위에서 /build-graph를 다시 돌리면 함께 바뀐 파일까지 잡습니다.
 ```
 
+`freshness.status`가 `stale`이면 결과 표시 위에 안내를 붙입니다. 결과는 나오지만 최근에 고친 파일이 빠져 있을 수 있습니다.
+
+```
+⚠️ 이전 그래프 기준으로 본 결과입니다 ({freshness.message}).
+   최근에 고친 파일은 빠져 있을 수 있습니다. 잠시 뒤 다시 부르면 그때 다시 맞춥니다.
+```
+
 `depthExhausted: true`면 위 표시 바로 아래에 한 줄을 덧붙입니다. 빠뜨리지 않습니다.
 
 ```

package/schemas/gestalt.schema.json

@@ -148,6 +148,25 @@
       "description": "Enable OS desktop notifications for pipeline events (env: GESTALT_NOTIFICATIONS)",
       "default": false
     },
+    "codeGraph": {
+      "type": "object",
+      "description": "Code knowledge graph settings",
+      "properties": {
+        "hooks": {
+          "type": "object",
+          "description": "Claude Code plugin hooks that inject code graph pointers into the session. Claude Code only",
+          "properties": {
+            "enabled": {
+              "type": "boolean",
+              "description": "Inject a repo map at session start, related file pointers per prompt, and impact plus co-change after edits. Off by default because plugin hooks run in every repo (env: GESTALT_CODE_GRAPH_HOOKS=1|0)",
+              "default": false
+            }
+          },
+          "additionalProperties": false
+        }
+      },
+      "additionalProperties": false
+    },
     "logLevel": {
       "type": "string",
       "enum": ["debug", "info", "warn", "error"],