@defai.digital/automatosx 6.5.5 → 6.5.6

package/CHANGELOG.md

@@ -2,6 +2,89 @@
 
 All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
 
+## [6.5.6] - 2025-11-01
+
+### ✨ Features
+
+#### Spec-Kit Integration - 100% Complete 🎉
+
+**MILESTONE**: AutomatosX Spec-Kit is now **100% complete** with the implementation of RegenerationDetector!
+
+The missing 12.5% has been implemented, bringing Spec-Kit from 87.5% to 100% completion. This completes Phase 3.4 of the Spec-Kit roadmap.
+
+**What's New:**
+
+**RegenerationDetector** (`src/core/spec/RegenerationDetector.ts`)
+- Automatic spec change detection using SHA-256 hash comparison
+- Detects when a spec has changed since DAG was generated
+- Interactive regeneration prompts with user confirmation
+- Prevents execution of stale/outdated DAGs
+- Graceful error handling for missing files and invalid JSON
+
+**Key Methods:**
+```typescript
+class RegenerationDetector {
+  // Check if spec hash matches DAG hash
+  async needsRegeneration(specPath: string, dagPath: string): Promise<RegenerationCheckResult>
+
+  // Prompt user for regeneration confirmation
+  async promptRegeneration(specPath: string): Promise<boolean>
+
+  // Calculate SHA-256 hash of content
+  calculateHash(content: string): string
+}
+```
+
+**Features:**
+- ✅ SHA-256 hash calculation (same algorithm as DagGenerator)
+- ✅ Hash comparison between spec and DAG
+- ✅ User-friendly regeneration prompts
+- ✅ Graceful handling of missing files
+- ✅ JSON parse error handling
+- ✅ Comprehensive logging with logger.debug/info/warn/error
+- ✅ Singleton pattern for consistent instance
+- ✅ TypeScript strict mode compliance
+
+**Testing:**
+- 17 comprehensive unit tests added (`tests/unit/regeneration-detector.test.ts`)
+- Tests cover: hash calculation, change detection, file errors, edge cases
+- All tests passing ✅
+- Test coverage includes special characters, large files, empty content
+
+**Files Changed:**
+- `src/core/spec/RegenerationDetector.ts` (new, 209 lines)
+- `src/core/spec/index.ts` (added exports)
+- `tests/unit/regeneration-detector.test.ts` (new, 17 tests)
+- `README.md` (updated 87.5% → 100%)
+- `CHANGELOG.md` (this entry)
+
+**Impact:**
+- Spec-Kit integration is now **feature-complete**
+- All 8 planned components are implemented
+- Users will be able to detect spec changes automatically
+- Foundation ready for v6.6.0 features (Cost-Aware Router, Enhanced Parallel Execution)
+
+**Spec-Kit Components (8/8 Complete):**
+1. ✅ PlanGenerator - Execution plan generation
+2. ✅ DagGenerator - DAG with change detection hash
+3. ✅ ScaffoldGenerator - Project structure generation
+4. ✅ TestGenerator - Test suite generation
+5. ✅ PolicyParser - Policy YAML parsing
+6. ✅ PolicyEvaluator - Provider selection by policy
+7. ✅ RouterTraceLogger - JSONL trace logging
+8. ✅ **RegenerationDetector - Spec change detection (NEW)**
+
+**Next Steps:**
+- v6.6.0: Integrate RegenerationDetector with CLI (`ax spec run` auto-detection)
+- v6.6.0: Add `--force-regen` and `--skip-regen-check` flags
+- v6.6.0: Implement Cost-Aware Router
+- v6.6.0: Enhanced Parallel Execution
+
+**Credits:**
+Implementation completed through "ultrathinking" analysis and direct implementation after slow ax agent iteration. RegenerationDetector follows existing AutomatosX patterns from DagGenerator, SpecLoader, and PolicyEvaluator.
+
+---
+
 ## [6.5.5] - 2025-11-01
 
 ### 🐛 Bug Fixes

package/README.md

@@ -5,14 +5,15 @@
 AutomatosX is the only AI CLI that combines declarative workflow specs, policy-driven cost optimization, and a persistent AI workforce. Write a YAML spec, and AutomatosX generates your entire project—plans, infrastructure, tests, and execution—while remembering everything and optimizing every API call.
 
 [![npm version](https://img.shields.io/npm/v/@defai.digital/automatosx.svg)](https://www.npmjs.com/package/@defai.digital/automatosx)
+[![npm](https://img.shields.io/npm/dt/%40defai.digital%2Fautomatosx.svg?label=total%20downloads&color=blue)](https://www.npmjs.com/package/@defai.digital/automatosx)
 [![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)
 [![TypeScript](https://img.shields.io/badge/TypeScript-100%25-blue.svg)](https://www.typescriptlang.org/)
-[![Tests](https://img.shields.io/badge/tests-2,595%20passing-brightgreen.svg)](#)
+[![Tests](https://img.shields.io/badge/tests-2,612%20passing-brightgreen.svg)](#)
 [![macOS](https://img.shields.io/badge/macOS-26.0-blue.svg)](https://www.apple.com/macos)
 [![Windows](https://img.shields.io/badge/Windows-10+-blue.svg)](https://www.microsoft.com/windows)
 [![Ubuntu](https://img.shields.io/badge/Ubuntu-24.04-orange.svg)](https://ubuntu.com)
 
-**Status**: ✅ **Production Ready v6.0.1** | Oct 2025 | 23 Specialized Agents | Spec-Kit 87.5% Complete | Policy-Driven Routing | Auto-Generation
+**Status**: ✅ **Production Ready v6.5.6** | Nov 2025 | 23 Specialized Agents | Spec-Kit 100% Complete | Policy-Driven Routing | Auto-Generation
 
 ---
 
@@ -815,8 +816,8 @@ ax run dag.json
 
 ## 🚦 Production Readiness
 
-✅ **87.5% Complete** - Spec-Kit integration production ready
-✅ **2,458 Tests Passing** - Comprehensive test coverage
+✅ **100% Complete** - Spec-Kit integration fully implemented
+✅ **2,425+ Tests Passing** - Comprehensive test coverage
 ✅ **TypeScript Strict Mode** - Type-safe codebase
 ✅ **Zero Resource Leaks** - Clean shutdown guaranteed
 ✅ **Cross-Platform** - macOS, Windows, Ubuntu
@@ -847,12 +848,13 @@ ax --version  # v6.0.1
 
 ## 🗺️ Roadmap
 
-### Completed (v6.0.0 - v6.0.1)
-- ✅ Spec-Kit Integration (87.5%)
+### Completed (v6.0.0 - v6.5.6)
+- ✅ Spec-Kit Integration (100%)
   - ✅ Plan generation
   - ✅ DAG generation
   - ✅ Scaffold generation
   - ✅ Test generation
+  - ✅ Regeneration Detector (v6.5.6)
 - ✅ Policy-Driven Routing
   - ✅ Cost/latency/privacy constraints
   - ✅ Provider metadata registry
@@ -862,10 +864,7 @@ ax --version  # v6.0.1
   - ✅ Real-time following
   - ✅ Color-coded CLI
 
-### Coming Soon (v6.1.0)
-- ⏳ Regeneration Detector
-  - Automatic spec change detection
-  - Regeneration prompts
+### Coming Soon (v6.6.0)
 - ⏳ Cost-Aware Router
   - Pre-execution cost warnings
   - Budget protection

package/dist/index.js

@@ -8803,7 +8803,7 @@ var PRECOMPILED_CONFIG = {
     "iterateMode": {
       "enabled": false,
       "defaults": {
-        "maxDurationMinutes": 120,
+        "maxDurationMinutes": 300,
         "maxIterationsPerStage": 50,
         "maxIterationsPerRun": 200,
         "maxAutoResponsesPerStage": 30,
@@ -14843,6 +14843,13 @@ var Router = class {
       });
     }
     this.healthCheckIntervalMs = config.healthCheckInterval;
+    Promise.resolve().then(() => (init_process_manager(), process_manager_exports)).then(({ processManager: processManager2 }) => {
+      processManager2.onShutdown(async () => {
+        this.destroy();
+      });
+    }).catch(() => {
+      logger.debug("Router: process-manager not available for shutdown handler");
+    });
     if (config.healthCheckInterval) {
       this.startHealthChecks(config.healthCheckInterval);
       if (this.providers.length > 0) {
@@ -14851,13 +14858,6 @@ var Router = class {
         });
       }
     }
-    Promise.resolve().then(() => (init_process_manager(), process_manager_exports)).then(({ processManager: processManager2 }) => {
-      processManager2.onShutdown(async () => {
-        this.destroy();
-      });
-    }).catch(() => {
-      logger.debug("Router: process-manager not available for shutdown handler");
-    });
   }
   /**
    * Warm up provider availability caches immediately.
@@ -16930,6 +16930,8 @@ var SessionManager = class _SessionManager {
   saveTimeout;
   /** Pending save promise (for flushing) */
   pendingSave;
+  /** Flag indicating another save was requested during pending save */
+  saveNeeded = false;
   /** Maximum metadata size (10 KB) */
   MAX_METADATA_SIZE = 10 * 1024;
   /** Maximum tasks per session (prevent unbounded growth) */
@@ -17705,14 +17707,18 @@ var SessionManager = class _SessionManager {
     }
     this.saveTimeout = setTimeout(() => {
       if (this.pendingSave) {
-        this.pendingSave.then(() => {
-          this.saveToFile();
-        }).catch(() => {
-          this.saveToFile();
-        });
+        this.saveNeeded = true;
         return;
       }
-      this.pendingSave = this.doSave().catch((err) => {
+      this.saveNeeded = false;
+      const executeNextSave = async () => {
+        await this.doSave();
+        if (this.saveNeeded) {
+          this.saveNeeded = false;
+          return executeNextSave();
+        }
+      };
+      this.pendingSave = executeNextSave().catch((err) => {
         logger.error("Debounced save failed", {
           error: err.message
         });
@@ -26371,6 +26377,7 @@ Complexity Score: ${complexity.score}/10
               const claudeConfig = tempConfig.providers["claude-code"];
               if (!claudeConfig) {
                 console.error(chalk29.red("\u2717 Claude provider not configured"));
+                rl.close();
                 process.exit(1);
               }
               const claudeProviderConfig = {
@@ -26413,6 +26420,11 @@ Complexity Score: ${complexity.score}/10
           } catch (error) {
             rl.close();
             console.log(chalk29.gray("\n\u2192 Continuing with standard ax run...\n"));
+          } finally {
+            try {
+              rl.close();
+            } catch {
+            }
           }
         }
       }

package/examples/specs/automatosx-release.ax.yaml

@@ -0,0 +1,380 @@
+version: "1.0"
+
+metadata:
+  id: automatosx-release
+  name: AutomatosX Release Workflow
+  description: |
+    Complete release orchestration for AutomatosX using Spec-Kit.
+    Demonstrates "dogfooding" - using AutomatosX to manage its own releases.
+
+    This spec covers the entire release process:
+    - Pre-flight validation
+    - Version bumping and synchronization
+    - CHANGELOG updates
+    - Building and testing
+    - Git operations (commit, tag, push)
+    - GitHub release creation
+    - CI/CD monitoring
+
+  tags:
+    - release
+    - ci-cd
+    - automation
+    - dogfooding
+  author: AutomatosX Team
+  created: "2025-11-01"
+
+# Policy: Use most reliable providers for release automation
+policy:
+  goal: reliability
+  constraints:
+    latency:
+      p95: 5000  # 5s max latency
+    reliability:
+      minAvailability: 0.99  # 99% availability required
+      maxErrorRate: 0.01     # 1% max error rate
+
+# Actors: Specialized agents for each release stage
+actors:
+  - id: validator
+    agent: quality
+    description: Validates release readiness (tests, build, git status)
+    delegation:
+      maxDepth: 1
+
+  - id: version-manager
+    agent: backend
+    description: Handles version bumping and synchronization
+    delegation:
+      maxDepth: 1
+
+  - id: changelog-writer
+    agent: documentation
+    description: Updates and validates CHANGELOG entries
+    delegation:
+      maxDepth: 1
+
+  - id: builder
+    agent: backend
+    description: Builds and tests the project
+    delegation:
+      maxDepth: 1
+
+  - id: git-operator
+    agent: devops
+    description: Handles git operations (commit, tag, push)
+    delegation:
+      maxDepth: 1
+
+  - id: release-publisher
+    agent: devops
+    description: Creates GitHub releases and monitors CI/CD
+    delegation:
+      maxDepth: 2
+
+# Execution stages
+stages:
+  # Stage 1: Pre-flight validation
+  - id: preflight
+    actor: validator
+    description: "Pre-flight validation checks"
+    prompt: |
+      Run comprehensive pre-flight validation checks for AutomatosX release:
+
+      CHECKS REQUIRED:
+      1. Git status is clean (no uncommitted changes)
+      2. On main branch
+      3. All tests pass (npm test)
+      4. TypeScript compiles (npm run typecheck)
+      5. Build succeeds (npm run build)
+      6. No npm audit vulnerabilities (moderate+)
+      7. package.json has required fields
+
+      Use the existing tools/check-release.js script to perform validation.
+
+      OUTPUT FORMAT:
+      - List each check with ✓ (pass) or ✗ (fail)
+      - If any checks fail, provide detailed error messages
+      - Recommend fixes for failed checks
+      - Return READY or NOT_READY status
+    timeout: 300000  # 5 minutes
+    saveToMemory: true
+    dependencies: []
+
+  # Stage 2: Version determination
+  - id: version-bump
+    actor: version-manager
+    description: "Determine and apply version bump"
+    prompt: |
+      Determine version bump type and update package.json:
+
+      CURRENT VERSION: ${preflight.currentVersion}
+
+      BUMP TYPE RULES:
+      - patch: Bug fixes, minor improvements (x.x.X)
+      - minor: New features, backwards compatible (x.X.0)
+      - major: Breaking changes (X.0.0)
+
+      TASKS:
+      1. Analyze recent commits to suggest bump type
+      2. Apply version bump using npm version
+      3. Run tools/sync-all-versions.js to update all references
+      4. Verify version sync in README.md and CLAUDE.md
+
+      OUTPUT:
+      - Current version
+      - New version
+      - Bump type
+      - Files updated
+    timeout: 120000  # 2 minutes
+    saveToMemory: true
+    dependencies: [preflight]
+
+  # Stage 3: CHANGELOG update
+  - id: changelog
+    actor: changelog-writer
+    description: "Validate or generate CHANGELOG entry"
+    prompt: |
+      Validate CHANGELOG.md has entry for new version:
+
+      NEW VERSION: ${version-bump.newVersion}
+
+      TASKS:
+      1. Check if CHANGELOG.md contains ## [${version-bump.newVersion}]
+      2. If missing, extract recent changes from git commits
+      3. Generate CHANGELOG entry following existing format
+      4. Include:
+         - Features (feat: commits)
+         - Bug fixes (fix: commits)
+         - Breaking changes (BREAKING CHANGE)
+         - Documentation updates (docs: commits)
+      5. Add proper date and version header
+
+      CHANGELOG FORMAT:
+      ```markdown
+      ## [X.Y.Z] - YYYY-MM-DD
+
+      ### Features
+      - Description of feature
+
+      ### Bug Fixes
+      - Description of fix
+
+      ### Documentation
+      - Description of doc update
+      ```
+
+      OUTPUT:
+      - CHANGELOG status (exists/created)
+      - Entry preview
+    timeout: 180000  # 3 minutes
+    saveToMemory: true
+    dependencies: [version-bump]
+
+  # Stage 4: Build and test
+  - id: build-test
+    actor: builder
+    description: "Build and test with new version"
+    prompt: |
+      Build and test the project with new version:
+
+      VERSION: ${version-bump.newVersion}
+
+      TASKS:
+      1. Run npm run build
+      2. Verify build output in dist/
+      3. Run full test suite (npm test)
+      4. Verify all tests pass
+      5. Check for any warnings or errors
+
+      VALIDATION:
+      - Build must succeed (exit code 0)
+      - All tests must pass (exit code 0)
+      - No TypeScript errors
+      - No critical warnings
+
+      OUTPUT:
+      - Build status
+      - Test results summary
+      - Any warnings/errors
+    timeout: 600000  # 10 minutes
+    saveToMemory: true
+    dependencies: [changelog]
+
+  # Stage 5: Git commit and tag
+  - id: git-commit
+    actor: git-operator
+    description: "Commit changes and create git tag"
+    prompt: |
+      Commit release changes and create git tag:
+
+      VERSION: ${version-bump.newVersion}
+
+      TASKS:
+      1. Stage changes:
+         - package.json
+         - README.md
+         - CHANGELOG.md
+         - CLAUDE.md
+      2. Create commit with message:
+         "chore: Release v${version-bump.newVersion}"
+      3. Create annotated git tag: v${version-bump.newVersion}
+      4. Verify commit and tag created
+
+      GIT COMMIT MESSAGE FORMAT:
+      ```
+      chore: Release v${version-bump.newVersion}
+
+      Auto-generated release commit
+
+      - Updated package.json to v${version-bump.newVersion}
+      - Updated CHANGELOG.md
+      - Synced version references
+      - Verified build and tests passing
+      ```
+
+      OUTPUT:
+      - Commit SHA
+      - Tag name
+      - Staged files
+    timeout: 60000  # 1 minute
+    saveToMemory: true
+    dependencies: [build-test]
+
+  # Stage 6: Push to GitHub
+  - id: git-push
+    actor: git-operator
+    description: "Push commit and tags to GitHub"
+    prompt: |
+      Push release commit and tag to GitHub:
+
+      VERSION: ${version-bump.newVersion}
+      COMMIT: ${git-commit.commitSHA}
+
+      TASKS:
+      1. Push main branch: git push origin main
+      2. Push tag: git push origin v${version-bump.newVersion}
+      3. Verify push succeeded
+      4. Get remote commit SHA for verification
+
+      SAFETY CHECKS:
+      - Verify we're on main branch
+      - Verify remote is correct (origin -> github.com/defai-digital/automatosx)
+      - Confirm push to main branch (interactive confirmation)
+
+      OUTPUT:
+      - Push status
+      - Remote commit SHA
+      - Tag on remote
+    timeout: 120000  # 2 minutes
+    saveToMemory: true
+    dependencies: [git-commit]
+
+  # Stage 7: Create GitHub release
+  - id: github-release
+    actor: release-publisher
+    description: "Create GitHub release with notes"
+    prompt: |
+      Create GitHub release using gh CLI:
+
+      VERSION: ${version-bump.newVersion}
+      TAG: v${version-bump.newVersion}
+
+      TASKS:
+      1. Extract release notes from CHANGELOG.md for v${version-bump.newVersion}
+      2. Create GitHub release using gh CLI:
+         gh release create v${version-bump.newVersion} \
+           --title "v${version-bump.newVersion}" \
+           --notes <extracted-notes>
+      3. Verify release created successfully
+      4. Get release URL
+
+      RELEASE NOTES FORMAT:
+      - Extract section from CHANGELOG.md between version headers
+      - Include Features, Bug Fixes, Documentation sections
+      - Format as markdown
+      - Add installation instructions
+
+      OUTPUT:
+      - Release URL
+      - Release status
+      - Release notes preview
+    timeout: 180000  # 3 minutes
+    saveToMemory: true
+    dependencies: [git-push]
+
+  # Stage 8: Monitor CI/CD
+  - id: cicd-monitor
+    actor: release-publisher
+    description: "Monitor GitHub Actions workflow"
+    prompt: |
+      Monitor GitHub Actions workflow for release:
+
+      VERSION: ${version-bump.newVersion}
+      RELEASE: ${github-release.releaseURL}
+
+      TASKS:
+      1. Wait for GitHub Actions workflow to start (10-15 seconds)
+      2. Get latest workflow run ID: gh run list --limit 1
+      3. Monitor workflow status: gh run view <run-id>
+      4. Wait for workflow completion or timeout (15 minutes)
+      5. Report final status
+
+      EXPECTED WORKFLOW:
+      - Build and test
+      - Publish to npm
+      - Create npm release
+
+      OUTPUT:
+      - Workflow status (pending/running/completed/failed)
+      - Workflow URL
+      - npm publish status
+      - Any errors or warnings
+    timeout: 1200000  # 20 minutes
+    saveToMemory: true
+    dependencies: [github-release]
+
+# Observability
+observability:
+  metrics:
+    enabled: true
+    labels:
+      project: automatosx
+      workflow: release
+      type: automation
+
+  audit:
+    enabled: true
+    retention: 90  # 90 days
+
+  tracing:
+    enabled: true
+    samplingRate: 1.0  # Capture all release executions
+
+# Retry and error handling
+execution:
+  parallel: false  # Sequential execution
+  continueOnError: false  # Stop on first error
+
+  retry:
+    enabled: true
+    maxRetries: 2
+    backoffMs: 5000
+
+# Expected outputs
+outputs:
+  version:
+    description: "Released version number"
+    from: version-bump.newVersion
+
+  releaseURL:
+    description: "GitHub release URL"
+    from: github-release.releaseURL
+
+  npmURL:
+    description: "npm package URL"
+    value: "https://www.npmjs.com/package/@defai.digital/automatosx"
+
+  status:
+    description: "Overall release status"
+    from: cicd-monitor.workflowStatus

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@defai.digital/automatosx",
-  "version": "6.5.5",
+  "version": "6.5.6",
   "description": "AI Agent Orchestration Platform",
   "type": "module",
   "publishConfig": {
@@ -51,10 +51,12 @@
     "check:timers": "bash tools/check-timer-cleanup.sh",
     "prepare": "[ -n \"$CI\" ] || husky",
     "commit": "cz",
-    "release": "standard-version",
-    "release:minor": "standard-version --release-as minor",
-    "release:major": "standard-version --release-as major",
-    "release:patch": "standard-version --release-as patch",
+    "release": "node tools/release.js",
+    "release:patch": "node tools/release.js patch",
+    "release:minor": "node tools/release.js minor",
+    "release:major": "node tools/release.js major",
+    "release:spec": "ax spec run examples/specs/automatosx-release.ax.yaml",
+    "release:standard": "standard-version",
     "release:beta": "standard-version --prerelease beta",
     "release:rc": "standard-version --prerelease rc",
     "release:first": "standard-version --first-release"