aios-core 4.0.4 → 4.2.0

package/.aios-core/development/agents/architect.md

@@ -105,7 +105,7 @@ persona:
       - Integration patterns (event-driven, messaging, webhooks)
       - Performance optimization (across all layers)
 
-    delegate_to_data_architect:
+    delegate_to_data_engineer:
       when:
         - Database schema design (tables, relationships, indexes)
         - Query optimization and performance tuning
@@ -123,9 +123,9 @@ persona:
       collaboration_pattern: |
         When user asks data-related questions:
         1. For "which database?" → @architect answers from system perspective
-        2. For "design schema" → Delegate to @data-architect
-        3. For "optimize queries" → Delegate to @data-architect
-        4. For data layer integration → @architect designs, @data-architect provides schema
+        2. For "design schema" → Delegate to @data-engineer
+        3. For "optimize queries" → Delegate to @data-engineer
+        4. For data layer integration → @architect designs, @data-engineer provides schema
 
     delegate_to_github_devops:
       when:
@@ -257,7 +257,7 @@ dependencies:
     - exa # Research technologies and best practices
     - context7 # Look up library documentation and technical references
     - git # Read-only: status, log, diff (NO PUSH - use @github-devops)
-    - supabase-cli # High-level database architecture (schema design → @data-architect)
+    - supabase-cli # High-level database architecture (schema design → @data-engineer)
     - railway-cli # Infrastructure planning and deployment
     - coderabbit # Automated code review for architectural patterns and security
 
@@ -402,7 +402,7 @@ Type `*help` to see all commands, or `*yolo` to skip confirmations.
 
 **I collaborate with:**
 
-- **@db-sage (Dara):** For database schema design and query optimization
+- **@data-engineer (Dara):** For database schema design and query optimization
 - **@ux-design-expert (Uma):** For frontend architecture and user flows
 - **@pm (Morgan):** Receives requirements and strategic direction from
 
@@ -412,7 +412,7 @@ Type `*help` to see all commands, or `*yolo` to skip confirmations.
 
 **When to use others:**
 
-- Database design → Use @db-sage
+- Database design → Use @data-engineer
 - UX/UI design → Use @ux-design-expert
 - Code implementation → Use @dev
 - Push operations → Use @github-devops
@@ -439,21 +439,21 @@ Type `*help` to see all commands, or `*yolo` to skip confirmations.
 
 1. **Requirements analysis** → Review PRD and constraints
 2. **Architecture design** → `*create-full-stack-architecture` or specific layer
-3. **Collaboration** → Coordinate with @db-sage (database) and @ux-design-expert (frontend)
+3. **Collaboration** → Coordinate with @data-engineer (database) and @ux-design-expert (frontend)
 4. **Documentation** → `*document-project` for comprehensive docs
 5. **Handoff** → Provide architecture to @dev for implementation
 
 ### Common Pitfalls
 
 - ❌ Designing without understanding NFRs (scalability, security)
-- ❌ Not consulting @db-sage for data layer
+- ❌ Not consulting @data-engineer for data layer
 - ❌ Over-engineering for current requirements
 - ❌ Skipping architecture checklists
 - ❌ Not considering brownfield constraints
 
 ### Related Agents
 
-- **@db-sage (Dara)** - Database architecture
+- **@data-engineer (Dara)** - Database architecture
 - **@ux-design-expert (Uma)** - Frontend architecture
 - **@pm (Morgan)** - Receives requirements from
 

package/.aios-core/development/agents/devops.md

@@ -129,56 +129,99 @@ persona:
 
 # All commands require * prefix when used (e.g., *help)
 commands:
-  # Core Commands
-  - help: Show all available commands with descriptions
-  - detect-repo: Detect repository context (framework-dev vs project-dev)
-
-  # Quality & Push
-  - version-check: Analyze version and recommend next
-  - pre-push: Run all quality checks before push
-  - push: Execute git push after quality gates pass
-
-  # GitHub Operations
-  - create-pr: Create pull request from current branch
-  - configure-ci: Setup/update GitHub Actions workflows
-  - release: Create versioned release with changelog
-
-  # Repository Management
-  - cleanup: Identify and remove stale branches/files
-  - init-project-status: Initialize dynamic project status tracking (Story 6.1.2.4)
-
-  # Environment Setup (Greenfield Phase 0)
-  - environment-bootstrap: Complete environment setup for new projects (CLIs, auth, Git/GitHub)
-  - setup-github: Configure DevOps infrastructure for user projects (workflows, CodeRabbit, branch protection, secrets) [Story 5.10]
-
-  # MCP Management (via Docker Gateway) [Story 6.14]
-  - search-mcp: Search available MCPs in Docker MCP Toolkit catalog
-  - add-mcp: Add MCP server to Docker MCP Toolkit
-  - list-mcps: List currently enabled MCPs and their tools
-  - remove-mcp: Remove MCP server from Docker MCP Toolkit
-  - setup-mcp-docker: Initial Docker MCP Toolkit configuration [Story 5.11]
-
-  # Documentation Quality
-  - check-docs: Verify documentation links integrity (broken, incorrect markings)
-
-  # Worktree Management (Story 1.3-1.4 - ADE Infrastructure)
-  - create-worktree: Create isolated worktree for story development
-  - list-worktrees: List all active worktrees with status
-  - remove-worktree: Remove worktree (with safety checks)
-  - cleanup-worktrees: Remove all stale worktrees (> 30 days)
-  - merge-worktree: Merge worktree branch back to base
-
-  # Migration Management (Epic 2 - V2→V3 Migration)
-  - inventory-assets: Generate migration inventory from V2 assets
-  - analyze-paths: Analyze path dependencies and migration impact
-  - migrate-agent: Migrate single agent from V2 to V3 format
-  - migrate-batch: Batch migrate all agents with validation
-
-  # Utilities
-  - session-info: Show current session details (agent history, commands)
-  - guide: Show comprehensive usage guide for this agent
-  - yolo: 'Toggle permission mode (cycle: ask > auto > explore)'
-  - exit: Exit DevOps mode
+  - name: help
+    visibility: [full, quick, key]
+    description: 'Show all available commands with descriptions'
+  - name: detect-repo
+    visibility: [full, quick, key]
+    description: 'Detect repository context (framework-dev vs project-dev)'
+  - name: version-check
+    visibility: [full, quick, key]
+    description: 'Analyze version and recommend next'
+  - name: pre-push
+    visibility: [full, quick, key]
+    description: 'Run all quality checks before push'
+  - name: push
+    visibility: [full, quick, key]
+    description: 'Execute git push after quality gates pass'
+  - name: create-pr
+    visibility: [full, quick, key]
+    description: 'Create pull request from current branch'
+  - name: configure-ci
+    visibility: [full, quick]
+    description: 'Setup/update GitHub Actions workflows'
+  - name: release
+    visibility: [full, quick]
+    description: 'Create versioned release with changelog'
+  - name: cleanup
+    visibility: [full, quick]
+    description: 'Identify and remove stale branches/files'
+  - name: init-project-status
+    visibility: [full]
+    description: 'Initialize dynamic project status tracking (Story 6.1.2.4)'
+  - name: environment-bootstrap
+    visibility: [full]
+    description: 'Complete environment setup for new projects (CLIs, auth, Git/GitHub)'
+  - name: setup-github
+    visibility: [full]
+    description: 'Configure DevOps infrastructure for user projects (workflows, CodeRabbit, branch protection, secrets) [Story 5.10]'
+  - name: search-mcp
+    visibility: [full]
+    description: 'Search available MCPs in Docker MCP Toolkit catalog'
+  - name: add-mcp
+    visibility: [full]
+    description: 'Add MCP server to Docker MCP Toolkit'
+  - name: list-mcps
+    visibility: [full]
+    description: 'List currently enabled MCPs and their tools'
+  - name: remove-mcp
+    visibility: [full]
+    description: 'Remove MCP server from Docker MCP Toolkit'
+  - name: setup-mcp-docker
+    visibility: [full]
+    description: 'Initial Docker MCP Toolkit configuration [Story 5.11]'
+  - name: check-docs
+    visibility: [full, quick]
+    description: 'Verify documentation links integrity (broken, incorrect markings)'
+  - name: create-worktree
+    visibility: [full]
+    description: 'Create isolated worktree for story development'
+  - name: list-worktrees
+    visibility: [full]
+    description: 'List all active worktrees with status'
+  - name: remove-worktree
+    visibility: [full]
+    description: 'Remove worktree (with safety checks)'
+  - name: cleanup-worktrees
+    visibility: [full]
+    description: 'Remove all stale worktrees (> 30 days)'
+  - name: merge-worktree
+    visibility: [full]
+    description: 'Merge worktree branch back to base'
+  - name: inventory-assets
+    visibility: [full]
+    description: 'Generate migration inventory from V2 assets'
+  - name: analyze-paths
+    visibility: [full]
+    description: 'Analyze path dependencies and migration impact'
+  - name: migrate-agent
+    visibility: [full]
+    description: 'Migrate single agent from V2 to V3 format'
+  - name: migrate-batch
+    visibility: [full]
+    description: 'Batch migrate all agents with validation'
+  - name: session-info
+    visibility: [full, quick]
+    description: 'Show current session details (agent history, commands)'
+  - name: guide
+    visibility: [full, quick, key]
+    description: 'Show comprehensive usage guide for this agent'
+  - name: yolo
+    visibility: [full, quick, key]
+    description: 'Toggle permission mode (cycle: ask > auto > explore)'
+  - name: exit
+    visibility: [full, quick, key]
+    description: 'Exit DevOps mode'
 
 dependencies:
   tasks:

package/.aios-core/development/agents/qa.md

@@ -94,46 +94,100 @@ story-file-permissions:
   - CRITICAL: Your updates must be limited to appending your review results in the QA Results section only
 # All commands require * prefix when used (e.g., *help)
 commands:
-  # Code Review & Analysis
-  - help: Show all available commands with descriptions
-  - 'code-review {scope}': 'Run automated review (scope: uncommitted or committed)'
-  - 'review {story}': Comprehensive story review with gate decision
-  - 'review-build {story}': '10-phase structured QA review (Epic 6) - outputs qa_report.md'
-
-  # Quality Gates
-  - 'gate {story}': Create quality gate decision
-  - 'nfr-assess {story}': Validate non-functional requirements
-  - 'risk-profile {story}': Generate risk assessment matrix
-
-  # Fix Requests (Epic 6 - QA Loop)
-  - 'create-fix-request {story}': Generate QA_FIX_REQUEST.md for @dev with issues to fix
-
-  # Enhanced Validation (Absorbed from Auto-Claude)
-  - 'validate-libraries {story}': Validate third-party library usage via Context7
-  - 'security-check {story}': Run 8-point security vulnerability scan
-  - 'validate-migrations {story}': Validate database migrations for schema changes
-  - 'evidence-check {story}': Verify evidence-based QA requirements
-  - 'false-positive-check {story}': Critical thinking verification for bug fixes
-  - 'console-check {story}': Browser console error detection
-
-  # Test Strategy
-  - 'test-design {story}': Create comprehensive test scenarios
-  - 'trace {story}': 'Map requirements to tests (Given-When-Then)'
-  - 'create-suite {story}': 'Create test suite for story (Authority: QA owns test suites)'
-
-  # Spec Pipeline (Epic 3 - ADE)
-  - 'critique-spec {story}': Review and critique specification for completeness and clarity
-
-  # Backlog Management
-  - 'backlog-add {story} {type} {priority} {title}': Add item to story backlog
-  - 'backlog-update {item_id} {status}': Update backlog item status
-  - backlog-review: Generate backlog review for sprint planning
-
-  # Utilities
-  - session-info: Show current session details (agent history, commands)
-  - guide: Show comprehensive usage guide for this agent
-  - yolo: 'Toggle permission mode (cycle: ask > auto > explore)'
-  - exit: Exit QA mode
+  - name: help
+    visibility: [full, quick, key]
+    description: 'Show all available commands with descriptions'
+  - name: code-review
+    visibility: [full, quick]
+    args: '{scope}'
+    description: 'Run automated review (scope: uncommitted or committed)'
+  - name: review
+    visibility: [full, quick, key]
+    args: '{story}'
+    description: 'Comprehensive story review with gate decision'
+  - name: review-build
+    visibility: [full]
+    args: '{story}'
+    description: '10-phase structured QA review (Epic 6) - outputs qa_report.md'
+  - name: gate
+    visibility: [full, quick]
+    args: '{story}'
+    description: 'Create quality gate decision'
+  - name: nfr-assess
+    visibility: [full, quick]
+    args: '{story}'
+    description: 'Validate non-functional requirements'
+  - name: risk-profile
+    visibility: [full, quick]
+    args: '{story}'
+    description: 'Generate risk assessment matrix'
+  - name: create-fix-request
+    visibility: [full]
+    args: '{story}'
+    description: 'Generate QA_FIX_REQUEST.md for @dev with issues to fix'
+  - name: validate-libraries
+    visibility: [full]
+    args: '{story}'
+    description: 'Validate third-party library usage via Context7'
+  - name: security-check
+    visibility: [full, quick]
+    args: '{story}'
+    description: 'Run 8-point security vulnerability scan'
+  - name: validate-migrations
+    visibility: [full]
+    args: '{story}'
+    description: 'Validate database migrations for schema changes'
+  - name: evidence-check
+    visibility: [full]
+    args: '{story}'
+    description: 'Verify evidence-based QA requirements'
+  - name: false-positive-check
+    visibility: [full]
+    args: '{story}'
+    description: 'Critical thinking verification for bug fixes'
+  - name: console-check
+    visibility: [full]
+    args: '{story}'
+    description: 'Browser console error detection'
+  - name: test-design
+    visibility: [full, quick]
+    args: '{story}'
+    description: 'Create comprehensive test scenarios'
+  - name: trace
+    visibility: [full, quick]
+    args: '{story}'
+    description: 'Map requirements to tests (Given-When-Then)'
+  - name: create-suite
+    visibility: [full]
+    args: '{story}'
+    description: 'Create test suite for story (Authority: QA owns test suites)'
+  - name: critique-spec
+    visibility: [full]
+    args: '{story}'
+    description: 'Review and critique specification for completeness and clarity'
+  - name: backlog-add
+    visibility: [full]
+    args: '{story} {type} {priority} {title}'
+    description: 'Add item to story backlog'
+  - name: backlog-update
+    visibility: [full]
+    args: '{item_id} {status}'
+    description: 'Update backlog item status'
+  - name: backlog-review
+    visibility: [full, quick]
+    description: 'Generate backlog review for sprint planning'
+  - name: session-info
+    visibility: [full, quick]
+    description: 'Show current session details (agent history, commands)'
+  - name: guide
+    visibility: [full, quick, key]
+    description: 'Show comprehensive usage guide for this agent'
+  - name: yolo
+    visibility: [full, quick, key]
+    description: 'Toggle permission mode (cycle: ask > auto > explore)'
+  - name: exit
+    visibility: [full, quick, key]
+    description: 'Exit QA mode'
 dependencies:
   data:
     - technical-preferences.md

package/.aios-core/development/agents/ux-design-expert.md

@@ -9,9 +9,9 @@ CRITICAL: Read the full YAML BLOCK that FOLLOWS IN THIS FILE to understand your
 ```yaml
 IDE-FILE-RESOLUTION:
   - FOR LATER USE ONLY - NOT FOR ACTIVATION, when executing commands that reference dependencies
-  - Dependencies map to aios-core/{type}/{name}
+  - Dependencies map to .aios-core/development/{type}/{name}
   - type=folder (tasks|templates|checklists|data|workflows|etc...), name=file-name
-  - Example: audit-codebase.md → aios-core/tasks/audit-codebase.md
+  - Example: audit-codebase.md → .aios-core/development/tasks/audit-codebase.md
   - IMPORTANT: Only load these files when user requests specific command execution
 
 REQUEST-RESOLUTION:
@@ -85,38 +85,38 @@ agent:
     Use DIRECT Read() with exact paths. NO Search/Grep.
 
     Phase 1 Commands:
-    *research        → Read("aios-core/tasks/ux-user-research.md")
-    *wireframe       → Read("aios-core/tasks/ux-create-wireframe.md")
-    *generate-ui-prompt → Read("aios-core/tasks/generate-ai-frontend-prompt.md")
-    *create-front-end-spec → Read("aios-core/tasks/create-doc.md") + template
+    *research        → Read(".aios-core/development/tasks/ux-user-research.md")
+    *wireframe       → Read(".aios-core/development/tasks/ux-create-wireframe.md")
+    *generate-ui-prompt → Read(".aios-core/development/tasks/generate-ai-frontend-prompt.md")
+    *create-front-end-spec → Read(".aios-core/development/tasks/create-doc.md") + template
 
     Phase 2 Commands:
-    *audit           → Read("aios-core/tasks/audit-codebase.md")
-    *consolidate     → Read("aios-core/tasks/consolidate-patterns.md")
-    *shock-report    → Read("aios-core/tasks/generate-shock-report.md")
+    *audit           → Read(".aios-core/development/tasks/audit-codebase.md")
+    *consolidate     → Read(".aios-core/development/tasks/consolidate-patterns.md")
+    *shock-report    → Read(".aios-core/development/tasks/generate-shock-report.md")
 
     Phase 3 Commands:
-    *tokenize        → Read("aios-core/tasks/extract-tokens.md")
-    *setup           → Read("aios-core/tasks/setup-design-system.md")
-    *migrate         → Read("aios-core/tasks/generate-migration-strategy.md")
-    *upgrade-tailwind → Read("aios-core/tasks/tailwind-upgrade.md")
-    *audit-tailwind-config → Read("aios-core/tasks/audit-tailwind-config.md")
-    *export-dtcg     → Read("aios-core/tasks/export-design-tokens-dtcg.md")
-    *bootstrap-shadcn → Read("aios-core/tasks/bootstrap-shadcn-library.md")
+    *tokenize        → Read(".aios-core/development/tasks/extract-tokens.md")
+    *setup           → Read(".aios-core/development/tasks/setup-design-system.md")
+    *migrate         → Read(".aios-core/development/tasks/generate-migration-strategy.md")
+    *upgrade-tailwind → Read(".aios-core/development/tasks/tailwind-upgrade.md")
+    *audit-tailwind-config → Read(".aios-core/development/tasks/audit-tailwind-config.md")
+    *export-dtcg     → Read(".aios-core/development/tasks/export-design-tokens-dtcg.md")
+    *bootstrap-shadcn → Read(".aios-core/development/tasks/bootstrap-shadcn-library.md")
 
     Phase 4 Commands:
-    *build           → Read("aios-core/tasks/build-component.md")
-    *compose         → Read("aios-core/tasks/compose-molecule.md")
-    *extend          → Read("aios-core/tasks/extend-pattern.md")
+    *build           → Read(".aios-core/development/tasks/build-component.md")
+    *compose         → Read(".aios-core/development/tasks/compose-molecule.md")
+    *extend          → Read(".aios-core/development/tasks/extend-pattern.md")
 
     Phase 5 Commands:
-    *document        → Read("aios-core/tasks/generate-documentation.md")
-    *a11y-check      → Read("aios-core/checklists/accessibility-wcag-checklist.md")
-    *calculate-roi   → Read("aios-core/tasks/calculate-roi.md")
+    *document        → Read(".aios-core/development/tasks/generate-documentation.md")
+    *a11y-check      → Read(".aios-core/development/checklists/accessibility-wcag-checklist.md")
+    *calculate-roi   → Read(".aios-core/development/tasks/calculate-roi.md")
 
     Universal Commands:
-    *scan            → Read("aios-core/tasks/ux-ds-scan-artifact.md")
-    *integrate       → Read("aios-core/tasks/integrate-Squad.md")
+    *scan            → Read(".aios-core/development/tasks/ux-ds-scan-artifact.md")
+    *integrate       → Read(".aios-core/development/tasks/integrate-Squad.md")
 
 persona_profile:
   archetype: Empathizer
@@ -196,7 +196,7 @@ commands:
 
   # === UNIVERSAL COMMANDS ===
   scan {path|url}: 'Analyze HTML/React artifact for patterns'
-  integrate {pack}: 'Connect with expansion pack'
+  integrate {pack}: 'Connect with squad'
   help: 'Show all commands organized by phase'
   status: 'Show current workflow phase'
   guide: 'Show comprehensive usage guide for this agent'

package/.aios-core/development/scripts/activation-runtime.js

@@ -0,0 +1,63 @@
+'use strict';
+
+const { UnifiedActivationPipeline } = require('./unified-activation-pipeline');
+
+/**
+ * Canonical activation runtime for AIOS agents.
+ *
+ * This wrapper centralizes agent activation calls so IDE-specific entry points
+ * (Codex, Claude Code, scripts) can depend on one stable API.
+ */
+class ActivationRuntime {
+  /**
+   * @param {Object} [options]
+   * @param {string} [options.projectRoot]
+   * @param {UnifiedActivationPipeline} [options.pipeline]
+   */
+  constructor(options = {}) {
+    this.pipeline = options.pipeline || new UnifiedActivationPipeline({
+      projectRoot: options.projectRoot,
+    });
+  }
+
+  /**
+   * Activate agent and return the full activation result.
+   * @param {string} agentId
+   * @param {Object} [options]
+   * @returns {Promise<{greeting: string, context: Object, duration: number, quality: string, metrics: Object}>}
+   */
+  async activate(agentId, options = {}) {
+    return this.pipeline.activate(agentId, options);
+  }
+
+  /**
+   * Activate agent and return only greeting text.
+   * @param {string} agentId
+   * @param {Object} [options]
+   * @returns {Promise<string>}
+   */
+  async activateGreeting(agentId, options = {}) {
+    try {
+      const result = await this.activate(agentId, options);
+      return result && typeof result.greeting === 'string' ? result.greeting : '';
+    } catch (error) {
+      throw new Error(`ActivationRuntime.activateGreeting failed for "${agentId}": ${error.message}`);
+    }
+  }
+}
+
+/**
+ * Convenience helper for one-shot activation.
+ * @param {string} agentId
+ * @param {Object} [options]
+ * @returns {Promise<{greeting: string, context: Object, duration: number, quality: string, metrics: Object}>}
+ */
+function activateAgent(agentId, options = {}) {
+  const runtime = new ActivationRuntime(options);
+  return runtime.activate(agentId, options);
+}
+
+module.exports = {
+  ActivationRuntime,
+  activateAgent,
+};

package/.aios-core/development/scripts/generate-greeting.js

@@ -2,11 +2,11 @@
 /**
  * Unified Greeting Generator - CLI Wrapper
  *
- * Story ACT-6: Refactored as thin wrapper around UnifiedActivationPipeline.
+ * Story ACT-6: Refactored as thin wrapper around ActivationRuntime.
  *
  * ARCHITECTURE NOTE:
  * This file is now a thin CLI wrapper that delegates to the
- * UnifiedActivationPipeline for all context loading and greeting generation.
+ * ActivationRuntime for all context loading and greeting generation.
  * Previously, this file orchestrated its own parallel loading of
  * AgentConfigLoader, SessionContextLoader, and ProjectStatusLoader.
  * Now ALL agents (not just 3) can use the same unified pipeline.
@@ -19,9 +19,10 @@
  * Usage: node generate-greeting.js <agent-id>
  *
  * Used by: @devops, @data-engineer, @ux-design-expert (CLI invocation pattern)
- * Note: All 12 agents now use UnifiedActivationPipeline internally.
+ * Note: All 12 agents now activate through ActivationRuntime.
  *
- * @see unified-activation-pipeline.js for the actual pipeline logic
+ * @see activation-runtime.js for the runtime entrypoint
+ * @see unified-activation-pipeline.js for pipeline internals
  * @see greeting-builder.js for core greeting logic
  *
  * Part of Story 6.1.4: Unified Greeting System Integration
@@ -30,12 +31,12 @@
 
 'use strict';
 
-const { UnifiedActivationPipeline } = require('./unified-activation-pipeline');
+const { ActivationRuntime } = require('./activation-runtime');
 
 /**
  * Generate unified greeting for agent activation.
  *
- * Delegates to UnifiedActivationPipeline.activate() which handles:
+ * Delegates to ActivationRuntime.activate() which handles:
  * - Parallel loading of config, session, project status, git, permissions
  * - Sequential context detection and workflow state
  * - Greeting generation via GreetingBuilder
@@ -49,8 +50,8 @@ const { UnifiedActivationPipeline } = require('./unified-activation-pipeline');
  */
 async function generateGreeting(agentId) {
   try {
-    const pipeline = new UnifiedActivationPipeline();
-    const result = await pipeline.activate(agentId);
+    const runtime = new ActivationRuntime();
+    const result = await runtime.activate(agentId);
 
     if (result.duration > 100) {
       console.warn(`[generate-greeting] Slow generation: ${result.duration}ms`);