multi-agents-cli 1.1.78 → 1.1.79

package/init.js

@@ -38,6 +38,8 @@ const {
   ORM_OPTIONS,
   AUTH_OPTIONS,
   IDE_CANDIDATES,
+  BLOCK_CONFIG,
+  INTENT_MAP,
 } = require('./lib/data-config');
 
 const {
@@ -373,6 +375,41 @@ const main = async () => {
   steps.push(0, 'Project name', projectName);
   separator();
 
+  // ── Intent selection ────────────────────────────────────────────────────────
+  rl.pause();
+  const intentChoices = Object.entries(INTENT_MAP).map(([k, v]) => ({ label: v.label, value: k }));
+  const intentIdx = await arrowSelect('What would you like to build?', intentChoices);
+  const intentKey = intentChoices[intentIdx].value;
+  const intent    = INTENT_MAP[intentKey];
+
+  // Secondary prompt for fullstack order
+  let blockOrder = intent.blocks;
+  if (intentKey === 'fullstack') {
+    const orderIdx = await arrowSelect('Full-stack order?', [
+      { label: 'Client first, then backend' },
+      { label: 'Backend first, then client' },
+    ]);
+    blockOrder = orderIdx === 0 ? ['client', 'backend'] : ['backend', 'client'];
+  }
+
+  // Activate blocks and resolve absolute step indices
+  let absoluteStep = 0;
+  const blockEntries = [];
+  for (const blockKey of blockOrder) {
+    const block = BLOCK_CONFIG[blockKey];
+    block.isActive = true;
+    let isFirstSeg = true;
+    for (const [segKey, seg] of Object.entries(block)) {
+      if (segKey === 'isActive' || typeof seg !== 'object' || !('step' in seg)) continue;
+      seg.absoluteStep = absoluteStep;
+      if (isFirstSeg) { blockEntries.push(absoluteStep); isFirstSeg = false; }
+      absoluteStep++;
+    }
+  }
+  steps.blockEntries = blockEntries;
+
+  separator();
+
   // Run all question steps with back-nav support
   const answers = await runQuestions(stepDefs, steps);
   if (answers === RESTART) {
@@ -389,7 +426,7 @@ const main = async () => {
   const clientUi             = answers.clientUi || null;
   const clientStyle          = answers.clientStyle || null;
   const useIntegratedBackend = answers.useIntegratedBackend || false;
-  const backendFwObj         = answers.backendFwObj || null;
+  const backendFwObj         = answers.backendFw || null;
   const backendFw            = backendFwObj ? fwValue(backendFwObj)    : null;
   const backendLang          = backendFwObj ? backendFwObj.language : null;
   const backendOrm           = answers.backendOrm || null;

package/lib/data-config.js

@@ -258,8 +258,37 @@ const BLOCKS = {
   SHARED:  'shared',
 };
 
+// ── Block config ─────────────────────────────────────────────────────────────
+
+const BLOCK_CONFIG = {
+  client: {
+    isActive: true,
+    framework:       { data: CLIENT_FRAMEWORKS, required: true,  key: 'clientFw',    step: 0 },
+    stateManagement: { data: STATE_OPTIONS,     required: false, key: 'clientState', step: 1 },
+    uiLibrary:       { data: UI_OPTIONS,        required: false, key: 'clientUi',    step: 2 },
+    styling:         { data: STYLING_OPTIONS,   required: false, key: 'clientStyle', step: 3 },
+  },
+  backend: {
+    isActive: false,
+    framework:       { data: BACKEND_FRAMEWORKS, required: false, key: 'backendFw',   step: 0 },
+    database:        { data: DB_OPTIONS,         required: false, key: 'backendDb',   step: 1 },
+    orm:             { data: ORM_OPTIONS,        required: false, key: 'backendOrm',  step: 2 },
+    auth:            { data: AUTH_OPTIONS,       required: false, key: 'backendAuth', step: 3 },
+  },
+};
+
+// ── Intent map ────────────────────────────────────────────────────────────────
+
+const INTENT_MAP = {
+  fullstack: { label: 'Full-stack',    blocks: ['client', 'backend'], order: null },
+  frontend:  { label: 'Frontend only', blocks: ['client'],            order: null },
+  backend:   { label: 'Backend only',  blocks: ['backend'],           order: null },
+};
+
 module.exports = {
   BLOCKS,
+  BLOCK_CONFIG,
+  INTENT_MAP,
   FRAMEWORK_CONVENTIONS,
   CLIENT_FRAMEWORKS,
   BACKEND_FRAMEWORKS,

package/lib/questions-flow.js

@@ -105,7 +105,7 @@ const buildStepDefs = (IDE_CANDIDATES) => [
 
   // ── Step 6: Backend framework ────────────────────────────────────────────────
   {
-    name: 'backendFwObj',
+    name: 'backendFw',
     run: async (machine, answers) => {
       stepHeader(7, 12);
       if (answers.useIntegratedBackend) return null; // skip
@@ -114,16 +114,7 @@ const buildStepDefs = (IDE_CANDIDATES) => [
       console.log(`\n${bold(blue('Backend configuration'))}`);
       console.log(dim('  You can skip the backend framework and decide later.\n'));
 
-      const choices = [
-        ...BACKEND_FRAMEWORKS.map(f => ({ label: f.label || f.value })),
-        { label: dim('Skip (decide later)') },
-      ];
-      const idx = await arrowSelect('Backend framework:', choices);
-
-      // Back nav
-      if (idx >= BACKEND_FRAMEWORKS.length + 1) return BACK;
-
-      return idx === BACKEND_FRAMEWORKS.length ? null : BACKEND_FRAMEWORKS[idx];
+      return await selectOptional('Backend framework:', BACKEND_FRAMEWORKS, machine, 6, answers, BLOCKS.BACKEND);
     },
   },
 
@@ -132,7 +123,7 @@ const buildStepDefs = (IDE_CANDIDATES) => [
     name: 'backendFwVersion',
     run: async (machine, answers) => {
       stepHeader(8, 12);
-      const fwObj = answers.backendFwObj;
+      const fwObj = answers.backendFw;
       if (!fwObj) return null; // skip — no backend selected
 
       const versions = await fetchLatestVersions(fwValue(fwObj)) || FRAMEWORK_VERSION_FALLBACK[fwValue(fwObj)] || [];
@@ -159,7 +150,7 @@ const buildStepDefs = (IDE_CANDIDATES) => [
     name: 'backendDb',
     run: async (machine, answers) => {
       stepHeader(9, 12);
-      if (!answers.backendFwObj) return null;
+      if (!answers.backendFw) return null;
       return await selectOptional('Database type:', DB_OPTIONS, machine, 8, answers, BLOCKS.BACKEND);
     },
   },
@@ -169,10 +160,10 @@ const buildStepDefs = (IDE_CANDIDATES) => [
     name: 'backendOrm',
     run: async (machine, answers) => {
       stepHeader(10, 12);
-      const { backendFwObj, backendDb } = answers;
-      if (!backendFwObj || !backendDb) return null;
+      const { backendFw, backendDb } = answers;
+      if (!backendFw || !backendDb) return null;
       const byDb = ORM_OPTIONS_BY_DB[backendDb] || [];
-      const byFw = ORM_OPTIONS[fwValue(backendFwObj)] || [];
+      const byFw = ORM_OPTIONS[fwValue(backendFw)] || [];
       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, BLOCKS.BACKEND);
     },
@@ -183,9 +174,9 @@ const buildStepDefs = (IDE_CANDIDATES) => [
     name: 'backendAuth',
     run: async (machine, answers) => {
       stepHeader(11, 12);
-      const { backendFwObj } = answers;
-      if (!backendFwObj) return null;
-      return await selectOptional('Auth strategy:', AUTH_OPTIONS[fwValue(backendFwObj)] || [], machine, 10, answers, BLOCKS.BACKEND);
+      const { backendFw } = answers;
+      if (!backendFw) return null;
+      return await selectOptional('Auth strategy:', AUTH_OPTIONS[fwValue(backendFw)] || [], machine, 10, answers, BLOCKS.BACKEND);
     },
   },
 

package/lib/steps.js

@@ -10,10 +10,12 @@ const SHOW_LIST = Symbol('SHOW_LIST');
 // ── Step machine ──────────────────────────────────────────────────────────────
 
 class StepMachine {
-  constructor() {
+  constructor(blockEntries = []) {
     this.history      = []; // [{ stepIndex, stepName, answer }]
     this.inBackNav    = false;
     this.resumeIndex  = null; // step index where back-nav started
+    this.blockEntries = blockEntries; // absolute step indices that are block entry points
+    this.snapshot     = null; // history snapshot taken at back-nav start
   }
 
   // Push a completed step answer onto the history stack
@@ -63,11 +65,30 @@ class StepMachine {
     return opts;
   }
 
+  // Take a snapshot of current history + answers (for ignore-changes restore)
+  snapshotHistory() {
+    this.snapshot = this.history.map(h => ({ ...h }));
+  }
+
+  // Restore history from snapshot
+  restoreSnapshot() {
+    if (this.snapshot) {
+      this.history  = this.snapshot.map(h => ({ ...h }));
+      this.snapshot = null;
+    }
+  }
+
+  // Check if a step index is a block entry point
+  isBlockEntry(stepIndex) {
+    return this.blockEntries.includes(stepIndex);
+  }
+
   // Enter back-nav mode — record where the user first pressed Back
   enterBackNav(currentStepIndex) {
     if (!this.inBackNav) {
       this.inBackNav   = true;
       this.resumeIndex = currentStepIndex;
+      this.snapshotHistory();
     }
   }
 
@@ -82,6 +103,7 @@ class StepMachine {
     this.history     = [];
     this.inBackNav   = false;
     this.resumeIndex = null;
+    this.snapshot    = null;
   }
 }
 
@@ -106,9 +128,34 @@ const runQuestions = async (stepDefs, machine) => {
     if (result === BACK) {
       if (i === 0) return RESTART; // nowhere to go back from step 0
       machine.enterBackNav(i);     // record where back-nav started
+      i--;
+      // Skip back over auto-skipped steps (not in history), stop at block entry
+      while (i > 0 && !machine.history.find(h => h.stepIndex === i) && !machine.isBlockEntry(i)) i--;
+      // Pop the step we landed on
       const popped = machine.pop();
       if (popped) delete answers[popped.stepName];
-      i--;
+      // Block boundary checkpoint — fires when back-nav reaches a block entry point
+      if (machine.isBlockEntry(i)) {
+        const { arrowSelect } = require('./ui');
+        const boundaryChoice = await arrowSelect('You\'ve reached the start of this block.', [
+          { label: '→ Continue from here (re-answer this block)' },
+          { label: '→ Ignore changes (restore to where you started)' },
+          { label: '← Restart configuration' },
+        ]);
+        if (boundaryChoice === 1) {
+          const resumeTarget = machine.resumeIndex;
+          machine.restoreSnapshot();
+          Object.keys(answers).forEach(k => delete answers[k]);
+          machine.history.forEach(h => { answers[h.stepName] = h.answer; });
+          machine.exitBackNav();
+          const entryStep = machine.blockEntries.find(e => e <= i) ?? 0;
+          i = resumeTarget != null ? resumeTarget : entryStep + 1;
+
+        } else if (boundaryChoice === 2) {
+          return RESTART;
+        }
+        // 'continue' — just proceed from current block entry step
+      }
       continue;
     }
 

package/package.json

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