@remnic/core 9.3.671 → 9.3.673

package/dist/cli.js

@@ -90,11 +90,12 @@ import {
   runWorkProductStatusCliCommand,
   runWorkProjectCliCommand,
   runWorkTaskCliCommand
-} from "./chunk-32RD3GIW.js";
+} from "./chunk-XVVEKF5I.js";
+import "./chunk-7F7Z6MOS.js";
 import "./chunk-MC4FJXPA.js";
 import "./chunk-LQHDIS7L.js";
-import "./chunk-7F7Z6MOS.js";
 import "./chunk-JJEJJ7RK.js";
+import "./chunk-UP6MOYCB.js";
 import "./chunk-7VFZTJ7K.js";
 import "./chunk-HDDRVXX4.js";
 import "./chunk-AGNBY3VG.js";
@@ -104,7 +105,6 @@ import "./chunk-2DL3OFLD.js";
 import "./chunk-G4IAEX6D.js";
 import "./chunk-2NLLXCJG.js";
 import "./chunk-765K3SAT.js";
-import "./chunk-UP6MOYCB.js";
 import "./chunk-EEC4PCG5.js";
 import "./chunk-PYIFUBRK.js";
 import "./chunk-HOJZMQ4J.js";
@@ -121,10 +121,10 @@ import "./chunk-GQL52GQ5.js";
 import "./chunk-EVWIEEKZ.js";
 import "./chunk-3OKWZT7F.js";
 import "./chunk-TGQ2NTWH.js";
-import "./chunk-PYTATYUV.js";
+import "./chunk-ODWI5XU2.js";
 import "./chunk-GSTYVG5L.js";
-import "./chunk-CPVV2UEL.js";
-import "./chunk-LXVOZ2O6.js";
+import "./chunk-SDLJ2W7S.js";
+import "./chunk-T2AOOHDA.js";
 import "./chunk-3T74IZB3.js";
 import "./chunk-HL4DB7TO.js";
 import "./chunk-EZ25VE3G.js";
@@ -133,11 +133,12 @@ import "./chunk-AUDJPF4N.js";
 import "./chunk-Y4Z4I6WK.js";
 import "./chunk-6T4LTI2F.js";
 import "./chunk-YBPYIAA5.js";
+import "./chunk-CMTINOFS.js";
 import "./chunk-X6IRLNOO.js";
 import "./chunk-2PRQG7PV.js";
+import "./chunk-NXBXM7Q6.js";
 import "./chunk-2F6NP3NT.js";
 import "./chunk-TERNBNJB.js";
-import "./chunk-NXBXM7Q6.js";
 import "./chunk-W4RVMTHR.js";
 import "./chunk-LVTTO3VC.js";
 import "./chunk-ZRWB5D4H.js";
@@ -147,11 +148,10 @@ import "./chunk-SFQ6QNL7.js";
 import "./chunk-33JBK2XP.js";
 import "./chunk-LZSMQHXC.js";
 import "./chunk-KFY3SGN7.js";
-import "./chunk-CMTINOFS.js";
 import "./chunk-TQNRI55H.js";
 import "./chunk-6GUG4YNM.js";
-import "./chunk-JXS5PDQ7.js";
 import "./chunk-AV5ZEH4M.js";
+import "./chunk-JXS5PDQ7.js";
 import "./chunk-AJU4PJGY.js";
 import "./chunk-BEUDU7Y4.js";
 import "./chunk-3PY7VHV7.js";
@@ -160,14 +160,16 @@ import "./chunk-LMDRGRJ2.js";
 import "./chunk-OKTXM5H4.js";
 import "./chunk-3UXOZBHV.js";
 import "./chunk-UQ7RN5HK.js";
-import "./chunk-MLVMBV2C.js";
+import "./chunk-IUZWBCJX.js";
 import "./chunk-PHK3HARR.js";
 import "./chunk-NDAH7BJ5.js";
 import "./chunk-Z5LAYHGJ.js";
+import "./chunk-QO3AILZN.js";
+import "./chunk-3BQOQYRB.js";
 import "./chunk-LBJBNWS2.js";
 import "./chunk-HQ6NIBL6.js";
 import "./chunk-OADWQ5CR.js";
-import "./chunk-F7OWUP3G.js";
+import "./chunk-OG7A6AZX.js";
 import "./chunk-SEDEKFYQ.js";
 import "./chunk-JBPKEARU.js";
 import "./chunk-TMSXWOBZ.js";
@@ -176,10 +178,10 @@ import "./chunk-RSUYKGGZ.js";
 import "./chunk-42NQ7AVG.js";
 import "./chunk-7RXCMVFQ.js";
 import "./chunk-7WV3F5DQ.js";
-import "./chunk-Z4GALEO3.js";
+import "./chunk-SF45RQDX.js";
 import "./chunk-T4WDJPEZ.js";
 import "./chunk-D24OXEPB.js";
-import "./chunk-TGN4M5MB.js";
+import "./chunk-ZLINDOBG.js";
 import "./chunk-GDASG7NC.js";
 import "./chunk-GDB4J2H3.js";
 import "./chunk-ARV3AUOM.js";
@@ -193,8 +195,8 @@ import "./chunk-RS25QOKZ.js";
 import "./chunk-JGSKJHF7.js";
 import "./chunk-FF4KLI5W.js";
 import "./chunk-6VP3YUCS.js";
-import "./chunk-XS2CWEHZ.js";
-import "./chunk-23EBQ27U.js";
+import "./chunk-Q6MIDQEL.js";
+import "./chunk-B55KFEGS.js";
 import "./chunk-OUWAQVDJ.js";
 import "./chunk-DOCTITOP.js";
 import "./chunk-CYEPCZN5.js";
@@ -204,10 +206,10 @@ import "./chunk-AER6MT24.js";
 import "./chunk-RN7MUWON.js";
 import "./chunk-CINZGPSJ.js";
 import "./chunk-ZFXCQPNO.js";
-import "./chunk-CRO4LCQ6.js";
-import "./chunk-7DTASS5T.js";
+import "./chunk-7OGJQP7T.js";
 import "./chunk-E6ZDCOHM.js";
 import "./chunk-OIF36KGD.js";
+import "./chunk-7DTASS5T.js";
 import "./chunk-6RHNCKHG.js";
 import "./chunk-YNQ6DFSV.js";
 import "./chunk-EIR5VLIH.js";
@@ -257,15 +259,15 @@ import "./chunk-2ODBA7MQ.js";
 import "./chunk-PVGDJXVK.js";
 import "./chunk-A2IYSXDQ.js";
 import "./chunk-LPSF4OQH.js";
-import "./chunk-7K5Q6COX.js";
-import "./chunk-LBLXEFWK.js";
+import "./chunk-TVVEYCNW.js";
 import "./chunk-RFYAYKTD.js";
+import "./chunk-LBLXEFWK.js";
 import "./chunk-VFUEZZBS.js";
-import "./chunk-UDJLF3BO.js";
-import "./chunk-KQAFEZQX.js";
+import "./chunk-QLRYXOAD.js";
+import "./chunk-IPLYGWQF.js";
+import "./chunk-J4EB7DNW.js";
 import "./chunk-WEHSQBFR.js";
 import "./chunk-X7Y7WX73.js";
-import "./chunk-J4EB7DNW.js";
 import "./chunk-PWWWLD7D.js";
 import "./chunk-UI3NYK34.js";
 import "./chunk-GCGJW34D.js";

package/dist/coding/optional-coding-graph.d.ts

@@ -0,0 +1,63 @@
+import { C as CreateCodingGraphEngineOptions, a as CodingGraphEngine, b as CodingGraphLanguage, c as CodingGraphErrorCode } from '../coding-graph-types-Dd2tGrnm.js';
+export { d as CODING_GRAPH_ENGINE_VERSION, F as FileIR, P as ParseFileInput, e as ParseResult, S as SymbolIR, T as TIER_1_LANGUAGES } from '../coding-graph-types-Dd2tGrnm.js';
+
+/**
+ * Structural minimal shape of `@remnic/coding-graph`'s public surface,
+ * as seen by core after a successful dynamic import. We narrow to
+ * `unknown` first (since the dynamic import returns `any` at runtime)
+ * and then to this interface only after the runtime check below.
+ */
+interface LoadedCodingGraphModule {
+    ENGINE_VERSION: string;
+    TIER_1_LANGUAGES: readonly CodingGraphLanguage[];
+    CodingGraphError: new (code: CodingGraphErrorCode, message: string, engineVersion?: string) => Error;
+    createCodingGraphEngine: (options?: CreateCodingGraphEngineOptions) => CodingGraphEngine;
+}
+/**
+ * Build the user-facing install hint message. Exported so tests can assert
+ * on the exact text (CLAUDE.md rule 51 / issue #1551 prove-fail-before).
+ */
+declare function buildCodingGraphInstallHint(): string;
+/**
+ * Return true when `err` is a module-not-found failure for exactly the
+ * `@remnic/coding-graph` specifier. Same boundary-aware regex as
+ * packages/remnic-cli/src/optional-module-loader.ts so transitive
+ * misses (a broken @remnic/coding-graph release) bubble up rather than
+ * being mis-reported as "run npm install".
+ *
+ * Exported for tests; the production loaders call the internal alias
+ * below.
+ */
+declare function isSpecifierNotFoundErrorForCodingGraph(err: unknown, specifier?: string): boolean;
+/**
+ * Load `@remnic/coding-graph` if installed and return its
+ * `createCodingGraphEngine` factory. Throws a user-facing diagnostic
+ * that distinguishes three failure modes:
+ *   - missing    → install hint (canonical "npm install ..." message).
+ *   - incompatible → "package shape mismatch" diagnostic.
+ *   - broken     → rethrows the original import error.
+ *
+ * Reuses the cached success path so repeated calls in the same
+ * process do not re-import. On success the resolved module is cached
+ * and shared with the try* helpers; a failure never poisons the cache
+ * so each call attempts a fresh import.
+ */
+declare function loadCodingGraphEngineFactory(): Promise<(options?: CreateCodingGraphEngineOptions) => CodingGraphEngine>;
+/**
+ * Return `true` only when `@remnic/coding-graph` is installed AND
+ * importable in a usable shape. Returns `false` for missing, broken,
+ * or incompatible installs. Never throws.
+ */
+declare function isCodingGraphInstalled(): Promise<boolean>;
+/**
+ * Return the engine factory module if `@remnic/coding-graph` is
+ * installed AND importable in a usable shape, or `null` otherwise.
+ * Use this for graceful-degradation code paths. Never throws.
+ *
+ * Uses an in-flight-promise slot so concurrent callers share the same
+ * import attempt, then caches the successful result so subsequent
+ * loadFactory calls skip the import.
+ */
+declare function tryLoadCodingGraphModule(): Promise<LoadedCodingGraphModule | null>;
+
+export { CodingGraphEngine, CodingGraphErrorCode, CodingGraphLanguage, CreateCodingGraphEngineOptions, buildCodingGraphInstallHint, isCodingGraphInstalled, isSpecifierNotFoundErrorForCodingGraph, loadCodingGraphEngineFactory, tryLoadCodingGraphModule };

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":"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","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/config.d.ts

@@ -6,6 +6,6 @@ declare function isOpenaiApiKeyDisabled(value: unknown): boolean;
 declare function resolveEnvVars(value: string): string;
 declare const DEFAULT_REASONING_MODEL = "gpt-5.5";
 declare const VALID_MEMORY_CATEGORIES: Set<string>;
-declare function parseConfig(raw: unknown): PluginConfig;
+declare function parseConfig(raw: unknown, rawOperatorConfig?: Record<string, unknown> | null, runtimeSet?: ReadonlySet<string>): PluginConfig;
 
 export { DEFAULT_REASONING_MODEL, VALID_MEMORY_CATEGORIES, isOpenaiApiKeyDisabled, parseConfig, resolveEnvVars };

package/dist/config.js

@@ -4,10 +4,12 @@ import {
   isOpenaiApiKeyDisabled,
   parseConfig,
   resolveEnvVars
-} from "./chunk-MLVMBV2C.js";
+} from "./chunk-IUZWBCJX.js";
 import "./chunk-PHK3HARR.js";
 import "./chunk-NDAH7BJ5.js";
 import "./chunk-Z5LAYHGJ.js";
+import "./chunk-QO3AILZN.js";
+import "./chunk-3BQOQYRB.js";
 import "./chunk-4DJQYKMN.js";
 import "./chunk-EYIEWJNI.js";
 import "./chunk-JUC24CTX.js";

package/dist/connectors/index.d.ts

@@ -12,6 +12,11 @@ import '../index-DJ9QWMw-.js';
  */
 declare function coerceInstallExtension(value: unknown): boolean | undefined;
 
+/** Path of the connector registry manifest file. */
+declare function getRegistryPath(): string;
+/** Directory holding one `<connector-id>.json` per installed connector. */
+declare function getConnectorsDir(): string;
+
 /**
  * codex-marketplace.ts — Codex marketplace installation support (#418)
  *
@@ -263,7 +268,6 @@ interface DoctorCheck {
     detail: string;
 }
 
-declare function getRegistryPath(): string;
 declare function loadRegistry(): ConnectorRegistry;
 declare function saveRegistry(registry: ConnectorRegistry): void;
 declare function listConnectors(): {
@@ -442,4 +446,4 @@ declare function buildWeCloneProxyConfig(args: {
     authToken?: string;
 }): WeCloneProxyConfig;
 
-export { type CodexMemoryExtensionPaths, type ConnectorCapability, type ConnectorInstance, type ConnectorManifest, type ConnectorRegistry, type DoctorCheck, type DoctorResult, type InstallCodexMemoryExtensionOptions, type InstallCodexMemoryExtensionResult, type InstallOptions, type InstallResult, MARKETPLACE_MANIFEST_FILENAME, MARKETPLACE_SCHEMA_VERSION, type MarketplaceConfig, type MarketplaceEntry, type MarketplaceInstallResult, type MarketplaceInstallType, type MarketplaceLogger, type MarketplaceManifest, type MarketplaceValidation, type RemoveCodexMemoryExtensionOptions, type RemoveCodexMemoryExtensionResult, type RemoveResult, buildWeCloneProxyConfig, checkMarketplaceManifest, coerceInstallExtension, doctorConnector, generateMarketplaceManifest, getConnectorToken, getRegistryPath, installCodexMemoryExtension, installConnector, installFromMarketplace, listConnectors, loadRegistry, locatePluginCodexExtensionSource, removeCodexMemoryExtension, removeConnector, removeHermesConfig, resolveCodexHome, resolveCodexMemoryExtensionPaths, resolveWeCloneProxyConfigPath, saveRegistry, upsertHermesConfig, validateMarketplaceManifest, writeMarketplaceManifest };
+export { type CodexMemoryExtensionPaths, type ConnectorCapability, type ConnectorInstance, type ConnectorManifest, type ConnectorRegistry, type DoctorCheck, type DoctorResult, type InstallCodexMemoryExtensionOptions, type InstallCodexMemoryExtensionResult, type InstallOptions, type InstallResult, MARKETPLACE_MANIFEST_FILENAME, MARKETPLACE_SCHEMA_VERSION, type MarketplaceConfig, type MarketplaceEntry, type MarketplaceInstallResult, type MarketplaceInstallType, type MarketplaceLogger, type MarketplaceManifest, type MarketplaceValidation, type RemoveCodexMemoryExtensionOptions, type RemoveCodexMemoryExtensionResult, type RemoveResult, buildWeCloneProxyConfig, checkMarketplaceManifest, coerceInstallExtension, doctorConnector, generateMarketplaceManifest, getConnectorToken, getConnectorsDir, getRegistryPath, installCodexMemoryExtension, installConnector, installFromMarketplace, listConnectors, loadRegistry, locatePluginCodexExtensionSource, removeCodexMemoryExtension, removeConnector, removeHermesConfig, resolveCodexHome, resolveCodexMemoryExtensionPaths, resolveWeCloneProxyConfigPath, saveRegistry, upsertHermesConfig, validateMarketplaceManifest, writeMarketplaceManifest };

package/dist/connectors/index.js

@@ -6,7 +6,6 @@ import {
   doctorConnector,
   generateMarketplaceManifest,
   getConnectorToken,
-  getRegistryPath,
   installCodexMemoryExtension,
   installConnector,
   installFromMarketplace,
@@ -23,7 +22,7 @@ import {
   upsertHermesConfig,
   validateMarketplaceManifest,
   writeMarketplaceManifest
-} from "../chunk-BTLNC5YM.js";
+} from "../chunk-GNAMDNGT.js";
 import "../chunk-UG274TNV.js";
 import {
   runCodexMaterialize
@@ -47,6 +46,10 @@ import "../chunk-3UXOZBHV.js";
 import {
   coerceInstallExtension
 } from "../chunk-PHK3HARR.js";
+import {
+  getConnectorsDir,
+  getRegistryPath
+} from "../chunk-3BQOQYRB.js";
 import "../chunk-O75CRYGF.js";
 import "../chunk-EUM7CZFM.js";
 import "../chunk-M7XQSUBB.js";
@@ -90,6 +93,7 @@ export {
   ensureSentinel,
   generateMarketplaceManifest,
   getConnectorToken,
+  getConnectorsDir,
   getRegistryPath,
   installCodexMemoryExtension,
   installConnector,

package/dist/conversation-index/backend.js

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

package/dist/emit-legacy-tools.d.ts

@@ -0,0 +1,61 @@
+/**
+ * emit-legacy-tools — resolution cluster for the `emitLegacyTools` and
+ * `namespaceCatalogEnabled` config gates (issues #1427, #1499, #1550).
+ *
+ * Extracted from packages/remnic-core/src/config.ts (PR #1593, round 6)
+ * so the raw-vs-effective split, runtime-override precedence, and
+ * fileConfig-null normalization logic specific to these two gates
+ * stays out of the god-file `config.ts`. The export surface is exactly
+ * the two resolvers plus the `coerceBooleanLikeOrThrow` helper that
+ * wraps the local `coerceBooleanLike` — every other config gate in
+ * `parseConfig` keeps using its own inline coercion or the
+ * `coerceBooleanLike` already exported from
+ * `packages/remnic-core/src/connectors/coerce.ts`.
+ *
+ * Precedence (PR #1593 rounds 1-4, plus the null/loader hardening from
+ * rounds 3-5):
+ *
+ *   1. `configValue` (the first arg) is the MERGED config
+ *      (runtime-over-file via the
+ *      `{...fileConfig, ...api.pluginConfig}` spread in src/index.ts).
+ *      If it's a real boolean, it represents what the operator wants,
+ *      so honor it. We only fall through when it's the schema-default
+ *      materialization with no operator authoring in raw.
+ *   2. `rawOperatorConfig` (the second arg) is the operator-supplied
+ *      config block BEFORE the OpenClaw manifest layer applies schema
+ *      defaults — i.e. the file-backed `loadPluginConfigFromFile` output.
+ *      When raw has the key with a non-null/undefined value, the file
+ *      layer authored it. The merged `configValue` reflects the full
+ *      operator intent (file + runtime), so `configValue` is still
+ *      authoritative. raw presence is used only as the "operator
+ *      authored this key" signal — if raw is missing AND configValue
+ *      equals the schema default, only the schema layer materialized the
+ *      key (no operator intent anywhere) and we fall through to env /
+ *      sticky-legacy.
+ *   3. Legacy callers (raw undefined): trust configValue as before to
+ *      preserve the 121+ existing call sites that pass only one arg.
+ *
+ * Defensive normalization (PR #1593 round 3): JSON null on disk for the
+ * operator config block surfaces as `null` in rawOperatorConfig. Both
+ * resolvers normalize `null` to `{}` so the `"key" in rawOperatorConfig`
+ * check never throws. The file loader
+ * (`loadPluginConfigFromFile`) also normalizes null to undefined
+ * before reaching here.
+ */
+/**
+ * Resolve the `emitLegacyTools` opt-out (issue #1427, defaults revised in
+ * #1550). Precedence: operator-set raw config, then merged (post-defaults)
+ * config, then the REMNIC_/ENGRAM_ env var, then a sticky-legacy default —
+ * `true` only when existing legacy connector entries are present on disk
+ * (`hasLegacyConnectorEntries`), `false` for fresh installs.
+ */
+declare function resolveEmitLegacyTools(configValue: unknown, rawOperatorConfig: Record<string, unknown> | undefined | null, runtimeSet?: ReadonlySet<string>): boolean;
+/**
+ * Resolve the `namespaceCatalogEnabled` opt-out (issue #1499). Same
+ * raw-vs-effective split as `resolveEmitLegacyTools` — schema-default
+ * hardening at the helper level so adding a `false` default later cannot
+ * silently flip behavior on upgraded installs (#1550 class hardening).
+ */
+declare function resolveNamespaceCatalogEnabled(configValue: unknown, rawOperatorConfig: Record<string, unknown> | undefined | null, runtimeSet?: ReadonlySet<string>): boolean;
+
+export { resolveEmitLegacyTools, resolveNamespaceCatalogEnabled };

package/dist/emit-legacy-tools.js

@@ -0,0 +1,12 @@
+import {
+  resolveEmitLegacyTools,
+  resolveNamespaceCatalogEnabled
+} from "./chunk-QO3AILZN.js";
+import "./chunk-3BQOQYRB.js";
+import "./chunk-JUC24CTX.js";
+import "./chunk-PZ5AY32C.js";
+export {
+  resolveEmitLegacyTools,
+  resolveNamespaceCatalogEnabled
+};
+//# sourceMappingURL=emit-legacy-tools.js.map

package/dist/emit-legacy-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}