omgkit 2.10.1 → 2.12.0

package/plugin/commands/auto/verify.md

@@ -0,0 +1,353 @@
+---
+description: Run verification checks on autonomous project
+allowed-tools: Read, Bash, Glob, Grep
+argument-hint: "[--full | --quick | --phase <phase>]"
+---
+
+# Verify Autonomous Project
+
+Run comprehensive verification checks on the autonomous project state and artifacts.
+
+## Verification Modes
+
+### Quick Verification
+Fast checks for basic integrity:
+```bash
+/auto:verify --quick
+```
+
+### Full Verification
+Complete verification of all aspects:
+```bash
+/auto:verify --full
+/auto:verify
+```
+
+### Phase Verification
+Verify specific phase artifacts:
+```bash
+/auto:verify --phase planning
+```
+
+## Verification Categories
+
+### 1. State Integrity
+
+Check `.omgkit/state.yaml`:
+- [ ] File exists and is valid YAML
+- [ ] Required fields present (project, phase, status)
+- [ ] Phase matches archetype phases
+- [ ] Progress data is consistent
+- [ ] No orphaned references
+
+### 2. Artifact Verification
+
+For each phase's expected outputs:
+- [ ] File exists
+- [ ] File is not empty
+- [ ] File format is valid (YAML, SQL, MD)
+- [ ] Content matches expected structure
+
+### 3. Code Quality
+
+If code has been generated:
+- [ ] TypeScript compiles without errors
+- [ ] ESLint passes
+- [ ] All tests pass
+- [ ] Coverage meets threshold
+
+### 4. Consistency Checks
+
+- [ ] PRD features match implementation plan
+- [ ] Schema matches models
+- [ ] API spec matches routes
+- [ ] Tests cover documented features
+
+### 5. Memory Integrity
+
+- [ ] Context files are current
+- [ ] Decisions are recorded
+- [ ] Journal entries exist for activities
+
+## Verification Process
+
+### 1. Load Configuration
+
+```yaml
+archetype: "saas-mvp"
+current_phase: "backend"
+quality_gates:
+  - command: "npm test"
+    required: true
+  - coverage_threshold: 80
+```
+
+### 2. Run Checks
+
+Execute each verification category:
+```
+[1/5] State Integrity...
+[2/5] Artifact Verification...
+[3/5] Code Quality...
+[4/5] Consistency Checks...
+[5/5] Memory Integrity...
+```
+
+### 3. Collect Results
+
+```yaml
+verification_results:
+  timestamp: "2024-01-15T10:30:00Z"
+  mode: "full"
+
+  categories:
+    state_integrity:
+      passed: true
+      checks: 5
+      failures: 0
+
+    artifacts:
+      passed: true
+      checks: 8
+      failures: 0
+
+    code_quality:
+      passed: false
+      checks: 4
+      failures: 1
+      details:
+        - check: "coverage"
+          expected: 80
+          actual: 76
+
+    consistency:
+      passed: true
+      checks: 3
+      failures: 0
+
+    memory:
+      passed: true
+      checks: 3
+      failures: 0
+```
+
+## Output
+
+### All Passing
+```
+## Verification Complete ✓
+
+**Mode:** Full
+**Duration:** 12.3s
+
+### Results
+
+| Category | Status | Checks |
+|----------|--------|--------|
+| State Integrity | ✅ Pass | 5/5 |
+| Artifacts | ✅ Pass | 8/8 |
+| Code Quality | ✅ Pass | 4/4 |
+| Consistency | ✅ Pass | 3/3 |
+| Memory | ✅ Pass | 3/3 |
+
+**Total:** 23/23 checks passing
+
+### Quality Metrics
+- Test Coverage: 84% (threshold: 80%)
+- TypeScript: No errors
+- ESLint: No warnings
+
+### Project Health: Excellent 🟢
+
+---
+
+**Commands:**
+- `/auto:start` - Continue execution
+- `/auto:status` - View full status
+```
+
+### With Failures
+```
+## Verification Complete ⚠️
+
+**Mode:** Full
+**Duration:** 15.7s
+
+### Results
+
+| Category | Status | Checks |
+|----------|--------|--------|
+| State Integrity | ✅ Pass | 5/5 |
+| Artifacts | ✅ Pass | 8/8 |
+| Code Quality | ⚠️ Fail | 3/4 |
+| Consistency | ✅ Pass | 3/3 |
+| Memory | ✅ Pass | 3/3 |
+
+**Total:** 22/23 checks passing
+
+### Failures
+
+#### Code Quality: Coverage Below Threshold
+
+**Expected:** 80%
+**Actual:** 76%
+
+**Uncovered Files:**
+- `src/services/payment.service.ts` (62%)
+- `src/utils/validation.ts` (71%)
+
+**Suggested Fix:**
+Add tests for payment service and validation utilities.
+
+### Project Health: Needs Attention 🟡
+
+---
+
+**Actions Required:**
+1. Increase test coverage to 80%
+2. Run `/auto:verify` again after fixes
+
+**Commands:**
+- `/auto:verify --quick` - Quick re-check
+- `npm test -- --coverage` - Run tests with coverage
+```
+
+### Critical Failures
+```
+## Verification Failed ❌
+
+**Mode:** Full
+**Duration:** 8.2s
+
+### Critical Issues Found
+
+#### 1. State Corruption
+
+**Issue:** Phase "backend" not found in archetype
+**File:** `.omgkit/state.yaml`
+
+```yaml
+# Current (invalid)
+phase: "backend"
+
+# Expected (one of)
+phases: ["discovery", "planning", "foundation", "core", ...]
+```
+
+**Fix:** Update phase to valid archetype phase
+
+#### 2. Missing Required Artifact
+
+**Issue:** Schema file not found
+**Expected:** `.omgkit/generated/schema.sql`
+**Phase:** Planning (required output)
+
+**Fix:** Run planning phase or create schema manually
+
+### Project Health: Critical 🔴
+
+---
+
+**Recovery Options:**
+
+1. **Auto-repair** (if possible)
+   ```bash
+   /auto:verify --repair
+   ```
+
+2. **Manual fix**
+   - Fix state.yaml phase value
+   - Create missing schema.sql
+
+3. **Reset to checkpoint**
+   ```bash
+   /auto:resume --from planning
+   ```
+
+**Commands:**
+- `/auto:status --verbose` - Detailed state info
+- `/auto:resume --from discovery` - Restart from known good state
+```
+
+## Quick Verification Output
+
+```
+## Quick Verification ✓
+
+**Duration:** 2.1s
+
+### Essential Checks
+- ✅ State file valid
+- ✅ Current phase valid
+- ✅ No blocking errors
+- ✅ Tests passing
+
+**Status:** Ready to continue
+
+---
+
+Run `/auto:verify --full` for comprehensive check.
+```
+
+## Phase Verification Output
+
+```
+## Phase Verification: Planning ✓
+
+**Duration:** 4.3s
+
+### Expected Outputs
+- ✅ `.omgkit/generated/prd.md` (12.4 KB)
+- ✅ `.omgkit/generated/schema.sql` (3.2 KB)
+- ✅ `.omgkit/generated/api-spec.md` (8.7 KB)
+
+### Validation
+- ✅ PRD has all required sections
+- ✅ Schema is valid SQL
+- ✅ API spec follows OpenAPI format
+
+### Quality Gates
+- ✅ Schema validation passed
+- ✅ API spec validation passed
+
+**Phase Status:** Complete and verified
+
+---
+
+**Commands:**
+- `/auto:approve` - Approve this phase
+- `/auto:verify --phase foundation` - Verify next phase
+```
+
+## Repair Mode
+
+Attempt automatic repairs for recoverable issues:
+
+```bash
+/auto:verify --repair
+```
+
+```
+## Verification with Repair
+
+### Issues Found: 2
+### Auto-repairable: 1
+
+#### Repaired ✓
+
+1. **State Progress Inconsistency**
+   - Issue: steps_completed count mismatch
+   - Fix: Recalculated from actual completed steps
+   - Result: Updated state.yaml
+
+#### Manual Repair Needed
+
+2. **Missing Test File**
+   - Issue: `user.service.test.ts` referenced but not found
+   - Cannot auto-repair: Test content unknown
+   - Action: Create test file or remove reference
+
+---
+
+**Verification After Repair:** 22/23 passing
+```

package/plugin/skills/autonomous/project-orchestration/SKILL.md

@@ -0,0 +1,332 @@
+---
+name: Project Orchestration
+description: Orchestrate autonomous project development through state-driven execution
+category: autonomous
+tools:
+  - Task
+  - Read
+  - Write
+  - Edit
+  - Bash
+  - Glob
+  - Grep
+  - AskUserQuestion
+---
+
+# Project Orchestration Skill
+
+Orchestrate autonomous project development through state-driven execution.
+
+## Overview
+
+The Project Orchestration skill provides the core functionality for managing
+autonomous project development. It handles state transitions, phase execution,
+checkpoint management, and quality enforcement.
+
+## Capabilities
+
+### State Management
+
+```yaml
+# Read current state
+state = load_state(".omgkit/state.yaml")
+
+# Update state
+update_state({
+  phase: "backend",
+  status: "in_progress",
+  progress: {
+    current_feature: "user_auth"
+  }
+})
+
+# Transition state
+transition_state("in_progress", "checkpoint")
+```
+
+### Phase Execution
+
+Execute phases according to archetype definition:
+
+1. **Discovery Phase** - Requirements gathering via interview
+2. **Planning Phase** - Generate specifications and schema
+3. **Foundation Phase** - Project scaffolding and setup
+4. **Core Phases** - Feature implementation (dynamic)
+5. **Hardening Phase** - Security and performance
+6. **Deployment Phase** - Production release
+
+### Checkpoint Management
+
+```yaml
+# Create checkpoint
+create_checkpoint({
+  type: "phase",
+  phase: "planning",
+  artifacts: ["schema.sql", "api-spec.md"]
+})
+
+# Check for pending checkpoint
+if has_pending_checkpoint():
+  wait_for_approval()
+
+# Approve checkpoint
+approve_checkpoint()
+
+# Reject with feedback
+reject_checkpoint("Need soft delete columns")
+```
+
+### Decision Framework
+
+Classify and handle decisions by autonomy level:
+
+| Level | Action | Example |
+|-------|--------|---------|
+| 0 | Auto-execute | Code formatting |
+| 1 | Execute + notify | Add dependency |
+| 2 | Preview + quick approve | Database index |
+| 3 | Full review | Auth approach |
+| 4 | Human does it | API credentials |
+
+### Quality Gates
+
+Run quality checks between phases and features:
+
+```yaml
+quality_gates:
+  after_feature:
+    - npm test
+    - npm run lint
+
+  before_checkpoint:
+    - npm run build
+    - coverage >= 80%
+
+  before_deploy:
+    - security_scan
+    - performance_test
+```
+
+## Usage
+
+### Initialize Project
+
+```bash
+# Start discovery interview
+/auto:init my-saas-app
+
+# Generates:
+# - .omgkit/state.yaml
+# - .omgkit/generated/prd.md
+# - .omgkit/generated/discovery-answers.yaml
+```
+
+### Start Execution
+
+```bash
+# Begin autonomous execution
+/auto:start
+
+# Execution flow:
+# 1. Load state and archetype
+# 2. Execute current phase
+# 3. Run quality gates
+# 4. Update progress
+# 5. Create checkpoint if needed
+```
+
+### Monitor Progress
+
+```bash
+# Check status
+/auto:status
+
+# Preview next action
+/auto:next
+
+# Run verification
+/auto:verify
+```
+
+### Handle Checkpoints
+
+```bash
+# At checkpoint, review artifacts then:
+/auto:approve          # Continue
+/auto:reject "reason"  # Request changes
+```
+
+### Resume After Interruption
+
+```bash
+# Resume from saved state
+/auto:resume
+
+# Retry failed step
+/auto:resume --retry
+
+# Skip problematic step
+/auto:resume --skip
+```
+
+## State Machine
+
+```
+┌─────────┐    start    ┌─────────────┐
+│  ready  │────────────►│ in_progress │
+└─────────┘             └──────┬──────┘
+     ▲                         │
+     │ approve                 │ phase_complete
+     │                         │ decision_required
+     │                         │ quality_fail
+┌─────────────┐                │
+│ checkpoint  │◄───────────────┘
+└─────────────┘
+     │
+     │ reject
+     ▼
+┌─────────────────┐
+│ revision_needed │
+└─────────────────┘
+
+┌─────────────┐    error    ┌─────────┐
+│ in_progress │────────────►│ blocked │
+└─────────────┘             └─────────┘
+                                 │
+                                 │ resume/skip
+                                 ▼
+                            ┌─────────────┐
+                            │ in_progress │
+                            └─────────────┘
+
+┌─────────────┐  all_complete  ┌───────────┐
+│ in_progress │───────────────►│ completed │
+└─────────────┘                └───────────┘
+```
+
+## Memory Integration
+
+### Context Files
+
+Maintain current context in `.omgkit/memory/context/`:
+
+- `project-brief.md` - Project overview
+- `current-feature.md` - Active feature details
+- `tech-stack.md` - Technology decisions
+
+### Decision Log
+
+Record all decisions in `.omgkit/memory/decisions/`:
+
+```markdown
+# Decision: Authentication Approach
+
+**Date:** 2024-01-15
+**Status:** Approved
+
+## Context
+Need to implement user authentication.
+
+## Options Considered
+1. Session-based auth
+2. JWT with refresh tokens
+3. OAuth only
+
+## Decision
+JWT with refresh tokens
+
+## Rationale
+- Stateless for scalability
+- Works with mobile apps
+- Standard approach
+```
+
+### Journal
+
+Track daily progress in `.omgkit/memory/journal/`:
+
+```markdown
+# 2024-01-15 Development Journal
+
+## Summary
+Completed planning phase, started backend implementation.
+
+## Completed
+- Database schema design
+- API specification
+- User model implementation
+
+## Challenges
+- Decided on password hashing approach
+- Resolved dependency conflict
+
+## Tomorrow
+- Complete auth service
+- Add unit tests
+```
+
+## Error Recovery
+
+### Test Failure Recovery
+
+1. Analyze failure message
+2. Identify failing test
+3. Check related code
+4. Attempt auto-fix if confidence > 70%
+5. Retry tests
+6. Block if still failing after 2 attempts
+
+### Build Failure Recovery
+
+1. Parse build error
+2. Check for common issues
+3. Fix imports, types, syntax
+4. Retry build
+5. Block if unfixable
+
+### External Failure Recovery
+
+1. Identify external service
+2. Retry with exponential backoff
+3. Max 3 retries
+4. Block and report if persistent
+
+## Configuration
+
+### Archetype Selection
+
+Based on project type, select appropriate archetype:
+
+| Project Type | Archetype | Phases |
+|-------------|-----------|--------|
+| SaaS | saas-mvp | 7 phases |
+| API | api-service | 6 phases |
+| CLI | cli-tool | 5 phases |
+| Library | library | 6 phases |
+| Full-stack | fullstack-app | 8 phases |
+
+### Autonomy Overrides
+
+Configure autonomy levels in state:
+
+```yaml
+autonomy:
+  default_level: 1
+  overrides:
+    - pattern: "**/migrations/**"
+      level: 3
+    - pattern: "**/auth/**"
+      level: 3
+    - pattern: "**/tests/**"
+      level: 0
+```
+
+## Best Practices
+
+1. **Always save state** after significant actions
+2. **Run quality gates** before checkpoints
+3. **Record decisions** for future reference
+4. **Update memory** as context changes
+5. **Handle errors gracefully** with recovery options
+6. **Respect autonomy levels** for sensitive operations
+7. **Provide clear progress** updates to user