workflow-agent-cli 2.1.0 → 2.2.0

package/dist/config/index.js

@@ -5,7 +5,7 @@ import {
   loadConfig,
   validateConfig,
   validateScopeName
-} from "../chunk-B27W7GWP.js";
+} from "../chunk-IPMSSOXR.js";
 export {
   DEFAULT_RESERVED_SCOPE_NAMES,
   WorkflowConfigSchema,

package/dist/index.js

@@ -5,7 +5,7 @@ import {
   validateBranchName,
   validateCommitMessage,
   validatePRTitle
-} from "./chunk-X2NQJ2ZY.js";
+} from "./chunk-NMHWD2GA.js";
 import {
   DEFAULT_RESERVED_SCOPE_NAMES,
   WorkflowConfigSchema,
@@ -13,7 +13,7 @@ import {
   loadConfig,
   validateConfig,
   validateScopeName
-} from "./chunk-B27W7GWP.js";
+} from "./chunk-IPMSSOXR.js";
 export {
   DEFAULT_RESERVED_SCOPE_NAMES,
   WorkflowConfigSchema,

package/dist/scripts/postinstall.js

@@ -48,7 +48,9 @@ function addScriptsToPackageJson() {
       return;
     }
     let addedCount = 0;
-    for (const [scriptName, scriptCommand] of Object.entries(WORKFLOW_SCRIPTS)) {
+    for (const [scriptName, scriptCommand] of Object.entries(
+      WORKFLOW_SCRIPTS
+    )) {
       if (!packageJson.scripts[scriptName]) {
         packageJson.scripts[scriptName] = scriptCommand;
         addedCount++;
@@ -64,7 +66,9 @@ function addScriptsToPackageJson() {
       Object.keys(WORKFLOW_SCRIPTS).forEach((scriptName) => {
         console.log(`  - ${scriptName}`);
       });
-      console.log("\nRun them with: npm run workflow:init (or pnpm run workflow:init)\n");
+      console.log(
+        "\nRun them with: npm run workflow:init (or pnpm run workflow:init)\n"
+      );
     }
   } catch (error) {
   }

package/dist/scripts/postinstall.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/scripts/postinstall.ts"],"sourcesContent":["#!/usr/bin/env node\n\n/**\n * Post-install script that automatically adds workflow scripts to package.json\n * when installed as a local dependency (not global)\n */\n\nimport { readFileSync, writeFileSync, existsSync } from 'fs';\nimport { join } from 'path';\n\nconst WORKFLOW_SCRIPTS = {\n  'workflow:init': 'workflow-agent init',\n  'workflow:validate': 'workflow-agent validate',\n  'workflow:suggest': 'workflow-agent suggest',\n  'workflow:doctor': 'workflow-agent doctor',\n};\n\nfunction isGlobalInstall(): boolean {\n  // Check if we're being installed globally\n  const installPath = process.env.npm_config_global;\n  return installPath === 'true';\n}\n\nfunction findProjectRoot(): string | null {\n  // When installed as a dependency, npm/pnpm runs postinstall from the package directory\n  // which is inside node_modules/@hawkinside_out/workflow-agent\n  // We need to find the project root (the directory containing node_modules)\n  \n  let currentDir = process.cwd();\n  \n  // Check if we're inside node_modules\n  if (currentDir.includes('node_modules')) {\n    // Split on 'node_modules' and take everything before it\n    // This handles both node_modules/@scope/package and node_modules/package\n    const parts = currentDir.split('node_modules');\n    if (parts.length > 0 && parts[0]) {\n      // Remove trailing slash\n      return parts[0].replace(/\\/$/, '');\n    }\n  }\n  \n  // If not in node_modules, we're probably in a monorepo workspace during development\n  // Don't modify package.json in this case\n  return null;\n}\n\nfunction addScriptsToPackageJson(): void {\n  try {\n    // Don't run for global installs\n    if (isGlobalInstall()) {\n      return;\n    }\n\n    const projectRoot = findProjectRoot();\n    if (!projectRoot) {\n      return;\n    }\n\n    const packageJsonPath = join(projectRoot, 'package.json');\n    \n    if (!existsSync(packageJsonPath)) {\n      return;\n    }\n\n    // Read existing package.json\n    const packageJsonContent = readFileSync(packageJsonPath, 'utf-8');\n    const packageJson = JSON.parse(packageJsonContent);\n\n    // Initialize scripts object if it doesn't exist\n    if (!packageJson.scripts) {\n      packageJson.scripts = {};\n    }\n\n    // Check if any workflow scripts already exist\n    const hasWorkflowScripts = Object.keys(WORKFLOW_SCRIPTS).some(\n      (scriptName) => packageJson.scripts[scriptName]\n    );\n\n    if (hasWorkflowScripts) {\n      // Scripts already exist, don't overwrite\n      return;\n    }\n\n    // Add workflow scripts\n    let addedCount = 0;\n    for (const [scriptName, scriptCommand] of Object.entries(WORKFLOW_SCRIPTS)) {\n      if (!packageJson.scripts[scriptName]) {\n        packageJson.scripts[scriptName] = scriptCommand;\n        addedCount++;\n      }\n    }\n\n    if (addedCount > 0) {\n      // Write back to package.json with proper formatting\n      writeFileSync(\n        packageJsonPath,\n        JSON.stringify(packageJson, null, 2) + '\\n',\n        'utf-8'\n      );\n\n      console.log('\\n✓ Added workflow scripts to package.json:');\n      Object.keys(WORKFLOW_SCRIPTS).forEach((scriptName) => {\n        console.log(`  - ${scriptName}`);\n      });\n      console.log('\\nRun them with: npm run workflow:init (or pnpm run workflow:init)\\n');\n    }\n  } catch (error) {\n    // Silently fail - this is a nice-to-have feature\n    // We don't want to break the installation if something goes wrong\n  }\n}\n\n// Run the script\naddScriptsToPackageJson();\n"],"mappings":";;;AAOA,SAAS,cAAc,eAAe,kBAAkB;AACxD,SAAS,YAAY;AAErB,IAAM,mBAAmB;AAAA,EACvB,iBAAiB;AAAA,EACjB,qBAAqB;AAAA,EACrB,oBAAoB;AAAA,EACpB,mBAAmB;AACrB;AAEA,SAAS,kBAA2B;AAElC,QAAM,cAAc,QAAQ,IAAI;AAChC,SAAO,gBAAgB;AACzB;AAEA,SAAS,kBAAiC;AAKxC,MAAI,aAAa,QAAQ,IAAI;AAG7B,MAAI,WAAW,SAAS,cAAc,GAAG;AAGvC,UAAM,QAAQ,WAAW,MAAM,cAAc;AAC7C,QAAI,MAAM,SAAS,KAAK,MAAM,CAAC,GAAG;AAEhC,aAAO,MAAM,CAAC,EAAE,QAAQ,OAAO,EAAE;AAAA,IACnC;AAAA,EACF;AAIA,SAAO;AACT;AAEA,SAAS,0BAAgC;AACvC,MAAI;AAEF,QAAI,gBAAgB,GAAG;AACrB;AAAA,IACF;AAEA,UAAM,cAAc,gBAAgB;AACpC,QAAI,CAAC,aAAa;AAChB;AAAA,IACF;AAEA,UAAM,kBAAkB,KAAK,aAAa,cAAc;AAExD,QAAI,CAAC,WAAW,eAAe,GAAG;AAChC;AAAA,IACF;AAGA,UAAM,qBAAqB,aAAa,iBAAiB,OAAO;AAChE,UAAM,cAAc,KAAK,MAAM,kBAAkB;AAGjD,QAAI,CAAC,YAAY,SAAS;AACxB,kBAAY,UAAU,CAAC;AAAA,IACzB;AAGA,UAAM,qBAAqB,OAAO,KAAK,gBAAgB,EAAE;AAAA,MACvD,CAAC,eAAe,YAAY,QAAQ,UAAU;AAAA,IAChD;AAEA,QAAI,oBAAoB;AAEtB;AAAA,IACF;AAGA,QAAI,aAAa;AACjB,eAAW,CAAC,YAAY,aAAa,KAAK,OAAO,QAAQ,gBAAgB,GAAG;AAC1E,UAAI,CAAC,YAAY,QAAQ,UAAU,GAAG;AACpC,oBAAY,QAAQ,UAAU,IAAI;AAClC;AAAA,MACF;AAAA,IACF;AAEA,QAAI,aAAa,GAAG;AAElB;AAAA,QACE;AAAA,QACA,KAAK,UAAU,aAAa,MAAM,CAAC,IAAI;AAAA,QACvC;AAAA,MACF;AAEA,cAAQ,IAAI,kDAA6C;AACzD,aAAO,KAAK,gBAAgB,EAAE,QAAQ,CAAC,eAAe;AACpD,gBAAQ,IAAI,OAAO,UAAU,EAAE;AAAA,MACjC,CAAC;AACD,cAAQ,IAAI,sEAAsE;AAAA,IACpF;AAAA,EACF,SAAS,OAAO;AAAA,EAGhB;AACF;AAGA,wBAAwB;","names":[]}
+{"version":3,"sources":["../../src/scripts/postinstall.ts"],"sourcesContent":["#!/usr/bin/env node\n\n/**\n * Post-install script that automatically adds workflow scripts to package.json\n * when installed as a local dependency (not global)\n */\n\nimport { readFileSync, writeFileSync, existsSync } from \"fs\";\nimport { join } from \"path\";\n\nconst WORKFLOW_SCRIPTS = {\n  \"workflow:init\": \"workflow-agent init\",\n  \"workflow:validate\": \"workflow-agent validate\",\n  \"workflow:suggest\": \"workflow-agent suggest\",\n  \"workflow:doctor\": \"workflow-agent doctor\",\n};\n\nfunction isGlobalInstall(): boolean {\n  // Check if we're being installed globally\n  const installPath = process.env.npm_config_global;\n  return installPath === \"true\";\n}\n\nfunction findProjectRoot(): string | null {\n  // When installed as a dependency, npm/pnpm runs postinstall from the package directory\n  // which is inside node_modules/@hawkinside_out/workflow-agent\n  // We need to find the project root (the directory containing node_modules)\n\n  let currentDir = process.cwd();\n\n  // Check if we're inside node_modules\n  if (currentDir.includes(\"node_modules\")) {\n    // Split on 'node_modules' and take everything before it\n    // This handles both node_modules/@scope/package and node_modules/package\n    const parts = currentDir.split(\"node_modules\");\n    if (parts.length > 0 && parts[0]) {\n      // Remove trailing slash\n      return parts[0].replace(/\\/$/, \"\");\n    }\n  }\n\n  // If not in node_modules, we're probably in a monorepo workspace during development\n  // Don't modify package.json in this case\n  return null;\n}\n\nfunction addScriptsToPackageJson(): void {\n  try {\n    // Don't run for global installs\n    if (isGlobalInstall()) {\n      return;\n    }\n\n    const projectRoot = findProjectRoot();\n    if (!projectRoot) {\n      return;\n    }\n\n    const packageJsonPath = join(projectRoot, \"package.json\");\n\n    if (!existsSync(packageJsonPath)) {\n      return;\n    }\n\n    // Read existing package.json\n    const packageJsonContent = readFileSync(packageJsonPath, \"utf-8\");\n    const packageJson = JSON.parse(packageJsonContent);\n\n    // Initialize scripts object if it doesn't exist\n    if (!packageJson.scripts) {\n      packageJson.scripts = {};\n    }\n\n    // Check if any workflow scripts already exist\n    const hasWorkflowScripts = Object.keys(WORKFLOW_SCRIPTS).some(\n      (scriptName) => packageJson.scripts[scriptName],\n    );\n\n    if (hasWorkflowScripts) {\n      // Scripts already exist, don't overwrite\n      return;\n    }\n\n    // Add workflow scripts\n    let addedCount = 0;\n    for (const [scriptName, scriptCommand] of Object.entries(\n      WORKFLOW_SCRIPTS,\n    )) {\n      if (!packageJson.scripts[scriptName]) {\n        packageJson.scripts[scriptName] = scriptCommand;\n        addedCount++;\n      }\n    }\n\n    if (addedCount > 0) {\n      // Write back to package.json with proper formatting\n      writeFileSync(\n        packageJsonPath,\n        JSON.stringify(packageJson, null, 2) + \"\\n\",\n        \"utf-8\",\n      );\n\n      console.log(\"\\n✓ Added workflow scripts to package.json:\");\n      Object.keys(WORKFLOW_SCRIPTS).forEach((scriptName) => {\n        console.log(`  - ${scriptName}`);\n      });\n      console.log(\n        \"\\nRun them with: npm run workflow:init (or pnpm run workflow:init)\\n\",\n      );\n    }\n  } catch (error) {\n    // Silently fail - this is a nice-to-have feature\n    // We don't want to break the installation if something goes wrong\n  }\n}\n\n// Run the script\naddScriptsToPackageJson();\n"],"mappings":";;;AAOA,SAAS,cAAc,eAAe,kBAAkB;AACxD,SAAS,YAAY;AAErB,IAAM,mBAAmB;AAAA,EACvB,iBAAiB;AAAA,EACjB,qBAAqB;AAAA,EACrB,oBAAoB;AAAA,EACpB,mBAAmB;AACrB;AAEA,SAAS,kBAA2B;AAElC,QAAM,cAAc,QAAQ,IAAI;AAChC,SAAO,gBAAgB;AACzB;AAEA,SAAS,kBAAiC;AAKxC,MAAI,aAAa,QAAQ,IAAI;AAG7B,MAAI,WAAW,SAAS,cAAc,GAAG;AAGvC,UAAM,QAAQ,WAAW,MAAM,cAAc;AAC7C,QAAI,MAAM,SAAS,KAAK,MAAM,CAAC,GAAG;AAEhC,aAAO,MAAM,CAAC,EAAE,QAAQ,OAAO,EAAE;AAAA,IACnC;AAAA,EACF;AAIA,SAAO;AACT;AAEA,SAAS,0BAAgC;AACvC,MAAI;AAEF,QAAI,gBAAgB,GAAG;AACrB;AAAA,IACF;AAEA,UAAM,cAAc,gBAAgB;AACpC,QAAI,CAAC,aAAa;AAChB;AAAA,IACF;AAEA,UAAM,kBAAkB,KAAK,aAAa,cAAc;AAExD,QAAI,CAAC,WAAW,eAAe,GAAG;AAChC;AAAA,IACF;AAGA,UAAM,qBAAqB,aAAa,iBAAiB,OAAO;AAChE,UAAM,cAAc,KAAK,MAAM,kBAAkB;AAGjD,QAAI,CAAC,YAAY,SAAS;AACxB,kBAAY,UAAU,CAAC;AAAA,IACzB;AAGA,UAAM,qBAAqB,OAAO,KAAK,gBAAgB,EAAE;AAAA,MACvD,CAAC,eAAe,YAAY,QAAQ,UAAU;AAAA,IAChD;AAEA,QAAI,oBAAoB;AAEtB;AAAA,IACF;AAGA,QAAI,aAAa;AACjB,eAAW,CAAC,YAAY,aAAa,KAAK,OAAO;AAAA,MAC/C;AAAA,IACF,GAAG;AACD,UAAI,CAAC,YAAY,QAAQ,UAAU,GAAG;AACpC,oBAAY,QAAQ,UAAU,IAAI;AAClC;AAAA,MACF;AAAA,IACF;AAEA,QAAI,aAAa,GAAG;AAElB;AAAA,QACE;AAAA,QACA,KAAK,UAAU,aAAa,MAAM,CAAC,IAAI;AAAA,QACvC;AAAA,MACF;AAEA,cAAQ,IAAI,kDAA6C;AACzD,aAAO,KAAK,gBAAgB,EAAE,QAAQ,CAAC,eAAe;AACpD,gBAAQ,IAAI,OAAO,UAAU,EAAE;AAAA,MACjC,CAAC;AACD,cAAQ;AAAA,QACN;AAAA,MACF;AAAA,IACF;AAAA,EACF,SAAS,OAAO;AAAA,EAGhB;AACF;AAGA,wBAAwB;","names":[]}

package/dist/validators/index.js

@@ -5,7 +5,7 @@ import {
   validateBranchName,
   validateCommitMessage,
   validatePRTitle
-} from "../chunk-X2NQJ2ZY.js";
+} from "../chunk-NMHWD2GA.js";
 export {
   discoverCustomScopes,
   getAllScopes,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "workflow-agent-cli",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "description": "A self-evolving workflow management system for AI agent development",
   "keywords": [
     "workflow",
@@ -41,6 +41,19 @@
     "templates",
     "README.md"
   ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "test:unit": "vitest run --exclude 'src/**/*.e2e.test.ts'",
+    "test:e2e": "vitest run 'src/**/*.e2e.test.ts'",
+    "lint": "exit 0",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist",
+    "postinstall": "node dist/scripts/postinstall.js || true"
+  },
   "dependencies": {
     "@clack/prompts": "^0.7.0",
     "@hawkinside_out/workflow-improvement-tracker": "^1.0.0",
@@ -69,18 +82,5 @@
   },
   "publishConfig": {
     "access": "public"
-  },
-  "scripts": {
-    "build": "tsup",
-    "dev": "tsup --watch",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "test:coverage": "vitest run --coverage",
-    "test:unit": "vitest run --exclude 'src/**/*.e2e.test.ts'",
-    "test:e2e": "vitest run 'src/**/*.e2e.test.ts'",
-    "lint": "eslint src",
-    "typecheck": "tsc --noEmit",
-    "clean": "rm -rf dist",
-    "postinstall": "node dist/scripts/postinstall.js || true"
   }
-}
+}

package/templates/AGENT_EDITING_INSTRUCTIONS.md

@@ -144,6 +144,176 @@ Any decisions, blockers, or context for future reference.
 
 > ⚠️ **IMPORTANT**: Never push directly to `main`. Always push to your feature branch and create a PR.
 
+---
+
+## 🚨 MANDATORY PRE-COMMIT CHECKLIST - ZERO EXCEPTIONS
+
+> **CRITICAL RULE**: This is a "one-and-done" service commitment. The following pre-commit checks are MANDATORY before ANY commit and push. There are ZERO EXCEPTIONS to this rule.
+
+### Auto-Setup Guarantee
+
+**If ANY mandatory check tool is not configured** (missing config files, scripts, or dependencies), Agent MUST automatically set them up based on industry best practices BEFORE running checks.
+
+👉 **Complete auto-setup documentation**: [../../docs/AUTO_SETUP_TOOLS.md](../../docs/AUTO_SETUP_TOOLS.md)
+
+### The Rule
+
+**Before EVERY commit and push, Agent MUST:**
+
+1. ✅ **Run all pre-commit checks** (listed below)
+2. 🔧 **Fix ALL errors encountered** automatically
+3. 🔄 **Re-run checks** until all pass
+4. ✅ **Only then commit and push**
+
+### Pre-Commit Execution Sequence
+
+Execute these commands in this exact order. If ANY command fails, fix the errors and restart from step 1:
+
+#### Step 1: Type Check
+
+```bash
+pnpm typecheck
+```
+
+**If errors occur:**
+
+- Fix all TypeScript type errors
+- Remove any `any` types
+- Ensure proper type imports
+- Re-run until clean
+
+#### Step 2: Lint Check
+
+```bash
+pnpm lint
+```
+
+**If errors occur:**
+
+- Fix all ESLint errors
+- Address all warnings
+- Ensure import ordering is correct
+- Re-run until clean
+
+#### Step 3: Format Check
+
+```bash
+pnpm format
+```
+
+**This command auto-fixes, then verify:**
+
+- All files are properly formatted
+- No formatting inconsistencies remain
+
+#### Step 4: Unit Tests
+
+```bash
+pnpm test
+```
+
+**If tests fail:**
+
+- Fix failing test logic
+- Update test expectations if changes are intentional
+- Add missing test coverage for new code
+- Re-run until all tests pass
+
+#### Step 5: Build Verification
+
+```bash
+pnpm build
+```
+
+**If build fails:**
+
+- Fix compilation errors
+- Resolve module resolution issues
+- Ensure all imports are valid
+- Re-run until build succeeds
+
+### Automated Pre-Commit Check Script
+
+Agent should execute this comprehensive check:
+
+```bash
+#!/bin/bash
+# Pre-commit validation - ALL must pass
+
+echo "🔍 Running pre-commit checks..."
+
+echo "📘 Step 1/5: Type checking..."
+pnpm typecheck || { echo "❌ Type check failed. Fix errors and retry."; exit 1; }
+
+echo "🔍 Step 2/5: Linting..."
+pnpm lint || { echo "❌ Lint check failed. Fix errors and retry."; exit 1; }
+
+echo "✨ Step 3/5: Formatting..."
+pnpm format || { echo "❌ Format check failed. Fix errors and retry."; exit 1; }
+
+echo "🧪 Step 4/5: Unit tests..."
+pnpm test || { echo "❌ Tests failed. Fix errors and retry."; exit 1; }
+
+echo "🏗️  Step 5/5: Build verification..."
+pnpm build || { echo "❌ Build failed. Fix errors and retry."; exit 1; }
+
+echo "✅ All pre-commit checks passed! Ready to commit."
+```
+
+### Agent Workflow for Commits
+
+When Agent is ready to commit, follow this EXACT workflow:
+
+1. **Stage changes**: `git add .`
+
+2. **Run pre-commit checks**: Execute all 5 steps above
+
+3. **If ANY check fails**:
+   - Analyze the error output
+   - Fix the errors in the codebase
+   - Commit the fixes
+   - Return to step 2 (re-run ALL checks)
+
+4. **When ALL checks pass**:
+   - Commit with proper message: `git commit -m "<type>(<scope>): <description>"`
+   - Push to branch: `git push origin <branch-name>`
+
+5. **Verification**: After push, confirm:
+   - GitHub Actions pipeline is triggered
+   - All CI checks are passing
+   - No pipeline failures
+
+### Error Handling Protocol
+
+**When errors are encountered:**
+
+| Error Type    | Agent Action                                                 |
+| ------------- | ------------------------------------------------------------ |
+| Type errors   | Analyze and fix type definitions, imports, and usage         |
+| Lint errors   | Apply auto-fix where possible, manual fix for complex issues |
+| Format errors | Re-run `pnpm format` (usually auto-fixes)                    |
+| Test failures | Update test logic, fix implementation, or update snapshots   |
+| Build errors  | Fix compilation issues, resolve imports, check dependencies  |
+
+**After fixing errors:**
+
+- ✅ Commit the fixes separately if needed
+- 🔄 Re-run the COMPLETE pre-commit checklist from step 1
+- ⚠️ Never skip steps or assume fixes worked without verification
+
+### Accountability
+
+This workflow ensures:
+
+- ✅ **Zero regressions** reach the main branch
+- ✅ **All code is production-ready** before merging
+- ✅ **CI/CD pipelines always pass** (no surprises)
+- ✅ **"One-and-done"** - customers receive working code, first time
+
+> 🔒 **ENFORCEMENT**: This rule has ZERO EXCEPTIONS. Agent will not commit or push code that fails any of these checks. Period.
+
+---
+
 ### Auto-Cleanup Rules
 
 | Trigger                      | Action                                        |
@@ -350,15 +520,15 @@ Every component story file MUST include:
 **Story Template:**
 
 ```tsx
-import type { Meta, StoryObj } from '@storybook/nextjs-vite';
-import { ComponentName } from './ui/component-name';
-import { mockFeatureFlags } from '@/lib/feature-flags';
+import type { Meta, StoryObj } from "@storybook/nextjs-vite";
+import { ComponentName } from "./ui/component-name";
+import { mockFeatureFlags } from "@/lib/feature-flags";
 
 const meta: Meta<typeof ComponentName> = {
-  title: 'Category/ComponentName',
+  title: "Category/ComponentName",
   component: ComponentName,
-  tags: ['autodocs'],
-  parameters: { layout: 'centered' },
+  tags: ["autodocs"],
+  parameters: { layout: "centered" },
   decorators: [
     (Story) => {
       mockFeatureFlags({ FEATURE_FLAG: true });
@@ -501,28 +671,28 @@ Imports MUST follow this exact order, with blank lines between groups:
 
 ```typescript
 // 1. Directive (MUST be first line if present)
-'use server';
+"use server";
 // OR
-'use client';
+"use client";
 
 // 2. React imports
-import React, { useState, useEffect, useCallback } from 'react';
+import React, { useState, useEffect, useCallback } from "react";
 
 // 3. External library imports (alphabetical)
-import { useDrag } from 'react-dnd';
-import { QueryClient } from '@tanstack/react-query';
-import { z } from 'zod';
+import { useDrag } from "react-dnd";
+import { QueryClient } from "@tanstack/react-query";
+import { z } from "zod";
 
 // 4. Internal absolute imports with @/ prefix (alphabetical by path)
-import { createServerClient } from '@/lib/supabase/server';
-import { verifyBoardAccess } from '@/utils/authorization.server';
-import type { Task, Sprint } from '@/types';
-import { useAuth } from '@/app/providers';
+import { createServerClient } from "@/lib/supabase/server";
+import { verifyBoardAccess } from "@/utils/authorization.server";
+import type { Task, Sprint } from "@/types";
+import { useAuth } from "@/app/providers";
 
 // 5. Relative imports (parent directories first, then siblings)
-import { Button } from '../ui/button';
-import { TaskCard } from './TaskCard';
-import type { LocalType } from './types';
+import { Button } from "../ui/button";
+import { TaskCard } from "./TaskCard";
+import type { LocalType } from "./types";
 ```
 
 ### Naming Conventions
@@ -548,27 +718,31 @@ import type { LocalType } from './types';
 
 ```typescript
 export async function getEntity(
-  id: string
+  id: string,
 ): Promise<{ data: Entity | null; error: string | null }> {
   try {
     // 1. Verify access FIRST
     const access = await verifyEntityAccess(id);
     if (!access.hasAccess) {
-      return { data: null, error: access.error || 'Access denied' };
+      return { data: null, error: access.error || "Access denied" };
     }
 
     const supabase = await createServerClient();
-    const { data, error } = await supabase.from('entities').select('*').eq('id', id).single();
+    const { data, error } = await supabase
+      .from("entities")
+      .select("*")
+      .eq("id", id)
+      .single();
 
     if (error) {
-      console.error('Error fetching entity:', error);
+      console.error("Error fetching entity:", error);
       return { data: null, error: error.message };
     }
 
     return { data: transformEntity(data), error: null };
   } catch (err) {
-    console.error('Unexpected error:', err);
-    return { data: null, error: 'An unexpected error occurred' };
+    console.error("Unexpected error:", err);
+    return { data: null, error: "An unexpected error occurred" };
   }
 }
 ```
@@ -583,10 +757,10 @@ const handleSubmit = async () => {
       toast.error(error);
       return;
     }
-    toast.success('Created successfully');
+    toast.success("Created successfully");
     onSuccess?.(data);
   } catch (err) {
-    toast.error('An unexpected error occurred');
+    toast.error("An unexpected error occurred");
   }
 };
 ```
@@ -612,12 +786,12 @@ const handleSubmit = async () => {
 5. **Never expose sensitive data** - filter fields before returning
 
 ```typescript
-'use server';
+"use server";
 
-import { createServerClient } from '@/lib/supabase/server';
-import { verifyBoardAccess } from '@/utils/authorization.server';
-import { revalidatePath } from 'next/cache';
-import type { Task } from '@/types';
+import { createServerClient } from "@/lib/supabase/server";
+import { verifyBoardAccess } from "@/utils/authorization.server";
+import { revalidatePath } from "next/cache";
+import type { Task } from "@/types";
 
 interface TaskRow {
   id: string;
@@ -636,17 +810,20 @@ function transformTask(row: TaskRow): Task {
 }
 
 export async function getTasks(
-  boardId: string
+  boardId: string,
 ): Promise<{ data: Task[] | null; error: string | null }> {
   // 1. Authorization FIRST
   const access = await verifyBoardAccess(boardId);
   if (!access.hasAccess) {
-    return { data: null, error: access.error || 'Access denied' };
+    return { data: null, error: access.error || "Access denied" };
   }
 
   // 2. Fetch data
   const supabase = await createServerClient();
-  const { data, error } = await supabase.from('tasks').select('*').eq('board_id', boardId);
+  const { data, error } = await supabase
+    .from("tasks")
+    .select("*")
+    .eq("board_id", boardId);
 
   if (error) {
     return { data: null, error: error.message };
@@ -717,12 +894,15 @@ export function TaskCard({ task, onEdit, readOnly = false }: TaskCardProps) {
 
 ```typescript
 // Server action
-import { verifyBoardAccess, requireContributorAccess } from '@/utils/authorization.server';
+import {
+  verifyBoardAccess,
+  requireContributorAccess,
+} from "@/utils/authorization.server";
 
 export async function createTask(boardId: string, data: CreateTaskData) {
   const boardAccess = await verifyBoardAccess(boardId);
   if (!boardAccess.hasAccess) {
-    return { data: null, error: 'Access denied' };
+    return { data: null, error: "Access denied" };
   }
 
   // For write operations, also check role
@@ -853,16 +1033,23 @@ When creating a PR, use Agent to automatically fill out the PR description:
 
 Before creating a PR, Agent must verify:
 
+- [ ] **🚨 MANDATORY PRE-COMMIT CHECKLIST completed** - See section above (ZERO EXCEPTIONS)
+  - [ ] ✅ Type check passed (`pnpm typecheck`)
+  - [ ] ✅ Lint check passed (`pnpm lint`)
+  - [ ] ✅ Format check passed (`pnpm format`)
+  - [ ] ✅ Unit tests passed (`pnpm test`)
+  - [ ] ✅ Build verification passed (`pnpm build`)
 - [ ] All required files for the change type have been touched
 - [ ] No `any` types introduced
 - [ ] Authorization added for new data access
 - [ ] Types updated in `types/index.ts`
-- [ ] Unit tests added/updated and passing (`pnpm test`)
-- [ ] E2E tests pass for affected flows (`pnpm test:e2e`)
+- [ ] E2E tests pass for affected flows (`pnpm test:e2e`) if applicable
 - [ ] No unapproved new libraries added
 - [ ] Import order follows the standard
 - [ ] `data-testid` attributes added for testable elements
 
+> ⚠️ **NOTE**: The mandatory pre-commit checklist MUST be completed before even considering a PR. If any pre-commit check fails, the code is not ready for PR.
+
 ---
 
 ## Quick Reference: Path Aliases

package/templates/COMPONENT_LIBRARY.md

@@ -269,11 +269,12 @@ import {
   FormDialogSection,
   FormDialogField,
   useFormDialog,
-} from '@/components/FormDialog';
+} from "@/components/FormDialog";
 
 function CreateSprintDialog() {
-  const { isOpen, isSubmitting, setIsSubmitting, open, close } = useFormDialog();
-  const [name, setName] = useState('');
+  const { isOpen, isSubmitting, setIsSubmitting, open, close } =
+    useFormDialog();
+  const [name, setName] = useState("");
 
   const handleSubmit = async (e: React.FormEvent) => {
     e.preventDefault();
@@ -359,8 +360,13 @@ Use sections to group related fields:
 Use `FormDialogField` error prop for validation:
 
 ```tsx
-<FormDialogField label="Email" required error={errors.email?.message} htmlFor="email">
-  <Input id="email" {...register('email')} />
+<FormDialogField
+  label="Email"
+  required
+  error={errors.email?.message}
+  htmlFor="email"
+>
+  <Input id="email" {...register("email")} />
 </FormDialogField>
 ```
 
@@ -418,14 +424,14 @@ components/
 #### Behavioral Tests
 
 ```typescript
-describe('StatusBadge', () => {
-  it('should render without crashing', () => {});
-  it('should render all status variants', () => {});
-  it('should apply correct colors for each status', () => {});
-  it('should respect size prop', () => {});
-  it('should apply custom className', () => {});
-  it('should handle feature flag disabled state', () => {});
-  it('should handle feature flag enabled state', () => {});
+describe("StatusBadge", () => {
+  it("should render without crashing", () => {});
+  it("should render all status variants", () => {});
+  it("should apply correct colors for each status", () => {});
+  it("should respect size prop", () => {});
+  it("should apply custom className", () => {});
+  it("should handle feature flag disabled state", () => {});
+  it("should handle feature flag enabled state", () => {});
 });
 ```
 
@@ -510,19 +516,19 @@ function TaskRow({ task }) {
 ### Testing with Flags
 
 ```typescript
-import { mockFeatureFlag, clearFeatureFlagMocks } from '@/lib/feature-flags';
+import { mockFeatureFlag, clearFeatureFlagMocks } from "@/lib/feature-flags";
 
-describe('Component with feature flag', () => {
+describe("Component with feature flag", () => {
   afterEach(() => {
     clearFeatureFlagMocks();
   });
 
-  it('should render new component when flag enabled', () => {
+  it("should render new component when flag enabled", () => {
     mockFeatureFlag(FeatureFlag.STATUS_BADGE, true);
     // test new behavior
   });
 
-  it('should render fallback when flag disabled', () => {
+  it("should render fallback when flag disabled", () => {
     mockFeatureFlag(FeatureFlag.STATUS_BADGE, false);
     // test fallback behavior
   });

package/templates/CUSTOM_SCOPE_TEMPLATE.md

@@ -137,11 +137,11 @@ describe('{{presetName}} Scope Preset', () => {
 ## tsup.config.ts Template
 
 ```typescript
-import { defineConfig } from 'tsup';
+import { defineConfig } from "tsup";
 
 export default defineConfig({
-  entry: ['src/index.ts'],
-  format: ['esm'],
+  entry: ["src/index.ts"],
+  format: ["esm"],
   dts: true,
   clean: true,
   sourcemap: true,
@@ -153,6 +153,7 @@ export default defineConfig({
 To create a custom scope package using these templates:
 
 1. **Use the CLI** (recommended):
+
    ```bash
    workflow scope:create
    ```
@@ -180,7 +181,7 @@ Each scope in `{{scopeDefinitions}}` must match:
   name: string;              // lowercase, alphanumeric, hyphens, max 32 chars
   description: string;       // min 10 characters
   emoji?: string;            // optional emoji
-  category?: 'auth' | 'features' | 'infrastructure' | 'documentation' | 
+  category?: 'auth' | 'features' | 'infrastructure' | 'documentation' |
              'testing' | 'performance' | 'other';
 }
 ```