monomind 2.1.0 → 2.1.4

package/packages/@monomind/cli/.claude/helpers/utils/monograph.cjs

@@ -9,6 +9,25 @@ const { _getRecentEdits } = require('./telemetry.cjs');
 
 const CWD = process.env.CLAUDE_PROJECT_DIR || process.cwd();
 
+// @monoes/monograph is "type":"module" with an exports map that has no
+// "require" condition — a bare `require('@monoes/monograph')` (or
+// require() of its package directory) always throws "No exports main
+// defined", regardless of whether the package is actually installed.
+// require()-ing the package's *resolved entry file* directly bypasses the
+// exports-map restriction and works via Node's require(esm) support (this
+// codebase targets Node 20+, which has it). Reads the entry path from the
+// package's own package.json instead of hardcoding "dist/src/index.js" so
+// this survives a future monograph dist-layout change.
+function _resolvePkgEntryFile(pkgDir) {
+  try {
+    var pkg = JSON.parse(fs.readFileSync(path.join(pkgDir, 'package.json'), 'utf-8'));
+    var entry = (pkg.exports && pkg.exports['.'] && (pkg.exports['.'].import || pkg.exports['.'].default)) || pkg.main;
+    if (!entry) return null;
+    var full = path.join(pkgDir, entry);
+    return fs.existsSync(full) ? full : null;
+  } catch (e) { return null; }
+}
+
 function _requireMonograph() {
   var candidates = [
     path.join(CWD, 'node_modules/.pnpm/node_modules/@monoes/monograph'),
@@ -16,9 +35,21 @@ function _requireMonograph() {
     path.join(CWD, 'node_modules/@monoes/monograph'),
   ];
   for (var i = 0; i < candidates.length; i++) {
-    try { if (fs.existsSync(candidates[i])) return require(candidates[i]); } catch(e) {}
+    var entry = fs.existsSync(candidates[i]) ? _resolvePkgEntryFile(candidates[i]) : null;
+    if (entry) { try { return require(entry); } catch (e) {} }
+  }
+  // Ancestor-directory search — the equivalent of bare `require('@monoes/
+  // monograph')`'s own node_modules walk, needed since that call form can
+  // never succeed against this package's exports map.
+  var dir = CWD;
+  for (;;) {
+    var pkgDir = path.join(dir, 'node_modules', '@monoes', 'monograph');
+    var entry = fs.existsSync(pkgDir) ? _resolvePkgEntryFile(pkgDir) : null;
+    if (entry) { try { return require(entry); } catch (e) {} break; }
+    var parent = path.dirname(dir);
+    if (parent === dir) break;
+    dir = parent;
   }
-  try { return require('@monoes/monograph'); } catch(e) {}
   return null;
 }
 
@@ -257,6 +288,44 @@ function _recordGraphTelemetry(event) {
   } catch (e) { /* non-fatal */ }
 }
 
+// ─── Graph gate ─────────────────────────────────────────────────────────────
+// The pre-search/pre-bash heuristic assist above silently resolves Grep/Bash
+// patterns against the graph and counts that as a "graph win" even when the
+// agent never actually called monograph_query — so the graph-usage % can look
+// healthy while zero real monograph_call events ever fire. This gate forces
+// at least one real monograph_query/monograph_suggest call per session before
+// Grep/Glob/bash grep|find are allowed, by hard-blocking (exitCode 2) the
+// first such call each session. Capped at ONE block per session (never a
+// second) so a subagent with no monograph MCP tool access can't deadlock.
+function _graphGateStateFile() {
+  return path.join(CWD, '.monomind', 'graph-gate-state.json');
+}
+
+function _graphGateMarkQueried(sessionId) {
+  if (!sessionId) return;
+  try {
+    fs.mkdirSync(path.join(CWD, '.monomind'), { recursive: true });
+    fs.writeFileSync(_graphGateStateFile(), JSON.stringify({ sessionId: sessionId, queried: true }));
+  } catch (e) { /* non-fatal */ }
+}
+
+function _graphGateShouldBlock(sessionId) {
+  if (!sessionId || !_isGraphFresh()) return false;
+  var f = _graphGateStateFile();
+  var d = {};
+  try { d = JSON.parse(fs.readFileSync(f, 'utf-8')); } catch (e) {}
+  if (typeof d !== 'object' || d === null || d.sessionId !== sessionId) {
+    d = { sessionId: sessionId, queried: false, blockedOnce: false };
+  }
+  if (d.queried || d.blockedOnce) return false;
+  d.blockedOnce = true;
+  try {
+    fs.mkdirSync(path.join(CWD, '.monomind'), { recursive: true });
+    fs.writeFileSync(f, JSON.stringify(d));
+  } catch (e) { return false; }
+  return true;
+}
+
 function _injectCompactGraphMap() {
   try {
     var db = _openMonographDb();
@@ -476,5 +545,7 @@ module.exports = {
   _injectCompactGraphMap,
   _findAffectedTests,
   _maybeRebuildMonograph,
+  _graphGateShouldBlock,
+  _graphGateMarkQueried,
   injectGodNodesContext,
 };