awesome-slash 2.4.3 → 2.5.0

package/plugins/ship/lib/utils/deprecation.js

@@ -0,0 +1,37 @@
+/**
+ * Deprecation Warning Utility
+ * Centralized utility for handling deprecation warnings across the codebase
+ *
+ * @author Avi Fenesh
+ * @license MIT
+ */
+
+// Track which functions have already shown deprecation warnings (once per function)
+const _deprecationWarned = new Set();
+
+/**
+ * Show deprecation warning for sync functions (once per function name)
+ * @param {string} funcName - Name of the deprecated sync function
+ * @param {string} asyncAlt - Name of the async alternative
+ */
+function warnDeprecation(funcName, asyncAlt) {
+  if (_deprecationWarned.has(funcName)) return;
+  _deprecationWarned.add(funcName);
+  console.warn(
+    `DEPRECATED: ${funcName}() is synchronous and blocks the event loop. ` +
+    `Use ${asyncAlt}() instead. Will be removed in v3.0.0.`
+  );
+}
+
+/**
+ * Reset deprecation warnings (for testing only)
+ * @private
+ */
+function _resetDeprecationWarnings() {
+  _deprecationWarned.clear();
+}
+
+module.exports = {
+  warnDeprecation,
+  _resetDeprecationWarnings
+};

package/plugins/ship/lib/utils/shell-escape.js

@@ -0,0 +1,88 @@
+/**
+ * Shell Escaping Utilities
+ * Centralized string escaping functions for safe shell command construction
+ *
+ * @module lib/utils/shell-escape
+ * @author Avi Fenesh
+ * @license MIT
+ */
+
+/**
+ * Escape shell special characters for safe command interpolation
+ * Handles all dangerous shell metacharacters including command injection vectors
+ * Optimized: uses single regex test instead of multiple .includes() calls
+ * @param {string} str - String to escape
+ * @returns {string} Escaped string safe for shell use
+ * @throws {Error} If string contains null bytes or newlines
+ */
+function escapeShell(str) {
+  if (typeof str !== 'string') return '';
+
+  // Reject null bytes and newlines which could be used for injection
+  // Optimized: single regex test instead of 3 separate .includes() scans
+  // Use \x00 instead of \0 for better portability across JS engines
+  if (/[\x00\n\r]/.test(str)) {
+    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 '\''
+ * Use this for strings that will be wrapped in single quotes
+ * @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
+ * Removes all non-alphanumeric characters
+ * @param {string} ext - Extension to validate
+ * @returns {string} Safe extension (alphanumeric only), defaults to 'ts' if empty
+ */
+function sanitizeExtension(ext) {
+  if (typeof ext !== 'string') return 'ts';
+  const safe = ext.replace(/[^a-zA-Z0-9]/g, '');
+  return safe || 'ts';
+}
+
+/**
+ * Escape a string for use in a double-quoted shell context
+ * More permissive than escapeShell but still safe
+ * @param {string} str - String to escape
+ * @returns {string} Escaped string safe for double-quoted shell use
+ */
+function escapeDoubleQuotes(str) {
+  if (typeof str !== 'string') return '';
+
+  // In double quotes, we need to escape: $ ` " \ and newlines
+  return str.replace(/[$`"\\\n]/g, '\\$&');
+}
+
+/**
+ * Quote a string for safe shell use
+ * Wraps in single quotes and escapes any embedded single quotes
+ * This is often safer than escapeShell for complex strings
+ * @param {string} str - String to quote
+ * @returns {string} Safely quoted string
+ */
+function quoteShell(str) {
+  if (typeof str !== 'string') return "''";
+
+  // Wrap in single quotes and escape any embedded single quotes
+  return "'" + str.replace(/'/g, "'\\''") + "'";
+}
+
+module.exports = {
+  escapeShell,
+  escapeSingleQuotes,
+  sanitizeExtension,
+  escapeDoubleQuotes,
+  quoteShell
+};

package/lib/state/workflow-state.schema.json

@@ -1,282 +0,0 @@
-{
-  "$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/deslop-around/lib/state/workflow-state.schema.json

@@ -1,282 +0,0 @@
-{
-  "$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" }
-      }
-    }
-  }
-}