@cloudstreamsoftware/claude-tools 1.0.0 → 1.1.0

package/dist/lib/workflow-state.js

@@ -0,0 +1,249 @@
+/**
+ * Workflow State - Tracks Workflow Phases and Suggests Next Steps
+ *
+ * Manages the state of multi-phase workflows (feature, bugfix, refactor, zoho)
+ * and provides guidance on skipped phases and next steps.
+ *
+ * @module workflow-state
+ */
+
+/**
+ * Workflow phase definitions
+ *
+ * Each workflow type has an ordered list of phases that should be followed.
+ * Critical phases are marked and require confirmation to skip.
+ */
+const WORKFLOW_PHASES = {
+  feature: ['plan', 'tdd', 'implement', 'review', 'verify', 'pr'],
+  bugfix: ['investigate', 'tdd', 'fix', 'review', 'verify'],
+  refactor: ['plan', 'review-existing', 'refactor', 'verify'],
+  zoho: ['architect', 'deluge-review', 'deploy', 'verify'],
+};
+
+/**
+ * Critical phases that require confirmation to skip
+ */
+const CRITICAL_PHASES = {
+  feature: ['plan', 'tdd', 'review'],
+  bugfix: ['investigate', 'review'],
+  refactor: ['plan', 'review-existing'],
+  zoho: ['architect', 'deluge-review'],
+};
+
+/**
+ * In-memory workflow state
+ * In production, this would be persisted to session-memory.js
+ */
+let currentWorkflow = null;
+
+/**
+ * Get the current workflow state
+ *
+ * @returns {object|null} Current workflow state or null if no workflow active
+ */
+function getWorkflowState() {
+  return currentWorkflow;
+}
+
+/**
+ * Start a new workflow
+ *
+ * @param {string} type - Workflow type (feature, bugfix, refactor, zoho)
+ * @param {string} description - Description of what this workflow is for
+ * @returns {boolean} True if workflow started successfully
+ */
+function startWorkflow(type, description = '') {
+  // Validate workflow type
+  if (!WORKFLOW_PHASES[type]) {
+    return false;
+  }
+
+  currentWorkflow = {
+    type,
+    description,
+    currentPhase: null,
+    completedPhases: [],
+    startedAt: new Date().toISOString(),
+    lastUpdated: new Date().toISOString(),
+  };
+
+  return true;
+}
+
+/**
+ * Advance to a specific phase
+ *
+ * @param {string} phase - The phase to advance to
+ * @returns {boolean} True if phase was advanced successfully
+ */
+function advancePhase(phase) {
+  if (!currentWorkflow) {
+    return false;
+  }
+
+  // Add to completed phases if not already there
+  if (!currentWorkflow.completedPhases.includes(phase)) {
+    currentWorkflow.completedPhases.push(phase);
+  }
+
+  currentWorkflow.currentPhase = phase;
+  currentWorkflow.lastUpdated = new Date().toISOString();
+
+  return true;
+}
+
+/**
+ * Check which phases were skipped to reach a target phase
+ *
+ * @param {string} targetPhase - The phase we're trying to reach
+ * @returns {string[]} Array of skipped phase names
+ */
+function checkSkippedPhases(targetPhase) {
+  if (!currentWorkflow) {
+    return [];
+  }
+
+  const phases = WORKFLOW_PHASES[currentWorkflow.type];
+  if (!phases) {
+    return [];
+  }
+
+  const targetIndex = phases.indexOf(targetPhase);
+  if (targetIndex === -1) {
+    return [];
+  }
+
+  const skipped = [];
+
+  // Check all phases before the target
+  for (let i = 0; i < targetIndex; i++) {
+    const phase = phases[i];
+    if (!currentWorkflow.completedPhases.includes(phase)) {
+      skipped.push(phase);
+    }
+  }
+
+  return skipped;
+}
+
+/**
+ * Get the next recommended phase
+ *
+ * @returns {string|null} Next phase name or null if workflow complete
+ */
+function getNextPhase() {
+  if (!currentWorkflow) {
+    return null;
+  }
+
+  const phases = WORKFLOW_PHASES[currentWorkflow.type];
+  if (!phases) {
+    return null;
+  }
+
+  // Find the current phase index
+  const currentIndex = currentWorkflow.currentPhase
+    ? phases.indexOf(currentWorkflow.currentPhase)
+    : -1;
+
+  // Return the next phase
+  const nextIndex = currentIndex + 1;
+  if (nextIndex >= phases.length) {
+    return null; // Workflow complete
+  }
+
+  return phases[nextIndex];
+}
+
+/**
+ * Check if a phase is critical for a workflow type
+ *
+ * @param {string} phase - Phase name
+ * @param {string} workflowType - Workflow type
+ * @returns {boolean} True if phase is critical
+ */
+function isCriticalPhase(phase, workflowType) {
+  const criticalPhases = CRITICAL_PHASES[workflowType];
+  if (!criticalPhases) {
+    return false;
+  }
+  return criticalPhases.includes(phase);
+}
+
+/**
+ * Reset the workflow state
+ */
+function resetWorkflow() {
+  currentWorkflow = null;
+}
+
+/**
+ * Check if a workflow is currently active
+ *
+ * @returns {boolean} True if workflow is active
+ */
+function hasActiveWorkflow() {
+  return currentWorkflow !== null;
+}
+
+/**
+ * Get workflow progress as a percentage
+ *
+ * @returns {number} Progress percentage (0-100)
+ */
+function getProgress() {
+  if (!currentWorkflow) {
+    return 0;
+  }
+
+  const phases = WORKFLOW_PHASES[currentWorkflow.type];
+  if (!phases || phases.length === 0) {
+    return 0;
+  }
+
+  return Math.round((currentWorkflow.completedPhases.length / phases.length) * 100);
+}
+
+/**
+ * Detect workflow type from an intent
+ *
+ * @param {string} intent - The detected intent
+ * @returns {string|null} Suggested workflow type or null
+ */
+function detectWorkflowType(intent) {
+  const intentToWorkflow = {
+    PLANNING: 'feature',
+    TESTING: 'feature', // Testing typically part of feature workflow
+    REVIEW: null, // Review could be any workflow
+    SECURITY: null,
+    COMPLIANCE: null,
+    ZOHO: 'zoho',
+    DEPLOY: null, // Deploy is usually end of workflow
+    REFACTOR: 'refactor',
+    DEBUG: 'bugfix',
+  };
+
+  return intentToWorkflow[intent] || null;
+}
+
+module.exports = {
+  // State management
+  getWorkflowState,
+  startWorkflow,
+  advancePhase,
+  resetWorkflow,
+  hasActiveWorkflow,
+
+  // Phase checking
+  checkSkippedPhases,
+  getNextPhase,
+  isCriticalPhase,
+  getProgress,
+
+  // Workflow detection
+  detectWorkflowType,
+
+  // Constants
+  WORKFLOW_PHASES,
+  CRITICAL_PHASES,
+};

package/hooks/hooks.json

@@ -0,0 +1,209 @@
+{
+  "$schema": "https://json.schemastore.org/claude-code-settings.json",
+  "hooks": {
+    "UserPromptSubmit": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/prompt-router.js\""
+          }
+        ],
+        "description": "Intelligent prompt routing - auto-detect intent and suggest optimal commands"
+      },
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/prompt-analyzer.js\""
+          }
+        ],
+        "description": "Real-time correction detection and session learning"
+      }
+    ],
+    "PreToolUse": [
+      {
+        "matcher": "tool == \"Edit\" || tool == \"Write\"",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/credential-check.js\""
+          }
+        ],
+        "description": "Scan for hardcoded Zoho/GCP credentials in edits"
+      },
+      {
+        "matcher": "tool == \"Bash\" && tool_input.command matches \"(npm run dev|pnpm( run)? dev|yarn dev|bun run dev)\"",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node -e \"console.error('[Hook] BLOCKED: Dev server must run in tmux for log access');console.error('[Hook] Use: tmux new-session -d -s dev \\\"npm run dev\\\"');console.error('[Hook] Then: tmux attach -t dev');process.exit(1)\""
+          }
+        ],
+        "description": "Block dev servers outside tmux - ensures you can access logs"
+      },
+      {
+        "matcher": "tool == \"Bash\" && tool_input.command matches \"(npm (install|test)|pnpm (install|test)|yarn (install|test)?|bun (install|test)|cargo build|make|docker|pytest|vitest|playwright)\"",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node -e \"if(!process.env.TMUX){console.error('[Hook] Consider running in tmux for session persistence');console.error('[Hook] tmux new -s dev  |  tmux attach -t dev')}\""
+          }
+        ],
+        "description": "Reminder to use tmux for long-running commands"
+      },
+      {
+        "matcher": "tool == \"Bash\" && tool_input.command matches \"git push\"",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node -e \"console.error('[Hook] Review changes before push...');console.error('[Hook] Continuing with push (remove this hook to add interactive review)')\""
+          }
+        ],
+        "description": "Reminder before git push to review changes"
+      },
+      {
+        "matcher": "tool == \"Write\" && tool_input.file_path matches \"\\\\.(md|txt)$\" && !(tool_input.file_path matches \"README\\\\.md|CLAUDE\\\\.md|AGENTS\\\\.md|CONTRIBUTING\\\\.md\")",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node -e \"const fs=require('fs');let d='';process.stdin.on('data',c=>d+=c);process.stdin.on('end',()=>{const i=JSON.parse(d);const p=i.tool_input?.file_path||'';if(/\\.(md|txt)$/.test(p)&&!/(README|CLAUDE|AGENTS|CONTRIBUTING)\\.md$/.test(p)){console.error('[Hook] BLOCKED: Unnecessary documentation file creation');console.error('[Hook] File: '+p);console.error('[Hook] Use README.md for documentation instead');process.exit(1)}console.log(d)})\""
+          }
+        ],
+        "description": "Block creation of random .md files - keeps docs consolidated"
+      },
+      {
+        "matcher": "tool == \"Edit\" || tool == \"Write\"",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/suggest-compact.js\""
+          }
+        ],
+        "description": "Suggest manual compaction at logical intervals"
+      },
+      {
+        "matcher": "tool == \"Edit\" || tool == \"Write\"",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/quality-gate-enforcer.js\""
+          }
+        ],
+        "description": "Enforce quality gates (credentials, compliance, patterns)"
+      },
+      {
+        "matcher": "tool == \"Edit\" || tool == \"Write\" || tool == \"Read\"",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/skill-injector.js\""
+          }
+        ],
+        "description": "Auto-inject relevant skills based on context"
+      }
+    ],
+    "PreCompact": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/pre-compact.js\""
+          }
+        ],
+        "description": "Save state before context compaction"
+      }
+    ],
+    "SessionStart": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/session-start.js\""
+          }
+        ],
+        "description": "Load previous context and detect package manager on new session"
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "tool == \"Bash\"",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node -e \"let d='';process.stdin.on('data',c=>d+=c);process.stdin.on('end',()=>{const i=JSON.parse(d);const cmd=i.tool_input?.command||'';if(/gh pr create/.test(cmd)){const out=i.tool_output?.output||'';const m=out.match(/https:\\/\\/github.com\\/[^/]+\\/[^/]+\\/pull\\/\\d+/);if(m){console.error('[Hook] PR created: '+m[0]);const repo=m[0].replace(/https:\\/\\/github.com\\/([^/]+\\/[^/]+)\\/pull\\/\\d+/,'$1');const pr=m[0].replace(/.*\\/pull\\/(\\d+)/,'$1');console.error('[Hook] To review: gh pr review '+pr+' --repo '+repo)}}console.log(d)})\""
+          }
+        ],
+        "description": "Log PR URL and provide review command after PR creation"
+      },
+      {
+        "matcher": "tool == \"Edit\" && tool_input.file_path matches \"\\\\.(ts|tsx|js|jsx)$\"",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node -e \"const{execSync}=require('child_process');const fs=require('fs');let d='';process.stdin.on('data',c=>d+=c);process.stdin.on('end',()=>{const i=JSON.parse(d);const p=i.tool_input?.file_path;if(p&&fs.existsSync(p)){try{execSync('npx prettier --write \"'+p+'\"',{stdio:['pipe','pipe','pipe']})}catch(e){}}console.log(d)})\""
+          }
+        ],
+        "description": "Auto-format JS/TS files with Prettier after edits"
+      },
+      {
+        "matcher": "tool == \"Edit\" && tool_input.file_path matches \"\\\\.(ts|tsx)$\"",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node -e \"const{execSync}=require('child_process');const fs=require('fs');const path=require('path');let d='';process.stdin.on('data',c=>d+=c);process.stdin.on('end',()=>{const i=JSON.parse(d);const p=i.tool_input?.file_path;if(p&&fs.existsSync(p)){let dir=path.dirname(p);while(dir!==path.dirname(dir)&&!fs.existsSync(path.join(dir,'tsconfig.json'))){dir=path.dirname(dir)}if(fs.existsSync(path.join(dir,'tsconfig.json'))){try{const r=execSync('npx tsc --noEmit --pretty false 2>&1',{cwd:dir,encoding:'utf8',stdio:['pipe','pipe','pipe']});const lines=r.split('\\n').filter(l=>l.includes(p)).slice(0,10);if(lines.length)console.error(lines.join('\\n'))}catch(e){const lines=(e.stdout||'').split('\\n').filter(l=>l.includes(p)).slice(0,10);if(lines.length)console.error(lines.join('\\n'))}}}console.log(d)})\""
+          }
+        ],
+        "description": "TypeScript check after editing .ts/.tsx files"
+      },
+      {
+        "matcher": "tool == \"Edit\" && tool_input.file_path matches \"\\\\.(ts|tsx|js|jsx)$\"",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node -e \"const fs=require('fs');let d='';process.stdin.on('data',c=>d+=c);process.stdin.on('end',()=>{const i=JSON.parse(d);const p=i.tool_input?.file_path;if(p&&fs.existsSync(p)){const c=fs.readFileSync(p,'utf8');const lines=c.split('\\n');const matches=[];lines.forEach((l,idx)=>{if(/console\\.log/.test(l))matches.push((idx+1)+': '+l.trim())});if(matches.length){console.error('[Hook] WARNING: console.log found in '+p);matches.slice(0,5).forEach(m=>console.error(m));console.error('[Hook] Remove console.log before committing')}}console.log(d)})\""
+          }
+        ],
+        "description": "Warn about console.log statements after edits"
+      }
+    ],
+    "Stop": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node -e \"const{execSync}=require('child_process');const fs=require('fs');let d='';process.stdin.on('data',c=>d+=c);process.stdin.on('end',()=>{try{execSync('git rev-parse --git-dir',{stdio:'pipe'})}catch{console.log(d);process.exit(0)}try{const files=execSync('git diff --name-only HEAD',{encoding:'utf8',stdio:['pipe','pipe','pipe']}).split('\\n').filter(f=>/\\.(ts|tsx|js|jsx)$/.test(f)&&fs.existsSync(f));let hasConsole=false;for(const f of files){if(fs.readFileSync(f,'utf8').includes('console.log')){console.error('[Hook] WARNING: console.log found in '+f);hasConsole=true}}if(hasConsole)console.error('[Hook] Remove console.log statements before committing')}catch(e){}console.log(d)})\""
+          }
+        ],
+        "description": "Check for console.log in modified files after each response"
+      }
+    ],
+    "SessionEnd": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/session-end.js\""
+          }
+        ],
+        "description": "Persist session state on end"
+      },
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/hooks/evaluate-session.js\""
+          }
+        ],
+        "description": "Evaluate session for extractable patterns"
+      }
+    ]
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cloudstreamsoftware/claude-tools",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "CloudStream Claude Code productivity tools - hooks, skills, agents, and knowledge server integration",
   "main": "dist/index.js",
   "bin": {
@@ -36,6 +36,10 @@
     "dist/",
     "config/",
     "mcp/",
+    "scripts/",
+    "hooks/",
+    "skills/",
+    "agents/",
     "README.md"
   ],
   "dependencies": {