claude-brain 0.15.2 → 0.16.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +191 -191
- package/VERSION +1 -1
- package/assets/CLAUDE-unified.md +11 -11
- package/assets/CLAUDE.md +29 -11
- package/bunfig.toml +8 -8
- package/package.json +82 -82
- package/packs/backend/node.json +173 -173
- package/packs/core/javascript.json +176 -176
- package/packs/core/typescript.json +222 -222
- package/packs/frontend/react.json +254 -254
- package/packs/meta/testing.json +172 -172
- package/scripts/postinstall.mjs +341 -341
- package/src/automation/auto-context.ts +240 -240
- package/src/automation/decision-detector.ts +452 -452
- package/src/automation/index.ts +11 -11
- package/src/automation/phase12-manager.ts +456 -456
- package/src/automation/proactive-recall.ts +373 -373
- package/src/automation/project-detector.ts +310 -310
- package/src/automation/repo-scanner.ts +205 -205
- package/src/cli/auto-setup.ts +82 -82
- package/src/cli/bin.ts +209 -202
- package/src/cli/commands/chroma.ts +573 -573
- package/src/cli/commands/git-hook.ts +189 -189
- package/src/cli/commands/hooks.ts +213 -213
- package/src/cli/commands/init.ts +122 -122
- package/src/cli/commands/install-mcp.ts +92 -92
- package/src/cli/commands/pack.ts +197 -197
- package/src/cli/commands/refresh.ts +323 -0
- package/src/cli/commands/serve.ts +167 -173
- package/src/cli/commands/start.ts +42 -42
- package/src/cli/commands/uninstall-mcp.ts +41 -41
- package/src/cli/commands/update.ts +124 -121
- package/src/cli/diagnose.ts +4 -4
- package/src/cli/health-check.ts +4 -4
- package/src/cli/migrate-chroma.ts +106 -106
- package/src/cli/setup.ts +4 -4
- package/src/cli/ui/animations.ts +80 -80
- package/src/cli/ui/components.ts +82 -82
- package/src/cli/ui/index.ts +4 -4
- package/src/cli/ui/logo.ts +36 -36
- package/src/cli/ui/theme.ts +55 -55
- package/src/config/defaults.ts +50 -50
- package/src/config/home.ts +55 -55
- package/src/config/index.ts +7 -7
- package/src/config/loader.ts +166 -166
- package/src/config/migration.ts +76 -76
- package/src/config/schema.ts +360 -360
- package/src/config/validator.ts +184 -184
- package/src/config/watcher.ts +86 -86
- package/src/context/assembler.ts +398 -398
- package/src/context/cache-manager.ts +101 -101
- package/src/context/formatter.ts +84 -84
- package/src/context/hierarchy.ts +85 -85
- package/src/context/index.ts +83 -83
- package/src/context/progress-tracker.ts +174 -174
- package/src/context/standards-manager.ts +287 -287
- package/src/context/types.ts +252 -252
- package/src/context/validator.ts +58 -58
- package/src/diagnostics/index.ts +123 -123
- package/src/health/index.ts +229 -229
- package/src/hooks/brain-hook.ts +128 -112
- package/src/hooks/capture.ts +168 -205
- package/src/hooks/deduplicator.ts +72 -72
- package/src/hooks/git-capture.ts +109 -109
- package/src/hooks/git-hook-installer.ts +207 -207
- package/src/hooks/index.ts +20 -20
- package/src/hooks/installer.ts +194 -194
- package/src/hooks/passive-classifier.ts +404 -723
- package/src/hooks/queue.ts +129 -129
- package/src/hooks/session-tracker.ts +312 -275
- package/src/hooks/types.ts +47 -47
- package/src/index.ts +7 -7
- package/src/intelligence/cross-project/affinity.ts +162 -162
- package/src/intelligence/cross-project/generalizer.ts +283 -283
- package/src/intelligence/cross-project/index.ts +13 -13
- package/src/intelligence/cross-project/transfer.ts +201 -201
- package/src/intelligence/index.ts +24 -24
- package/src/intelligence/optimization/index.ts +10 -10
- package/src/intelligence/optimization/precompute.ts +202 -202
- package/src/intelligence/optimization/semantic-cache.ts +207 -207
- package/src/intelligence/prediction/context-anticipator.ts +198 -198
- package/src/intelligence/prediction/decision-predictor.ts +184 -184
- package/src/intelligence/prediction/index.ts +13 -13
- package/src/intelligence/prediction/recommender.ts +268 -268
- package/src/intelligence/reasoning/chain-retrieval.ts +247 -247
- package/src/intelligence/reasoning/counterfactual.ts +248 -248
- package/src/intelligence/reasoning/index.ts +13 -13
- package/src/intelligence/reasoning/synthesizer.ts +169 -169
- package/src/intelligence/temporal/evolution.ts +197 -197
- package/src/intelligence/temporal/index.ts +16 -16
- package/src/intelligence/temporal/query-processor.ts +190 -190
- package/src/intelligence/temporal/timeline.ts +259 -259
- package/src/intelligence/temporal/trends.ts +263 -263
- package/src/knowledge/entity-extractor.ts +416 -416
- package/src/knowledge/graph/builder.ts +185 -185
- package/src/knowledge/graph/linker.ts +201 -201
- package/src/knowledge/graph/memory-graph.ts +359 -359
- package/src/knowledge/graph/schema.ts +99 -99
- package/src/knowledge/graph/search.ts +168 -168
- package/src/knowledge/relationship-extractor.ts +108 -108
- package/src/memory/chroma/client.ts +174 -174
- package/src/memory/chroma/collection-manager.ts +94 -94
- package/src/memory/chroma/config.ts +57 -57
- package/src/memory/chroma/embeddings.ts +155 -155
- package/src/memory/chroma/index.ts +82 -82
- package/src/memory/chroma/migration.ts +270 -270
- package/src/memory/chroma/schemas.ts +69 -69
- package/src/memory/chroma/search.ts +315 -315
- package/src/memory/chroma/store.ts +741 -741
- package/src/memory/consolidation/archiver.ts +164 -164
- package/src/memory/consolidation/merger.ts +186 -186
- package/src/memory/consolidation/scorer.ts +138 -138
- package/src/memory/context-builder.ts +236 -236
- package/src/memory/database.ts +169 -169
- package/src/memory/embedding-utils.ts +156 -156
- package/src/memory/embeddings.ts +226 -226
- package/src/memory/episodic/detector.ts +108 -108
- package/src/memory/episodic/manager.ts +351 -351
- package/src/memory/episodic/summarizer.ts +179 -179
- package/src/memory/episodic/types.ts +52 -52
- package/src/memory/index.ts +582 -582
- package/src/memory/knowledge-extractor.ts +455 -455
- package/src/memory/learning.ts +378 -378
- package/src/memory/patterns.ts +396 -396
- package/src/memory/schema.ts +88 -88
- package/src/memory/search.ts +309 -309
- package/src/memory/store.ts +787 -787
- package/src/memory/types.ts +121 -121
- package/src/orchestrator/coordinator.ts +272 -272
- package/src/orchestrator/decision-logger.ts +228 -228
- package/src/orchestrator/event-emitter.ts +198 -198
- package/src/orchestrator/event-queue.ts +184 -184
- package/src/orchestrator/handlers/base-handler.ts +70 -70
- package/src/orchestrator/handlers/context-handler.ts +73 -73
- package/src/orchestrator/handlers/decision-handler.ts +204 -204
- package/src/orchestrator/handlers/index.ts +10 -10
- package/src/orchestrator/handlers/status-handler.ts +131 -131
- package/src/orchestrator/handlers/task-handler.ts +171 -171
- package/src/orchestrator/index.ts +275 -275
- package/src/orchestrator/task-parser.ts +284 -284
- package/src/orchestrator/types.ts +98 -98
- package/src/packs/index.ts +9 -9
- package/src/packs/loader.ts +134 -134
- package/src/packs/manager.ts +204 -204
- package/src/packs/ranker.ts +78 -78
- package/src/packs/types.ts +81 -81
- package/src/phase12/index.ts +5 -5
- package/src/retrieval/bm25/index.ts +300 -300
- package/src/retrieval/bm25/tokenizer.ts +184 -184
- package/src/retrieval/feedback/adaptive.ts +223 -223
- package/src/retrieval/feedback/index.ts +16 -16
- package/src/retrieval/feedback/metrics.ts +223 -223
- package/src/retrieval/feedback/store.ts +283 -283
- package/src/retrieval/fusion/index.ts +194 -194
- package/src/retrieval/fusion/rrf.ts +163 -163
- package/src/retrieval/index.ts +12 -12
- package/src/retrieval/pipeline.ts +375 -375
- package/src/retrieval/query/expander.ts +198 -198
- package/src/retrieval/query/index.ts +27 -27
- package/src/retrieval/query/intent-classifier.ts +236 -236
- package/src/retrieval/query/temporal-parser.ts +295 -295
- package/src/retrieval/reranker/index.ts +188 -188
- package/src/retrieval/reranker/model.ts +95 -95
- package/src/retrieval/service.ts +125 -125
- package/src/retrieval/types.ts +162 -162
- package/src/routing/entity-extractor.ts +428 -428
- package/src/routing/intent-classifier.ts +450 -436
- package/src/routing/response-filter.ts +261 -258
- package/src/routing/router.ts +1441 -1322
- package/src/routing/search-engine.ts +515 -475
- package/src/routing/types.ts +94 -94
- package/src/scripts/health-check.ts +118 -118
- package/src/scripts/setup.ts +122 -122
- package/src/server/handlers/call-tool.ts +156 -156
- package/src/server/handlers/index.ts +9 -9
- package/src/server/handlers/list-tools.ts +35 -35
- package/src/server/handlers/tools/analyze-decision-evolution.ts +151 -151
- package/src/server/handlers/tools/auto-remember.ts +200 -200
- package/src/server/handlers/tools/brain.ts +85 -85
- package/src/server/handlers/tools/create-project.ts +135 -135
- package/src/server/handlers/tools/detect-trends.ts +144 -144
- package/src/server/handlers/tools/find-cross-project-patterns.ts +168 -168
- package/src/server/handlers/tools/get-activity-log.ts +194 -194
- package/src/server/handlers/tools/get-code-standards.ts +124 -124
- package/src/server/handlers/tools/get-corrections.ts +154 -154
- package/src/server/handlers/tools/get-decision-timeline.ts +172 -172
- package/src/server/handlers/tools/get-episode.ts +103 -103
- package/src/server/handlers/tools/get-patterns.ts +158 -158
- package/src/server/handlers/tools/get-phase12-status.ts +63 -63
- package/src/server/handlers/tools/get-project-context.ts +75 -75
- package/src/server/handlers/tools/get-recommendations.ts +145 -145
- package/src/server/handlers/tools/index.ts +31 -31
- package/src/server/handlers/tools/init-project.ts +757 -757
- package/src/server/handlers/tools/list-episodes.ts +90 -90
- package/src/server/handlers/tools/list-projects.ts +125 -125
- package/src/server/handlers/tools/rate-memory.ts +101 -101
- package/src/server/handlers/tools/recall-similar.ts +87 -87
- package/src/server/handlers/tools/recognize-pattern.ts +126 -126
- package/src/server/handlers/tools/record-correction.ts +125 -125
- package/src/server/handlers/tools/remember-decision.ts +153 -153
- package/src/server/handlers/tools/schemas.ts +253 -253
- package/src/server/handlers/tools/search-knowledge-graph.ts +102 -102
- package/src/server/handlers/tools/smart-context.ts +146 -146
- package/src/server/handlers/tools/update-progress.ts +131 -131
- package/src/server/handlers/tools/what-if-analysis.ts +135 -135
- package/src/server/http-api.ts +693 -693
- package/src/server/index.ts +40 -40
- package/src/server/mcp-server.ts +283 -283
- package/src/server/providers/index.ts +7 -7
- package/src/server/providers/prompts.ts +327 -327
- package/src/server/providers/resources.ts +622 -622
- package/src/server/services.ts +468 -468
- package/src/server/types.ts +39 -39
- package/src/server/utils/error-handler.ts +155 -155
- package/src/server/utils/index.ts +13 -13
- package/src/server/utils/memory-indicator.ts +83 -83
- package/src/server/utils/request-context.ts +122 -122
- package/src/server/utils/response-formatter.ts +129 -129
- package/src/server/utils/validators.ts +210 -210
- package/src/setup/index.ts +48 -48
- package/src/setup/wizard.ts +461 -461
- package/src/tools/index.ts +24 -24
- package/src/tools/registry.ts +115 -115
- package/src/tools/schemas.test.ts +30 -30
- package/src/tools/schemas.ts +617 -617
- package/src/tools/types.ts +412 -412
- package/src/utils/circuit-breaker.ts +130 -130
- package/src/utils/cleanup.ts +34 -34
- package/src/utils/error-handler.ts +132 -132
- package/src/utils/error-messages.ts +60 -60
- package/src/utils/fallback.ts +45 -45
- package/src/utils/index.ts +54 -54
- package/src/utils/logger-utils.ts +80 -80
- package/src/utils/logger.ts +88 -88
- package/src/utils/phase12-helper.ts +56 -56
- package/src/utils/retry.ts +94 -94
- package/src/utils/timing.ts +47 -47
- package/src/utils/transaction.ts +63 -63
- package/src/vault/frontmatter.ts +264 -264
- package/src/vault/index.ts +318 -318
- package/src/vault/paths.ts +106 -106
- package/src/vault/query.ts +422 -422
- package/src/vault/reader.ts +264 -264
- package/src/vault/templates.ts +186 -186
- package/src/vault/types.ts +73 -73
- package/src/vault/watcher.ts +277 -277
- package/src/vault/writer.ts +413 -413
- package/tsconfig.json +30 -30
- package/src/cli/auto-update.ts +0 -157
package/src/hooks/installer.ts
CHANGED
|
@@ -1,194 +1,194 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Phase 17: Hook Installer
|
|
3
|
-
* Manages installation/removal of Claude Code hooks in ~/.claude/settings.json.
|
|
4
|
-
*/
|
|
5
|
-
|
|
6
|
-
import { readFileSync, writeFileSync, existsSync, mkdirSync, renameSync } from 'node:fs'
|
|
7
|
-
import { join, dirname } from 'node:path'
|
|
8
|
-
import { fileURLToPath } from 'node:url'
|
|
9
|
-
import { homedir } from 'node:os'
|
|
10
|
-
import { getClaudeBrainHome } from '@/config/home'
|
|
11
|
-
|
|
12
|
-
const CLAUDE_SETTINGS_PATH = join(homedir(), '.claude', 'settings.json')
|
|
13
|
-
const HOOK_MARKER = 'claude-brain-hook'
|
|
14
|
-
|
|
15
|
-
/** Get the path where the hook script should be installed */
|
|
16
|
-
export function getHookScriptPath(): string {
|
|
17
|
-
return join(getClaudeBrainHome(), 'hooks', 'brain-hook.ts')
|
|
18
|
-
}
|
|
19
|
-
|
|
20
|
-
/** Read Claude Code settings.json, creating if needed */
|
|
21
|
-
function readSettings(): Record<string, any> {
|
|
22
|
-
if (!existsSync(CLAUDE_SETTINGS_PATH)) return {}
|
|
23
|
-
try {
|
|
24
|
-
return JSON.parse(readFileSync(CLAUDE_SETTINGS_PATH, 'utf-8'))
|
|
25
|
-
} catch {
|
|
26
|
-
return {}
|
|
27
|
-
}
|
|
28
|
-
}
|
|
29
|
-
|
|
30
|
-
/** Write settings.json atomically (write temp → rename) */
|
|
31
|
-
function writeSettings(settings: Record<string, any>): void {
|
|
32
|
-
const dir = dirname(CLAUDE_SETTINGS_PATH)
|
|
33
|
-
if (!existsSync(dir)) {
|
|
34
|
-
mkdirSync(dir, { recursive: true })
|
|
35
|
-
}
|
|
36
|
-
|
|
37
|
-
const tmpPath = CLAUDE_SETTINGS_PATH + '.tmp'
|
|
38
|
-
writeFileSync(tmpPath, JSON.stringify(settings, null, 2) + '\n', 'utf-8')
|
|
39
|
-
renameSync(tmpPath, CLAUDE_SETTINGS_PATH)
|
|
40
|
-
}
|
|
41
|
-
|
|
42
|
-
/** Build the hook command string */
|
|
43
|
-
function buildHookCommand(event: string): string {
|
|
44
|
-
const scriptPath = getHookScriptPath()
|
|
45
|
-
return `bun "${scriptPath}" --event ${event} # ${HOOK_MARKER}`
|
|
46
|
-
}
|
|
47
|
-
|
|
48
|
-
/**
|
|
49
|
-
* Install Claude Brain hooks into Claude Code settings.
|
|
50
|
-
* Adds PostToolUse and Stop hook entries.
|
|
51
|
-
*/
|
|
52
|
-
export function installHooks(): { installed: boolean; message: string } {
|
|
53
|
-
if (isHooksInstalled()) {
|
|
54
|
-
return { installed: true, message: 'Hooks already installed' }
|
|
55
|
-
}
|
|
56
|
-
|
|
57
|
-
const settings = readSettings()
|
|
58
|
-
|
|
59
|
-
// Ensure hooks object exists
|
|
60
|
-
if (!settings.hooks) settings.hooks = {}
|
|
61
|
-
|
|
62
|
-
// PostToolUse hook — runs on every tool completion
|
|
63
|
-
if (!settings.hooks.PostToolUse) settings.hooks.PostToolUse = []
|
|
64
|
-
settings.hooks.PostToolUse.push({
|
|
65
|
-
matcher: '',
|
|
66
|
-
hooks: [{
|
|
67
|
-
type: 'command',
|
|
68
|
-
command: buildHookCommand('PostToolUse'),
|
|
69
|
-
}],
|
|
70
|
-
})
|
|
71
|
-
|
|
72
|
-
// Stop hook — triggers session-end summary
|
|
73
|
-
if (!settings.hooks.Stop) settings.hooks.Stop = []
|
|
74
|
-
settings.hooks.Stop.push({
|
|
75
|
-
matcher: '',
|
|
76
|
-
hooks: [{
|
|
77
|
-
type: 'command',
|
|
78
|
-
command: buildHookCommand('Stop'),
|
|
79
|
-
}],
|
|
80
|
-
})
|
|
81
|
-
|
|
82
|
-
writeSettings(settings)
|
|
83
|
-
|
|
84
|
-
// Copy hook script to install location
|
|
85
|
-
copyHookScript()
|
|
86
|
-
|
|
87
|
-
return { installed: true, message: 'Hooks installed successfully' }
|
|
88
|
-
}
|
|
89
|
-
|
|
90
|
-
/**
|
|
91
|
-
* Remove Claude Brain hooks from Claude Code settings.
|
|
92
|
-
*/
|
|
93
|
-
export function uninstallHooks(): { uninstalled: boolean; message: string } {
|
|
94
|
-
if (!isHooksInstalled()) {
|
|
95
|
-
return { uninstalled: true, message: 'Hooks not installed' }
|
|
96
|
-
}
|
|
97
|
-
|
|
98
|
-
const settings = readSettings()
|
|
99
|
-
|
|
100
|
-
if (settings.hooks) {
|
|
101
|
-
// Remove our entries from PostToolUse
|
|
102
|
-
if (Array.isArray(settings.hooks.PostToolUse)) {
|
|
103
|
-
settings.hooks.PostToolUse = settings.hooks.PostToolUse.filter(
|
|
104
|
-
(entry: any) => !isOurHookEntry(entry)
|
|
105
|
-
)
|
|
106
|
-
if (settings.hooks.PostToolUse.length === 0) {
|
|
107
|
-
delete settings.hooks.PostToolUse
|
|
108
|
-
}
|
|
109
|
-
}
|
|
110
|
-
|
|
111
|
-
// Remove our entries from Stop
|
|
112
|
-
if (Array.isArray(settings.hooks.Stop)) {
|
|
113
|
-
settings.hooks.Stop = settings.hooks.Stop.filter(
|
|
114
|
-
(entry: any) => !isOurHookEntry(entry)
|
|
115
|
-
)
|
|
116
|
-
if (settings.hooks.Stop.length === 0) {
|
|
117
|
-
delete settings.hooks.Stop
|
|
118
|
-
}
|
|
119
|
-
}
|
|
120
|
-
|
|
121
|
-
// Clean up empty hooks object
|
|
122
|
-
if (Object.keys(settings.hooks).length === 0) {
|
|
123
|
-
delete settings.hooks
|
|
124
|
-
}
|
|
125
|
-
}
|
|
126
|
-
|
|
127
|
-
writeSettings(settings)
|
|
128
|
-
|
|
129
|
-
return { uninstalled: true, message: 'Hooks uninstalled successfully' }
|
|
130
|
-
}
|
|
131
|
-
|
|
132
|
-
/**
|
|
133
|
-
* Check if hooks are already installed.
|
|
134
|
-
*/
|
|
135
|
-
export function isHooksInstalled(): boolean {
|
|
136
|
-
const settings = readSettings()
|
|
137
|
-
if (!settings.hooks) return false
|
|
138
|
-
|
|
139
|
-
const hasPostToolUse = Array.isArray(settings.hooks.PostToolUse) &&
|
|
140
|
-
settings.hooks.PostToolUse.some((entry: any) => isOurHookEntry(entry))
|
|
141
|
-
|
|
142
|
-
const hasStop = Array.isArray(settings.hooks.Stop) &&
|
|
143
|
-
settings.hooks.Stop.some((entry: any) => isOurHookEntry(entry))
|
|
144
|
-
|
|
145
|
-
return hasPostToolUse || hasStop
|
|
146
|
-
}
|
|
147
|
-
|
|
148
|
-
/** Check if a hook entry belongs to us (by marker in command) */
|
|
149
|
-
function isOurHookEntry(entry: any): boolean {
|
|
150
|
-
if (!entry || !Array.isArray(entry.hooks)) return false
|
|
151
|
-
return entry.hooks.some(
|
|
152
|
-
(h: any) => typeof h.command === 'string' && h.command.includes(HOOK_MARKER)
|
|
153
|
-
)
|
|
154
|
-
}
|
|
155
|
-
|
|
156
|
-
/** All files needed by brain-hook.ts at runtime */
|
|
157
|
-
const HOOK_FILES = [
|
|
158
|
-
'brain-hook.ts',
|
|
159
|
-
'capture.ts',
|
|
160
|
-
'queue.ts',
|
|
161
|
-
'types.ts',
|
|
162
|
-
'passive-classifier.ts',
|
|
163
|
-
]
|
|
164
|
-
|
|
165
|
-
/** Copy the hook script and all its dependencies to the install location */
|
|
166
|
-
function copyHookScript(): void {
|
|
167
|
-
const destDir = dirname(getHookScriptPath())
|
|
168
|
-
|
|
169
|
-
if (!existsSync(destDir)) {
|
|
170
|
-
mkdirSync(destDir, { recursive: true })
|
|
171
|
-
}
|
|
172
|
-
|
|
173
|
-
// Use Bun's import.meta.dir if available, otherwise fileURLToPath for Windows compat
|
|
174
|
-
// (new URL(...).pathname returns "/C:/..." on Windows, breaking existsSync)
|
|
175
|
-
const srcDir = (import.meta as any).dir ?? dirname(fileURLToPath(import.meta.url))
|
|
176
|
-
|
|
177
|
-
for (const file of HOOK_FILES) {
|
|
178
|
-
const srcPath = join(srcDir, file)
|
|
179
|
-
const destPath = join(destDir, file)
|
|
180
|
-
|
|
181
|
-
if (existsSync(srcPath)) {
|
|
182
|
-
const content = readFileSync(srcPath, 'utf-8')
|
|
183
|
-
writeFileSync(destPath, content, 'utf-8')
|
|
184
|
-
} else {
|
|
185
|
-
// Try .js extension for compiled version
|
|
186
|
-
const jsSrcPath = srcPath.replace('.ts', '.js')
|
|
187
|
-
const jsDestPath = destPath.replace('.ts', '.js')
|
|
188
|
-
if (existsSync(jsSrcPath)) {
|
|
189
|
-
const content = readFileSync(jsSrcPath, 'utf-8')
|
|
190
|
-
writeFileSync(jsDestPath, content, 'utf-8')
|
|
191
|
-
}
|
|
192
|
-
}
|
|
193
|
-
}
|
|
194
|
-
}
|
|
1
|
+
/**
|
|
2
|
+
* Phase 17: Hook Installer
|
|
3
|
+
* Manages installation/removal of Claude Code hooks in ~/.claude/settings.json.
|
|
4
|
+
*/
|
|
5
|
+
|
|
6
|
+
import { readFileSync, writeFileSync, existsSync, mkdirSync, renameSync } from 'node:fs'
|
|
7
|
+
import { join, dirname } from 'node:path'
|
|
8
|
+
import { fileURLToPath } from 'node:url'
|
|
9
|
+
import { homedir } from 'node:os'
|
|
10
|
+
import { getClaudeBrainHome } from '@/config/home'
|
|
11
|
+
|
|
12
|
+
const CLAUDE_SETTINGS_PATH = join(homedir(), '.claude', 'settings.json')
|
|
13
|
+
const HOOK_MARKER = 'claude-brain-hook'
|
|
14
|
+
|
|
15
|
+
/** Get the path where the hook script should be installed */
|
|
16
|
+
export function getHookScriptPath(): string {
|
|
17
|
+
return join(getClaudeBrainHome(), 'hooks', 'brain-hook.ts')
|
|
18
|
+
}
|
|
19
|
+
|
|
20
|
+
/** Read Claude Code settings.json, creating if needed */
|
|
21
|
+
function readSettings(): Record<string, any> {
|
|
22
|
+
if (!existsSync(CLAUDE_SETTINGS_PATH)) return {}
|
|
23
|
+
try {
|
|
24
|
+
return JSON.parse(readFileSync(CLAUDE_SETTINGS_PATH, 'utf-8'))
|
|
25
|
+
} catch {
|
|
26
|
+
return {}
|
|
27
|
+
}
|
|
28
|
+
}
|
|
29
|
+
|
|
30
|
+
/** Write settings.json atomically (write temp → rename) */
|
|
31
|
+
function writeSettings(settings: Record<string, any>): void {
|
|
32
|
+
const dir = dirname(CLAUDE_SETTINGS_PATH)
|
|
33
|
+
if (!existsSync(dir)) {
|
|
34
|
+
mkdirSync(dir, { recursive: true })
|
|
35
|
+
}
|
|
36
|
+
|
|
37
|
+
const tmpPath = CLAUDE_SETTINGS_PATH + '.tmp'
|
|
38
|
+
writeFileSync(tmpPath, JSON.stringify(settings, null, 2) + '\n', 'utf-8')
|
|
39
|
+
renameSync(tmpPath, CLAUDE_SETTINGS_PATH)
|
|
40
|
+
}
|
|
41
|
+
|
|
42
|
+
/** Build the hook command string */
|
|
43
|
+
function buildHookCommand(event: string): string {
|
|
44
|
+
const scriptPath = getHookScriptPath()
|
|
45
|
+
return `bun "${scriptPath}" --event ${event} # ${HOOK_MARKER}`
|
|
46
|
+
}
|
|
47
|
+
|
|
48
|
+
/**
|
|
49
|
+
* Install Claude Brain hooks into Claude Code settings.
|
|
50
|
+
* Adds PostToolUse and Stop hook entries.
|
|
51
|
+
*/
|
|
52
|
+
export function installHooks(): { installed: boolean; message: string } {
|
|
53
|
+
if (isHooksInstalled()) {
|
|
54
|
+
return { installed: true, message: 'Hooks already installed' }
|
|
55
|
+
}
|
|
56
|
+
|
|
57
|
+
const settings = readSettings()
|
|
58
|
+
|
|
59
|
+
// Ensure hooks object exists
|
|
60
|
+
if (!settings.hooks) settings.hooks = {}
|
|
61
|
+
|
|
62
|
+
// PostToolUse hook — runs on every tool completion
|
|
63
|
+
if (!settings.hooks.PostToolUse) settings.hooks.PostToolUse = []
|
|
64
|
+
settings.hooks.PostToolUse.push({
|
|
65
|
+
matcher: '',
|
|
66
|
+
hooks: [{
|
|
67
|
+
type: 'command',
|
|
68
|
+
command: buildHookCommand('PostToolUse'),
|
|
69
|
+
}],
|
|
70
|
+
})
|
|
71
|
+
|
|
72
|
+
// Stop hook — triggers session-end summary
|
|
73
|
+
if (!settings.hooks.Stop) settings.hooks.Stop = []
|
|
74
|
+
settings.hooks.Stop.push({
|
|
75
|
+
matcher: '',
|
|
76
|
+
hooks: [{
|
|
77
|
+
type: 'command',
|
|
78
|
+
command: buildHookCommand('Stop'),
|
|
79
|
+
}],
|
|
80
|
+
})
|
|
81
|
+
|
|
82
|
+
writeSettings(settings)
|
|
83
|
+
|
|
84
|
+
// Copy hook script to install location
|
|
85
|
+
copyHookScript()
|
|
86
|
+
|
|
87
|
+
return { installed: true, message: 'Hooks installed successfully' }
|
|
88
|
+
}
|
|
89
|
+
|
|
90
|
+
/**
|
|
91
|
+
* Remove Claude Brain hooks from Claude Code settings.
|
|
92
|
+
*/
|
|
93
|
+
export function uninstallHooks(): { uninstalled: boolean; message: string } {
|
|
94
|
+
if (!isHooksInstalled()) {
|
|
95
|
+
return { uninstalled: true, message: 'Hooks not installed' }
|
|
96
|
+
}
|
|
97
|
+
|
|
98
|
+
const settings = readSettings()
|
|
99
|
+
|
|
100
|
+
if (settings.hooks) {
|
|
101
|
+
// Remove our entries from PostToolUse
|
|
102
|
+
if (Array.isArray(settings.hooks.PostToolUse)) {
|
|
103
|
+
settings.hooks.PostToolUse = settings.hooks.PostToolUse.filter(
|
|
104
|
+
(entry: any) => !isOurHookEntry(entry)
|
|
105
|
+
)
|
|
106
|
+
if (settings.hooks.PostToolUse.length === 0) {
|
|
107
|
+
delete settings.hooks.PostToolUse
|
|
108
|
+
}
|
|
109
|
+
}
|
|
110
|
+
|
|
111
|
+
// Remove our entries from Stop
|
|
112
|
+
if (Array.isArray(settings.hooks.Stop)) {
|
|
113
|
+
settings.hooks.Stop = settings.hooks.Stop.filter(
|
|
114
|
+
(entry: any) => !isOurHookEntry(entry)
|
|
115
|
+
)
|
|
116
|
+
if (settings.hooks.Stop.length === 0) {
|
|
117
|
+
delete settings.hooks.Stop
|
|
118
|
+
}
|
|
119
|
+
}
|
|
120
|
+
|
|
121
|
+
// Clean up empty hooks object
|
|
122
|
+
if (Object.keys(settings.hooks).length === 0) {
|
|
123
|
+
delete settings.hooks
|
|
124
|
+
}
|
|
125
|
+
}
|
|
126
|
+
|
|
127
|
+
writeSettings(settings)
|
|
128
|
+
|
|
129
|
+
return { uninstalled: true, message: 'Hooks uninstalled successfully' }
|
|
130
|
+
}
|
|
131
|
+
|
|
132
|
+
/**
|
|
133
|
+
* Check if hooks are already installed.
|
|
134
|
+
*/
|
|
135
|
+
export function isHooksInstalled(): boolean {
|
|
136
|
+
const settings = readSettings()
|
|
137
|
+
if (!settings.hooks) return false
|
|
138
|
+
|
|
139
|
+
const hasPostToolUse = Array.isArray(settings.hooks.PostToolUse) &&
|
|
140
|
+
settings.hooks.PostToolUse.some((entry: any) => isOurHookEntry(entry))
|
|
141
|
+
|
|
142
|
+
const hasStop = Array.isArray(settings.hooks.Stop) &&
|
|
143
|
+
settings.hooks.Stop.some((entry: any) => isOurHookEntry(entry))
|
|
144
|
+
|
|
145
|
+
return hasPostToolUse || hasStop
|
|
146
|
+
}
|
|
147
|
+
|
|
148
|
+
/** Check if a hook entry belongs to us (by marker in command) */
|
|
149
|
+
function isOurHookEntry(entry: any): boolean {
|
|
150
|
+
if (!entry || !Array.isArray(entry.hooks)) return false
|
|
151
|
+
return entry.hooks.some(
|
|
152
|
+
(h: any) => typeof h.command === 'string' && h.command.includes(HOOK_MARKER)
|
|
153
|
+
)
|
|
154
|
+
}
|
|
155
|
+
|
|
156
|
+
/** All files needed by brain-hook.ts at runtime */
|
|
157
|
+
const HOOK_FILES = [
|
|
158
|
+
'brain-hook.ts',
|
|
159
|
+
'capture.ts',
|
|
160
|
+
'queue.ts',
|
|
161
|
+
'types.ts',
|
|
162
|
+
'passive-classifier.ts',
|
|
163
|
+
]
|
|
164
|
+
|
|
165
|
+
/** Copy the hook script and all its dependencies to the install location */
|
|
166
|
+
function copyHookScript(): void {
|
|
167
|
+
const destDir = dirname(getHookScriptPath())
|
|
168
|
+
|
|
169
|
+
if (!existsSync(destDir)) {
|
|
170
|
+
mkdirSync(destDir, { recursive: true })
|
|
171
|
+
}
|
|
172
|
+
|
|
173
|
+
// Use Bun's import.meta.dir if available, otherwise fileURLToPath for Windows compat
|
|
174
|
+
// (new URL(...).pathname returns "/C:/..." on Windows, breaking existsSync)
|
|
175
|
+
const srcDir = (import.meta as any).dir ?? dirname(fileURLToPath(import.meta.url))
|
|
176
|
+
|
|
177
|
+
for (const file of HOOK_FILES) {
|
|
178
|
+
const srcPath = join(srcDir, file)
|
|
179
|
+
const destPath = join(destDir, file)
|
|
180
|
+
|
|
181
|
+
if (existsSync(srcPath)) {
|
|
182
|
+
const content = readFileSync(srcPath, 'utf-8')
|
|
183
|
+
writeFileSync(destPath, content, 'utf-8')
|
|
184
|
+
} else {
|
|
185
|
+
// Try .js extension for compiled version
|
|
186
|
+
const jsSrcPath = srcPath.replace('.ts', '.js')
|
|
187
|
+
const jsDestPath = destPath.replace('.ts', '.js')
|
|
188
|
+
if (existsSync(jsSrcPath)) {
|
|
189
|
+
const content = readFileSync(jsSrcPath, 'utf-8')
|
|
190
|
+
writeFileSync(jsDestPath, content, 'utf-8')
|
|
191
|
+
}
|
|
192
|
+
}
|
|
193
|
+
}
|
|
194
|
+
}
|