kiro-spec-engine 1.22.0 → 1.24.2

package/CHANGELOG.md

@@ -7,6 +7,197 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.24.2] - 2026-02-05
+
+### Changed
+- **Steering Optimization**: Reduced token consumption by 70-80% across all steering files
+  - ENVIRONMENT.md: Simplified from detailed sections to core information (75% reduction)
+  - CURRENT_CONTEXT.md: Condensed to essential status summary (80% reduction)
+  - RULES_GUIDE.md: Streamlined to key rules only (70% reduction)
+  - Total reduction: ~1500 tokens saved per session
+  - Improved AI response speed and available context space
+
+### Added
+- **Frontend-Backend Alignment Principle**: New core principle for field consistency
+  - Backend data model as authoritative source
+  - Frontend fields must align with backend definitions
+  - Prevents legacy field accumulation in frontend code
+
+## [1.24.1] - 2026-02-03
+
+### Added
+- **Knowledge Management - EntryManager**: Core file operations for knowledge entries
+  - Entry creation with YAML frontmatter and metadata
+  - Entry reading and parsing with frontmatter support
+  - Entry updating with automatic timestamp management
+  - Entry deletion with optional backup system
+  - Entry validation with comprehensive error checking
+  - Unique ID generation (kb-{timestamp}-{random} format)
+  - Kebab-case filename generation from titles
+  - Full CRUD operations for knowledge base entries
+
+### Technical Details
+- Implements all methods from design specification
+- Uses fs-extra for atomic file operations
+- Uses js-yaml for frontmatter parsing/serialization
+- Backup system stores deleted entries in .backups/ directory
+- Comprehensive error handling with descriptive messages
+- Foundation for Phase 1 of Spec 34-00-user-knowledge-management
+
+## [1.24.0] - 2026-02-03
+
+### Added
+- **User Knowledge Management System (MVP)**: Personal knowledge base for capturing project experiences
+  - **Knowledge Base**: Organize patterns, lessons, workflows, checklists, and references
+  - **CLI Commands**: Complete command set for knowledge management
+    - `kse knowledge init` - Initialize knowledge base
+    - `kse knowledge add <type> <title>` - Add new entry (pattern/lesson/workflow/checklist/reference)
+    - `kse knowledge list` - List all entries with filtering and sorting
+    - `kse knowledge search <keyword>` - Search entries (title, tags, content)
+    - `kse knowledge show <id>` - Display entry details
+    - `kse knowledge delete <id>` - Delete entry with backup
+    - `kse knowledge stats` - Show statistics
+  - **Entry Types**: Five built-in types with customizable templates
+    - Pattern: Design patterns and architectural solutions
+    - Lesson: Lessons learned from experience
+    - Workflow: Custom workflows and processes
+    - Checklist: Task checklists
+    - Reference: Reference materials and links
+  - **Features**:
+    - YAML frontmatter + Markdown content
+    - Tag-based organization
+    - Fast metadata indexing (index.json)
+    - Automatic backup on deletion
+    - Full-text search support
+    - Customizable templates
+  - **Documentation**: Complete user guide at `docs/knowledge-management-guide.md`
+
+### Technical Details
+- Knowledge stored in `.kiro/knowledge/` directory
+- Lightweight index for fast lookups (not auto-loaded into AI context)
+- Modular architecture: EntryManager, IndexManager, TemplateManager, KnowledgeManager
+- Cross-platform support (Windows/Linux/macOS)
+
+### Future Enhancements
+- AI-powered knowledge analysis and suggestions
+- Knowledge integration into project documentation
+- Import/export functionality
+- Advanced search with semantic understanding
+
+## [1.23.2] - 2026-02-02
+
+### Added
+- **AI Autonomous Control System (Complete Version)**: Full autonomous execution framework
+  - **Safety Manager**: Safety boundary enforcement with operation validation
+    - Production environment access control
+    - Workspace boundary validation
+    - External system access confirmation
+    - Destructive operation protection
+    - Audit logging for all operations
+  - **Learning System Persistence**: Error recovery learning with historical data
+    - Success/failure history tracking across sessions
+    - Strategy prioritization based on historical performance
+    - Automatic learning data persistence to `.kiro/auto/learning-data.json`
+  - **Estimation Improvement**: Task duration tracking and prediction
+    - Historical task duration tracking by task type
+    - Weighted average estimation (more weight to recent data)
+    - Improved completion time estimates over multiple executions
+    - Historical data persistence to `.kiro/auto/historical-data.json`
+  - **CORE_PRINCIPLES Compliance**: Automatic verification of kse project structure
+    - Checks for `.kiro` directory (adoption marker)
+    - Validates `version.json`, `specs/`, `steering/` directories
+    - Ensures Spec-driven development workflow compliance
+  - **Comprehensive Documentation**:
+    - Complete user guide: `docs/autonomous-control-guide.md`
+    - Quick start examples and best practices
+    - Troubleshooting guide with common issues
+    - Configuration reference with all options
+    - FAQ section
+  - **README Updates**: Added Autonomous Control feature to main README
+    - Feature overview with quick start examples
+    - Links to detailed documentation
+
+### Improved
+- **Error Recovery**: Enhanced with persistent learning across sessions
+- **Progress Tracking**: Improved time estimates using historical data
+- **Safety**: Integrated safety checks into all file operations and task execution
+
+## [1.23.1] - 2026-02-02
+
+### Fixed
+- **CI Test Stability**: Fixed timing issue in docs-stats-report test
+  - Increased delay from 10ms to 100ms to ensure file write completion in CI environment
+  - Aligns with other similar tests that use 100ms delay for filesystem operations
+  - All 1689 tests now pass reliably
+
+## [1.23.0] - 2026-02-02 [YANKED]
+
+### Note
+- This version was yanked due to CI test failure
+- All features moved to v1.23.1
+
+### Added
+- **AI Autonomous Control System (MVP)**: Complete autonomous execution framework for Spec-driven development
+  - **Core Managers**: 7 specialized managers for autonomous operation
+    - `StateManager`: Persistent state management with automatic save/load
+    - `TaskQueueManager`: Task queue with dependency analysis and priority-based execution
+    - `ErrorRecoveryManager`: Automatic error recovery with 3-attempt retry and learning system
+    - `ProgressTracker`: Real-time progress tracking with comprehensive audit logging
+    - `DecisionEngine`: Design decision documentation and pattern detection
+    - `CheckpointManager`: Checkpoint creation and rollback with user approval workflow
+    - `AutonomousEngine`: Central orchestrator integrating all managers
+  - **CLI Commands**: Complete command set for autonomous execution
+    - `kse auto create <description>`: Create and run Spec autonomously from feature description
+    - `kse auto run <spec>`: Execute existing Spec tasks autonomously
+    - `kse auto status`: Display current execution state and progress
+    - `kse auto resume`: Resume from last checkpoint after pause
+    - `kse auto stop`: Gracefully stop execution and save state
+    - `kse auto config`: View and update autonomous execution configuration
+  - **Key Features**:
+    - Continuous task execution without interruption
+    - Automatic error recovery with strategy learning
+    - Progress tracking with detailed execution logs
+    - Checkpoint system with rollback capability (keeps last 5 checkpoints)
+    - User approval workflow at critical phase boundaries
+    - Configuration-based safety boundaries
+    - State persistence for resume after interruption
+  - **Configuration Schema**: Comprehensive configuration with validation
+    - Execution modes: conservative, balanced, aggressive
+    - Safety boundaries: production protection, workspace limits
+    - Error recovery settings: max attempts, timeout, strategies
+    - Checkpoint settings: auto-create, user approval requirements
+  - **State Management**: Complete state tracking
+    - Execution status (running, paused, stopped)
+    - Current phase and task
+    - Progress percentages by phase
+    - Checkpoint history
+    - Error recovery attempts
+    - Decision records
+
+### Technical Details
+- State stored in `.kiro/auto/state.json` with atomic updates
+- Checkpoints stored in `.kiro/auto/checkpoints/` with metadata
+- Configuration hierarchy: global defaults < project config < runtime options
+- Error recovery strategies: syntax fixes, import resolution, null checks, retry
+- Learning system tracks successful/failed strategies for future optimization
+- Progress tracking with action logging, decision recording, error tracking
+- Checkpoint types: phase boundary, user approval, fatal error, external resource
+- Task dependency graph with circular dependency detection
+- Priority-based task ordering with blocked task detection
+
+### Documentation
+- Comprehensive inline documentation in all manager classes
+- CLI help text for all commands
+- Configuration schema with validation rules
+- State structure documentation
+
+### Notes
+- MVP implementation complete (80% of planned features)
+- All 1689 existing tests pass
+- Optional property-based tests deferred for faster delivery
+- Detailed documentation and integration tests to follow in subsequent iterations
+- Implements Spec 33-00-ai-autonomous-control
+
 ## [1.22.0] - 2026-02-02
 
 ### Added

package/README.md

@@ -8,6 +8,8 @@
 
 **A context provider for AI coding tools** - Structure your project requirements, design, and tasks so AI assistants can help you build better software.
 
+**🚀 NEW: Autonomous Control** - Let AI independently manage entire development workflows from requirements to delivery.
+
 English | [简体中文](README.zh.md)
 
 ---
@@ -249,6 +251,35 @@ sequenceDiagram
 
 ## Key Features
 
+### Autonomous Control 🚀 NEW in v1.23.0
+- **Fully Autonomous Execution**: AI independently manages entire development workflows from requirements to delivery
+- **Intelligent Error Recovery**: Automatically diagnose and fix errors with 3 retry attempts and learning system
+- **Strategic Checkpoints**: Pause only at meaningful milestones (phase boundaries, fatal errors, external resources)
+- **Continuous Task Execution**: Execute multiple tasks without interruption between individual tasks
+- **Learning System**: Improve over time by learning from successful and failed recovery strategies
+- **Safety Boundaries**: Respect workspace boundaries, require confirmation for production/external operations
+- **Three Execution Modes**: Conservative (safe), Balanced (default), Aggressive (fast)
+- **Progress Tracking**: Real-time status, estimated completion time, detailed execution reports
+- **Rollback Support**: Create checkpoints and rollback to previous states if needed
+- **CORE_PRINCIPLES Compliance**: Follows Spec-driven development, file management, and quality standards
+
+**Quick Start**:
+```bash
+# Create and execute a feature autonomously
+kse auto create "user authentication with JWT tokens"
+
+# Run existing Spec autonomously
+kse auto run 33-00-ai-autonomous-control
+
+# Check status
+kse auto status
+
+# Resume after pause
+kse auto resume
+```
+
+[Learn more about Autonomous Control →](docs/autonomous-control-guide.md)
+
 ### Spec-Driven Development
 Structure your work with Requirements → Design → Tasks workflow
 

package/bin/kiro-spec-engine.js

@@ -555,6 +555,14 @@ repoCmd
 // Spec-level collaboration commands
 registerCollabCommands(program);
 
+// Autonomous control commands
+const { registerAutoCommands } = require('../lib/commands/auto');
+registerAutoCommands(program);
+
+// Knowledge management commands
+const { registerKnowledgeCommands } = require('../lib/commands/knowledge');
+registerKnowledgeCommands(program);
+
 // Template management commands
 const templatesCommand = require('../lib/commands/templates');