@tienne/gestalt 0.87.0 → 0.89.0

package/dist/src/code-graph/hooks/state.d.ts

@@ -0,0 +1,20 @@
+/** 세션마다 기억하는 포인터 수. 넘으면 오래된 것부터 잊는다 */
+export declare const MAX_REMEMBERED = 40;
+export interface SessionState {
+    /** UserPromptSubmit에서 넣은 포인터. 키는 `상대경로#심볼이름` */
+    pointers: string[];
+    /** PostToolUse에서 영향 범위를 넣은 파일 */
+    impacts: string[];
+}
+export declare function hooksDir(repoRoot: string): string;
+export declare function readSessionState(repoRoot: string, sessionId: string): SessionState;
+/** 새 키를 뒤에 붙이고 MAX_REMEMBERED만 남긴다 */
+export declare function remember(list: string[], keys: string[]): string[];
+/**
+ * 임시 파일에 쓰고 rename한다. 같은 세션의 훅 둘이 겹쳐 돌아도 반쯤 쓴 JSON을
+ * 읽지 않게 하려는 것이다. 겹친 쪽 하나의 기록이 사라질 수는 있는데, 그러면 포인터가
+ * 한 번 더 들어갈 뿐이라 락까지는 안 잡는다.
+ */
+export declare function writeSessionState(repoRoot: string, sessionId: string, state: SessionState): void;
+export declare function pruneSessionStates(repoRoot: string, now?: number): void;
+//# sourceMappingURL=state.d.ts.map

package/dist/src/code-graph/hooks/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../../src/code-graph/hooks/state.ts"],"names":[],"mappings":"AAWA,uCAAuC;AACvC,eAAO,MAAM,cAAc,KAAK,CAAC;AAKjC,MAAM,WAAW,YAAY;IAC3B,gDAAgD;IAChD,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,iCAAiC;IACjC,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEjD;AAiBD,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,YAAY,CAWlF;AAED,sCAAsC;AACtC,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAGjE;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,IAAI,CAOhG;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,SAAa,GAAG,IAAI,CAe3E"}

package/dist/src/code-graph/hooks/state.js

@@ -0,0 +1,73 @@
+import { mkdirSync, readFileSync, readdirSync, renameSync, statSync, unlinkSync, writeFileSync, } from 'node:fs';
+import { join } from 'node:path';
+/** 세션마다 기억하는 포인터 수. 넘으면 오래된 것부터 잊는다 */
+export const MAX_REMEMBERED = 40;
+/** 이보다 오래 안 쓰인 세션 상태 파일은 SessionStart 때 지운다 */
+const SESSION_STATE_TTL_MS = 7 * 24 * 60 * 60 * 1000;
+export function hooksDir(repoRoot) {
+    return join(repoRoot, '.gestalt', 'hooks');
+}
+function sessionsDir(repoRoot) {
+    return join(hooksDir(repoRoot), 'sessions');
+}
+/** session_id는 밖에서 들어온 값이라 파일 이름에 쓸 수 있는 글자만 남긴다 */
+function sessionFile(repoRoot, sessionId) {
+    const safe = sessionId.replace(/[^A-Za-z0-9_-]/g, '').slice(0, 128);
+    if (!safe)
+        return null;
+    return join(sessionsDir(repoRoot), `${safe}.json`);
+}
+function asStrings(v) {
+    return Array.isArray(v) ? v.filter((x) => typeof x === 'string') : [];
+}
+export function readSessionState(repoRoot, sessionId) {
+    const file = sessionFile(repoRoot, sessionId);
+    if (!file)
+        return { pointers: [], impacts: [] };
+    try {
+        const raw = JSON.parse(readFileSync(file, 'utf-8'));
+        return { pointers: asStrings(raw.pointers), impacts: asStrings(raw.impacts) };
+    }
+    catch {
+        return { pointers: [], impacts: [] };
+    }
+}
+/** 새 키를 뒤에 붙이고 MAX_REMEMBERED만 남긴다 */
+export function remember(list, keys) {
+    const merged = [...list.filter((k) => !keys.includes(k)), ...keys];
+    return merged.slice(-MAX_REMEMBERED);
+}
+/**
+ * 임시 파일에 쓰고 rename한다. 같은 세션의 훅 둘이 겹쳐 돌아도 반쯤 쓴 JSON을
+ * 읽지 않게 하려는 것이다. 겹친 쪽 하나의 기록이 사라질 수는 있는데, 그러면 포인터가
+ * 한 번 더 들어갈 뿐이라 락까지는 안 잡는다.
+ */
+export function writeSessionState(repoRoot, sessionId, state) {
+    const file = sessionFile(repoRoot, sessionId);
+    if (!file)
+        return;
+    mkdirSync(sessionsDir(repoRoot), { recursive: true });
+    const tmp = `${file}.${process.pid}.tmp`;
+    writeFileSync(tmp, JSON.stringify(state));
+    renameSync(tmp, file);
+}
+export function pruneSessionStates(repoRoot, now = Date.now()) {
+    let entries;
+    try {
+        entries = readdirSync(sessionsDir(repoRoot));
+    }
+    catch {
+        return;
+    }
+    for (const name of entries) {
+        const path = join(sessionsDir(repoRoot), name);
+        try {
+            if (now - statSync(path).mtimeMs > SESSION_STATE_TTL_MS)
+                unlinkSync(path);
+        }
+        catch {
+            // 다른 세션이 먼저 지웠다
+        }
+    }
+}
+//# sourceMappingURL=state.js.map

package/dist/src/code-graph/hooks/state.js.map

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

package/dist/src/code-graph/index.d.ts

@@ -1,10 +1,14 @@
-export { CodeGraphEngine, codeGraphEngine } from './engine.js';
+export { CodeGraphEngine, codeGraphEngine, MAX_INLINE_PARSE } from './engine.js';
 export { CodeGraphStore, MAX_MATCHED_ROWS } from './storage.js';
 export type { CoChangeScan, CoChangeNeighborRow, CoChangePairRow } from './storage.js';
 export { computeBlastRadius } from './blast-radius.js';
 export { syncCoChange, queryCoChange, buildCoChangeLookup, parseGitLog, countPairs, scoreNeighbor, MAX_FILES_PER_COMMIT, MIN_FILES_PER_COMMIT, MIN_PAIR_COUNT, DEFAULT_MIN_CONFIDENCE, DEFAULT_NEIGHBOR_LIMIT, DEFAULT_PAIR_LIMIT, CONFIDENCE_DECIMALS, LIFT_DECIMALS, } from './cochange.js';
 export type { CoChangeQueryOptions, CoChangeSyncOptions, CommitRecord } from './cochange.js';
 export { getPluginForFile, pluginRegistry } from './plugins/index.js';
-export type { CodeGraphNode, CodeGraphEdge, BlastRadiusResult, BlastRadiusNode, BlastRadiusOptions, BuildOptions, BuildResult, QueryPattern, QueryResult, CodeGraphStats, AnalyzerPlugin, ParseResult, ImpactOrigin, RankedImpactFile, CoChangeNeighbor, CoChangePair, CoChangeResult, CoChangeLookup, CoChangeBuildSummary, CoChangeMeta, CoChangeTuning, } from './types.js';
+export type { CodeGraphNode, CodeGraphEdge, BlastRadiusResult, BlastRadiusNode, BlastRadiusOptions, BuildOptions, BuildResult, QueryPattern, QueryResult, CodeGraphStats, AnalyzerPlugin, ParseResult, ImpactOrigin, RankedImpactFile, CoChangeNeighbor, CoChangePair, CoChangeResult, CoChangeLookup, CoChangeBuildSummary, CoChangeMeta, CoChangeTuning, FreshnessCounts, FreshnessReport, RefreshOptions, SkeletonEntry, SkeletonResult, } from './types.js';
+export { detectDrift, RACY_WINDOW_MS } from './freshness.js';
+export type { DriftReport, FileStamp } from './freshness.js';
+export { acquireLock, tryAcquireLock, LOCK_STALE_MS } from './lock.js';
+export type { LockHandle, LockOptions } from './lock.js';
 export { NodeKind, EdgeKind } from './types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/src/code-graph/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/code-graph/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChE,YAAY,EAAE,YAAY,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACvF,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EACL,YAAY,EACZ,aAAa,EACb,mBAAmB,EACnB,WAAW,EACX,UAAU,EACV,aAAa,EACb,oBAAoB,EACpB,oBAAoB,EACpB,cAAc,EACd,sBAAsB,EACtB,sBAAsB,EACtB,kBAAkB,EAClB,mBAAmB,EACnB,aAAa,GACd,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7F,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACtE,YAAY,EACV,aAAa,EACb,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,WAAW,EACX,cAAc,EACd,cAAc,EACd,WAAW,EACX,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,cAAc,EACd,oBAAoB,EACpB,YAAY,EACZ,cAAc,GACf,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/code-graph/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACjF,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChE,YAAY,EAAE,YAAY,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACvF,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EACL,YAAY,EACZ,aAAa,EACb,mBAAmB,EACnB,WAAW,EACX,UAAU,EACV,aAAa,EACb,oBAAoB,EACpB,oBAAoB,EACpB,cAAc,EACd,sBAAsB,EACtB,sBAAsB,EACtB,kBAAkB,EAClB,mBAAmB,EACnB,aAAa,GACd,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7F,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACtE,YAAY,EACV,aAAa,EACb,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,WAAW,EACX,cAAc,EACd,cAAc,EACd,WAAW,EACX,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,cAAc,EACd,oBAAoB,EACpB,YAAY,EACZ,cAAc,EACd,eAAe,EACf,eAAe,EACf,cAAc,EACd,aAAa,EACb,cAAc,GACf,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAC7D,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AACvE,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC"}

package/dist/src/code-graph/index.js

@@ -1,7 +1,9 @@
-export { CodeGraphEngine, codeGraphEngine } from './engine.js';
+export { CodeGraphEngine, codeGraphEngine, MAX_INLINE_PARSE } from './engine.js';
 export { CodeGraphStore, MAX_MATCHED_ROWS } from './storage.js';
 export { computeBlastRadius } from './blast-radius.js';
 export { syncCoChange, queryCoChange, buildCoChangeLookup, parseGitLog, countPairs, scoreNeighbor, MAX_FILES_PER_COMMIT, MIN_FILES_PER_COMMIT, MIN_PAIR_COUNT, DEFAULT_MIN_CONFIDENCE, DEFAULT_NEIGHBOR_LIMIT, DEFAULT_PAIR_LIMIT, CONFIDENCE_DECIMALS, LIFT_DECIMALS, } from './cochange.js';
 export { getPluginForFile, pluginRegistry } from './plugins/index.js';
+export { detectDrift, RACY_WINDOW_MS } from './freshness.js';
+export { acquireLock, tryAcquireLock, LOCK_STALE_MS } from './lock.js';
 export { NodeKind, EdgeKind } from './types.js';
 //# sourceMappingURL=index.js.map

package/dist/src/code-graph/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/code-graph/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhE,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EACL,YAAY,EACZ,aAAa,EACb,mBAAmB,EACnB,WAAW,EACX,UAAU,EACV,aAAa,EACb,oBAAoB,EACpB,oBAAoB,EACpB,cAAc,EACd,sBAAsB,EACtB,sBAAsB,EACtB,kBAAkB,EAClB,mBAAmB,EACnB,aAAa,GACd,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAwBtE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/code-graph/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACjF,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhE,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EACL,YAAY,EACZ,aAAa,EACb,mBAAmB,EACnB,WAAW,EACX,UAAU,EACV,aAAa,EACb,oBAAoB,EACpB,oBAAoB,EACpB,cAAc,EACd,sBAAsB,EACtB,sBAAsB,EACtB,kBAAkB,EAClB,mBAAmB,EACnB,aAAa,GACd,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AA6BtE,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAE7D,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAEvE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC"}

package/dist/src/code-graph/ko-text.d.ts

@@ -0,0 +1,39 @@
+/**
+ * 한국어 텍스트를 색인 단어로 쪼갠다. 사전을 쓰지 않는다.
+ *
+ * 어절 끝의 흔한 조사와 어미를 짧은 목록으로 떼고 남은 줄기를 음절 bigram으로 쪼갠다.
+ * "인터뷰 점수가" → 인터, 터뷰 / 점수. 형태소 분석기가 없어도 같은 낱말은 같은 bigram을
+ * 내서 색인 쪽과 프롬프트 쪽이 만난다.
+ *
+ * 빌드(주석, 커밋 메시지 색인)와 훅(프롬프트)이 이 모듈 하나를 같이 쓴다. 훅의 기동 경로에
+ * 들어가므로 의존성을 두지 않는다.
+ */
+/** 주석 하나에서 색인에 넣는 최대 글자 수. 긴 설명 주석 하나가 파일의 단어를 다 차지하지 않게 */
+export declare const MAX_DOC_CHARS = 400;
+export declare function hasHangul(text: string): boolean;
+export declare function stripSuffix(eojeol: string): string;
+/** 줄기를 bigram으로. 1음절이면 그 음절 하나 */
+export declare function bigrams(stem: string): string[];
+export interface KoEojeol {
+    /** 조사와 어미를 뗀 줄기 */
+    stem: string;
+    /**
+     * 프롬프트에 적힌 그대로의 어절. 주입 문구에 "어떤 단어로 걸렸는지"를 보여줄 때 쓴다.
+     * 사전이 없어서 "해상도"도 조사 "도"로 보고 "해상"까지 자른다. 색인 쪽도 똑같이 잘라서
+     * 매칭은 맞지만 줄기를 그대로 보여주면 낯선 말이 된다
+     */
+    surface: string;
+    terms: string[];
+}
+/** 프롬프트용. 어절마다 줄기와 bigram을 따로 들고 간다. 게이트가 어절 수를 세야 해서다 */
+export declare function koreanEojeols(text: string): KoEojeol[];
+/** 색인용. 텍스트 하나에서 나온 bigram 집합 */
+export declare function koreanTerms(text: string): string[];
+/**
+ * `CT-31408`, `BIZRES-12636` 꼴. Jira 프로젝트 키처럼 접두어는 두 글자 이상이어야 한다.
+ * 한 글자를 받으면 `I-7`, `C-11` 같은 규칙 번호까지 티켓으로 잡힌다
+ */
+export declare function extractTickets(text: string): string[];
+/** 주석 원문을 색인할 텍스트로 줄인다. 한글이 없으면 undefined */
+export declare function docText(raw: string): string | undefined;
+//# sourceMappingURL=ko-text.d.ts.map

package/dist/src/code-graph/ko-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ko-text.d.ts","sourceRoot":"","sources":["../../../src/code-graph/ko-text.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,4DAA4D;AAC5D,eAAO,MAAM,aAAa,MAAM,CAAC;AA4IjC,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE/C;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAKlD;AAED,kCAAkC;AAClC,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAK9C;AAED,MAAM,WAAW,QAAQ;IACvB,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,0DAA0D;AAC1D,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,EAAE,CAatD;AAED,iCAAiC;AACjC,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAIlD;AAOD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAOrD;AAED,6CAA6C;AAC7C,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAQvD"}

package/dist/src/code-graph/ko-text.js

@@ -0,0 +1,223 @@
+/**
+ * 한국어 텍스트를 색인 단어로 쪼갠다. 사전을 쓰지 않는다.
+ *
+ * 어절 끝의 흔한 조사와 어미를 짧은 목록으로 떼고 남은 줄기를 음절 bigram으로 쪼갠다.
+ * "인터뷰 점수가" → 인터, 터뷰 / 점수. 형태소 분석기가 없어도 같은 낱말은 같은 bigram을
+ * 내서 색인 쪽과 프롬프트 쪽이 만난다.
+ *
+ * 빌드(주석, 커밋 메시지 색인)와 훅(프롬프트)이 이 모듈 하나를 같이 쓴다. 훅의 기동 경로에
+ * 들어가므로 의존성을 두지 않는다.
+ */
+const HANGUL_RUN = /[가-힣]+/g;
+const HANGUL = /[가-힣]/;
+/** 주석 하나에서 색인에 넣는 최대 글자 수. 긴 설명 주석 하나가 파일의 단어를 다 차지하지 않게 */
+export const MAX_DOC_CHARS = 400;
+/**
+ * 뗄 꼬리. 긴 것부터 맞춰본다 — "에서"를 "서"보다 먼저 봐야 한다.
+ * 떼고 남은 줄기가 2음절 미만이면 안 뗀다. "아이"에서 "이"를 떼면 다른 낱말이 된다.
+ */
+const SUFFIXES = [
+    '했는데요',
+    '했는데',
+    '하는데',
+    '해주세요',
+    '했어요',
+    '해줘요',
+    '인데요',
+    '거든요',
+    '에서는',
+    '으로는',
+    '이라서',
+    '라서',
+    '해줘',
+    '했어',
+    '했다',
+    '하고',
+    '하는',
+    '하면',
+    '해서',
+    '하게',
+    '해요',
+    '인데',
+    '는데',
+    '에서',
+    '으로',
+    '에게',
+    '한테',
+    '까지',
+    '부터',
+    '처럼',
+    '보다',
+    '이랑',
+    '이나',
+    '이고',
+    '이면',
+    '이다',
+    '입니다',
+    '합니다',
+    '됩니다',
+    '되는',
+    '되고',
+    '된다',
+    '돼요',
+    '안돼',
+    '은',
+    '는',
+    '이',
+    '가',
+    '을',
+    '를',
+    '에',
+    '로',
+    '의',
+    '도',
+    '만',
+    '와',
+    '과',
+    '랑',
+    '요',
+].sort((a, b) => b.length - a.length);
+const SUFFIX_SET = new Set(SUFFIXES);
+/**
+ * 어디에나 끼는 낱말. 대부분은 IDF가 눌러주지만 프롬프트에 너무 자주 나와서
+ * 게이트의 "어절 둘 이상" 조건을 혼자 채워버리는 것만 뺀다.
+ */
+const KO_STOPWORDS = new Set([
+    '코드',
+    '파일',
+    '수정',
+    '확인',
+    '작업',
+    '이거',
+    '그거',
+    '저거',
+    '여기',
+    '거기',
+    '지금',
+    '이번',
+    '다시',
+    '그냥',
+    '혹시',
+    '어디',
+    '어떻게',
+    '부분',
+    '내용',
+    '관련',
+    '사용',
+    '추가',
+    '처리',
+    '문제',
+    '기능',
+    '정리',
+    '진행',
+    '같아',
+    '같은',
+    '있는',
+    '없는',
+    '있어',
+    '없어',
+    '그리고',
+    '근데',
+    '그래서',
+    '이제',
+    '먼저',
+    '해줘',
+    '봐줘',
+    '알려줘',
+    // 1음절 어절은 bigram 없이 그대로 색인되니 기능어가 그대로 맞는다
+    '것',
+    '거',
+    '수',
+    '좀',
+    '뭐',
+    '왜',
+    '안',
+    '잘',
+    '더',
+    '다',
+    '또',
+    '할',
+    '한',
+    '될',
+    '된',
+    '해',
+    '해야',
+    '하기',
+    '하면',
+    '있다',
+    '없다',
+    '같다',
+]);
+export function hasHangul(text) {
+    return HANGUL.test(text);
+}
+export function stripSuffix(eojeol) {
+    for (const s of SUFFIXES) {
+        if (eojeol.length - s.length >= 2 && eojeol.endsWith(s))
+            return eojeol.slice(0, -s.length);
+    }
+    return eojeol;
+}
+/** 줄기를 bigram으로. 1음절이면 그 음절 하나 */
+export function bigrams(stem) {
+    if (stem.length <= 1)
+        return stem ? [stem] : [];
+    const out = [];
+    for (let i = 0; i < stem.length - 1; i++)
+        out.push(stem.slice(i, i + 2));
+    return out;
+}
+/** 프롬프트용. 어절마다 줄기와 bigram을 따로 들고 간다. 게이트가 어절 수를 세야 해서다 */
+export function koreanEojeols(text) {
+    const out = [];
+    const seen = new Set();
+    for (const m of text.matchAll(HANGUL_RUN)) {
+        // "calculateTotal에서", "rules가"처럼 영문에 바로 붙은 조사는 낱말이 아니다
+        const prev = text[m.index - 1];
+        if (prev && /[A-Za-z0-9_)\]`'"]/.test(prev) && SUFFIX_SET.has(m[0]))
+            continue;
+        const stem = stripSuffix(m[0]);
+        if (KO_STOPWORDS.has(stem) || KO_STOPWORDS.has(m[0]) || seen.has(stem))
+            continue;
+        seen.add(stem);
+        out.push({ stem, surface: m[0], terms: [...new Set(bigrams(stem))] });
+    }
+    return out;
+}
+/** 색인용. 텍스트 하나에서 나온 bigram 집합 */
+export function koreanTerms(text) {
+    const terms = new Set();
+    for (const e of koreanEojeols(text))
+        for (const t of e.terms)
+            terms.add(t);
+    return [...terms];
+}
+/**
+ * 티켓 키로 보지 않는 접두어. `UTF-8`, `SHA-256`처럼 대문자-숫자 꼴인 표준 이름이다.
+ */
+const NOT_TICKETS = new Set(['UTF', 'SHA', 'ISO', 'ES', 'MD', 'RFC', 'HTTP', 'TLS', 'AES', 'RSA']);
+/**
+ * `CT-31408`, `BIZRES-12636` 꼴. Jira 프로젝트 키처럼 접두어는 두 글자 이상이어야 한다.
+ * 한 글자를 받으면 `I-7`, `C-11` 같은 규칙 번호까지 티켓으로 잡힌다
+ */
+export function extractTickets(text) {
+    const out = new Set();
+    for (const m of text.matchAll(/(?<![A-Za-z0-9])([A-Z][A-Z0-9]{1,15})-(\d{1,7})(?![0-9])/g)) {
+        if (NOT_TICKETS.has(m[1]))
+            continue;
+        out.add(`${m[1]}-${m[2]}`);
+    }
+    return [...out];
+}
+/** 주석 원문을 색인할 텍스트로 줄인다. 한글이 없으면 undefined */
+export function docText(raw) {
+    const text = raw
+        .replace(/^\s*\/\*\*?|\*\/\s*$/g, '')
+        .replace(/^\s*(\*|\/\/+)\s?/gm, '')
+        .replace(/\s+/g, ' ')
+        .trim();
+    if (!hasHangul(text))
+        return undefined;
+    return text.slice(0, MAX_DOC_CHARS);
+}
+//# sourceMappingURL=ko-text.js.map

package/dist/src/code-graph/ko-text.js.map

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

package/dist/src/code-graph/lock.d.ts

@@ -0,0 +1,30 @@
+/**
+ * 주인이 살아 있어도 이보다 오래 잡힌 락은 버려진 것으로 본다.
+ * pid 재사용으로 죽은 주인이 살아 있는 것처럼 보이는 경우를 막는 상한이라
+ * 정상 빌드가 절대 안 닿을 만큼 넉넉하게 잡았다.
+ */
+export declare const LOCK_STALE_MS: number;
+export interface LockHandle {
+    readonly path: string;
+    readonly token: string;
+    /** 락 파일이 아직 내 것일 때만 지운다. 지웠으면 true */
+    release(): boolean;
+}
+export interface LockOptions {
+    staleMs?: number;
+    /** 테스트용. 기본은 process.pid */
+    pid?: number;
+}
+/**
+ * 락 파일을 배타적으로 만든다. 못 잡으면 null.
+ *
+ * 버려진 락은 지우고 한 번 더 시도한다. 지우기 직전에 토큰을 다시 읽어
+ * 판정 사이에 다른 프로세스가 새로 잡은 락을 지우지 않게 한다.
+ */
+export declare function tryAcquireLock(path: string, opts?: LockOptions): LockHandle | null;
+/** timeoutMs 동안 pollMs 간격으로 다시 시도한다. 끝내 못 잡으면 null */
+export declare function acquireLock(path: string, opts?: LockOptions & {
+    timeoutMs?: number;
+    pollMs?: number;
+}): Promise<LockHandle | null>;
+//# sourceMappingURL=lock.d.ts.map

package/dist/src/code-graph/lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock.d.ts","sourceRoot":"","sources":["../../../src/code-graph/lock.ts"],"names":[],"mappings":"AAKA;;;;GAIG;AACH,eAAO,MAAM,aAAa,QAAiB,CAAC;AAe5C,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,sCAAsC;IACtC,OAAO,IAAI,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4BAA4B;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAsCD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,WAAgB,GAAG,UAAU,GAAG,IAAI,CAkCtF;AA4BD,sDAAsD;AACtD,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,WAAW,GAAG;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,GAC/D,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAU5B"}

package/dist/src/code-graph/lock.js

@@ -0,0 +1,140 @@
+import { closeSync, openSync, readFileSync, statSync, unlinkSync, writeSync } from 'node:fs';
+import { randomUUID } from 'node:crypto';
+import { setTimeout as sleep } from 'node:timers/promises';
+import { logger } from '../core/logger.js';
+/**
+ * 주인이 살아 있어도 이보다 오래 잡힌 락은 버려진 것으로 본다.
+ * pid 재사용으로 죽은 주인이 살아 있는 것처럼 보이는 경우를 막는 상한이라
+ * 정상 빌드가 절대 안 닿을 만큼 넉넉하게 잡았다.
+ */
+export const LOCK_STALE_MS = 10 * 60 * 1000;
+/**
+ * 내용을 못 읽는 락을 버려진 것으로 보기까지 기다리는 시간.
+ * `wx`로 만든 직후 내용을 쓰기 전에 다른 프로세스가 읽으면 빈 파일이 보인다.
+ * 그걸 바로 버려진 락으로 보면 막 잡힌 남의 락을 지운다.
+ */
+const UNREADABLE_GRACE_MS = 5000;
+function readLock(path) {
+    try {
+        const parsed = JSON.parse(readFileSync(path, 'utf-8'));
+        if (typeof parsed.pid !== 'number' || typeof parsed.token !== 'string')
+            return null;
+        return {
+            pid: parsed.pid,
+            token: parsed.token,
+            acquiredAt: typeof parsed.acquiredAt === 'number' ? parsed.acquiredAt : 0,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+function isAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (e) {
+        // EPERM은 프로세스가 있는데 신호 권한만 없는 경우다
+        return e.code === 'EPERM';
+    }
+}
+function isStale(path, content, staleMs) {
+    if (!content) {
+        try {
+            return Date.now() - statSync(path).mtimeMs > UNREADABLE_GRACE_MS;
+        }
+        catch {
+            return true;
+        }
+    }
+    if (!isAlive(content.pid))
+        return true;
+    return Date.now() - content.acquiredAt > staleMs;
+}
+/**
+ * 락 파일을 배타적으로 만든다. 못 잡으면 null.
+ *
+ * 버려진 락은 지우고 한 번 더 시도한다. 지우기 직전에 토큰을 다시 읽어
+ * 판정 사이에 다른 프로세스가 새로 잡은 락을 지우지 않게 한다.
+ */
+export function tryAcquireLock(path, opts = {}) {
+    const staleMs = opts.staleMs ?? LOCK_STALE_MS;
+    const pid = opts.pid ?? process.pid;
+    for (let attempt = 0; attempt < 2; attempt++) {
+        const token = randomUUID();
+        try {
+            const fd = openSync(path, 'wx');
+            try {
+                writeSync(fd, JSON.stringify({ pid, token, acquiredAt: Date.now() }));
+            }
+            finally {
+                closeSync(fd);
+            }
+            return makeHandle(path, pid, token);
+        }
+        catch (e) {
+            if (e.code !== 'EEXIST')
+                throw e;
+        }
+        const held = readLock(path);
+        if (!isStale(path, held, staleMs))
+            return null;
+        const recheck = readLock(path);
+        if (held && recheck?.token !== held.token)
+            return null;
+        try {
+            unlinkSync(path);
+            logger.warn('code_graph.lock_stale_removed', {
+                module: 'code-graph/lock',
+                path,
+                previousPid: held?.pid,
+            });
+        }
+        catch {
+            // 다른 프로세스가 먼저 지웠다. 다시 만들기를 시도한다
+        }
+    }
+    return null;
+}
+function makeHandle(path, pid, token) {
+    return {
+        path,
+        token,
+        release() {
+            // 오래 걸려 stale로 판정되면 락이 다른 프로세스로 넘어갔을 수 있다.
+            // 그때 지우면 지금 주인의 락을 빼앗는 셈이라 확인 없이 지우지 않는다
+            const current = readLock(path);
+            if (!current || current.pid !== pid || current.token !== token) {
+                logger.warn('code_graph.lock_not_owned_on_release', {
+                    module: 'code-graph/lock',
+                    path,
+                    ownerPid: current?.pid,
+                });
+                return false;
+            }
+            try {
+                unlinkSync(path);
+                return true;
+            }
+            catch {
+                return false;
+            }
+        },
+    };
+}
+/** timeoutMs 동안 pollMs 간격으로 다시 시도한다. 끝내 못 잡으면 null */
+export async function acquireLock(path, opts = {}) {
+    const timeoutMs = opts.timeoutMs ?? 1500;
+    const pollMs = opts.pollMs ?? 50;
+    const deadline = Date.now() + timeoutMs;
+    for (;;) {
+        const handle = tryAcquireLock(path, opts);
+        if (handle)
+            return handle;
+        if (Date.now() >= deadline)
+            return null;
+        await sleep(Math.min(pollMs, Math.max(0, deadline - Date.now())));
+    }
+}
+//# sourceMappingURL=lock.js.map

package/dist/src/code-graph/lock.js.map

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

package/dist/src/code-graph/plugins/typescript-skeleton.d.ts

@@ -0,0 +1,7 @@
+import type { SkeletonEntry } from '../types.js';
+/**
+ * TS/JS 파일에서 본문을 뺀 시그니처를 뽑는다.
+ * 최상위 선언과 클래스, 인터페이스, enum, namespace 멤버를 담고 import는 뺀다.
+ */
+export declare function extractTypeScriptSkeleton(filePath: string, content: string): SkeletonEntry[];
+//# sourceMappingURL=typescript-skeleton.d.ts.map

package/dist/src/code-graph/plugins/typescript-skeleton.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typescript-skeleton.d.ts","sourceRoot":"","sources":["../../../../src/code-graph/plugins/typescript-skeleton.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAcjD;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,aAAa,EAAE,CAgJ5F"}