forge-workflow 0.0.4 → 0.0.6

package/lib/workflow-profiles.js

@@ -1,197 +1,197 @@
-/**
- * Workflow Profiles
- *
- * Implements hybrid approach: 4 user-facing types (Feature/Fix/Refactor/Chore)
- * map to 6 internal profiles (Critical/Standard/Simple/Hotfix/Docs/Refactor)
- * with keyword-based auto-escalation.
- */
-
-/**
- * Internal workflow profiles aligned with AGENTS.md specification
- */
-const PROFILES = {
-  critical: {
-    name: 'Critical (Maximum Rigor)',
-    stages: ['/status', '/plan', '/dev', '/validate', '/ship', '/review', '/premerge', '/verify'],
-    tdd: 'strict',
-    research: 'required',
-    description: 'Security, auth, payments, data integrity, breaking changes',
-    keywords: ['auth', 'security', 'payment', 'crypto', 'password', 'token', 'session', 'data-migration', 'breaking']
-  },
-
-  standard: {
-    name: 'Standard (Full Workflow)',
-    stages: ['/status', '/plan', '/dev', '/validate', '/ship', '/review', '/premerge'],
-    tdd: 'required',
-    research: 'optional',
-    description: 'Most features and non-critical enhancements'
-  },
-
-  simple: {
-    name: 'Simple (Streamlined)',
-    stages: ['/dev', '/validate', '/ship', '/premerge'],
-    tdd: 'recommended',
-    research: 'skip',
-    description: 'UI tweaks, small improvements, minor fixes'
-  },
-
-  hotfix: {
-    name: 'Hotfix (Emergency)',
-    stages: ['/dev', '/validate', '/ship'],
-    tdd: 'required',  // Must reproduce bug
-    research: 'skip',
-    description: 'Production bugs, urgent fixes',
-    keywords: ['urgent', 'production', 'emergency', 'hotfix', 'critical']
-  },
-
-  docs: {
-    name: 'Docs (Documentation Only)',
-    stages: ['/verify', '/ship', '/premerge'],
-    tdd: 'no',
-    research: 'no',
-    description: 'Documentation updates, README changes'
-  },
-
-  refactor: {
-    name: 'Refactor (Behavior-Preserving)',
-    stages: ['/plan', '/dev', '/validate', '/ship', '/premerge'],
-    tdd: 'strict',  // Must preserve behavior
-    research: 'optional',
-    description: 'Code cleanup, optimization, behavior-preserving improvements'
-  }
-};
-
-/**
- * Generic keyword detection helper (DRY utility)
- * @param {string} text - Text to analyze
- * @param {string[]} keywords - Keywords to search for
- * @returns {boolean} - True if any keyword found
- */
-function containsKeywords(text, keywords) {
-  if (!text || typeof text !== 'string') return false;
-  const lowerText = text.toLowerCase();
-  return keywords.some(keyword => lowerText.includes(keyword));
-}
-
-/**
- * Detects if text contains critical keywords (auth, security, payment, etc.)
- * @param {string} text - Text to analyze (branch name, commit message, etc.)
- * @returns {boolean} - True if critical keywords found
- */
-function containsCriticalKeywords(text) {
-  const keywords = ['auth', 'security', 'payment', 'crypto', 'password', 'token', 'session', 'migration', 'breaking'];
-  return containsKeywords(text, keywords);
-}
-
-/**
- * Detects if text contains hotfix keywords (urgent, production, emergency, etc.)
- * @param {string} text - Text to analyze (branch name, commit message, etc.)
- * @returns {boolean} - True if hotfix keywords found
- */
-function containsHotfixKeywords(text) {
-  const keywords = ['urgent', 'production', 'emergency', 'hotfix', 'critical'];
-  return containsKeywords(text, keywords);
-}
-
-/**
- * Detects user-facing work type from context (4 simple types)
- * @param {Object} context - Detection context
- * @param {string} context.branch - Git branch name
- * @returns {string} - User type: 'feature' | 'fix' | 'refactor' | 'chore'
- */
-function getUserType(context) {
-  const branch = context.branch || '';
-  const branchLower = branch.toLowerCase();
-
-  // Detect from branch prefix
-  if (branchLower.startsWith('feat/')) return 'feature';
-  if (branchLower.startsWith('fix/')) return 'fix';
-  if (branchLower.startsWith('hotfix/')) return 'fix';
-  if (branchLower.startsWith('refactor/')) return 'refactor';
-  if (branchLower.startsWith('docs/')) return 'chore';
-  if (branchLower.startsWith('chore/')) return 'chore';
-
-  // Default: feature (safest - full workflow)
-  return 'feature';
-}
-
-/**
- * Maps user type to internal profile with keyword-based escalation (6 granular profiles)
- * @param {string} userType - User-facing type: 'feature' | 'fix' | 'refactor' | 'chore'
- * @param {Object} context - Detection context
- * @param {string[]} context.keywords - Keywords from branch/commit
- * @param {string[]} context.files - Modified files
- * @returns {string} - Internal profile: 'critical' | 'standard' | 'simple' | 'hotfix' | 'docs' | 'refactor'
- */
-function getInternalProfile(userType, context) {
-  const keywords = context.keywords || [];
-  const files = context.files || [];
-
-  // Combine all keywords into a single string for analysis
-  const keywordText = keywords.join(' ');
-
-  switch (userType) {
-    case 'feature':
-      // Auto-escalate to Critical if security-sensitive
-      return containsCriticalKeywords(keywordText) ? 'critical' : 'standard';
-
-    case 'fix':
-      // Auto-escalate to Hotfix if urgent/production
-      return containsHotfixKeywords(keywordText) ? 'hotfix' : 'simple';
-
-    case 'refactor':
-      // 1:1 mapping
-      return 'refactor';
-
-    case 'chore':
-      // Docs if only markdown files, otherwise Simple
-      if (files.length > 0 && files.every(f => f.endsWith('.md'))) {
-        return 'docs';
-      }
-      return 'simple';
-
-    default:
-      return 'standard';
-  }
-}
-
-/**
- * Main detection function - detects work type and selects appropriate profile
- * @param {Object} context - Detection context
- * @param {string} context.manualProfile - Manual profile override (optional)
- * @param {string} context.branch - Git branch name
- * @param {string[]} context.keywords - Keywords from branch/commit
- * @param {string[]} context.files - Modified files
- * @returns {Object} - { userType, profile, source }
- */
-function detectWorkType(context) {
-  // Priority 1: Manual override (power users)
-  if (context.manualProfile) {
-    return {
-      userType: null,
-      profile: context.manualProfile,
-      source: 'manual'
-    };
-  }
-
-  // Priority 2: Detect simple user type (4 options)
-  const userType = getUserType(context);
-
-  // Priority 3: Auto-select granular internal profile (6 options)
-  const profile = getInternalProfile(userType, context);
-
-  return {
-    userType,
-    profile,
-    source: 'auto'
-  };
-}
-
-module.exports = {
-  PROFILES,
-  containsCriticalKeywords,
-  containsHotfixKeywords,
-  getUserType,
-  getInternalProfile,
-  detectWorkType
-};
+/**
+ * Workflow Profiles
+ *
+ * Implements hybrid approach: 4 user-facing types (Feature/Fix/Refactor/Chore)
+ * map to 6 internal profiles (Critical/Standard/Simple/Hotfix/Docs/Refactor)
+ * with keyword-based auto-escalation.
+ */
+
+/**
+ * Internal workflow profiles aligned with AGENTS.md specification
+ */
+const PROFILES = {
+  critical: {
+    name: 'Critical (Maximum Rigor)',
+    stages: ['/status', '/plan', '/dev', '/validate', '/ship', '/review', '/premerge', '/verify'],
+    tdd: 'strict',
+    research: 'required',
+    description: 'Security, auth, payments, data integrity, breaking changes',
+    keywords: ['auth', 'security', 'payment', 'crypto', 'password', 'token', 'session', 'data-migration', 'breaking']
+  },
+
+  standard: {
+    name: 'Standard (Full Workflow)',
+    stages: ['/status', '/plan', '/dev', '/validate', '/ship', '/review', '/premerge'],
+    tdd: 'required',
+    research: 'optional',
+    description: 'Most features and non-critical enhancements'
+  },
+
+  simple: {
+    name: 'Simple (Streamlined)',
+    stages: ['/dev', '/validate', '/ship', '/premerge'],
+    tdd: 'recommended',
+    research: 'skip',
+    description: 'UI tweaks, small improvements, minor fixes'
+  },
+
+  hotfix: {
+    name: 'Hotfix (Emergency)',
+    stages: ['/dev', '/validate', '/ship'],
+    tdd: 'required',  // Must reproduce bug
+    research: 'skip',
+    description: 'Production bugs, urgent fixes',
+    keywords: ['urgent', 'production', 'emergency', 'hotfix', 'critical']
+  },
+
+  docs: {
+    name: 'Docs (Documentation Only)',
+    stages: ['/verify', '/ship', '/premerge'],
+    tdd: 'no',
+    research: 'no',
+    description: 'Documentation updates, README changes'
+  },
+
+  refactor: {
+    name: 'Refactor (Behavior-Preserving)',
+    stages: ['/plan', '/dev', '/validate', '/ship', '/premerge'],
+    tdd: 'strict',  // Must preserve behavior
+    research: 'optional',
+    description: 'Code cleanup, optimization, behavior-preserving improvements'
+  }
+};
+
+/**
+ * Generic keyword detection helper (DRY utility)
+ * @param {string} text - Text to analyze
+ * @param {string[]} keywords - Keywords to search for
+ * @returns {boolean} - True if any keyword found
+ */
+function containsKeywords(text, keywords) {
+  if (!text || typeof text !== 'string') return false;
+  const lowerText = text.toLowerCase();
+  return keywords.some(keyword => lowerText.includes(keyword));
+}
+
+/**
+ * Detects if text contains critical keywords (auth, security, payment, etc.)
+ * @param {string} text - Text to analyze (branch name, commit message, etc.)
+ * @returns {boolean} - True if critical keywords found
+ */
+function containsCriticalKeywords(text) {
+  const keywords = ['auth', 'security', 'payment', 'crypto', 'password', 'token', 'session', 'migration', 'breaking'];
+  return containsKeywords(text, keywords);
+}
+
+/**
+ * Detects if text contains hotfix keywords (urgent, production, emergency, etc.)
+ * @param {string} text - Text to analyze (branch name, commit message, etc.)
+ * @returns {boolean} - True if hotfix keywords found
+ */
+function containsHotfixKeywords(text) {
+  const keywords = ['urgent', 'production', 'emergency', 'hotfix', 'critical'];
+  return containsKeywords(text, keywords);
+}
+
+/**
+ * Detects user-facing work type from context (4 simple types)
+ * @param {Object} context - Detection context
+ * @param {string} context.branch - Git branch name
+ * @returns {string} - User type: 'feature' | 'fix' | 'refactor' | 'chore'
+ */
+function getUserType(context) {
+  const branch = context.branch || '';
+  const branchLower = branch.toLowerCase();
+
+  // Detect from branch prefix
+  if (branchLower.startsWith('feat/')) return 'feature';
+  if (branchLower.startsWith('fix/')) return 'fix';
+  if (branchLower.startsWith('hotfix/')) return 'fix';
+  if (branchLower.startsWith('refactor/')) return 'refactor';
+  if (branchLower.startsWith('docs/')) return 'chore';
+  if (branchLower.startsWith('chore/')) return 'chore';
+
+  // Default: feature (safest - full workflow)
+  return 'feature';
+}
+
+/**
+ * Maps user type to internal profile with keyword-based escalation (6 granular profiles)
+ * @param {string} userType - User-facing type: 'feature' | 'fix' | 'refactor' | 'chore'
+ * @param {Object} context - Detection context
+ * @param {string[]} context.keywords - Keywords from branch/commit
+ * @param {string[]} context.files - Modified files
+ * @returns {string} - Internal profile: 'critical' | 'standard' | 'simple' | 'hotfix' | 'docs' | 'refactor'
+ */
+function getInternalProfile(userType, context) {
+  const keywords = context.keywords || [];
+  const files = context.files || [];
+
+  // Combine all keywords into a single string for analysis
+  const keywordText = keywords.join(' ');
+
+  switch (userType) {
+    case 'feature':
+      // Auto-escalate to Critical if security-sensitive
+      return containsCriticalKeywords(keywordText) ? 'critical' : 'standard';
+
+    case 'fix':
+      // Auto-escalate to Hotfix if urgent/production
+      return containsHotfixKeywords(keywordText) ? 'hotfix' : 'simple';
+
+    case 'refactor':
+      // 1:1 mapping
+      return 'refactor';
+
+    case 'chore':
+      // Docs if only markdown files, otherwise Simple
+      if (files.length > 0 && files.every(f => f.endsWith('.md'))) {
+        return 'docs';
+      }
+      return 'simple';
+
+    default:
+      return 'standard';
+  }
+}
+
+/**
+ * Main detection function - detects work type and selects appropriate profile
+ * @param {Object} context - Detection context
+ * @param {string} context.manualProfile - Manual profile override (optional)
+ * @param {string} context.branch - Git branch name
+ * @param {string[]} context.keywords - Keywords from branch/commit
+ * @param {string[]} context.files - Modified files
+ * @returns {Object} - { userType, profile, source }
+ */
+function detectWorkType(context) {
+  // Priority 1: Manual override (power users)
+  if (context.manualProfile) {
+    return {
+      userType: null,
+      profile: context.manualProfile,
+      source: 'manual'
+    };
+  }
+
+  // Priority 2: Detect simple user type (4 options)
+  const userType = getUserType(context);
+
+  // Priority 3: Auto-select granular internal profile (6 options)
+  const profile = getInternalProfile(userType, context);
+
+  return {
+    userType,
+    profile,
+    source: 'auto'
+  };
+}
+
+module.exports = {
+  PROFILES,
+  containsCriticalKeywords,
+  containsHotfixKeywords,
+  getUserType,
+  getInternalProfile,
+  detectWorkType
+};

package/package.json

@@ -1,128 +1,131 @@
-{
-  "name": "forge-workflow",
-  "version": "0.0.4",
-  "description": "7-stage TDD workflow for ALL AI coding agents (Claude, Cursor, Cline, OpenCode, Copilot, Kilo Code, Roo Code, Codex)",
-  "bin": {
-    "forge": "bin/forge.js",
-    "forge-preflight": "bin/forge-preflight.js"
-  },
-  "workspaces": [
-    "packages/*"
-  ],
-  "scripts": {
-    "test": "bun test",
-    "test:setup": "bash test-env/automation/setup-fixtures.sh",
-    "test:all": "bun run test:setup && bun test",
-    "test:coverage": "c8 --check-coverage bun test",
-    "typecheck": "echo 'No TypeScript in project - skipping type check'",
-    "lint": "eslint . --max-warnings 0",
-    "check": "bash scripts/validate.sh",
-    "prepare": "lefthook install || echo 'Note: lefthook not installed. Git hooks disabled. Run: bun add -d lefthook'",
-    "setup": "node ./bin/forge.js setup",
-    "help": "node ./bin/forge.js --help",
-    "validate:yaml": "find . \\( -name '*.yml' -o -name '*.yaml' \\) | grep -v node_modules | while IFS= read -r file; do echo \"Checking $file...\" && bun x js-yaml \"$file\" > /dev/null || exit 1; done",
-    "test:mutation": "npx stryker run",
-    "test:benchmark": "node scripts/benchmark.js",
-    "test:dashboard": "node scripts/test-dashboard.js"
-  },
-  "peerDependencies": {
-    "lefthook": "^1.0.0"
-  },
-  "peerDependenciesMeta": {
-    "lefthook": {
-      "optional": true
-    }
-  },
-  "devDependencies": {
-    "@commitlint/cli": "^20.4.1",
-    "@commitlint/config-conventional": "^20.4.1",
-    "@eslint/js": "^10.0.1",
-    "@microsoft/eslint-formatter-sarif": "^3.1.0",
-    "@stryker-mutator/core": "^9.6.0",
-    "c8": "^11.0.0",
-    "eslint": "^10.0.2",
-    "globals": "^17.3.0",
-    "js-yaml": "^4.1.1",
-    "lefthook": "^1.10.1",
-    "yaml": "^2.8.2"
-  },
-  "keywords": [
-    "ai",
-    "workflow",
-    "tdd",
-    "agents-md",
-    "claude-code",
-    "cursor",
-    "kilo-code",
-    "opencode",
-    "copilot",
-    "cline",
-    "roo-code",
-    "codex",
-    "development",
-    "testing"
-  ],
-  "author": "Harsha Nandak",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/harshanandak/forge.git"
-  },
-  "homepage": "https://github.com/harshanandak/forge#readme",
-  "bugs": {
-    "url": "https://github.com/harshanandak/forge/issues"
-  },
-  "files": [
-    "bin/",
-    "lib/",
-    "skills/",
-    ".claude/commands/",
-    ".claude/rules/",
-    ".claude/scripts/",
-    ".claude/skills/",
-    ".cursor/",
-    ".cline/",
-    ".roo/",
-    ".codex/",
-    ".kilocode/",
-    ".opencode/",
-    ".github/prompts/",
-    ".github/PLUGIN_TEMPLATE.json",
-    ".forge/hooks/",
-    "docs/*.md",
-    "install.sh",
-    "lefthook.yml",
-    "AGENTS.md",
-    "CLAUDE.md",
-    ".mcp.json.example"
-  ],
-  "dependencies": {
-    "@babel/parser": "^7.29.2",
-    "fastest-levenshtein": "^1.0.16"
-  },
-  "overrides": {
-    "eslint": "^10.0.2",
-    "flatted": "3.4.2",
-    "minimatch": "10.2.4"
-  },
-  "c8": {
-    "lines": 80,
-    "branches": 80,
-    "functions": 80,
-    "statements": 80,
-    "exclude": [
-      "test/**",
-      "test-env/**",
-      "**/*.test.js",
-      "**/*.spec.js",
-      "coverage/**",
-      ".forge/hooks/**",
-      "bin/forge.js"
-    ],
-    "reporter": [
-      "text",
-      "lcov",
-      "html"
-    ]
-  }
-}
+{
+  "name": "forge-workflow",
+  "version": "0.0.6",
+  "description": "7-stage TDD workflow for ALL AI coding agents (Claude, Cursor, Cline, OpenCode, Copilot, Kilo Code, Roo Code, Codex)",
+  "bin": {
+    "forge": "bin/forge.js",
+    "forge-preflight": "bin/forge-preflight.js"
+  },
+  "workspaces": [
+    "packages/*"
+  ],
+  "scripts": {
+    "test": "bun test --timeout 15000",
+    "test:setup": "bash test-env/automation/setup-fixtures.sh",
+    "test:all": "bun run test:setup && bun test",
+    "test:coverage": "c8 --check-coverage bun test",
+    "typecheck": "echo 'No TypeScript in project - skipping type check'",
+    "lint": "eslint . --max-warnings 0",
+    "check": "bash scripts/validate.sh",
+    "prepare": "lefthook install || echo 'Note: lefthook not installed. Git hooks disabled. Run: bun add -d lefthook'",
+    "setup": "node ./bin/forge.js setup",
+    "help": "node ./bin/forge.js --help",
+    "validate:yaml": "find . \\( -name '*.yml' -o -name '*.yaml' \\) | grep -v node_modules | while IFS= read -r file; do echo \"Checking $file...\" && bun x js-yaml \"$file\" > /dev/null || exit 1; done",
+    "test:mutation": "npx stryker run",
+    "test:benchmark": "node scripts/benchmark.js",
+    "test:dashboard": "node scripts/test-dashboard.js"
+  },
+  "peerDependencies": {
+    "lefthook": "^1.0.0"
+  },
+  "peerDependenciesMeta": {
+    "lefthook": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@commitlint/cli": "^20.4.1",
+    "@commitlint/config-conventional": "^20.4.1",
+    "@eslint/js": "^10.0.1",
+    "@microsoft/eslint-formatter-sarif": "^3.1.0",
+    "@stryker-mutator/core": "^9.6.0",
+    "c8": "^11.0.0",
+    "eslint": "^10.0.2",
+    "globals": "^17.3.0",
+    "js-yaml": "^4.1.1",
+    "lefthook": "^1.10.1",
+    "yaml": "^2.8.2"
+  },
+  "keywords": [
+    "ai",
+    "workflow",
+    "tdd",
+    "agents-md",
+    "claude-code",
+    "cursor",
+    "kilo-code",
+    "opencode",
+    "copilot",
+    "cline",
+    "roo-code",
+    "codex",
+    "development",
+    "testing"
+  ],
+  "author": "Harsha Nandak",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/harshanandak/forge.git"
+  },
+  "homepage": "https://github.com/harshanandak/forge#readme",
+  "bugs": {
+    "url": "https://github.com/harshanandak/forge/issues"
+  },
+  "files": [
+    "bin/",
+    "lib/",
+    "skills/",
+    ".claude/commands/",
+    ".claude/rules/",
+    ".claude/scripts/",
+    ".claude/skills/",
+    ".cursor/",
+    ".cline/",
+    ".roo/",
+    ".codex/",
+    ".kilocode/",
+    ".opencode/",
+    "scripts/",
+    ".github/prompts/",
+    ".github/PLUGIN_TEMPLATE.json",
+    ".github/workflows/github-to-beads.yml",
+    ".github/workflows/beads-to-github.yml",
+    ".forge/hooks/",
+    "docs/*.md",
+    "install.sh",
+    "lefthook.yml",
+    "AGENTS.md",
+    "CLAUDE.md",
+    ".mcp.json.example"
+  ],
+  "dependencies": {
+    "@babel/parser": "^7.29.2",
+    "fastest-levenshtein": "^1.0.16"
+  },
+  "overrides": {
+    "eslint": "^10.0.2",
+    "flatted": "3.4.2",
+    "minimatch": "10.2.4"
+  },
+  "c8": {
+    "lines": 80,
+    "branches": 80,
+    "functions": 80,
+    "statements": 80,
+    "exclude": [
+      "test/**",
+      "test-env/**",
+      "**/*.test.js",
+      "**/*.spec.js",
+      "coverage/**",
+      ".forge/hooks/**",
+      "bin/forge.js"
+    ],
+    "reporter": [
+      "text",
+      "lcov",
+      "html"
+    ]
+  }
+}