multi-agents-cli 1.1.67 → 1.1.69

package/lib/questions-flow.js

@@ -168,7 +168,9 @@ const buildStepDefs = (IDE_CANDIDATES) => [
       stepHeader(10, 12);
       const { backendFwObj, backendDb } = answers;
       if (!backendFwObj || !backendDb) return null;
-      const ormChoices = ORM_OPTIONS_BY_DB[backendDb] || ORM_OPTIONS[backendFwObj.value] || [];
+      const byDb = ORM_OPTIONS_BY_DB[backendDb] || [];
+      const byFw = ORM_OPTIONS[backendFwObj.value] || [];
+      const ormChoices = byDb.length && byFw.length ? byDb.filter(o => byFw.includes(o)) : byDb.length ? byDb : byFw;
       return await selectOptional('ORM / query layer:', ormChoices, machine, 9, answers);
     },
   },

package/lib/ui.js

@@ -121,10 +121,78 @@ const stepHeader = (stepIndex, totalSteps) => {
 // ── Step selection helpers ────────────────────────────────────────────────────
 
 const { BACK, RESTART } = require('./steps');
-const { validateCombination } = require('./validate');
+const { validateCombination, checkFrameworkExists, fuzzyMatchFramework } = require('./validate');
 
 const NONE_LABEL = '→ None of these - I\'ll specify my own';
 
+// ── Free-text handler (shared by selectRequired + selectOptional) ────────────
+
+const handleFreeText = async (prompt, items, stepMachine, stepIndex, context, isOptional) => {
+  const _res = await prompts({ type: 'text', name: 'value', message: 'Type your own value:' }, { onCancel: () => process.exit(0) });
+  const typed = (_res.value || '').trim();
+  if (!typed) return isOptional ? null : handleFreeText(prompt, items, stepMachine, stepIndex, context, isOptional);
+
+  // Fuzzy match first - before registry check
+  const matches = fuzzyMatchFramework(typed);
+  if (matches.length > 0) {
+    const didYouMeanOpts = [
+      ...matches.map(m => `→ ${m.label || m}`),
+      `→ Type a different value`,
+    ];
+    const choice = await arrowSelect(`"${typed}" couldn't be verified. Did you mean:`, didYouMeanOpts.map(o => ({ label: o })));
+    if (choice < matches.length) return matches[choice]; // returns full framework object
+    return handleFreeText(prompt, items, stepMachine, stepIndex, context, isOptional);
+  }
+
+  // Live registry check - only when no fuzzy match
+  console.log(dim('  Verifying...'));
+  const existence = await checkFrameworkExists(typed);
+
+  if (!existence.exists) {
+    console.log('');
+    const riskOpts = [
+      `→ Proceed with "${typed}" - I accept the risks`,
+      `→ Type a different value`,
+    ];
+    const choice = await arrowSelect(`"${typed}" couldn't be verified.`, riskOpts.map(o => ({ label: o })));
+    if (choice === 1) return handleFreeText(prompt, items, stepMachine, stepIndex, context, isOptional);
+    // Show risk consequence block
+    console.log('');
+    console.log(`  ${yellow('⚠ Proceeding with an unverified framework may result in:')}`);
+    console.log(dim('    · Agent spending excessive tokens resolving unknown setup'));
+    console.log(dim('    · Incorrect scaffold structure for this framework'));
+    console.log(dim('    · Missing contracts and integration points'));
+    console.log(dim('    · Potential mid-flow failures requiring full restart'));
+    console.log('');
+    const confirm = await arrowSelect('Confirm you understand and want to continue?', [
+      { label: `→ Yes - proceed with "${typed}"` },
+      { label: `→ No - let me pick something else` },
+    ]);
+    if (confirm === 1) return handleFreeText(prompt, items, stepMachine, stepIndex, context, isOptional);
+    return typed;
+  }
+
+  // Valid + verified - check compatibility
+  const check = validateCombination(typed, context);
+  if (!check.valid) {
+    console.log(`
+  ${yellow('⚠')} ${check.reason}
+`);
+    const opts = [
+      '→ Continue - I understand the tradeoff',
+      ...check.alternatives.map(a => `→ ${a}`),
+      '→ Type a different value',
+    ];
+    const choice = await arrowSelect('How would you like to proceed?', opts.map(o => ({ label: o })));
+    if (choice === 0) return typed;
+    if (choice === opts.length - 1) return handleFreeText(prompt, items, stepMachine, stepIndex, context, isOptional);
+    return check.alternatives[choice - 1];
+  }
+
+  console.log(dim('  Custom value - the agent will handle compatibility at runtime.'));
+  return typed;
+};
+
 const selectRequired = async (prompt, items, stepMachine, stepIndex, context = {}) => {
   const isFirstStep = stepIndex <= 1;
   const navOpts = stepMachine ? stepMachine.navOptions(stepIndex, isFirstStep) : [];
@@ -133,29 +201,7 @@ const selectRequired = async (prompt, items, stepMachine, stepIndex, context = {
 
   const idx = await arrowSelect(prompt, allItems.map(i => ({ label: typeof i === 'string' ? i : i.label })));
 
-  // None of these - free text input
-  if (idx === items.length) {
-    const _res = await prompts({ type: 'text', name: 'value', message: 'Type your own value:' }, { onCancel: () => process.exit(0) });
-    const typed = (_res.value || '').trim();
-    if (!typed) return null;
-    const check = validateCombination(typed, context);
-    if (!check.valid) {
-      console.log(`
-  ${yellow('⚠')} ${check.reason}
-`);
-      const opts = [
-        '→ Continue - I understand the tradeoff',
-        ...check.alternatives.map(a => `→ ${a}`),
-        '→ Type a different value',
-      ];
-      const choice = await arrowSelect('How would you like to proceed?', opts.map(o => ({ label: o })));
-      if (choice === 0) return typed;
-      if (choice === opts.length - 1) return selectRequired(prompt, items, stepMachine, stepIndex, context);
-      return check.alternatives[choice - 1];
-    }
-    console.log(dim('  Custom value - the agent will handle compatibility at runtime.'));
-    return typed;
-  }
+  if (idx === items.length) return handleFreeText(prompt, items, stepMachine, stepIndex, context, false);
 
   if (idx > items.length) {
     const nav = navOpts[idx - items.length - 1];
@@ -178,30 +224,7 @@ const selectOptional = async (prompt, items, stepMachine, stepIndex, context = {
   const idx = await arrowSelect(prompt, choices);
 
   if (idx === items.length) return null; // skip
-
-  // None of these - free text input
-  if (idx === items.length + 1) {
-    const _res = await prompts({ type: 'text', name: 'value', message: 'Type your own value:' }, { onCancel: () => process.exit(0) });
-    const typed = (_res.value || '').trim();
-    if (!typed) return null;
-    const check = validateCombination(typed, context);
-    if (!check.valid) {
-      console.log(`
-  ${yellow('⚠')} ${check.reason}
-`);
-      const opts = [
-        '→ Continue - I understand the tradeoff',
-        ...check.alternatives.map(a => `→ ${a}`),
-        '→ Type a different value',
-      ];
-      const choice = await arrowSelect('How would you like to proceed?', opts.map(o => ({ label: o })));
-      if (choice === 0) return typed;
-      if (choice === opts.length - 1) return selectOptional(prompt, items, stepMachine, stepIndex, context);
-      return check.alternatives[choice - 1];
-    }
-    console.log(dim('  Custom value - the agent will handle compatibility at runtime.'));
-    return typed;
-  }
+  if (idx === items.length + 1) return handleFreeText(prompt, items, stepMachine, stepIndex, context, true);
 
   if (idx > items.length + 1) {
     const nav = navOpts[idx - items.length - 2];

package/lib/validate.js

@@ -1,5 +1,9 @@
 'use strict';
 
+const { FRAMEWORK_REGISTRY, CLIENT_FRAMEWORKS, BACKEND_FRAMEWORKS } = require('./data-config');
+
+const ALL_FRAMEWORKS = [...CLIENT_FRAMEWORKS, ...BACKEND_FRAMEWORKS];
+
 // ── Compatibility matrix ──────────────────────────────────────────────────────
 
 const PYTHON_BACKENDS  = ['FastAPI', 'Django'];
@@ -10,15 +14,64 @@ const MONGO_ONLY_ORMS  = ['Beanie (MongoDB)'];
 const NEXTJS_ONLY_LIBS = ['shadcn/ui', 'Radix UI'];
 const MONGO_DBS        = ['MongoDB'];
 
+// ── fuzzyMatchFramework ───────────────────────────────────────────────────────
+// Returns up to 3 known framework names that loosely match the typed value
+
+const fuzzyMatchFramework = (typed) => {
+  const lower = typed.toLowerCase().replace(/[^a-z0-9]/g, '');
+  const matchedNames = Object.keys(FRAMEWORK_REGISTRY).filter(name => {
+    const n = name.toLowerCase().replace(/[^a-z0-9]/g, '');
+    return n.includes(lower) || lower.includes(n) || (lower.length >= 3 && n.startsWith(lower.slice(0, 3)));
+  }).slice(0, 3);
+  return matchedNames.map(name => ALL_FRAMEWORKS.find(f => f.value === name) || { label: name, value: name });
+};
+
+// ── checkFrameworkExists ──────────────────────────────────────────────────────
+// Checks npm then pypi for the typed framework name
+// Returns { exists: boolean, registry: string|null }
+
+const checkFrameworkExists = async (name) => {
+  const known = FRAMEWORK_REGISTRY[name];
+  if (known && known.package) return { exists: true, registry: known.registry };
+  if (known && !known.package) return { exists: true, registry: known.registry }; // Laravel/Rails - known but no package
+
+  const https = require('https');
+  const fetch = (url) => new Promise((resolve, reject) => {
+    const req = https.get(url, { timeout: 4000 }, (res) => {
+      let data = '';
+      res.on('data', chunk => data += chunk);
+      res.on('end', () => resolve({ status: res.statusCode, data }));
+    });
+    req.on('error', reject);
+    req.on('timeout', () => { req.destroy(); reject(new Error('timeout')); });
+  });
+
+  const slug = name.toLowerCase().replace(/\s+/g, '-');
+
+  // Try npm
+  try {
+    const res = await fetch(`https://registry.npmjs.org/${slug}`);
+    if (res.status === 200) return { exists: true, registry: 'npm' };
+  } catch {}
+
+  // Try pypi
+  try {
+    const res = await fetch(`https://pypi.org/pypi/${slug}/json`);
+    if (res.status === 200) return { exists: true, registry: 'pypi' };
+  } catch {}
+
+  return { exists: false, registry: null };
+};
+
 // ── validateCombination ───────────────────────────────────────────────────────
 // chosen  — the value just entered (string)
 // context — answers accumulated so far { clientFw, backendFwObj, backendDb, ... }
 // returns { valid, reason, alternatives }
 
 const validateCombination = (chosen, context = {}) => {
-  const clientFw    = context.clientFw?.value    || context.clientFw    || null;
-  const backendFw   = context.backendFwObj?.value || context.backendFwObj || null;
-  const backendDb   = context.backendDb           || null;
+  const clientFw  = context.clientFw?.value    || context.clientFw    || null;
+  const backendFw = context.backendFwObj?.value || context.backendFwObj || null;
+  const backendDb = context.backendDb           || null;
 
   // Node.js ORM + Python backend
   if (NODE_ONLY_ORMS.includes(chosen) && PYTHON_BACKENDS.includes(backendFw)) {
@@ -58,7 +111,7 @@ const validateCombination = (chosen, context = {}) => {
     };
   }
 
-  // Ambiguous cross-boundary (e.g. dotnet as both client and backend)
+  // Ambiguous cross-boundary
   if (chosen && backendFw && chosen.toLowerCase() === backendFw.toLowerCase()) {
     return {
       valid:        false,
@@ -70,4 +123,4 @@ const validateCombination = (chosen, context = {}) => {
   return { valid: true, reason: null, alternatives: [] };
 };
 
-module.exports = { validateCombination };
+module.exports = { validateCombination, checkFrameworkExists, fuzzyMatchFramework };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "multi-agents-cli",
-  "version": "1.1.67",
+  "version": "1.1.69",
   "description": "Multi-agent workflow orchestration for Claude Code — isolated git worktrees, structured state tracking, autonomous task chaining",
   "keywords": [
     "claude-code",