aios-core 2.2.2 → 2.3.1

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

@@ -1,300 +0,0 @@
-/**
- * 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/.claude/CLAUDE.md

@@ -1,221 +0,0 @@
-# AIOS-FULLSTACK Development Rules for Claude Code
-
-You are working with AIOS-FULLSTACK, an AI-Orchestrated System for Full Stack Development.
-
-## Core Framework Understanding
-
-AIOS-FULLSTACK is a meta-framework that orchestrates AI agents to handle complex development workflows. Always recognize and work within this architecture.
-
-## Agent System
-
-### Agent Activation
-- Agents are activated with @agent-name syntax: @dev, @qa, @architect, @pm, @po, @sm, @analyst
-- The master agent is activated with @aios-master
-- Agent commands use the * prefix: *help, *create-story, *task, *exit
-
-### Agent Context
-When an agent is active:
-- Follow that agent's specific persona and expertise
-- Use the agent's designated workflow patterns
-- Maintain the agent's perspective throughout the interaction
-
-## Development Methodology
-
-### Story-Driven Development
-1. **Work from stories** - All development starts with a story in `docs/stories/`
-2. **Update progress** - Mark checkboxes as tasks complete: [ ] → [x]
-3. **Track changes** - Maintain the File List section in the story
-4. **Follow criteria** - Implement exactly what the acceptance criteria specify
-
-### Code Standards
-- Write clean, self-documenting code
-- Follow existing patterns in the codebase
-- Include comprehensive error handling
-- Add unit tests for all new functionality
-- Use TypeScript/JavaScript best practices
-
-### Testing Requirements
-- Run all tests before marking tasks complete
-- Ensure linting passes: `npm run lint`
-- Verify type checking: `npm run typecheck`
-- Add tests for new features
-- Test edge cases and error scenarios
-
-## AIOS Framework Structure
-
-```
-aios-core/
-├── agents/         # Agent persona definitions (YAML/Markdown)
-├── tasks/          # Executable task workflows
-├── workflows/      # Multi-step workflow definitions
-├── templates/      # Document and code templates
-├── checklists/     # Validation and review checklists
-└── rules/          # Framework rules and patterns
-
-docs/
-├── stories/        # Development stories (numbered)
-├── prd/            # Product requirement documents
-├── architecture/   # System architecture documentation
-└── guides/         # User and developer guides
-```
-
-## Workflow Execution
-
-### Task Execution Pattern
-1. Read the complete task/workflow definition
-2. Understand all elicitation points
-3. Execute steps sequentially
-4. Handle errors gracefully
-5. Provide clear feedback
-
-### Interactive Workflows
-- Workflows with `elicit: true` require user input
-- Present options clearly
-- Validate user responses
-- Provide helpful defaults
-
-## Best Practices
-
-### When implementing features:
-- Check existing patterns first
-- Reuse components and utilities
-- Follow naming conventions
-- Keep functions focused and testable
-- Document complex logic
-
-### When working with agents:
-- Respect agent boundaries
-- Use appropriate agent for each task
-- Follow agent communication patterns
-- Maintain agent context
-
-### When handling errors:
-```javascript
-try {
-  // Operation
-} catch (error) {
-  console.error(`Error in ${operation}:`, error);
-  // Provide helpful error message
-  throw new Error(`Failed to ${operation}: ${error.message}`);
-}
-```
-
-## Git & GitHub Integration
-
-### Commit Conventions
-- Use conventional commits: `feat:`, `fix:`, `docs:`, `chore:`, etc.
-- Reference story ID: `feat: implement IDE detection [Story 2.1]`
-- Keep commits atomic and focused
-
-### GitHub CLI Usage
-- Ensure authenticated: `gh auth status`
-- Use for PR creation: `gh pr create`
-- Check org access: `gh api user/memberships`
-
-## AIOS-Specific Patterns
-
-### Working with Templates
-```javascript
-const template = await loadTemplate('template-name');
-const rendered = await renderTemplate(template, context);
-```
-
-### Agent Command Handling
-```javascript
-if (command.startsWith('*')) {
-  const agentCommand = command.substring(1);
-  await executeAgentCommand(agentCommand, args);
-}
-```
-
-### Story Updates
-```javascript
-// Update story progress
-const story = await loadStory(storyId);
-story.updateTask(taskId, { status: 'completed' });
-await story.save();
-```
-
-## Environment Setup
-
-### Required Tools
-- Node.js 18+ 
-- GitHub CLI
-- Git
-- Your preferred package manager (npm/yarn/pnpm)
-
-### Configuration Files
-- `.aios/config.yaml` - Framework configuration
-- `.env` - Environment variables
-- `aios.config.js` - Project-specific settings
-
-## Common Commands
-
-### AIOS Master Commands
-- `*help` - Show available commands
-- `*create-story` - Create new story
-- `*task {name}` - Execute specific task
-- `*workflow {name}` - Run workflow
-
-### Development Commands
-- `npm run dev` - Start development
-- `npm test` - Run tests
-- `npm run lint` - Check code style
-- `npm run build` - Build project
-
-## Debugging
-
-### Enable Debug Mode
-```bash
-export AIOS_DEBUG=true
-```
-
-### View Agent Logs
-```bash
-tail -f .aios/logs/agent.log
-```
-
-### Trace Workflow Execution
-```bash
-npm run trace -- workflow-name
-```
-
-## Claude Code Specific Configuration
-
-### Performance Optimization
-- Prefer batched tool calls when possible for better performance
-- Use parallel execution for independent operations
-- Cache frequently accessed data in memory during sessions
-
-### Tool Usage Guidelines
-- Always use the Grep tool for searching, never `grep` or `rg` in bash
-- Use the Task tool for complex multi-step operations
-- Batch file reads/writes when processing multiple files
-- Prefer editing existing files over creating new ones
-
-### Session Management
-- Track story progress throughout the session
-- Update checkboxes immediately after completing tasks
-- Maintain context of the current story being worked on
-- Save important state before long-running operations
-
-### Error Recovery
-- Always provide recovery suggestions for failures
-- Include error context in messages to user
-- Suggest rollback procedures when appropriate
-- Document any manual fixes required
-
-### Testing Strategy
-- Run tests incrementally during development
-- Always verify lint and typecheck before marking complete
-- Test edge cases for each new feature
-- Document test scenarios in story files
-
-### Documentation
-- Update relevant docs when changing functionality
-- Include code examples in documentation
-- Keep README synchronized with actual behavior
-- Document breaking changes prominently
-
----
-*AIOS-FULLSTACK Claude Code Configuration v2.0*