@ttsc/graph 0.18.3 → 0.18.4

package/README.md

@@ -47,6 +47,7 @@ The whole MCP surface is one tool, `inspect_typescript_graph`. You ask in plain
 
 - **An index, not source bodies.** It returns names, edges, signatures, and spans, never code, so the response stays flat as the repository grows.
 - **Built on the real compiler.** It reads the program `ttsc` type-checked, so `tsconfig` aliases, pnpm monorepos, symlinks, and re-exports resolve exactly, where a text parser can only guess.
+- **Current within one agent session.** Before each graph operation it checks the config, root-file set, module-resolution inputs, and source contents. Unchanged calls reuse the warm graph; source edits update the resident compiler incrementally; config, file-addition, deletion, and resolution changes reload safely.
 - **It does not force itself.** It states when the graph is the right source and offers a first-class `escape` for everything else.
 - **Errors and lint too.** `tsc` compile errors and `@ttsc/lint` and plugin (typia, nestia) findings ride the same graph, so "what is broken here?" answers from one index.
 

package/lib/TtscGraphApplication.d.ts

@@ -1,6 +1,6 @@
 import { TtscGraphMemory } from "./model/TtscGraphMemory";
 import { ITtscGraphApplication } from "./structures/ITtscGraphApplication";
-export type TtscGraphSource = TtscGraphMemory | (() => TtscGraphMemory);
+export type TtscGraphSource = TtscGraphMemory | (() => TtscGraphMemory | Promise<TtscGraphMemory>);
 /**
  * The MCP tool surface as a plain class over the resident
  * {@link TtscGraphMemory}.
@@ -12,13 +12,14 @@ export type TtscGraphSource = TtscGraphMemory | (() => TtscGraphMemory);
  * The method delegates to the pure graph functions in `./server`, which are
  * unit-testable without a transport; this class only binds them to the graph.
  *
- * Every method answers from the resident graph; none recompiles. Output is kept
+ * Every method answers from the current resident graph. The source may refresh
+ * that graph before the operation when project files changed. Output is kept
  * compact and bounded so a model can read structure without a file read, which
  * is the token win the redesign exists for.
  */
 export declare class TtscGraphApplication implements ITtscGraphApplication {
     private readonly graph;
     constructor(source: TtscGraphSource);
-    inspect_typescript_graph(props: ITtscGraphApplication.IProps): ITtscGraphApplication.IResult;
+    inspect_typescript_graph(props: ITtscGraphApplication.IProps): Promise<ITtscGraphApplication.IResult>;
     private escape;
 }

package/lib/TtscGraphApplication.js

@@ -19,7 +19,8 @@ const runTrace_1 = require("./server/runTrace");
  * The method delegates to the pure graph functions in `./server`, which are
  * unit-testable without a transport; this class only binds them to the graph.
  *
- * Every method answers from the resident graph; none recompiles. Output is kept
+ * Every method answers from the current resident graph. The source may refresh
+ * that graph before the operation when project files changed. Output is kept
  * compact and bounded so a model can read structure without a file read, which
  * is the token win the redesign exists for.
  */
@@ -28,7 +29,7 @@ class TtscGraphApplication {
     constructor(source) {
         this.graph = typeof source === "function" ? source : () => source;
     }
-    inspect_typescript_graph(props) {
+    async inspect_typescript_graph(props) {
         if (props.request.type === "escape") {
             const result = this.escape(props.request.reason);
             if (props.request.nextStep !== undefined) {
@@ -38,30 +39,31 @@ class TtscGraphApplication {
                 result,
             };
         }
+        const graph = await this.graph();
         switch (props.request.type) {
             case "entrypoints":
                 return {
-                    result: (0, runEntrypoints_1.runEntrypoints)(this.graph(), props.request),
+                    result: (0, runEntrypoints_1.runEntrypoints)(graph, props.request),
                 };
             case "lookup":
                 return {
-                    result: (0, runLookup_1.runLookup)(this.graph(), props.request),
+                    result: (0, runLookup_1.runLookup)(graph, props.request),
                 };
             case "trace":
                 return {
-                    result: (0, runTrace_1.runTrace)(this.graph(), props.request),
+                    result: (0, runTrace_1.runTrace)(graph, props.request),
                 };
             case "details":
                 return {
-                    result: (0, runDetails_1.runDetails)(this.graph(), props.request),
+                    result: (0, runDetails_1.runDetails)(graph, props.request),
                 };
             case "overview":
                 return {
-                    result: (0, runOverview_1.runOverview)(this.graph(), props.request),
+                    result: (0, runOverview_1.runOverview)(graph, props.request),
                 };
             case "tour":
                 return {
-                    result: (0, runTour_1.runTour)(this.graph(), props.request),
+                    result: (0, runTour_1.runTour)(graph, props.request),
                 };
             default:
                 props.request;

package/lib/TtscGraphApplication.js.map

@@ -1 +1 @@
-{"version":3,"file":"TtscGraphApplication.js","sourceRoot":"","sources":["../src/TtscGraphApplication.ts"],"names":[],"mappings":";;;AACA,sDAA+D;AAC/D,oDAAiD;AACjD,4DAAyD;AACzD,kDAA+C;AAC/C,sDAAmD;AACnD,8CAA2C;AAC3C,gDAA6C;AAM7C;;;;;;;;;;;;;;GAcG;AACH;IACmB,KAAK,CAAwB;IAE9C,YAAmB,MAAuB;QACxC,IAAI,CAAC,KAAK,GAAG,OAAO,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC;IACpE,CAAC;IAEM,wBAAwB,CAC7B,KAAmC;QAEnC,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACpC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YACjD,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;gBACzC,MAAM,CAAC,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC;YAC3C,CAAC;YACD,OAAO;gBACL,MAAM;aACP,CAAC;QACJ,CAAC;QACD,QAAQ,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;YAC3B,KAAK,aAAa;gBAChB,OAAO;oBACL,MAAM,EAAE,IAAA,+BAAc,EAAC,IAAI,CAAC,KAAK,EAAE,EAAE,KAAK,CAAC,OAAO,CAAC;iBACpD,CAAC;YACJ,KAAK,QAAQ;gBACX,OAAO;oBACL,MAAM,EAAE,IAAA,qBAAS,EAAC,IAAI,CAAC,KAAK,EAAE,EAAE,KAAK,CAAC,OAAO,CAAC;iBAC/C,CAAC;YACJ,KAAK,OAAO;gBACV,OAAO;oBACL,MAAM,EAAE,IAAA,mBAAQ,EAAC,IAAI,CAAC,KAAK,EAAE,EAAE,KAAK,CAAC,OAAO,CAAC;iBAC9C,CAAC;YACJ,KAAK,SAAS;gBACZ,OAAO;oBACL,MAAM,EAAE,IAAA,uBAAU,EAAC,IAAI,CAAC,KAAK,EAAE,EAAE,KAAK,CAAC,OAAO,CAAC;iBAChD,CAAC;YACJ,KAAK,UAAU;gBACb,OAAO;oBACL,MAAM,EAAE,IAAA,yBAAW,EAAC,IAAI,CAAC,KAAK,EAAE,EAAE,KAAK,CAAC,OAAO,CAAC;iBACjD,CAAC;YACJ,KAAK,MAAM;gBACT,OAAO;oBACL,MAAM,EAAE,IAAA,iBAAO,EAAC,IAAI,CAAC,KAAK,EAAE,EAAE,KAAK,CAAC,OAAO,CAAC;iBAC7C,CAAC;YACJ;gBACE,KAAK,CAAC,OAAuB,CAAC;gBAC9B,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IAEO,MAAM,CACZ,MAAc,EACd,QAAiB,EACjB,MAAM,GAAqC,SAAS;QAEpD,OAAO;YACL,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,IAAI;YACb,MAAM;YACN,IAAI,EAAE,IAAA,wBAAU,EACd,MAAM,EACN,QAAQ;gBACN,8DAA8D,CACjE;YACD,KAAK,EAAE,IAAA,yBAAW,EAChB,qFAAqF,CACtF;YACD,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAChD,CAAC;IACJ,CAAC;CACF"}
+{"version":3,"file":"TtscGraphApplication.js","sourceRoot":"","sources":["../src/TtscGraphApplication.ts"],"names":[],"mappings":";;;AACA,sDAA+D;AAC/D,oDAAiD;AACjD,4DAAyD;AACzD,kDAA+C;AAC/C,sDAAmD;AACnD,8CAA2C;AAC3C,gDAA6C;AAQ7C;;;;;;;;;;;;;;;GAeG;AACH;IACmB,KAAK,CAAmD;IAEzE,YAAmB,MAAuB;QACxC,IAAI,CAAC,KAAK,GAAG,OAAO,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC;IACpE,CAAC;IAEM,KAAK,CAAC,wBAAwB,CACnC,KAAmC;QAEnC,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACpC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YACjD,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;gBACzC,MAAM,CAAC,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC;YAC3C,CAAC;YACD,OAAO;gBACL,MAAM;aACP,CAAC;QACJ,CAAC;QACD,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;QACjC,QAAQ,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;YAC3B,KAAK,aAAa;gBAChB,OAAO;oBACL,MAAM,EAAE,IAAA,+BAAc,EAAC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC;iBAC7C,CAAC;YACJ,KAAK,QAAQ;gBACX,OAAO;oBACL,MAAM,EAAE,IAAA,qBAAS,EAAC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC;iBACxC,CAAC;YACJ,KAAK,OAAO;gBACV,OAAO;oBACL,MAAM,EAAE,IAAA,mBAAQ,EAAC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC;iBACvC,CAAC;YACJ,KAAK,SAAS;gBACZ,OAAO;oBACL,MAAM,EAAE,IAAA,uBAAU,EAAC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC;iBACzC,CAAC;YACJ,KAAK,UAAU;gBACb,OAAO;oBACL,MAAM,EAAE,IAAA,yBAAW,EAAC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC;iBAC1C,CAAC;YACJ,KAAK,MAAM;gBACT,OAAO;oBACL,MAAM,EAAE,IAAA,iBAAO,EAAC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC;iBACtC,CAAC;YACJ;gBACE,KAAK,CAAC,OAAuB,CAAC;gBAC9B,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IAEO,MAAM,CACZ,MAAc,EACd,QAAiB,EACjB,MAAM,GAAqC,SAAS;QAEpD,OAAO;YACL,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,IAAI;YACb,MAAM;YACN,IAAI,EAAE,IAAA,wBAAU,EACd,MAAM,EACN,QAAQ;gBACN,8DAA8D,CACjE;YACD,KAAK,EAAE,IAAA,yBAAW,EAChB,qFAAqF,CACtF;YACD,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAChD,CAAC;IACJ,CAAC;CACF"}

package/lib/index.d.ts

@@ -4,9 +4,9 @@
  * - `view`: JS-orchestrated 3D viewer (dump -> reduce -> serve -> open).
  * - `dump`: pass through to the native `ttscgraph dump`, which prints the whole
  *   graph as JSON for piping or the viewer.
- * - Default: serve the MCP graph over stdio. The TypeScript server runs
- *   `ttscgraph dump` once to build the resident graph, then answers tool calls
- *   from memory; the agent's MCP client speaks JSON-RPC over this process's
- *   stdin/stdout. The process stays alive on the stdio transport.
+ * - Default: serve the MCP graph over stdio. The TypeScript server keeps a native
+ *   incremental compiler session resident, checks the disk snapshot before each
+ *   graph operation, and reuses the in-memory graph when unchanged; the agent's
+ *   MCP client speaks JSON-RPC over this process's stdin/stdout.
  */
 export declare function runGraph(argv?: readonly string[]): number | void;

package/lib/index.js

@@ -40,10 +40,10 @@ function parseProjectArgs(argv) {
  * - `view`: JS-orchestrated 3D viewer (dump -> reduce -> serve -> open).
  * - `dump`: pass through to the native `ttscgraph dump`, which prints the whole
  *   graph as JSON for piping or the viewer.
- * - Default: serve the MCP graph over stdio. The TypeScript server runs
- *   `ttscgraph dump` once to build the resident graph, then answers tool calls
- *   from memory; the agent's MCP client speaks JSON-RPC over this process's
- *   stdin/stdout. The process stays alive on the stdio transport.
+ * - Default: serve the MCP graph over stdio. The TypeScript server keeps a native
+ *   incremental compiler session resident, checks the disk snapshot before each
+ *   graph operation, and reuses the in-memory graph when unchanged; the agent's
+ *   MCP client speaks JSON-RPC over this process's stdin/stdout.
  */
 function runGraph(argv = process.argv.slice(2)) {
     if (argv[0] === "view")

package/lib/model/TtscGraphSession.d.ts

@@ -0,0 +1,36 @@
+import { TtscGraphMemory } from "./TtscGraphMemory";
+/**
+ * Resident bridge to `ttscgraph serve`.
+ *
+ * Every graph request first asks the native session for the current disk
+ * snapshot. Unchanged requests reuse the existing {@link TtscGraphMemory}; an
+ * edited source reuses tsgo's resident Program through `driver.Session`, while
+ * config and root-file-set changes force a safe full reload.
+ */
+export declare class TtscGraphSession {
+    private readonly cwd;
+    private readonly tsconfig;
+    private readonly binary;
+    private child;
+    private stderr;
+    private nextId;
+    private readonly pending;
+    private queue;
+    private current;
+    private closed;
+    constructor(options: {
+        cwd: string;
+        tsconfig: string;
+        binary?: string;
+    });
+    /** Return a graph for the current disk snapshot, serialized per tool call. */
+    graph(): Promise<TtscGraphMemory>;
+    /** Close the native session. Safe to call more than once. */
+    close(): void;
+    private refresh;
+    private request;
+    private ensureChild;
+    private onLine;
+    private failChild;
+    private failPending;
+}