aios-core 2.1.0

package/.aios-core/scripts/elicitation-session-manager.js

@@ -0,0 +1,300 @@
+/**
+ * Elicitation Session Manager
+ * Handles saving and loading elicitation sessions
+ * @module elicitation-session-manager
+ */
+
+const fs = require('fs-extra');
+const path = require('path');
+const crypto = require('crypto');
+
+class ElicitationSessionManager {
+  constructor(sessionDir = '.aios-sessions') {
+    this.sessionDir = path.resolve(process.cwd(), sessionDir);
+    this.activeSession = null;
+  }
+
+  /**
+   * Initialize session storage
+   */
+  async init() {
+    await fs.ensureDir(this.sessionDir);
+  }
+
+  /**
+   * Create a new session
+   * @param {string} type - Component type (agent, task, workflow)
+   * @param {Object} metadata - Additional session metadata
+   * @returns {Promise<string>} Session ID
+   */
+  async createSession(type, metadata = {}) {
+    const sessionId = this.generateSessionId();
+    const session = {
+      id: sessionId,
+      type,
+      version: '1.0',
+      created: new Date().toISOString(),
+      updated: new Date().toISOString(),
+      status: 'active',
+      currentStep: 0,
+      totalSteps: 0,
+      answers: {},
+      metadata: {
+        ...metadata,
+        user: process.env.USER || 'unknown',
+        hostname: require('os').hostname(),
+      },
+    };
+
+    this.activeSession = session;
+    await this.saveSession(session);
+    
+    return sessionId;
+  }
+
+  /**
+   * Save current session state
+   * @param {Object} session - Session data to save
+   */
+  async saveSession(session = null) {
+    const sessionToSave = session || this.activeSession;
+    if (!sessionToSave) {
+      throw new Error('No active session to save');
+    }
+
+    sessionToSave.updated = new Date().toISOString();
+    
+    const sessionPath = this.getSessionPath(sessionToSave.id);
+    await fs.writeJson(sessionPath, sessionToSave, { spaces: 2 });
+  }
+
+  /**
+   * Load an existing session
+   * @param {string} sessionId - Session ID to load
+   * @returns {Promise<Object>} Session data
+   */
+  async loadSession(sessionId) {
+    const sessionPath = this.getSessionPath(sessionId);
+    
+    if (!await fs.pathExists(sessionPath)) {
+      throw new Error(`Session ${sessionId} not found`);
+    }
+
+    const session = await fs.readJson(sessionPath);
+    this.activeSession = session;
+    
+    return session;
+  }
+
+  /**
+   * Update session answers
+   * @param {Object} answers - New answers to merge
+   * @param {number} stepIndex - Current step index
+   */
+  async updateAnswers(answers, stepIndex = null) {
+    if (!this.activeSession) {
+      throw new Error('No active session');
+    }
+
+    // Merge answers
+    Object.assign(this.activeSession.answers, answers);
+    
+    // Update step index if provided
+    if (stepIndex !== null) {
+      this.activeSession.currentStep = stepIndex;
+    }
+
+    await this.saveSession();
+  }
+
+  /**
+   * List all sessions
+   * @param {Object} filters - Filter options
+   * @returns {Promise<Array>} List of sessions
+   */
+  async listSessions(filters = {}) {
+    const files = await fs.readdir(this.sessionDir);
+    const sessions = [];
+
+    for (const file of files) {
+      if (file.endsWith('.json')) {
+        try {
+          const sessionPath = path.join(this.sessionDir, file);
+          const session = await fs.readJson(sessionPath);
+          
+          // Apply filters
+          if (filters.type && session.type !== filters.type) continue;
+          if (filters.status && session.status !== filters.status) continue;
+          if (filters.after && new Date(session.created) < new Date(filters.after)) continue;
+          
+          sessions.push({
+            id: session.id,
+            type: session.type,
+            created: session.created,
+            updated: session.updated,
+            status: session.status,
+            progress: session.totalSteps > 0 ? 
+              Math.round((session.currentStep / session.totalSteps) * 100) : 0,
+          });
+        } catch (error) {
+          // Skip invalid session files
+          console.warn(`Invalid session file: ${file}`);
+        }
+      }
+    }
+
+    // Sort by updated date (newest first)
+    sessions.sort((a, b) => new Date(b.updated) - new Date(a.updated));
+    
+    return sessions;
+  }
+
+  /**
+   * Resume a session
+   * @param {string} sessionId - Session ID to resume
+   * @returns {Promise<Object>} Session data with resume info
+   */
+  async resumeSession(sessionId) {
+    const session = await this.loadSession(sessionId);
+    
+    // Calculate resume information
+    const resumeInfo = {
+      ...session,
+      resumeFrom: session.currentStep,
+      completedSteps: Object.keys(session.answers).length,
+      remainingSteps: session.totalSteps - session.currentStep,
+      percentComplete: session.totalSteps > 0 ? 
+        Math.round((session.currentStep / session.totalSteps) * 100) : 0,
+    };
+
+    return resumeInfo;
+  }
+
+  /**
+   * Complete a session
+   * @param {string} result - Completion result (success, cancelled, error)
+   */
+  async completeSession(result = 'success') {
+    if (!this.activeSession) {
+      throw new Error('No active session');
+    }
+
+    this.activeSession.status = 'completed';
+    this.activeSession.completedAt = new Date().toISOString();
+    this.activeSession.result = result;
+    
+    await this.saveSession();
+    
+    // Move to completed directory if success
+    if (result === 'success') {
+      const completedDir = path.join(this.sessionDir, 'completed');
+      await fs.ensureDir(completedDir);
+      
+      const oldPath = this.getSessionPath(this.activeSession.id);
+      const newPath = path.join(completedDir, path.basename(oldPath));
+      
+      await fs.move(oldPath, newPath, { overwrite: true });
+    }
+
+    this.activeSession = null;
+  }
+
+  /**
+   * Delete a session
+   * @param {string} sessionId - Session ID to delete
+   */
+  async deleteSession(sessionId) {
+    const sessionPath = this.getSessionPath(sessionId);
+    const completedPath = path.join(this.sessionDir, 'completed', `${sessionId}.json`);
+    
+    // Check both active and completed directories
+    if (await fs.pathExists(sessionPath)) {
+      await fs.remove(sessionPath);
+    } else if (await fs.pathExists(completedPath)) {
+      await fs.remove(completedPath);
+    } else {
+      throw new Error(`Session ${sessionId} not found`);
+    }
+
+    // Clear active session if it matches
+    if (this.activeSession && this.activeSession.id === sessionId) {
+      this.activeSession = null;
+    }
+  }
+
+  /**
+   * Export session data
+   * @param {string} sessionId - Session ID to export
+   * @param {string} format - Export format (json, yaml)
+   * @returns {Promise<string>} Exported data
+   */
+  async exportSession(sessionId, format = 'json') {
+    const session = await this.loadSession(sessionId);
+    
+    switch (format) {
+      case 'json':
+        return JSON.stringify(session, null, 2);
+        
+      case 'yaml':
+        const yaml = require('js-yaml');
+        return yaml.dump(session);
+        
+      default:
+        throw new Error(`Unsupported export format: ${format}`);
+    }
+  }
+
+  /**
+   * Clean up old sessions
+   * @param {number} daysOld - Delete sessions older than this many days
+   */
+  async cleanupOldSessions(daysOld = 30) {
+    const sessions = await this.listSessions();
+    const cutoffDate = new Date();
+    cutoffDate.setDate(cutoffDate.getDate() - daysOld);
+    
+    let deletedCount = 0;
+    
+    for (const session of sessions) {
+      if (new Date(session.updated) < cutoffDate && session.status !== 'active') {
+        await this.deleteSession(session.id);
+        deletedCount++;
+      }
+    }
+    
+    return deletedCount;
+  }
+
+  /**
+   * Generate a unique session ID
+   * @private
+   */
+  generateSessionId() {
+    return crypto.randomBytes(8).toString('hex');
+  }
+
+  /**
+   * Get session file path
+   * @private
+   */
+  getSessionPath(sessionId) {
+    return path.join(this.sessionDir, `${sessionId}.json`);
+  }
+
+  /**
+   * Get active session
+   * @returns {Object|null} Active session or null
+   */
+  getActiveSession() {
+    return this.activeSession;
+  }
+
+  /**
+   * Clear active session
+   */
+  clearActiveSession() {
+    this.activeSession = null;
+  }
+}
+
+module.exports = ElicitationSessionManager;

package/.aios-core/scripts/migrate-framework-docs.sh

@@ -0,0 +1,300 @@
+#!/bin/bash
+#
+# AIOS Framework Documentation Migration Script
+#
+# Purpose: Migrate framework docs from aios-fullstack to aios-core (REPO 1)
+# Story: 6.1.2.6 - Framework Configuration System
+# Execution Timeline: Q2 2026 (Repository Migration Phase)
+#
+# Usage:
+#   ./migrate-framework-docs.sh [--dry-run] [--target-repo PATH]
+#
+# Options:
+#   --dry-run        Show what would be migrated without making changes
+#   --target-repo    Path to aios-core repository (default: ../aios-core)
+#   --help           Show this help message
+#
+
+set -e  # Exit on error
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+# Default values
+DRY_RUN=false
+TARGET_REPO="../aios-core"
+SOURCE_DOCS="docs/framework"
+
+# Parse command line arguments
+while [[ $# -gt 0 ]]; do
+  case $1 in
+    --dry-run)
+      DRY_RUN=true
+      shift
+      ;;
+    --target-repo)
+      TARGET_REPO="$2"
+      shift 2
+      ;;
+    --help)
+      head -n 20 "$0" | grep "^#" | sed 's/^# //'
+      exit 0
+      ;;
+    *)
+      echo -e "${RED}Error: Unknown option $1${NC}"
+      echo "Use --help for usage information"
+      exit 1
+      ;;
+  esac
+done
+
+# Header
+echo ""
+echo -e "${BLUE}╔════════════════════════════════════════════════════════════╗${NC}"
+echo -e "${BLUE}║  AIOS Framework Documentation Migration Script             ║${NC}"
+echo -e "${BLUE}║  Story 6.1.2.6: Framework Configuration System             ║${NC}"
+echo -e "${BLUE}╚════════════════════════════════════════════════════════════╝${NC}"
+echo ""
+
+if [ "$DRY_RUN" = true ]; then
+  echo -e "${YELLOW}⚠️  DRY RUN MODE - No changes will be made${NC}"
+  echo ""
+fi
+
+# Function: Print section header
+print_section() {
+  echo ""
+  echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+  echo -e "${BLUE}  $1${NC}"
+  echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+  echo ""
+}
+
+# Function: Execute command (respects dry-run)
+execute() {
+  local cmd="$1"
+  local description="$2"
+
+  echo -e "  ${description}"
+
+  if [ "$DRY_RUN" = true ]; then
+    echo -e "  ${YELLOW}[DRY RUN]${NC} Would execute: ${cmd}"
+  else
+    echo -e "  ${GREEN}[EXEC]${NC} ${cmd}"
+    eval "$cmd"
+  fi
+}
+
+# Step 1: Verify Source Directory
+print_section "Step 1: Verify Source Directory"
+
+if [ ! -d "$SOURCE_DOCS" ]; then
+  echo -e "${RED}✗ Error: Source directory not found: $SOURCE_DOCS${NC}"
+  echo "  Please run this script from the aios-fullstack root directory"
+  exit 1
+fi
+
+echo -e "${GREEN}✓${NC} Source directory found: $SOURCE_DOCS"
+
+# Count files to migrate
+FILE_COUNT=$(find "$SOURCE_DOCS" -type f -name "*.md" | wc -l)
+echo -e "${GREEN}✓${NC} Found ${FILE_COUNT} files to migrate"
+
+# List files
+echo ""
+echo "  Files to migrate:"
+find "$SOURCE_DOCS" -type f -name "*.md" | while read -r file; do
+  echo "    - ${file}"
+done
+
+# Step 2: Verify Target Repository
+print_section "Step 2: Verify Target Repository"
+
+if [ ! -d "$TARGET_REPO" ]; then
+  echo -e "${RED}✗ Error: Target repository not found: $TARGET_REPO${NC}"
+  echo "  Please clone aios-core first or specify correct path with --target-repo"
+  exit 1
+fi
+
+echo -e "${GREEN}✓${NC} Target repository found: $TARGET_REPO"
+
+# Check if target repo is a git repository
+if [ ! -d "$TARGET_REPO/.git" ]; then
+  echo -e "${YELLOW}⚠  Warning: Target is not a git repository${NC}"
+fi
+
+# Step 3: Create Target Directory Structure
+print_section "Step 3: Create Target Directory Structure"
+
+TARGET_DOCS="$TARGET_REPO/docs/framework"
+
+execute "mkdir -p \"$TARGET_DOCS\"" "Create target directory: $TARGET_DOCS"
+
+# Step 4: Copy Framework Documentation
+print_section "Step 4: Copy Framework Documentation"
+
+find "$SOURCE_DOCS" -type f -name "*.md" | while read -r source_file; do
+  # Get relative path from source docs
+  rel_path="${source_file#${SOURCE_DOCS}/}"
+  target_file="$TARGET_DOCS/$rel_path"
+
+  # Create parent directory if needed
+  target_dir=$(dirname "$target_file")
+  if [ ! -d "$target_dir" ]; then
+    execute "mkdir -p \"$target_dir\"" "Create directory: $target_dir"
+  fi
+
+  # Copy file
+  execute "cp \"$source_file\" \"$target_file\"" "Copy: $rel_path"
+done
+
+# Step 5: Update Internal Links
+print_section "Step 5: Update Internal Links"
+
+echo -e "${YELLOW}  Updating internal documentation links...${NC}"
+
+# This is a simplified link update - may need manual review
+if [ "$DRY_RUN" = false ]; then
+  find "$TARGET_DOCS" -type f -name "*.md" -exec sed -i.bak \
+    -e 's|../../docs/architecture/|../architecture/|g' \
+    -e 's|docs/framework/|./|g' \
+    {} \;
+
+  # Remove backup files
+  find "$TARGET_DOCS" -type f -name "*.bak" -delete
+
+  echo -e "${GREEN}✓${NC} Links updated (review recommended)"
+else
+  echo -e "${YELLOW}[DRY RUN]${NC} Would update links in migrated files"
+fi
+
+# Step 6: Create Migration Notice
+print_section "Step 6: Create Migration Notice"
+
+MIGRATION_NOTICE="$TARGET_DOCS/MIGRATION_NOTICE.md"
+
+if [ "$DRY_RUN" = false ]; then
+  cat > "$MIGRATION_NOTICE" << 'EOF'
+# Framework Documentation Migration Notice
+
+**Migration Date:** $(date +%Y-%m-%d)
+**Source:** aios-fullstack/docs/framework/
+**Target:** aios-core/docs/framework/
+**Story:** 6.1.2.6 - Framework Configuration System
+
+## Migration Status
+
+✅ Framework documentation successfully migrated from aios-fullstack to aios-core (REPO 1)
+
+## Files Migrated
+
+- coding-standards.md - Official AIOS coding standards
+- tech-stack.md - Technology stack and architecture decisions
+- source-tree.md - Project structure and file organization
+
+## Backward Compatibility
+
+For backward compatibility during the migration period (Q2-Q3 2026):
+- aios-fullstack maintains copies in `docs/framework/` (will be removed Q3 2026)
+- aios-fullstack maintains legacy copies in `docs/architecture/` (will be removed Q3 2026)
+
+## Post-Migration Actions
+
+1. Update all agent configuration files to reference new paths
+2. Update CI/CD pipelines to use new documentation location
+3. Add deprecation warnings to old documentation locations
+4. Monitor for broken links and update as needed
+
+## Rollback Procedure
+
+If migration issues occur:
+```bash
+# Restore from aios-fullstack
+cd aios-fullstack
+git log --all --full-history -- "docs/framework/*"
+```
+
+---
+
+*Auto-generated by migrate-framework-docs.sh*
+EOF
+
+  echo -e "${GREEN}✓${NC} Migration notice created: $MIGRATION_NOTICE"
+else
+  echo -e "${YELLOW}[DRY RUN]${NC} Would create migration notice"
+fi
+
+# Step 7: Verification
+print_section "Step 7: Verification"
+
+if [ "$DRY_RUN" = false ]; then
+  TARGET_FILE_COUNT=$(find "$TARGET_DOCS" -type f -name "*.md" ! -name "MIGRATION_NOTICE.md" | wc -l)
+
+  if [ "$TARGET_FILE_COUNT" -eq "$FILE_COUNT" ]; then
+    echo -e "${GREEN}✓${NC} All ${FILE_COUNT} files migrated successfully"
+  else
+    echo -e "${YELLOW}⚠  Warning: File count mismatch${NC}"
+    echo "  Source: ${FILE_COUNT} files"
+    echo "  Target: ${TARGET_FILE_COUNT} files"
+  fi
+
+  echo ""
+  echo "  Migrated files:"
+  find "$TARGET_DOCS" -type f -name "*.md" ! -name "MIGRATION_NOTICE.md" | while read -r file; do
+    rel_path="${file#${TARGET_DOCS}/}"
+    file_size=$(stat -f%z "$file" 2>/dev/null || stat -c%s "$file" 2>/dev/null || echo "unknown")
+    echo "    - ${rel_path} (${file_size} bytes)"
+  done
+else
+  echo -e "${YELLOW}[DRY RUN]${NC} Verification skipped in dry-run mode"
+fi
+
+# Step 8: Git Operations (Optional)
+print_section "Step 8: Git Operations (Optional)"
+
+if [ "$DRY_RUN" = false ] && [ -d "$TARGET_REPO/.git" ]; then
+  echo -e "${YELLOW}  Ready to commit changes?${NC}"
+  echo "  "
+  echo "  Suggested git commands:"
+  echo "    cd $TARGET_REPO"
+  echo "    git add docs/framework/"
+  echo "    git commit -m \"docs: migrate framework documentation from aios-fullstack\""
+  echo ""
+  echo "    Story: 6.1.2.6 - Framework Configuration System"
+  echo "    Migrated: coding-standards.md, tech-stack.md, source-tree.md"
+  echo "    Source: aios-fullstack/docs/framework/"
+  echo ""
+  echo -e "${YELLOW}  Note: Review changes before committing${NC}"
+else
+  echo -e "${YELLOW}[DRY RUN]${NC} Git operations skipped"
+fi
+
+# Summary
+print_section "Migration Summary"
+
+echo -e "${GREEN}✓${NC} Migration completed successfully!"
+echo ""
+echo "  Source: $SOURCE_DOCS"
+echo "  Target: $TARGET_DOCS"
+echo "  Files:  $FILE_COUNT migrated"
+echo ""
+echo "  Next Steps:"
+echo "    1. Review migrated files in $TARGET_DOCS"
+echo "    2. Test agent activations with new paths"
+echo "    3. Update agent config files (agent-config-requirements.yaml)"
+echo "    4. Commit changes to aios-core repository"
+echo "    5. Update aios-fullstack deprecation warnings (Q3 2026)"
+echo ""
+
+if [ "$DRY_RUN" = true ]; then
+  echo -e "${YELLOW}⚠️  This was a DRY RUN - no changes were made${NC}"
+  echo "  Run without --dry-run to perform actual migration"
+  echo ""
+fi
+
+echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+echo ""