aios-core 3.6.0 → 3.8.0

package/.aios-core/development/templates/service-template/jest.config.js

@@ -0,0 +1,89 @@
+/**
+ * Jest configuration for service testing.
+ * @type {import('jest').Config}
+ */
+module.exports = {
+  // Use ts-jest for TypeScript support
+  preset: 'ts-jest',
+
+  // Test environment
+  testEnvironment: 'node',
+
+  // Root directories for tests
+  roots: ['<rootDir>'],
+
+  // Test file patterns
+  testMatch: [
+    '**/__tests__/**/*.test.ts',
+    '**/__tests__/**/*.spec.ts',
+  ],
+
+  // TypeScript transformation
+  transform: {
+    '^.+\\.tsx?$': [
+      'ts-jest',
+      {
+        useESM: true,
+        tsconfig: {
+          module: 'ESNext',
+          moduleResolution: 'NodeNext',
+        },
+      },
+    ],
+  },
+
+  // Module file extensions
+  moduleFileExtensions: ['ts', 'tsx', 'js', 'jsx', 'json', 'node'],
+
+  // Coverage configuration
+  collectCoverageFrom: [
+    '**/*.ts',
+    '!**/*.d.ts',
+    '!**/__tests__/**',
+    '!**/node_modules/**',
+    '!**/dist/**',
+  ],
+
+  // Coverage thresholds (targeting >70%)
+  coverageThreshold: {
+    global: {
+      branches: 70,
+      functions: 70,
+      lines: 70,
+      statements: 70,
+    },
+  },
+
+  // Coverage reporters
+  coverageReporters: ['text', 'text-summary', 'lcov', 'html'],
+
+  // Coverage output directory
+  coverageDirectory: 'coverage',
+
+  // Clear mocks between tests
+  clearMocks: true,
+
+  // Verbose output
+  verbose: true,
+
+  // Test timeout (30 seconds)
+  testTimeout: 30000,
+
+  // Setup files
+  // setupFilesAfterEnv: ['<rootDir>/jest.setup.ts'],
+
+  // Module name mapper for path aliases
+  moduleNameMapper: {
+    '^@/(.*)$': '<rootDir>/$1',
+  },
+
+  // Ignore patterns
+  testPathIgnorePatterns: [
+    '/node_modules/',
+    '/dist/',
+  ],
+
+  // Global setup/teardown
+  // globalSetup: '<rootDir>/jest.global-setup.ts',
+  // globalTeardown: '<rootDir>/jest.global-teardown.ts',
+};

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

@@ -0,0 +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}}"
+  }
+}

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

@@ -0,0 +1,45 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "lib": ["ES2020"],
+    "outDir": "./dist",
+    "rootDir": "./",
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "strict": true,
+    "noImplicitAny": true,
+    "strictNullChecks": true,
+    "strictFunctionTypes": true,
+    "strictBindCallApply": true,
+    "strictPropertyInitialization": true,
+    "noImplicitThis": true,
+    "useUnknownInCatchVariables": true,
+    "alwaysStrict": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "exactOptionalPropertyTypes": false,
+    "noImplicitReturns": true,
+    "noFallthroughCasesInSwitch": true,
+    "noUncheckedIndexedAccess": true,
+    "noImplicitOverride": true,
+    "noPropertyAccessFromIndexSignature": false,
+    "esModuleInterop": true,
+    "forceConsistentCasingInFileNames": true,
+    "skipLibCheck": true,
+    "resolveJsonModule": true,
+    "isolatedModules": true
+  },
+  "include": [
+    "./**/*.ts"
+  ],
+  "exclude": [
+    "node_modules",
+    "dist",
+    "**/*.test.ts",
+    "**/*.spec.ts",
+    "__tests__"
+  ]
+}

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

@@ -0,0 +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}}

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

@@ -0,0 +1,69 @@
+# {{COMPONENTNAME}}
+
+> Agent definition for {{SQUADNAME}} squad
+> Created: {{CREATEDAT}}
+{{#IF STORYID}}
+> Story: {{STORYID}}
+{{/IF}}
+
+## Description
+
+{{DESCRIPTION}}
+
+## Configuration
+
+```yaml
+agent:
+  name: {{COMPONENTNAME}}
+  id: {{COMPONENTNAME}}
+  title: "{{COMPONENTNAME}} Agent"
+  icon: "{{ICON}}"
+  whenToUse: "Use this agent when {{USECASE}}"
+
+persona:
+  role: "Describe the agent's primary role and responsibilities"
+  style: "Communication style (e.g., systematic, empathetic, analytical)"
+  identity: "What makes this agent unique"
+  focus: "Primary focus areas"
+
+core_principles:
+  - "Principle 1: Define the first guiding principle"
+  - "Principle 2: Define the second guiding principle"
+  - "Principle 3: Define the third guiding principle"
+
+commands:
+  - name: help
+    visibility: [full, quick, key]
+    description: "Show all available commands"
+  - name: command-1
+    visibility: [full, quick]
+    description: "Description of command 1"
+  - name: exit
+    visibility: [full, quick, key]
+    description: "Exit agent mode"
+
+dependencies:
+  tasks: []
+  templates: []
+  checklists: []
+  tools: []
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `*help` | Show available commands |
+| `*exit` | Exit agent mode |
+
+## Collaboration
+
+**Works with:**
+- List other agents this agent collaborates with
+
+**Handoff points:**
+- When to hand off to other agents
+
+---
+
+*Agent created by squad-creator*

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

@@ -0,0 +1,82 @@
+# {{COMPONENTNAME}} Checklist
+
+> {{DESCRIPTION}}
+> Squad: {{SQUADNAME}}
+> Created: {{CREATEDAT}}
+{{#IF STORYID}}
+> Story: {{STORYID}}
+{{/IF}}
+
+---
+
+## Pre-Conditions
+
+Before starting, verify:
+
+- [ ] Pre-condition 1
+- [ ] Pre-condition 2
+- [ ] Pre-condition 3
+
+---
+
+## Checklist Items
+
+### Category 1: Setup
+
+| # | Item | Status | Notes |
+|---|------|--------|-------|
+| 1.1 | Item description | [ ] | |
+| 1.2 | Item description | [ ] | |
+| 1.3 | Item description | [ ] | |
+
+### Category 2: Implementation
+
+| # | Item | Status | Notes |
+|---|------|--------|-------|
+| 2.1 | Item description | [ ] | |
+| 2.2 | Item description | [ ] | |
+| 2.3 | Item description | [ ] | |
+
+### Category 3: Validation
+
+| # | Item | Status | Notes |
+|---|------|--------|-------|
+| 3.1 | Item description | [ ] | |
+| 3.2 | Item description | [ ] | |
+| 3.3 | Item description | [ ] | |
+
+---
+
+## Post-Conditions
+
+After completion, verify:
+
+- [ ] Post-condition 1
+- [ ] Post-condition 2
+- [ ] Post-condition 3
+
+---
+
+## Sign-off
+
+| Role | Name | Date | Signature |
+|------|------|------|-----------|
+| Creator | | | |
+| Reviewer | | | |
+| Approver | | | |
+
+---
+
+## Usage
+
+```bash
+# Use this checklist with:
+*checklist {{COMPONENTNAME}}
+
+# Or reference in tasks:
+checklist: {{COMPONENTNAME}}.md
+```
+
+---
+
+*Checklist created by squad-creator*

package/.aios-core/development/templates/squad/data-template.yaml

@@ -0,0 +1,105 @@
+# {{COMPONENTNAME}} Data
+#
+# {{DESCRIPTION}}
+#
+# Squad: {{SQUADNAME}}
+# Created: {{CREATEDAT}}
+# Story: {{STORYID}}
+
+name: {{COMPONENTNAME}}
+version: 1.0.0
+description: {{DESCRIPTION}}
+
+# Metadata
+metadata:
+  created: {{CREATEDAT}}
+  author: squad-creator
+  squad: {{SQUADNAME}}
+  tags:
+    - data
+    - {{SQUADNAME}}
+
+# Data schema definition
+schema:
+  type: object
+  required:
+    - id
+    - name
+  properties:
+    id:
+      type: string
+      description: "Unique identifier"
+      pattern: "^[a-z][a-z0-9-]*$"
+    name:
+      type: string
+      description: "Display name"
+      minLength: 1
+      maxLength: 100
+    description:
+      type: string
+      description: "Optional description"
+    enabled:
+      type: boolean
+      description: "Whether this entry is enabled"
+      default: true
+    priority:
+      type: integer
+      description: "Priority level (1-10)"
+      minimum: 1
+      maximum: 10
+      default: 5
+    metadata:
+      type: object
+      description: "Additional metadata"
+      additionalProperties: true
+
+# Default values for new entries
+defaults:
+  enabled: true
+  priority: 5
+  metadata: {}
+
+# Validation rules
+validation:
+  - rule: "id must be unique"
+    check: "unique(entries.id)"
+  - rule: "name must not be empty"
+    check: "length(name) > 0"
+
+# Data entries
+entries:
+  - id: example-1
+    name: "Example Entry 1"
+    description: "This is an example entry"
+    enabled: true
+    priority: 5
+    metadata:
+      category: example
+
+  - id: example-2
+    name: "Example Entry 2"
+    description: "Another example entry"
+    enabled: true
+    priority: 3
+    metadata:
+      category: example
+
+# Usage examples
+usage:
+  load: |
+    const yaml = require('js-yaml');
+    const fs = require('fs');
+    const data = yaml.load(fs.readFileSync('{{COMPONENTNAME}}.yaml', 'utf8'));
+    console.log(data.entries);
+
+  query: |
+    const activeEntries = data.entries.filter(e => e.enabled);
+    const highPriority = data.entries.filter(e => e.priority >= 7);
+
+  add_entry: |
+    data.entries.push({
+      id: 'new-entry',
+      name: 'New Entry',
+      enabled: true,
+      priority: 5,
+    });