loki-mode 6.27.2 → 6.29.0

package/autonomy/run.sh

@@ -3629,6 +3629,11 @@ except:
 
     # Clear current-task.json
     echo "{}" > .loki/queue/current-task.json
+
+    # Write-back completed BMAD stories to source artifacts (v6.29.0)
+    if [ "$exit_code" = "0" ]; then
+        bmad_write_back
+    fi
 }
 
 start_status_monitor() {
@@ -8198,6 +8203,9 @@ if not stories:
     print("No BMAD stories found to queue", file=sys.stderr)
     sys.exit(0)
 
+# Sort stories by priority_weight (MVP=1 first, then phase2=2, then phase3=3)
+stories.sort(key=lambda s: s.get("priority_weight", 2) if isinstance(s, dict) else 2)
+
 # Filter out completed stories from sprint-status
 skipped_count = 0
 if completed_stories:
@@ -8269,6 +8277,45 @@ BMAD_QUEUE_EOF
     log_info "BMAD queue population complete"
 }
 
+# Write-back completed BMAD stories to sprint-status.yml and epics.md
+# Called after each iteration to sync completion state back to BMAD artifacts
+bmad_write_back() {
+    # Skip if not a BMAD project
+    local bmad_project="${BMAD_PROJECT_PATH:-}"
+    if [[ -z "$bmad_project" ]]; then
+        return 0
+    fi
+
+    # Skip if no completed stories file
+    local completed_file=".loki/bmad-completed-stories.json"
+    if [[ ! -f "$completed_file" ]]; then
+        return 0
+    fi
+
+    # Skip if completed stories file is empty or just []
+    local story_count
+    story_count=$(python3 -c "import json; data=json.load(open('$completed_file')); print(len(data))" 2>/dev/null || echo "0")
+    if [[ "$story_count" -eq 0 ]]; then
+        return 0
+    fi
+
+    # Find the adapter script
+    local adapter_script="${SCRIPT_DIR}/bmad-adapter.py"
+    if [[ ! -f "$adapter_script" ]]; then
+        log_warn "BMAD adapter not found, skipping write-back"
+        return 0
+    fi
+
+    # Run write-back (warn on failure, never crash)
+    if python3 "$adapter_script" "$bmad_project" \
+        --write-back \
+        --completed-stories-file "$completed_file" 2>/dev/null; then
+        log_info "BMAD write-back: synced completed stories to source artifacts"
+    else
+        log_warn "BMAD write-back failed (non-fatal)"
+    fi
+}
+
 #===============================================================================
 # OpenSpec Task Queue Population
 #===============================================================================

package/dashboard/__init__.py

@@ -7,7 +7,7 @@ Modules:
     control: Session control API (start/stop/pause/resume)
 """
 
-__version__ = "6.27.2"
+__version__ = "6.29.0"
 
 # Expose the control app for easy import
 try:

package/docs/INSTALLATION.md

@@ -2,7 +2,7 @@
 
 The flagship product of [Autonomi](https://www.autonomi.dev/). Complete installation instructions for all platforms and use cases.
 
-**Version:** v6.27.2
+**Version:** v6.29.0
 
 ---
 

package/mcp/__init__.py

@@ -57,4 +57,4 @@ try:
 except ImportError:
     __all__ = ['mcp']
 
-__version__ = '6.27.0'
+__version__ = '6.29.0'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "loki-mode",
-  "version": "6.27.2",
+  "version": "6.29.0",
   "description": "Loki Mode by Autonomi - Multi-agent autonomous startup system for Claude Code, Codex CLI, and Gemini CLI",
   "keywords": [
     "agent",

package/templates/dashboard.md

@@ -0,0 +1,42 @@
+# PRD: Analytics Dashboard
+
+## Overview
+A real-time analytics dashboard that visualizes key business metrics with interactive charts, filterable data tables, and customizable dashboard layouts.
+
+## Target Users
+- Product managers tracking feature adoption and user engagement
+- Business analysts monitoring KPIs and trends
+- Operations teams watching system health and performance metrics
+
+## Core Features
+1. **Interactive Charts** - Line, bar, pie, and area charts with hover tooltips and click-to-drill-down
+2. **Data Tables** - Sortable, filterable, and paginated tables with column visibility controls
+3. **Date Range Picker** - Filter all dashboard data by custom date ranges with preset shortcuts
+4. **Real-Time Updates** - WebSocket connection for live metric updates without page refresh
+5. **Dashboard Layouts** - Drag-and-drop widget arrangement with save and load layout presets
+6. **Export** - Export charts as PNG images and tables as CSV files
+7. **Responsive Design** - Fully functional on desktop, tablet, and mobile screen sizes
+
+## Technical Requirements
+- React 18 with TypeScript
+- Recharts or Chart.js for data visualization
+- TanStack Table for data tables
+- WebSocket for real-time updates
+- TailwindCSS for styling
+- Express backend serving mock data API
+- LocalStorage for saved layouts
+
+## Quality Gates
+- Unit tests for data transformation and formatting utilities
+- Component tests for chart and table rendering
+- E2E tests for date filtering and layout persistence (Playwright)
+- Responsive design tested at 3 breakpoints (mobile, tablet, desktop)
+- Accessibility: all charts have aria labels, tables are keyboard navigable
+
+## Success Metrics
+- Dashboard loads with sample data and renders all chart types
+- Date range filter updates all widgets simultaneously
+- Real-time updates reflect in charts within 2 seconds
+- Drag-and-drop layout changes persist across page reloads
+- CSV and PNG exports contain accurate data
+- All tests pass

package/templates/data-pipeline.md

@@ -0,0 +1,42 @@
+# PRD: Data Pipeline
+
+## Overview
+An ETL data pipeline that ingests data from multiple sources, transforms it through configurable processing steps, and loads results into a target data store with monitoring and error recovery.
+
+## Target Users
+- Data engineers building batch or streaming pipelines
+- Analysts automating data transformation workflows
+- Teams consolidating data from multiple sources
+
+## Core Features
+1. **Multi-Source Ingestion** - Read from CSV files, JSON APIs, PostgreSQL databases, and S3 buckets
+2. **Configurable Transforms** - Chain transformation steps: filter, map, aggregate, join, and deduplicate
+3. **Schema Validation** - Validate incoming data against defined schemas, quarantine invalid records
+4. **Incremental Processing** - Track watermarks for incremental loads, skip already-processed records
+5. **Error Recovery** - Dead letter queue for failed records, automatic retry with configurable policies
+6. **Pipeline Monitoring** - Metrics for records processed, errors, throughput, and pipeline duration
+7. **Scheduling** - Cron-based scheduling with dependency management between pipeline stages
+
+## Technical Requirements
+- Python 3.10+ with type hints
+- Pydantic for schema validation
+- SQLAlchemy for database connections
+- Click for CLI interface
+- YAML pipeline definitions
+- SQLite for pipeline state and metadata
+- Structured JSON logging
+
+## Quality Gates
+- Unit tests for each transform function
+- Integration tests with sample datasets
+- Schema validation tested with valid and invalid records
+- Incremental processing verified across multiple runs
+- Dead letter queue captures all failure categories
+
+## Success Metrics
+- Pipeline processes sample dataset end-to-end without errors
+- Invalid records quarantined with descriptive error messages
+- Incremental runs process only new records
+- Metrics accurately reflect processing statistics
+- Pipeline resumes correctly after interruption
+- All tests pass

package/templates/game.md

@@ -0,0 +1,42 @@
+# PRD: Browser Game
+
+## Overview
+A browser-based 2D game with player controls, enemy AI, scoring, levels, and persistent high scores. Runs entirely client-side with no server required.
+
+## Target Users
+- Casual gamers looking for a quick browser-based experience
+- Game developers learning 2D game architecture patterns
+- Developers exploring canvas-based rendering and game loops
+
+## Core Features
+1. **Player Controls** - Keyboard input for movement and actions with configurable key bindings
+2. **Game Loop** - Fixed-timestep update loop with requestAnimationFrame rendering at 60fps
+3. **Enemy AI** - Multiple enemy types with distinct movement patterns and difficulty scaling
+4. **Collision Detection** - Axis-aligned bounding box (AABB) collision between sprites
+5. **Scoring and Levels** - Point system with level progression, increasing difficulty per level
+6. **High Scores** - Persistent leaderboard stored in localStorage with name entry
+7. **Sound Effects** - Audio feedback for actions, collisions, and level completion using Web Audio API
+
+## Technical Requirements
+- HTML5 Canvas for rendering
+- Vanilla TypeScript (no game engine dependency)
+- Web Audio API for sound
+- LocalStorage for high scores and settings
+- Asset pipeline for sprites and audio files
+- Responsive canvas sizing
+- No server required (static files only)
+
+## Quality Gates
+- Unit tests for collision detection, scoring, and level progression logic
+- Game loop maintains consistent frame timing under load
+- All sprite assets load without errors
+- Controls responsive on both keyboard and touch (mobile)
+- No memory leaks during extended play sessions
+
+## Success Metrics
+- Game starts, plays, and ends with proper state transitions
+- Player can move, shoot, and interact with enemies
+- Score increments correctly and persists in high score table
+- Level progression increases difficulty noticeably
+- Game runs at stable 60fps on modern browsers
+- All tests pass

package/templates/microservice.md

@@ -0,0 +1,43 @@
+# PRD: Microservice
+
+## Overview
+A containerized microservice with health checks, structured logging, graceful shutdown, and observability. Follows twelve-factor app principles for cloud-native deployment.
+
+## Target Users
+- Backend engineers building distributed systems
+- Teams decomposing monoliths into microservices
+- DevOps engineers designing cloud-native architectures
+
+## Core Features
+1. **HTTP API** - RESTful endpoints with request validation, error handling, and content negotiation
+2. **Health Checks** - Liveness and readiness probe endpoints for container orchestration
+3. **Structured Logging** - JSON-formatted logs with correlation IDs, log levels, and context fields
+4. **Graceful Shutdown** - Handle SIGTERM/SIGINT with connection draining and cleanup
+5. **Configuration** - Environment-variable-based configuration with validation on startup
+6. **Database Integration** - Connection pooling, migrations, and repository pattern for data access
+7. **Observability** - Prometheus metrics endpoint with request duration, error rate, and custom counters
+
+## Technical Requirements
+- Node.js with Express and TypeScript
+- Docker and docker-compose for local development
+- Prisma ORM with PostgreSQL
+- Prometheus client for metrics
+- pino for structured logging
+- Dockerfile with multi-stage build
+- Health check middleware
+
+## Quality Gates
+- Unit tests for business logic and middleware
+- Integration tests with test database
+- Docker image builds and starts successfully
+- Health check endpoints return correct status codes
+- Graceful shutdown completes within timeout
+- Metrics endpoint serves valid Prometheus format
+
+## Success Metrics
+- Service starts in Docker and responds to API requests
+- Health probes return healthy status after startup
+- Logs are valid JSON with correlation IDs across requests
+- Graceful shutdown drains connections without dropping requests
+- Prometheus can scrape metrics endpoint
+- All tests pass

package/templates/npm-library.md

@@ -0,0 +1,43 @@
+# PRD: npm Library
+
+## Overview
+A well-structured npm package with TypeScript support, comprehensive documentation, tree-shakeable exports, and automated publishing. Designed as a reusable utility library.
+
+## Target Users
+- JavaScript and TypeScript developers looking for reusable utilities
+- Teams standardizing shared logic across multiple projects
+- Open source contributors publishing packages to npm
+
+## Core Features
+1. **TypeScript First** - Written in TypeScript with generated .d.ts declaration files
+2. **Dual Format** - Publish both ESM and CommonJS builds for maximum compatibility
+3. **Tree Shaking** - Named exports with proper sideEffects configuration for optimal bundling
+4. **Comprehensive Docs** - Auto-generated API documentation from TSDoc comments
+5. **Semantic Versioning** - Automated changelog generation and version bumping
+6. **Zero Dependencies** - No runtime dependencies for minimal install footprint
+7. **Playground** - Interactive examples in a docs site for trying the library
+
+## Technical Requirements
+- TypeScript 5+ with strict mode
+- tsup for dual ESM/CJS builds
+- Vitest for testing
+- typedoc for API documentation generation
+- changesets for version management
+- GitHub Actions for CI/CD and npm publishing
+- package.json exports map for subpath exports
+
+## Quality Gates
+- Unit tests with 90%+ code coverage
+- Type tests verifying public API type signatures
+- Bundle size tracked and budgeted (fail CI if over limit)
+- ESM and CJS builds both importable in Node.js
+- TypeScript declarations compile cleanly in consuming projects
+- Documentation generated without warnings
+
+## Success Metrics
+- Package installs and imports correctly in ESM and CJS projects
+- All public functions have TSDoc comments and generated docs
+- Test coverage exceeds 90% across all modules
+- Bundle size stays under defined budget
+- Changelog accurately reflects changes between versions
+- All tests pass

package/templates/slack-bot.md

@@ -0,0 +1,42 @@
+# PRD: Slack Bot
+
+## Overview
+A Slack bot that responds to commands, processes events, and integrates with external services. Supports slash commands, interactive messages, and scheduled notifications.
+
+## Target Users
+- Teams automating workflows through Slack
+- Developers building internal tools for Slack workspaces
+- Organizations standardizing team communication and processes
+
+## Core Features
+1. **Slash Commands** - Register and handle custom slash commands with argument parsing
+2. **Event Handling** - Listen for message events, reactions, channel joins, and user mentions
+3. **Interactive Messages** - Send messages with buttons, menus, and modals for user input
+4. **Scheduled Messages** - Schedule recurring notifications and reminders with cron syntax
+5. **External Integrations** - Connect to REST APIs and databases to fetch and display data
+6. **Help System** - Built-in help command listing all available commands and their usage
+7. **Error Reporting** - Log errors and send admin notifications when commands fail
+
+## Technical Requirements
+- Node.js with TypeScript
+- Bolt for Slack SDK (official Slack framework)
+- Express for webhook endpoints
+- SQLite for persistent storage (schedules, user preferences)
+- Environment-based configuration for tokens and signing secrets
+- Structured logging with request context
+- Socket Mode for development, HTTP for production
+
+## Quality Gates
+- Unit tests for command handlers and argument parsers
+- Integration tests with Slack API mocks
+- Interactive message flows tested end-to-end
+- Error handling verified for invalid inputs and API failures
+- Rate limiting compliance with Slack API limits
+
+## Success Metrics
+- Bot responds to all registered slash commands
+- Event handlers process messages and reactions correctly
+- Interactive modals collect and persist user input
+- Scheduled messages fire at configured times
+- Error notifications reach admin channel
+- All tests pass

package/templates/web-scraper.md

@@ -0,0 +1,42 @@
+# PRD: Web Scraper Tool
+
+## Overview
+A configurable web scraping tool that extracts structured data from websites, handles pagination, respects robots.txt, and exports results in multiple formats.
+
+## Target Users
+- Data analysts collecting web data for research
+- Developers building data pipelines from web sources
+- Marketers monitoring competitor pricing or content
+
+## Core Features
+1. **Configurable Extraction** - Define scraping targets with CSS selectors or XPath expressions in a config file
+2. **Pagination Handling** - Automatically follow next-page links or infinite scroll patterns
+3. **Rate Limiting** - Configurable request delays and concurrent connection limits to avoid blocking
+4. **Robots.txt Compliance** - Parse and respect robots.txt rules, with override flag for allowed domains
+5. **Multi-Format Export** - Export scraped data as JSON, CSV, or SQLite database
+6. **Retry and Error Handling** - Automatic retry with exponential backoff for failed requests
+7. **Proxy Support** - Rotate through proxy list for distributed scraping
+
+## Technical Requirements
+- Python 3.10+ with async/await
+- httpx for async HTTP requests
+- BeautifulSoup4 and lxml for HTML parsing
+- SQLite for persistent storage
+- YAML configuration files
+- CLI interface with argparse
+- Structured logging
+
+## Quality Gates
+- Unit tests for parser, config loader, and export functions
+- Integration tests with mock HTTP server
+- Robots.txt parser tested against edge cases
+- Rate limiter verified with timing assertions
+- Export format validation for JSON, CSV, and SQLite
+
+## Success Metrics
+- Scraper extracts data matching CSS selector configuration
+- Pagination follows links and collects all pages
+- Rate limiting maintains configured request interval
+- Robots.txt rules correctly block disallowed paths
+- All export formats contain valid, complete data
+- All tests pass