feat: /new-project hardening (10/10) — 3 phases complete

.aios-core/cli/commands/context/auto.js

@@ -0,0 +1,86 @@
+/**
+ * Context Auto Command
+ * Auto-detect session context from project
+ *
+ * Usage: aios context auto [--dry-run]
+ *
+ * @module cli/commands/context/auto
+ */
+
+const SessionStateManager = require('../../../core/session/state-manager');
+const ContextTracker = require('../../../core/session/context-tracker');
+const readline = require('readline');
+
+async function execute(args) {
+  const isDryRun = args.includes('--dry-run');
+
+  try {
+    // Create tracker and detect context
+    const tracker = new ContextTracker();
+    const detected = await tracker.detectContext();
+
+    // Display detected values
+    console.log('Auto-detected context:\n');
+
+    console.log('  Project:');
+    console.log(`    Type: ${detected.project.type} (confidence: ${Math.round(detected.confidence.projectType * 100)}%)`);
+    console.log(`    Name: ${detected.project.name}`);
+    console.log(`    Emoji: ${detected.project.emoji}`);
+
+    if (detected.git.branch) {
+      console.log('\n  Git Status:');
+      console.log(`    Branch: ${detected.git.branch}`);
+      console.log(`    Uncommitted Changes: ${detected.git.hasChanges ? 'yes' : 'no'} ${detected.git.emoji}`);
+    }
+
+    if (detected.status.phase) {
+      console.log('\n  Status:');
+      console.log(`    Phase: ${detected.status.phase} (confidence: ${Math.round(detected.confidence.phase * 100)}%)`);
+      if (detected.status.progress) {
+        const [current, total] = detected.status.progress.split('/').map(Number);
+        const percentage = Math.round((current / total) * 100);
+        console.log(`    Progress: ${detected.status.progress} (${percentage}%)`);
+      }
+    }
+
+    // Dry run - stop here
+    if (isDryRun) {
+      console.log('\n🔍 Dry run - no changes made.');
+      return;
+    }
+
+    // Ask for confirmation
+    const rl = readline.createInterface({
+      input: process.stdin,
+      output: process.stdout,
+    });
+
+    const answer = await new Promise(resolve => {
+      rl.question('\nApply this context? [Y/n]: ', resolve);
+    });
+    rl.close();
+
+    if (answer.toLowerCase() === 'n' || answer.toLowerCase() === 'no') {
+      console.log('❌ Cancelled.');
+      process.exit(0);
+    }
+
+    // Apply detected context
+    const manager = SessionStateManager;
+    await manager.update({
+      project: detected.project,
+      status: {
+        phase: detected.status.phase,
+        progress: detected.status.progress,
+        emoji: detected.status.emoji || (detected.git.hasChanges ? '🟡' : '🟢'),
+      },
+    });
+
+    console.log('\n✓ Context updated');
+  } catch (error) {
+    console.error(`Error detecting context: ${error.message}`);
+    process.exit(1);
+  }
+}
+
+module.exports = { execute };

.aios-core/cli/commands/context/clear.js

@@ -0,0 +1,41 @@
+/**
+ * Context Clear Command
+ * Reset session context to defaults
+ *
+ * Usage: aios context clear [--archive]
+ *
+ * @module cli/commands/context/clear
+ */
+
+const SessionStateManager = require('../../../core/session/state-manager');
+const path = require('path');
+
+async function execute(args) {
+  const shouldArchive = args.includes('--archive');
+
+  try {
+    const manager = SessionStateManager;
+
+    // Get current session for archive filename
+    const currentSession = await manager.read();
+
+    // Clear (which archives automatically if session has data)
+    await manager.clear();
+
+
+    // Show confirmation
+    console.log('✓ Context cleared');
+
+    // If session was archived, show path
+    if (shouldArchive && currentSession.project.name) {
+      const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+      const archivePath = path.join('.aios', 'sessions', 'history', `session-${timestamp}.json`);
+      console.log(`  Session archived to: ${archivePath}`);
+    }
+  } catch (error) {
+    console.error(`Error clearing context: ${error.message}`);
+    process.exit(1);
+  }
+}
+
+module.exports = { execute };

.aios-core/cli/commands/context/index.js

@@ -0,0 +1,101 @@
+/**
+ * Context Command Router
+ * Routes aios context subcommands to appropriate handlers
+ *
+ * @module cli/commands/context
+ */
+
+const set = require('./set');
+const show = require('./show');
+const clear = require('./clear');
+const auto = require('./auto');
+const setEpic = require('./set-epic');
+const setStory = require('./set-story');
+const setTask = require('./set-task');
+
+async function run(args) {
+  const subcommand = args[3] || 'show'; // Default to 'show'
+
+  switch (subcommand) {
+    case 'set':
+      await set.execute(args.slice(4));
+      break;
+    case 'set-epic':
+      await setEpic.execute(args.slice(4));
+      break;
+    case 'set-story':
+      await setStory.execute(args.slice(4));
+      break;
+    case 'set-task':
+      await setTask.execute(args.slice(4));
+      break;
+    case 'show':
+      await show.execute(args.slice(4));
+      break;
+    case 'clear':
+      await clear.execute(args.slice(4));
+      break;
+    case 'auto':
+      await auto.execute(args.slice(4));
+      break;
+    case 'help':
+    case '--help':
+    case '-h':
+      showHelp();
+      break;
+    default:
+      console.error(`Unknown subcommand: ${subcommand}`);
+      console.log('Run "aios context help" for usage');
+      process.exit(1);
+  }
+}
+
+function showHelp() {
+  console.log(`
+Usage: aios context <command> [options]
+
+Commands:
+  set <name>            Set context manually
+set-epic <epic>       Set epic (main context - always visible)
+  set-story <story>     Set story (mid-level context)
+  set-task <task>       Set task (momentary context)
+  show                  Display current context (default)
+  clear                 Reset context
+  auto                  Auto-detect context from project
+
+Options for 'set':
+  --emoji <emoji>       Project emoji
+  --type <type>         Project type (framework/squad/app/tool/design-system)
+  --status <emoji>      Status emoji
+  --phase <phase>       Work phase
+  --progress <n/m>      Progress (e.g., "2/5")
+  --agent <agent>       Active agent
+  --story <story>       Story ID
+
+Options for 'set-epic', 'set-story', 'set-task':
+  --clear               Clear the epic/story/task
+
+Options for 'show':
+  --json                Output as JSON
+
+Options for 'clear':
+  --archive             Archive session before clearing
+
+Options for 'auto':
+  --dry-run             Show detection without applying
+
+Examples:
+  aios context set "aios-core" --emoji 🏗️ --progress 2/5
+  aios context set-epic "Baixar vídeos YouTube"
+  aios context set-story "Implementar playlist"
+  aios context set-task "Commit GitHub"
+  aios context set-task --clear
+  aios context show
+  aios context show --json
+  aios context clear --archive
+  aios context auto
+  aios context auto --dry-run
+  `);
+}
+
+module.exports = { run };

.aios-core/cli/commands/context/set-context.js

@@ -0,0 +1,129 @@
+#!/usr/bin/env node
+/**
+ * AIOS Context Setter
+ * Updates session context to display in terminal tab title and status bar
+ *
+ * Usage:
+ *   aios context set <text>
+ *   aios context set epic "Epic name"
+ *   aios context set story "Story name"
+ *   aios context set task "Task name"
+ *   aios context clear
+ */
+
+const fs = require('fs').promises;
+const path = require('path');
+const { execSync } = require('child_process');
+
+const SESSION_FILE = '.aios/session.json';
+
+async function setContext(args) {
+  const projectRoot = process.cwd();
+  const sessionPath = path.join(projectRoot, SESSION_FILE);
+
+  try {
+    // Read current session
+    let session = {};
+    try {
+      session = JSON.parse(await fs.readFile(sessionPath, 'utf-8'));
+    } catch (error) {
+      if (error.code !== 'ENOENT') throw error;
+      // Create default session if doesn't exist
+      session = {
+        version: '1.0.0',
+        pid: process.pid,
+        sessionId: `session-${Date.now()}`,
+        project: {
+          type: 'unknown',
+          name: path.basename(projectRoot),
+          emoji: '📦',
+        },
+        status: {
+          phase: 'active',
+          progress: '',
+          currentTask: '',
+          emoji: '',
+        },
+        context: {},
+        metadata: {
+          startedAt: new Date().toISOString(),
+          lastUpdatedAt: new Date().toISOString(),
+        },
+      };
+    }
+
+    // Parse arguments
+    const [type, ...valueParts] = args;
+    const value = valueParts.join(' ');
+
+    if (!session.context) {
+      session.context = {};
+    }
+
+    // Handle different commands
+    if (type === 'clear') {
+      session.context = {};
+      console.log('✅ Context cleared');
+    } else if (type === 'epic' || type === 'story' || type === 'task') {
+      if (!value) {
+        console.error(`❌ Error: Please provide a ${type} name`);
+        process.exit(1);
+      }
+      session.context[type] = value;
+      console.log(`✅ ${type} set: ${value}`);
+    } else {
+      // Default: set as current task
+      const contextText = [type, ...valueParts].join(' ');
+      session.context.task = contextText;
+      console.log(`✅ Context set: ${contextText}`);
+    }
+
+    // Update timestamp
+    session.metadata = session.metadata || {};
+    session.metadata.lastUpdatedAt = new Date().toISOString();
+
+    // Write back
+    await fs.writeFile(sessionPath, JSON.stringify(session, null, 2), 'utf-8');
+
+    // Show current context
+    const contextParts = [
+      session.context.epic,
+      session.context.story,
+      session.context.task,
+    ].filter(Boolean);
+
+    if (contextParts.length > 0) {
+      console.log(`📍 Current context: ${contextParts.join(' → ')}`);
+    }
+
+  } catch (error) {
+    console.error('❌ Error setting context:', error.message);
+    process.exit(1);
+  }
+}
+
+// Get arguments (skip node and script name)
+const args = process.argv.slice(2);
+
+if (args.length === 0) {
+  console.log(`
+AIOS Context Setter
+
+Usage:
+  aios context set <text>              Set context as current task
+  aios context set epic "Epic name"    Set epic level context
+  aios context set story "Story name"  Set story level context
+  aios context set task "Task name"    Set task level context
+  aios context clear                   Clear all context
+
+Examples:
+  aios context set "Landing Page Help"
+  aios context set epic "Q1 2026 Features"
+  aios context set story "User Authentication"
+  aios context set task "Implement login form"
+  aios context clear
+  `);
+  process.exit(0);
+}
+
+setContext(args);