vibecodingmachine-cli 2026.1.29-713 → 2026.2.20-423

package/src/utils/trui-nav-requirements.js

@@ -0,0 +1,268 @@
+/**
+ * TRUI Requirements Section
+ * Exposes loadRequirementsData / buildRequirementChoices / handleRequirementSelection
+ * for inline accordion display in the main navigation menu.
+ * Also exports addRequirementFlow for the [+ Add Requirement] shortcut.
+ */
+
+const inquirer = require('inquirer');
+const chalk = require('chalk');
+const fs = require('fs-extra');
+
+/**
+ * Load requirements data via the RUI command resolver
+ * @param {Object} navigation - TRUINavigation instance
+ * @returns {Promise<{requirements: Array}|null>}
+ */
+async function loadRequirementsData(navigation) {
+  try {
+    const result = navigation.resolver.resolve('list requirements');
+    if (!result.success) return null;
+
+    const commandResult = await result.command.execute();
+    if (!commandResult.success || !commandResult.data) return null;
+
+    return commandResult.data;
+  } catch (err) {
+    return null;
+  }
+}
+
+/**
+ * Build inline accordion choice objects for the requirements section.
+ * Requirements are grouped by status with Separator headers.
+ * @param {{requirements: Array}} data
+ * @returns {Array} inquirer choice objects (includes Separators)
+ */
+function buildRequirementChoices(data) {
+  const requirements = (data && data.requirements) || [];
+
+  if (!requirements.length) {
+    return [{ name: chalk.gray('  (no requirements found)'), value: 'noop' }];
+  }
+
+  const sections = {
+    current: requirements.filter(r => r.status === 'current'),
+    todo: requirements.filter(r => r.status === 'todo'),
+    verify: requirements.filter(r => r.status === 'verify'),
+    verified: requirements.filter(r => r.status === 'verified'),
+    'need-information': requirements.filter(r => r.status === 'need-information'),
+  };
+
+  const choices = [];
+
+  const addSection = (label, items, icon) => {
+    if (!items.length) return;
+    choices.push(new inquirer.Separator(chalk.bold(`  ${label}`)));
+    items.forEach(req => {
+      const idx = requirements.indexOf(req);
+      const isDisabled = req.title.startsWith('DISABLED:');
+      const cleanTitle = isDisabled ? req.title.replace(/^DISABLED:\s*/, '') : req.title;
+      const disabledIcon = isDisabled ? chalk.red('🚫') : '';
+      choices.push({
+        name: `    ${disabledIcon}${icon} ${chalk.white(cleanTitle)}`,
+        value: `req:${idx}`,
+      });
+    });
+  };
+
+  addSection('📌 CURRENT', sections.current, chalk.cyan('●'));
+  addSection('⏳ TODO', sections.todo, chalk.yellow('○'));
+  addSection('🔍 TO VERIFY', sections.verify, chalk.blue('◎'));
+  addSection('✅ VERIFIED', sections.verified, chalk.green('✓'));
+  addSection('❓ NEED INFO', sections['need-information'], chalk.red('?'));
+
+  return choices;
+}
+
+/**
+ * Handle selection of a requirement item — shows status-change sub-prompt
+ * @param {number} index - Index into data.requirements
+ * @param {{requirements: Array}} data
+ * @param {Object} navigation - TRUINavigation instance
+ * @returns {Promise<boolean>} true if requirements were changed
+ */
+async function handleRequirementSelection(index, data, navigation) {
+  if (!data || !data.requirements || !data.requirements[index]) return false;
+
+  const req = data.requirements[index];
+
+  const {
+    promoteToVerified,
+    demoteFromVerifiedToTodo,
+    promoteTodoToVerify,
+    demoteVerifyToTodo,
+    getOrCreateRequirementsFilePath,
+  } = require('vibecodingmachine-core');
+
+  const statusLabel = {
+    current: chalk.cyan('CURRENT'),
+    todo: chalk.yellow('TODO'),
+    verify: chalk.blue('TO VERIFY'),
+    verified: chalk.green('VERIFIED'),
+    'need-information': chalk.red('NEED INFO'),
+  }[req.status] || chalk.gray(req.status || 'unknown');
+
+  const isDisabled = req.title.startsWith('DISABLED:');
+  const cleanTitle = isDisabled ? req.title.replace(/^DISABLED:\s*/, '') : req.title;
+
+  const choices = [
+    { name: 'Move to TODO', value: 'moveToTodo' },
+    { name: 'Move to TO VERIFY', value: 'moveToVerify' },
+    { name: 'Move to VERIFIED', value: 'moveToVerified' },
+  ];
+
+  // Add enable/disable option
+  if (isDisabled) {
+    choices.push({ name: 'Enable Requirement', value: 'enable' });
+  } else {
+    choices.push({ name: 'Disable Requirement', value: 'disable' });
+  }
+
+  choices.push({ name: chalk.gray('Cancel'), value: 'cancel' });
+
+  const { reqAction } = await inquirer.prompt([
+    {
+      type: 'list',
+      name: 'reqAction',
+      message: `${cleanTitle} [${statusLabel}]`,
+      choices,
+    },
+  ]);
+
+  if (reqAction === 'cancel') return false;
+
+  try {
+    const reqPath = await getOrCreateRequirementsFilePath();
+
+    if (reqAction === 'moveToTodo') {
+      if (req.status === 'verify') {
+        await demoteVerifyToTodo(reqPath, req.title);
+      } else if (req.status === 'verified') {
+        await demoteFromVerifiedToTodo(reqPath, req.title);
+      } else {
+        console.log(chalk.yellow('Cannot move to TODO from current status'));
+        await navigation.promptContinue();
+        return false;
+      }
+    } else if (reqAction === 'moveToVerify') {
+      await promoteTodoToVerify(reqPath, req.title);
+    } else if (reqAction === 'moveToVerified') {
+      await promoteToVerified(reqPath, req.title);
+    } else if (reqAction === 'enable' || reqAction === 'disable') {
+      // Toggle disabled status
+      const content = await fs.readFile(reqPath, 'utf8');
+      const lines = content.split('\n');
+
+      // Find the requirement line
+      for (let i = 0; i < lines.length; i++) {
+        if (lines[i].includes(req.title)) {
+          if (reqAction === 'enable') {
+            // Remove DISABLED: prefix
+            lines[i] = lines[i].replace(/^###\s*DISABLED:\s*/, '### ');
+          } else {
+            // Add DISABLED: prefix
+            lines[i] = lines[i].replace(/^###\s*/, '### DISABLED: ');
+          }
+          break;
+        }
+      }
+
+      await fs.writeFile(reqPath, lines.join('\n'), 'utf8');
+      const action = reqAction === 'enable' ? 'enabled' : 'disabled';
+      console.log(chalk.green(`\n✓ Requirement "${cleanTitle}" ${action}`));
+      console.log(chalk.gray(`  Equivalent: app requirements ${cleanTitle} ${reqAction}`));
+      await navigation.promptContinue();
+      return true;
+    }
+
+    console.log(chalk.green(`\n✓ Moved "${req.title}" successfully`));
+    console.log(chalk.gray(`  Equivalent: app requirements ${req.title} ${reqAction}`));
+    await navigation.promptContinue();
+    return true;
+  } catch (err) {
+    console.log(chalk.red(`Error: ${err.message}`));
+    await navigation.promptContinue();
+    return false;
+  }
+}
+
+/**
+ * Interactive flow to add a new requirement
+ * Appends a new requirement to the "Requirements not yet completed" section
+ * @param {Object} navigation - TRUINavigation instance
+ */
+async function addRequirementFlow(navigation) {
+  console.log(chalk.bold.cyan('\n📋 Add New Requirement\n'));
+  console.log(chalk.gray('Equivalent: app create requirement <name>\n'));
+
+  const { title } = await inquirer.prompt([
+    {
+      type: 'input',
+      name: 'title',
+      message: chalk.cyan('Requirement title:'),
+      validate: input => input.trim().length > 0 || 'Title is required',
+    },
+  ]);
+
+  const { description } = await inquirer.prompt([
+    {
+      type: 'input',
+      name: 'description',
+      message: chalk.cyan('Description (optional):'),
+    },
+  ]);
+
+  try {
+    const { getOrCreateRequirementsFilePath } = require('vibecodingmachine-core');
+    const repoPath = process.cwd();
+    const reqPath = await getOrCreateRequirementsFilePath(repoPath);
+
+    const content = await fs.readFile(reqPath, 'utf8');
+    const lines = content.split('\n');
+
+    let insertIndex = -1;
+    for (let i = 0; i < lines.length; i++) {
+      if (lines[i].trim().match(/^##\s+.*(?:Requirements not yet completed|TODO)/i)) {
+        insertIndex = i + 1;
+        for (let j = i + 1; j < lines.length; j++) {
+          const inner = lines[j].trim();
+          if (inner.startsWith('##') && !inner.startsWith('###')) {
+            insertIndex = j;
+            break;
+          }
+          if (inner.startsWith('###') || inner.startsWith('- ')) {
+            insertIndex = j;
+            break;
+          }
+        }
+        break;
+      }
+    }
+
+    const requirementLine = description.trim()
+      ? `### ${title.trim()}\n\n${description.trim()}\n`
+      : `### ${title.trim()}\n`;
+
+    if (insertIndex >= 0) {
+      lines.splice(insertIndex, 0, requirementLine);
+    } else {
+      lines.push('', '## Requirements not yet completed', '', requirementLine);
+    }
+
+    await fs.writeFile(reqPath, lines.join('\n'), 'utf8');
+    console.log(chalk.green(`\n✓ Requirement "${title.trim()}" added`));
+    console.log(chalk.gray(`  Equivalent: app create requirement "${title.trim()}"`));
+  } catch (err) {
+    console.log(chalk.red(`Error adding requirement: ${err.message}`));
+  }
+
+  await navigation.promptContinue();
+}
+
+module.exports = {
+  loadRequirementsData,
+  buildRequirementChoices,
+  handleRequirementSelection,
+  addRequirementFlow,
+};

package/src/utils/trui-nav-settings.js

@@ -0,0 +1,157 @@
+/**
+ * TRUI Settings Section
+ * Exposes loadSettingsData / buildSettingChoices / handleSettingSelection
+ * for inline accordion display in the main navigation menu.
+ */
+
+const inquirer = require('inquirer');
+const chalk = require('chalk');
+
+/**
+ * Load settings data via the RUI command resolver
+ * @param {Object} navigation - TRUINavigation instance
+ * @returns {Promise<{settings: Array}|null>}
+ */
+async function loadSettingsData(navigation) {
+  try {
+    const result = navigation.resolver.resolve('list settings');
+    if (!result.success) return null;
+
+    const commandResult = await result.command.execute();
+    if (!commandResult.success || !commandResult.data) return null;
+
+    return commandResult.data;
+  } catch (err) {
+    return null;
+  }
+}
+
+/**
+ * Build inline accordion choice objects for the settings section
+ * @param {{settings: Array}} data
+ * @returns {Array} inquirer choice objects
+ */
+function buildSettingChoices(data) {
+  const settings = (data && data.settings) || [];
+
+  if (!settings.length) {
+    return [{ name: chalk.gray('  (no settings found)'), value: 'noop' }];
+  }
+
+  return settings.map(setting => ({
+    name: `  ${chalk.white(setting.key)}: ${chalk.gray(String(setting.value))}`,
+    value: `setting:${setting.key}`,
+  }));
+}
+
+/**
+ * Handle selection of a setting item — shows key/value detail
+ * @param {string} key - The setting key
+ * @param {{settings: Array}} data
+ * @param {Object} navigation - TRUINavigation instance
+ */
+async function handleSettingSelection(key, data, navigation) {
+  const settings = (data && data.settings) || [];
+  const setting = settings.find(s => s.key === key);
+
+  if (!setting) {
+    console.log(chalk.red(`Setting "${key}" not found`));
+    await navigation.promptContinue();
+    return;
+  }
+
+  console.log(chalk.bold.cyan(`\n⚙️  ${setting.key}\n`));
+  console.log(chalk.white(`  Value:       ${setting.value}`));
+  if (setting.description) {
+    console.log(chalk.gray(`  Description: ${setting.description}`));
+  }
+  console.log(chalk.gray(`\n  Equivalent: app get settings ${setting.key}`));
+
+  await navigation.promptContinue();
+}
+
+/**
+ * Show the settings menu — a showQuickMenu loop with current config displayed.
+ */
+async function showSettings() {
+  const { showQuickMenu } = require('./trui-quick-menu');
+  const { getAutoConfig, getRepoPath, getStages, setAutoConfig } = require('./config');
+  const { getProviderPreferences } = require('./provider-registry');
+  const inquirer = require('inquirer');
+
+  const printHeader = () => {
+    console.clear();
+    process.stdout.write(chalk.bold.cyan('⚙️  Settings\n\n'));
+    process.stdout.write(chalk.gray('[↑↓ navigate  Enter select  ← back]\n\n'));
+  };
+
+  const buildItems = async () => {
+    const repoPath = await getRepoPath();
+    const autoConfig = await getAutoConfig();
+    const prefs = await getProviderPreferences();
+    // Find first enabled provider in order for display
+    let activeIde = autoConfig.ide || autoConfig.agent || 'cline';
+
+    const items = [];
+    items.push({ type: 'setting', name: `Repo: ${chalk.white(repoPath || '(not set)')}`, value: 'setting:repo' });
+    items.push({ type: 'setting', name: `IDE/Agent: ${chalk.white(activeIde)}`, value: 'setting:ide' });
+    items.push({ type: 'setting', name: `Max Chats: ${chalk.white(autoConfig.maxChats || '(unlimited)')}`, value: 'setting:maxChats' });
+    items.push({ type: 'setting', name: `Never Stop: ${chalk.white(autoConfig.neverStop ? 'true' : 'false')}`, value: 'setting:neverStop' });
+    items.push({ type: 'setting', name: `Skip Disabled: ${chalk.white(autoConfig.skipDisabled ? 'true' : 'false')}`, value: 'setting:skipDisabled' });
+    return items;
+  };
+
+  printHeader();
+
+  while (true) {
+    const items = await buildItems();
+    const result = await showQuickMenu(items, 0);
+    const value = result.value;
+
+    if (value === '__cancel__' || value === 'exit') break;
+
+    if (value === 'setting:ide') {
+      const prefs = await getProviderPreferences();
+      const autoConfig = await getAutoConfig();
+      const enabledAgents = prefs.order.filter(id => prefs.enabled[id] !== false);
+      if (enabledAgents.length === 0) {
+        console.log(chalk.yellow('\nNo enabled agents. Enable agents in Agents menu first.\n'));
+        await inquirer.prompt([{ type: 'input', name: 'c', message: chalk.gray('Press Enter...') }]);
+      } else {
+        const { ide } = await inquirer.prompt([{
+          type: 'list',
+          name: 'ide',
+          message: 'Select active IDE/Agent:',
+          choices: enabledAgents,
+          default: autoConfig.ide || autoConfig.agent,
+        }]);
+        await setAutoConfig({ ide });
+      }
+    } else if (value === 'setting:maxChats') {
+      const autoConfig = await getAutoConfig();
+      const { maxChats } = await inquirer.prompt([{
+        type: 'input',
+        name: 'maxChats',
+        message: 'Max chats per run (blank = unlimited):',
+        default: autoConfig.maxChats ? String(autoConfig.maxChats) : '',
+      }]);
+      const parsed = parseInt(maxChats, 10);
+      await setAutoConfig({ maxChats: isNaN(parsed) ? undefined : parsed });
+    } else if (value === 'setting:neverStop') {
+      const autoConfig = await getAutoConfig();
+      await setAutoConfig({ neverStop: !autoConfig.neverStop });
+    } else if (value === 'setting:skipDisabled') {
+      const autoConfig = await getAutoConfig();
+      await setAutoConfig({ skipDisabled: !autoConfig.skipDisabled });
+    }
+
+    printHeader();
+  }
+}
+
+module.exports = {
+  loadSettingsData,
+  buildSettingChoices,
+  handleSettingSelection,
+  showSettings,
+};

package/src/utils/trui-nav-specifications.js

@@ -0,0 +1,139 @@
+/**
+ * TRUI Specifications Section
+ * Exposes loadSpecificationsData / buildSpecificationChoices / handleSpecificationSelection
+ * for inline accordion display in the main navigation menu.
+ * Also exports addSpecificationFlow for the [+ Add Specification] shortcut.
+ */
+
+const inquirer = require('inquirer');
+const chalk = require('chalk');
+
+/**
+ * Load all specifications from the repo
+ * @returns {Promise<Array|null>}
+ */
+async function loadSpecificationsData() {
+  try {
+    const { getAllSpecifications } = require('vibecodingmachine-core');
+    const repoPath = process.cwd();
+    return await getAllSpecifications(repoPath);
+  } catch (err) {
+    return null;
+  }
+}
+
+/**
+ * Build inline accordion choice objects for the specifications section
+ * @param {Array} specs - Array of spec objects
+ * @returns {Array} inquirer choice objects
+ */
+function buildSpecificationChoices(specs) {
+  if (!specs || !specs.length) {
+    return [{ name: chalk.gray('  (no specifications found)'), value: 'noop' }];
+  }
+
+  return specs.map(spec => {
+    const todoTag = !spec.hasTasks ? chalk.yellow(' [TODO]') : chalk.green(' [done]');
+    const label = spec.title || spec.directory;
+    return {
+      name: `  ${chalk.white(spec.directory)} ${chalk.gray('—')} ${chalk.gray(label)}${todoTag}`,
+      value: `spec:${spec.directory}`,
+    };
+  });
+}
+
+/**
+ * Handle selection of a specification item — shows detail
+ * @param {string} directory - Spec directory name
+ * @param {Array} specs
+ * @param {Object} navigation - TRUINavigation instance
+ */
+async function handleSpecificationSelection(directory, specs, navigation) {
+  const spec = (specs || []).find(s => s.directory === directory);
+
+  if (!spec) {
+    console.log(chalk.red(`Specification "${directory}" not found`));
+    await navigation.promptContinue();
+    return;
+  }
+
+  console.log(chalk.bold.cyan(`\n📐 ${spec.title || spec.directory}\n`));
+  console.log(chalk.white(`  Directory: ${spec.directory}`));
+  console.log(chalk.white(`  Path:      ${spec.path}`));
+  console.log(chalk.white(`  Has Plan:  ${spec.hasPlan ? chalk.green('Yes') : chalk.gray('No')}`));
+  console.log(chalk.white(`  Has Tasks: ${spec.hasTasks ? chalk.green('Yes') : chalk.yellow('No (TODO)')}`));
+
+  await navigation.promptContinue();
+}
+
+/**
+ * Interactive flow to add a new specification
+ * @param {Object} navigation - TRUINavigation instance
+ */
+async function addSpecificationFlow(navigation) {
+  console.log(chalk.bold.cyan('\n📐 New Specification\n'));
+
+  const { shortName } = await inquirer.prompt([
+    {
+      type: 'input',
+      name: 'shortName',
+      message: chalk.cyan('Short name (e.g. "print-to-pdf"):'),
+      validate: input => {
+        if (!input.trim()) return 'Short name is required';
+        if (!/^[a-z0-9]+(-[a-z0-9]+)*$/.test(input.trim())) {
+          return 'Must be lowercase with hyphens: /^[a-z0-9]+(-[a-z0-9]+)*$/';
+        }
+        return true;
+      },
+    },
+  ]);
+
+  console.log(chalk.gray('Enter specification prompt. Enter a blank line to finish.'));
+  const promptLines = [];
+  while (true) {
+    const { line } = await inquirer.prompt([
+      {
+        type: 'input',
+        name: 'line',
+        message: chalk.cyan(promptLines.length === 0 ? 'Prompt > ' : '        > '),
+      },
+    ]);
+    if (line.trim() === '' && promptLines.length > 0) break;
+    if (line.trim() !== '') promptLines.push(line);
+  }
+  const specPrompt = promptLines.join('\n');
+
+  console.log(chalk.gray('\nPlan prompt (optional). Enter blank line to skip.'));
+  const planLines = [];
+  while (true) {
+    const { line } = await inquirer.prompt([
+      {
+        type: 'input',
+        name: 'line',
+        message: chalk.cyan(planLines.length === 0 ? 'Plan   > ' : '        > '),
+      },
+    ]);
+    if (line.trim() === '') break;
+    planLines.push(line);
+  }
+  const planPrompt = planLines.join('\n');
+
+  try {
+    const { createSpecification } = require('vibecodingmachine-core');
+    const repoPath = process.cwd();
+    const result = await createSpecification(repoPath, shortName.trim(), specPrompt, planPrompt);
+    console.log(chalk.green(`\n✅ Specification created: ${result.directory}`));
+    console.log(chalk.gray(`   Path: ${result.path}`));
+  } catch (err) {
+    console.log(chalk.red(`❌ Error creating specification: ${err.message}`));
+  }
+
+  await navigation.promptContinue();
+}
+
+module.exports = {
+  loadSpecificationsData,
+  buildSpecificationChoices,
+  handleSpecificationSelection,
+  addSpecificationFlow,
+};