awesome-slash 3.2.1 → 3.3.0

package/.claude-plugin/marketplace.json

@@ -1,7 +1,7 @@
 {
   "name": "awesome-slash",
   "description": "8 specialized plugins for AI workflow automation - task orchestration, PR workflow, slop detection, code review, drift detection, enhancement analysis, documentation sync, and repo mapping",
-  "version": "3.2.1",
+  "version": "3.3.0",
   "owner": {
     "name": "Avi Fenesh",
     "url": "https://github.com/avifenesh"
@@ -13,56 +13,56 @@
       "name": "next-task",
       "source": "./plugins/next-task",
       "description": "Master workflow orchestrator: autonomous workflow with model optimization (opus/sonnet/haiku), two-file state management, workflow enforcement gates, 14 specialist agents",
-      "version": "3.2.1",
+      "version": "3.3.0",
       "category": "productivity"
     },
     {
       "name": "ship",
       "source": "./plugins/ship",
       "description": "Complete PR workflow: commit to production, skips review when called from next-task, removes task from registry on cleanup, automatic rollback",
-      "version": "3.2.1",
+      "version": "3.3.0",
       "category": "deployment"
     },
     {
       "name": "deslop",
       "source": "./plugins/deslop",
       "description": "3-phase AI slop detection: regex patterns (HIGH), multi-pass analyzers (MEDIUM), CLI tools (LOW)",
-      "version": "3.2.1",
+      "version": "3.3.0",
       "category": "development"
     },
     {
       "name": "audit-project",
       "source": "./plugins/audit-project",
       "description": "Multi-agent iterative code review until zero issues remain",
-      "version": "3.2.1",
+      "version": "3.3.0",
       "category": "development"
     },
     {
       "name": "drift-detect",
       "source": "./plugins/drift-detect",
       "description": "Deep repository analysis to realign project plans with code reality - detects drift, gaps, and creates prioritized reconstruction plans",
-      "version": "3.2.1",
+      "version": "3.3.0",
       "category": "productivity"
     },
     {
       "name": "enhance",
       "source": "./plugins/enhance",
       "description": "Master enhancement orchestrator: parallel analyzer execution for plugins, agents, docs, CLAUDE.md, and prompts with unified reporting",
-      "version": "3.2.1",
+      "version": "3.3.0",
       "category": "development"
     },
     {
       "name": "sync-docs",
       "source": "./plugins/sync-docs",
       "description": "Standalone documentation sync: find outdated refs, update CHANGELOG, flag stale examples based on code changes",
-      "version": "3.2.1",
+      "version": "3.3.0",
       "category": "development"
     },
     {
       "name": "repo-map",
       "source": "./plugins/repo-map",
       "description": "AST-based repository map generation using ast-grep with incremental updates for faster drift analysis",
-      "version": "3.2.1",
+      "version": "3.3.0",
       "category": "development"
     }
   ],

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "awesome-slash",
-  "version": "3.2.1",
+  "version": "3.3.0",
   "description": "Professional-grade slash commands for Claude Code with cross-platform support",
   "keywords": [
     "workflow",

package/CHANGELOG.md

@@ -5,6 +5,16 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [Unreleased]
+
+## [3.3.0] - 2026-01-28
+
+### Changed
+- **Docs** - Documented `npm run detect`/`npm run verify` diagnostics scripts for platform/tool checks
+- **Docs** - Clarified Phase 9 review loop uses the `orchestrate-review` skill for pass definitions
+- **Docs** - Aligned `/drift-detect` naming and expanded repo-map usage details
+- **Docs** - Recommended installing ast-grep (`sg`) upfront for repo-map
+
 ## [3.2.1] - 2026-01-28
 
 ### Added

package/README.md

@@ -228,6 +228,8 @@ With proper workflow structure, context management, and quality gates, AI agents
 11. **Docs Update** - Updates CHANGELOG and related documentation
 12. **Ship** - Creates PR, monitors CI, addresses comments, merges
 
+Phase 9 uses the `orchestrate-review` skill to define review passes and signal thresholds.
+
 **Agents involved:**
 
 | Agent | Model | Role |
@@ -433,6 +435,8 @@ Multi-agent collection wastes tokens on coordination. JavaScript collectors are
 - Import graph for dependency hints
 - Optional docs analysis (features, checkboxes)
 
+Output is cached at `{state-dir}/repo-map.json` and exposed via the MCP `repo_map` tool.
+
 **Why it matters:**
 
 Tools like `/drift-detect` and planners can use the map instead of re-scanning the repo every time.
@@ -445,7 +449,7 @@ Tools like `/drift-detect` and planners can use the map instead of re-scanning t
 /repo-map status      # Check freshness
 ```
 
-**Prerequisite:** Install ast-grep (`sg`) when prompted.
+**Recommended:** Install ast-grep (`sg`) before using `/repo-map` for fastest setup. It is required for repo-map generation.
 
 ---
 
@@ -598,6 +602,15 @@ Interactive installer for Claude Code, OpenCode, and Codex CLI.
 **For GitLab workflows:**
 - GitLab CLI (`glab`) authenticated
 
+**Recommended for repo-map:**
+- ast-grep (`sg`) installed (required for `/repo-map` generation)
+
+**Local diagnostics (optional):**
+```bash
+npm run detect   # Platform detection (CI, deploy, project type)
+npm run verify   # Tool availability + versions
+```
+
 ---
 
 ## Documentation

package/bin/cli.js

@@ -162,8 +162,9 @@ function installForClaude() {
   }
 }
 
-function installForOpenCode(installDir) {
+function installForOpenCode(installDir, options = {}) {
   console.log('\n📦 Installing for OpenCode...\n');
+  const { stripModels = false } = options;
 
   const home = process.env.HOME || process.env.USERPROFILE;
   // Commands go to ~/.opencode/commands/awesome-slash/
@@ -175,6 +176,12 @@ function installForOpenCode(installDir) {
   const configDir = path.dirname(configPath);
 
   fs.mkdirSync(configDir, { recursive: true });
+  if (fs.existsSync(commandsDir)) {
+    fs.rmSync(commandsDir, { recursive: true, force: true });
+  }
+  if (fs.existsSync(pluginDir)) {
+    fs.rmSync(pluginDir, { recursive: true, force: true });
+  }
   fs.mkdirSync(commandsDir, { recursive: true });
   fs.mkdirSync(pluginDir, { recursive: true });
 
@@ -344,7 +351,7 @@ function installForOpenCode(installDir) {
             opencodeFrontmatter += 'mode: subagent\n';
 
             // Map model names
-            if (parsed.model) {
+            if (parsed.model && !stripModels) {
               const modelMap = {
                 'sonnet': 'anthropic/claude-sonnet-4',
                 'opus': 'anthropic/claude-opus-4',
@@ -500,6 +507,9 @@ AI_STATE_DIR = ".codex"
     const destPath = path.join(skillDir, 'SKILL.md');
 
     if (fs.existsSync(srcPath)) {
+      if (fs.existsSync(skillDir)) {
+        fs.rmSync(skillDir, { recursive: true, force: true });
+      }
       // Create skill directory
       fs.mkdirSync(skillDir, { recursive: true });
 
@@ -564,6 +574,8 @@ function removeInstallation() {
 
 async function main() {
   const args = process.argv.slice(2);
+  const stripModels = args.includes('--strip-models') ||
+    ['1', 'true', 'yes'].includes((process.env.AWESOME_SLASH_STRIP_MODELS || '').toLowerCase());
 
   // Handle --remove / --uninstall
   if (args.includes('--remove') || args.includes('--uninstall')) {
@@ -584,10 +596,14 @@ awesome-slash v${VERSION} - Workflow automation for AI coding assistants
 
 Usage:
   awesome-slash              Interactive installer (select platforms)
+  awesome-slash --strip-models  Skip per-agent model overrides (OpenCode)
   awesome-slash --remove     Remove local installation
   awesome-slash --version    Show version
   awesome-slash --help       Show this help
 
+Environment:
+  AWESOME_SLASH_STRIP_MODELS=1  Same as --strip-models
+
 Supported Platforms:
   1) Claude Code  - /next-task, /ship, /deslop, /audit-project
   2) OpenCode     - Same commands + MCP tools
@@ -658,7 +674,7 @@ Docs: https://github.com/avifenesh/awesome-slash
         installForClaude();
         break;
       case 'opencode':
-        installForOpenCode(installDir);
+        installForOpenCode(installDir, { stripModels });
         break;
       case 'codex':
         installForCodex(installDir);

package/lib/drift-detect/collectors.js

@@ -15,11 +15,13 @@ const path = require('path');
 /**
  * Default options for data collection
  */
+const DEFAULT_PR_LIMIT = 50;
+
 const DEFAULT_OPTIONS = {
   sources: ['github', 'docs', 'code'],
   depth: 'thorough', // quick | thorough
   issueLimit: 100,
-  prLimit: 50,
+  prLimit: DEFAULT_PR_LIMIT,
   timeout: 10000, // 10s
   cwd: process.cwd()
 };

package/mcp-server/index.js

@@ -1018,7 +1018,7 @@ async function main() {
 const server = new Server(
     {
       name: 'awesome-slash',
-      version: '3.2.1',
+      version: '3.3.0',
     },
     {
       capabilities: {

package/package.json

@@ -1,27 +1,12 @@
 {
   "name": "awesome-slash",
-  "version": "3.2.1",
-  "description": "6 specialized plugins for AI workflow automation - works with Claude Code, OpenCode, and Codex CLI",
+  "version": "3.3.0",
+  "description": "8 specialized plugins for AI workflow automation (drift detection + AST repo maps) - works with Claude Code, OpenCode, and Codex CLI",
   "main": "lib/platform/detect-platform.js",
   "type": "commonjs",
   "bin": {
     "awesome-slash": "./bin/cli.js"
   },
-  "files": [
-    ".claude-plugin/",
-    ".mcp.json",
-    "adapters/",
-    "bin/",
-    "lib/",
-    "mcp-server/index.js",
-    "mcp-server/package.json",
-    "plugins/",
-    "scripts/setup-hooks.js",
-    "README.md",
-    "LICENSE",
-    "CHANGELOG.md",
-    "SECURITY.md"
-  ],
   "scripts": {
     "test": "jest",
     "test:watch": "jest --watch",
@@ -58,7 +43,10 @@
     "multi-agent",
     "cli",
     "pr-automation",
-    "productivity"
+    "productivity",
+    "repo-map",
+    "ast-grep",
+    "drift-detect"
   ],
   "author": {
     "name": "Avi Fenesh",

package/plugins/audit-project/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "audit-project",
-  "version": "3.2.1",
+  "version": "3.3.0",
   "description": "Multi-agent iterative code review until zero issues remain",
   "author": {
     "name": "Avi Fenesh",

package/plugins/audit-project/lib/drift-detect/collectors.js

@@ -15,11 +15,13 @@ const path = require('path');
 /**
  * Default options for data collection
  */
+const DEFAULT_PR_LIMIT = 50;
+
 const DEFAULT_OPTIONS = {
   sources: ['github', 'docs', 'code'],
   depth: 'thorough', // quick | thorough
   issueLimit: 100,
-  prLimit: 50,
+  prLimit: DEFAULT_PR_LIMIT,
   timeout: 10000, // 10s
   cwd: process.cwd()
 };

package/plugins/deslop/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "deslop",
-  "version": "3.2.1",
+  "version": "3.3.0",
   "description": "AI slop cleanup with minimal diffs and behavior preservation",
   "author": {
     "name": "Avi Fenesh",

package/plugins/deslop/lib/drift-detect/collectors.js

@@ -15,11 +15,13 @@ const path = require('path');
 /**
  * Default options for data collection
  */
+const DEFAULT_PR_LIMIT = 50;
+
 const DEFAULT_OPTIONS = {
   sources: ['github', 'docs', 'code'],
   depth: 'thorough', // quick | thorough
   issueLimit: 100,
-  prLimit: 50,
+  prLimit: DEFAULT_PR_LIMIT,
   timeout: 10000, // 10s
   cwd: process.cwd()
 };

package/plugins/drift-detect/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "drift-detect",
-  "version": "3.2.1",
+  "version": "3.3.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",

package/plugins/drift-detect/lib/drift-detect/collectors.js

@@ -15,11 +15,13 @@ const path = require('path');
 /**
  * Default options for data collection
  */
+const DEFAULT_PR_LIMIT = 50;
+
 const DEFAULT_OPTIONS = {
   sources: ['github', 'docs', 'code'],
   depth: 'thorough', // quick | thorough
   issueLimit: 100,
-  prLimit: 50,
+  prLimit: DEFAULT_PR_LIMIT,
   timeout: 10000, // 10s
   cwd: process.cwd()
 };

package/plugins/enhance/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "enhance",
-  "version": "3.2.1",
+  "version": "3.3.0",
   "description": "Plugin structure and tool use analyzer - validates plugin.json, MCP tools, and security patterns",
   "author": {
     "name": "Avi Fenesh",

package/plugins/enhance/lib/drift-detect/collectors.js

@@ -15,11 +15,13 @@ const path = require('path');
 /**
  * Default options for data collection
  */
+const DEFAULT_PR_LIMIT = 50;
+
 const DEFAULT_OPTIONS = {
   sources: ['github', 'docs', 'code'],
   depth: 'thorough', // quick | thorough
   issueLimit: 100,
-  prLimit: 50,
+  prLimit: DEFAULT_PR_LIMIT,
   timeout: 10000, // 10s
   cwd: process.cwd()
 };

package/plugins/next-task/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "next-task",
-  "version": "3.2.1",
+  "version": "3.3.0",
   "description": "Master workflow orchestrator with autonomous task-to-production automation, quality gates, and multi-agent review",
   "author": {
     "name": "Avi Fenesh",

package/plugins/next-task/lib/drift-detect/collectors.js

@@ -15,11 +15,13 @@ const path = require('path');
 /**
  * Default options for data collection
  */
+const DEFAULT_PR_LIMIT = 50;
+
 const DEFAULT_OPTIONS = {
   sources: ['github', 'docs', 'code'],
   depth: 'thorough', // quick | thorough
   issueLimit: 100,
-  prLimit: 50,
+  prLimit: DEFAULT_PR_LIMIT,
   timeout: 10000, // 10s
   cwd: process.cwd()
 };

package/plugins/repo-map/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "repo-map",
-  "version": "3.2.1",
+  "version": "3.3.0",
   "description": "AST-based repository map generator using ast-grep for symbol and import extraction with incremental updates",
   "author": {
     "name": "Avi Fenesh",

package/plugins/repo-map/lib/drift-detect/collectors.js

@@ -15,11 +15,13 @@ const path = require('path');
 /**
  * Default options for data collection
  */
+const DEFAULT_PR_LIMIT = 50;
+
 const DEFAULT_OPTIONS = {
   sources: ['github', 'docs', 'code'],
   depth: 'thorough', // quick | thorough
   issueLimit: 100,
-  prLimit: 50,
+  prLimit: DEFAULT_PR_LIMIT,
   timeout: 10000, // 10s
   cwd: process.cwd()
 };

package/plugins/repo-map/lib/platform/state-dir.js

@@ -11,10 +11,19 @@ const fs = require('fs');
 const path = require('path');
 
 /**
- * Cached state directory name (relative, without leading dot handling)
- * @type {string|null}
+ * Cached state directory name (relative, without leading dot handling),
+ * scoped by resolved base path.
+ * @type {Map<string, string>}
  */
-let _cachedStateDir = null;
+const _cachedStateDirs = new Map();
+
+function isDirectory(targetPath) {
+  try {
+    return fs.statSync(targetPath).isDirectory();
+  } catch {
+    return false;
+  }
+}
 
 /**
  * Detect which AI coding assistant is running and return appropriate state directory
@@ -34,23 +43,24 @@ function getStateDir(basePath = process.cwd()) {
     return process.env.AI_STATE_DIR;
   }
 
-  // Return cached value if available
-  if (_cachedStateDir) {
-    return _cachedStateDir;
+  const cacheKey = path.resolve(basePath);
+  const cached = _cachedStateDirs.get(cacheKey);
+  if (cached) {
+    return cached;
   }
 
   // OpenCode detection
   if (process.env.OPENCODE_CONFIG || process.env.OPENCODE_CONFIG_DIR) {
-    _cachedStateDir = '.opencode';
-    return _cachedStateDir;
+    _cachedStateDirs.set(cacheKey, '.opencode');
+    return '.opencode';
   }
 
   // Check for .opencode directory in project
   try {
     const opencodePath = path.join(basePath, '.opencode');
-    if (fs.existsSync(opencodePath) && fs.statSync(opencodePath).isDirectory()) {
-      _cachedStateDir = '.opencode';
-      return _cachedStateDir;
+    if (isDirectory(opencodePath)) {
+      _cachedStateDirs.set(cacheKey, '.opencode');
+      return '.opencode';
     }
   } catch {
     // Ignore errors, continue detection
@@ -58,24 +68,24 @@ function getStateDir(basePath = process.cwd()) {
 
   // Codex detection
   if (process.env.CODEX_HOME) {
-    _cachedStateDir = '.codex';
-    return _cachedStateDir;
+    _cachedStateDirs.set(cacheKey, '.codex');
+    return '.codex';
   }
 
   // Check for .codex directory in project
   try {
     const codexPath = path.join(basePath, '.codex');
-    if (fs.existsSync(codexPath) && fs.statSync(codexPath).isDirectory()) {
-      _cachedStateDir = '.codex';
-      return _cachedStateDir;
+    if (isDirectory(codexPath)) {
+      _cachedStateDirs.set(cacheKey, '.codex');
+      return '.codex';
     }
   } catch {
     // Ignore errors, continue detection
   }
 
   // Default to Claude Code
-  _cachedStateDir = '.claude';
-  return _cachedStateDir;
+  _cachedStateDirs.set(cacheKey, '.claude');
+  return '.claude';
 }
 
 /**
@@ -111,7 +121,7 @@ function getPlatformName(basePath = process.cwd()) {
  * Clear the cached state directory (useful for testing)
  */
 function clearCache() {
-  _cachedStateDir = null;
+  _cachedStateDirs.clear();
 }
 
 module.exports = {

package/plugins/ship/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "ship",
-  "version": "3.2.1",
+  "version": "3.3.0",
   "description": "Complete PR workflow from commit to production with validation",
   "author": {
     "name": "Avi Fenesh",

package/plugins/ship/lib/drift-detect/collectors.js

@@ -15,11 +15,13 @@ const path = require('path');
 /**
  * Default options for data collection
  */
+const DEFAULT_PR_LIMIT = 50;
+
 const DEFAULT_OPTIONS = {
   sources: ['github', 'docs', 'code'],
   depth: 'thorough', // quick | thorough
   issueLimit: 100,
-  prLimit: 50,
+  prLimit: DEFAULT_PR_LIMIT,
   timeout: 10000, // 10s
   cwd: process.cwd()
 };

package/plugins/sync-docs/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "sync-docs",
-  "version": "3.2.1",
+  "version": "3.3.0",
   "description": "Sync documentation with code changes. Find outdated refs, update CHANGELOG, flag stale examples.",
   "commands": ["commands/sync-docs.md"]
 }

package/plugins/sync-docs/lib/drift-detect/collectors.js

@@ -15,11 +15,13 @@ const path = require('path');
 /**
  * Default options for data collection
  */
+const DEFAULT_PR_LIMIT = 50;
+
 const DEFAULT_OPTIONS = {
   sources: ['github', 'docs', 'code'],
   depth: 'thorough', // quick | thorough
   issueLimit: 100,
-  prLimit: 50,
+  prLimit: DEFAULT_PR_LIMIT,
   timeout: 10000, // 10s
   cwd: process.cwd()
 };