maiass 5.8.9 → 5.9.1

package/README.md

@@ -48,7 +48,7 @@ maiass --dry-run
 ```bash
 # Enable AI features
 maiass config set maiass_token "your_api_key"
-maiass config set ai_mode "ask"
+maiass config set ai_mode "ask" (or "always" or "off")
 
 # MAIASS will now suggest intelligent commit messages
 maiass

package/lib/bootstrap.js

@@ -158,6 +158,11 @@ export async function bootstrapProject() {
   // Step 7: Save configuration
   await saveConfiguration(config);
   
+  // Step 8: Initialize branch structure if needed (full mode only)
+  if (config.features === 'full') {
+    await initializeBranchStructure(config.branches);
+  }
+  
   console.log('');
   log.success(SYMBOLS.CHECKMARK, 'Project setup complete!');
   log.info(SYMBOLS.INFO, 'You can modify these settings anytime by editing .env.maiass');
@@ -534,6 +539,119 @@ MAIASS_STAGINGBRANCH=${config.branches.staging}
   await ensureGitignore();
 }
 
+/**
+ * Step 8: Initialize branch structure for new repositories
+ */
+async function initializeBranchStructure(branchConfig) {
+  const { execSync } = await import('child_process');
+  
+  // Check if we're in a git repo
+  try {
+    execSync('git rev-parse --is-inside-work-tree', { stdio: 'pipe' });
+  } catch {
+    // Not a git repo, skip
+    return;
+  }
+  
+  // Check if there are any commits
+  let hasCommits = false;
+  try {
+    execSync('git rev-parse HEAD', { stdio: 'pipe' });
+    hasCommits = true;
+  } catch {
+    // No commits yet
+    hasCommits = false;
+  }
+  
+  // If there are already commits, check if develop branch exists
+  if (hasCommits) {
+    try {
+      execSync(`git rev-parse --verify ${branchConfig.develop}`, { stdio: 'pipe' });
+      // Develop branch exists, nothing to do
+      return;
+    } catch {
+      // Develop branch doesn't exist, offer to create it
+      console.log('');
+      console.log(colors.BCyan('🌿 Branch Structure Setup'));
+      console.log('');
+      console.log(`${SYMBOLS.INFO} Your repository has commits but no ${colors.BGreen(branchConfig.develop)} branch.`);
+      console.log(`${SYMBOLS.INFO} MAIASS works best with a ${colors.BGreen(branchConfig.develop)} branch for version management.`);
+      console.log('');
+      
+      const createBranch = await getSingleCharInput(`Create ${branchConfig.develop} branch from current branch? [Y/n]: `);
+      if (createBranch !== 'n') {
+        try {
+          execSync(`git checkout -b ${branchConfig.develop}`, { stdio: 'inherit' });
+          log.success(SYMBOLS.CHECKMARK, `Created and switched to ${colors.BGreen(branchConfig.develop)} branch`);
+        } catch (error) {
+          log.warning(SYMBOLS.WARNING, `Could not create ${branchConfig.develop} branch: ${error.message}`);
+        }
+      }
+      return;
+    }
+  }
+  
+  // No commits yet - this is a brand new repo
+  console.log('');
+  console.log(colors.BCyan('🌿 Branch Structure Setup'));
+  console.log('');
+  console.log(`${SYMBOLS.INFO} This appears to be a new repository with no commits yet.`);
+  console.log(`${SYMBOLS.INFO} MAIASS can set up the recommended branch structure for you:`);
+  console.log('');
+  console.log(`  1. Create initial commit on ${colors.BGreen(branchConfig.main)} branch`);
+  console.log(`  2. Create ${colors.BGreen(branchConfig.develop)} branch from ${branchConfig.main}`);
+  console.log(`  3. Switch to ${colors.BGreen(branchConfig.develop)} for development`);
+  console.log('');
+  console.log(colors.Gray('This ensures MAIASS has the proper branch structure for version management.'));
+  console.log('');
+  
+  const setupBranches = await getSingleCharInput('Set up branch structure now? [Y/n]: ');
+  if (setupBranches === 'n') {
+    log.info(SYMBOLS.INFO, 'Skipping branch setup. You can create branches manually later.');
+    return;
+  }
+  
+  try {
+    // Check if we're on a branch or in detached HEAD
+    let currentBranch;
+    try {
+      currentBranch = execSync('git rev-parse --abbrev-ref HEAD', { encoding: 'utf8', stdio: 'pipe' }).trim();
+    } catch {
+      currentBranch = null;
+    }
+    
+    // If not on a branch or on wrong branch, create/switch to main
+    if (!currentBranch || currentBranch === 'HEAD' || currentBranch !== branchConfig.main) {
+      log.info(SYMBOLS.INFO, `Creating ${colors.BGreen(branchConfig.main)} branch...`);
+      execSync(`git checkout -b ${branchConfig.main}`, { stdio: 'pipe' });
+    }
+    
+    // Create initial commit with the config files
+    log.info(SYMBOLS.INFO, 'Creating initial commit...');
+    execSync('git add .env.maiass .env.maiass.local .gitignore', { stdio: 'pipe' });
+    execSync('git commit -m "Initial commit: MAIASS configuration"', { stdio: 'inherit' });
+    log.success(SYMBOLS.CHECKMARK, `Initial commit created on ${colors.BGreen(branchConfig.main)}`);
+    
+    // Create develop branch
+    log.info(SYMBOLS.INFO, `Creating ${colors.BGreen(branchConfig.develop)} branch...`);
+    execSync(`git checkout -b ${branchConfig.develop}`, { stdio: 'pipe' });
+    log.success(SYMBOLS.CHECKMARK, `Created and switched to ${colors.BGreen(branchConfig.develop)} branch`);
+    
+    console.log('');
+    log.success(SYMBOLS.CHECKMARK, 'Branch structure initialized successfully!');
+    log.info(SYMBOLS.INFO, `You are now on the ${colors.BGreen(branchConfig.develop)} branch and ready to start development.`);
+    
+  } catch (error) {
+    console.log('');
+    log.warning(SYMBOLS.WARNING, 'Could not automatically set up branch structure');
+    log.info(SYMBOLS.INFO, 'You can create branches manually:');
+    console.log(`  ${colors.Gray(`git checkout -b ${branchConfig.main}`)}`);
+    console.log(`  ${colors.Gray('git add .')}`);
+    console.log(`  ${colors.Gray('git commit -m "Initial commit"')}`);
+    console.log(`  ${colors.Gray(`git checkout -b ${branchConfig.develop}`)}`);
+  }
+}
+
 /**
  * Ensure .gitignore includes necessary patterns
  */

package/lib/maiass-pipeline.js

@@ -551,6 +551,12 @@ async function handleMergeToDevelop(branchInfo, commitResult, options = {}) {
   const { force = false, silent = false, originalGitInfo = null, autoSwitch = true, versionBump = null, tag = false } = options;
   const { currentBranch, developBranch, originalBranch } = branchInfo;
   
+  // If no current branch (new repo with no commits), skip merge
+  if (!currentBranch || currentBranch === 'null') {
+    log.blue(SYMBOLS.INFO, 'New repository with no branch yet, skipping merge workflow');
+    return { success: true, skipped: true, newRepo: true };
+  }
+  
   // If we're already on develop or this was commits-only, skip merge
   if (currentBranch === developBranch || originalBranch === developBranch) {
     log.blue(SYMBOLS.INFO, `Already on ${developBranch} branch, skipping merge`);

package/maiass.mjs

@@ -51,6 +51,7 @@ if (args.includes('--setup') || args.includes('--bootstrap')) {
 
 // Check if first argument is a version bump type
 const versionBumpTypes = ['major', 'minor', 'patch'];
+const validCommands = ['hello', 'env', 'git-info', 'config', 'version', 'account-info', 'maiass', 'help'];
 let command = 'maiass'; // Default to maiass workflow
 let versionBump = null;
 
@@ -59,10 +60,22 @@ if (firstArg && versionBumpTypes.includes(firstArg)) {
   versionBump = firstArg;
   command = 'maiass';
 } else if (firstArg && !firstArg.startsWith('-')) {
-  // First arg is a command
+  // First arg is a command - validate it
+  if (!validCommands.includes(firstArg)) {
+    console.error(colors.Red(`${SYMBOLS.CROSS} Error: Unknown command '${firstArg}'`));
+    console.log('');
+    console.log('Valid commands:');
+    console.log('  ' + validCommands.join(', '));
+    console.log('');
+    console.log('Version bump types:');
+    console.log('  ' + versionBumpTypes.join(', '));
+    console.log('');
+    console.log(`Run 'nma --help' for more information.`);
+    process.exit(1);
+  }
   command = firstArg;
-} else {
-  // No command specified or starts with flag, default to maiass
+} else if (!firstArg) {
+  // No command specified, default to maiass
   command = 'maiass';
 }
 
@@ -85,6 +98,54 @@ if (args.includes('--version') || args.includes('-v')) {
   process.exit(0);
 }
 
+// Handle --account-info flag (before help to allow it to work)
+if (args.includes('--account-info')) {
+  command = 'account-info';
+}
+
+// Validate flags - check for unrecognized options
+const validFlags = [
+  '--help', '-h',
+  '--version', '-v',
+  '--account-info',
+  '--auto', '-a',
+  '--commits-only', '-c',
+  '--auto-stage',
+  '--setup', '--bootstrap',
+  '--dry-run', '-d',
+  '--force', '-f',
+  '--silent', '-s',
+  '--json',
+  '--tag', '-t'
+];
+
+// Check for unrecognized flags
+for (const arg of args) {
+  if (arg.startsWith('-')) {
+    // Check if it's a flag with value (e.g., --tag=value or --tag value)
+    const flagName = arg.split('=')[0];
+    if (!validFlags.includes(flagName) && !validFlags.includes(arg)) {
+      console.error(colors.Red(`${SYMBOLS.CROSS} Error: Unrecognized option '${arg}'`));
+      console.log('');
+      console.log('Valid flags:');
+      // Group flags by category for better readability
+      const helpFlags = validFlags.filter(f => f.includes('help') || f.includes('version'));
+      const commandFlags = validFlags.filter(f => f.includes('account') || f.includes('setup') || f.includes('bootstrap'));
+      const workflowFlags = validFlags.filter(f => !helpFlags.includes(f) && !commandFlags.includes(f));
+      
+      console.log('  Help & Info:');
+      console.log('    ' + helpFlags.join(', '));
+      console.log('  Commands:');
+      console.log('    ' + commandFlags.join(', '));
+      console.log('  Workflow Options:');
+      console.log('    ' + workflowFlags.join(', '));
+      console.log('');
+      console.log(`Run 'nma --help' for detailed information.`);
+      process.exit(1);
+    }
+  }
+}
+
 // Handle help flag
 if (args.includes('--help') || args.includes('-h') || command === 'help') {
   console.log(`\nMAIASS v${version}`);
@@ -102,6 +163,7 @@ if (args.includes('--help') || args.includes('-h') || command === 'help') {
   console.log('  version            Manage version information');
   console.log('  account-info       Show your account status (masked token)');
   console.log('\nOptions:');
+  console.log('  --account-info     Show your account status (masked token)');
   console.log('  --auto             Enable all auto-yes functionality (non-interactive mode)');
   console.log('  --commits-only, -c Generate AI commits without version management');
   console.log('  --auto-stage       Automatically stage all changes');

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "maiass",
   "type": "module",
-  "version": "5.8.9",
+  "version": "5.9.1",
   "description": "MAIASS - Modular AI-Augmented Semantic Scribe - Intelligent Git workflow automation",
   "main": "maiass.mjs",
   "bin": {