@claude-flow/hooks 3.0.0-alpha.1

package/dist/workers/session-hook.js

@@ -0,0 +1,172 @@
+/**
+ * Session Start Hook Integration
+ *
+ * Auto-starts workers when Claude Code session begins.
+ */
+import { createWorkerManager } from './index.js';
+import * as path from 'path';
+// ============================================================================
+// Session Hook Functions
+// ============================================================================
+/**
+ * Initialize workers on session start
+ *
+ * Call this from your SessionStart hook to auto-start the worker system.
+ */
+export async function onSessionStart(config = {}) {
+    const { projectRoot = process.cwd(), autoStart = true, runInitialScan = true, workers = ['health', 'security', 'git'], } = config;
+    try {
+        // Create and initialize manager
+        const manager = createWorkerManager(projectRoot);
+        await manager.initialize();
+        let initialResults;
+        // Run initial scan of critical workers
+        if (runInitialScan && workers.length > 0) {
+            initialResults = {};
+            for (const workerName of workers) {
+                try {
+                    const result = await manager.runWorker(workerName);
+                    initialResults[workerName] = {
+                        success: result.success,
+                        data: result.data,
+                        alerts: result.alerts,
+                    };
+                }
+                catch {
+                    initialResults[workerName] = { success: false, error: 'Worker failed' };
+                }
+            }
+        }
+        // Start scheduled workers
+        if (autoStart) {
+            await manager.start({
+                autoSave: true,
+                statuslineUpdate: true,
+            });
+        }
+        return {
+            success: true,
+            manager,
+            initialResults,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            manager: createWorkerManager(projectRoot),
+            error: error instanceof Error ? error.message : String(error),
+        };
+    }
+}
+/**
+ * Clean up workers on session end
+ */
+export async function onSessionEnd(manager) {
+    await manager.stop();
+}
+/**
+ * Generate session start output for Claude Code hooks
+ *
+ * Returns formatted output suitable for Claude Code SessionStart hook.
+ */
+export function formatSessionStartOutput(result) {
+    const lines = [];
+    if (result.success) {
+        lines.push('[Workers] System initialized');
+        if (result.initialResults) {
+            const healthResult = result.initialResults.health;
+            const securityResult = result.initialResults.security;
+            const gitResult = result.initialResults.git;
+            if (healthResult?.data) {
+                const status = healthResult.data.status || 'unknown';
+                const icon = status === 'healthy' ? '✓' : status === 'warning' ? '⚠' : '✗';
+                lines.push(`  ${icon} Health: ${status}`);
+            }
+            if (securityResult?.data) {
+                const status = securityResult.data.status || 'unknown';
+                const issues = securityResult.data.totalIssues || 0;
+                const icon = status === 'clean' ? '✓' : status === 'warning' ? '⚠' : '✗';
+                lines.push(`  ${icon} Security: ${status} (${issues} issues)`);
+            }
+            if (gitResult?.data) {
+                const branch = gitResult.data.branch || 'unknown';
+                const uncommitted = gitResult.data.uncommitted || 0;
+                lines.push(`  ├─ Branch: ${branch}`);
+                lines.push(`  └─ Uncommitted: ${uncommitted}`);
+            }
+        }
+        lines.push('[Workers] Background scheduling started');
+    }
+    else {
+        lines.push(`[Workers] Failed to initialize: ${result.error}`);
+    }
+    return lines.join('\n');
+}
+// ============================================================================
+// Shell Script Generator
+// ============================================================================
+/**
+ * Generate a shell hook script for integration with .claude/settings.json
+ */
+export function generateShellHook(projectRoot) {
+    const hookPath = path.join(projectRoot, 'v3', '@claude-flow', 'hooks');
+    return `#!/bin/bash
+# Claude Flow V3 Workers - Session Start Hook
+# Auto-generated - do not edit manually
+
+set -euo pipefail
+
+PROJECT_ROOT="${projectRoot}"
+HOOKS_PATH="${hookPath}"
+
+# Run worker initialization via Node.js
+node --experimental-specifier-resolution=node -e "
+const { onSessionStart, formatSessionStartOutput } = require('\${HOOKS_PATH}/dist/workers/session-hook.js');
+
+async function main() {
+  const result = await onSessionStart({
+    projectRoot: '\${PROJECT_ROOT}',
+    autoStart: true,
+    runInitialScan: true,
+    workers: ['health', 'security', 'git'],
+  });
+
+  console.log(formatSessionStartOutput(result));
+}
+
+main().catch(err => {
+  console.error('[Workers] Error:', err.message);
+  process.exit(1);
+});
+"
+`;
+}
+// ============================================================================
+// Integration Helper
+// ============================================================================
+/**
+ * Create a global worker manager instance for the session
+ */
+let globalManager = null;
+export function getGlobalManager() {
+    return globalManager;
+}
+export function setGlobalManager(manager) {
+    globalManager = manager;
+}
+export async function initializeGlobalManager(projectRoot) {
+    if (globalManager) {
+        return globalManager;
+    }
+    const result = await onSessionStart({
+        projectRoot,
+        autoStart: true,
+        runInitialScan: true,
+    });
+    if (!result.success) {
+        throw new Error(result.error || 'Failed to initialize worker manager');
+    }
+    globalManager = result.manager;
+    return globalManager;
+}
+//# sourceMappingURL=session-hook.js.map

package/dist/workers/session-hook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-hook.js","sourceRoot":"","sources":["../../src/workers/session-hook.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,101 @@
+{
+  "name": "@claude-flow/hooks",
+  "version": "3.0.0-alpha.1",
+  "description": "V3 Hooks System - Event-driven lifecycle hooks with ReasoningBank learning integration",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.js",
+      "import": "./dist/index.js"
+    },
+    "./registry": {
+      "types": "./dist/registry/index.d.js",
+      "import": "./dist/registry/index.js"
+    },
+    "./executor": {
+      "types": "./dist/executor/index.d.js",
+      "import": "./dist/executor/index.js"
+    },
+    "./daemons": {
+      "types": "./dist/daemons/index.d.js",
+      "import": "./dist/daemons/index.js"
+    },
+    "./statusline": {
+      "types": "./dist/statusline/index.d.js",
+      "import": "./dist/statusline/index.js"
+    },
+    "./mcp": {
+      "types": "./dist/mcp/index.d.js",
+      "import": "./dist/mcp/index.js"
+    },
+    "./reasoningbank": {
+      "types": "./dist/reasoningbank/index.d.js",
+      "import": "./dist/reasoningbank/index.js"
+    },
+    "./guidance": {
+      "types": "./dist/reasoningbank/guidance-provider.d.js",
+      "import": "./dist/reasoningbank/guidance-provider.js"
+    }
+  },
+  "files": [
+    "dist",
+    "bin",
+    "scripts"
+  ],
+  "bin": {
+    "hooks-daemon": "./bin/hooks-daemon.js",
+    "statusline": "./bin/statusline.js",
+    "claude-flow-hooks": "./dist/cli/guidance-cli.js",
+    "guidance": "./dist/cli/guidance-cli.js"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "clean": "rm -rf dist",
+    "test": "vitest run",
+    "test:watch": "vitest watch",
+    "test:coverage": "vitest run --coverage",
+    "lint": "eslint src --ext .ts",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@claude-flow/shared": "^3.0.0-alpha.1",
+    "@claude-flow/neural": "^3.0.0-alpha.1",
+    "@claude-flow/memory": "^3.0.0-alpha.1",
+    "better-sqlite3": "^11.0.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.11",
+    "@types/node": "^20.10.0",
+    "typescript": "^5.3.0",
+    "vitest": "^2.0.0"
+  },
+  "peerDependencies": {
+    "@claude-flow/shared": "^3.0.0-alpha.1"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "keywords": [
+    "claude-flow",
+    "hooks",
+    "daemons",
+    "statusline",
+    "reasoningbank",
+    "mcp",
+    "agents"
+  ],
+  "author": "Claude Flow Team",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ruvnet/claude-flow.git",
+    "directory": "v3/@claude-flow/hooks"
+  },
+  "publishConfig": {
+    "access": "public",
+    "tag": "v3alpha"
+  }
+}