aios-core 1.0.0

package/.aios-core/scripts/batch-migrate-phase2.ps1

@@ -0,0 +1,88 @@
+# Phase 2 - Batch migrate agent-specific tasks (50 tasks)
+
+$tasks = @(
+  # Dev Agent Tasks (5 new - 2 already done in Phase 1)
+  'dev-apply-qa-fixes.md',
+  'dev-improve-code-quality.md',
+  'dev-optimize-performance.md',
+  'dev-suggest-refactoring.md',
+  'dev-backlog-debt.md',
+  
+  # QA Agent Tasks (8 new - 2 already done in Phase 1)
+  'qa-generate-tests.md',
+  'qa-nfr-assess.md',
+  'qa-risk-profile.md',
+  'qa-trace-requirements.md',
+  'qa-review-proposal.md',
+  'qa-review-story.md',
+  'qa-run-tests.md',
+  'qa-backlog-add-followup.md',
+  
+  # PO/PM/SM Agent Tasks (12 tasks)
+  'po-pull-story.md',
+  'po-pull-story-from-clickup.md',
+  'po-sync-story.md',
+  'po-sync-story-to-clickup.md',
+  'po-manage-story-backlog.md',
+  'po-backlog-add.md',
+  'po-stories-index.md',
+  'sm-create-next-story.md',
+  'pr-automation.md',
+  'release-management.md',
+  'calculate-roi.md',
+  'collaborative-edit.md',
+  
+  # Architect/Analyst Tasks (7 tasks)
+  'analyze-framework.md',
+  'architect-analyze-impact.md',
+  'analyst-facilitate-brainstorming.md',
+  'advanced-elicitation.md',
+  'create-deep-research-prompt.md',
+  'analyze-performance.md',
+  
+  # UX/Data/DevOps Tasks (14 tasks)
+  'ux-create-wireframe.md',
+  'ux-ds-scan-artifact.md',
+  'ux-user-research.md',
+  'db-apply-migration.md',
+  'db-bootstrap.md',
+  'db-dry-run.md',
+  'db-env-check.md',
+  'db-snapshot.md',
+  'github-devops-github-pr-automation.md',
+  'github-devops-pre-push-quality-gate.md',
+  'github-devops-repository-cleanup.md',
+  'github-devops-version-management.md',
+  'ci-cd-configuration.md',
+  'security-scan.md'
+)
+
+Write-Host "Phase 2: Migrating $($tasks.Count) agent-specific tasks..." -ForegroundColor Cyan
+Write-Host ""
+
+$successCount = 0
+$failCount = 0
+$startTime = Get-Date
+
+foreach ($task in $tasks) {
+  Write-Host "Migrating: $task" -ForegroundColor Yellow
+  node .aios-core/scripts/migrate-task-to-v2.js ".aios-core/tasks/$task" 2>&1 | Out-Null
+  
+  if ($LASTEXITCODE -eq 0 -or $LASTEXITCODE -eq 1) {
+    $successCount++
+    Write-Host "  OK" -ForegroundColor Green
+  } else {
+    $failCount++
+    Write-Host "  FAILED" -ForegroundColor Red
+  }
+}
+
+$endTime = Get-Date
+$duration = $endTime - $startTime
+
+Write-Host ""
+Write-Host "=== Phase 2 Migration Complete ===" -ForegroundColor Green
+Write-Host "Success: $successCount" -ForegroundColor Green
+Write-Host "Failed: $failCount" -ForegroundColor $(if ($failCount -gt 0) { 'Red' } else { 'Green' })
+Write-Host "Duration: $($duration.TotalSeconds) seconds" -ForegroundColor Cyan
+

package/.aios-core/scripts/batch-migrate-phase3.ps1

@@ -0,0 +1,45 @@
+# Phase 3 - Batch migrate remaining utility & support tasks
+
+# Get all remaining non-compliant tasks
+$allTasks = Get-ChildItem .aios-core/tasks/*.md | Where-Object { $_.Name -notlike '*v1-backup*' } | ForEach-Object { $_.Name }
+
+Write-Host "Finding non-compliant tasks..." -ForegroundColor Cyan
+
+$nonCompliantTasks = @()
+
+foreach ($task in $allTasks) {
+  $result = node .aios-core/scripts/validate-task-v2.js ".aios-core/tasks/$task" 2>&1
+  if ($LASTEXITCODE -ne 0) {
+    $nonCompliantTasks += $task
+  }
+}
+
+Write-Host "Phase 3: Migrating $($nonCompliantTasks.Count) remaining tasks..." -ForegroundColor Cyan
+Write-Host ""
+
+$successCount = 0
+$failCount = 0
+$startTime = Get-Date
+
+foreach ($task in $nonCompliantTasks) {
+  Write-Host "Migrating: $task" -ForegroundColor Yellow
+  node .aios-core/scripts/migrate-task-to-v2.js ".aios-core/tasks/$task" 2>&1 | Out-Null
+  
+  if ($LASTEXITCODE -eq 0 -or $LASTEXITCODE -eq 1) {
+    $successCount++
+    Write-Host "  OK" -ForegroundColor Green
+  } else {
+    $failCount++
+    Write-Host "  FAILED" -ForegroundColor Red
+  }
+}
+
+$endTime = Get-Date
+$duration = $endTime - $startTime
+
+Write-Host ""
+Write-Host "=== Phase 3 Migration Complete ===" -ForegroundColor Green
+Write-Host "Success: $successCount" -ForegroundColor Green
+Write-Host "Failed: $failCount" -ForegroundColor $(if ($failCount -gt 0) { 'Red' } else { 'Green' })
+Write-Host "Duration: $($duration.TotalSeconds) seconds" -ForegroundColor Cyan
+

package/.aios-core/scripts/command-execution-hook.js

@@ -0,0 +1,201 @@
+#!/usr/bin/env node
+/**
+ * Command Execution Hook
+ * 
+ * Updates session state after command execution for workflow continuity.
+ * 
+ * Responsibilities:
+ * - Track command execution history
+ * - Update session type (new → existing → workflow)
+ * - Record agent transitions
+ * - Enable intelligent greeting adaptation
+ * 
+ * Usage:
+ *   const { updateSessionAfterCommand } = require('./command-execution-hook');
+ *   await updateSessionAfterCommand(agentId, commandName);
+ * 
+ * Part of Story 6.1.4: Unified Greeting System Integration
+ */
+
+const fs = require('fs').promises;
+const path = require('path');
+
+/**
+ * Session state storage location
+ */
+const SESSION_DIR = path.join(process.cwd(), '.aios-core', '.session');
+const SESSION_FILE = path.join(SESSION_DIR, 'current-session.json');
+
+/**
+ * Maximum command history to keep
+ */
+const MAX_HISTORY_LENGTH = 10;
+
+/**
+ * Update session state after command execution
+ * 
+ * @param {string} agentId - Current agent ID
+ * @param {string} commandName - Executed command name
+ * @param {Object} options - Optional metadata
+ * @param {string} options.previousAgent - Previous agent (for transitions)
+ * @param {any} options.result - Command execution result
+ * @returns {Promise<Object>} Updated session state
+ */
+async function updateSessionAfterCommand(agentId, commandName, options = {}) {
+  try {
+    // Ensure session directory exists
+    await fs.mkdir(SESSION_DIR, { recursive: true });
+    
+    // Load current session or create new
+    const session = await loadSession();
+    
+    // Update command history
+    const commandEntry = {
+      command: commandName,
+      agent: agentId,
+      timestamp: Date.now(),
+      success: options.result !== undefined ? !options.result.error : true,
+    };
+    
+    session.commandHistory = session.commandHistory || [];
+    session.commandHistory.push(commandEntry);
+    
+    // Keep only last MAX_HISTORY_LENGTH commands
+    if (session.commandHistory.length > MAX_HISTORY_LENGTH) {
+      session.commandHistory = session.commandHistory.slice(-MAX_HISTORY_LENGTH);
+    }
+    
+    // Update session type based on history
+    session.sessionType = determineSessionType(session.commandHistory);
+    
+    // Track agent transitions
+    if (options.previousAgent && options.previousAgent !== agentId) {
+      session.previousAgent = options.previousAgent;
+      session.agentTransitions = session.agentTransitions || [];
+      session.agentTransitions.push({
+        from: options.previousAgent,
+        to: agentId,
+        timestamp: Date.now(),
+      });
+    }
+    
+    // Update current agent
+    session.currentAgent = agentId;
+    session.lastUpdated = Date.now();
+    
+    // Save session
+    await saveSession(session);
+    
+    return session;
+    
+  } catch (error) {
+    console.warn('[command-execution-hook] Failed to update session:', error.message);
+    // Non-blocking: return empty session on error
+    return {
+      sessionType: 'new',
+      currentAgent: agentId,
+      commandHistory: [],
+      lastUpdated: Date.now(),
+    };
+  }
+}
+
+/**
+ * Load current session from disk
+ * @private
+ * @returns {Promise<Object>} Session object
+ */
+async function loadSession() {
+  try {
+    const content = await fs.readFile(SESSION_FILE, 'utf8');
+    return JSON.parse(content);
+  } catch (error) {
+    if (error.code === 'ENOENT') {
+      // New session
+      return {
+        sessionType: 'new',
+        commandHistory: [],
+        createdAt: Date.now(),
+        lastUpdated: Date.now(),
+      };
+    }
+    throw error;
+  }
+}
+
+/**
+ * Save session to disk
+ * @private
+ * @param {Object} session - Session object to save
+ */
+async function saveSession(session) {
+  await fs.writeFile(
+    SESSION_FILE,
+    JSON.stringify(session, null, 2),
+    'utf8',
+  );
+}
+
+/**
+ * Determine session type based on command history
+ * @private
+ * @param {Array} commandHistory - Command history array
+ * @returns {string} Session type (new|existing|workflow)
+ */
+function determineSessionType(commandHistory) {
+  if (!commandHistory || commandHistory.length === 0) {
+    return 'new';
+  }
+  
+  if (commandHistory.length === 1) {
+    return 'existing';
+  }
+  
+  // Workflow detection: 3+ commands or agent transitions
+  if (commandHistory.length >= 3) {
+    return 'workflow';
+  }
+  
+  return 'existing';
+}
+
+/**
+ * Get current session state
+ * 
+ * @returns {Promise<Object>} Current session
+ */
+async function getCurrentSession() {
+  try {
+    return await loadSession();
+  } catch (error) {
+    console.warn('[command-execution-hook] Failed to load session:', error.message);
+    return {
+      sessionType: 'new',
+      commandHistory: [],
+      createdAt: Date.now(),
+      lastUpdated: Date.now(),
+    };
+  }
+}
+
+/**
+ * Clear current session (for testing or manual reset)
+ * 
+ * @returns {Promise<void>}
+ */
+async function clearSession() {
+  try {
+    await fs.unlink(SESSION_FILE);
+  } catch (error) {
+    if (error.code !== 'ENOENT') {
+      throw error;
+    }
+  }
+}
+
+module.exports = {
+  updateSessionAfterCommand,
+  getCurrentSession,
+  clearSession,
+};
+

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 ""

package/.aios-core/scripts/session-context-loader.js

@@ -0,0 +1,45 @@
+/**
+ * Session Context Loader - Re-export from canonical location
+ *
+ * @deprecated Use require('../core/session/context-loader') directly
+ * @module scripts/session-context-loader
+ *
+ * This file re-exports SessionContextLoader from its canonical location
+ * in core/session/context-loader.js for backward compatibility.
+ *
+ * Migration note (WIS-3):
+ * - Canonical location: .aios-core/core/session/context-loader.js
+ * - This file exists for backward compatibility with existing imports
+ * - New code should import from core/session/context-loader directly
+ */
+
+'use strict';
+
+// Re-export from canonical location
+const SessionContextLoader = require('../core/session/context-loader');
+
+// CLI Interface (preserved for backward compatibility)
+if (require.main === module) {
+  const loader = new SessionContextLoader();
+  const command = process.argv[2];
+  const agentId = process.argv[3] || 'dev';
+
+  if (command === 'load') {
+    const context = loader.loadContext(agentId);
+    console.log(JSON.stringify(context, null, 2));
+  } else if (command === 'clear') {
+    loader.clearSession();
+    console.log('✅ Session cleared');
+  } else if (command === 'update') {
+    const agentName = process.argv[4] || agentId.toUpperCase();
+    const lastCommand = process.argv[5] || null;
+    loader.updateSession(agentId, agentName, lastCommand);
+    console.log('✅ Session updated');
+  } else {
+    // Default: show greeting format
+    const message = loader.formatForGreeting(agentId);
+    console.log(message || '(No session context)');
+  }
+}
+
+module.exports = SessionContextLoader;