@chem-x/starter-kit 26.9.21-227 → 26.9.21-34

package/cli/audit/autofix.js

@@ -63,9 +63,7 @@ export const autofixContent = (content, options = {}) => {
     }
 
     // 3. AI lazy placeholder comment removal
-    const hasLazyTruncation = TRUNCATION_REGEX.test(line);
-    const isLazyTruncationEligible = !shouldDropLine && shouldFix('AI_SLOP_LAZY_PLACEHOLDER');
-    if (isLazyTruncationEligible && hasLazyTruncation) {
+    if (!shouldDropLine && shouldFix('AI_SLOP_LAZY_PLACEHOLDER') && TRUNCATION_REGEX.test(line)) {
       fixes.push({
         line: lineNumber,
         rule: 'AI_SLOP_LAZY_PLACEHOLDER',
@@ -74,9 +72,7 @@ export const autofixContent = (content, options = {}) => {
       shouldDropLine = true;
     }
 
-    const hasEmDash = line.includes('\u2014');
-    const isEmDashEligible = !shouldDropLine && shouldFix('TYPOGRAPHY_EM_DASH');
-    if (isEmDashEligible && hasEmDash) {
+    if (!shouldDropLine && shouldFix('TYPOGRAPHY_EM_DASH') && line.includes('\u2014')) {
       line = line.replace(/\u2014/g, '-');
       fixes.push({
         line: lineNumber,
@@ -85,17 +81,6 @@ export const autofixContent = (content, options = {}) => {
       });
     }
 
-    const hasTimeoutMacro = /setTimeout\([^,]+,\s*0\)/.test(line);
-    const isTimeoutEligible = !shouldDropLine && shouldFix('MACRO_TASK_OVER_MICRO_TASK');
-    if (isTimeoutEligible && hasTimeoutMacro) {
-      line = line.replace(/setTimeout\(([^,]+),\s*0\)/g, 'queueMicrotask($1)');
-      fixes.push({
-        line: lineNumber,
-        rule: 'MACRO_TASK_OVER_MICRO_TASK',
-        action: 'Replaced setTimeout(fn, 0) with queueMicrotask(fn)'
-      });
-    }
-
     if (!shouldDropLine) {
       resultLines.push(line);
     }

package/cli/audit.js

@@ -226,11 +226,8 @@ export const runAudit = (targetDir = 'src', options = {}) => {
   const patterns = patternRegistry.resolveHarmonizationCandidates(hotspots);
   const roadmap = buildRemediationRoadmap({ hotspots, violations, patterns });
 
-  const stage = options.stage || (options.relax ? 'draft' : 'strict');
-
   const report = {
     targetDir,
-    stage,
     options,
     scannedFiles,
     totalViolations: violations.length,

package/cli/commands/cmd-audit.js

@@ -1,5 +1,5 @@
 /**
- * cmd-audit.js: Audit command orchestrator.
+ * cmd-audit.js — Audit command orchestrator.
  * Single responsibility: run the full AST audit pipeline given CLI args.
  * Extracted from cli/index.js per Directive 1.A (Monolith Decomposition).
  */
@@ -47,19 +47,6 @@ export const runAudit = async (customDir, isCli, rawArgs, loadProjectConfig) =>
   const isPromptOnFail = rawArgs.includes('--prompt-on-fail');
   const isCopyPrompt = rawArgs.includes('--copy-prompt');
 
-  const stageFlag = rawArgs.find((arg) => arg.startsWith('--stage='));
-  let stage = 'strict';
-  if (stageFlag) {
-    stage = stageFlag.split('=')[1];
-  } else if (rawArgs.includes('--relax') || rawArgs.includes('--draft')) {
-    stage = 'draft';
-  } else if (isStrict) {
-    stage = 'strict';
-  } else if (projectConfig.stage) {
-    stage = projectConfig.stage;
-  }
-  const isDraft = stage === 'draft';
-
   const dirFlag = rawArgs.find((arg) => arg.startsWith('--dir='));
   const outputFlag = rawArgs.find((arg) => arg.startsWith('--output=') || arg.startsWith('-o='));
   const outputFile = outputFlag ? outputFlag.split('=')[1] : null;
@@ -101,7 +88,7 @@ export const runAudit = async (customDir, isCli, rawArgs, loadProjectConfig) =>
     fileList = preflight.fileList;
   }
 
-  const auditOptions = { outputFile, model, costPerMillion, fast: isFast, fileList, stage };
+  const auditOptions = { outputFile, model, costPerMillion, fast: isFast, fileList };
   const report = executeAstAudit(targetDir, auditOptions);
   saveAuditSnapshot(report);
   const syncRes = syncSearchIndex(targetDir, process.cwd());
@@ -115,35 +102,9 @@ export const runAudit = async (customDir, isCli, rawArgs, loadProjectConfig) =>
         process.stdout.write(`\x1b[32m✔\x1b[0m Auto-triage generated ${createdTasks.length} team task(s) from audit violations.\n`);
       }
     }
-    if (rawArgs.includes('--clones')) {
-      const { detectSemanticClones } = await import('../audit/clone-detector.js');
-      const { formatCloneReport } = await import('../audit/reporter-clones.js');
-      const cloneThresholdArg = rawArgs.find((a) => a.startsWith('--clone-threshold='));
-      const threshold = cloneThresholdArg ? parseFloat(cloneThresholdArg.split('=')[1]) : 0.85;
-      const clones = detectSemanticClones(syncRes.db, { threshold });
-      if (isJson) {
-        report.clones = clones;
-      } else {
-        process.stdout.write(formatCloneReport(clones));
-      }
-    }
-    if (rawArgs.includes('--hotspot-graph')) {
-      const { calculateCascadingHotspotGraph } = await import('../search-queries-hotspot-graph.js');
-      const { formatHotspotGraphReport } = await import('../audit/reporter-hotspot-graph.js');
-      const limitArg = rawArgs.find((a) => a.startsWith('--limit='));
-      const limit = limitArg ? parseInt(limitArg.split('=')[1], 10) : 10;
-      const graph = calculateCascadingHotspotGraph(syncRes.db, { limit });
-      if (isJson) {
-        report.hotspotGraph = graph;
-      } else {
-        process.stdout.write(formatHotspotGraphReport(graph));
-      }
-    }
   }
 
   // Stage 1: Atomic failure predicates
-  const isCriticalViolation = (v) => v.severity === 'CRITICAL';
-  const hasCritical = report.violations.some(isCriticalViolation);
   const isSevereViolation = (v) => v.severity === 'CRITICAL' || v.severity === 'HIGH';
   const hasCriticalOrHigh = report.violations.some(isSevereViolation);
   const hasViolations = report.violations.length > 0;
@@ -155,8 +116,7 @@ export const runAudit = async (customDir, isCli, rawArgs, loadProjectConfig) =>
   const isDefaultFail = !hasThreshold && !isStrict && hasCriticalOrHigh;
 
   // Stage 2: Unified failure decision
-  const hasStandardFailure = evaluateAuditFailure([isStrictFail, isDefaultFail, isGradeFail, isScoreFail]);
-  const hasFailingViolations = isDraft ? hasCritical : hasStandardFailure;
+  const hasFailingViolations = evaluateAuditFailure([isStrictFail, isDefaultFail, isGradeFail, isScoreFail]);
 
   if (isJson) {
     process.stdout.write(JSON.stringify(report, null, 2) + '\n');

package/cli/commands/cmd-router.js

@@ -1,5 +1,5 @@
 /**
- * cmd-router.js: CLI command dispatch table.
+ * cmd-router.js — CLI command dispatch table.
  * Single responsibility: map first-arg tokens to their lazy-loaded command handlers.
  * Extracted from cli/index.js per Directive 1.A (Monolith Decomposition).
  */
@@ -67,12 +67,6 @@ export const dispatchCommand = async (firstArg, rawArgs, runAudit, getPackageVer
       await runAudit(posDir, true);
       break;
     }
-    case 'trend':
-    case 'trends': {
-      const { runTrend } = await import('../trend.js');
-      runTrend(rawArgs.slice(1), process.cwd());
-      break;
-    }
     case 'init': {
       const { runInit } = await import('../scaffold.js');
       await runInit(rawArgs[1] || 'src/chemical-x', rawArgs, runAudit);
@@ -113,12 +107,6 @@ export const dispatchCommand = async (firstArg, rawArgs, runAudit, getPackageVer
       await runMutatorCli(rawArgs, true);
       break;
     }
-    case 'explode':
-    case 'unpack': {
-      const { runExplodeCli } = await import('../exploder.js');
-      await runExplodeCli(rawArgs.slice(1), true);
-      break;
-    }
     case 'add': {
       if (['prop', 'state', 'action'].includes(rawArgs[1])) {
         const { runMutatorCli } = await import('../mutators.js');

package/cli/generator-templates/archetypes/index.js

@@ -7,10 +7,6 @@ import { INPUT_ARCHETYPES } from './input-archetypes.js';
 import { LAYOUT_ARCHETYPES } from './layout-archetypes.js';
 import { DOMAIN_ARCHETYPES } from './domain-archetypes.js';
 import { STATUS_ARCHETYPES } from './status-archetypes.js';
-import { MINIMAL_ARCHETYPES } from './minimal-archetypes.js';
-import { matchArchetypeByVector } from './vector-matcher.js';
-
-export { matchArchetypeByVector };
 
 export const ALL_ARCHETYPES = [
   ...COLLECTION_ARCHETYPES,
@@ -20,24 +16,7 @@ export const ALL_ARCHETYPES = [
   ...STATUS_ARCHETYPES
 ];
 
-export const EXTENDED_ARCHETYPES = [
-  ...MINIMAL_ARCHETYPES,
-  ...ALL_ARCHETYPES
-];
-
-const isPartialMatch = (token, kw) => {
-  const isMinLength = token.length >= 3;
-  const isAffixMatch = token.startsWith(kw) || kw.startsWith(token);
-  return isMinLength && isAffixMatch;
-};
-
-export const resolveArchetype = (slug = '', description = '', explicitTemplate = '') => {
-  if (explicitTemplate) {
-    const templateNorm = String(explicitTemplate).toLowerCase().trim();
-    const exactMatch = EXTENDED_ARCHETYPES.find((a) => a.id === templateNorm || a.keywords.includes(templateNorm));
-    if (exactMatch) return exactMatch;
-  }
-
+export const resolveArchetype = (slug = '', description = '') => {
   const normalized = String(slug).toLowerCase().replace(/^(m-|a-|o-|t-|v-|use-)/, '');
   const slugTokens = normalized.split(/[-_]/).filter(Boolean);
   const descTokens = String(description)
@@ -61,7 +40,7 @@ export const resolveArchetype = (slug = '', description = '', explicitTemplate =
       for (const kw of archetype.keywords) {
         if (token === kw) {
           score += 12;
-        } else if (isPartialMatch(token, kw)) {
+        } else if (token.length >= 3 && (token.startsWith(kw) || kw.startsWith(token))) {
           score += 8;
         }
       }
@@ -74,7 +53,7 @@ export const resolveArchetype = (slug = '', description = '', explicitTemplate =
       for (const kw of archetype.keywords) {
         if (token === kw) {
           score += 7;
-        } else if (isPartialMatch(token, kw)) {
+        } else if (token.length >= 3 && (token.startsWith(kw) || kw.startsWith(token))) {
           score += 4;
         }
       }
@@ -86,19 +65,10 @@ export const resolveArchetype = (slug = '', description = '', explicitTemplate =
     }
   }
 
-  const hasKeywordWinner = Boolean(bestArchetype && highestScore > 0);
-  if (hasKeywordWinner) {
+  if (bestArchetype && highestScore > 0) {
     return bestArchetype;
   }
 
-  const hasDescription = Boolean(description && String(description).trim());
-  if (hasDescription) {
-    const vectorMatch = matchArchetypeByVector(description, 0.3);
-    if (vectorMatch) {
-      return vectorMatch.archetype;
-    }
-  }
-
   // Fallback to State Boundary (Archetype #22 in LAYOUT_ARCHETYPES)
   return LAYOUT_ARCHETYPES.find((a) => a.id === 'state-boundary') || ALL_ARCHETYPES[0];
 };

package/cli/generator-templates/controller.js

@@ -3,7 +3,7 @@ import { convertReactControllerToVue, convertReactControllerToSvelte } from './c
 
 export const buildController = (name, pascalName, options = {}) => {
   const fw = options.framework ? options.framework.toLowerCase() : 'react';
-  const archetype = resolveArchetype(name, options.description || options.desc, options.template || options.archetype);
+  const archetype = resolveArchetype(name, options.description || options.desc);
 
   if (archetype && typeof archetype.buildController === 'function') {
     const rawReactController = archetype.buildController(name, pascalName);

package/cli/generator-templates/react.js

@@ -3,7 +3,7 @@ import { resolveArchetype } from './archetypes/index.js';
 export const buildReactComponent = (name, pascalName, options = {}) => {
   const atomsPackage = options.atomsPackage || null;
   const hasController = options.hasController !== false;
-  const archetype = resolveArchetype(name, options.description || options.desc, options.template || options.archetype);
+  const archetype = resolveArchetype(name, options.description || options.desc);
 
   const atomImport = atomsPackage ? `import { AtomButton } from '${atomsPackage}';\n` : '';
   const controllerImport = hasController

package/cli/generator-templates/svelte.js

@@ -3,7 +3,7 @@ import { resolveArchetype } from './archetypes/index.js';
 export const buildSvelteComponent = (name, pascalName, options = {}) => {
   const atomsPackage = options.atomsPackage || null;
   const hasController = options.hasController !== false;
-  const archetype = resolveArchetype(name, options.description || options.desc, options.template || options.archetype);
+  const archetype = resolveArchetype(name, options.description || options.desc);
   const atomImport = atomsPackage ? `import { AtomButton } from '${atomsPackage}';\n` : '';
 
   const controllerImport = hasController

package/cli/generator-templates/types.js

@@ -1,7 +1,7 @@
 import { resolveArchetype } from './archetypes/index.js';
 
 export const buildPropsType = (name, pascalName, options = {}) => {
-  const archetype = resolveArchetype(name, options.description || options.desc, options.template || options.archetype);
+  const archetype = resolveArchetype(name, options.description || options.desc);
   if (archetype && typeof archetype.buildProps === 'function') {
     const rawProps = archetype.buildProps(name, pascalName);
     if (!rawProps.includes(`${pascalName}Emits`)) {
@@ -28,7 +28,7 @@ export interface ${pascalName}Emits {
 };
 
 export const buildStateType = (name, pascalName, options = {}) => {
-  const archetype = resolveArchetype(name, options.description || options.desc, options.template || options.archetype);
+  const archetype = resolveArchetype(name, options.description || options.desc);
   if (archetype && typeof archetype.buildState === 'function') {
     return archetype.buildState(name, pascalName);
   }

package/cli/generator-templates/vue.js

@@ -3,7 +3,7 @@ import { resolveArchetype } from './archetypes/index.js';
 export const buildVueComponent = (name, pascalName, options = {}) => {
   const atomsPackage = options.atomsPackage || null;
   const hasController = options.hasController !== false;
-  const archetype = resolveArchetype(name, options.description || options.desc, options.template || options.archetype);
+  const archetype = resolveArchetype(name, options.description || options.desc);
 
   const controllerImport = hasController
     ? `import { use${pascalName}Controller } from './${name}.controller';\n`

package/cli/generator-templates.js

@@ -27,4 +27,3 @@ export {
   buildViewIndex,
   buildViewSpec
 } from './generator-templates/views.js';
-export { buildCompactCapsule } from './generator-templates/compact.js';

package/cli/generator-templates.spec.js

@@ -180,8 +180,3 @@ test('archetypes: resolveArchetype matches from description keywords', () => {
   const cart = resolveArchetype('m-box', 'shopping cart checkout billing payment');
   assert.equal(cart.id, 'cart-billing');
 });
-
-test('archetypes: resolveArchetype matches from semantic vector embeddings on unknown slugs', () => {
-  const chat = resolveArchetype('m-quantum-nexus', 'live chat messages conversation thread');
-  assert.equal(chat.id, 'chat-messaging');
-});

package/cli/generator.js

@@ -5,7 +5,6 @@ import { checkOrPromptEvaluation } from './license.js';
 import {
   toPascalCase,
   toCamelCase,
-  resolveArchetype,
   buildReactComponent,
   buildVueComponent,
   buildSvelteComponent,
@@ -26,10 +25,9 @@ import {
   buildSvelteView,
   buildViewParamsType,
   buildViewIndex,
-  buildViewSpec,
-  buildCompactCapsule
+  buildViewSpec
 } from './generator-templates.js';
-import { detectFramework, resolveFramework, detectTierBaseDir, detectInstalledFamily, detectTestRunner, detectStylingStack } from './project-detector.js';
+import { detectFramework, resolveFramework, detectTierBaseDir, detectInstalledFamily, detectTestRunner } from './project-detector.js';
 
 const TIERS = [
   { prefix: 'm-', tier: 'molecule', label: '1. m- Molecule (Self-contained feature block < 100 lines - Recommended)' },
@@ -84,20 +82,11 @@ export const createCapsuleFiles = ({
   cwd = process.cwd(),
   desc = '',
   description = '',
-  template = null,
-  templateArg = null,
-  css = null,
-  compact = false,
-  flat = false,
   dryRun = false
 }) => {
   const capsuleDesc = desc || description || '';
   const cleanName = (name || 'user-avatar').trim().toLowerCase();
   const selectedTier = resolveSelectedTier(tier, cleanName);
-  const explicitTemplate = template || templateArg || null;
-  const isCompact = Boolean(compact || flat);
-  const styling = detectStylingStack(cwd);
-  const wantsNoScss = css === 'none' || css === 'tailwind' || (styling.hasTailwind && css !== 'scss');
 
   const resolvedFrameworkId = resolveFramework({ frameworkArg: framework, cwd });
   const selectedFramework = FRAMEWORKS.find(
@@ -123,56 +112,6 @@ export const createCapsuleFiles = ({
   const detectedDir = detectTierBaseDir(selectedTier.tier, cwd);
   const parentDir = targetParent || detectedDir;
   const resolvedParent = path.resolve(cwd, parentDir || '.');
-
-  const isHookOrView = selectedTier.tier === 'hook' || selectedTier.tier === 'view';
-  const canUseCompact = isCompact && !isHookOrView;
-  if (canUseCompact) {
-    const compFile = `${capsuleName}.${selectedFramework.ext}`;
-    const targetFilePath = path.resolve(resolvedParent, compFile);
-
-    if (!dryRun && fs.existsSync(targetFilePath)) {
-      throw new Error(`File ${compFile} already exists at ${targetFilePath}.`);
-    }
-
-    const archetype = resolveArchetype(capsuleName, capsuleDesc, explicitTemplate);
-    const installedFamily = detectInstalledFamily(cwd);
-    const compactContent = buildCompactCapsule({
-      capsuleName,
-      pascalName,
-      framework: selectedFramework.id,
-      archetype,
-      atomsPackage: installedFamily.atomsPackage
-    });
-
-    const filesCreated = [compFile];
-    const previews = [{ file: compFile, lines: compactContent.split('\n').length }];
-
-    if (!dryRun) {
-      if (!fs.existsSync(resolvedParent)) {
-        fs.mkdirSync(resolvedParent, { recursive: true });
-      }
-      fs.writeFileSync(targetFilePath, compactContent, 'utf-8');
-    }
-
-    const relTargetDir = path.relative(cwd, targetFilePath);
-
-    return {
-      success: true,
-      compact: true,
-      dryRun: Boolean(dryRun),
-      capsuleName,
-      pascalName,
-      framework: selectedFramework.id,
-      tier: selectedTier.tier,
-      targetDir: targetFilePath,
-      relativeDir: relTargetDir,
-      directory: relTargetDir,
-      files: filesCreated,
-      filesCreated,
-      previews
-    };
-  }
-
   const targetDir = path.resolve(resolvedParent, capsuleName);
   const runner = detectTestRunner(targetDir || cwd);
 
@@ -231,26 +170,24 @@ export const createCapsuleFiles = ({
       atomsPackage: installedFamily.atomsPackage,
       hasController,
       description: capsuleDesc,
-      framework: selectedFramework.id,
-      template: explicitTemplate
+      framework: selectedFramework.id
     };
 
     recordFile(compFile, path.join(targetDir, compFile), selectedFramework.compBuilder(capsuleName, pascalName, templateOpts));
     recordFile('index.ts', path.join(targetDir, 'index.ts'), buildIndex(capsuleName, pascalName, selectedFramework.ext, hasController));
     recordFile(specFile, path.join(targetDir, specFile), buildComponentSpec(capsuleName, pascalName, hasController, runner));
 
-    const domainOpts = { description: capsuleDesc, framework: selectedFramework.id, template: explicitTemplate };
-    recordFile('types/props.d.ts', path.join(typesDir, 'props.d.ts'), buildPropsType(capsuleName, pascalName, domainOpts));
-    recordFile('types/state.d.ts', path.join(typesDir, 'state.d.ts'), buildStateType(capsuleName, pascalName, domainOpts));
+    recordFile('types/props.d.ts', path.join(typesDir, 'props.d.ts'), buildPropsType(capsuleName, pascalName, { description: capsuleDesc, framework: selectedFramework.id }));
+    recordFile('types/state.d.ts', path.join(typesDir, 'state.d.ts'), buildStateType(capsuleName, pascalName, { description: capsuleDesc, framework: selectedFramework.id }));
     recordFile('types/index.ts', path.join(typesDir, 'index.ts'), buildTypesIndex(['props', 'state']));
     recordFile('types.d.ts', path.join(targetDir, 'types.d.ts'), "export * from './types/index';\n");
 
     if (hasController) {
       const controllerFile = `${capsuleName}.controller.ts`;
-      recordFile(controllerFile, path.join(targetDir, controllerFile), buildController(capsuleName, pascalName, domainOpts));
+      recordFile(controllerFile, path.join(targetDir, controllerFile), buildController(capsuleName, pascalName, { description: capsuleDesc, framework: selectedFramework.id }));
     }
 
-    if (!isLean && !wantsNoScss) {
+    if (!isLean) {
       const scssFile = `_${capsuleName}.scss`;
       recordFile(scssFile, path.join(targetDir, scssFile), buildScss(capsuleName));
     }
@@ -357,27 +294,6 @@ export const runGenerateWizard = async (rawArgs = []) => {
     .replace(/^--(desc|description|prompt)=/, '');
   const isDryRun = rawArgs.includes('--dry-run') || rawArgs.includes('-n');
 
-  const isBareOrMinimal = rawArgs.includes('--bare') || rawArgs.includes('--minimal');
-  const templateFlagMatch = (rawArgs.find((a) => a.startsWith('--template=')) || '').split('=')[1];
-  let templateArg = templateFlagMatch || null;
-  if (!templateArg && isBareOrMinimal) {
-    templateArg = 'minimal';
-  } else if (!templateArg && rawArgs.includes('--controls')) {
-    templateArg = 'controls';
-  } else if (!templateArg && rawArgs.includes('--canvas')) {
-    templateArg = 'canvas';
-  }
-
-  const cssFlagMatch = (rawArgs.find((a) => a.startsWith('--css=')) || '').split('=')[1];
-  let cssArg = cssFlagMatch || null;
-  if (!cssArg && rawArgs.includes('--no-scss')) {
-    cssArg = 'none';
-  }
-
-  const hasCompactFlag = rawArgs.includes('--compact');
-  const hasFlatFlag = rawArgs.includes('--flat');
-  const isCompact = hasCompactFlag || hasFlatFlag;
-
   if (!rawName && !isYes) {
     rawName = useGum
       ? gumInput('Capsule feature name (e.g. user-avatar, spark-kpi, auth-status):', 'user-avatar')
@@ -455,9 +371,6 @@ export const runGenerateWizard = async (rawArgs = []) => {
       isLean,
       cwd: process.cwd(),
       desc: descArg,
-      template: templateArg,
-      css: cssArg,
-      compact: isCompact,
       dryRun: isDryRun
     });
   } catch (err) {

package/cli/index.js

@@ -67,12 +67,11 @@ export const patchFile       = async (...a) => (await import('./patcher.js')).pa
 export const runWriterCli    = async (...a) => (await import('./patcher.js')).runWriterCli(...a);
 export const writeFile       = async (...a) => (await import('./patcher.js')).writeFile(...a);
 export const runTeamCli      = async (...a) => (await import('./team/index.js')).runTeamCli(...a);
-export const runTrend        = async (...a) => (await import('./trend.js')).runTrend(...a);
 export const runPillarsWizard = async (...a) => (await import('./pillars-wizard.js')).runPillarsWizard(...a);
 export { handleError, withErrorCatcher, publishIssue };
 
 // ---------------------------------------------------------------------------
-// Allowed commands guard (exits early before any heavy import)
+// Allowed commands guard (exits early — before any heavy import)
 // ---------------------------------------------------------------------------
 
 export const ALLOWED_COMMANDS = new Set([
@@ -81,9 +80,7 @@ export const ALLOWED_COMMANDS = new Set([
   'patch', 'edit',
   'write',
   'generate', 'g', 'gen', 'capsule', 'add',
-  'explode', 'unpack',
   'audit',
-  'trend', 'trends',
   'verify', 'check:all',
   'team', 'swarm', 'feed',
   'pillars', 'rules', 'config:pillars',
@@ -103,7 +100,7 @@ export const ALLOWED_COMMANDS = new Set([
 ]);
 
 // ---------------------------------------------------------------------------
-// main: thin orchestrator; real dispatch lives in cmd-router.js
+// main — thin orchestrator; real dispatch lives in cmd-router.js
 // ---------------------------------------------------------------------------
 
 const main = async () => {

package/cli/mcp/antigravity.js

@@ -8,9 +8,8 @@ export const buildMcpInstructions = () => {
     '# Chemical X Protocol: Master MCP Gateway Guide (chemical-x / chemx)',
     '',
     'MASTER TOOL: "chemx" (chemical-x / chemx)',
-    'Provides all Chemical X operations through a single tool. This avoids requiring',
-    'separate approval for each sub-operation in MCP clients that gate tool access per-tool.',
-    'Pass the desired operation via the action parameter; see action: \'help\' for the full list.',
+    'Recommended gateway tool for all Chemical X operations. Dispatches all sub-operations',
+    'through a single tool for token efficiency and single-point authorization.',
     '',
     '1. TESTING, BUILDS & VERIFICATION:',
     '   - chemx({ action: "test" }) or chemx({ command: "test" })',

package/cli/mcp/manifests.js

@@ -5,7 +5,7 @@
 
 export const MASTER_MCP_TOOL = {
   name: 'chemx',
-  description: "Provides all Chemical X operations (search, generate, patch, audit, verify, team) through a single tool. This avoids requiring separate approval for each sub-operation in MCP clients that gate tool access per-tool. Pass the desired operation via the action parameter; see action: 'help' for the full list.",
+  description: 'Chemical X Protocol Master Gateway: provides all Chemical X operations (test, build, verify, typecheck, audit, read, patch, write, check, q, team, autofix, generate, patterns, issue) through a single unified tool. Recommended for token efficiency and single-point authorization.',
   inputSchema: {
     type: 'object',
     properties: {

package/cli/mcp/tools-search.js

@@ -11,7 +11,6 @@ import {
   querySemanticIndex,
   queryHybridIndex
 } from '../search-queries.js';
-import { findSimilarSymbols } from '../search-queries-similar.js';
 import { readTokenOptimized } from '../reader.js';
 import { patchFile, writeFile } from '../patcher.js';
 import { toColumnar } from '../columnar.js';
@@ -186,12 +185,7 @@ export const handleChemxRead = (args = {}, cwd = process.cwd()) => {
       const blast = calculateBlastRadius(db, args.symbol || targetPath);
       if (args.symbol) {
         const refs = findSymbolReferences(db, args.symbol);
-        const similar = findSimilarSymbols(db, args.symbol, 3);
-        const hasSimilar = similar.length > 0;
-        const simSuffix = hasSimilar
-          ? ` Similar symbols: ${similar.map((s) => `${s.name} (${Math.round(s.similarity * 100)}%)`).join(', ')}.`
-          : '';
-        connectionCard = `\n// Connections for ${args.symbol}: referenced by ${refs.length} file(s) [${refs.slice(0, 3).map((r) => path.basename(r.importerPath)).join(', ')}]. Blast Radius: ${blast.totalImpactCount} affected file(s) across ${blast.depth} hops (${blast.impactedTests.length} tests).${simSuffix}`;
+        connectionCard = `\n// Connections for ${args.symbol}: referenced by ${refs.length} file(s) [${refs.slice(0, 3).map((r) => path.basename(r.importerPath)).join(', ')}]. Blast Radius: ${blast.totalImpactCount} affected file(s) across ${blast.depth} hops (${blast.impactedTests.length} tests).`;
       } else {
         const deps = findFileDependencies(db, targetPath);
         const dependents = findFileDependents(db, targetPath);

package/cli/mcp/tools.js

@@ -15,8 +15,6 @@ import { runBuildAudit } from '../build.js';
 import { runAutofix } from '../audit/autofix.js';
 import { runTypecheckAudit, runTestAudit, runProjectVerify } from '../verify.js';
 import { syncSearchIndex, syncViolationsIndex, recordAuditSnapshot } from '../search.js';
-import { openIndexDb } from '../search-schema.js';
-import { fetchScoreTrends, formatTrendReport, renderSparkline } from '../trend.js';
 import { MCP_TOOLS, ALL_MCP_TOOLS } from './manifests.js';
 import {
   resolveTargetCwd,
@@ -288,24 +286,6 @@ const handleChemxVerify = async (args = {}, cwd = process.cwd()) => {
   });
 };
 
-const handleChemxTrend = async (args = {}, cwd = process.cwd()) => {
-  const targetCwd = resolveTargetCwd(args.cwd || cwd);
-  const db = openIndexDb(targetCwd);
-  const limit = args.limit || 10;
-  const snapshots = fetchScoreTrends(db, limit);
-  if (args.json) {
-    const scores = snapshots.map((s) => s.score);
-    return {
-      count: snapshots.length,
-      sparkline: renderSparkline(scores),
-      latestScore: snapshots.length ? snapshots[snapshots.length - 1].score : null,
-      delta: snapshots.length >= 2 ? snapshots[snapshots.length - 1].score - snapshots[0].score : 0,
-      snapshots
-    };
-  }
-  return formatTrendReport(snapshots);
-};
-
 const handleChemx = async (args = {}, cwd = process.cwd()) => {
   let action = args.action;
   let params = args.params || {};
@@ -351,14 +331,11 @@ const handleChemx = async (args = {}, cwd = process.cwd()) => {
     } else if (subCmd === 'autofix') {
       action = 'autofix';
       params = { path: parts[1] || 'src', ...params };
-    } else if (subCmd === 'trend' || subCmd === 'trends') {
-      action = 'trend';
     }
   }
 
   const DISPATCHER = {
     audit: handleAudit,
-    trend: handleChemxTrend,
     build: handleAuditBuild,
     verify: handleChemxVerify,
     typecheck: handleChemxTypecheck,