awesome-slash 2.4.2

package/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/lib/utils/context-optimizer.js

@@ -0,0 +1,227 @@
+/**
+ * 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
+ * Handles all dangerous shell metacharacters including command injection vectors
+ * @param {string} str - String to escape
+ * @returns {string} Escaped string safe for shell use
+ */
+function escapeShell(str) {
+  if (typeof str !== 'string') return '';
+  // Reject null bytes and newlines which could be used for injection
+  if (str.includes('\0') || str.includes('\n') || str.includes('\r')) {
+    throw new Error('Input contains invalid characters (null bytes or newlines)');
+  }
+  // Escape all shell metacharacters: " $ ` \ ! ; | & > < ( ) { } [ ] * ? ~ # ' space tab
+  return str.replace(/["\$`\\!;|&><(){}[\]*?~#'\s]/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;