@monoes/monomindcli 1.10.24 → 1.10.26

package/.claude/helpers/router.cjs

@@ -143,11 +143,46 @@ function matchSkills(task, topN = 5) {
     .slice(0, topN);
 }
 
+// Categories that are almost never relevant in a software project context.
+// We exclude these from extras suggestions UNLESS the prompt has explicit
+// keywords that opt them back in. Default-conservative: in a code repo,
+// an "Anthropologist" for "community docs" or "Unity Architect" for a
+// "community module" is noise, not signal.
+const _NON_DEV_EXTRA_CATEGORIES = new Set([
+  'academic',         // Anthropologist, Geographer, Historian, Narratologist, Psychologist
+  'game-development', // Unity/Unreal/Godot/Blender — irrelevant for non-game codebases
+  'marketing',
+  'sales',
+  'paid-media',
+  'design',           // brand/UI/UX specialists — irrelevant for code reviews
+]);
+
+// Per-category opt-in keywords. If the prompt mentions one of these, that
+// category is allowed back into extras.
+const _CATEGORY_OPTIN_KEYWORDS = {
+  'academic':         /\b(anthropolog|sociolog|cultural|ritual|kinship|ethnograph|histor(?:y|ical|ian)|geograph|narratolog|psycholog|belief\s*system)\b/i,
+  'game-development': /\b(unity|unreal|godot|blender|game\s*(?:design|dev|engine)|gameplay|shader\s*graph|level\s*design|ugc|roblox)\b/i,
+  'marketing':        /\b(marketing|advertis|seo|tiktok|instagram|linkedin\s*content|brand|campaign|growth\s*hack|copywrit|blog\s*post|press\s*release|launch\s*strategy|pitch|investor)\b/i,
+  'sales':            /\b(sales|prospect|outbound|pipeline|crm|cold\s*email|deal|account\s*strategy|quota|forecast|qbr)\b/i,
+  'paid-media':       /\b(paid\s*media|ads?|google\s*ads|meta\s*ads|programmatic|ppc|cpa|conversion\s*tracking)\b/i,
+  'design':           /\b(figma|brand\s*identity|design\s*system|ux\s*research|persona|usability|wireframe|prototype|color\s*palette|typography|moodboard)\b/i,
+};
+
+function _allowedExtraCategories(taskLower) {
+  const allowed = new Set();
+  for (const [cat, re] of Object.entries(_CATEGORY_OPTIN_KEYWORDS)) {
+    if (re.test(taskLower)) allowed.add(cat);
+  }
+  return allowed;
+}
+
 function matchExtras(task, topN = 8) {
   if (typeof task !== 'string') return [];
   const registry = loadExtrasRegistry();
   const taskLower = task.toLowerCase();
+  const optedIn = _allowedExtraCategories(taskLower);
   return registry.extras
+    .filter(e => !_NON_DEV_EXTRA_CATEGORIES.has(e.category) || optedIn.has(e.category))
     .map(e => ({ slug: e.slug, name: e.name, description: e.description, category: e.category, filePath: e.filePath, score: scoreEntry(e.keywords, taskLower) }))
     .filter(e => e.score > 0)
     .sort((a, b) => b.score - a.score)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@monoes/monomindcli",
-  "version": "1.10.24",
+  "version": "1.10.26",
   "type": "module",
   "description": "Monomind CLI - Enterprise AI agent orchestration with 60+ specialized agents, swarm coordination, MCP server, self-learning hooks, and vector memory for Claude Code",
   "main": "dist/src/index.js",

package/scripts/understand-analyze.mjs

@@ -22,8 +22,9 @@
  *   --no-llm              Heuristic-only mode (layers + tags from paths, no API calls)
  *   --layers-only         Skip per-file analysis, only (re-)detect layers
  *
- * Env:
- *   ANTHROPIC_API_KEY     Required unless --no-llm is set
+ * Designed to be invoked by the /monomind:understand slash command. The
+ * slash command runs the script in --no-llm mode and orchestrates the
+ * per-file summarization through the active Claude Code session.
  */
 
 import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'node:fs';
@@ -181,7 +182,7 @@ async function callClaude(systemPrompt, userPrompt, maxTokens = 1024) {
   if (ANTHROPIC_API_KEY) {
     return callClaudeViaApi(systemPrompt, userPrompt, maxTokens);
   }
-  throw new Error('No LLM path available: set ANTHROPIC_API_KEY (or use the /monomind:understand slash command, which orchestrates LLM work via the active Claude Code session)');
+  throw new Error('No LLM path available. Use /monomind:understand from inside Claude Code — the slash command orchestrates LLM work through the active session.');
 }
 
 function parseJson(text) {
@@ -678,19 +679,13 @@ async function main() {
   const batch = toAnalyze.slice(0, limit);
   console.log(`[understand] Analyzing ${batch.length} files (${toAnalyze.length - batch.length} skipped/already enriched)`);
 
-  // LLM path: direct Anthropic API only. The script does NOT try to spawn
-  // `claude -p` from within Claude Code subprocesses — that hangs because
-  // nested CLI sessions aren't supported. For LLM enrichment without an API
-  // key, use the /monomind:understand slash command which orchestrates LLM
-  // work via the active Claude Code session inline.
+  // LLM path determined automatically. The script does NOT advise on
+  // credentials — orchestration is the slash command's job.
   const llmPath = ANTHROPIC_API_KEY ? 'api' : 'none';
   if (llmPath === 'none' && !noLlm) {
-    console.log('[understand] No ANTHROPIC_API_KEY — running in heuristic mode for layer detection.');
-    console.log('[understand] For per-file summaries: either set ANTHROPIC_API_KEY for direct API,');
-    console.log('[understand] or use the /monomind:understand slash command from inside Claude Code');
-    console.log('[understand] (the slash command does inline analysis via the active session, no key needed).');
-  } else if (llmPath === 'api' && !noLlm) {
-    console.log('[understand] LLM path: direct Anthropic API');
+    console.log('[understand] Running in heuristic mode. For per-file summaries,');
+    console.log('[understand] use /monomind:understand from inside Claude Code — the slash');
+    console.log('[understand] command orchestrates summarization through the active session.');
   }
   const useLlm = !noLlm && llmPath !== 'none';