sinapse-ai 9.3.0 → 9.5.0

package/.sinapse-ai/development/templates/service-template/package.json.hbs

@@ -1,88 +1,88 @@
-{
-  "name": "@sinapse/{{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": [
-    "sinapse",
-    "{{kebabCase serviceName}}",
-    "service"{{#if isApiIntegration}},
-    "api",
-    "integration"{{/if}}
-  ],
-  "author": "SINAPSE-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/sinapse-fullstack/{{kebabCase serviceName}}.git"
-  },
-  "bugs": {
-    "url": "https://github.com/sinapse-fullstack/{{kebabCase serviceName}}/issues"
-  },
-  "homepage": "https://github.com/sinapse-fullstack/{{kebabCase serviceName}}#readme",
-  "sinapse": {
-    "storyId": "{{storyId}}",
-    "type": "{{#if isApiIntegration}}api-integration{{else}}utility-service{{/if}}",
-    "generatedAt": "{{generatedAt}}"
-  }
-}
-
+{
+  "name": "@sinapse/{{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": [
+    "sinapse",
+    "{{kebabCase serviceName}}",
+    "service"{{#if isApiIntegration}},
+    "api",
+    "integration"{{/if}}
+  ],
+  "author": "SINAPSE-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/sinapse-fullstack/{{kebabCase serviceName}}.git"
+  },
+  "bugs": {
+    "url": "https://github.com/sinapse-fullstack/{{kebabCase serviceName}}/issues"
+  },
+  "homepage": "https://github.com/sinapse-fullstack/{{kebabCase serviceName}}#readme",
+  "sinapse": {
+    "storyId": "{{storyId}}",
+    "type": "{{#if isApiIntegration}}api-integration{{else}}utility-service{{/if}}",
+    "generatedAt": "{{generatedAt}}"
+  }
+}
+

package/.sinapse-ai/development/templates/service-template/types.ts.hbs

@@ -1,146 +1,146 @@
-/**
- * Type definitions for {{pascalCase serviceName}} service.
- * @module @sinapse/{{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 @sinapse/{{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/.sinapse-ai/development/templates/squad/agent-template.md

@@ -21,10 +21,23 @@ agent:
   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"
+  # 4-Layer Persona Design (research-backed)
+  layer_1_identity:
+    role: "Primary role and responsibilities"
+    archetype: "Domain archetype (e.g., The Strategist, The Builder)"
+    voice: "Tone and communication style"
+  layer_2_expertise:
+    domain: "Core domain expertise"
+    frameworks: "Key frameworks this agent uses"
+    tools: "Preferred tools and methods"
+  layer_3_behavior:
+    decision_style: "How this agent makes decisions"
+    collaboration: "How it works with other agents"
+    quality_bar: "What quality standard it enforces"
+  layer_4_boundaries:
+    can_do: "Operations this agent CAN perform"
+    cannot_do: "Operations delegated to other agents"
+    escalation: "When and to whom to escalate"
 
 core_principles:
   - "Principle 1: Define the first guiding principle"

package/.sinapse-ai/development/templates/squad/checklist-template.md

@@ -57,13 +57,21 @@ After completion, verify:
 
 ---
 
+## Scoring (research-backed)
+
+| Metric | Value |
+|--------|-------|
+| Total items | {{TOTAL}} |
+| Passed | {{PASSED}} |
+| Score | {{PASSED}}/{{TOTAL}} ({{PERCENTAGE}}%) |
+| Gate | PASS (>=80%) / CONCERNS (60-79%) / FAIL (<60%) |
+
 ## Sign-off
 
-| Role | Name | Date | Signature |
-|------|------|------|-----------|
-| Creator | | | |
-| Reviewer | | | |
-| Approver | | | |
+| Role | Name | Date | Verdict |
+|------|------|------|---------|
+| Executor | | | |
+| Reviewer | | | PASS / CONCERNS / FAIL |
 
 ---
 

package/.sinapse-ai/development/templates/squad/task-template.md

@@ -22,6 +22,13 @@ Checklist:
   - "[ ] Step 1: Describe first step"
   - "[ ] Step 2: Describe second step"
   - "[ ] Step 3: Describe third step"
+
+# Execution mode (research-backed, gap 4.1)
+# fast-track: trivial fixes < 50 lines, auto-validated story
+# standard: normal features, full SDC workflow
+# heavy: complex initiatives, spec pipeline first
+execution_mode: standard
+complexity_estimate: S|M|L|XL
 ---
 
 # {{COMPONENTNAME}}

package/.sinapse-ai/development/templates/squad/workflow-template.yaml

@@ -114,6 +114,12 @@ workflow:
       notify: true
       rollback: true
 
+  # Complexity-adaptive execution (research gap 4.1)
+  complexity:
+    class: STANDARD  # SIMPLE (3 phases) | STANDARD (all) | COMPLEX (+ revision)
+    estimated_tokens: null  # Filled at runtime
+    fast_track_eligible: false  # true for trivial fixes
+
   validation:
     pre_run:
       - "Check all required inputs are provided"
@@ -121,4 +127,5 @@ workflow:
     post_run:
       - "Verify output is valid"
       - "Log completion metrics"
+      - "Report DORA metrics (lead time, failure rate)"
 

package/.sinapse-ai/development/templates/squad-template/LICENSE

@@ -1,22 +1,22 @@
-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.
+