@yohakuforce/core 0.4.0

package/dist/util/build-lock.d.ts

@@ -0,0 +1,35 @@
+/**
+ * 並行 graph build の競合を防ぐ簡易ロック。
+ *
+ * - `lockPath` (例: `.yohaku/build.lock`) が存在すれば、誰かが実行中。
+ *   後続は `dirtyPath` (例: `.yohaku/build.dirty`) を touch して即終了する。
+ * - 実行中プロセスは終了時にロックを解除し、dirty があれば 1 回だけ再実行する責任を持つ。
+ *
+ * SQLite WAL とプロセス間並行書き込みの組み合わせは壊れやすいので、
+ * 「並行は絶対避ける、最後の編集だけは確実に反映」という戦略を取る。
+ */
+export interface BuildLockPaths {
+    readonly lockPath: string;
+    readonly dirtyPath: string;
+}
+export interface AcquireResult {
+    readonly acquired: boolean;
+    /** acquired=false の理由 ("locked") をログに出すための情報 */
+    readonly heldBy?: string;
+}
+/**
+ * ロックを取得試行する。取得できなければ dirty flag を立てて false を返す。
+ */
+export declare function tryAcquireBuildLock(paths: BuildLockPaths): AcquireResult;
+/**
+ * ロックを解除し、dirty flag が立っていれば「再実行が必要」と通知する。
+ */
+export declare function releaseBuildLock(paths: BuildLockPaths): {
+    readonly rerunNeeded: boolean;
+};
+/**
+ * 古い (stale) ロックを掃除する。OS リブートや SIGKILL でロックが残った場合の保険。
+ * @param maxAgeMs これより古いロックは削除する (デフォルト 10 分)
+ */
+export declare function cleanStaleLock(paths: BuildLockPaths, maxAgeMs?: number): void;
+//# sourceMappingURL=build-lock.d.ts.map

package/dist/util/build-lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-lock.d.ts","sourceRoot":"","sources":["../../src/util/build-lock.ts"],"names":[],"mappings":"AAGA;;;;;;;;;GASG;AAEH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,gDAAgD;IAChD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,cAAc,GAAG,aAAa,CAqBxE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,cAAc,GAAG;IAAE,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAA;CAAE,CAezF;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,cAAc,EAAE,QAAQ,SAAiB,GAAG,IAAI,CAcrF"}

package/dist/util/build-lock.js

@@ -0,0 +1,72 @@
+import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import { dirname } from "node:path";
+/**
+ * ロックを取得試行する。取得できなければ dirty flag を立てて false を返す。
+ */
+export function tryAcquireBuildLock(paths) {
+    mkdirSync(dirname(paths.lockPath), { recursive: true });
+    if (existsSync(paths.lockPath)) {
+        // 別プロセスが実行中 — dirty flag を立てて即終了
+        try {
+            writeFileSync(paths.dirtyPath, new Date().toISOString(), { encoding: "utf8" });
+        }
+        catch {
+            // ignore
+        }
+        let heldBy = "unknown";
+        try {
+            heldBy = readFileSync(paths.lockPath, "utf8").trim();
+        }
+        catch {
+            // ignore
+        }
+        return { acquired: false, heldBy };
+    }
+    writeFileSync(paths.lockPath, `${process.pid}@${new Date().toISOString()}`, {
+        encoding: "utf8",
+    });
+    return { acquired: true };
+}
+/**
+ * ロックを解除し、dirty flag が立っていれば「再実行が必要」と通知する。
+ */
+export function releaseBuildLock(paths) {
+    try {
+        rmSync(paths.lockPath, { force: true });
+    }
+    catch {
+        // ignore
+    }
+    const rerunNeeded = existsSync(paths.dirtyPath);
+    if (rerunNeeded) {
+        try {
+            rmSync(paths.dirtyPath, { force: true });
+        }
+        catch {
+            // ignore
+        }
+    }
+    return { rerunNeeded };
+}
+/**
+ * 古い (stale) ロックを掃除する。OS リブートや SIGKILL でロックが残った場合の保険。
+ * @param maxAgeMs これより古いロックは削除する (デフォルト 10 分)
+ */
+export function cleanStaleLock(paths, maxAgeMs = 10 * 60 * 1000) {
+    if (!existsSync(paths.lockPath))
+        return;
+    try {
+        const content = readFileSync(paths.lockPath, "utf8");
+        const isoMatch = content.match(/@(.+)$/);
+        if (isoMatch) {
+            const ts = Date.parse(isoMatch[1] ?? "");
+            if (!Number.isNaN(ts) && Date.now() - ts > maxAgeMs) {
+                rmSync(paths.lockPath, { force: true });
+            }
+        }
+    }
+    catch {
+        // ignore
+    }
+}
+//# sourceMappingURL=build-lock.js.map

package/dist/util/build-lock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-lock.js","sourceRoot":"","sources":["../../src/util/build-lock.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACrF,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAwBpC;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAqB;IACvD,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACxD,IAAI,UAAU,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC/B,iCAAiC;QACjC,IAAI,CAAC;YACH,aAAa,CAAC,KAAK,CAAC,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;QACjF,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;QACD,IAAI,MAAM,GAAG,SAAS,CAAC;QACvB,IAAI,CAAC;YACH,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;QACvD,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;QACD,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IACrC,CAAC;IACD,aAAa,CAAC,KAAK,CAAC,QAAQ,EAAE,GAAG,OAAO,CAAC,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,EAAE;QAC1E,QAAQ,EAAE,MAAM;KACjB,CAAC,CAAC;IACH,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;AAC5B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAqB;IACpD,IAAI,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1C,CAAC;IAAC,MAAM,CAAC;QACP,SAAS;IACX,CAAC;IACD,MAAM,WAAW,GAAG,UAAU,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAChD,IAAI,WAAW,EAAE,CAAC;QAChB,IAAI,CAAC;YACH,MAAM,CAAC,KAAK,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3C,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;IACH,CAAC;IACD,OAAO,EAAE,WAAW,EAAE,CAAC;AACzB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,KAAqB,EAAE,QAAQ,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI;IAC7E,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,QAAQ,CAAC;QAAE,OAAO;IACxC,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,YAAY,CAAC,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QACrD,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACzC,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YACzC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;gBACpD,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YAC1C,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,SAAS;IACX,CAAC;AACH,CAAC"}

package/dist/util/hash.d.ts

@@ -0,0 +1,3 @@
+export declare function sha256(input: string | Buffer): string;
+export declare function combineHashes(parts: readonly string[]): string;
+//# sourceMappingURL=hash.d.ts.map

package/dist/util/hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../../src/util/hash.ts"],"names":[],"mappings":"AAEA,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAErD;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAO9D"}

package/dist/util/hash.js

@@ -0,0 +1,13 @@
+import { createHash } from "node:crypto";
+export function sha256(input) {
+    return `sha256:${createHash("sha256").update(input).digest("hex")}`;
+}
+export function combineHashes(parts) {
+    const hash = createHash("sha256");
+    for (const part of parts.toSorted()) {
+        hash.update(part);
+        hash.update("\n");
+    }
+    return `sha256:${hash.digest("hex")}`;
+}
+//# sourceMappingURL=hash.js.map

package/dist/util/hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.js","sourceRoot":"","sources":["../../src/util/hash.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,UAAU,MAAM,CAAC,KAAsB;IAC3C,OAAO,UAAU,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAwB;IACpD,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;IAClC,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,QAAQ,EAAE,EAAE,CAAC;QACpC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAClB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACpB,CAAC;IACD,OAAO,UAAU,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;AACxC,CAAC"}

package/dist/util/path-guard.d.ts

@@ -0,0 +1,16 @@
+export declare class PathGuardError extends Error {
+    constructor(message: string);
+}
+/**
+ * `inputPath` を `rootDir` 起点で解決し、解決後のパスが `rootDir` 配下に
+ * 収まっていることを保証する。`../` による脱出を拒否する。
+ *
+ * 戻り値: 検証済みの絶対パス
+ */
+export declare function resolveWithinRoot(rootDir: string, inputPath: string, label?: string): string;
+/**
+ * 既に解決された絶対パスが `rootDir` 配下にあることを assert する。
+ * `resolveMarkdownPath` のような内部生成パス (FQN を組み込む) の検証用。
+ */
+export declare function assertWithinRoot(rootDir: string, resolvedPath: string, label?: string): void;
+//# sourceMappingURL=path-guard.d.ts.map

package/dist/util/path-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-guard.d.ts","sourceRoot":"","sources":["../../src/util/path-guard.ts"],"names":[],"mappings":"AAEA,qBAAa,cAAe,SAAQ,KAAK;gBAC3B,OAAO,EAAE,MAAM;CAI5B;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,SAAS,GAAG,MAAM,CAa5F;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,KAAK,SAAS,GAAG,IAAI,CAQ5F"}

package/dist/util/path-guard.js

@@ -0,0 +1,40 @@
+import { isAbsolute, relative, resolve } from "node:path";
+export class PathGuardError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "PathGuardError";
+    }
+}
+/**
+ * `inputPath` を `rootDir` 起点で解決し、解決後のパスが `rootDir` 配下に
+ * 収まっていることを保証する。`../` による脱出を拒否する。
+ *
+ * 戻り値: 検証済みの絶対パス
+ */
+export function resolveWithinRoot(rootDir, inputPath, label = "path") {
+    const root = resolve(rootDir);
+    const resolved = resolve(root, inputPath);
+    const rel = relative(root, resolved);
+    if (rel === "" || rel === ".") {
+        return resolved;
+    }
+    if (rel.startsWith("..") || isAbsolute(rel)) {
+        throw new PathGuardError(`${label} must be within ${root} (got: ${inputPath} → resolved outside root)`);
+    }
+    return resolved;
+}
+/**
+ * 既に解決された絶対パスが `rootDir` 配下にあることを assert する。
+ * `resolveMarkdownPath` のような内部生成パス (FQN を組み込む) の検証用。
+ */
+export function assertWithinRoot(rootDir, resolvedPath, label = "path") {
+    const root = resolve(rootDir);
+    const target = resolve(resolvedPath);
+    const rel = relative(root, target);
+    if (rel === "" || rel === ".")
+        return;
+    if (rel.startsWith("..") || isAbsolute(rel)) {
+        throw new PathGuardError(`${label} escapes root ${root}: ${resolvedPath}`);
+    }
+}
+//# sourceMappingURL=path-guard.js.map

package/dist/util/path-guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-guard.js","sourceRoot":"","sources":["../../src/util/path-guard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE1D,MAAM,OAAO,cAAe,SAAQ,KAAK;IACvC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAe,EAAE,SAAiB,EAAE,KAAK,GAAG,MAAM;IAClF,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9B,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IAC1C,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IACrC,IAAI,GAAG,KAAK,EAAE,IAAI,GAAG,KAAK,GAAG,EAAE,CAAC;QAC9B,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC5C,MAAM,IAAI,cAAc,CACtB,GAAG,KAAK,mBAAmB,IAAI,UAAU,SAAS,2BAA2B,CAC9E,CAAC;IACJ,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAe,EAAE,YAAoB,EAAE,KAAK,GAAG,MAAM;IACpF,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9B,MAAM,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IACrC,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACnC,IAAI,GAAG,KAAK,EAAE,IAAI,GAAG,KAAK,GAAG;QAAE,OAAO;IACtC,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC5C,MAAM,IAAI,cAAc,CAAC,GAAG,KAAK,iBAAiB,IAAI,KAAK,YAAY,EAAE,CAAC,CAAC;IAC7E,CAAC;AACH,CAAC"}

package/dist/util/timing-log.d.ts

@@ -0,0 +1,28 @@
+export interface TimingEntry {
+    readonly timestamp: string;
+    readonly command: string;
+    readonly durationMs: number;
+    readonly mode?: string;
+    readonly extra?: Record<string, unknown>;
+}
+/**
+ * `.yohaku/hook-timings.jsonl` に 1 行 JSON で実行時間を追記する。
+ * - 追記失敗は黙って無視 (本処理を絶対に止めない)
+ * - 閾値超過時は stderr に warning (デフォルト 2000ms)
+ */
+export declare function appendTimingLog(logPath: string, entry: TimingEntry, options?: {
+    readonly warnThresholdMs?: number;
+    readonly silent?: boolean;
+}): void;
+/**
+ * 高分解能タイマーで処理時間 (ms) を返すユーティリティ。
+ */
+export declare function measureMs<T>(fn: () => T): {
+    readonly result: T;
+    readonly durationMs: number;
+};
+export declare function measureMsAsync<T>(fn: () => Promise<T>): Promise<{
+    readonly result: T;
+    readonly durationMs: number;
+}>;
+//# sourceMappingURL=timing-log.d.ts.map

package/dist/util/timing-log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timing-log.d.ts","sourceRoot":"","sources":["../../src/util/timing-log.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC1C;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,WAAW,EAClB,OAAO,GAAE;IAAE,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GAC7E,IAAI,CAeN;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG;IAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAK7F;AAED,wBAAsB,cAAc,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC;IACrE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IACnB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B,CAAC,CAKD"}

package/dist/util/timing-log.js

@@ -0,0 +1,38 @@
+import { appendFileSync, mkdirSync } from "node:fs";
+import { dirname } from "node:path";
+/**
+ * `.yohaku/hook-timings.jsonl` に 1 行 JSON で実行時間を追記する。
+ * - 追記失敗は黙って無視 (本処理を絶対に止めない)
+ * - 閾値超過時は stderr に warning (デフォルト 2000ms)
+ */
+export function appendTimingLog(logPath, entry, options = {}) {
+    const threshold = options.warnThresholdMs ?? 2000;
+    try {
+        mkdirSync(dirname(logPath), { recursive: true });
+        appendFileSync(logPath, `${JSON.stringify(entry)}\n`, { encoding: "utf8" });
+    }
+    catch {
+        // 計測の失敗は本処理を巻き込まない
+    }
+    if (!options.silent && entry.durationMs > threshold) {
+        const seconds = (entry.durationMs / 1000).toFixed(2);
+        const thresholdSec = threshold / 1000;
+        console.error(`[yohaku] warning: ${entry.command} took ${seconds}s (> ${thresholdSec}s threshold). If this runs from a Claude Code hook, consider --async or moving to a Stop hook. See docs/03-reference/knowledge-graph-schema.md and CHANGELOG for tuning options.`);
+    }
+}
+/**
+ * 高分解能タイマーで処理時間 (ms) を返すユーティリティ。
+ */
+export function measureMs(fn) {
+    const start = process.hrtime.bigint();
+    const result = fn();
+    const durationMs = Number(process.hrtime.bigint() - start) / 1_000_000;
+    return { result, durationMs };
+}
+export async function measureMsAsync(fn) {
+    const start = process.hrtime.bigint();
+    const result = await fn();
+    const durationMs = Number(process.hrtime.bigint() - start) / 1_000_000;
+    return { result, durationMs };
+}
+//# sourceMappingURL=timing-log.js.map

package/dist/util/timing-log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timing-log.js","sourceRoot":"","sources":["../../src/util/timing-log.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAUpC;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAC7B,OAAe,EACf,KAAkB,EAClB,UAA4E,EAAE;IAE9E,MAAM,SAAS,GAAG,OAAO,CAAC,eAAe,IAAI,IAAI,CAAC;IAClD,IAAI,CAAC;QACH,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACjD,cAAc,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;IAC9E,CAAC;IAAC,MAAM,CAAC;QACP,mBAAmB;IACrB,CAAC;IACD,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,KAAK,CAAC,UAAU,GAAG,SAAS,EAAE,CAAC;QACpD,MAAM,OAAO,GAAG,CAAC,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QACrD,MAAM,YAAY,GAAG,SAAS,GAAG,IAAI,CAAC;QACtC,OAAO,CAAC,KAAK,CACX,qBAAqB,KAAK,CAAC,OAAO,SAAS,OAAO,QAAQ,YAAY,kLAAkL,CACzP,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAI,EAAW;IACtC,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;IACtC,MAAM,MAAM,GAAG,EAAE,EAAE,CAAC;IACpB,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC,GAAG,SAAS,CAAC;IACvE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;AAChC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAI,EAAoB;IAI1D,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;IACtC,MAAM,MAAM,GAAG,MAAM,EAAE,EAAE,CAAC;IAC1B,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC,GAAG,SAAS,CAAC;IACvE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;AAChC,CAAC"}

package/dist/util/walk.d.ts

@@ -0,0 +1,10 @@
+/**
+ * ディレクトリを再帰的に走査してファイルを yield する。
+ *
+ * セキュリティ方針 (MED-4):
+ *   - シンボリックリンクは **追跡しない** (lstatSync を使用)。
+ *     `force-app/` 配下に外部ディレクトリへの symlink が置かれていても、
+ *     プロジェクト外のファイルが知識グラフに混入することを防ぐ。
+ */
+export declare function walkFiles(rootDir: string): Iterable<string>;
+//# sourceMappingURL=walk.d.ts.map

package/dist/util/walk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"walk.d.ts","sourceRoot":"","sources":["../../src/util/walk.ts"],"names":[],"mappings":"AAGA;;;;;;;GAOG;AACH,wBAAiB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,CA4B5D"}

package/dist/util/walk.js

@@ -0,0 +1,45 @@
+import { lstatSync, readdirSync } from "node:fs";
+import { join } from "node:path";
+/**
+ * ディレクトリを再帰的に走査してファイルを yield する。
+ *
+ * セキュリティ方針 (MED-4):
+ *   - シンボリックリンクは **追跡しない** (lstatSync を使用)。
+ *     `force-app/` 配下に外部ディレクトリへの symlink が置かれていても、
+ *     プロジェクト外のファイルが知識グラフに混入することを防ぐ。
+ */
+export function* walkFiles(rootDir) {
+    const stack = [rootDir];
+    while (stack.length > 0) {
+        const current = stack.pop();
+        if (current === undefined)
+            break;
+        let entries;
+        try {
+            entries = readdirSync(current);
+        }
+        catch {
+            continue;
+        }
+        for (const entry of entries) {
+            const full = join(current, entry);
+            let s;
+            try {
+                s = lstatSync(full);
+            }
+            catch {
+                continue;
+            }
+            // シンボリックリンクは無視 (ファイル / ディレクトリ どちらでも)
+            if (s.isSymbolicLink())
+                continue;
+            if (s.isDirectory()) {
+                stack.push(full);
+            }
+            else if (s.isFile()) {
+                yield full;
+            }
+        }
+    }
+}
+//# sourceMappingURL=walk.js.map

package/dist/util/walk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"walk.js","sourceRoot":"","sources":["../../src/util/walk.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACjD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC;;;;;;;GAOG;AACH,MAAM,SAAS,CAAC,CAAC,SAAS,CAAC,OAAe;IACxC,MAAM,KAAK,GAAa,CAAC,OAAO,CAAC,CAAC;IAClC,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,EAAE,CAAC;QAC5B,IAAI,OAAO,KAAK,SAAS;YAAE,MAAM;QACjC,IAAI,OAAiB,CAAC;QACtB,IAAI,CAAC;YACH,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;QACjC,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;QACD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YAClC,IAAI,CAA+B,CAAC;YACpC,IAAI,CAAC;gBACH,CAAC,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;YACtB,CAAC;YAAC,MAAM,CAAC;gBACP,SAAS;YACX,CAAC;YACD,qCAAqC;YACrC,IAAI,CAAC,CAAC,cAAc,EAAE;gBAAE,SAAS;YACjC,IAAI,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;gBACpB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACnB,CAAC;iBAAM,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;gBACtB,MAAM,IAAI,CAAC;YACb,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC"}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@yohakuforce/core",
+  "version": "0.4.0",
+  "description": "Core CLI and knowledge graph engine for yohakuforce. Salesforce metadata → SQLite knowledge graph → deterministic Markdown rendering.",
+  "license": "Apache-2.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "yohaku": "./dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "src/schema",
+    "README.md",
+    "LICENSE",
+    "NOTICE"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json && node scripts/copy-assets.mjs",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:golden": "vitest run --dir tests/golden",
+    "typecheck": "tsc --noEmit",
+    "lint": "biome check src tests",
+    "bench:graph-build": "node scripts/bench-graph-build.mjs"
+  },
+  "dependencies": {
+    "ajv": "^8.17.0",
+    "ajv-formats": "^3.0.1",
+    "better-sqlite3": "^11.0.0",
+    "eta": "^3.5.0",
+    "fast-xml-parser": "^5.7.3",
+    "yaml": "^2.6.0"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.0",
+    "@types/node": "^20.16.0",
+    "typescript": "^5.6.0",
+    "vitest": "^2.1.0"
+  },
+  "peerDependencies": {
+    "@salesforce/source-deploy-retrieve": ">=12.0.0"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  }
+}