aios-core 2.1.5 → 2.2.0

package/.aios-core/infrastructure/scripts/pm-adapter.js

@@ -1,134 +1,134 @@
-/**
- * @fileoverview Base interface for Project Management tool adapters
- *
- * This file defines the PMAdapter base class that all PM tool adapters must extend.
- * Supports ClickUp, GitHub Projects, Jira, and local-only modes.
- *
- * @see Story 3.20 - PM Tool-Agnostic Integration
- */
-
-/**
- * Base class for Project Management tool adapters
- *
- * All PM tool adapters (ClickUp, GitHub, Jira, Local) must extend this class
- * and implement all abstract methods.
- *
- * @abstract
- */
-class PMAdapter {
-  /**
-   * Create a PM adapter instance
-   * @param {object} config - Adapter-specific configuration
-   */
-  constructor(config = {}) {
-    this.config = config;
-  }
-
-  /**
-   * Sync local story to PM tool
-   *
-   * Pushes the current state of a story YAML file to the configured PM tool.
-   * Creates or updates the corresponding item in the PM tool.
-   *
-   * @param {string} storyPath - Absolute path to story YAML file
-   * @returns {Promise<{success: boolean, url?: string, error?: string}>}
-   * @throws {Error} If not implemented by subclass
-   *
-   * @example
-   * const result = await adapter.syncStory('/path/to/story/3.20.yaml');
-   * if (result.success) {
-   *   console.log('Story synced:', result.url);
-   * }
-   */
-  async syncStory(_storyPath) {
-    throw new Error('syncStory must be implemented by adapter');
-  }
-
-  /**
-   * Pull story updates from PM tool
-   *
-   * Retrieves the current state of a story from the PM tool and returns
-   * any updates that differ from the local YAML file.
-   *
-   * @param {string} storyId - Story ID (e.g., "3.14")
-   * @returns {Promise<{success: boolean, updates?: object, error?: string}>}
-   * @throws {Error} If not implemented by subclass
-   *
-   * @example
-   * const result = await adapter.pullStory('3.20');
-   * if (result.success && result.updates) {
-   *   console.log('Story has updates:', result.updates);
-   * }
-   */
-  async pullStory(_storyId) {
-    throw new Error('pullStory must be implemented by adapter');
-  }
-
-  /**
-   * Create new story in PM tool
-   *
-   * Creates a new item in the PM tool based on story metadata.
-   * Does not modify the local YAML file.
-   *
-   * @param {object} storyData - Story metadata (id, title, description, etc.)
-   * @returns {Promise<{success: boolean, url?: string, error?: string}>}
-   * @throws {Error} If not implemented by subclass
-   *
-   * @example
-   * const result = await adapter.createStory({
-   *   id: '3.20',
-   *   title: 'PM Tool-Agnostic Integration',
-   *   description: 'Remove hard-coded ClickUp dependency'
-   * });
-   */
-  async createStory(_storyData) {
-    throw new Error('createStory must be implemented by adapter');
-  }
-
-  /**
-   * Update story status in PM tool
-   *
-   * Updates only the status field of a story in the PM tool.
-   * Useful for workflow state transitions (Draft → InProgress → Done).
-   *
-   * @param {string} storyId - Story ID (e.g., "3.14")
-   * @param {string} status - New status (Draft, InProgress, Review, Done)
-   * @returns {Promise<{success: boolean, error?: string}>}
-   * @throws {Error} If not implemented by subclass
-   *
-   * @example
-   * await adapter.updateStatus('3.20', 'InProgress');
-   */
-  async updateStatus(_storyId, _status) {
-    throw new Error('updateStatus must be implemented by adapter');
-  }
-
-  /**
-   * Test connection to PM tool
-   *
-   * Validates that the adapter can connect to the PM tool with the
-   * provided configuration. Used during initial setup.
-   *
-   * @returns {Promise<{success: boolean, error?: string}>}
-   * @throws {Error} If not implemented by subclass
-   *
-   * @example
-   * const result = await adapter.testConnection();
-   * if (!result.success) {
-   *   console.error('Connection failed:', result.error);
-   * }
-   */
-  async testConnection() {
-    throw new Error('testConnection must be implemented by adapter');
-  }
-
-  /**
-   * Get adapter name
-   * @returns {string} Adapter name (e.g., 'ClickUp', 'GitHub Projects')
-   */
-  getName() {
-    return this.constructor.name.replace('Adapter', '');
-  }
-}
-
-module.exports = { PMAdapter };
+/**
+ * @fileoverview Base interface for Project Management tool adapters
+ *
+ * This file defines the PMAdapter base class that all PM tool adapters must extend.
+ * Supports ClickUp, GitHub Projects, Jira, and local-only modes.
+ *
+ * @see Story 3.20 - PM Tool-Agnostic Integration
+ */
+
+/**
+ * Base class for Project Management tool adapters
+ *
+ * All PM tool adapters (ClickUp, GitHub, Jira, Local) must extend this class
+ * and implement all abstract methods.
+ *
+ * @abstract
+ */
+class PMAdapter {
+  /**
+   * Create a PM adapter instance
+   * @param {object} config - Adapter-specific configuration
+   */
+  constructor(config = {}) {
+    this.config = config;
+  }
+
+  /**
+   * Sync local story to PM tool
+   *
+   * Pushes the current state of a story YAML file to the configured PM tool.
+   * Creates or updates the corresponding item in the PM tool.
+   *
+   * @param {string} storyPath - Absolute path to story YAML file
+   * @returns {Promise<{success: boolean, url?: string, error?: string}>}
+   * @throws {Error} If not implemented by subclass
+   *
+   * @example
+   * const result = await adapter.syncStory('/path/to/story/3.20.yaml');
+   * if (result.success) {
+   *   console.log('Story synced:', result.url);
+   * }
+   */
+  async syncStory(_storyPath) {
+    throw new Error('syncStory must be implemented by adapter');
+  }
+
+  /**
+   * Pull story updates from PM tool
+   *
+   * Retrieves the current state of a story from the PM tool and returns
+   * any updates that differ from the local YAML file.
+   *
+   * @param {string} storyId - Story ID (e.g., "3.14")
+   * @returns {Promise<{success: boolean, updates?: object, error?: string}>}
+   * @throws {Error} If not implemented by subclass
+   *
+   * @example
+   * const result = await adapter.pullStory('3.20');
+   * if (result.success && result.updates) {
+   *   console.log('Story has updates:', result.updates);
+   * }
+   */
+  async pullStory(_storyId) {
+    throw new Error('pullStory must be implemented by adapter');
+  }
+
+  /**
+   * Create new story in PM tool
+   *
+   * Creates a new item in the PM tool based on story metadata.
+   * Does not modify the local YAML file.
+   *
+   * @param {object} storyData - Story metadata (id, title, description, etc.)
+   * @returns {Promise<{success: boolean, url?: string, error?: string}>}
+   * @throws {Error} If not implemented by subclass
+   *
+   * @example
+   * const result = await adapter.createStory({
+   *   id: '3.20',
+   *   title: 'PM Tool-Agnostic Integration',
+   *   description: 'Remove hard-coded ClickUp dependency'
+   * });
+   */
+  async createStory(_storyData) {
+    throw new Error('createStory must be implemented by adapter');
+  }
+
+  /**
+   * Update story status in PM tool
+   *
+   * Updates only the status field of a story in the PM tool.
+   * Useful for workflow state transitions (Draft → InProgress → Done).
+   *
+   * @param {string} storyId - Story ID (e.g., "3.14")
+   * @param {string} status - New status (Draft, InProgress, Review, Done)
+   * @returns {Promise<{success: boolean, error?: string}>}
+   * @throws {Error} If not implemented by subclass
+   *
+   * @example
+   * await adapter.updateStatus('3.20', 'InProgress');
+   */
+  async updateStatus(_storyId, _status) {
+    throw new Error('updateStatus must be implemented by adapter');
+  }
+
+  /**
+   * Test connection to PM tool
+   *
+   * Validates that the adapter can connect to the PM tool with the
+   * provided configuration. Used during initial setup.
+   *
+   * @returns {Promise<{success: boolean, error?: string}>}
+   * @throws {Error} If not implemented by subclass
+   *
+   * @example
+   * const result = await adapter.testConnection();
+   * if (!result.success) {
+   *   console.error('Connection failed:', result.error);
+   * }
+   */
+  async testConnection() {
+    throw new Error('testConnection must be implemented by adapter');
+  }
+
+  /**
+   * Get adapter name
+   * @returns {string} Adapter name (e.g., 'ClickUp', 'GitHub Projects')
+   */
+  getName() {
+    return this.constructor.name.replace('Adapter', '');
+  }
+}
+
+module.exports = { PMAdapter };

package/.aios-core/infrastructure/scripts/repository-detector.js

@@ -36,11 +36,11 @@ function detectRepositoryContext() {
 
   const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8'));
 
-  // Detect if we're in aios-fullstack repo itself
+  // Detect if we're in @synkra/aios-core repo itself
   const isFrameworkRepo =
     packageJson.name === '@aios/fullstack' ||
-    packageJson.name === 'aios-fullstack' ||
-    remoteUrl.includes('aios-fullstack');
+    packageJson.name === '@synkra/aios-core' ||
+    remoteUrl.includes('@synkra/aios-core');
 
   // Load installation config if exists
   let installConfig = null;

package/.aios-core/infrastructure/scripts/template-engine.js

@@ -1,5 +1,5 @@
 /**
- * Template Engine for AIOS-FULLSTACK
+ * Template Engine for Synkra AIOS
  * Handles variable substitution, conditionals, and loops for component generation
  * @module template-engine
  */

package/.aios-core/infrastructure/scripts/template-validator.js

@@ -1,5 +1,5 @@
 /**
- * Template Validator for AIOS-FULLSTACK
+ * Template Validator for Synkra AIOS
  * Validates component templates for required structure and placeholders
  * @module template-validator
  */

package/.aios-core/infrastructure/scripts/test-generator.js

@@ -3,7 +3,7 @@ const path = require('path');
 const chalk = require('chalk');
 
 /**
- * Test generator for AIOS-FULLSTACK automated test generation
+ * Test generator for Synkra AIOS automated test generation
  * Orchestrates test file creation using the template system
  */
 class TestGenerator {

package/.aios-core/infrastructure/scripts/test-quality-assessment.js

@@ -3,7 +3,7 @@ const path = require('path');
 const chalk = require('chalk');
 
 /**
- * Test quality assessment for AIOS-FULLSTACK test generation
+ * Test quality assessment for Synkra AIOS test generation
  * Evaluates generated test quality and provides improvement recommendations
  */
 class TestQualityAssessment {

package/.aios-core/infrastructure/scripts/transaction-manager.js

@@ -1,5 +1,5 @@
 /**
- * Transaction Manager for AIOS-FULLSTACK
+ * Transaction Manager for Synkra AIOS
  * Manages component operations with rollback support
  * @module transaction-manager
  */

package/.aios-core/infrastructure/scripts/usage-analytics.js

@@ -3,7 +3,7 @@ const path = require('path');
 const chalk = require('chalk');
 
 /**
- * Usage pattern analyzer for AIOS-FULLSTACK framework components
+ * Usage pattern analyzer for Synkra AIOS framework components
  * Analyzes how components are used throughout the codebase
  */
 class UsageAnalytics {

package/.aios-core/infrastructure/scripts/visual-impact-generator.js

@@ -3,7 +3,7 @@ const path = require('path');
 const chalk = require('chalk');
 
 /**
- * Visual impact generator for AIOS-FULLSTACK framework
+ * Visual impact generator for Synkra AIOS framework
  * Creates visual representations of impact analysis results
  */
 class VisualImpactGenerator {
@@ -499,7 +499,7 @@ class VisualImpactGenerator {
         </div>
 
         <div class="footer">
-            Generated on ${new Date().toLocaleString()} | AIOS-FULLSTACK Impact Analysis
+            Generated on ${new Date().toLocaleString()} | Synkra AIOS Impact Analysis
         </div>
     </div>
 </body>

package/.aios-core/infrastructure/templates/core-config/core-config-brownfield.tmpl.yaml

@@ -0,0 +1,176 @@
+# AIOS Core Configuration
+# Generated by AIOS Documentation Integrity System
+# Mode: Brownfield (Existing Project Integration)
+# Date: {{GENERATED_DATE}}
+#
+# NOTE: This is a template file (.tmpl.yaml) - not raw YAML.
+# Placeholders are processed by the documentation-integrity generator.
+
+# =============================================================================
+# PROJECT CONFIGURATION
+# =============================================================================
+project:
+  type: USER_PROJECT
+  mode: brownfield
+  name: "{{PROJECT_NAME}}"
+  analyzed: "{{GENERATED_DATE}}"
+  version: "{{PROJECT_VERSION}}"
+
+  # Analysis metadata from brownfield analyzer
+  analysis:
+    existing_structure: {{HAS_EXISTING_STRUCTURE}}
+    existing_workflows: {{HAS_EXISTING_WORKFLOWS}}
+    existing_standards: {{HAS_EXISTING_STANDARDS}}
+    merge_strategy: "{{MERGE_STRATEGY}}"  # parallel | replace | manual
+
+    # Detected configurations (for reference)
+    detected:
+      tech_stack: {{DETECTED_TECH_STACK}}
+      frameworks: {{DETECTED_FRAMEWORKS}}
+      linting: {{DETECTED_LINTING}}
+      formatting: {{DETECTED_FORMATTING}}
+      testing: {{DETECTED_TESTING}}
+
+# =============================================================================
+# DEV CONTEXT LOADING
+# Files loaded automatically when @dev agent activates
+# =============================================================================
+devLoadAlwaysFiles:
+  - docs/architecture/coding-standards.md
+  - docs/architecture/tech-stack.md
+  - docs/architecture/source-tree.md
+
+# =============================================================================
+# DEPLOYMENT CONFIGURATION
+# All @devops agent tasks read from this section
+# Analyzed from existing workflows + user confirmation
+# =============================================================================
+deployment:
+  # Workflow type (detected or user-selected)
+  workflow: {{DEPLOYMENT_WORKFLOW}}
+
+  # Branch routing configuration (analyzed from existing PR patterns)
+  branches:
+    staging_targets:
+      - "feature/*"
+      - "fix/*"
+      - "docs/*"
+      - "chore/*"
+      - "refactor/*"
+      - "test/*"
+
+    production_targets:
+      - "hotfix/*"
+
+    # Detected branch names (may differ from defaults)
+    staging_branch: {{STAGING_BRANCH}}
+    production_branch: {{PRODUCTION_BRANCH}}
+    default_target: {{DEFAULT_TARGET}}
+
+  # Environment configuration (detected from existing deploy configs)
+  environments:
+    staging:
+      name: "{{STAGING_ENV_NAME}}"
+      branch: {{STAGING_BRANCH}}
+      auto_deploy: {{STAGING_AUTO_DEPLOY}}
+      platform: "{{DEPLOYMENT_PLATFORM}}"
+      url: "${STAGING_URL}"
+      promotion_message: "After validation, create PR to {{PRODUCTION_BRANCH}} for production"
+
+    production:
+      name: "{{PRODUCTION_ENV_NAME}}"
+      branch: {{PRODUCTION_BRANCH}}
+      auto_deploy: {{PRODUCTION_AUTO_DEPLOY}}
+      platform: "{{DEPLOYMENT_PLATFORM}}"
+      url: "${PRODUCTION_URL}"
+      promotion_message: "This is the final production deployment"
+
+  # Quality gates (detected from existing CI)
+  quality_gates:
+    lint: {{QUALITY_LINT}}
+    typecheck: {{QUALITY_TYPECHECK}}
+    tests: {{QUALITY_TESTS}}
+    security_scan: {{QUALITY_SECURITY}}
+    min_coverage: {{MIN_COVERAGE}}
+
+  # PR defaults
+  pr_defaults:
+    auto_assign_reviewers: {{AUTO_ASSIGN_REVIEWERS}}
+    draft_by_default: {{DRAFT_BY_DEFAULT}}
+    include_deployment_info: true
+
+# =============================================================================
+# EXISTING CONFIGURATION PRESERVATION
+# References to existing config files that should be respected
+# =============================================================================
+existing_configs:
+  # Linting/Formatting (don't override these)
+  eslint: {{ESLINT_CONFIG_PATH}}
+  prettier: {{PRETTIER_CONFIG_PATH}}
+  tsconfig: {{TSCONFIG_PATH}}
+  flake8: {{FLAKE8_CONFIG_PATH}}
+
+  # CI/CD (may need merge)
+  github_workflows: {{GITHUB_WORKFLOWS_PATH}}
+  gitlab_ci: {{GITLAB_CI_PATH}}
+
+  # Package management
+  package_json: {{PACKAGE_JSON_PATH}}
+  requirements_txt: {{REQUIREMENTS_PATH}}
+  go_mod: {{GO_MOD_PATH}}
+
+# =============================================================================
+# AGENT CONFIGURATION
+# =============================================================================
+agents:
+  dev:
+    auto_load_context: true
+    story_tracking: true
+    respect_existing_standards: true
+
+  qa:
+    run_on_pr: true
+    coverage_threshold: {{MIN_COVERAGE}}
+
+  devops:
+    auto_detect_workflow: true
+    merge_with_existing: {{MERGE_WORKFLOWS}}
+
+# =============================================================================
+# FEATURES
+# =============================================================================
+features:
+  documentation_integrity: true
+  source_tree_guardian: true
+  quality_metrics: true
+
+  documentation_integrity_options:
+    generate_source_tree: true
+    generate_coding_standards: true
+    generate_tech_stack: true
+    brownfield_analysis: true
+    gitignore_generation: true
+    merge_gitignore: true  # Merge with existing instead of replace
+
+# =============================================================================
+# MIGRATION NOTES
+# Auto-generated notes from brownfield analysis
+# =============================================================================
+migration_notes:
+  # Summary of what was detected vs generated
+  summary: "{{MIGRATION_SUMMARY}}"
+
+  # Items requiring manual review
+  manual_review_items: {{MANUAL_REVIEW_ITEMS_YAML}}
+
+  # Potential conflicts detected
+  conflicts: {{CONFLICTS_YAML}}
+
+  # Recommendations
+  recommendations: {{RECOMMENDATIONS_YAML}}
+
+# =============================================================================
+# CUSTOM CONFIGURATION
+# Project-specific settings
+# =============================================================================
+custom: {}

package/.aios-core/infrastructure/templates/core-config/core-config-greenfield.tmpl.yaml

@@ -0,0 +1,127 @@
+# AIOS Core Configuration
+# Generated by AIOS Documentation Integrity System
+# Mode: Greenfield (New Project)
+# Date: {{GENERATED_DATE}}
+
+# =============================================================================
+# PROJECT CONFIGURATION
+# =============================================================================
+project:
+  type: USER_PROJECT
+  mode: greenfield
+  name: "{{PROJECT_NAME}}"
+  created: "{{GENERATED_DATE}}"
+  version: "0.1.0"
+
+# =============================================================================
+# DEV CONTEXT LOADING
+# Files loaded automatically when @dev agent activates
+# =============================================================================
+devLoadAlwaysFiles:
+  - docs/architecture/coding-standards.md
+  - docs/architecture/tech-stack.md
+  - docs/architecture/source-tree.md
+
+# =============================================================================
+# DEPLOYMENT CONFIGURATION
+# All @devops agent tasks read from this section
+# See docs/guides/DEPLOYMENT-GUIDE.md for details
+# =============================================================================
+deployment:
+  # Workflow type: staging-first (with staging branch) or direct-to-main
+  workflow: {{DEPLOYMENT_WORKFLOW}}
+
+  # Branch routing configuration
+  branches:
+    # These branch patterns will target staging (if staging-first workflow)
+    staging_targets:
+      - "feature/*"
+      - "fix/*"
+      - "docs/*"
+      - "chore/*"
+      - "refactor/*"
+      - "test/*"
+
+    # These branch patterns will target production directly (emergency fixes)
+    production_targets:
+      - "hotfix/*"
+
+    # Branch names
+    staging_branch: {{STAGING_BRANCH}}
+    production_branch: {{PRODUCTION_BRANCH}}
+
+    # Default PR target for ambiguous cases
+    default_target: {{DEFAULT_TARGET}}
+
+  # Environment configuration
+  environments:
+    staging:
+      name: "{{STAGING_ENV_NAME}}"
+      branch: {{STAGING_BRANCH}}
+      auto_deploy: true
+      platform: "{{DEPLOYMENT_PLATFORM}}"
+      url: "${STAGING_URL}"
+      promotion_message: "After validation, create PR to {{PRODUCTION_BRANCH}} for production"
+
+    production:
+      name: "{{PRODUCTION_ENV_NAME}}"
+      branch: {{PRODUCTION_BRANCH}}
+      auto_deploy: true
+      platform: "{{DEPLOYMENT_PLATFORM}}"
+      url: "${PRODUCTION_URL}"
+      promotion_message: "This is the final production deployment"
+
+  # Quality gates for PRs
+  quality_gates:
+    lint: {{QUALITY_LINT}}
+    typecheck: {{QUALITY_TYPECHECK}}
+    tests: {{QUALITY_TESTS}}
+    security_scan: {{QUALITY_SECURITY}}
+    min_coverage: {{MIN_COVERAGE}}
+
+  # PR defaults
+  pr_defaults:
+    auto_assign_reviewers: false
+    draft_by_default: false
+    include_deployment_info: true
+    labels:
+      staging: ["staging", "needs-review"]
+      production: ["production", "promotion"]
+
+# =============================================================================
+# AGENT CONFIGURATION
+# Agent-specific settings
+# =============================================================================
+agents:
+  dev:
+    auto_load_context: true
+    story_tracking: true
+
+  qa:
+    run_on_pr: true
+    coverage_threshold: {{MIN_COVERAGE}}
+
+  devops:
+    auto_detect_workflow: true
+
+# =============================================================================
+# FEATURES
+# Feature flags for optional functionality
+# =============================================================================
+features:
+  documentation_integrity: true
+  source_tree_guardian: true
+  quality_metrics: true
+
+  documentation_integrity_options:
+    generate_source_tree: true
+    generate_coding_standards: true
+    generate_tech_stack: true
+    brownfield_analysis: false
+    gitignore_generation: true
+
+# =============================================================================
+# CUSTOM CONFIGURATION
+# Project-specific settings
+# =============================================================================
+custom: {}