aios-core 2.1.6 → 2.2.1

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/github-workflows/README.md

@@ -1,109 +1,109 @@
-# GitHub Workflows Templates
-
-Templates for GitHub Actions workflows, used by the `*setup-github` task to configure DevOps infrastructure for user projects.
-
-## Available Templates
-
-### ci.yml.template
-
-Basic CI workflow for pull requests and pushes:
-
-- **lint** - ESLint validation
-- **typecheck** - TypeScript type checking
-- **test** - Jest/Vitest tests with coverage
-- **build** - Production build validation
-
-### pr-automation.yml.template
-
-Enhanced PR validation workflow:
-
-- All basic CI checks
-- Coverage report as PR comment
-- Quality gate summary comment
-- CodeRabbit integration status
-
-### release.yml.template
-
-Release automation workflow:
-
-- Triggered on version tags (v*)
-- Automatic changelog generation
-- GitHub Release creation
-- Asset upload (tar.gz distribution)
-
-## Template Variables
-
-Variables are replaced during installation by the `*setup-github` task:
-
-| Variable | Description | Default |
-|----------|-------------|---------|
-| `{{NODE_VERSION}}` | Node.js version | `20` |
-| `{{PYTHON_VERSION}}` | Python version | `3.11` |
-| `{{PROJECT_NAME}}` | Project name | From package.json |
-| `{{LINT_COMMAND}}` | Lint command | `npm run lint` |
-| `{{TEST_COMMAND}}` | Test command | `npm run test:coverage` |
-| `{{TYPECHECK_COMMAND}}` | TypeCheck command | `npm run typecheck` |
-| `{{BUILD_COMMAND}}` | Build command | `npm run build` |
-
-## Usage
-
-These templates are used automatically by the `*setup-github` task:
-
-```bash
-@devops *setup-github
-```
-
-Or manually copy and customize:
-
-```bash
-# Copy template
-cp .aios-core/infrastructure/templates/github-workflows/ci.yml.template .github/workflows/ci.yml
-
-# Replace variables
-sed -i 's/{{NODE_VERSION}}/20/g' .github/workflows/ci.yml
-sed -i 's/{{LINT_COMMAND}}/npm run lint/g' .github/workflows/ci.yml
-# ... etc
-```
-
-## Customization
-
-### Adding New Jobs
-
-Add new jobs to the workflow after the basic checks:
-
-```yaml
-custom-check:
-  name: Custom Check
-  runs-on: ubuntu-latest
-  needs: [lint, typecheck]
-  steps:
-    - uses: actions/checkout@v4
-    - run: echo "Custom validation"
-```
-
-### Different Languages
-
-For Python projects, use `setup-python@v5`:
-
-```yaml
-- name: Setup Python
-  uses: actions/setup-python@v5
-  with:
-    python-version: ${{ env.PYTHON_VERSION }}
-    cache: 'pip'
-```
-
-For Go projects, use `setup-go@v5`:
-
-```yaml
-- name: Setup Go
-  uses: actions/setup-go@v5
-  with:
-    go-version: '1.21'
-```
-
-## Related
-
-- [Story 5.10 - GitHub DevOps Setup](../../../docs/stories/v2.1/sprint-5/story-5.10-github-devops-user-projects.md)
-- [setup-github task](../../development/tasks/setup-github.md)
-- [GitHub Actions Documentation](https://docs.github.com/en/actions)
+# GitHub Workflows Templates
+
+Templates for GitHub Actions workflows, used by the `*setup-github` task to configure DevOps infrastructure for user projects.
+
+## Available Templates
+
+### ci.yml.template
+
+Basic CI workflow for pull requests and pushes:
+
+- **lint** - ESLint validation
+- **typecheck** - TypeScript type checking
+- **test** - Jest/Vitest tests with coverage
+- **build** - Production build validation
+
+### pr-automation.yml.template
+
+Enhanced PR validation workflow:
+
+- All basic CI checks
+- Coverage report as PR comment
+- Quality gate summary comment
+- CodeRabbit integration status
+
+### release.yml.template
+
+Release automation workflow:
+
+- Triggered on version tags (v*)
+- Automatic changelog generation
+- GitHub Release creation
+- Asset upload (tar.gz distribution)
+
+## Template Variables
+
+Variables are replaced during installation by the `*setup-github` task:
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `{{NODE_VERSION}}` | Node.js version | `20` |
+| `{{PYTHON_VERSION}}` | Python version | `3.11` |
+| `{{PROJECT_NAME}}` | Project name | From package.json |
+| `{{LINT_COMMAND}}` | Lint command | `npm run lint` |
+| `{{TEST_COMMAND}}` | Test command | `npm run test:coverage` |
+| `{{TYPECHECK_COMMAND}}` | TypeCheck command | `npm run typecheck` |
+| `{{BUILD_COMMAND}}` | Build command | `npm run build` |
+
+## Usage
+
+These templates are used automatically by the `*setup-github` task:
+
+```bash
+@devops *setup-github
+```
+
+Or manually copy and customize:
+
+```bash
+# Copy template
+cp .aios-core/infrastructure/templates/github-workflows/ci.yml.template .github/workflows/ci.yml
+
+# Replace variables
+sed -i 's/{{NODE_VERSION}}/20/g' .github/workflows/ci.yml
+sed -i 's/{{LINT_COMMAND}}/npm run lint/g' .github/workflows/ci.yml
+# ... etc
+```
+
+## Customization
+
+### Adding New Jobs
+
+Add new jobs to the workflow after the basic checks:
+
+```yaml
+custom-check:
+  name: Custom Check
+  runs-on: ubuntu-latest
+  needs: [lint, typecheck]
+  steps:
+    - uses: actions/checkout@v4
+    - run: echo "Custom validation"
+```
+
+### Different Languages
+
+For Python projects, use `setup-python@v5`:
+
+```yaml
+- name: Setup Python
+  uses: actions/setup-python@v5
+  with:
+    python-version: ${{ env.PYTHON_VERSION }}
+    cache: 'pip'
+```
+
+For Go projects, use `setup-go@v5`:
+
+```yaml
+- name: Setup Go
+  uses: actions/setup-go@v5
+  with:
+    go-version: '1.21'
+```
+
+## Related
+
+- [Story 5.10 - GitHub DevOps Setup](../../../docs/stories/v2.1/sprint-5/story-5.10-github-devops-user-projects.md)
+- [setup-github task](../../development/tasks/setup-github.md)
+- [GitHub Actions Documentation](https://docs.github.com/en/actions)