omgkit 2.10.0 → 2.11.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "omgkit",
-  "version": "2.10.0",
+  "version": "2.11.0",
   "description": "Omega-Level Development Kit - AI Team System for Claude Code. 23 agents, 58 commands, 88 skills, sprint management.",
   "keywords": [
     "claude-code",
@@ -53,6 +53,7 @@
   },
   "devDependencies": {
     "@vitest/coverage-v8": "^4.0.16",
+    "js-yaml": "^4.1.1",
     "vitest": "^4.0.16"
   }
 }

package/plugin/agents/autonomous-orchestrator.yaml

@@ -0,0 +1,215 @@
+# Autonomous Orchestrator Agent
+# Core agent for running autonomous project development
+
+name: Autonomous Orchestrator
+id: autonomous-orchestrator
+version: "1.0.0"
+description: |
+  The central orchestrator for autonomous project development. Manages state,
+  coordinates phases, handles checkpoints, and drives the entire autonomous
+  development lifecycle from discovery to deployment.
+
+# Agent categorization
+category: orchestration
+tags:
+  - autonomous
+  - orchestration
+  - project-management
+  - state-machine
+
+# Capabilities
+capabilities:
+  - State machine management
+  - Phase orchestration
+  - Checkpoint handling
+  - Decision management
+  - Quality gate enforcement
+  - Memory system integration
+  - Error recovery
+  - Progress tracking
+
+# Tools this agent can use
+tools:
+  - Read
+  - Write
+  - Edit
+  - Bash
+  - Glob
+  - Grep
+  - Task
+  - AskUserQuestion
+
+# System prompt for the agent
+system_prompt: |
+  You are the Autonomous Orchestrator, responsible for driving autonomous project
+  development from initial discovery through deployment.
+
+  ## Your Responsibilities
+
+  1. **State Management**
+     - Maintain `.omgkit/state.yaml` with current project state
+     - Track progress through phases and features
+     - Handle state transitions correctly
+     - Ensure state consistency and recoverability
+
+  2. **Phase Orchestration**
+     - Load and follow archetype definitions
+     - Execute phase workflows in order
+     - Handle dynamic feature phases
+     - Respect phase dependencies
+
+  3. **Checkpoint Management**
+     - Create checkpoints at phase boundaries
+     - Handle manual checkpoint requests
+     - Wait for approval before continuing
+     - Process rejection feedback appropriately
+
+  4. **Decision Framework**
+     - Classify decisions by autonomy level
+     - Auto-execute level 0-1 decisions
+     - Request approval for level 2-4 decisions
+     - Record all decisions in memory
+
+  5. **Quality Enforcement**
+     - Run quality gates after features
+     - Enforce coverage thresholds
+     - Block on critical failures
+     - Report quality metrics
+
+  6. **Memory Integration**
+     - Update context files as work progresses
+     - Record decisions in decision log
+     - Maintain journal entries
+     - Preserve learning for future sessions
+
+  ## State Machine
+
+  Valid states:
+  - `ready`: Ready to start/continue execution
+  - `in_progress`: Currently executing
+  - `checkpoint`: Paused for approval
+  - `blocked`: Error or issue preventing progress
+  - `completed`: All phases finished
+  - `revision_needed`: Feedback requires changes
+
+  ## Autonomy Levels
+
+  - Level 0: Auto-execute without notification
+  - Level 1: Execute with notification
+  - Level 2: Preview and quick approval
+  - Level 3: Full review required
+  - Level 4: Human must perform
+
+  ## Error Handling
+
+  On errors:
+  1. Log error context
+  2. Save state for recovery
+  3. Transition to blocked state
+  4. Report with fix suggestions
+  5. Support retry/skip/rollback
+
+  ## Output Standards
+
+  Always provide:
+  - Clear progress indicators
+  - Current phase and step
+  - Quality gate results
+  - Next action preview
+
+# Workflows this agent can trigger
+workflows:
+  - discovery
+  - planning
+  - feature
+  - test
+  - code-review
+  - security-audit
+  - deployment
+
+# Integration points
+integrations:
+  state:
+    file: ".omgkit/state.yaml"
+    schema: "plugin/templates/autonomous/state-schema.yaml"
+
+  features:
+    file: ".omgkit/generated/features.yaml"
+    schema: "plugin/templates/autonomous/features-schema.yaml"
+
+  memory:
+    context: ".omgkit/memory/context/"
+    decisions: ".omgkit/memory/decisions/"
+    journal: ".omgkit/memory/journal/"
+
+  archetypes:
+    path: "plugin/templates/autonomous/archetypes/"
+
+# Behavior configuration
+behavior:
+  # How verbose to be
+  verbosity: normal  # quiet | normal | verbose
+
+  # Whether to auto-create checkpoints
+  auto_checkpoint: true
+
+  # Maximum retries before blocking
+  max_retries: 3
+
+  # Whether to attempt auto-fixes
+  auto_fix: true
+  auto_fix_confidence_threshold: 0.7
+
+  # Whether to run quality gates automatically
+  auto_quality_gates: true
+
+# Performance hints
+performance:
+  # Use parallel execution when possible
+  parallel_execution: true
+
+  # Cache archetype definitions
+  cache_archetypes: true
+
+  # Batch state updates
+  batch_state_updates: true
+
+# Monitoring
+monitoring:
+  # Log all state transitions
+  log_transitions: true
+
+  # Track execution metrics
+  track_metrics: true
+
+  # Alert on blocked state
+  alert_on_blocked: true
+
+# Examples of agent usage
+examples:
+  - name: Start autonomous execution
+    input: "Continue autonomous execution for the project"
+    expected: |
+      1. Load current state from .omgkit/state.yaml
+      2. Determine current phase and step
+      3. Execute next actions according to archetype
+      4. Update state after each action
+      5. Create checkpoint at phase boundary
+
+  - name: Handle checkpoint
+    input: "Checkpoint reached for planning phase"
+    expected: |
+      1. Save complete state snapshot
+      2. Generate checkpoint summary
+      3. List artifacts for review
+      4. Set status to checkpoint
+      5. Wait for /auto:approve or /auto:reject
+
+  - name: Recover from error
+    input: "Tests failed during user_authentication feature"
+    expected: |
+      1. Capture error context
+      2. Analyze failure cause
+      3. If auto-fixable, attempt fix
+      4. If not fixable, set status to blocked
+      5. Report with suggestions

package/plugin/commands/auto/approve.md

@@ -0,0 +1,258 @@
+---
+description: Approve checkpoint or pending decision to continue
+allowed-tools: Read, Write, Edit
+argument-hint: "[checkpoint | decision <id>] [--all]"
+---
+
+# Approve Checkpoint or Decision
+
+Approve a pending checkpoint or autonomy decision to continue execution.
+
+## Usage
+
+### Approve Current Checkpoint
+```bash
+/auto:approve
+/auto:approve checkpoint
+```
+
+### Approve Specific Decision
+```bash
+/auto:approve decision db_index_strategy
+```
+
+### Approve All Pending
+```bash
+/auto:approve --all
+```
+
+## Approval Process
+
+### 1. Check Pending Items
+
+Load from `.omgkit/state.yaml`:
+```yaml
+checkpoint:
+  pending: true
+  type: "phase"
+  phase: "planning"
+  description: "Planning phase complete. Review artifacts."
+  artifacts:
+    - ".omgkit/generated/schema.sql"
+    - ".omgkit/generated/api-spec.md"
+
+pending_decisions:
+  - id: "db_index_strategy"
+    level: 2
+    description: "Add composite index on users(email, status)"
+    options:
+      - "approve"
+      - "modify"
+      - "reject"
+  - id: "auth_token_expiry"
+    level: 2
+    description: "Set JWT expiry to 24 hours"
+```
+
+### 2. Validate Approval
+
+For checkpoint:
+- Check artifacts exist
+- Verify quality gates passed
+- Confirm user has reviewed
+
+For decision:
+- Check decision exists
+- Validate decision is pending
+- Record approval with timestamp
+
+### 3. Update State
+
+```yaml
+# After checkpoint approval
+checkpoint:
+  pending: false
+  approved_at: "2024-01-15T10:30:00Z"
+  approved_by: "user"
+
+status: "ready"  # Changed from "checkpoint"
+
+# After decision approval
+decisions_log:
+  - id: "db_index_strategy"
+    decision: "approved"
+    timestamp: "2024-01-15T10:30:00Z"
+
+pending_decisions: []  # Removed approved item
+```
+
+### 4. Record in Memory
+
+Create decision record at `.omgkit/memory/decisions/`:
+```markdown
+# Decision: Database Index Strategy
+
+**Date:** 2024-01-15
+**Phase:** Planning
+**Status:** Approved
+
+## Context
+During schema design, identified need for efficient user lookup by email and status.
+
+## Decision
+Add composite index on users(email, status) table.
+
+## Rationale
+- Improves login query performance
+- Supports filtering by account status
+- Minimal storage overhead
+
+## Consequences
+- Slightly slower inserts
+- Index maintenance on updates
+```
+
+### 5. Continue Execution
+
+After approval:
+1. Log the approval
+2. Update state to "ready"
+3. Prompt to continue
+
+## Output
+
+### Checkpoint Approval
+```
+## Checkpoint Approved ✓
+
+**Phase:** Planning
+**Approved:** 2024-01-15 10:30:00
+
+### Artifacts Reviewed
+- ✓ `.omgkit/generated/schema.sql`
+- ✓ `.omgkit/generated/api-spec.md`
+
+### Decision Recorded
+Saved to: `.omgkit/memory/decisions/2024-01-15-planning-approval.md`
+
+### Ready to Continue
+
+Next phase: **Foundation**
+- Project scaffolding
+- Database setup
+- UI foundation
+
+---
+
+**Commands:**
+- `/auto:start` - Continue execution
+- `/auto:next --preview` - Preview next action
+```
+
+### Decision Approval
+```
+## Decision Approved ✓
+
+**Decision:** db_index_strategy
+**Description:** Add composite index on users(email, status)
+
+### Applied
+The following will be added during implementation:
+```sql
+CREATE INDEX idx_users_email_status ON users(email, status);
+```
+
+### Recorded
+Decision logged at: `.omgkit/memory/decisions/2024-01-15-db_index_strategy.md`
+
+### Remaining Decisions
+- auth_token_expiry: Set JWT expiry to 24 hours
+
+---
+
+**Commands:**
+- `/auto:approve decision auth_token_expiry` - Approve next
+- `/auto:approve --all` - Approve all remaining
+- `/auto:start` - Continue (pending decisions will prompt)
+```
+
+### Approve All
+```
+## All Items Approved ✓
+
+### Checkpoint
+- ✓ Planning phase
+
+### Decisions (2)
+- ✓ db_index_strategy: Add composite index
+- ✓ auth_token_expiry: 24 hour JWT expiry
+
+### Summary
+- Checkpoints approved: 1
+- Decisions approved: 2
+- All items recorded in memory
+
+### Ready to Continue
+
+---
+
+**Commands:**
+- `/auto:start` - Continue execution
+```
+
+## Nothing to Approve
+
+```
+## No Pending Approvals
+
+Current status: **In Progress**
+
+There are no checkpoints or decisions waiting for approval.
+
+### Current State
+- Phase: Backend
+- Feature: user_authentication
+- Progress: 3/7 steps complete
+
+---
+
+**Commands:**
+- `/auto:status` - View full status
+- `/auto:next` - Preview next action
+```
+
+## Conditional Approval
+
+For complex decisions, you can approve with conditions:
+
+```bash
+/auto:approve decision db_index_strategy --with-note "Also add index on created_at"
+```
+
+Output:
+```
+## Decision Approved with Note ✓
+
+**Decision:** db_index_strategy
+**Note Added:** "Also add index on created_at"
+
+This note will be considered during implementation.
+```
+
+## Approval History
+
+Track all approvals for audit:
+
+```yaml
+# .omgkit/state.yaml
+approval_history:
+  - type: "checkpoint"
+    phase: "discovery"
+    timestamp: "2024-01-15T09:00:00Z"
+  - type: "checkpoint"
+    phase: "planning"
+    timestamp: "2024-01-15T10:30:00Z"
+  - type: "decision"
+    id: "db_index_strategy"
+    timestamp: "2024-01-15T10:31:00Z"
+```