@remnic/core 9.3.670 → 9.3.672

package/dist/coding/optional-coding-graph.js

@@ -0,0 +1,119 @@
+import {
+  CODING_GRAPH_ENGINE_VERSION,
+  TIER_1_LANGUAGES
+} from "../chunk-52LZ42LI.js";
+import "../chunk-PZ5AY32C.js";
+
+// src/coding/optional-coding-graph.ts
+var SPECIFIER = "@remnic/coding-graph";
+function buildCodingGraphInstallHint() {
+  return "The `@remnic/coding-graph` engine is optional and not installed in this environment.\n\nInstall it alongside @remnic/core to enable codebase-graph features:\n  npm install @remnic/coding-graph\n\nOr add it to a project (pnpm / yarn):\n  pnpm add @remnic/coding-graph\n  yarn add @remnic/coding-graph\n";
+}
+function notInstalledError() {
+  return new Error(buildCodingGraphInstallHint());
+}
+function incompatibleModuleError(actual) {
+  const keys = actual && typeof actual === "object" ? Object.keys(actual).slice(0, 8).join(", ") || "(none)" : typeof actual;
+  return new Error(
+    `\`@remnic/coding-graph\` is present but its module shape does not match the expected contract. The installed build may be stale, broken, or from an incompatible version. Try reinstalling it (\`npm install --force @remnic/coding-graph\`) or pinning to a known working version. Detected exports: ${keys}.`
+  );
+}
+function isSpecifierNotFoundErrorForCodingGraph(err, specifier = SPECIFIER) {
+  if (!err || typeof err !== "object") {
+    return false;
+  }
+  const code = err.code;
+  if (code !== "ERR_MODULE_NOT_FOUND" && code !== "MODULE_NOT_FOUND") {
+    return false;
+  }
+  const message = err.message;
+  if (typeof message !== "string") {
+    return false;
+  }
+  if (message.includes(`'${specifier}'`)) return true;
+  if (message.includes(`"${specifier}"`)) return true;
+  const escaped = specifier.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  const boundaryRegex = new RegExp(
+    `(?:^|[\\s"'\`\\(])${escaped}(?:[\\s"'\`\\)]|$)`
+  );
+  return boundaryRegex.test(message);
+}
+function isLoadedCodingGraphModule(value) {
+  if (!value || typeof value !== "object") return false;
+  const candidate = value;
+  return typeof candidate.createCodingGraphEngine === "function" && typeof candidate.CodingGraphError === "function" && typeof candidate.ENGINE_VERSION === "string" && Array.isArray(candidate.TIER_1_LANGUAGES);
+}
+async function tryImportCodingGraphModule() {
+  let mod;
+  try {
+    mod = await import(SPECIFIER);
+  } catch (err) {
+    if (isSpecifierNotFoundErrorForCodingGraph(err)) {
+      return { kind: "missing" };
+    }
+    return { kind: "broken", cause: err };
+  }
+  if (!isLoadedCodingGraphModule(mod)) {
+    return { kind: "incompatible", actual: mod };
+  }
+  return { kind: "ok", module: mod };
+}
+async function loadCodingGraphEngineFactory() {
+  if (cachedLoadResult !== void 0 && cachedLoadResult !== null) {
+    return cachedLoadResult.createCodingGraphEngine;
+  }
+  const outcome = await tryImportCodingGraphModule();
+  switch (outcome.kind) {
+    case "ok":
+      cachedLoadResult = outcome.module;
+      return outcome.module.createCodingGraphEngine;
+    case "missing":
+      throw notInstalledError();
+    case "incompatible":
+      throw incompatibleModuleError(outcome.actual);
+    case "broken":
+      throw outcome.cause instanceof Error ? outcome.cause : new Error(`@remnic/coding-graph failed to load: ${String(outcome.cause)}`);
+  }
+}
+function startProbeOnce() {
+  if (inFlightProbe !== null) {
+    return inFlightProbe;
+  }
+  const p = tryImportCodingGraphModule().then((outcome) => {
+    if (outcome.kind === "ok") {
+      cachedLoadResult = outcome.module;
+      return outcome.module;
+    }
+    return null;
+  }).catch(() => {
+    return null;
+  });
+  inFlightProbe = p;
+  p.finally(() => {
+    if (inFlightProbe === p) {
+      inFlightProbe = null;
+    }
+  });
+  return p;
+}
+var cachedLoadResult;
+var inFlightProbe = null;
+async function isCodingGraphInstalled() {
+  return await tryLoadCodingGraphModule() !== null;
+}
+async function tryLoadCodingGraphModule() {
+  if (cachedLoadResult !== void 0 && cachedLoadResult !== null) {
+    return cachedLoadResult;
+  }
+  return startProbeOnce();
+}
+export {
+  CODING_GRAPH_ENGINE_VERSION,
+  TIER_1_LANGUAGES,
+  buildCodingGraphInstallHint,
+  isCodingGraphInstalled,
+  isSpecifierNotFoundErrorForCodingGraph,
+  loadCodingGraphEngineFactory,
+  tryLoadCodingGraphModule
+};
+//# sourceMappingURL=optional-coding-graph.js.map

package/dist/coding/optional-coding-graph.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/coding/optional-coding-graph.ts"],"sourcesContent":["// Lazy loader for the optional @remnic/coding-graph package.\n//\n// Remnic's core is installed à-la-carte: users who only need memory\n// features should not have to install codebase-graph tooling, so\n// @remnic/coding-graph is an optional peer dependency, not a bundled\n// dependency. Any code path that actually needs the graph engine calls\n// loadCodingGraphEngineFactory() or one of the try* helpers; the loader\n// either returns the engine factory or throws a user-facing install hint.\n//\n// Justification for the dynamic import:\n//   CLAUDE.md rule 57 / AGENTS.md rule 44 require à-la-carte optional\n//   workspace packages to be loaded via a *computed-specifier* dynamic\n//   import. Static `import \"@remnic/coding-graph\"` would either fail the\n//   base install when the optional package is absent or — worse — force\n//   the bundler to bundle it into @remnic/core's dist. Concat'ing the\n//   specifier from string literals keeps the dynamic import a runtime\n//   call. The same pattern is canonical in\n//   packages/remnic-cli/src/optional-bench.ts and\n//   packages/remnic-cli/src/optional-module-loader.ts; we mirror it here\n//   because core, not the CLI, owns the engine entry point.\n//\n// Type-source direction:\n//   The CodingGraphEngine interface and supporting IR types live in\n//   packages/remnic-core/src/coding/coding-graph-types.ts (a local\n//   types-only module). They are owned by core; @remnic/coding-graph\n//   imports them and implements against them. This breaks the type\n//   cycle that would otherwise require core to resolve\n//   @remnic/coding-graph at compile time. Core's tsup DTS phase emits\n//   declarations against the package's compiled output — this would\n//   fail in CI's fresh base install where the optional peer is not\n//   symlinked. With the types owned locally, the loader types its\n//   dynamic-import result through the local shape (validated at runtime\n//   via a structural check, not via TS) so the base install compiles.\n//\n// Failure-mode policy:\n//   - Missing optional package → install hint (loadCodingGraphEngineFactory\n//     throws the canonical user-facing message).\n//   - Present-but-mismatched install (the optional package resolves to a\n//     module that does not satisfy the structural contract) →\n//     `module_load_failed` Error on the loadFactory path; probe paths\n//     return null with no throw (graceful degradation). User sees a\n//     real diagnostic telling them the install is broken — NOT the\n//     \"npm install @remnic/coding-graph\" install hint, which would\n//     mislead users into re-installing a package that is already there.\n//   - Present-but-broken install (transitive dep missing, loader\n//     fault, etc.) → underlying import error is rethrown on the\n//     loadFactory path; probe paths swallow and return null.\n//   - Three separate cache slots, kept strictly disjoint:\n//     (a) `cachedLoadResult` — successful-module cache, read by both\n//         loadFactory and tryLoad. Never populated on missing or\n//         broken installs (preserves the \"users see the real\n//         diagnostic\" invariant).\n//     (b) `inFlightProbe` — in-flight promise slot shared by concurrent\n//         probe callers; cleared once settled.\n//     (c) (No \"absent result\" cache.) loadFactory ALWAYS attempts a\n//         fresh import on a fresh call — never serves a stale\n//         decision from a previous attempt.\n\nimport {\n  CODING_GRAPH_ENGINE_VERSION,\n  TIER_1_LANGUAGES,\n  type CodingGraphEngine,\n  type CodingGraphErrorCode,\n  type CodingGraphLanguage,\n  type CreateCodingGraphEngineOptions,\n  type FileIR,\n  type ParseFileInput,\n  type ParseResult,\n  type SymbolIR,\n} from \"./coding-graph-types.js\";\n\nconst SPECIFIER = \"@remnic/\" + \"coding-graph\";\n\n/**\n * Structural minimal shape of `@remnic/coding-graph`'s public surface,\n * as seen by core after a successful dynamic import. We narrow to\n * `unknown` first (since the dynamic import returns `any` at runtime)\n * and then to this interface only after the runtime check below.\n */\ninterface LoadedCodingGraphModule {\n  ENGINE_VERSION: string;\n  TIER_1_LANGUAGES: readonly CodingGraphLanguage[];\n  CodingGraphError: new (\n    code: CodingGraphErrorCode,\n    message: string,\n    engineVersion?: string,\n  ) => Error;\n  createCodingGraphEngine: (\n    options?: CreateCodingGraphEngineOptions,\n  ) => CodingGraphEngine;\n}\n\n/**\n * Outcome of a single import attempt. The probe path collapses\n * \"missing\" and \"incompatible\" into `null` (graceful degradation);\n * the loader path distinguishes the two so users get an accurate\n * diagnostic instead of a misleading install hint on a broken install.\n */\ntype ImportAttemptOutcome =\n  | { readonly kind: \"ok\"; readonly module: LoadedCodingGraphModule }\n  | { readonly kind: \"missing\" }\n  | { readonly kind: \"incompatible\"; readonly actual: unknown }\n  | { readonly kind: \"broken\"; readonly cause: unknown };\n\n/**\n * Build the user-facing install hint message. Exported so tests can assert\n * on the exact text (CLAUDE.md rule 51 / issue #1551 prove-fail-before).\n */\nexport function buildCodingGraphInstallHint(): string {\n  return (\n    \"The `@remnic/coding-graph` engine is optional and not installed in this environment.\\n\" +\n    \"\\n\" +\n    \"Install it alongside @remnic/core to enable codebase-graph features:\\n\" +\n    \"  npm install @remnic/coding-graph\\n\" +\n    \"\\n\" +\n    \"Or add it to a project (pnpm / yarn):\\n\" +\n    \"  pnpm add @remnic/coding-graph\\n\" +\n    \"  yarn add @remnic/coding-graph\\n\"\n  );\n}\n\nfunction notInstalledError(): Error {\n  return new Error(buildCodingGraphInstallHint());\n}\n\n/**\n * Build the present-but-incompatible diagnostic. The user has the\n * package installed but it does not satisfy the structural contract;\n * \"npm install @remnic/coding-graph\" would NOT help them (the package\n * is already there). Tell them to reinstall or open an issue.\n */\nfunction incompatibleModuleError(actual: unknown): Error {\n  const keys =\n    actual && typeof actual === \"object\"\n      ? Object.keys(actual).slice(0, 8).join(\", \") || \"(none)\"\n      : typeof actual;\n  return new Error(\n    \"`@remnic/coding-graph` is present but its module shape does not match \" +\n      \"the expected contract. The installed build may be stale, broken, or \" +\n      \"from an incompatible version. Try reinstalling it \" +\n      \"(`npm install --force @remnic/coding-graph`) or pinning to a known \" +\n      `working version. Detected exports: ${keys}.`,\n  );\n}\n\n/**\n * Return true when `err` is a module-not-found failure for exactly the\n * `@remnic/coding-graph` specifier. Same boundary-aware regex as\n * packages/remnic-cli/src/optional-module-loader.ts so transitive\n * misses (a broken @remnic/coding-graph release) bubble up rather than\n * being mis-reported as \"run npm install\".\n *\n * Exported for tests; the production loaders call the internal alias\n * below.\n */\nexport function isSpecifierNotFoundErrorForCodingGraph(\n  err: unknown,\n  specifier: string = SPECIFIER,\n): boolean {\n  if (!err || typeof err !== \"object\") {\n    return false;\n  }\n  const code = (err as { code?: unknown }).code;\n  if (code !== \"ERR_MODULE_NOT_FOUND\" && code !== \"MODULE_NOT_FOUND\") {\n    return false;\n  }\n  const message = (err as { message?: unknown }).message;\n  if (typeof message !== \"string\") {\n    return false;\n  }\n  if (message.includes(`'${specifier}'`)) return true;\n  if (message.includes(`\"${specifier}\"`)) return true;\n  // Boundary guard so \"@remnic/coding-graph\" does not match\n  // \"@remnic/coding-graph-foo\".\n  const escaped = specifier.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\n  const boundaryRegex = new RegExp(\n    `(?:^|[\\\\s\"'\\`\\\\(])${escaped}(?:[\\\\s\"'\\`\\\\)]|$)`,\n  );\n  return boundaryRegex.test(message);\n}\n\n/**\n * Narrow a dynamic import result to the local LoadedCodingGraphModule\n * shape via a runtime structural check (never inline-as casting).\n * The cast-through-unknown double-step satisfies the rule that\n * \"unchecked casts\" must be justified; here the check is the runtime\n * predicate below.\n */\nfunction isLoadedCodingGraphModule(value: unknown): value is LoadedCodingGraphModule {\n  if (!value || typeof value !== \"object\") return false;\n  const candidate = value as Record<string, unknown>;\n  return (\n    typeof candidate.createCodingGraphEngine === \"function\" &&\n    typeof candidate.CodingGraphError === \"function\" &&\n    typeof candidate.ENGINE_VERSION === \"string\" &&\n    Array.isArray(candidate.TIER_1_LANGUAGES)\n  );\n}\n\n/**\n * Single import attempt. Returns a tagged-outcome object so callers\n * can distinguish \"not installed\" from \"incompatible build\" from\n * \"broken transitive dep\" — each gets its own diagnostic on the\n * user-facing path.\n *\n * Never reads from any cache; the calling function decides whether\n * to consult the success cache first.\n */\nasync function tryImportCodingGraphModule(): Promise<ImportAttemptOutcome> {\n  // The dynamic `import()` with a runtime-concatenated specifier is the\n  // documented à-la-carte loader pattern. See file header.\n  let mod: unknown;\n  try {\n    // Cast through `unknown` is justified here: the dynamic import below\n    // is the LOADING BOUNDARY between core (no compile-time dependency on\n    // @remnic/coding-graph by design — see file header) and the optional\n    // package whose shape we have documented locally. We validate the\n    // structural shape before using any of the cast fields, so the cast\n    // asserts the boundary, not specific fields.\n    mod = (await import(SPECIFIER)) as unknown;\n  } catch (err) {\n    if (isSpecifierNotFoundErrorForCodingGraph(err)) {\n      return { kind: \"missing\" };\n    }\n    // Non-specifier error (broken transitive dep, loader fault, etc.)\n    // is wrapped so the loader can surface the diagnostic on a fresh\n    // attempt and the probe path can still swallow.\n    return { kind: \"broken\", cause: err };\n  }\n  if (!isLoadedCodingGraphModule(mod)) {\n    return { kind: \"incompatible\", actual: mod };\n  }\n  return { kind: \"ok\", module: mod };\n}\n\n/**\n * Load `@remnic/coding-graph` if installed and return its\n * `createCodingGraphEngine` factory. Throws a user-facing diagnostic\n * that distinguishes three failure modes:\n *   - missing    → install hint (canonical \"npm install ...\" message).\n *   - incompatible → \"package shape mismatch\" diagnostic.\n *   - broken     → rethrows the original import error.\n *\n * Reuses the cached success path so repeated calls in the same\n * process do not re-import. On success the resolved module is cached\n * and shared with the try* helpers; a failure never poisons the cache\n * so each call attempts a fresh import.\n */\nexport async function loadCodingGraphEngineFactory(): Promise<\n  (options?: CreateCodingGraphEngineOptions) => CodingGraphEngine\n> {\n  // Fast path: a previous successful load populated cachedLoadResult.\n  // Reading it here matches the CLI `loadBenchModule` pattern and the\n  // probe path's convention of sharing the success result (Cursor\n  // Bugbot P3 round 5: \"Loader skips success cache\"). The fast path is\n  // intentionally read-only — we never write the success cache from\n  // the probe or fail-fast paths, so a probe that returned null cannot\n  // convert into a stale loader result here.\n  if (cachedLoadResult !== undefined && cachedLoadResult !== null) {\n    return cachedLoadResult.createCodingGraphEngine;\n  }\n  // Fresh attempt — never inherited from a probe failure. Users see\n  // the real diagnostic on broken installs.\n  const outcome = await tryImportCodingGraphModule();\n  switch (outcome.kind) {\n    case \"ok\":\n      cachedLoadResult = outcome.module;\n      return outcome.module.createCodingGraphEngine;\n    case \"missing\":\n      throw notInstalledError();\n    case \"incompatible\":\n      throw incompatibleModuleError(outcome.actual);\n    case \"broken\":\n      throw outcome.cause instanceof Error\n        ? outcome.cause\n        : new Error(`@remnic/coding-graph failed to load: ${String(outcome.cause)}`);\n  }\n}\n\n/**\n * Run the probe attempt with a Promise slot so concurrent callers\n * await the same in-flight import (Cursor Bugbot P2 round 4).\n * Successful results are also written into `cachedLoadResult` so a\n * SUBSEQUENT loadCodingGraphEngineFactory skips the import (the\n * success-cache fast path above). All non-ok outcomes (missing,\n * incompatible, broken) are collapsed to `null` so the probe stays\n * boolean-safe for gate-off consumers.\n */\nfunction startProbeOnce(): Promise<LoadedCodingGraphModule | null> {\n  if (inFlightProbe !== null) {\n    return inFlightProbe;\n  }\n  const p = tryImportCodingGraphModule()\n    .then((outcome) => {\n      if (outcome.kind === \"ok\") {\n        cachedLoadResult = outcome.module;\n        return outcome.module;\n      }\n      return null;\n    })\n    .catch(() => {\n      // Defensive: tryImportCodingGraphModule does not reject in\n      // practice (we wrap all throws), but a future refactor could\n      // regress it — keep the probe boolean-safe.\n      return null as LoadedCodingGraphModule | null;\n    });\n  inFlightProbe = p;\n  // Once settled, clear the in-flight slot so a future call after a\n  // long delay still re-attempts. The successful module result lives\n  // on in cachedLoadResult if it succeeded.\n  p.finally(() => {\n    if (inFlightProbe === p) {\n      inFlightProbe = null;\n    }\n  });\n  return p;\n}\n\n// ---------------------------------------------------------------------------\n// Cache slots — see file header for the failure-mode policy that justifies\n// these being three separate slots.\n// ---------------------------------------------------------------------------\nlet cachedLoadResult: LoadedCodingGraphModule | null | undefined;\nlet inFlightProbe: Promise<LoadedCodingGraphModule | null> | null = null;\n\n/**\n * Return `true` only when `@remnic/coding-graph` is installed AND\n * importable in a usable shape. Returns `false` for missing, broken,\n * or incompatible installs. Never throws.\n */\nexport async function isCodingGraphInstalled(): Promise<boolean> {\n  return (await tryLoadCodingGraphModule()) !== null;\n}\n\n/**\n * Return the engine factory module if `@remnic/coding-graph` is\n * installed AND importable in a usable shape, or `null` otherwise.\n * Use this for graceful-degradation code paths. Never throws.\n *\n * Uses an in-flight-promise slot so concurrent callers share the same\n * import attempt, then caches the successful result so subsequent\n * loadFactory calls skip the import.\n */\nexport async function tryLoadCodingGraphModule(): Promise<LoadedCodingGraphModule | null> {\n  // Fast path: a previous loadFactory call stored a successful module.\n  if (cachedLoadResult !== undefined && cachedLoadResult !== null) {\n    return cachedLoadResult;\n  }\n  return startProbeOnce();\n}\n\n// ---------------------------------------------------------------------------\n// Re-export the engine contract types and stable constants so callers can\n// stay in `core` (no host prefix; the engine contract is owned by core).\n// ---------------------------------------------------------------------------\nexport {\n  CODING_GRAPH_ENGINE_VERSION,\n  TIER_1_LANGUAGES,\n};\n\nexport type {\n  CodingGraphEngine,\n  CodingGraphErrorCode,\n  CodingGraphLanguage,\n  CreateCodingGraphEngineOptions,\n  FileIR,\n  ParseFileInput,\n  ParseResult,\n  SymbolIR,\n};\n"],"mappings":";;;;;;;AAuEA,IAAM,YAAY;AAqCX,SAAS,8BAAsC;AACpD,SACE;AASJ;AAEA,SAAS,oBAA2B;AAClC,SAAO,IAAI,MAAM,4BAA4B,CAAC;AAChD;AAQA,SAAS,wBAAwB,QAAwB;AACvD,QAAM,OACJ,UAAU,OAAO,WAAW,WACxB,OAAO,KAAK,MAAM,EAAE,MAAM,GAAG,CAAC,EAAE,KAAK,IAAI,KAAK,WAC9C,OAAO;AACb,SAAO,IAAI;AAAA,IACT,ySAIwC,IAAI;AAAA,EAC9C;AACF;AAYO,SAAS,uCACd,KACA,YAAoB,WACX;AACT,MAAI,CAAC,OAAO,OAAO,QAAQ,UAAU;AACnC,WAAO;AAAA,EACT;AACA,QAAM,OAAQ,IAA2B;AACzC,MAAI,SAAS,0BAA0B,SAAS,oBAAoB;AAClE,WAAO;AAAA,EACT;AACA,QAAM,UAAW,IAA8B;AAC/C,MAAI,OAAO,YAAY,UAAU;AAC/B,WAAO;AAAA,EACT;AACA,MAAI,QAAQ,SAAS,IAAI,SAAS,GAAG,EAAG,QAAO;AAC/C,MAAI,QAAQ,SAAS,IAAI,SAAS,GAAG,EAAG,QAAO;AAG/C,QAAM,UAAU,UAAU,QAAQ,uBAAuB,MAAM;AAC/D,QAAM,gBAAgB,IAAI;AAAA,IACxB,qBAAqB,OAAO;AAAA,EAC9B;AACA,SAAO,cAAc,KAAK,OAAO;AACnC;AASA,SAAS,0BAA0B,OAAkD;AACnF,MAAI,CAAC,SAAS,OAAO,UAAU,SAAU,QAAO;AAChD,QAAM,YAAY;AAClB,SACE,OAAO,UAAU,4BAA4B,cAC7C,OAAO,UAAU,qBAAqB,cACtC,OAAO,UAAU,mBAAmB,YACpC,MAAM,QAAQ,UAAU,gBAAgB;AAE5C;AAWA,eAAe,6BAA4D;AAGzE,MAAI;AACJ,MAAI;AAOF,UAAO,MAAM,OAAO;AAAA,EACtB,SAAS,KAAK;AACZ,QAAI,uCAAuC,GAAG,GAAG;AAC/C,aAAO,EAAE,MAAM,UAAU;AAAA,IAC3B;AAIA,WAAO,EAAE,MAAM,UAAU,OAAO,IAAI;AAAA,EACtC;AACA,MAAI,CAAC,0BAA0B,GAAG,GAAG;AACnC,WAAO,EAAE,MAAM,gBAAgB,QAAQ,IAAI;AAAA,EAC7C;AACA,SAAO,EAAE,MAAM,MAAM,QAAQ,IAAI;AACnC;AAeA,eAAsB,+BAEpB;AAQA,MAAI,qBAAqB,UAAa,qBAAqB,MAAM;AAC/D,WAAO,iBAAiB;AAAA,EAC1B;AAGA,QAAM,UAAU,MAAM,2BAA2B;AACjD,UAAQ,QAAQ,MAAM;AAAA,IACpB,KAAK;AACH,yBAAmB,QAAQ;AAC3B,aAAO,QAAQ,OAAO;AAAA,IACxB,KAAK;AACH,YAAM,kBAAkB;AAAA,IAC1B,KAAK;AACH,YAAM,wBAAwB,QAAQ,MAAM;AAAA,IAC9C,KAAK;AACH,YAAM,QAAQ,iBAAiB,QAC3B,QAAQ,QACR,IAAI,MAAM,wCAAwC,OAAO,QAAQ,KAAK,CAAC,EAAE;AAAA,EACjF;AACF;AAWA,SAAS,iBAA0D;AACjE,MAAI,kBAAkB,MAAM;AAC1B,WAAO;AAAA,EACT;AACA,QAAM,IAAI,2BAA2B,EAClC,KAAK,CAAC,YAAY;AACjB,QAAI,QAAQ,SAAS,MAAM;AACzB,yBAAmB,QAAQ;AAC3B,aAAO,QAAQ;AAAA,IACjB;AACA,WAAO;AAAA,EACT,CAAC,EACA,MAAM,MAAM;AAIX,WAAO;AAAA,EACT,CAAC;AACH,kBAAgB;AAIhB,IAAE,QAAQ,MAAM;AACd,QAAI,kBAAkB,GAAG;AACvB,sBAAgB;AAAA,IAClB;AAAA,EACF,CAAC;AACD,SAAO;AACT;AAMA,IAAI;AACJ,IAAI,gBAAgE;AAOpE,eAAsB,yBAA2C;AAC/D,SAAQ,MAAM,yBAAyB,MAAO;AAChD;AAWA,eAAsB,2BAAoE;AAExF,MAAI,qBAAqB,UAAa,qBAAqB,MAAM;AAC/D,WAAO;AAAA,EACT;AACA,SAAO,eAAe;AACxB;","names":[]}

package/dist/coding-graph-types-Dd2tGrnm.d.ts

@@ -0,0 +1,106 @@
+declare const CODING_GRAPH_ENGINE_VERSION: "0.1.0-pr1";
+declare const TIER_1_LANGUAGES: readonly ["typescript", "tsx", "javascript", "python", "go", "rust", "java", "c", "cpp", "csharp", "ruby", "php", "kotlin", "swift", "bash"];
+type CodingGraphLanguage = (typeof TIER_1_LANGUAGES)[number];
+type CodingGraphErrorCode = "not_implemented" | "module_load_failed";
+interface CodingGraphEngine {
+    /** Engine version reported at construction time. */
+    readonly engineVersion: string;
+    /** Tier-1 languages this build supports (PR2 narrows by grammar availability). */
+    readonly supportedLanguages: readonly CodingGraphLanguage[];
+    /**
+     * Parse a single source file and emit its FileIR.
+     *
+     * PR1 throws `CodingGraphError("not_implemented", …)`. PR2 will return
+     * `ParseResult`; failure paths come back as
+     * `{ ok: false, code: "parse_failed", path, message }` (rule 44) rather
+     * than partial / silent IR.
+     */
+    parseFile(input: ParseFileInput): Promise<ParseResult>;
+    /** Engine lifecycle — release any cached parsers/grammars. */
+    dispose(): Promise<void>;
+}
+interface ParseFileInput {
+    /** Repository-relative path (forward slashes; no leading `./`). */
+    readonly path: string;
+    /** Raw file bytes; hashing happens inside the engine (rule 23). */
+    readonly content: Uint8Array;
+    /**
+     * Optional override. When omitted the engine sniffs the language from
+     * `path` extensions against its built-in tier-1 list (PR2).
+     */
+    readonly language?: CodingGraphLanguage;
+}
+type ParseResult = {
+    readonly ok: true;
+    readonly ir: FileIR;
+} | {
+    readonly ok: false;
+    readonly code: "parse_failed";
+    readonly path: string;
+    readonly message: string;
+};
+interface FileIR {
+    readonly path: string;
+    readonly language: CodingGraphLanguage;
+    /** SHA-256 of the raw bytes; rule 23 — every consumer hashes the same form. */
+    readonly contentHash: string;
+    readonly symbols: readonly SymbolIR[];
+    readonly imports: readonly ImportIR[];
+    readonly exports: readonly ExportIR[];
+    readonly callSites: readonly CallSiteIR[];
+    readonly routes: readonly RouteIR[];
+}
+interface SymbolIR {
+    readonly kind: "function" | "class" | "method" | "interface" | "enum" | "type" | "module";
+    readonly name: string;
+    readonly qualifiedName: string;
+    /** Half-open byte span `[startByte, endByte)`. Rule 35. */
+    readonly span: {
+        readonly startByte: number;
+        readonly endByte: number;
+    };
+    readonly parentQualifiedName?: string;
+}
+interface ImportIR {
+    /** Raw module specifier as written in source. */
+    readonly module: string;
+    readonly importedNames: readonly string[];
+    readonly span: {
+        readonly startByte: number;
+        readonly endByte: number;
+    };
+}
+interface ExportIR {
+    readonly name: string;
+    readonly span: {
+        readonly startByte: number;
+        readonly endByte: number;
+    };
+}
+interface CallSiteIR {
+    readonly calleeNameCandidates: readonly string[];
+    readonly span: {
+        readonly startByte: number;
+        readonly endByte: number;
+    };
+}
+interface RouteIR {
+    /** HTTP verb in upper-case, or framework-native verb (e.g. "ANY"). */
+    readonly verb: string;
+    readonly pathTemplate: string;
+    readonly handlerQualifiedName: string;
+    readonly span: {
+        readonly startByte: number;
+        readonly endByte: number;
+    };
+}
+/**
+ * Reserved for PR2. Declared now so the public surface is stable; the
+ * options object is intentionally empty in PR1.
+ */
+interface CreateCodingGraphEngineOptions {
+    /** Reserved for PR2: extra grammar directory supplied by the operator. */
+    readonly grammarDir?: never;
+}
+
+export { type CreateCodingGraphEngineOptions as C, type FileIR as F, type ParseFileInput as P, type SymbolIR as S, TIER_1_LANGUAGES as T, type CodingGraphEngine as a, type CodingGraphLanguage as b, type CodingGraphErrorCode as c, CODING_GRAPH_ENGINE_VERSION as d, type ParseResult as e };

package/dist/compounding/engine.d.ts

@@ -1,5 +1,5 @@
 import { StorageManager } from '../storage.js';
-import { P as PluginConfig } from '../types-D96bCB3C.js';
+import { P as PluginConfig } from '../types-D3pm4NhH.js';
 import { SharedFeedbackEntry } from '../shared-context/manager.js';
 import '../page-versioning.js';
 import '../consolidation-operator.js';

package/dist/compounding/engine.js

@@ -1,14 +1,14 @@
 import {
   CompoundingEngine,
   defaultTierMigrationCycleBudget
-} from "../chunk-KOXGLQS7.js";
+} from "../chunk-B6IUW76R.js";
 import "../chunk-DRD2Q7HQ.js";
-import "../chunk-WKMCC4NQ.js";
+import "../chunk-EUM7CZFM.js";
 import "../chunk-M7XQSUBB.js";
 import "../chunk-5UZXUTVO.js";
 import "../chunk-5GPPACXK.js";
 import "../chunk-J6A3CX5N.js";
-import "../chunk-AZBV4RRY.js";
+import "../chunk-FMSDA2D3.js";
 import "../chunk-AWJ2FHCF.js";
 import "../chunk-42JKGUFJ.js";
 import "../chunk-RULE4VG5.js";

package/dist/compounding/preference-consolidator.d.ts

@@ -1,4 +1,4 @@
-import { M as MemoryCategory, g as MemoryFile } from '../types-D96bCB3C.js';
+import { M as MemoryCategory, g as MemoryFile } from '../types-D3pm4NhH.js';
 import { LcmEngine } from '../lcm/engine.js';
 import '../types-ByK7T3L6.js';
 import '../index-DJ9QWMw-.js';

package/dist/compression-optimizer.d.ts

@@ -1,4 +1,4 @@
-import { a8 as CompressionGuidelineOptimizerEventCounts, a9 as CompressionGuidelineOptimizerActionSummary, aa as CompressionGuidelineOptimizerRuleUpdate, ab as MemoryActionType, m as MemoryActionEvent, C as CompressionGuidelineOptimizerState } from './types-D96bCB3C.js';
+import { a8 as CompressionGuidelineOptimizerEventCounts, a9 as CompressionGuidelineOptimizerActionSummary, aa as CompressionGuidelineOptimizerRuleUpdate, ab as MemoryActionType, m as MemoryActionEvent, C as CompressionGuidelineOptimizerState } from './types-D3pm4NhH.js';
 import './types-ByK7T3L6.js';
 import './index-DJ9QWMw-.js';
 

package/dist/config.d.ts

@@ -1,4 +1,4 @@
-import { P as PluginConfig } from './types-D96bCB3C.js';
+import { P as PluginConfig } from './types-D3pm4NhH.js';
 import './types-ByK7T3L6.js';
 import './index-DJ9QWMw-.js';
 

package/dist/config.js

@@ -4,7 +4,7 @@ import {
   isOpenaiApiKeyDisabled,
   parseConfig,
   resolveEnvVars
-} from "./chunk-CTAV55JM.js";
+} from "./chunk-MLVMBV2C.js";
 import "./chunk-PHK3HARR.js";
 import "./chunk-NDAH7BJ5.js";
 import "./chunk-Z5LAYHGJ.js";

package/dist/connectors/codex-materialize-runner.d.ts

@@ -1,4 +1,4 @@
-import { P as PluginConfig, g as MemoryFile } from '../types-D96bCB3C.js';
+import { P as PluginConfig, g as MemoryFile } from '../types-D3pm4NhH.js';
 import { RolloutSummaryInput, MaterializeResult } from './codex-materialize.js';
 import '../types-ByK7T3L6.js';
 import '../index-DJ9QWMw-.js';

package/dist/connectors/codex-materialize-runner.js

@@ -1,15 +1,15 @@
 import {
   runCodexMaterialize,
   runPostConsolidationMaterialize
-} from "../chunk-AARDBQTA.js";
+} from "../chunk-CTCPB57O.js";
 import "../chunk-LN4YGHTM.js";
 import "../chunk-3UXOZBHV.js";
-import "../chunk-WKMCC4NQ.js";
+import "../chunk-EUM7CZFM.js";
 import "../chunk-M7XQSUBB.js";
 import "../chunk-5UZXUTVO.js";
 import "../chunk-5GPPACXK.js";
 import "../chunk-J6A3CX5N.js";
-import "../chunk-AZBV4RRY.js";
+import "../chunk-FMSDA2D3.js";
 import "../chunk-AWJ2FHCF.js";
 import "../chunk-42JKGUFJ.js";
 import "../chunk-RULE4VG5.js";

package/dist/connectors/codex-materialize.d.ts

@@ -1,4 +1,4 @@
-import { g as MemoryFile } from '../types-D96bCB3C.js';
+import { g as MemoryFile } from '../types-D3pm4NhH.js';
 import '../types-ByK7T3L6.js';
 import '../index-DJ9QWMw-.js';
 

package/dist/connectors/index.d.ts

@@ -1,6 +1,6 @@
 export { MATERIALIZE_VERSION, MaterializeOptions, MaterializeResult, MemoryMdValidation, RolloutSummaryInput, SENTINEL_FILE, TMP_DIR, approximateTokenCount, describeMemoriesDir, ensureSentinel, materializeForNamespace, renderMemoryMd, renderMemorySummary, renderRawMemories, renderRolloutSummary, truncateToTokenBudget, validateMemoryMd } from './codex-materialize.js';
 export { RunMaterializeOptions, runCodexMaterialize } from './codex-materialize-runner.js';
-import { P as PluginConfig } from '../types-D96bCB3C.js';
+import { P as PluginConfig } from '../types-D3pm4NhH.js';
 import '../types-ByK7T3L6.js';
 import '../index-DJ9QWMw-.js';
 

package/dist/connectors/index.js

@@ -27,7 +27,7 @@ import {
 import "../chunk-UG274TNV.js";
 import {
   runCodexMaterialize
-} from "../chunk-AARDBQTA.js";
+} from "../chunk-CTCPB57O.js";
 import {
   MATERIALIZE_VERSION,
   SENTINEL_FILE,
@@ -48,12 +48,12 @@ import {
   coerceInstallExtension
 } from "../chunk-PHK3HARR.js";
 import "../chunk-O75CRYGF.js";
-import "../chunk-WKMCC4NQ.js";
+import "../chunk-EUM7CZFM.js";
 import "../chunk-M7XQSUBB.js";
 import "../chunk-5UZXUTVO.js";
 import "../chunk-5GPPACXK.js";
 import "../chunk-J6A3CX5N.js";
-import "../chunk-AZBV4RRY.js";
+import "../chunk-FMSDA2D3.js";
 import "../chunk-AWJ2FHCF.js";
 import "../chunk-42JKGUFJ.js";
 import "../chunk-RULE4VG5.js";

package/dist/consolidation-provenance-check.d.ts

@@ -1,7 +1,7 @@
 import { StorageManager } from './storage.js';
 import './page-versioning.js';
 import './consolidation-operator.js';
-import './types-D96bCB3C.js';
+import './types-D3pm4NhH.js';
 import './types-ByK7T3L6.js';
 import './index-DJ9QWMw-.js';
 import './memory-projection-store.js';

package/dist/consolidation-undo.d.ts

@@ -1,7 +1,7 @@
 import { StorageManager } from './storage.js';
 import { VersioningConfig } from './page-versioning.js';
 import './consolidation-operator.js';
-import './types-D96bCB3C.js';
+import './types-D3pm4NhH.js';
 import './types-ByK7T3L6.js';
 import './index-DJ9QWMw-.js';
 import './memory-projection-store.js';

package/dist/contradiction/index.d.ts

@@ -1,5 +1,5 @@
 import { StorageManager } from '../storage.js';
-import { h as MemoryStatus, P as PluginConfig, M as MemoryCategory } from '../types-D96bCB3C.js';
+import { h as MemoryStatus, P as PluginConfig, M as MemoryCategory } from '../types-D3pm4NhH.js';
 import { S as SemanticDedupLookup } from '../semantic-DJR8_DMQ.js';
 import { LocalLlmClient } from '../local-llm.js';
 import { FallbackLlmClient } from '../fallback-llm.js';

package/dist/conversation-index/backend.d.ts

@@ -1,7 +1,7 @@
 import { SearchBackend, SearchExecutionOptions } from '../search/port.js';
 import { ConversationChunk } from './chunker.js';
 import { C as ConversationSearchResult, F as FaissConversationIndexAdapter } from '../faiss-adapter-BHecI1fF.js';
-import '../types-D96bCB3C.js';
+import '../types-D3pm4NhH.js';
 import '../types-ByK7T3L6.js';
 import '../index-DJ9QWMw-.js';
 import '../runtime/child-process.js';

package/dist/conversation-index/backend.js

@@ -1,9 +1,9 @@
 import {
   createConversationIndexBackend
-} from "../chunk-CRO4LCQ6.js";
+} from "../chunk-KJOYHNS7.js";
+import "../chunk-OIF36KGD.js";
 import "../chunk-7DTASS5T.js";
 import "../chunk-E6ZDCOHM.js";
-import "../chunk-OIF36KGD.js";
 import "../chunk-O75CRYGF.js";
 import "../chunk-2ODBA7MQ.js";
 import "../chunk-PZ5AY32C.js";

package/dist/conversation-index/chunker.d.ts

@@ -1,4 +1,4 @@
-import { _ as TranscriptEntry } from '../types-D96bCB3C.js';
+import { _ as TranscriptEntry } from '../types-D3pm4NhH.js';
 import '../types-ByK7T3L6.js';
 import '../index-DJ9QWMw-.js';
 

package/dist/conversation-index/faiss-adapter.d.ts

@@ -1,7 +1,7 @@
 import './chunker.js';
 export { b as FaissAdapterConfig, c as FaissAdapterError, F as FaissConversationIndexAdapter, d as FaissHealthResult, e as FaissInspectResult, f as failOpenFaissHealth, r as resolveDefaultFaissScriptPath } from '../faiss-adapter-BHecI1fF.js';
 import '../runtime/child-process.js';
-import '../types-D96bCB3C.js';
+import '../types-D3pm4NhH.js';
 import '../types-ByK7T3L6.js';
 import '../index-DJ9QWMw-.js';
 import '../search/port.js';

package/dist/conversation-index/indexer.d.ts

@@ -1,7 +1,7 @@
 import { F as FaissConversationIndexAdapter } from '../faiss-adapter-BHecI1fF.js';
 import { ConversationChunk } from './chunker.js';
 import '../search/port.js';
-import '../types-D96bCB3C.js';
+import '../types-D3pm4NhH.js';
 import '../types-ByK7T3L6.js';
 import '../index-DJ9QWMw-.js';
 import '../runtime/child-process.js';

package/dist/conversation-index/search.d.ts

@@ -1,6 +1,6 @@
 import '../search/port.js';
 export { C as ConversationSearchResult, s as searchConversationIndex, a as searchConversationIndexFaissFailOpen } from '../faiss-adapter-BHecI1fF.js';
-import '../types-D96bCB3C.js';
+import '../types-D3pm4NhH.js';
 import '../types-ByK7T3L6.js';
 import '../index-DJ9QWMw-.js';
 import './chunker.js';

package/dist/day-summary.d.ts

@@ -1,4 +1,4 @@
-import { P as PluginConfig, g as MemoryFile } from './types-D96bCB3C.js';
+import { P as PluginConfig, g as MemoryFile } from './types-D3pm4NhH.js';
 import './types-ByK7T3L6.js';
 import './index-DJ9QWMw-.js';
 

package/dist/delinearize.d.ts

@@ -1,4 +1,4 @@
-import { ac as EntityMention } from './types-D96bCB3C.js';
+import { ac as EntityMention } from './types-D3pm4NhH.js';
 import './types-ByK7T3L6.js';
 import './index-DJ9QWMw-.js';
 

package/dist/direct-answer-wiring.d.ts

@@ -1,4 +1,4 @@
-import { g as MemoryFile, P as PluginConfig } from './types-D96bCB3C.js';
+import { g as MemoryFile, P as PluginConfig } from './types-D3pm4NhH.js';
 import { TrustZoneName } from './trust-zones.js';
 import { T as Taxonomy } from './types-DJhqDJUV.js';
 import { DirectAnswerResult } from './direct-answer.js';

package/dist/direct-answer.d.ts

@@ -1,5 +1,5 @@
 import { TrustZoneName } from './trust-zones.js';
-import { g as MemoryFile } from './types-D96bCB3C.js';
+import { g as MemoryFile } from './types-D3pm4NhH.js';
 import './types-ByK7T3L6.js';
 import './index-DJ9QWMw-.js';
 

package/dist/embedding-fallback.d.ts

@@ -1,4 +1,4 @@
-import { P as PluginConfig } from './types-D96bCB3C.js';
+import { P as PluginConfig } from './types-D3pm4NhH.js';
 import './types-ByK7T3L6.js';
 import './index-DJ9QWMw-.js';
 

package/dist/enrichment/index.d.ts

@@ -1,4 +1,4 @@
-import { M as MemoryCategory, a5 as ImportanceLevel } from '../types-D96bCB3C.js';
+import { M as MemoryCategory, a5 as ImportanceLevel } from '../types-D3pm4NhH.js';
 import { LoggerBackend } from '../logger.js';
 import '../types-ByK7T3L6.js';
 import '../index-DJ9QWMw-.js';

package/dist/entity-retrieval.d.ts

@@ -1,5 +1,5 @@
 import { StorageManager } from './storage.js';
-import { P as PluginConfig, _ as TranscriptEntry } from './types-D96bCB3C.js';
+import { P as PluginConfig, _ as TranscriptEntry } from './types-D3pm4NhH.js';
 import './page-versioning.js';
 import './consolidation-operator.js';
 import './memory-projection-store.js';

package/dist/entity-retrieval.js

@@ -3,14 +3,14 @@ import {
   entityIndexVersion,
   entityRecentTranscriptLookbackHours,
   readRecentEntityTranscriptEntries
-} from "./chunk-QZ7ODIVL.js";
+} from "./chunk-MNUPGYIV.js";
 import "./chunk-BEUDU7Y4.js";
-import "./chunk-WKMCC4NQ.js";
+import "./chunk-EUM7CZFM.js";
 import "./chunk-M7XQSUBB.js";
 import "./chunk-5UZXUTVO.js";
 import "./chunk-5GPPACXK.js";
 import "./chunk-J6A3CX5N.js";
-import "./chunk-AZBV4RRY.js";
+import "./chunk-FMSDA2D3.js";
 import "./chunk-AWJ2FHCF.js";
 import "./chunk-42JKGUFJ.js";
 import "./chunk-RULE4VG5.js";

package/dist/entity-schema.d.ts

@@ -1,4 +1,4 @@
-import { ad as EntitySchemaDefinition, ae as EntitySchemaSectionDefinition, E as EntityStructuredSection } from './types-D96bCB3C.js';
+import { ad as EntitySchemaDefinition, ae as EntitySchemaSectionDefinition, E as EntityStructuredSection } from './types-D3pm4NhH.js';
 import './types-ByK7T3L6.js';
 import './index-DJ9QWMw-.js';
 

package/dist/explicit-capture.d.ts

@@ -1,5 +1,5 @@
-import { O as Orchestrator } from './orchestrator-DyP9QYsh.js';
-import { M as MemoryCategory, P as PluginConfig } from './types-D96bCB3C.js';
+import { O as Orchestrator } from './orchestrator-7zPqGupX.js';
+import { M as MemoryCategory, P as PluginConfig } from './types-D3pm4NhH.js';
 import './briefing.js';
 import './storage.js';
 import './page-versioning.js';
@@ -38,7 +38,7 @@ import './lcm/archive.js';
 import './lcm/summarizer.js';
 import './lcm/dag.js';
 import './lcm/queue.js';
-import './semantic-consolidation-BICZvQ3C.js';
+import './semantic-consolidation-BX9Z9_aK.js';
 import './connectors/codex-materialize.js';
 import './logger.js';
 import './conversation-index/backend.js';

package/dist/extraction-judge-telemetry.d.ts

@@ -1,5 +1,5 @@
 import { JudgeVerdictKind } from './extraction-judge.js';
-import './types-D96bCB3C.js';
+import './types-D3pm4NhH.js';
 import './types-ByK7T3L6.js';
 import './index-DJ9QWMw-.js';
 import './local-llm.js';

package/dist/extraction-judge-training.d.ts

@@ -1,5 +1,5 @@
 import { JudgeVerdictKind } from './extraction-judge.js';
-import './types-D96bCB3C.js';
+import './types-D3pm4NhH.js';
 import './types-ByK7T3L6.js';
 import './index-DJ9QWMw-.js';
 import './local-llm.js';

package/dist/extraction-judge.d.ts

@@ -1,4 +1,4 @@
-import { a5 as ImportanceLevel, P as PluginConfig } from './types-D96bCB3C.js';
+import { a5 as ImportanceLevel, P as PluginConfig } from './types-D3pm4NhH.js';
 import { LocalLlmClient } from './local-llm.js';
 import { FallbackLlmClient } from './fallback-llm.js';
 import './types-ByK7T3L6.js';

package/dist/extraction.d.ts

@@ -1,6 +1,6 @@
 import { LocalLlmClient } from './local-llm.js';
 import { ContradictionVerificationResult, SuggestedLinks, MemorySummaryResult } from './schemas.js';
-import { P as PluginConfig, G as GatewayConfig, Z as BufferTurn, af as ExtractionResult, g as MemoryFile, ag as ConsolidationResult, ah as DaySummaryResult } from './types-D96bCB3C.js';
+import { P as PluginConfig, G as GatewayConfig, Z as BufferTurn, af as ExtractionResult, g as MemoryFile, ag as ConsolidationResult, ah as DaySummaryResult } from './types-D3pm4NhH.js';
 import { ModelRegistry } from './model-registry.js';
 import { ProfilingCollector } from './profiling.js';
 import './types-ByK7T3L6.js';

package/dist/fallback-llm.d.ts

@@ -1,4 +1,4 @@
-import { G as GatewayConfig, f as AgentPersonaModelConfig, P as PluginConfig } from './types-D96bCB3C.js';
+import { G as GatewayConfig, f as AgentPersonaModelConfig, P as PluginConfig } from './types-D3pm4NhH.js';
 import { GetRuntimeAuthForModelFn, ResolveApiKeyFn } from './resolve-provider-secret.js';
 import './types-ByK7T3L6.js';
 import './index-DJ9QWMw-.js';

package/dist/identity-continuity.d.ts

@@ -1,4 +1,4 @@
-import { q as ContinuityIncidentRecord, r as ContinuityIncidentCloseInput, p as ContinuityIncidentOpenInput, s as ContinuityImprovementLoop, u as ContinuityLoopReviewInput, t as ContinuityLoopUpsertInput } from './types-D96bCB3C.js';
+import { q as ContinuityIncidentRecord, r as ContinuityIncidentCloseInput, p as ContinuityIncidentOpenInput, s as ContinuityImprovementLoop, u as ContinuityLoopReviewInput, t as ContinuityLoopUpsertInput } from './types-D3pm4NhH.js';
 import './types-ByK7T3L6.js';
 import './index-DJ9QWMw-.js';