multi-agents-cli 1.1.65 → 1.1.67

package/init.js

@@ -38,7 +38,7 @@ const {
   ORM_OPTIONS,
   AUTH_OPTIONS,
   IDE_CANDIDATES,
-} = require('./lib/questions');
+} = require('./lib/data-config');
 
 const {
   expandWinPath,

package/lib/questions-flow.js

@@ -8,7 +8,7 @@ const {
   CLIENT_FRAMEWORKS, BACKEND_FRAMEWORKS, FRAMEWORK_VERSION_FALLBACK,
   fetchLatestVersions, STATE_OPTIONS, UI_OPTIONS, STYLING_OPTIONS,
   DB_OPTIONS, ORM_OPTIONS_BY_DB, ORM_OPTIONS, AUTH_OPTIONS,
-} = require('./questions');
+} = require('./data-config');
 const { buildIDEOptions, verifyIDE, detectTerminal } = require('./detect');
 
 // ── Step definitions ──────────────────────────────────────────────────────────
@@ -23,7 +23,7 @@ const buildStepDefs = (IDE_CANDIDATES) => [
     run: async (machine, answers) => {
       stepHeader(1, 12);
       console.log(`\n${bold(blue('Client configuration'))}`);
-      return await selectRequired('* Client framework (required):', CLIENT_FRAMEWORKS, machine, 0);
+      return await selectRequired('* Client framework (required):', CLIENT_FRAMEWORKS, machine, 0, answers);
     },
   },
 
@@ -60,7 +60,7 @@ const buildStepDefs = (IDE_CANDIDATES) => [
     run: async (machine, answers) => {
       stepHeader(3, 12);
       const opts = STATE_OPTIONS[answers.clientFw.value] || [];
-      return await selectOptional('State management:', opts, machine, 2);
+      return await selectOptional('State management:', opts, machine, 2, answers);
     },
   },
 
@@ -70,7 +70,7 @@ const buildStepDefs = (IDE_CANDIDATES) => [
     run: async (machine, answers) => {
       stepHeader(4, 12);
       const opts = UI_OPTIONS[answers.clientFw.value] || [];
-      return await selectOptional('UI library:', opts, machine, 3);
+      return await selectOptional('UI library:', opts, machine, 3, answers);
     },
   },
 
@@ -79,7 +79,7 @@ const buildStepDefs = (IDE_CANDIDATES) => [
     name: 'clientStyle',
     run: async (machine, answers) => {
       stepHeader(5, 12);
-      return await selectOptional('Styling:', STYLING_OPTIONS, machine, 4);
+      return await selectOptional('Styling:', STYLING_OPTIONS, machine, 4, answers);
     },
   },
 
@@ -157,7 +157,7 @@ const buildStepDefs = (IDE_CANDIDATES) => [
     run: async (machine, answers) => {
       stepHeader(9, 12);
       if (!answers.backendFwObj) return null;
-      return await selectOptional('Database type:', DB_OPTIONS, machine, 8);
+      return await selectOptional('Database type:', DB_OPTIONS, machine, 8, answers);
     },
   },
 
@@ -169,7 +169,7 @@ const buildStepDefs = (IDE_CANDIDATES) => [
       const { backendFwObj, backendDb } = answers;
       if (!backendFwObj || !backendDb) return null;
       const ormChoices = ORM_OPTIONS_BY_DB[backendDb] || ORM_OPTIONS[backendFwObj.value] || [];
-      return await selectOptional('ORM / query layer:', ormChoices, machine, 9);
+      return await selectOptional('ORM / query layer:', ormChoices, machine, 9, answers);
     },
   },
 
@@ -180,7 +180,7 @@ const buildStepDefs = (IDE_CANDIDATES) => [
       stepHeader(11, 12);
       const { backendFwObj } = answers;
       if (!backendFwObj) return null;
-      return await selectOptional('Auth strategy:', AUTH_OPTIONS[backendFwObj.value] || [], machine, 10);
+      return await selectOptional('Auth strategy:', AUTH_OPTIONS[backendFwObj.value] || [], machine, 10, answers);
     },
   },
 
@@ -206,7 +206,7 @@ const buildStepDefs = (IDE_CANDIDATES) => [
       else                               console.log(`\n  ${'\x1b[33m'}No IDEs detected.${'\x1b[0m'}\n`);
 
       while (true) {
-        const ideChoice = await selectRequired('* IDE / editor (required):', sorted, machine, 11);
+        const ideChoice = await selectRequired('* IDE / editor (required):', sorted, machine, 11, answers);
         if (ideChoice === RESTART || ideChoice === BACK) return ideChoice;
 
         if (ideChoice.cmd && !ideChoice.detected) {

package/lib/ui.js

@@ -121,36 +121,90 @@ const stepHeader = (stepIndex, totalSteps) => {
 // ── Step selection helpers ────────────────────────────────────────────────────
 
 const { BACK, RESTART } = require('./steps');
+const { validateCombination } = require('./validate');
 
-const selectRequired = async (prompt, items, stepMachine, stepIndex) => {
+const NONE_LABEL = '→ None of these - I\'ll specify my own';
+
+const selectRequired = async (prompt, items, stepMachine, stepIndex, context = {}) => {
   const isFirstStep = stepIndex <= 1;
   const navOpts = stepMachine ? stepMachine.navOptions(stepIndex, isFirstStep) : [];
-  const allItems = [...items, ...navOpts];
+  const noneOpt = { label: NONE_LABEL };
+  const allItems = [...items, noneOpt, ...navOpts];
 
   const idx = await arrowSelect(prompt, allItems.map(i => ({ label: typeof i === 'string' ? i : i.label })));
 
-  if (idx >= items.length) {
-    const nav = navOpts[idx - items.length];
+  // 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) {
+    const nav = navOpts[idx - items.length - 1];
     return nav ? nav.value : RESTART;
   }
   return items[idx];
 };
 
-const selectOptional = async (prompt, items, stepMachine, stepIndex) => {
+const selectOptional = async (prompt, items, stepMachine, stepIndex, context = {}) => {
   if (!items || items.length === 0) return null;
   const isFirstStep = stepIndex <= 1;
   const navOpts = stepMachine ? stepMachine.navOptions(stepIndex, isFirstStep) : [];
   const choices = [
     ...items.map(i => ({ label: typeof i === 'string' ? i : i.label })),
     { label: dim('Skip (agent will propose when needed)') },
+    { label: NONE_LABEL },
     ...navOpts.map(n => ({ label: n.label })),
   ];
 
   const idx = await arrowSelect(prompt, choices);
 
   if (idx === items.length) return null; // skip
-  if (idx > items.length) {
-    const nav = navOpts[idx - items.length - 1];
+
+  // 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) {
+    const nav = navOpts[idx - items.length - 2];
     return nav ? nav.value : RESTART;
   }
   return typeof items[idx] === 'string' ? items[idx] : items[idx].value;

package/lib/validate.js

@@ -0,0 +1,73 @@
+'use strict';
+
+// ── Compatibility matrix ──────────────────────────────────────────────────────
+
+const PYTHON_BACKENDS  = ['FastAPI', 'Django'];
+const NODE_BACKENDS    = ['Express', 'NestJS', 'Fastify'];
+const NODE_ONLY_ORMS   = ['Prisma', 'TypeORM', 'Drizzle', 'Sequelize', 'MikroORM', 'raw pg driver', 'raw mysql2 driver', 'better-sqlite3'];
+const PYTHON_ONLY_ORMS = ['SQLAlchemy', 'Tortoise ORM', 'Django ORM (built-in)'];
+const MONGO_ONLY_ORMS  = ['Beanie (MongoDB)'];
+const NEXTJS_ONLY_LIBS = ['shadcn/ui', 'Radix UI'];
+const MONGO_DBS        = ['MongoDB'];
+
+// ── 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;
+
+  // Node.js ORM + Python backend
+  if (NODE_ONLY_ORMS.includes(chosen) && PYTHON_BACKENDS.includes(backendFw)) {
+    return {
+      valid:        false,
+      reason:       `${chosen} is a Node.js ORM and does not support ${backendFw} (Python).`,
+      alternatives: backendFw === 'Django'
+        ? ['Django ORM (built-in)', 'SQLAlchemy']
+        : ['SQLAlchemy', 'Tortoise ORM', 'raw asyncpg'],
+    };
+  }
+
+  // Python ORM + Node.js backend
+  if (PYTHON_ONLY_ORMS.includes(chosen) && NODE_BACKENDS.includes(backendFw)) {
+    return {
+      valid:        false,
+      reason:       `${chosen} is a Python ORM and does not support ${backendFw} (Node.js).`,
+      alternatives: ['Prisma', 'TypeORM', 'Drizzle'],
+    };
+  }
+
+  // Beanie + non-MongoDB
+  if (MONGO_ONLY_ORMS.includes(chosen) && backendDb && !MONGO_DBS.includes(backendDb)) {
+    return {
+      valid:        false,
+      reason:       `Beanie is a MongoDB ODM and does not support ${backendDb}.`,
+      alternatives: ['Prisma', 'TypeORM', 'Drizzle'],
+    };
+  }
+
+  // Next.js-only UI libs + Vite+React
+  if (NEXTJS_ONLY_LIBS.includes(chosen) && clientFw === 'Vite+React') {
+    return {
+      valid:        false,
+      reason:       `${chosen} is optimized for Next.js and may not work correctly with Vite+React.`,
+      alternatives: ['MUI', 'Chakra UI', 'Ant Design'],
+    };
+  }
+
+  // Ambiguous cross-boundary (e.g. dotnet as both client and backend)
+  if (chosen && backendFw && chosen.toLowerCase() === backendFw.toLowerCase()) {
+    return {
+      valid:        false,
+      reason:       `${chosen} appears in both client and backend selections - this may cause scope ambiguity.`,
+      alternatives: [],
+    };
+  }
+
+  return { valid: true, reason: null, alternatives: [] };
+};
+
+module.exports = { validateCombination };

package/package.json

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