aios-core 4.2.15 → 4.4.0

package/.aios-core/development/templates/service-template/package.json.hbs

@@ -1,87 +1,87 @@
-{
-  "name": "@aios/{{kebabCase serviceName}}",
-  "version": "1.0.0",
-  "description": "{{description}}",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "type": "module",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js",
-      "require": "./dist/index.cjs"
-    },
-    "./types": {
-      "types": "./dist/types.d.ts",
-      "import": "./dist/types.js"
-    },
-    "./errors": {
-      "types": "./dist/errors.d.ts",
-      "import": "./dist/errors.js"
-    }{{#if isApiIntegration}},
-    "./client": {
-      "types": "./dist/client.d.ts",
-      "import": "./dist/client.js"
-    }{{/if}}
-  },
-  "files": [
-    "dist",
-    "README.md"
-  ],
-  "scripts": {
-    "build": "tsc",
-    "build:watch": "tsc --watch",
-    "clean": "rimraf dist coverage",
-    "test": "jest",
-    "test:watch": "jest --watch",
-    "test:coverage": "jest --coverage",
-    "typecheck": "tsc --noEmit",
-    "lint": "eslint . --ext .ts",
-    "lint:fix": "eslint . --ext .ts --fix",
-    "prepublishOnly": "npm run clean && npm run build && npm test"
-  },
-  "keywords": [
-    "aios",
-    "{{kebabCase serviceName}}",
-    "service"{{#if isApiIntegration}},
-    "api",
-    "integration"{{/if}}
-  ],
-  "author": "AIOS-FullStack",
-  "license": "MIT",
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "devDependencies": {
-    "@types/jest": "^29.5.12",
-    "@types/node": "^20.11.0",
-    "@typescript-eslint/eslint-plugin": "^6.19.0",
-    "@typescript-eslint/parser": "^6.19.0",
-    "eslint": "^8.56.0",
-    "jest": "^29.7.0",
-    "rimraf": "^5.0.5",
-    "ts-jest": "^29.1.2",
-    "typescript": "^5.3.3"
-  },
-  "peerDependencies": {
-    "typescript": ">=5.0.0"
-  },
-  "peerDependenciesMeta": {
-    "typescript": {
-      "optional": true
-    }
-  },
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/aios-fullstack/{{kebabCase serviceName}}.git"
-  },
-  "bugs": {
-    "url": "https://github.com/aios-fullstack/{{kebabCase serviceName}}/issues"
-  },
-  "homepage": "https://github.com/aios-fullstack/{{kebabCase serviceName}}#readme",
-  "aios": {
-    "storyId": "{{storyId}}",
-    "type": "{{#if isApiIntegration}}api-integration{{else}}utility-service{{/if}}",
-    "generatedAt": "{{generatedAt}}"
-  }
-}
+{
+  "name": "@aios/{{kebabCase serviceName}}",
+  "version": "1.0.0",
+  "description": "{{description}}",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./types": {
+      "types": "./dist/types.d.ts",
+      "import": "./dist/types.js"
+    },
+    "./errors": {
+      "types": "./dist/errors.d.ts",
+      "import": "./dist/errors.js"
+    }{{#if isApiIntegration}},
+    "./client": {
+      "types": "./dist/client.d.ts",
+      "import": "./dist/client.js"
+    }{{/if}}
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "build:watch": "tsc --watch",
+    "clean": "rimraf dist coverage",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint . --ext .ts",
+    "lint:fix": "eslint . --ext .ts --fix",
+    "prepublishOnly": "npm run clean && npm run build && npm test"
+  },
+  "keywords": [
+    "aios",
+    "{{kebabCase serviceName}}",
+    "service"{{#if isApiIntegration}},
+    "api",
+    "integration"{{/if}}
+  ],
+  "author": "AIOS-FullStack",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.12",
+    "@types/node": "^20.11.0",
+    "@typescript-eslint/eslint-plugin": "^6.19.0",
+    "@typescript-eslint/parser": "^6.19.0",
+    "eslint": "^8.56.0",
+    "jest": "^29.7.0",
+    "rimraf": "^5.0.5",
+    "ts-jest": "^29.1.2",
+    "typescript": "^5.3.3"
+  },
+  "peerDependencies": {
+    "typescript": ">=5.0.0"
+  },
+  "peerDependenciesMeta": {
+    "typescript": {
+      "optional": true
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/aios-fullstack/{{kebabCase serviceName}}.git"
+  },
+  "bugs": {
+    "url": "https://github.com/aios-fullstack/{{kebabCase serviceName}}/issues"
+  },
+  "homepage": "https://github.com/aios-fullstack/{{kebabCase serviceName}}#readme",
+  "aios": {
+    "storyId": "{{storyId}}",
+    "type": "{{#if isApiIntegration}}api-integration{{else}}utility-service{{/if}}",
+    "generatedAt": "{{generatedAt}}"
+  }
+}

package/.aios-core/development/templates/service-template/types.ts.hbs

@@ -1,145 +1,145 @@
-/**
- * Type definitions for {{pascalCase serviceName}} service.
- * @module @aios/{{kebabCase serviceName}}/types
- * @story {{storyId}}
- */
-
-/**
- * Configuration options for the {{pascalCase serviceName}} service.
- */
-export interface {{pascalCase serviceName}}Config {
-{{#each envVars}}
-  /**
-   * {{this.description}}
-   {{#if this.required}}
-   * @required
-   {{/if}}
-   */
-  {{camelCase this.name}}{{#unless this.required}}?{{/unless}}: string;
-
-{{/each}}
-{{#if isApiIntegration}}
-  /**
-   * Base URL for the API.
-   * @default '{{apiBaseUrl}}'
-   */
-  baseUrl?: string;
-
-  /**
-   * Request timeout in milliseconds.
-   * @default 30000
-   */
-  timeout?: number;
-
-  /**
-   * Maximum number of retry attempts.
-   * @default 3
-   */
-  maxRetries?: number;
-
-  /**
-   * Enable debug logging.
-   * @default false
-   */
-  debug?: boolean;
-
-{{/if}}
-}
-
-/**
- * The {{pascalCase serviceName}} service interface.
- */
-export interface {{pascalCase serviceName}}Service {
-  /**
-   * Execute the primary service operation.
-   */
-  execute(): Promise<void>;
-
-  /**
-   * Get the current configuration (without sensitive values).
-   */
-  getConfig(): Partial<{{pascalCase serviceName}}Config>;
-
-  /**
-   * Check if the service is properly configured and operational.
-   */
-  healthCheck(): Promise<boolean>;
-}
-
-{{#if isApiIntegration}}
-/**
- * Base API response structure.
- */
-export interface {{pascalCase serviceName}}ApiResponse<T = unknown> {
-  success: boolean;
-  data?: T;
-  error?: {
-    code: string;
-    message: string;
-    details?: Record<string, unknown>;
-  };
-  meta?: {
-    requestId?: string;
-    rateLimit?: {
-      remaining: number;
-      reset: number;
-    };
-  };
-}
-
-/**
- * Request options for API calls.
- */
-export interface {{pascalCase serviceName}}RequestOptions {
-  /**
-   * HTTP method.
-   */
-  method?: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
-
-  /**
-   * Request headers.
-   */
-  headers?: Record<string, string>;
-
-  /**
-   * Request body.
-   */
-  body?: unknown;
-
-  /**
-   * Query parameters.
-   */
-  params?: Record<string, string | number | boolean>;
-
-  /**
-   * Request timeout override.
-   */
-  timeout?: number;
-
-  /**
-   * Skip retry on failure.
-   */
-  noRetry?: boolean;
-}
-
-/**
- * Rate limit information.
- */
-export interface {{pascalCase serviceName}}RateLimit {
-  /**
-   * Maximum requests allowed.
-   */
-  limit: number;
-
-  /**
-   * Remaining requests in current window.
-   */
-  remaining: number;
-
-  /**
-   * Unix timestamp when the rate limit resets.
-   */
-  reset: number;
-}
-
-{{/if}}
+/**
+ * Type definitions for {{pascalCase serviceName}} service.
+ * @module @aios/{{kebabCase serviceName}}/types
+ * @story {{storyId}}
+ */
+
+/**
+ * Configuration options for the {{pascalCase serviceName}} service.
+ */
+export interface {{pascalCase serviceName}}Config {
+{{#each envVars}}
+  /**
+   * {{this.description}}
+   {{#if this.required}}
+   * @required
+   {{/if}}
+   */
+  {{camelCase this.name}}{{#unless this.required}}?{{/unless}}: string;
+
+{{/each}}
+{{#if isApiIntegration}}
+  /**
+   * Base URL for the API.
+   * @default '{{apiBaseUrl}}'
+   */
+  baseUrl?: string;
+
+  /**
+   * Request timeout in milliseconds.
+   * @default 30000
+   */
+  timeout?: number;
+
+  /**
+   * Maximum number of retry attempts.
+   * @default 3
+   */
+  maxRetries?: number;
+
+  /**
+   * Enable debug logging.
+   * @default false
+   */
+  debug?: boolean;
+
+{{/if}}
+}
+
+/**
+ * The {{pascalCase serviceName}} service interface.
+ */
+export interface {{pascalCase serviceName}}Service {
+  /**
+   * Execute the primary service operation.
+   */
+  execute(): Promise<void>;
+
+  /**
+   * Get the current configuration (without sensitive values).
+   */
+  getConfig(): Partial<{{pascalCase serviceName}}Config>;
+
+  /**
+   * Check if the service is properly configured and operational.
+   */
+  healthCheck(): Promise<boolean>;
+}
+
+{{#if isApiIntegration}}
+/**
+ * Base API response structure.
+ */
+export interface {{pascalCase serviceName}}ApiResponse<T = unknown> {
+  success: boolean;
+  data?: T;
+  error?: {
+    code: string;
+    message: string;
+    details?: Record<string, unknown>;
+  };
+  meta?: {
+    requestId?: string;
+    rateLimit?: {
+      remaining: number;
+      reset: number;
+    };
+  };
+}
+
+/**
+ * Request options for API calls.
+ */
+export interface {{pascalCase serviceName}}RequestOptions {
+  /**
+   * HTTP method.
+   */
+  method?: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+
+  /**
+   * Request headers.
+   */
+  headers?: Record<string, string>;
+
+  /**
+   * Request body.
+   */
+  body?: unknown;
+
+  /**
+   * Query parameters.
+   */
+  params?: Record<string, string | number | boolean>;
+
+  /**
+   * Request timeout override.
+   */
+  timeout?: number;
+
+  /**
+   * Skip retry on failure.
+   */
+  noRetry?: boolean;
+}
+
+/**
+ * Rate limit information.
+ */
+export interface {{pascalCase serviceName}}RateLimit {
+  /**
+   * Maximum requests allowed.
+   */
+  limit: number;
+
+  /**
+   * Remaining requests in current window.
+   */
+  remaining: number;
+
+  /**
+   * Unix timestamp when the rate limit resets.
+   */
+  reset: number;
+}
+
+{{/if}}

package/.aios-core/development/templates/squad/agent-template.md

@@ -64,6 +64,17 @@ dependencies:
 **Handoff points:**
 - When to hand off to other agents
 
+{{#IF CODE_INTEL_AVAILABLE}}
+## Code Intelligence Context
+
+> Auto-populated when code intelligence provider is available.
+> This section can be safely removed if not needed.
+
+- **Project Structure:** {{PROJECT_STRUCTURE}}
+- **Conventions:** {{CONVENTIONS}}
+- **Related Entities:** {{RELATED_ENTITIES}}
+{{/IF}}
+
 ---
 
 *Agent created by squad-creator*

package/.aios-core/development/templates/squad/task-template.md

@@ -49,6 +49,27 @@ pre-conditions:
     error_message: "Error message if pre-condition fails"
 ```
 
+{{#IF CODE_INTEL_AVAILABLE}}
+## Code Intelligence Duplicate Check
+
+> Auto-check when code intelligence provider is available.
+> This step is advisory only — it never blocks task creation.
+> This section can be safely removed if not needed.
+
+Before proceeding, verify no similar task already exists:
+
+```javascript
+const { checkDuplicateArtefact } = require('.aios-core/core/code-intel/helpers/creation-helper');
+const result = await checkDuplicateArtefact('{{COMPONENTNAME}}', '{{DESCRIPTION}}');
+if (result) {
+  console.warn(result.warning);
+  // Advisory: "Similar task exists: {task-name}. Consider extending instead of creating."
+}
+```
+
+- **Duplicates Found:** {{DUPLICATE_WARNING}}
+{{/IF}}
+
 ## Execution Steps
 
 ### Step 1: Initialize

package/.aios-core/development/templates/squad-template/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) {{year}} {{author}}
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) {{year}} {{author}}
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/.aios-core/docs/standards/AIOS-LIVRO-DE-OURO-V2.1-COMPLETE.md

@@ -703,7 +703,7 @@ $ aios workflow brownfield-integration --target=./existing-project
 ## Source Tree v4.2 (Current)
 
 ```
-@synkra/aios-core/                        # Root project
+aios-core/                        # Root project
 ├── .aios-core/                        # Framework layer
 │   ├── core/                          # Core module
 │   │   ├── config/                    # Configuration

package/.aios-core/docs/standards/AIOS-LIVRO-DE-OURO-V2.2-SUMMARY.md

@@ -795,7 +795,7 @@ Features:
 ### Complete Project Structure
 
 ```
-@synkra/aios-core/                        # Root project
+aios-core/                        # Root project
 ├── .aios-core/                        # Modular Architecture
 │   │
 │   ├── core/                          # Core Framework Module

package/.aios-core/framework-config.yaml

@@ -148,3 +148,11 @@ ide_sync_system:
     strict_mode: true
     fail_on_drift: true
     fail_on_orphaned: false
+
+# --- Template Override Defaults (Section 13) ---
+# Override in project-config.yaml to customize story template rendering.
+# null = use template default order; [] = no optional sections.
+template_overrides:
+  story:
+    sections_order: null
+    optional_sections: []

package/.aios-core/index.esm.js

@@ -1,4 +1,4 @@
-// @synkra/aios-core/core - ES Module Entry Point
+// aios-core/core - ES Module Entry Point
 import MetaAgent from './infrastructure/scripts/component-generator.js';
 import TaskManager from './infrastructure/scripts/batch-creator.js';
 import ElicitationEngine from './core/elicitation/elicitation-engine.js';

package/.aios-core/index.js

@@ -1,4 +1,4 @@
-// @synkra/aios-core/core - CommonJS Entry Point
+// aios-core/core - CommonJS Entry Point
 const MetaAgent = require('./infrastructure/scripts/component-generator.js');
 const TaskManager = require('./infrastructure/scripts/batch-creator.js');
 const ElicitationEngine = require('./core/elicitation/elicitation-engine.js');

package/.aios-core/infrastructure/integrations/ai-providers/index.js

@@ -3,7 +3,7 @@
  *
  * Exports all AI provider classes and factory functions.
  *
- * @module @synkra/aios-core/infrastructure/integrations/ai-providers
+ * @module aios-core/infrastructure/integrations/ai-providers
  * @see Epic GEMINI-INT - Story 2: AI Provider Factory Pattern
  */
 

package/.aios-core/infrastructure/schemas/task-v3-schema.json

@@ -28,6 +28,12 @@
       "default": false,
       "description": "Whether task requires user interaction"
     },
+    "execution_mode": {
+      "type": "string",
+      "enum": ["direct", "programmatic"],
+      "default": "direct",
+      "description": "Execution mode: 'direct' (standard tool calls) or 'programmatic' (PTC/batch — consolidate N tool calls into single Bash block, per ADR-3 native tools only). Tasks without this field default to 'direct' (backward compatible)."
+    },
     "inputs": {
       "type": "object",
       "description": "Required inputs for task execution",