aios-core 4.1.0 → 4.2.0

package/.aios-core/development/tasks/validate-next-story.md

@@ -190,13 +190,24 @@ token_usage: ~3,000-10,000 tokens
 
 ```yaml
 story: N/A
-version: 1.0.0
+version: 2.0.0
 dependencies:
   - N/A
 tags:
   - automation
   - workflow
-updated_at: 2025-11-17
+  - self-healing
+  - auto-fix
+updated_at: 2026-02-15
+changelog:
+  - version: 2.0.0
+    date: 2026-02-15
+    author: "@po (Pax)"
+    change: "Added Step 12: Auto-Fix and Re-Validate loop — fixes template compliance, CodeRabbit, Dev Notes, Testing, Risks, and task AC mapping automatically"
+  - version: 1.0.0
+    date: 2025-11-17
+    author: "original"
+    change: "Initial validate-next-story task (report-only, no auto-fix)"
 ```
 
 ---
@@ -452,4 +463,90 @@ Provide a structured validation report including:
 - **NO-GO**: Story requires fixes before implementation
 - **Implementation Readiness Score**: 1-10 scale
 - **Confidence Level**: High/Medium/Low for successful implementation
+
+### 12. Auto-Fix and Re-Validate (Self-Healing Loop)
+
+**Purpose:** Automatically fix all fixable issues found during validation instead of just reporting them. This eliminates the manual round-trip of validate → report → fix → re-validate.
+
+**EXECUTION RULES:**
+
+```yaml
+auto_fix:
+  enabled: true
+  max_iterations: 2
+  fixable_categories:
+    - template_compliance    # Missing sections from story template
+    - executor_assignment    # Missing or incorrect executor/quality_gate fields
+    - story_format           # Missing "As a / I want / So that"
+    - coderabbit_section     # Missing or incomplete CodeRabbit Integration
+    - dev_notes              # Missing Dev Notes, Source Tree, Testing
+    - task_ac_mapping        # Tasks without AC references
+    - risks_section          # Missing Risks section
+    - placeholder_sections   # Missing Dev Agent Record, QA Results placeholders
+  non_fixable_categories:
+    - anti_hallucination     # Requires human verification
+    - business_logic         # Requires PO decision
+    - scope_changes          # Requires stakeholder approval
+```
+
+**SEQUENTIAL AUTO-FIX PROCEDURE:**
+
+1. **Classify issues** from Step 11 report:
+   - `FIXABLE`: Template compliance, missing sections, structural issues
+   - `NON-FIXABLE`: Business logic, scope, anti-hallucination findings
+
+2. **IF fixable issues exist AND iteration < max_iterations:**
+
+   a. **Template Compliance Fixes:**
+      - Missing Executor Assignment → Infer from story Agent field and Work Type mapping (Step 1.1 table)
+      - Missing Story format → Generate from Description section (extract role, action, benefit)
+      - Missing Dev Notes → Generate from Technical Notes, File List, and epic context
+      - Missing Testing section → Generate from Acceptance Criteria (derive test scenarios)
+      - Missing Risks section → Generate from Description and Scope (identify common risk patterns)
+      - Missing placeholder sections (Dev Agent Record, QA Results) → Add standard placeholders
+
+   b. **CodeRabbit Integration Fixes (if `coderabbit_integration.enabled: true`):**
+      - Missing section → Generate from story type analysis:
+        - Infer Primary Type from Description keywords
+        - Assign agents from Work Type mapping
+        - Add Quality Gate checkboxes (Pre-Commit always, Pre-PR if applicable)
+        - Add Self-Healing config based on primary agent
+        - Add Focus Areas based on story type
+
+   c. **Task Enhancement Fixes:**
+      - Missing AC references → Map tasks to ACs by content matching
+      - Missing subtasks → Break down vague tasks into specific subtasks
+      - Add edge case scenarios to ACs if obvious gaps found
+
+   d. **Nice-to-Have Improvements:**
+      - Add external dependency links (GitHub, npm) if referenced in Technical Notes
+      - Expand Scope IN/OUT if implicit from Description
+
+3. **Apply all fixes** to the story file using Edit tool
+
+4. **Re-validate** (run Steps 1-11 again on fixed story)
+
+5. **IF still NO-GO after max_iterations:**
+   - Report remaining NON-FIXABLE issues
+   - List what was auto-fixed vs what needs human decision
+   - HALT for user input
+
+6. **IF GO after fixes:**
+   - Update story Status from `Draft` to `Ready`
+   - Log transition in Change Log: `"Status: Draft → Ready (validation GO {score}/10, auto-fixed {N} issues)"`
+   - Report summary of all fixes applied
+
+**AUTO-FIX CHANGE LOG FORMAT:**
+```markdown
+| {date} | @po (Pax) | v{N} — Auto-fix: {comma-separated list of fixes applied} |
+| {date} | @po (Pax) | Status: Draft → Ready (validation GO {score}/10) |
+```
+
+**IMPORTANT CONSTRAINTS:**
+- NEVER change Acceptance Criteria content (only add missing edge cases as new ACs)
+- NEVER change Description or Problem/Solution
+- NEVER change Scope IN/OUT boundaries
+- NEVER change Points or Priority
+- NEVER invent technical details not present in epic/PRD context
+- All generated content MUST be traceable to existing story content or epic context
  

package/.aios-core/development/templates/service-template/README.md.hbs

@@ -1,158 +1,158 @@
-# {{pascalCase serviceName}} Service
-
-> {{description}}
-
-## Installation
-
-```bash
-npm install @aios/{{kebabCase serviceName}}
-```
-
-## Quick Start
-
-```typescript
-import { create{{pascalCase serviceName}}Service } from '@aios/{{kebabCase serviceName}}';
-
-const service = create{{pascalCase serviceName}}Service({
-{{#each envVars}}
-  {{camelCase this.name}}: process.env.{{this.name}},
-{{/each}}
-});
-
-// Use the service
-const result = await service.execute();
-```
-
-## Configuration
-
-### Environment Variables
-
-| Variable | Required | Description |
-|----------|----------|-------------|
-{{#each envVars}}
-| `{{this.name}}` | {{#if this.required}}Yes{{else}}No{{/if}} | {{this.description}} |
-{{/each}}
-
-### Programmatic Configuration
-
-```typescript
-import { create{{pascalCase serviceName}}Service, {{pascalCase serviceName}}Config } from '@aios/{{kebabCase serviceName}}';
-
-const config: {{pascalCase serviceName}}Config = {
-{{#each envVars}}
-  {{camelCase this.name}}: '{{this.example}}',
-{{/each}}
-};
-
-const service = create{{pascalCase serviceName}}Service(config);
-```
-
-{{#if isApiIntegration}}
-## API Integration
-
-This service integrates with an external API. Features include:
-
-- **Rate Limiting**: Automatic request throttling
-- **Retry Logic**: Exponential backoff on failures
-- **Error Handling**: Typed errors with actionable messages
-
-### Rate Limits
-
-> **Note:** The values below are placeholders. Update them according to your API's actual rate limits.
-
-| Tier | Requests/min | Burst |
-|------|--------------|-------|
-| Free | 60 | 10 |
-| Pro | 600 | 100 |
-
-{{/if}}
-## Usage Examples
-
-### Basic Usage
-
-```typescript
-const service = create{{pascalCase serviceName}}Service(config);
-
-try {
-  const result = await service.execute();
-  console.log('Success:', result);
-} catch (error) {
-  if (error instanceof {{pascalCase serviceName}}Error) {
-    console.error('Service error:', error.code, error.message);
-  }
-  throw error;
-}
-```
-
-{{#if hasAuth}}
-### Authentication
-
-This service requires authentication. Set your credentials via environment variables or config:
-
-```typescript
-const service = create{{pascalCase serviceName}}Service({
-  apiKey: process.env.{{upperCase serviceName}}_API_KEY,
-  // or
-  accessToken: process.env.{{upperCase serviceName}}_ACCESS_TOKEN,
-});
-```
-
-{{/if}}
-## Error Handling
-
-The service provides typed errors for common failure scenarios:
-
-```typescript
-import { {{pascalCase serviceName}}Error, {{pascalCase serviceName}}ErrorCode } from '@aios/{{kebabCase serviceName}}';
-
-try {
-  await service.execute();
-} catch (error) {
-  if (error instanceof {{pascalCase serviceName}}Error) {
-    switch (error.code) {
-      case {{pascalCase serviceName}}ErrorCode.CONFIGURATION_ERROR:
-        // Handle configuration issues
-        break;
-      case {{pascalCase serviceName}}ErrorCode.NETWORK_ERROR:
-        // Handle network issues
-        break;
-{{#if isApiIntegration}}
-      case {{pascalCase serviceName}}ErrorCode.RATE_LIMIT_EXCEEDED:
-        // Handle rate limiting
-        break;
-{{/if}}
-      default:
-        // Handle other errors
-    }
-  }
-}
-```
-
-## API Reference
-
-See the [TypeScript definitions](./dist/types.d.ts) for complete API documentation.
-
-## Development
-
-```bash
-# Install dependencies
-npm install
-
-# Run tests
-npm test
-
-# Build
-npm run build
-
-# Type check
-npm run typecheck
-```
-
-## License
-
-MIT
-
----
-
-*Generated by AIOS-FullStack Service Template*
-*Story: {{storyId}}*
+# {{pascalCase serviceName}} Service
+
+> {{description}}
+
+## Installation
+
+```bash
+npm install @aios/{{kebabCase serviceName}}
+```
+
+## Quick Start
+
+```typescript
+import { create{{pascalCase serviceName}}Service } from '@aios/{{kebabCase serviceName}}';
+
+const service = create{{pascalCase serviceName}}Service({
+{{#each envVars}}
+  {{camelCase this.name}}: process.env.{{this.name}},
+{{/each}}
+});
+
+// Use the service
+const result = await service.execute();
+```
+
+## Configuration
+
+### Environment Variables
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+{{#each envVars}}
+| `{{this.name}}` | {{#if this.required}}Yes{{else}}No{{/if}} | {{this.description}} |
+{{/each}}
+
+### Programmatic Configuration
+
+```typescript
+import { create{{pascalCase serviceName}}Service, {{pascalCase serviceName}}Config } from '@aios/{{kebabCase serviceName}}';
+
+const config: {{pascalCase serviceName}}Config = {
+{{#each envVars}}
+  {{camelCase this.name}}: '{{this.example}}',
+{{/each}}
+};
+
+const service = create{{pascalCase serviceName}}Service(config);
+```
+
+{{#if isApiIntegration}}
+## API Integration
+
+This service integrates with an external API. Features include:
+
+- **Rate Limiting**: Automatic request throttling
+- **Retry Logic**: Exponential backoff on failures
+- **Error Handling**: Typed errors with actionable messages
+
+### Rate Limits
+
+> **Note:** The values below are placeholders. Update them according to your API's actual rate limits.
+
+| Tier | Requests/min | Burst |
+|------|--------------|-------|
+| Free | 60 | 10 |
+| Pro | 600 | 100 |
+
+{{/if}}
+## Usage Examples
+
+### Basic Usage
+
+```typescript
+const service = create{{pascalCase serviceName}}Service(config);
+
+try {
+  const result = await service.execute();
+  console.log('Success:', result);
+} catch (error) {
+  if (error instanceof {{pascalCase serviceName}}Error) {
+    console.error('Service error:', error.code, error.message);
+  }
+  throw error;
+}
+```
+
+{{#if hasAuth}}
+### Authentication
+
+This service requires authentication. Set your credentials via environment variables or config:
+
+```typescript
+const service = create{{pascalCase serviceName}}Service({
+  apiKey: process.env.{{upperCase serviceName}}_API_KEY,
+  // or
+  accessToken: process.env.{{upperCase serviceName}}_ACCESS_TOKEN,
+});
+```
+
+{{/if}}
+## Error Handling
+
+The service provides typed errors for common failure scenarios:
+
+```typescript
+import { {{pascalCase serviceName}}Error, {{pascalCase serviceName}}ErrorCode } from '@aios/{{kebabCase serviceName}}';
+
+try {
+  await service.execute();
+} catch (error) {
+  if (error instanceof {{pascalCase serviceName}}Error) {
+    switch (error.code) {
+      case {{pascalCase serviceName}}ErrorCode.CONFIGURATION_ERROR:
+        // Handle configuration issues
+        break;
+      case {{pascalCase serviceName}}ErrorCode.NETWORK_ERROR:
+        // Handle network issues
+        break;
+{{#if isApiIntegration}}
+      case {{pascalCase serviceName}}ErrorCode.RATE_LIMIT_EXCEEDED:
+        // Handle rate limiting
+        break;
+{{/if}}
+      default:
+        // Handle other errors
+    }
+  }
+}
+```
+
+## API Reference
+
+See the [TypeScript definitions](./dist/types.d.ts) for complete API documentation.
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Run tests
+npm test
+
+# Build
+npm run build
+
+# Type check
+npm run typecheck
+```
+
+## License
+
+MIT
+
+---
+
+*Generated by AIOS-FullStack Service Template*
+*Story: {{storyId}}*