omgkit 2.23.0 → 2.24.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "omgkit",
-  "version": "2.23.0",
-  "description": "Omega-Level Development Kit - AI Team System for Claude Code. 41 agents, 151 commands, 157 skills, 67 workflows.",
+  "version": "2.24.0",
+  "description": "Omega-Level Development Kit - AI Team System for Claude Code. 41 agents, 156 commands, 157 skills, 68 workflows.",
   "keywords": [
     "claude-code",
     "ai",

package/plugin/commands/hooks/run.md

@@ -0,0 +1,144 @@
+---
+name: hooks:run
+description: Manually run Git hook actions for testing or debugging, without triggering an actual Git operation.
+category: hooks
+---
+
+# /hooks:run
+
+Manually execute Git hook actions for testing or debugging.
+
+## Usage
+
+```bash
+# Run all actions for a hook
+/hooks:run pre-commit
+/hooks:run commit-msg
+/hooks:run pre-push
+
+# Run specific action only
+/hooks:run pre-commit --action=lint
+/hooks:run pre-commit --action=format
+/hooks:run pre-push --action=test
+
+# Run on specific files
+/hooks:run pre-commit --files="src/app.ts,src/utils.ts"
+
+# Verbose output
+/hooks:run pre-commit --verbose
+```
+
+## Available Hooks
+
+### pre-commit
+
+```bash
+/hooks:run pre-commit
+
+# Actions:
+# - lint: Run linter on staged files
+# - format: Format staged files
+# - type-check: Run type checker
+# - secrets-check: Detect leaked secrets
+```
+
+### commit-msg
+
+```bash
+/hooks:run commit-msg
+
+# Validates last commit message
+# Or provide message:
+/hooks:run commit-msg --message="feat: add login"
+```
+
+### pre-push
+
+```bash
+/hooks:run pre-push
+
+# Actions:
+# - test: Run test suite
+# - security-scan: Run security audit
+# - build: Verify build works
+```
+
+## Output
+
+```
+Running pre-commit hooks
+========================
+
+Action: lint
+  Running: npx eslint src/
+  ✓ Passed (0 errors, 2 warnings)
+
+Action: format
+  Running: npx prettier --check src/
+  ✓ All files formatted
+
+Action: type-check
+  Running: npx tsc --noEmit
+  ✓ No type errors
+
+Summary: 3/3 actions passed
+```
+
+## Use Cases
+
+### Test Before Commit
+
+```bash
+# Make sure hooks will pass
+/hooks:run pre-commit
+
+# Then commit
+git commit -m "feat: add feature"
+```
+
+### Debug Failing Hook
+
+```bash
+# Run with verbose output
+/hooks:run pre-commit --verbose
+
+# Run specific failing action
+/hooks:run pre-commit --action=lint
+```
+
+### Validate Commit Message
+
+```bash
+# Check if message is valid
+/hooks:run commit-msg --message="fix: resolve bug"
+
+# Output:
+# ✓ Valid conventional commit
+# Type: fix
+# Subject: resolve bug
+```
+
+### Run Tests Before Push
+
+```bash
+# Full pre-push check
+/hooks:run pre-push
+
+# Just tests
+/hooks:run pre-push --action=test
+```
+
+## Exit Codes
+
+| Code | Meaning |
+|------|---------|
+| 0 | All actions passed |
+| 1 | One or more actions failed |
+| 2 | Config error or invalid hook |
+
+## Related Commands
+
+- `/hooks:setup` - Install/update hooks
+- `/workflow:status` - Check workflow status
+- `/dev:test` - Run tests
+- `/quality:lint` - Run linter

package/plugin/commands/hooks/setup.md

@@ -0,0 +1,174 @@
+---
+name: hooks:setup
+description: Install or update Git hooks based on workflow configuration, creating executable hook scripts in .git/hooks/.
+category: hooks
+---
+
+# /hooks:setup
+
+Install Git hooks from your workflow configuration.
+
+## Usage
+
+```bash
+# Install all hooks from config
+/hooks:setup
+
+# Install specific hook only
+/hooks:setup --hook=pre-commit
+/hooks:setup --hook=commit-msg
+/hooks:setup --hook=pre-push
+
+# Force overwrite existing hooks
+/hooks:setup --force
+
+# Dry run (show what would be created)
+/hooks:setup --dry-run
+
+# Remove all hooks
+/hooks:setup --remove
+```
+
+## What It Does
+
+1. **Reads config** from `.omgkit/workflow.yaml`
+2. **Generates hook scripts** based on settings
+3. **Installs to `.git/hooks/`** with execute permissions
+4. **Validates installation**
+
+## Generated Hooks
+
+### pre-commit
+
+Runs before each commit:
+
+```yaml
+hooks:
+  pre_commit:
+    enabled: true
+    actions:
+      - lint        # ESLint, Pylint, etc.
+      - format      # Prettier, Black, etc.
+      - type-check  # TypeScript, mypy, etc.
+```
+
+### commit-msg
+
+Validates commit message:
+
+```yaml
+hooks:
+  commit_msg:
+    enabled: true
+    validate_conventional: true
+    max_length: 72
+```
+
+### pre-push
+
+Runs before push:
+
+```yaml
+hooks:
+  pre_push:
+    enabled: true
+    actions:
+      - test           # Run tests
+      - security-scan  # npm audit, safety
+```
+
+### post-merge
+
+Runs after git pull/merge:
+
+```yaml
+hooks:
+  post_merge:
+    enabled: true
+    actions:
+      - install  # npm install
+```
+
+## Output
+
+```
+Installing Git Hooks
+====================
+
+Reading config from .omgkit/workflow.yaml...
+
+Creating hooks:
+  ✓ pre-commit (lint, format, type-check)
+  ✓ commit-msg (conventional validation)
+  ✓ pre-push (test, security-scan)
+  - post-merge (disabled in config)
+
+Setting permissions...
+  ✓ .git/hooks/pre-commit (755)
+  ✓ .git/hooks/commit-msg (755)
+  ✓ .git/hooks/pre-push (755)
+
+Done! 3 hooks installed.
+
+Test with: /hooks:run pre-commit
+```
+
+## Auto-Detection
+
+Hooks auto-detect your project type:
+
+| Project | Lint | Format | Test |
+|---------|------|--------|------|
+| Node.js | `npx eslint` | `npx prettier` | `npm test` |
+| Python | `ruff check` | `black` | `pytest` |
+| Go | `golangci-lint` | `gofmt` | `go test` |
+| Rust | `cargo clippy` | `cargo fmt` | `cargo test` |
+
+## Examples
+
+```bash
+# Initial setup
+/workflow:init
+/hooks:setup
+
+# Update after config change
+/hooks:setup --force
+
+# Check what would be created
+/hooks:setup --dry-run
+
+# Remove hooks
+/hooks:setup --remove
+```
+
+## Troubleshooting
+
+### Permission Denied
+
+```bash
+chmod +x .git/hooks/*
+```
+
+### Hook Not Running
+
+```bash
+# Check hook exists and is executable
+ls -la .git/hooks/pre-commit
+
+# Regenerate
+/hooks:setup --force
+```
+
+### Bypass Temporarily
+
+```bash
+SKIP_HOOKS=1 git commit -m "message"
+# or
+git commit --no-verify -m "message"
+```
+
+## Related Commands
+
+- `/hooks:run` - Manually run hook actions
+- `/workflow:init` - Initialize workflow config
+- `/workflow:status` - Check workflow status

package/plugin/commands/workflow/init.md

@@ -0,0 +1,143 @@
+---
+name: workflow:init
+description: Initialize workflow configuration with interactive setup or preset templates for trunk-based, gitflow, or github-flow development.
+category: workflow
+---
+
+# /workflow:init
+
+Initialize the OMGKIT workflow configuration system in your project.
+
+## Usage
+
+```bash
+# Interactive setup
+/workflow:init
+
+# Use specific workflow preset
+/workflow:init --workflow=trunk-based
+/workflow:init --workflow=gitflow
+/workflow:init --workflow=github-flow
+
+# Use all defaults (trunk-based)
+/workflow:init --defaults
+
+# Force overwrite existing config
+/workflow:init --force
+```
+
+## What It Does
+
+1. **Creates `.omgkit/` directory** if not exists
+2. **Generates `workflow.yaml`** with your preferences
+3. **Sets up Git hooks** based on configuration
+4. **Validates existing setup** and suggests improvements
+
+## Interactive Setup
+
+When run without arguments, guides you through:
+
+1. **Workflow Type**
+   - Trunk-based (recommended for CI/CD)
+   - GitHub Flow (simple, PR-based)
+   - GitFlow (release-based)
+
+2. **Branch Settings**
+   - Main branch name
+   - Branch prefixes
+
+3. **Commit Conventions**
+   - Conventional commits (recommended)
+   - Scope requirements
+
+4. **PR Settings**
+   - Review requirements
+   - Auto-labeling
+
+5. **Hooks**
+   - Pre-commit actions
+   - Pre-push actions
+
+6. **Deployment**
+   - Provider (Vercel, Netlify, etc.)
+   - Auto-deploy settings
+
+## Output Files
+
+```
+.omgkit/
+└── workflow.yaml    # Main configuration
+
+.git/hooks/
+├── pre-commit       # Lint, format, type-check
+├── commit-msg       # Validate conventional commits
+└── pre-push         # Tests, security scan
+```
+
+## Workflow Presets
+
+### Trunk-Based (Default)
+
+Best for: Teams practicing continuous deployment.
+
+```yaml
+git:
+  workflow: trunk-based
+  max_branch_age_days: 2
+hooks:
+  pre_commit: [lint, format, type-check]
+  pre_push: [test, security-scan]
+feature_flags:
+  provider: vercel-edge
+```
+
+### GitHub Flow
+
+Best for: Teams with regular releases, focus on code review.
+
+```yaml
+git:
+  workflow: github-flow
+  max_branch_age_days: 7
+hooks:
+  pre_commit: [lint, format]
+  pre_push: [test]
+```
+
+### GitFlow
+
+Best for: Teams with scheduled releases, multiple environments.
+
+```yaml
+git:
+  workflow: gitflow
+  develop_branch: develop
+hooks:
+  pre_commit: [lint, format, type-check]
+  pre_push: [test, build]
+```
+
+## Examples
+
+```bash
+# Quick setup for a new project
+/workflow:init --workflow=trunk-based
+
+# Setup for enterprise project
+/workflow:init --workflow=gitflow
+
+# Reconfigure existing project
+/workflow:init --force
+```
+
+## After Initialization
+
+1. **Review generated config**: `.omgkit/workflow.yaml`
+2. **Commit config to repo**: `git add .omgkit && git commit -m "chore: add workflow config"`
+3. **Team syncs and runs**: `/hooks:setup`
+
+## Related Commands
+
+- `/workflow:status` - Check current workflow status
+- `/workflow:trunk-based` - Execute trunk-based workflow
+- `/hooks:setup` - Setup/update Git hooks

package/plugin/commands/workflow/status.md

@@ -0,0 +1,126 @@
+---
+name: workflow:status
+description: Display current workflow configuration status, branch info, and next recommended actions.
+category: workflow
+---
+
+# /workflow:status
+
+Check the current state of your workflow configuration and Git status.
+
+## Usage
+
+```bash
+# Full status
+/workflow:status
+
+# Config only
+/workflow:status --config
+
+# Branch only
+/workflow:status --branch
+
+# Hooks only
+/workflow:status --hooks
+```
+
+## Output
+
+```
+OMGKIT Workflow Status
+======================
+
+Configuration
+-------------
+File: .omgkit/workflow.yaml
+Valid: Yes
+Workflow: trunk-based
+Version: 1.0
+
+Git Status
+----------
+Branch: feature/add-authentication
+Base: main
+Age: 6 hours (max: 48 hours)
+Commits ahead: 3
+Status: Clean
+
+Hooks Status
+------------
+pre-commit: Enabled (lint, format, type-check)
+commit-msg: Enabled (conventional)
+pre-push: Enabled (test, security-scan)
+
+Review Settings
+---------------
+Auto-review: Enabled
+Checks: security, performance, best-practices
+Block on critical: Yes
+
+Deploy Settings
+---------------
+Provider: vercel
+Auto-deploy: Yes
+Preview on PR: Yes
+
+Recommendations
+---------------
+✓ Branch age is within limit
+✓ All hooks are enabled
+! Consider pushing soon (3 commits pending)
+```
+
+## Validation Checks
+
+| Check | Status | Description |
+|-------|--------|-------------|
+| Config exists | ✓/✗ | `.omgkit/workflow.yaml` found |
+| Config valid | ✓/✗ | YAML parses, schema valid |
+| Hooks installed | ✓/✗ | Git hooks in place |
+| Branch age | ✓/! | Within max age limit |
+| Uncommitted changes | ✓/! | Working tree status |
+
+## Error Messages
+
+### Config Not Found
+
+```
+Warning: No workflow config found
+Run /workflow:init to create configuration
+```
+
+### Invalid Config
+
+```
+Error: Invalid workflow config
+- git.workflow: must be trunk-based, gitflow, or github-flow
+- commit.max_subject_length: must be a number
+
+Run /workflow:init --force to regenerate
+```
+
+### Hooks Not Installed
+
+```
+Warning: Git hooks not installed
+Run /hooks:setup to install hooks
+```
+
+## Examples
+
+```bash
+# Quick health check
+/workflow:status
+
+# Verify after setup
+/workflow:init && /workflow:status
+
+# Debug hooks
+/workflow:status --hooks
+```
+
+## Related Commands
+
+- `/workflow:init` - Initialize workflow config
+- `/hooks:setup` - Install Git hooks
+- `/workflow:trunk-based` - Execute workflow