@samchon/graph 0.1.0

package/lib/utils/dirname.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dirname.js","sourceRoot":"","sources":["../../src/utils/dirname.ts"],"names":[],"mappings":";;;AAAA,mDAAgD;AAEhD,iBAAwB,IAAY;IAClC,MAAM,UAAU,GAAG,IAAA,6BAAa,EAAC,IAAI,CAAC,CAAC;IACvC,MAAM,KAAK,GAAG,UAAU,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAC1C,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;AACvD,CAAC"}

package/lib/utils/fileFromUri.d.ts

@@ -0,0 +1 @@
+export declare function fileFromUri(uri: string): string;

package/lib/utils/fileFromUri.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fileFromUri = fileFromUri;
+function fileFromUri(uri) {
+    if (!uri.startsWith("file://"))
+        return uri;
+    // Language servers encode the Windows drive-letter colon as `%3A`, which
+    // `decodeURI` leaves intact; normalize it before the drive-letter check so
+    // the path does not stay malformed and drop every reference edge.
+    const withoutScheme = uri
+        .slice("file://".length)
+        .replace(/^\/([A-Za-z])%3[Aa]/, "/$1:");
+    // `decodeURI` leaves reserved characters encoded, but `fileUri` percent-encodes
+    // `#` in real paths; restore it (and `?`) so the path round-trips.
+    const decoded = decodeURI(withoutScheme).replace(/%23/g, "#").replace(/%3[Ff]/g, "?");
+    if (/^\/[A-Za-z]:/.test(decoded))
+        return decoded.slice(1).replace(/\//g, "\\");
+    return decoded;
+}
+//# sourceMappingURL=fileFromUri.js.map

package/lib/utils/fileFromUri.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileFromUri.js","sourceRoot":"","sources":["../../src/utils/fileFromUri.ts"],"names":[],"mappings":";;;AAAA,qBAA4B,GAAW;IACrC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC;QAAE,OAAO,GAAG,CAAC;IAC3C,yEAAyE;IACzE,2EAA2E;IAC3E,kEAAkE;IAClE,MAAM,aAAa,GAAG,GAAG;SACtB,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC;SACvB,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;IAC1C,gFAAgF;IAChF,mEAAmE;IACnE,MAAM,OAAO,GAAG,SAAS,CAAC,aAAa,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;IACtF,IAAI,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAC/E,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/lib/utils/fileUri.d.ts

@@ -0,0 +1 @@
+export declare function fileUri(file: string): string;

package/lib/utils/fileUri.js

@@ -0,0 +1,19 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fileUri = fileUri;
+const node_path_1 = __importDefault(require("node:path"));
+function fileUri(file) {
+    // Prepend a leading slash for Windows drive paths (`C:/x` -> `/C:/x`) while
+    // leaving POSIX paths untouched. A branchless replace keeps the coverage gate
+    // reachable on every platform, since a plain `if` here is only ever taken on
+    // one OS.
+    const resolved = node_path_1.default
+        .resolve(file)
+        .replace(/\\/g, "/")
+        .replace(/^(?!\/)/, "/");
+    return `file://${encodeURI(resolved).replace(/#/g, "%23")}`;
+}
+//# sourceMappingURL=fileUri.js.map

package/lib/utils/fileUri.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileUri.js","sourceRoot":"","sources":["../../src/utils/fileUri.ts"],"names":[],"mappings":";;;;;;AAAA,0DAA6B;AAE7B,iBAAwB,IAAY;IAClC,4EAA4E;IAC5E,8EAA8E;IAC9E,6EAA6E;IAC7E,UAAU;IACV,MAAM,QAAQ,GAAG,mBAAI;SAClB,OAAO,CAAC,IAAI,CAAC;SACb,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;SACnB,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;IAC3B,OAAO,UAAU,SAAS,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC;AAC9D,CAAC"}

package/lib/utils/fs.d.ts

@@ -0,0 +1,6 @@
+export * from "./DEFAULT_IGNORES";
+export * from "./IWalkOptions";
+export * from "./projectRelative";
+export * from "./readLines";
+export * from "./readText";
+export * from "./walkSourceFiles";

package/lib/utils/fs.js

@@ -0,0 +1,23 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./DEFAULT_IGNORES"), exports);
+__exportStar(require("./IWalkOptions"), exports);
+__exportStar(require("./projectRelative"), exports);
+__exportStar(require("./readLines"), exports);
+__exportStar(require("./readText"), exports);
+__exportStar(require("./walkSourceFiles"), exports);
+//# sourceMappingURL=fs.js.map

package/lib/utils/fs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.js","sourceRoot":"","sources":["../../src/utils/fs.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,oDAAkC;AAClC,iDAA+B;AAC/B,oDAAkC;AAClC,8CAA4B;AAC5B,6CAA2B;AAC3B,oDAAkC"}

package/lib/utils/isSubPath.d.ts

@@ -0,0 +1 @@
+export declare function isSubPath(root: string, candidate: string): boolean;

package/lib/utils/isSubPath.js

@@ -0,0 +1,15 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isSubPath = isSubPath;
+const node_path_1 = __importDefault(require("node:path"));
+function isSubPath(root, candidate) {
+    const rel = node_path_1.default.relative(node_path_1.default.resolve(root), node_path_1.default.resolve(candidate));
+    // A path that merely starts with ".." (e.g. `..foo`) is still a child; only a
+    // bare ".." or one under "../" escapes the root.
+    const escapes = rel === ".." || rel.startsWith(`..${node_path_1.default.sep}`);
+    return rel === "" || (!escapes && !node_path_1.default.isAbsolute(rel));
+}
+//# sourceMappingURL=isSubPath.js.map

package/lib/utils/isSubPath.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isSubPath.js","sourceRoot":"","sources":["../../src/utils/isSubPath.ts"],"names":[],"mappings":";;;;;;AAAA,0DAA6B;AAE7B,mBAA0B,IAAY,EAAE,SAAiB;IACvD,MAAM,GAAG,GAAG,mBAAI,CAAC,QAAQ,CAAC,mBAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,mBAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;IACvE,8EAA8E;IAC9E,iDAAiD;IACjD,MAAM,OAAO,GAAG,GAAG,KAAK,IAAI,IAAI,GAAG,CAAC,UAAU,CAAC,KAAK,mBAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IAChE,OAAO,GAAG,KAAK,EAAE,IAAI,CAAC,CAAC,OAAO,IAAI,CAAC,mBAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;AAC3D,CAAC"}

package/lib/utils/normalizePath.d.ts

@@ -0,0 +1 @@
+export declare function normalizePath(value: string): string;

package/lib/utils/normalizePath.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizePath = normalizePath;
+function normalizePath(value) {
+    return value.replace(/\\/g, "/");
+}
+//# sourceMappingURL=normalizePath.js.map

package/lib/utils/normalizePath.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizePath.js","sourceRoot":"","sources":["../../src/utils/normalizePath.ts"],"names":[],"mappings":";;;AAAA,uBAA8B,KAAa;IACzC,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AACnC,CAAC"}

package/lib/utils/path.d.ts

@@ -0,0 +1,7 @@
+export * from "./basename";
+export * from "./dirname";
+export * from "./fileFromUri";
+export * from "./fileUri";
+export * from "./isSubPath";
+export * from "./normalizePath";
+export * from "./relativePath";

package/lib/utils/path.js

@@ -0,0 +1,24 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./basename"), exports);
+__exportStar(require("./dirname"), exports);
+__exportStar(require("./fileFromUri"), exports);
+__exportStar(require("./fileUri"), exports);
+__exportStar(require("./isSubPath"), exports);
+__exportStar(require("./normalizePath"), exports);
+__exportStar(require("./relativePath"), exports);
+//# sourceMappingURL=path.js.map

package/lib/utils/path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.js","sourceRoot":"","sources":["../../src/utils/path.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6CAA2B;AAC3B,4CAA0B;AAC1B,gDAA8B;AAC9B,4CAA0B;AAC1B,8CAA4B;AAC5B,kDAAgC;AAChC,iDAA+B"}

package/lib/utils/projectRelative.d.ts

@@ -0,0 +1 @@
+export declare function projectRelative(root: string, file: string): string;

package/lib/utils/projectRelative.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.projectRelative = projectRelative;
+const normalizePath_1 = require("./normalizePath");
+const relativePath_1 = require("./relativePath");
+function projectRelative(root, file) {
+    return (0, normalizePath_1.normalizePath)((0, relativePath_1.relativePath)(root, file));
+}
+//# sourceMappingURL=projectRelative.js.map

package/lib/utils/projectRelative.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projectRelative.js","sourceRoot":"","sources":["../../src/utils/projectRelative.ts"],"names":[],"mappings":";;;AAAA,mDAAgD;AAChD,iDAA8C;AAE9C,yBAAgC,IAAY,EAAE,IAAY;IACxD,OAAO,IAAA,6BAAa,EAAC,IAAA,2BAAY,EAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;AACjD,CAAC"}

package/lib/utils/readLines.d.ts

@@ -0,0 +1 @@
+export declare function readLines(file: string): string[] | undefined;

package/lib/utils/readLines.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readLines = readLines;
+const readText_1 = require("./readText");
+function readLines(file) {
+    return (0, readText_1.readText)(file)?.split(/\r?\n/);
+}
+//# sourceMappingURL=readLines.js.map

package/lib/utils/readLines.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"readLines.js","sourceRoot":"","sources":["../../src/utils/readLines.ts"],"names":[],"mappings":";;;AAAA,yCAAsC;AAEtC,mBAA0B,IAAY;IACpC,OAAO,IAAA,mBAAQ,EAAC,IAAI,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;AACxC,CAAC"}

package/lib/utils/readText.d.ts

@@ -0,0 +1 @@
+export declare function readText(file: string): string | undefined;

package/lib/utils/readText.js

@@ -0,0 +1,17 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readText = readText;
+const node_fs_1 = __importDefault(require("node:fs"));
+function readText(file) {
+    try {
+        // Strip a UTF-8 BOM (U+FEFF) so it does not offset the first line's columns.
+        return node_fs_1.default.readFileSync(file, "utf8").replace(/^\uFEFF/, "");
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=readText.js.map

package/lib/utils/readText.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"readText.js","sourceRoot":"","sources":["../../src/utils/readText.ts"],"names":[],"mappings":";;;;;;AAAA,sDAAyB;AAEzB,kBAAyB,IAAY;IACnC,IAAI,CAAC;QACH,6EAA6E;QAC7E,OAAO,iBAAE,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;IAC9D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}

package/lib/utils/relativePath.d.ts

@@ -0,0 +1 @@
+export declare function relativePath(root: string, file: string): string;

package/lib/utils/relativePath.js

@@ -0,0 +1,12 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.relativePath = relativePath;
+const node_path_1 = __importDefault(require("node:path"));
+const normalizePath_1 = require("./normalizePath");
+function relativePath(root, file) {
+    return (0, normalizePath_1.normalizePath)(node_path_1.default.relative(root, file));
+}
+//# sourceMappingURL=relativePath.js.map

package/lib/utils/relativePath.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"relativePath.js","sourceRoot":"","sources":["../../src/utils/relativePath.ts"],"names":[],"mappings":";;;;;;AAAA,0DAA6B;AAE7B,mDAAgD;AAEhD,sBAA6B,IAAY,EAAE,IAAY;IACrD,OAAO,IAAA,6BAAa,EAAC,mBAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;AAClD,CAAC"}

package/lib/utils/walkSourceFiles.d.ts

@@ -0,0 +1,2 @@
+import { IWalkOptions } from "./IWalkOptions";
+export declare function walkSourceFiles(root: string, options: IWalkOptions): string[];

package/lib/utils/walkSourceFiles.js

@@ -0,0 +1,44 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.walkSourceFiles = walkSourceFiles;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const DEFAULT_IGNORES_1 = require("./DEFAULT_IGNORES");
+function walkSourceFiles(root, options) {
+    const out = [];
+    const ignoreDirs = options.ignoreDirs ?? DEFAULT_IGNORES_1.DEFAULT_IGNORES;
+    const visit = (dir) => {
+        if (options.maxFiles !== undefined && out.length >= options.maxFiles)
+            return;
+        let entries;
+        try {
+            entries = node_fs_1.default.readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        entries.sort((a, b) => a.name.localeCompare(b.name));
+        for (const entry of entries) {
+            if (options.maxFiles !== undefined && out.length >= options.maxFiles)
+                break;
+            const abs = node_path_1.default.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                if (!ignoreDirs.has(entry.name))
+                    visit(abs);
+                continue;
+            }
+            /* c8 ignore next */
+            if (!entry.isFile())
+                continue;
+            if (options.extensions.has(node_path_1.default.extname(entry.name).toLowerCase())) {
+                out.push(abs);
+            }
+        }
+    };
+    visit(node_path_1.default.resolve(root));
+    return out;
+}
+//# sourceMappingURL=walkSourceFiles.js.map

package/lib/utils/walkSourceFiles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"walkSourceFiles.js","sourceRoot":"","sources":["../../src/utils/walkSourceFiles.ts"],"names":[],"mappings":";;;;;;AAAA,sDAAyB;AACzB,0DAA6B;AAE7B,uDAAoD;AAGpD,yBAAgC,IAAY,EAAE,OAAqB;IACjE,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,iCAAe,CAAC;IACzD,MAAM,KAAK,GAAG,CAAC,GAAW,EAAQ,EAAE;QAClC,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS,IAAI,GAAG,CAAC,MAAM,IAAI,OAAO,CAAC,QAAQ;YAAE,OAAO;QAC7E,IAAI,OAAoB,CAAC;QACzB,IAAI,CAAC;YACH,OAAO,GAAG,iBAAE,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QACzD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO;QACT,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QACrD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS,IAAI,GAAG,CAAC,MAAM,IAAI,OAAO,CAAC,QAAQ;gBAAE,MAAM;YAC5E,MAAM,GAAG,GAAG,mBAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YACvC,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;gBACxB,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC;oBAAE,KAAK,CAAC,GAAG,CAAC,CAAC;gBAC5C,SAAS;YACX,CAAC;YACD,oBAAoB;YACpB,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE;gBAAE,SAAS;YAC9B,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,mBAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;gBACnE,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAChB,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IACF,KAAK,CAAC,mBAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IAC1B,OAAO,GAAG,CAAC;AACb,CAAC"}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@samchon/graph",
+  "version": "0.1.0",
+  "description": "Language-server-backed code graph over MCP for statically typed compiled languages.",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "bin": {
+    "samchon-graph": "lib/bin.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "keywords": [
+    "mcp",
+    "lsp",
+    "code-graph",
+    "language-server",
+    "static-analysis"
+  ],
+  "files": [
+    "README.md",
+    "LICENSE",
+    "lib",
+    "src"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.26.0",
+    "@typia/interface": "^13.0.0",
+    "@typia/mcp": "^13.0.0",
+    "typia": "^13.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.18.0",
+    "rimraf": "^6.0.1",
+    "ttsc": "^0.17.4",
+    "typescript": "^7.0.2"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/samchon/graph"
+  },
+  "author": "Jeongho Nam",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/samchon/graph/issues"
+  },
+  "homepage": "https://github.com/samchon/graph#readme",
+  "scripts": {
+    "build": "rimraf lib && ttsc -p tsconfig.json && node -e \"require('node:fs').copyFileSync('../../README.md', 'README.md')\""
+  }
+}

package/src/AsyncSamchonGraphSource.ts

@@ -0,0 +1,5 @@
+import { GraphMemory } from "./model/GraphMemory";
+
+export type AsyncSamchonGraphSource =
+  | GraphMemory
+  | (() => GraphMemory | Promise<GraphMemory>);

package/src/SamchonGraphApplication.ts

@@ -0,0 +1,74 @@
+import { AsyncSamchonGraphSource } from "./AsyncSamchonGraphSource";
+import { GraphMemory } from "./model/GraphMemory";
+import { resultGuide, resultNext } from "./operations/common";
+import { runDetails } from "./operations/runDetails";
+import { runEntrypoints } from "./operations/runEntrypoints";
+import { runLookup } from "./operations/runLookup";
+import { runOverview } from "./operations/runOverview";
+import { runTour } from "./operations/runTour";
+import { runTrace } from "./operations/runTrace";
+import { IGraphEscape, ISamchonGraphApplication } from "./structures";
+
+export class SamchonGraphApplication implements ISamchonGraphApplication {
+  private readonly graph: () => GraphMemory | Promise<GraphMemory>;
+  private promise?: Promise<GraphMemory>;
+
+  public constructor(source: AsyncSamchonGraphSource) {
+    this.graph = typeof source === "function" ? source : () => source;
+  }
+
+  public async inspect_code_graph(
+    props: ISamchonGraphApplication.IProps,
+  ): Promise<ISamchonGraphApplication.IResult> {
+    const graph = await this.load();
+    switch (props.request.type) {
+      case "entrypoints":
+        return { result: runEntrypoints(graph, props.request) };
+      case "lookup":
+        return { result: runLookup(graph, props.request) };
+      case "trace":
+        return { result: runTrace(graph, props.request) };
+      case "details":
+        return { result: runDetails(graph, props.request) };
+      case "overview":
+        return { result: runOverview(graph, props.request) };
+      case "tour":
+        return { result: runTour(graph, props.request) };
+      case "escape":
+        return { result: this.escape(props.request.reason, props.request.nextStep) };
+      default:
+        props.request satisfies never;
+        throw new Error("Unknown graph request type");
+    }
+  }
+
+  private escape(reason: string, nextStep?: string): IGraphEscape {
+    return {
+      type: "escape",
+      skipped: true,
+      reason,
+      ...(nextStep !== undefined ? { nextStep } : {}),
+      next: resultNext(
+        "outside",
+        nextStep ?? "Graph evidence is exhausted or not the next evidence source.",
+      ),
+      guide: resultGuide(
+        "Finish from existing graph evidence, state the graph gap, or ask for clarification.",
+      ),
+    };
+  }
+
+  private async load(): Promise<GraphMemory> {
+    // Cache the built graph on success only. Caching a rejected promise would
+    // brick the resident server for the whole session after one transient index
+    // failure (e.g. a slow language-server cold start); clear it so the next
+    // call rebuilds.
+    if (this.promise === undefined) {
+      this.promise = Promise.resolve(this.graph()).catch((error: unknown) => {
+        this.promise = undefined;
+        throw error;
+      });
+    }
+    return this.promise;
+  }
+}

package/src/SamchonGraphSource.ts

@@ -0,0 +1,3 @@
+import { GraphMemory } from "./model/GraphMemory";
+
+export type SamchonGraphSource = GraphMemory | (() => GraphMemory);

package/src/application.ts

@@ -0,0 +1,3 @@
+export * from "./AsyncSamchonGraphSource";
+export * from "./SamchonGraphApplication";
+export * from "./SamchonGraphSource";

package/src/bin.ts

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+
+import { runGraph } from "./index";
+
+const code = runGraph(process.argv.slice(2));
+if (typeof code === "number") process.exitCode = code;

package/src/index.ts

@@ -0,0 +1,13 @@
+export * from "./application";
+export * from "./indexer/allExtensions";
+export * from "./indexer/buildGraph";
+export * from "./indexer/buildGraphDump";
+export * from "./indexer/IBuildGraphOptions";
+export * from "./indexer/IIndexerResult";
+export * from "./indexer/ILanguageSpec";
+export * from "./indexer/LANGUAGE_SPECS";
+export * from "./indexer/languageOf";
+export * from "./indexer/specOf";
+export * from "./model/GraphMemory";
+export * from "./runGraph";
+export * from "./structures";

package/src/indexer/IBuildGraphOptions.ts

@@ -0,0 +1,42 @@
+import { GraphLanguage } from "../structures";
+
+export interface IBuildGraphOptions {
+  cwd?: string;
+  mode?: "auto" | "lsp" | "static";
+  languages?: GraphLanguage[];
+  server?: string;
+  serverArgs?: string[];
+  initializationOptions?: unknown;
+  maxFiles?: number;
+  lspReferenceLimit?: number;
+  lspTimeoutMs?: number;
+  /**
+   * How many `textDocument/references` requests to keep in flight at once.
+   * Reference collection dominates indexing time on large repositories, and the
+   * requests are independent, so they are issued concurrently up to this bound.
+   */
+  lspConcurrency?: number;
+  /**
+   * Maximum time to wait for a language server to finish its initial indexing
+   * (reported through `$/progress`) before collecting references. Servers such
+   * as rust-analyzer, clangd, and jdtls answer reference requests with nothing
+   * until indexing completes, so skipping this wait yields zero edges.
+   */
+  lspReadyTimeoutMs?: number;
+  /**
+   * How long the server must stay silent on `$/progress` before its initial
+   * indexing is treated as settled. Also bounds the wait for servers that never
+   * report progress at all.
+   */
+  lspReadyQuietMs?: number;
+  /**
+   * How long to wait for the FIRST `textDocument/references` request, which may
+   * trigger the server to build its cross-file reference index lazily. Once that
+   * one warmup request returns, later references are cache-fast and use the
+   * normal `lspTimeoutMs`. A timeout here means the server cannot answer
+   * references at all, so only structural edges are kept. Defaults to a patient
+   * budget (slow servers like ruby-lsp need it); fast servers answer instantly
+   * and never reach it.
+   */
+  lspWarmupTimeoutMs?: number;
+}

package/src/indexer/IIndexerResult.ts

@@ -0,0 +1,6 @@
+import { IGraphDump } from "../structures";
+
+export interface IIndexerResult {
+  dump: IGraphDump;
+  warnings: string[];
+}

package/src/indexer/ILanguageSpec.ts

@@ -0,0 +1,11 @@
+import { GraphLanguage } from "../structures";
+
+export interface ILanguageSpec {
+  language: GraphLanguage;
+  extensions: string[];
+  lsp?: {
+    command: string;
+    args: string[];
+  };
+  lineComment: string;
+}