awesome-slash 2.4.2

package/plugins/project-review/lib/state/workflow-state.schema.json

@@ -0,0 +1,282 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "workflow-state.schema.json",
+  "title": "Workflow State",
+  "description": "Schema for next-task workflow orchestration state",
+  "type": "object",
+  "required": ["version", "workflow"],
+  "properties": {
+    "version": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$",
+      "description": "Schema version for migrations"
+    },
+    "workflow": {
+      "type": "object",
+      "required": ["id", "type", "status", "startedAt"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "pattern": "^workflow-\\d{8}-\\d{6}-[a-z0-9]+$",
+          "description": "Unique workflow identifier"
+        },
+        "type": {
+          "type": "string",
+          "enum": ["next-task", "ship", "manual"],
+          "description": "Workflow type"
+        },
+        "status": {
+          "type": "string",
+          "enum": ["pending", "in_progress", "paused", "completed", "failed", "aborted"],
+          "description": "Current workflow status"
+        },
+        "startedAt": {
+          "type": "string",
+          "format": "date-time",
+          "description": "Workflow start timestamp"
+        },
+        "lastUpdatedAt": {
+          "type": "string",
+          "format": "date-time",
+          "description": "Last state update timestamp"
+        },
+        "completedAt": {
+          "type": ["string", "null"],
+          "format": "date-time",
+          "description": "Workflow completion timestamp"
+        }
+      }
+    },
+    "policy": {
+      "type": "object",
+      "properties": {
+        "taskSource": {
+          "type": "string",
+          "enum": ["defaults", "gh-issues", "linear", "tasks-md", "custom"],
+          "default": "gh-issues"
+        },
+        "priorityFilter": {
+          "type": "string",
+          "enum": ["continue", "bugs", "security", "features", "all"],
+          "default": "continue"
+        },
+        "platform": {
+          "type": "string",
+          "enum": ["detected", "manual"],
+          "default": "detected"
+        },
+        "stoppingPoint": {
+          "type": "string",
+          "enum": ["implemented", "pr-created", "all-green", "merged", "deployed", "production"],
+          "default": "merged"
+        },
+        "mergeStrategy": {
+          "type": "string",
+          "enum": ["squash", "merge", "rebase"],
+          "default": "squash"
+        },
+        "autoFix": {
+          "type": "boolean",
+          "default": true
+        },
+        "maxReviewIterations": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 10,
+          "default": 3
+        }
+      }
+    },
+    "task": {
+      "type": ["object", "null"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "Task identifier (issue number, Linear ID, etc.)"
+        },
+        "source": {
+          "type": "string",
+          "enum": ["github", "linear", "tasks-md", "manual"]
+        },
+        "title": {
+          "type": "string"
+        },
+        "description": {
+          "type": "string"
+        },
+        "labels": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "url": {
+          "type": ["string", "null"],
+          "format": "uri"
+        },
+        "linearId": {
+          "type": ["string", "null"]
+        }
+      }
+    },
+    "git": {
+      "type": ["object", "null"],
+      "properties": {
+        "originalBranch": {
+          "type": "string",
+          "description": "Branch before workflow started"
+        },
+        "workingBranch": {
+          "type": "string",
+          "description": "Feature branch for this task"
+        },
+        "worktreePath": {
+          "type": ["string", "null"],
+          "description": "Path to worktree if using isolated development"
+        },
+        "baseSha": {
+          "type": "string",
+          "description": "Base commit SHA when branched"
+        },
+        "currentSha": {
+          "type": "string",
+          "description": "Current HEAD commit SHA"
+        },
+        "isWorktree": {
+          "type": "boolean",
+          "default": false
+        }
+      }
+    },
+    "pr": {
+      "type": ["object", "null"],
+      "properties": {
+        "number": {
+          "type": "integer"
+        },
+        "url": {
+          "type": "string",
+          "format": "uri"
+        },
+        "state": {
+          "type": "string",
+          "enum": ["draft", "open", "merged", "closed"]
+        },
+        "ciStatus": {
+          "type": "string",
+          "enum": ["pending", "running", "success", "failure", "unknown"]
+        },
+        "reviewState": {
+          "type": "string",
+          "enum": ["pending", "changes_requested", "approved", "dismissed"]
+        },
+        "lastCheckedAt": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "checksWaitingCount": {
+          "type": "integer",
+          "default": 0
+        }
+      }
+    },
+    "phases": {
+      "type": "object",
+      "properties": {
+        "current": {
+          "type": "string",
+          "enum": [
+            "policy-selection",
+            "task-discovery",
+            "worktree-setup",
+            "exploration",
+            "planning",
+            "user-approval",
+            "implementation",
+            "review-loop",
+            "delivery-approval",
+            "ship-prep",
+            "create-pr",
+            "ci-wait",
+            "comment-fix",
+            "merge",
+            "production-ci",
+            "deploy",
+            "production-release",
+            "complete"
+          ]
+        },
+        "currentIteration": {
+          "type": "integer",
+          "minimum": 0,
+          "default": 0
+        },
+        "history": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": ["phase", "status", "startedAt"],
+            "properties": {
+              "phase": { "type": "string" },
+              "status": {
+                "type": "string",
+                "enum": ["pending", "in_progress", "completed", "failed", "skipped"]
+              },
+              "startedAt": { "type": "string", "format": "date-time" },
+              "completedAt": { "type": ["string", "null"], "format": "date-time" },
+              "duration": { "type": "integer", "description": "Duration in milliseconds" },
+              "iteration": { "type": "integer" },
+              "result": { "type": "object" }
+            }
+          }
+        }
+      }
+    },
+    "agents": {
+      "type": ["object", "null"],
+      "properties": {
+        "lastRun": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "object",
+            "properties": {
+              "status": { "type": "string", "enum": ["pending", "running", "completed", "failed"] },
+              "issues": { "type": "integer" },
+              "critical": { "type": "integer" },
+              "high": { "type": "integer" }
+            }
+          }
+        },
+        "totalIterations": { "type": "integer", "default": 0 },
+        "totalIssuesFound": { "type": "integer", "default": 0 },
+        "totalIssuesFixed": { "type": "integer", "default": 0 }
+      }
+    },
+    "checkpoints": {
+      "type": "object",
+      "properties": {
+        "canResume": {
+          "type": "boolean",
+          "default": true
+        },
+        "resumeFrom": {
+          "type": ["string", "null"],
+          "description": "Phase to resume from"
+        },
+        "resumeContext": {
+          "type": ["object", "null"],
+          "description": "Additional context needed for resume"
+        }
+      }
+    },
+    "metrics": {
+      "type": ["object", "null"],
+      "properties": {
+        "totalDuration": { "type": "integer", "description": "Total duration in milliseconds" },
+        "tokensUsed": { "type": "integer" },
+        "toolCalls": { "type": "integer" },
+        "filesModified": { "type": "integer" },
+        "linesAdded": { "type": "integer" },
+        "linesRemoved": { "type": "integer" }
+      }
+    }
+  }
+}

package/plugins/project-review/lib/utils/context-optimizer.js

@@ -0,0 +1,222 @@
+/**
+ * Context Optimizer Utilities
+ * Provides optimized git commands to minimize token usage while gathering context
+ *
+ * Target: Keep command execution under 50k tokens
+ *
+ * @author Avi Fenesh
+ * @license MIT
+ */
+
+/**
+ * Escape shell special characters for safe command interpolation
+ * @param {string} str - String to escape
+ * @returns {string} Escaped string safe for shell use
+ */
+function escapeShell(str) {
+  if (typeof str !== 'string') return '';
+  // Escape characters that have special meaning in shell
+  return str.replace(/["$`\\!]/g, '\\$&');
+}
+
+/**
+ * Escape single quotes for shell (replace ' with '\''
+ * @param {string} str - String to escape
+ * @returns {string} Escaped string safe for single-quoted shell use
+ */
+function escapeSingleQuotes(str) {
+  if (typeof str !== 'string') return '';
+  return str.replace(/'/g, "'\\''");
+}
+
+/**
+ * Validate and sanitize file extension
+ * @param {string} ext - Extension to validate
+ * @returns {string} Safe extension (alphanumeric only)
+ */
+function sanitizeExtension(ext) {
+  if (typeof ext !== 'string') return 'ts';
+  const safe = ext.replace(/[^a-zA-Z0-9]/g, '');
+  return safe || 'ts';
+}
+
+/**
+ * Git command optimization utilities for context efficiency
+ */
+const contextOptimizer = {
+  /**
+   * Get recent commits with minimal formatting
+   * @param {number} limit - Number of commits to retrieve (default: 10)
+   * @returns {string} Git command
+   */
+  recentCommits: (limit = 10) =>
+    `git log --oneline --no-decorate -${limit} --format="%h %s"`,
+
+  /**
+   * Get compact git status (untracked files excluded)
+   * @returns {string} Git command
+   */
+  compactStatus: () =>
+    'git status -uno --porcelain',
+
+  /**
+   * Get file changes between refs
+   * @param {string} ref - Reference to compare from (default: 'HEAD~5')
+   * @returns {string} Git command
+   */
+  fileChanges: (ref = 'HEAD~5') =>
+    `git diff ${ref}..HEAD --name-status`,
+
+  /**
+   * Get current branch name
+   * @returns {string} Git command
+   */
+  currentBranch: () =>
+    'git branch --show-current',
+
+  /**
+   * Get remote information (limited to 2 lines)
+   * @returns {string} Git command
+   */
+  remoteInfo: () =>
+    'git remote -v | head -2',
+
+  /**
+   * Check if there are stashed changes
+   * @returns {string} Git command
+   */
+  hasStashes: () =>
+    'git stash list --oneline | wc -l',
+
+  /**
+   * Get worktree list in porcelain format
+   * @returns {string} Git command
+   */
+  worktreeList: () =>
+    'git worktree list --porcelain',
+
+  /**
+   * Get the age of a specific line (for TODO checking)
+   * @param {string} file - File path
+   * @param {number} line - Line number
+   * @returns {string} Git command
+   */
+  lineAge: (file, line) => {
+    // Validate line is a positive integer
+    const lineNum = parseInt(line, 10);
+    if (!Number.isInteger(lineNum) || lineNum < 1) {
+      throw new Error('Line must be a positive integer');
+    }
+    // Escape file path for safe shell usage
+    const safeFile = escapeShell(file);
+    return `git blame -L ${lineNum},${lineNum} "${safeFile}" --porcelain | grep '^committer-time' | cut -d' ' -f2`;
+  },
+
+  /**
+   * Find source files by extension
+   * @param {string} extension - File extension (e.g., 'ts', 'py', 'rs')
+   * @returns {string} Git command
+   */
+  findSourceFiles: (extension = 'ts') => {
+    const safeExt = sanitizeExtension(extension);
+    return `git ls-files | grep '\\.${safeExt}$'`;
+  },
+
+  /**
+   * Get diff stat summary
+   * @param {string} ref - Reference to compare from (default: 'HEAD~5')
+   * @returns {string} Git command
+   */
+  diffStat: (ref = 'HEAD~5') =>
+    `git diff ${ref}..HEAD --stat | head -20`,
+
+  /**
+   * Get contributors list (limited to top 10)
+   * @returns {string} Git command
+   */
+  contributors: () =>
+    'git shortlog -sn --no-merges | head -10',
+
+  /**
+   * Get last commit message
+   * @returns {string} Git command
+   */
+  lastCommitMessage: () =>
+    'git log -1 --format=%s',
+
+  /**
+   * Get files changed in last commit
+   * @returns {string} Git command
+   */
+  lastCommitFiles: () =>
+    'git diff-tree --no-commit-id --name-only -r HEAD',
+
+  /**
+   * Get branch list (local only, limited)
+   * @param {number} limit - Number of branches (default: 10)
+   * @returns {string} Git command
+   */
+  branches: (limit = 10) =>
+    `git branch --format='%(refname:short)' | head -${limit}`,
+
+  /**
+   * Get tags list (limited)
+   * @param {number} limit - Number of tags (default: 10)
+   * @returns {string} Git command
+   */
+  tags: (limit = 10) =>
+    `git tag --sort=-creatordate | head -${limit}`,
+
+  /**
+   * Get count of commits on current branch since branching from main
+   * @param {string} mainBranch - Main branch name (default: 'main')
+   * @returns {string} Git command
+   */
+  commitsSinceBranch: (mainBranch = 'main') =>
+    `git rev-list --count ${mainBranch}..HEAD`,
+
+  /**
+   * Check if working directory is clean
+   * @returns {string} Git command
+   */
+  isClean: () =>
+    'git status --porcelain | wc -l',
+
+  /**
+   * Get merge base with main branch
+   * @param {string} mainBranch - Main branch name (default: 'main')
+   * @returns {string} Git command
+   */
+  mergeBase: (mainBranch = 'main') =>
+    `git merge-base ${mainBranch} HEAD`,
+
+  /**
+   * Get files modified in current branch (since branching)
+   * @param {string} mainBranch - Main branch name (default: 'main')
+   * @returns {string} Git command
+   */
+  branchChangedFiles: (mainBranch = 'main') =>
+    `git diff ${mainBranch}...HEAD --name-only`,
+
+  /**
+   * Get commit count by author
+   * @param {string} author - Author name or email
+   * @returns {string} Git command
+   */
+  authorCommitCount: (author) => {
+    const safeAuthor = escapeShell(author);
+    return `git log --author="${safeAuthor}" --oneline | wc -l`;
+  },
+
+  /**
+   * Check if file exists in repository
+   * @param {string} file - File path
+   * @returns {string} Git command
+   */
+  fileExists: (file) => {
+    const safeFile = escapeSingleQuotes(file);
+    return `git ls-files | grep -q '${safeFile}' && echo 'true' || echo 'false'`;
+  }
+};
+
+module.exports = contextOptimizer;

package/plugins/reality-check/.claude-plugin/plugin.json

@@ -0,0 +1,23 @@
+{
+  "name": "reality-check",
+  "version": "1.0.0",
+  "description": "Deep repository analysis to realign project plans with actual code reality - discovers drift, gaps, and produces prioritized reconstruction plans",
+  "author": {
+    "name": "Avi Fenesh",
+    "email": "[email protected]",
+    "url": "https://github.com/avifenesh"
+  },
+  "homepage": "https://github.com/avifenesh/awesome-slash#reality-check",
+  "repository": "https://github.com/avifenesh/awesome-slash",
+  "license": "MIT",
+  "keywords": [
+    "planning",
+    "reality-check",
+    "drift-detection",
+    "prioritization",
+    "exploration",
+    "documentation",
+    "github-issues",
+    "project-management"
+  ]
+}

package/plugins/reality-check/README.md

@@ -0,0 +1,156 @@
+# reality-check
+
+Deep repository analysis to realign project plans with actual code reality.
+
+## Overview
+
+The reality-check plugin performs comprehensive analysis of your codebase to identify drift between documented plans and actual implementation. It scans GitHub issues, documentation files, and code structure to produce a prioritized reconstruction plan.
+
+## Features
+
+- **Multi-source scanning**: Analyzes GitHub issues, documentation, and codebase in parallel
+- **Drift detection**: Identifies where plans have diverged from reality
+- **Gap analysis**: Finds missing tests, documentation, and implementation
+- **Priority ranking**: Uses configurable weights to prioritize work items
+- **Interactive setup**: First-run wizard with checkbox configuration
+- **Configurable settings**: Persistent settings in `.claude/reality-check.local.md`
+
+## Commands
+
+### `/reality-check:scan`
+
+Run a comprehensive reality check scan.
+
+```
+/reality-check:scan
+```
+
+On first run, presents interactive checkboxes to configure:
+- Data sources (GitHub issues, docs, Linear, code exploration)
+- Scan depth (quick, medium, thorough)
+- Output format (file, display, both)
+
+### `/reality-check:set`
+
+Configure or update settings interactively.
+
+```
+/reality-check:set
+```
+
+## Agents
+
+| Agent | Purpose | Model |
+|-------|---------|-------|
+| `issue-scanner` | Scans GitHub issues, PRs, milestones | sonnet |
+| `doc-analyzer` | Analyzes documentation files | sonnet |
+| `code-explorer` | Deep codebase structure analysis | sonnet |
+| `plan-synthesizer` | Combines findings, creates plan | opus |
+
+## Workflow
+
+```
+/reality-check:scan
+        │
+        ▼
+┌───────────────────┐
+│  Settings Check   │ ← First-run setup if needed
+└───────────────────┘
+        │
+        ├──────────────────┬──────────────────┐
+        ▼                  ▼                  ▼
+┌──────────────┐   ┌──────────────┐   ┌──────────────┐
+│ Issue Scanner│   │ Doc Analyzer │   │ Code Explorer│
+└──────────────┘   └──────────────┘   └──────────────┘
+        │                  │                  │
+        └──────────────────┴──────────────────┘
+                           │
+                           ▼
+                ┌──────────────────┐
+                │ Plan Synthesizer │
+                └──────────────────┘
+                           │
+                           ▼
+              Prioritized Reality Report
+```
+
+## Configuration
+
+Settings are stored in `.claude/reality-check.local.md`:
+
+```yaml
+---
+sources:
+  github_issues: true
+  linear: false
+  docs_paths: ["docs/", "README.md", "CLAUDE.md"]
+  code_exploration: true
+scan_depth: thorough
+output:
+  write_to_file: true
+  file_path: "reality-check-report.md"
+  display_summary: true
+priority_weights:
+  security: 10
+  bugs: 8
+  features: 5
+  docs: 3
+exclusions:
+  paths: ["node_modules/", "dist/"]
+  labels: ["wontfix", "duplicate"]
+---
+```
+
+## Output
+
+The scan produces:
+
+1. **Drift Analysis**: Where plans diverge from reality
+2. **Gap Analysis**: Missing tests, docs, implementation
+3. **Cross-Reference**: Documented vs. implemented features
+4. **Reconstruction Plan**: Prioritized action items
+
+### Example Output
+
+```markdown
+## Reality Check Complete
+
+### Summary
+- Drift Areas: 4
+- Gaps Found: 7
+- Critical Items: 2
+- Aligned Features: 8
+
+### Immediate Actions (This Week)
+1. Address 3 open security vulnerabilities
+2. Fix stale milestone "v2.0" (45 days overdue)
+
+### Short-Term (This Month)
+1. Add test coverage (0% currently)
+2. Update outdated documentation
+3. Close 8 stale priority issues
+```
+
+## Skills
+
+### reality-analysis
+
+Provides knowledge for:
+- Drift detection patterns
+- Prioritization framework
+- Cross-reference matching
+- Output templates
+
+## Requirements
+
+- GitHub CLI (`gh`) for issue scanning
+- Git repository
+- Node.js for state management
+
+## Installation
+
+The plugin is part of the awesome-slash marketplace. Enable it in your Claude Code settings.
+
+## License
+
+MIT