@ttsc/graph 0.31.5 → 0.32.0

package/lib/resolveGraphBinary.d.ts

@@ -1,35 +1,33 @@
 /**
- * Resolve the per-platform `ttscgraph` binary, or `null` when it cannot be
- * located.
+ * Resolve the `ttscgraph` binary this `@ttsc/graph` release spawns, or `null`
+ * when it cannot be located.
  *
- * `ttsc` is a peer dependency pinned to this package's own version, installed
- * alongside `@ttsc/graph` in the user's project rather than nested under this
- * launcher, so resolution starts from the user's project, not from this
- * package's own tree.
- *
- * The pin is what keeps the two halves of the graph in step. `literals` and the
- * rest of the node facts are resolved by the Go builder and ride the dump, so a
- * newer `@ttsc/graph` reading an older `ttscgraph` would find those fields
- * simply absent and answer from a graph missing facts it believes are there.
+ * The binary ships in `@ttsc/graph-<platform>-<arch>`, which `@ttsc/graph`
+ * lists as an exact-version optional dependency, so it is resolved from this
+ * package's own installation. The JavaScript client and the native producer
+ * therefore always come from one release, wherever the launcher was started.
+ * That pairing matters because node facts such as `literals` are resolved by
+ * the producer and ride the dump: a client reading an older producer would find
+ * those fields absent and answer from a graph missing facts it believes are
+ * there.
  *
  * Resolution order:
  *
  * 1. `TTSC_GRAPH_BINARY` env var, when set to an absolute path.
- * 2. The per-platform npm package `@ttsc/<platform>-<arch>/bin/ttscgraph[.exe]`.
- *    That package carries `ttsc`, `ttscserver`, and `ttscgraph` together and is
- *    an `optionalDependency` of `ttsc`, so it is resolved from `ttsc`'s
- *    location — found from `cwd`, the project the caller selected (via `--cwd`
- *    or an API `cwd` option), defaulting to `process.cwd()` when no project was
- *    named. A launcher started from an unrelated directory still resolves the
- *    `ttsc` installed under the target project it was asked to graph.
+ * 2. `@ttsc/graph-<platform>-<arch>/bin/ttscgraph[.exe]`, resolved from the
+ *    installed `@ttsc/graph` package.
+ *
+ * `cwd` is still accepted so existing callers keep compiling. It no longer
+ * affects resolution: the binary used to come from the target project's `ttsc`
+ * platform package, and now belongs to `@ttsc/graph` itself.
  *
- * @evidence contracts/common.md#principled-implementation Project-anchored module resolution locates the peer ttsc and then its platform binary; an explicit absolute override has precedence.
- * @evidence contracts/common.md#clear-and-simple-design One resolver owns override and peer-package lookup for all graph launchers.
- * @evidence contracts/common.md#prohibited-implementation-shortcuts Resolution uses installed package contracts rather than guessing binary paths from repository layouts.
- * @evidence contracts/common.md#meaningful-documentation Native paragraphs and the ordered list explain peer placement, override precedence and target-project anchoring.
- * @evidence contracts/portability.md#os-neutral-implementation Native path checks and module resolution select the platform/architecture package; only Windows's required executable suffix differs explicitly.
+ * @evidence contracts/common.md#principled-implementation The installed-package resolver locates the exact-version platform dependency from this module's own location; an explicit absolute override has precedence.
+ * @evidence contracts/common.md#clear-and-simple-design The public function delegates to the one resolver every launcher, loader and session uses, anchored at this package's installation.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts Resolution uses the installed package contract rather than repository layouts or the target project's packages.
+ * @evidence contracts/common.md#meaningful-documentation Native paragraphs and the ordered list explain package ownership, override precedence and the retained but ignored cwd argument.
+ * @evidence contracts/portability.md#os-neutral-implementation The delegated resolver selects the platform/architecture package through Node module resolution; only Windows's executable suffix differs.
  * @evidenceExclude contracts/performance.md#bound-retention-and-release-resources returns a path string and opens no handle.
- * @evidenceExclude contracts/performance.md#efficient-algorithms performs a constant number of module resolutions (ttsc, then its platform package).
+ * @evidenceExclude contracts/performance.md#efficient-algorithms performs at most one module resolution.
  * @evidenceExclude contracts/performance.md#reuse-equivalent-work resolves on every call and caches nothing, so a reinstall between calls is honored.
  */
 export declare function resolveGraphBinary(env?: NodeJS.ProcessEnv, cwd?: string): string | null;

package/lib/resolveGraphBinary.js

@@ -1,60 +1,41 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.resolveGraphBinary = resolveGraphBinary;
-const node_module_1 = require("node:module");
-const node_path_1 = __importDefault(require("node:path"));
+const InstalledGraphBinary_1 = require("./internal/InstalledGraphBinary");
 /**
- * Resolve the per-platform `ttscgraph` binary, or `null` when it cannot be
- * located.
+ * Resolve the `ttscgraph` binary this `@ttsc/graph` release spawns, or `null`
+ * when it cannot be located.
  *
- * `ttsc` is a peer dependency pinned to this package's own version, installed
- * alongside `@ttsc/graph` in the user's project rather than nested under this
- * launcher, so resolution starts from the user's project, not from this
- * package's own tree.
- *
- * The pin is what keeps the two halves of the graph in step. `literals` and the
- * rest of the node facts are resolved by the Go builder and ride the dump, so a
- * newer `@ttsc/graph` reading an older `ttscgraph` would find those fields
- * simply absent and answer from a graph missing facts it believes are there.
+ * The binary ships in `@ttsc/graph-<platform>-<arch>`, which `@ttsc/graph`
+ * lists as an exact-version optional dependency, so it is resolved from this
+ * package's own installation. The JavaScript client and the native producer
+ * therefore always come from one release, wherever the launcher was started.
+ * That pairing matters because node facts such as `literals` are resolved by
+ * the producer and ride the dump: a client reading an older producer would find
+ * those fields absent and answer from a graph missing facts it believes are
+ * there.
  *
  * Resolution order:
  *
  * 1. `TTSC_GRAPH_BINARY` env var, when set to an absolute path.
- * 2. The per-platform npm package `@ttsc/<platform>-<arch>/bin/ttscgraph[.exe]`.
- *    That package carries `ttsc`, `ttscserver`, and `ttscgraph` together and is
- *    an `optionalDependency` of `ttsc`, so it is resolved from `ttsc`'s
- *    location — found from `cwd`, the project the caller selected (via `--cwd`
- *    or an API `cwd` option), defaulting to `process.cwd()` when no project was
- *    named. A launcher started from an unrelated directory still resolves the
- *    `ttsc` installed under the target project it was asked to graph.
+ * 2. `@ttsc/graph-<platform>-<arch>/bin/ttscgraph[.exe]`, resolved from the
+ *    installed `@ttsc/graph` package.
+ *
+ * `cwd` is still accepted so existing callers keep compiling. It no longer
+ * affects resolution: the binary used to come from the target project's `ttsc`
+ * platform package, and now belongs to `@ttsc/graph` itself.
  *
- * @evidence contracts/common.md#principled-implementation Project-anchored module resolution locates the peer ttsc and then its platform binary; an explicit absolute override has precedence.
- * @evidence contracts/common.md#clear-and-simple-design One resolver owns override and peer-package lookup for all graph launchers.
- * @evidence contracts/common.md#prohibited-implementation-shortcuts Resolution uses installed package contracts rather than guessing binary paths from repository layouts.
- * @evidence contracts/common.md#meaningful-documentation Native paragraphs and the ordered list explain peer placement, override precedence and target-project anchoring.
- * @evidence contracts/portability.md#os-neutral-implementation Native path checks and module resolution select the platform/architecture package; only Windows's required executable suffix differs explicitly.
+ * @evidence contracts/common.md#principled-implementation The installed-package resolver locates the exact-version platform dependency from this module's own location; an explicit absolute override has precedence.
+ * @evidence contracts/common.md#clear-and-simple-design The public function delegates to the one resolver every launcher, loader and session uses, anchored at this package's installation.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts Resolution uses the installed package contract rather than repository layouts or the target project's packages.
+ * @evidence contracts/common.md#meaningful-documentation Native paragraphs and the ordered list explain package ownership, override precedence and the retained but ignored cwd argument.
+ * @evidence contracts/portability.md#os-neutral-implementation The delegated resolver selects the platform/architecture package through Node module resolution; only Windows's executable suffix differs.
  * @evidenceExclude contracts/performance.md#bound-retention-and-release-resources returns a path string and opens no handle.
- * @evidenceExclude contracts/performance.md#efficient-algorithms performs a constant number of module resolutions (ttsc, then its platform package).
+ * @evidenceExclude contracts/performance.md#efficient-algorithms performs at most one module resolution.
  * @evidenceExclude contracts/performance.md#reuse-equivalent-work resolves on every call and caches nothing, so a reinstall between calls is honored.
  */
-function resolveGraphBinary(env = process.env, cwd = process.cwd()) {
-    if (env.TTSC_GRAPH_BINARY && node_path_1.default.isAbsolute(env.TTSC_GRAPH_BINARY)) {
-        return env.TTSC_GRAPH_BINARY;
-    }
-    const exe = process.platform === "win32" ? "ttscgraph.exe" : "ttscgraph";
-    try {
-        // Anchor package lookup at the absolute project root so a relative `--cwd`
-        // resolves the same way the native process interprets it.
-        const fromProject = (0, node_module_1.createRequire)(node_path_1.default.join(node_path_1.default.resolve(cwd), "package.json"));
-        const ttscPackageJson = fromProject.resolve("ttsc/package.json");
-        const fromTtsc = (0, node_module_1.createRequire)(ttscPackageJson);
-        return fromTtsc.resolve(`@ttsc/${process.platform}-${process.arch}/bin/${exe}`);
-    }
-    catch {
-        return null;
-    }
+function resolveGraphBinary(env = process.env, cwd) {
+    void cwd;
+    return InstalledGraphBinary_1.InstalledGraphBinary.resolve(env, __filename);
 }
 //# sourceMappingURL=resolveGraphBinary.js.map

package/lib/resolveGraphBinary.js.map

@@ -1 +1 @@
-{"version":3,"file":"resolveGraphBinary.js","sourceRoot":"","sources":["../src/resolveGraphBinary.ts"],"names":[],"mappings":";;;;;;AAAA,6CAA4C;AAC5C,0DAA6B;AAE7B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,4BACE,GAAG,GAAsB,OAAO,CAAC,GAAG,EACpC,GAAG,GAAW,OAAO,CAAC,GAAG,EAAE;IAE3B,IAAI,GAAG,CAAC,iBAAiB,IAAI,mBAAI,CAAC,UAAU,CAAC,GAAG,CAAC,iBAAiB,CAAC,EAAE,CAAC;QACpE,OAAO,GAAG,CAAC,iBAAiB,CAAC;IAC/B,CAAC;IACD,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,WAAW,CAAC;IACzE,IAAI,CAAC;QACH,2EAA2E;QAC3E,0DAA0D;QAC1D,MAAM,WAAW,GAAG,IAAA,2BAAa,EAC/B,mBAAI,CAAC,IAAI,CAAC,mBAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,cAAc,CAAC,CAC7C,CAAC;QACF,MAAM,eAAe,GAAG,WAAW,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC;QACjE,MAAM,QAAQ,GAAG,IAAA,2BAAa,EAAC,eAAe,CAAC,CAAC;QAChD,OAAO,QAAQ,CAAC,OAAO,CACrB,SAAS,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,IAAI,QAAQ,GAAG,EAAE,CACvD,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}
+{"version":3,"file":"resolveGraphBinary.js","sourceRoot":"","sources":["../src/resolveGraphBinary.ts"],"names":[],"mappings":";;;AAAA,0EAAuE;AAEvE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,4BACE,GAAG,GAAsB,OAAO,CAAC,GAAG,EACpC,GAAY;IAEZ,KAAK,GAAG,CAAC;IACT,OAAO,2CAAoB,CAAC,OAAO,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;AACvD,CAAC"}

package/lib/runGraph.d.ts

@@ -13,7 +13,7 @@
  * @evidence contracts/common.md#clear-and-simple-design The launcher owns lane dispatch while viewer, server and native dump helpers own their respective execution boundaries.
  * @evidence contracts/common.md#prohibited-implementation-shortcuts A missing dump binary exposes only an explicitly qualified help summary; execution failures retain nonzero outcomes instead of fake graph answers.
  * @evidence contracts/common.md#meaningful-documentation Native lane bullets explain observable CLI behavior and resident refresh ownership with a blank line before tags.
- * @evidence contracts/portability.md#os-neutral-implementation Native lanes resolve the selected project's platform package and pass argv directly; stdio MCP uses Node transport APIs without shell path construction.
+ * @evidence contracts/portability.md#os-neutral-implementation Native lanes resolve this package's installed platform binary and pass argv directly; stdio MCP uses Node transport APIs without shell path construction.
  * @evidenceExclude contracts/performance.md#bound-retention-and-release-resources starts the stdio server (owned by startServer), runs a synchronous dump child to completion or hands over to runView, and keeps no handle itself.
  * @evidenceExclude contracts/performance.md#efficient-algorithms dispatches on the first argv token to one lane and the lanes own the work.
  * @evidenceExclude contracts/performance.md#reuse-equivalent-work runs one launcher lane per process invocation, so there is nothing to share.

package/lib/runGraph.js

@@ -26,7 +26,7 @@ const VERSION = require("../package.json")
  * @evidence contracts/common.md#clear-and-simple-design The launcher owns lane dispatch while viewer, server and native dump helpers own their respective execution boundaries.
  * @evidence contracts/common.md#prohibited-implementation-shortcuts A missing dump binary exposes only an explicitly qualified help summary; execution failures retain nonzero outcomes instead of fake graph answers.
  * @evidence contracts/common.md#meaningful-documentation Native lane bullets explain observable CLI behavior and resident refresh ownership with a blank line before tags.
- * @evidence contracts/portability.md#os-neutral-implementation Native lanes resolve the selected project's platform package and pass argv directly; stdio MCP uses Node transport APIs without shell path construction.
+ * @evidence contracts/portability.md#os-neutral-implementation Native lanes resolve this package's installed platform binary and pass argv directly; stdio MCP uses Node transport APIs without shell path construction.
  * @evidenceExclude contracts/performance.md#bound-retention-and-release-resources starts the stdio server (owned by startServer), runs a synchronous dump child to completion or hands over to runView, and keeps no handle itself.
  * @evidenceExclude contracts/performance.md#efficient-algorithms dispatches on the first argv token to one lane and the lanes own the work.
  * @evidenceExclude contracts/performance.md#reuse-equivalent-work runs one launcher lane per process invocation, so there is nothing to share.
@@ -47,10 +47,10 @@ function runGraph(argv = process.argv.slice(2)) {
  * on this process's stdout. Returns the child's exit code.
  */
 function runDump(argv) {
-    // Resolve the native binary from the target project the caller named with
-    // `--cwd`, not from wherever the launcher process happened to start.
+    // The producer belongs to this package's installation; `--cwd` only selects
+    // the project the native process graphs.
     const { cwd, tsconfig, artifactsSpecified } = TtscGraphLauncherArguments_1.TtscGraphLauncherArguments.dump(argv);
-    const binary = (0, resolveGraphBinary_1.resolveGraphBinary)(process.env, cwd);
+    const binary = (0, resolveGraphBinary_1.resolveGraphBinary)(process.env);
     if (binary === null) {
         // `ttscgraph` owns the flag contract, so a resolvable binary always answers
         // `--help` itself and stays the single source of truth. It cannot answer

package/lib/runGraph.js.map

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

package/lib/view.js

@@ -10,6 +10,7 @@ const node_path_1 = __importDefault(require("node:path"));
 const TtscGraphLauncherArguments_1 = require("./TtscGraphLauncherArguments");
 const TtscGraphViewSnapshot_1 = require("./TtscGraphViewSnapshot");
 const GraphProcessTrace_1 = require("./internal/GraphProcessTrace");
+const InstalledGraphBinary_1 = require("./internal/InstalledGraphBinary");
 const publishedArtifacts_1 = require("./model/publishedArtifacts");
 const nativeExecutable_1 = require("./nativeExecutable");
 const reduce_1 = require("./reduce");
@@ -31,13 +32,11 @@ const resolveGraphBinary_1 = require("./resolveGraphBinary");
  */
 function runView(argv) {
     const opts = TtscGraphLauncherArguments_1.TtscGraphLauncherArguments.view(argv);
-    // Anchor binary resolution at the project selected by `--cwd`, so `view` from
-    // an unrelated directory still finds the `ttsc` installed under the target.
-    const binary = (0, resolveGraphBinary_1.resolveGraphBinary)(process.env, opts.cwd);
+    // The producer belongs to this package's installation; `--cwd` only selects
+    // the project the native process graphs.
+    const binary = (0, resolveGraphBinary_1.resolveGraphBinary)(process.env);
     if (binary === null) {
-        process.stderr.write("@ttsc/graph: could not resolve the ttscgraph binary. " +
-            "Install `ttsc` so its platform package is present, " +
-            "or set TTSC_GRAPH_BINARY to an absolute path.\n");
+        process.stderr.write(`${InstalledGraphBinary_1.InstalledGraphBinary.missingMessage()}\n`);
         return 1;
     }
     (0, nativeExecutable_1.ensureExecutable)(binary);

package/lib/view.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ttsc/graph",
-  "version": "0.31.5",
+  "version": "0.32.0",
   "description": "Checker-resolved architecture graph over MCP for coding agents, backed by ttsc's in-process TypeScript-Go compiler.",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
@@ -20,7 +20,16 @@
     "typia": "^15.1.0"
   },
   "peerDependencies": {
-    "ttsc": "^0.31.5"
+    "ttsc": "^0.32.0"
+  },
+  "optionalDependencies": {
+    "@ttsc/graph-linux-x64": "0.32.0",
+    "@ttsc/graph-linux-arm": "0.32.0",
+    "@ttsc/graph-linux-arm64": "0.32.0",
+    "@ttsc/graph-darwin-x64": "0.32.0",
+    "@ttsc/graph-darwin-arm64": "0.32.0",
+    "@ttsc/graph-win32-x64": "0.32.0",
+    "@ttsc/graph-win32-arm64": "0.32.0"
   },
   "keywords": [
     "ttsc",
@@ -35,7 +44,7 @@
     "src"
   ],
   "devDependencies": {
-    "@wrtnlabs/evidence": "^0.3.1",
+    "@wrtnlabs/evidence": "^0.5.0",
     "@types/node": "^25.3.0",
     "@types/three": "^0.184.1",
     "esbuild": "^0.25.12",
@@ -43,7 +52,7 @@
     "three": "^0.184.0",
     "three-forcegraph": "^1.43.4",
     "typescript": "^7.0.2",
-    "ttsc": "0.31.5"
+    "ttsc": "0.32.0"
   },
   "repository": {
     "type": "git",

package/src/TtscGraphLauncherArguments.ts

@@ -1,4 +1,5 @@
 import type { IProjectOptions } from "./IProjectOptions";
+import { InstalledGraphBinary } from "./internal/InstalledGraphBinary";
 import {
   PROJECT_OPTIONS,
   nonNegativeIntegerOption,
@@ -162,13 +163,7 @@ export namespace TtscGraphLauncherArguments {
   } {
     if (argv.some((argument) => DUMP_HELP_FLAGS.has(argument)))
       return { code: 0, stdout: DUMP_HELP_SUMMARY };
-    return {
-      code: 1,
-      stderr:
-        "@ttsc/graph: could not resolve the ttscgraph binary. " +
-        "Install `ttsc` so its platform package is present, " +
-        "or set TTSC_GRAPH_BINARY to an absolute path.\n",
-    };
+    return { code: 1, stderr: `${InstalledGraphBinary.missingMessage()}\n` };
   }
 }
 
@@ -202,6 +197,7 @@ const DUMP_HELP_SUMMARY = [
   "  --pretty           Indent the JSON output.",
   "",
   "The native `ttscgraph` binary owns these flags and is not installed here,",
-  "so this summary may lag it. Install `ttsc` and rerun for the exact list.",
+  "so this summary may lag it. Install @ttsc/graph with its optional",
+  "dependencies and rerun for the exact list.",
   "",
 ].join("\n");

package/src/internal/InstalledGraphBinary.ts

@@ -0,0 +1,102 @@
+import { createRequire } from "node:module";
+import path from "node:path";
+
+/**
+ * The native `ttscgraph` producer installed with this `@ttsc/graph` release.
+ *
+ * `@ttsc/graph` lists one `@ttsc/graph-<platform>-<arch>` package per supported
+ * target as an exact-version optional dependency. The producer is therefore
+ * resolved from `@ttsc/graph`'s own installation, not from the project being
+ * graphed: the JavaScript client and its native producer always come from one
+ * release, and the directory a launcher starts in does not affect which binary
+ * runs.
+ *
+ * @evidence contracts/common.md#principled-implementation Node module resolution from a file inside the installed package finds the optional platform dependency wherever the package manager placed it; an explicit absolute override keeps precedence.
+ * @evidence contracts/common.md#clear-and-simple-design One owner holds the resolution order and the two remedies every launcher, loader and session reports, so their wording cannot drift.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts Resolution uses the installed package contract rather than repository layouts, the target project's packages or guessed paths.
+ * @evidence contracts/common.md#meaningful-documentation Native paragraphs explain why the producer belongs to this package and what the anchor means.
+ * @evidence contracts/portability.md#os-neutral-implementation The platform and architecture name the package and Windows alone adds the executable suffix; Node module resolution handles symlinked and hoisted layouts on every host.
+ * @evidenceExclude contracts/performance.md#bound-retention-and-release-resources Resolution returns a path string and opens no handle.
+ * @evidenceExclude contracts/performance.md#efficient-algorithms Each member performs at most one module resolution or builds one string.
+ * @evidenceExclude contracts/performance.md#reuse-equivalent-work Resolution runs once per launch and caches nothing, so a reinstall between launches is honored.
+ */
+export namespace InstalledGraphBinary {
+  /**
+   * Resolve the producer, or `null` when nothing supplies one.
+   *
+   * 1. `TTSC_GRAPH_BINARY` when it is an absolute path. It is returned without a
+   *    filesystem probe, so the spawn owns its executable error; a relative
+   *    value is ignored.
+   * 2. `@ttsc/graph-<platform>-<arch>/bin/ttscgraph[.exe]`, resolved by Node
+   *    module resolution from `anchor`, a file inside the installed
+   *    `@ttsc/graph` package.
+   *
+   * @evidence contracts/common.md#principled-implementation An absolute override is honored before module resolution walks up from the anchor to the package manager's placement of the platform dependency.
+   * @evidence contracts/common.md#clear-and-simple-design The function owns precedence and lookup; callers own the failure presentation through the shared remedies.
+   * @evidence contracts/common.md#prohibited-implementation-shortcuts A missing package resolves to null instead of a guessed path, and the override is not probed on the caller's behalf.
+   * @evidence contracts/common.md#meaningful-documentation The numbered list states the precedence, the anchor's meaning and the unprobed override.
+   * @evidence contracts/portability.md#os-neutral-implementation path.isAbsolute applies the host's absolute-path rule, and the package and executable names come from process.platform and process.arch.
+   * @evidenceExclude contracts/performance.md#bound-retention-and-release-resources Returns a path string and opens no handle.
+   * @evidenceExclude contracts/performance.md#efficient-algorithms Performs at most one module resolution.
+   * @evidenceExclude contracts/performance.md#reuse-equivalent-work Resolves on every call so a reinstall is honored.
+   */
+  export function resolve(
+    env: NodeJS.ProcessEnv,
+    anchor: string,
+  ): string | null {
+    const override = env.TTSC_GRAPH_BINARY;
+    if (override && path.isAbsolute(override)) return override;
+    try {
+      return createRequire(anchor).resolve(
+        `${packageName()}/bin/${process.platform === "win32" ? "ttscgraph.exe" : "ttscgraph"}`,
+      );
+    } catch {
+      return null;
+    }
+  }
+
+  /**
+   * The platform package this process's target selects.
+   *
+   * @evidence contracts/common.md#principled-implementation The npm platform and architecture strings are the package name's only variable parts.
+   * @evidence contracts/common.md#clear-and-simple-design Resolution and the missing-package diagnostic share this one name.
+   * @evidence contracts/common.md#prohibited-implementation-shortcuts No platform table or alias substitutes for the actual target names.
+   * @evidence contracts/common.md#meaningful-documentation The native headline states what the name selects.
+   * @evidence contracts/portability.md#os-neutral-implementation process.platform and process.arch already carry npm's os and cpu spellings, which the platform manifests declare.
+   * @evidenceExclude contracts/performance.md#bound-retention-and-release-resources Builds a string and holds nothing.
+   * @evidenceExclude contracts/performance.md#efficient-algorithms Concatenates two process properties.
+   * @evidenceExclude contracts/performance.md#reuse-equivalent-work A constant-time string needs no sharing.
+   */
+  export function packageName(): string {
+    return `@ttsc/graph-${process.platform}-${process.arch}`;
+  }
+
+  /**
+   * The diagnostic a launcher, loader or session reports when resolution fails.
+   *
+   * @evidence contracts/common.md#principled-implementation The remedy names the actual package that resolution looked for and the override that bypasses it.
+   * @evidence contracts/common.md#clear-and-simple-design Every failing entry point reports this one text.
+   * @evidence contracts/common.md#prohibited-implementation-shortcuts The text describes the real installation contract rather than a repository path.
+   * @evidence contracts/common.md#meaningful-documentation The native headline states when the diagnostic applies.
+   * @evidenceExclude contracts/portability.md#os-neutral-implementation Builds a message; the package name carries the only platform-dependent part.
+   * @evidenceExclude contracts/performance.md#bound-retention-and-release-resources Builds a string and holds nothing.
+   * @evidenceExclude contracts/performance.md#efficient-algorithms Concatenates constant text with the package name.
+   * @evidenceExclude contracts/performance.md#reuse-equivalent-work Called once per failed resolution.
+   */
+  export function missingMessage(): string {
+    return (
+      "@ttsc/graph: could not resolve the ttscgraph binary. " +
+      `Install @ttsc/graph with its optional dependencies so ${packageName()} is present, ` +
+      "or set TTSC_GRAPH_BINARY to an absolute path."
+    );
+  }
+
+  /**
+   * The remedy appended to a serve-protocol or dump-schema mismatch. The
+   * installed platform package always matches its `@ttsc/graph` release, so a
+   * mismatch means a stale installation or an override naming another build.
+   */
+  export const MISMATCH_REMEDY =
+    "Reinstall @ttsc/graph so its platform package matches this client, " +
+    "or point TTSC_GRAPH_BINARY at a matching ttscgraph.";
+}

package/src/model/TtscGraphProjection.ts

@@ -351,22 +351,24 @@ function synthesize(
   // small — the two copies are 17% of the document, 55 MB of VS Code's 323 MB,
   // paid again in the encode, the pipe, the parse and the validation. Nothing
   // downstream of this line sees a span without its file.
-  const nodes: SynthesizedNode[] = dump.nodes.flatMap((n): SynthesizedNode[] => {
-    if (n.kind === "module") return [];
-    const { evidence, implementation, ...rest } = n;
-    return [
-      {
-        ...rest,
-        kind: n.kind,
-        ...(evidence !== undefined
-          ? { evidence: spanIn(evidence, n.file) }
-          : {}),
-        ...(implementation !== undefined
-          ? { implementation: spanIn(implementation, n.file) }
-          : {}),
-      },
-    ];
-  });
+  const nodes: SynthesizedNode[] = dump.nodes.flatMap(
+    (n): SynthesizedNode[] => {
+      if (n.kind === "module") return [];
+      const { evidence, implementation, ...rest } = n;
+      return [
+        {
+          ...rest,
+          kind: n.kind,
+          ...(evidence !== undefined
+            ? { evidence: spanIn(evidence, n.file) }
+            : {}),
+          ...(implementation !== undefined
+            ? { implementation: spanIn(implementation, n.file) }
+            : {}),
+        },
+      ];
+    },
+  );
   const edges: TtscGraphReadonly<ITtscGraphEdge>[] = dump.edges.map((edge) => {
     const { evidence, ...rest } = edge;
     const from = moduleIds.get(edge.from);

package/src/model/TtscGraphProtocol.ts

@@ -1,5 +1,6 @@
 import typia from "typia";
 
+import { InstalledGraphBinary } from "../internal/InstalledGraphBinary";
 import { ITtscGraphSnapshot } from "../structures/ITtscGraphSnapshot";
 
 /**
@@ -63,8 +64,7 @@ export namespace TtscGraphProtocol {
         `@ttsc/graph: ttscgraph speaks serve protocol ${
           version === undefined ? "an unknown version" : `v${String(version)}`
         }, this client speaks v${String(PROTOCOL_VERSION)}. ` +
-          "Install a matching `ttsc` (the binary resolves from the target " +
-          "project, or from TTSC_GRAPH_BINARY).",
+          InstalledGraphBinary.MISMATCH_REMEDY,
       );
     }
 

package/src/model/TtscGraphSession.ts

@@ -1,5 +1,6 @@
 import { CapabilityPluginResolver } from "ttsc";
 
+import { InstalledGraphBinary } from "../internal/InstalledGraphBinary";
 import { ensureExecutable } from "../nativeExecutable";
 import { resolveGraphBinary } from "../resolveGraphBinary";
 import type { IPublishedArtifactsResident } from "./IPublishedArtifactsResident";
@@ -70,18 +71,10 @@ export class TtscGraphSession {
   private readonly retiredDaemons = new Set<Promise<void>>();
 
   public constructor(options: TtscGraphSessionOptions) {
-    // Resolve the platform binary from the project this session serves, so the
-    // MCP server started from an unrelated directory still finds the target's
-    // installed `ttsc`.
-    const binary =
-      options.binary ?? resolveGraphBinary(process.env, options.cwd);
-    if (binary === null) {
-      throw new Error(
-        "@ttsc/graph: could not resolve the ttscgraph binary. " +
-          "Install `ttsc` so its platform package is present, " +
-          "or set TTSC_GRAPH_BINARY to an absolute path.",
-      );
-    }
+    // The producer belongs to this package's installation, so an MCP server
+    // started from any directory spawns the binary of its own release.
+    const binary = options.binary ?? resolveGraphBinary(process.env);
+    if (binary === null) throw new Error(InstalledGraphBinary.missingMessage());
     ensureExecutable(binary);
     this.cwd = options.cwd;
     this.tsconfig = options.tsconfig;

package/src/model/TtscGraphSessionOptions.ts

@@ -17,6 +17,9 @@ export interface TtscGraphSessionOptions {
   /** Project tsconfig passed to `ttscgraph serve`. */
   tsconfig: string;
 
-  /** Absolute native binary path, resolved from `cwd` when omitted. */
+  /**
+   * Absolute native binary path; omitted, the installed
+   * `@ttsc/graph-<platform>-<arch>` binary runs.
+   */
   binary?: string;
 }

package/src/model/TtscGraphSessionState.ts

@@ -1,3 +1,4 @@
+import { InstalledGraphBinary } from "../internal/InstalledGraphBinary";
 import { ITtscGraphSnapshot } from "../structures/ITtscGraphSnapshot";
 import { TtscGraphLinePeer } from "./TtscGraphLinePeer";
 import { TtscGraphMemory } from "./TtscGraphMemory";
@@ -385,8 +386,7 @@ export class TtscGraphSessionState {
             response.dump?.provenance.schemaVersion ??
               response.snapshot?.schemaVersion,
           )}, this client reads v${String(DUMP_SCHEMA_VERSION)}. ` +
-            "Install a matching `ttsc` (the binary resolves from the target " +
-            "project, or from TTSC_GRAPH_BINARY).",
+            InstalledGraphBinary.MISMATCH_REMEDY,
         ),
       );
       return;