olympus-ai 3.2.3 → 3.3.0

package/dist/hooks/registrations/index.d.ts

@@ -11,6 +11,7 @@ import { registerPreToolUseHooks } from './pre-tool-use.js';
 import { registerPostToolUseHooks } from './post-tool-use.js';
 import { registerPostToolUseFailureHooks } from './post-tool-use-failure.js';
 import { registerNotificationHooks } from './notification.js';
+import { registerTokenMetricsHooks } from './token-metrics.js';
 /**
  * Register all hooks with the router.
  * Safe to call multiple times (idempotent).
@@ -21,5 +22,5 @@ export declare function registerAllHooks(): void;
  * Primarily used for testing.
  */
 export declare function resetRegistration(): void;
-export { registerUserPromptSubmitHooks, registerSessionStartHooks, registerStopHooks, registerPreToolUseHooks, registerPostToolUseHooks, registerPostToolUseFailureHooks, registerNotificationHooks, };
+export { registerUserPromptSubmitHooks, registerSessionStartHooks, registerStopHooks, registerPreToolUseHooks, registerPostToolUseHooks, registerPostToolUseFailureHooks, registerNotificationHooks, registerTokenMetricsHooks, };
 //# sourceMappingURL=index.d.ts.map

package/dist/hooks/registrations/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/registrations/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,6BAA6B,EAAE,MAAM,yBAAyB,CAAC;AACxE,OAAO,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,+BAA+B,EAAE,MAAM,4BAA4B,CAAC;AAC7E,OAAO,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAK9D;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAevC;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAExC;AAGD,OAAO,EACL,6BAA6B,EAC7B,yBAAyB,EACzB,iBAAiB,EACjB,uBAAuB,EACvB,wBAAwB,EACxB,+BAA+B,EAC/B,yBAAyB,GAC1B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/registrations/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,6BAA6B,EAAE,MAAM,yBAAyB,CAAC;AACxE,OAAO,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,+BAA+B,EAAE,MAAM,4BAA4B,CAAC;AAC7E,OAAO,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAK/D;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAgBvC;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAExC;AAGD,OAAO,EACL,6BAA6B,EAC7B,yBAAyB,EACzB,iBAAiB,EACjB,uBAAuB,EACvB,wBAAwB,EACxB,+BAA+B,EAC/B,yBAAyB,EACzB,yBAAyB,GAC1B,CAAC"}

package/dist/hooks/registrations/index.js

@@ -11,6 +11,7 @@ import { registerPreToolUseHooks } from './pre-tool-use.js';
 import { registerPostToolUseHooks } from './post-tool-use.js';
 import { registerPostToolUseFailureHooks } from './post-tool-use-failure.js';
 import { registerNotificationHooks } from './notification.js';
+import { registerTokenMetricsHooks } from './token-metrics.js';
 /** Flag to prevent double registration */
 let registered = false;
 /**
@@ -29,6 +30,7 @@ export function registerAllHooks() {
     registerPostToolUseHooks();
     registerPostToolUseFailureHooks();
     registerNotificationHooks();
+    registerTokenMetricsHooks();
     registered = true;
 }
 /**
@@ -39,5 +41,5 @@ export function resetRegistration() {
     registered = false;
 }
 // Re-export individual registration functions for selective use
-export { registerUserPromptSubmitHooks, registerSessionStartHooks, registerStopHooks, registerPreToolUseHooks, registerPostToolUseHooks, registerPostToolUseFailureHooks, registerNotificationHooks, };
+export { registerUserPromptSubmitHooks, registerSessionStartHooks, registerStopHooks, registerPreToolUseHooks, registerPostToolUseHooks, registerPostToolUseFailureHooks, registerNotificationHooks, registerTokenMetricsHooks, };
 //# sourceMappingURL=index.js.map

package/dist/hooks/registrations/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/hooks/registrations/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,6BAA6B,EAAE,MAAM,yBAAyB,CAAC;AACxE,OAAO,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,+BAA+B,EAAE,MAAM,4BAA4B,CAAC;AAC7E,OAAO,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAE9D,0CAA0C;AAC1C,IAAI,UAAU,GAAG,KAAK,CAAC;AAEvB;;;GAGG;AACH,MAAM,UAAU,gBAAgB;IAC9B,IAAI,UAAU,EAAE,CAAC;QACf,OAAO;IACT,CAAC;IAED,+BAA+B;IAC/B,6BAA6B,EAAE,CAAC;IAChC,yBAAyB,EAAE,CAAC;IAC5B,iBAAiB,EAAE,CAAC;IACpB,uBAAuB,EAAE,CAAC;IAC1B,wBAAwB,EAAE,CAAC;IAC3B,+BAA+B,EAAE,CAAC;IAClC,yBAAyB,EAAE,CAAC;IAE5B,UAAU,GAAG,IAAI,CAAC;AACpB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB;IAC/B,UAAU,GAAG,KAAK,CAAC;AACrB,CAAC;AAED,gEAAgE;AAChE,OAAO,EACL,6BAA6B,EAC7B,yBAAyB,EACzB,iBAAiB,EACjB,uBAAuB,EACvB,wBAAwB,EACxB,+BAA+B,EAC/B,yBAAyB,GAC1B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/hooks/registrations/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,6BAA6B,EAAE,MAAM,yBAAyB,CAAC;AACxE,OAAO,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,+BAA+B,EAAE,MAAM,4BAA4B,CAAC;AAC7E,OAAO,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAE/D,0CAA0C;AAC1C,IAAI,UAAU,GAAG,KAAK,CAAC;AAEvB;;;GAGG;AACH,MAAM,UAAU,gBAAgB;IAC9B,IAAI,UAAU,EAAE,CAAC;QACf,OAAO;IACT,CAAC;IAED,+BAA+B;IAC/B,6BAA6B,EAAE,CAAC;IAChC,yBAAyB,EAAE,CAAC;IAC5B,iBAAiB,EAAE,CAAC;IACpB,uBAAuB,EAAE,CAAC;IAC1B,wBAAwB,EAAE,CAAC;IAC3B,+BAA+B,EAAE,CAAC;IAClC,yBAAyB,EAAE,CAAC;IAC5B,yBAAyB,EAAE,CAAC;IAE5B,UAAU,GAAG,IAAI,CAAC;AACpB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB;IAC/B,UAAU,GAAG,KAAK,CAAC;AACrB,CAAC;AAED,gEAAgE;AAChE,OAAO,EACL,6BAA6B,EAC7B,yBAAyB,EACzB,iBAAiB,EACjB,uBAAuB,EACvB,wBAAwB,EACxB,+BAA+B,EAC/B,yBAAyB,EACzB,yBAAyB,GAC1B,CAAC"}

package/dist/hooks/registrations/token-metrics.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Token Metrics Hook Registrations
+ *
+ * Captures token usage metrics from Claude Code events.
+ * Tracks prompts and tool executions for usage analysis.
+ */
+/**
+ * Register token metrics hooks
+ */
+export declare function registerTokenMetricsHooks(): void;
+//# sourceMappingURL=token-metrics.d.ts.map

package/dist/hooks/registrations/token-metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-metrics.d.ts","sourceRoot":"","sources":["../../../src/hooks/registrations/token-metrics.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA2CH;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,IAAI,CA+EhD"}

package/dist/hooks/registrations/token-metrics.js

@@ -0,0 +1,119 @@
+/**
+ * Token Metrics Hook Registrations
+ *
+ * Captures token usage metrics from Claude Code events.
+ * Tracks prompts and tool executions for usage analysis.
+ */
+import { registerHook } from '../registry.js';
+import { logTokenMetric } from '../../features/token-metrics/storage.js';
+import { estimateTokens, estimateTokensFromToolOutput } from '../../features/token-metrics/token-estimator.js';
+/**
+ * Extract prompt text from various input formats
+ */
+function getPromptText(ctx) {
+    if (ctx.prompt) {
+        return ctx.prompt;
+    }
+    if (ctx.message?.content) {
+        return ctx.message.content;
+    }
+    if (ctx.parts) {
+        return ctx.parts
+            .filter(p => p.type === 'text' && p.text)
+            .map(p => p.text)
+            .join(' ');
+    }
+    return '';
+}
+/**
+ * Extract model identifier from context
+ */
+function getModelIdentifier(ctx) {
+    if (ctx.message?.model) {
+        const { providerId, modelId } = ctx.message.model;
+        if (providerId && modelId) {
+            return `${providerId}/${modelId}`;
+        }
+        if (modelId) {
+            return modelId;
+        }
+    }
+    return undefined;
+}
+/**
+ * Register token metrics hooks
+ */
+export function registerTokenMetricsHooks() {
+    // Hook 1: Capture user prompt submissions
+    registerHook({
+        name: 'tokenMetricsPrompt',
+        event: 'UserPromptSubmit',
+        priority: 110, // Low priority - passive capture, run after other hooks
+        handler: async (ctx) => {
+            try {
+                const promptText = getPromptText(ctx);
+                // Estimate input tokens (will be 0 if empty)
+                const inputTokens = promptText ? await estimateTokens(promptText) : 0;
+                const model = getModelIdentifier(ctx);
+                // Create metrics entry
+                const entry = {
+                    timestamp: new Date().toISOString(),
+                    session_id: ctx.sessionId || 'unknown',
+                    event_type: 'prompt',
+                    input_tokens: inputTokens,
+                    model,
+                    project_path: ctx.directory,
+                };
+                // Log to storage (fire-and-forget) - always log for complete session tracking
+                logTokenMetric(entry, ctx.directory).catch(err => {
+                    // Silent failure - metrics should never block execution
+                    console.error('[Olympus Token Metrics] Failed to log prompt metric:', err);
+                });
+            }
+            catch (error) {
+                // Silent failure - metrics should never break hooks
+                console.error('[Olympus Token Metrics] Error in prompt handler:', error);
+            }
+            return { continue: true };
+        }
+    });
+    // Hook 2: Capture tool executions
+    registerHook({
+        name: 'tokenMetricsToolUse',
+        event: 'PostToolUse',
+        priority: 70, // Lower priority - passive capture
+        handler: async (ctx) => {
+            try {
+                if (!ctx.toolName) {
+                    return { continue: true };
+                }
+                // Estimate output tokens from tool result
+                const outputTokens = ctx.toolOutput
+                    ? await estimateTokensFromToolOutput(ctx.toolOutput)
+                    : 0;
+                const model = getModelIdentifier(ctx);
+                // Create metrics entry
+                const entry = {
+                    timestamp: new Date().toISOString(),
+                    session_id: ctx.sessionId || 'unknown',
+                    event_type: 'tool_use',
+                    output_tokens: outputTokens,
+                    model,
+                    tool_name: ctx.toolName,
+                    project_path: ctx.directory,
+                };
+                // Log to storage (fire-and-forget)
+                logTokenMetric(entry, ctx.directory).catch(err => {
+                    // Silent failure - metrics should never block execution
+                    console.error('[Olympus Token Metrics] Failed to log tool metric:', err);
+                });
+            }
+            catch (error) {
+                // Silent failure - metrics should never break hooks
+                console.error('[Olympus Token Metrics] Error in tool use handler:', error);
+            }
+            return { continue: true };
+        }
+    });
+}
+//# sourceMappingURL=token-metrics.js.map

package/dist/hooks/registrations/token-metrics.js.map

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

package/dist/installer/index.d.ts

@@ -24,7 +24,7 @@ export declare const HOOKS_DIR: string;
 export declare const SETTINGS_FILE: string;
 export declare const VERSION_FILE: string;
 /** Current version - MUST match package.json */
-export declare const VERSION = "3.2.3";
+export declare const VERSION = "3.3.0";
 /** Installation result */
 export interface InstallResult {
     success: boolean;

package/dist/installer/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/installer/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAsBH,0CAA0C;AAC1C,eAAO,MAAM,iBAAiB,QAA6B,CAAC;AAC5D,eAAO,MAAM,UAAU,QAAoC,CAAC;AAC5D,eAAO,MAAM,YAAY,QAAsC,CAAC;AAChE,eAAO,MAAM,UAAU,QAAoC,CAAC;AAC5D,eAAO,MAAM,SAAS,QAAmC,CAAC;AAC1D,eAAO,MAAM,aAAa,QAA2C,CAAC;AACtE,eAAO,MAAM,YAAY,QAAmD,CAAC;AAE7E,gDAAgD;AAChD,eAAO,MAAM,OAAO,UAAU,CAAC;AAE/B,0BAA0B;AAC1B,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,eAAe,EAAE,OAAO,CAAC;IACzB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,2BAA2B;AAC3B,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAOxF;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAQ3C;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAkzCpD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAioBtD,CAAC;AAIF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,2qWA6Q7B,CAAC;AAEF;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,OAAO,CAyB7C;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,OAAO,GAAE,cAAmB,GAAG,aAAa,CAyYnE;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,OAAO,CAErC;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAehG"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/installer/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAsBH,0CAA0C;AAC1C,eAAO,MAAM,iBAAiB,QAA6B,CAAC;AAC5D,eAAO,MAAM,UAAU,QAAoC,CAAC;AAC5D,eAAO,MAAM,YAAY,QAAsC,CAAC;AAChE,eAAO,MAAM,UAAU,QAAoC,CAAC;AAC5D,eAAO,MAAM,SAAS,QAAmC,CAAC;AAC1D,eAAO,MAAM,aAAa,QAA2C,CAAC;AACtE,eAAO,MAAM,YAAY,QAAmD,CAAC;AAE7E,gDAAgD;AAChD,eAAO,MAAM,OAAO,UAAU,CAAC;AAE/B,0BAA0B;AAC1B,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,eAAe,EAAE,OAAO,CAAC;IACzB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,2BAA2B;AAC3B,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAOxF;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAQ3C;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAm0CpD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAu7BtD,CAAC;AAIF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,2qWA6Q7B,CAAC;AAEF;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,OAAO,CAyB7C;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,OAAO,GAAE,cAAmB,GAAG,aAAa,CAyYnE;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,OAAO,CAErC;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAehG"}

package/dist/installer/index.js

@@ -33,7 +33,7 @@ export const HOOKS_DIR = join(CLAUDE_CONFIG_DIR, 'hooks');
 export const SETTINGS_FILE = join(CLAUDE_CONFIG_DIR, 'settings.json');
 export const VERSION_FILE = join(CLAUDE_CONFIG_DIR, '.olympus-version.json');
 /** Current version - MUST match package.json */
-export const VERSION = '3.2.3';
+export const VERSION = '3.3.0';
 /**
  * Check if the current Node.js version meets the minimum requirement
  */
@@ -773,6 +773,12 @@ BLOCKED ACTIONS (will fail if attempted):
 - Any agent spawning: BLOCKED
 
 You work ALONE. No delegation. No background tasks. Execute directly.
+
+CRITICAL PATH RULES:
+- NEVER use absolute paths (C:\\\\..., /Users/...) in Write, Edit, or Bash directory creation
+- ALWAYS use relative paths from project root (e.g., "src/features/", ".olympus/")
+- Before creating files/directories, verify path does NOT contain drive letters or home directory markers
+- If you accidentally create malformed directories (CUsers..., C:...), DELETE them immediately
 </Critical_Constraints>
 
 <Work_Context>
@@ -1264,6 +1270,12 @@ BLOCKED ACTIONS (will fail if attempted):
 - Any agent spawning: BLOCKED
 
 You work ALONE. No delegation. Execute directly with careful reasoning.
+
+CRITICAL PATH RULES:
+- NEVER use absolute paths (C:\\\\..., /Users/...) in Write, Edit, or Bash directory creation
+- ALWAYS use relative paths from project root (e.g., "src/features/", ".olympus/")
+- Before creating files/directories, verify path does NOT contain drive letters or home directory markers
+- If you accidentally create malformed directories (CUsers..., C:...), DELETE them immediately
 </Critical_Constraints>
 
 <Todo_Discipline>
@@ -1292,6 +1304,11 @@ Execute tasks directly. NEVER delegate.
 
 <Constraints>
 BLOCKED: Task tool, agent spawning
+
+CRITICAL PATH RULES:
+- NEVER use absolute paths (C:\\\\..., /Users/...) in Write, Edit, or Bash directory creation
+- ALWAYS use relative paths from project root
+- If you create malformed directories (CUsers..., C:...), DELETE them immediately
 Keep it simple - if task seems complex, escalate to olympian or olympian-high.
 </Constraints>`,
     // Librarian variants (default is sonnet)
@@ -1893,16 +1910,20 @@ I will check for available updates to Olympus.
 
 ### Update Methods
 
-**Automatic (Recommended):**
-Run the install script to update:
+**npm (Recommended):**
 \`\`\`bash
-curl -fsSL https://raw.githubusercontent.com/mikev10/olympus/main/scripts/install.sh | bash
+npm update -g olympus-ai
+olympus-ai install --force
 \`\`\`
 
-**Manual:**
-1. Check your current version in \`~/.claude/.olympus-version.json\`
-2. Visit https://github.com/mikev10/olympus/releases
-3. Download and run the install script from the latest release
+**Alternative (install script):**
+\`\`\`bash
+# macOS/Linux
+curl -fsSL https://raw.githubusercontent.com/mikev10/olympus/main/scripts/install.sh | bash
+
+# Windows (PowerShell)
+irm https://raw.githubusercontent.com/mikev10/olympus/main/scripts/install.ps1 | iex
+\`\`\`
 
 ### Version Info Location
 
@@ -2011,7 +2032,311 @@ If NOT COMPLETED:
 
 ---
 
-**Remember: Summon the gods of code. Verify everything. Trust nothing without evidence.**`
+**Remember: Summon the gods of code. Verify everything. Trust nothing without evidence.**`,
+    'doctor.md': `---
+description: Diagnose and fix olympus installation issues
+---
+
+$ARGUMENTS
+
+## Task: Run Installation Diagnostics
+
+You are the Olympus Doctor - diagnose and fix installation issues.
+
+### Step 1: Check Plugin Version
+
+\`\`\`bash
+# Get installed version
+INSTALLED=$(ls ~/.claude/plugins/cache/olympus/olympus/ 2>/dev/null | sort -V | tail -1)
+echo "Installed: $INSTALLED"
+
+# Get latest from npm
+LATEST=$(npm view olympus version 2>/dev/null)
+echo "Latest: $LATEST"
+\`\`\`
+
+**Diagnosis**:
+- If no version installed: CRITICAL - plugin not installed
+- If INSTALLED != LATEST: WARN - outdated plugin
+- If multiple versions exist: WARN - stale cache
+
+### Step 2: Check for Legacy Hooks in settings.json
+
+Read \`~/.claude/settings.json\` and check if there's a \`"hooks"\` key with entries like:
+- \`bash $HOME/.claude/hooks/keyword-detector.sh\`
+- \`bash $HOME/.claude/hooks/persistent-mode.sh\`
+- \`bash $HOME/.claude/hooks/session-start.sh\`
+
+**Diagnosis**:
+- If found: CRITICAL - legacy hooks causing duplicates
+
+### Step 3: Check for Legacy Bash Hook Scripts
+
+\`\`\`bash
+ls -la ~/.claude/hooks/*.sh 2>/dev/null
+\`\`\`
+
+**Diagnosis**:
+- If \`keyword-detector.sh\`, \`persistent-mode.sh\`, \`session-start.sh\`, or \`stop-continuation.sh\` exist: WARN - legacy scripts (can cause confusion)
+
+### Step 4: Check CLAUDE.md
+
+\`\`\`bash
+# Check if CLAUDE.md exists
+ls -la ~/.claude/CLAUDE.md 2>/dev/null
+
+# Check for Olympus marker
+grep -q "Olympus Multi-Agent System" ~/.claude/CLAUDE.md 2>/dev/null && echo "Has Olympus config" || echo "Missing Olympus config"
+\`\`\`
+
+**Diagnosis**:
+- If missing: CRITICAL - CLAUDE.md not configured
+- If missing Olympus marker: WARN - outdated CLAUDE.md
+
+### Step 5: Check for Stale Plugin Cache
+
+\`\`\`bash
+# Count versions in cache
+ls ~/.claude/plugins/cache/olympus/olympus/ 2>/dev/null | wc -l
+\`\`\`
+
+**Diagnosis**:
+- If > 1 version: WARN - multiple cached versions (cleanup recommended)
+
+### Step 6: Check for Legacy Curl-Installed Content
+
+Check for legacy agents, commands, and skills installed via curl (before plugin system):
+
+\`\`\`bash
+# Check for legacy agents directory
+ls -la ~/.claude/agents/ 2>/dev/null
+
+# Check for legacy commands directory
+ls -la ~/.claude/commands/ 2>/dev/null
+
+# Check for legacy skills directory
+ls -la ~/.claude/skills/ 2>/dev/null
+\`\`\`
+
+**Diagnosis**:
+- If \`~/.claude/agents/\` exists with olympus-related files: WARN - legacy agents (now provided by plugin)
+- If \`~/.claude/commands/\` exists with olympus-related files: WARN - legacy commands (now provided by plugin)
+- If \`~/.claude/skills/\` exists with olympus-related files: WARN - legacy skills (now provided by plugin)
+
+Look for files like:
+- \`oracle.md\`, \`librarian.md\`, \`explore.md\`, \`olympian.md\`, etc. in agents/
+- \`ultrawork.md\`, \`olympus-default.md\`, \`deepsearch.md\`, etc. in commands/
+- Any olympus-related \`.md\` files in skills/
+
+---
+
+## Report Format
+
+After running all checks, output a report:
+
+\`\`\`
+## Olympus Doctor Report
+
+### Summary
+[HEALTHY / ISSUES FOUND]
+
+### Checks
+
+| Check | Status | Details |
+|-------|--------|---------|
+| Plugin Version | OK/WARN/CRITICAL | ... |
+| Legacy Hooks (settings.json) | OK/CRITICAL | ... |
+| Legacy Scripts (~/.claude/hooks/) | OK/WARN | ... |
+| CLAUDE.md | OK/WARN/CRITICAL | ... |
+| Plugin Cache | OK/WARN | ... |
+| Legacy Agents (~/.claude/agents/) | OK/WARN | ... |
+| Legacy Commands (~/.claude/commands/) | OK/WARN | ... |
+| Legacy Skills (~/.claude/skills/) | OK/WARN | ... |
+
+### Issues Found
+1. [Issue description]
+2. [Issue description]
+
+### Recommended Fixes
+[List fixes based on issues]
+\`\`\`
+
+---
+
+## Auto-Fix (if user confirms)
+
+If issues found, ask user: "Would you like me to fix these issues automatically?"
+
+If yes, apply fixes:
+
+### Fix: Legacy Hooks in settings.json
+Remove the \`"hooks"\` section from \`~/.claude/settings.json\` (keep other settings intact)
+
+### Fix: Legacy Bash Scripts
+\`\`\`bash
+rm -f ~/.claude/hooks/keyword-detector.sh
+rm -f ~/.claude/hooks/persistent-mode.sh
+rm -f ~/.claude/hooks/session-start.sh
+rm -f ~/.claude/hooks/stop-continuation.sh
+\`\`\`
+
+### Fix: Outdated Plugin
+\`\`\`bash
+rm -rf ~/.claude/plugins/cache/olympus
+echo "Plugin cache cleared. Restart Claude Code to fetch latest version."
+\`\`\`
+
+### Fix: Stale Cache (multiple versions)
+\`\`\`bash
+# Keep only latest version
+cd ~/.claude/plugins/cache/olympus/olympus/
+ls | sort -V | head -n -1 | xargs rm -rf
+\`\`\`
+
+### Fix: Missing/Outdated CLAUDE.md
+Fetch latest from GitHub and write to \`~/.claude/CLAUDE.md\`:
+\`\`\`
+WebFetch(url: "https://raw.githubusercontent.com/mikev10/olympus/main/docs/CLAUDE.md", prompt: "Return the complete raw markdown content exactly as-is")
+\`\`\`
+
+### Fix: Legacy Curl-Installed Content
+
+Remove legacy agents, commands, and skills directories (now provided by plugin):
+
+\`\`\`bash
+# Backup first (optional - ask user)
+# mv ~/.claude/agents ~/.claude/agents.bak
+# mv ~/.claude/commands ~/.claude/commands.bak
+# mv ~/.claude/skills ~/.claude/skills.bak
+
+# Or remove directly
+rm -rf ~/.claude/agents
+rm -rf ~/.claude/commands
+rm -rf ~/.claude/skills
+\`\`\`
+
+**Note**: Only remove if these contain olympus-related files. If user has custom agents/commands/skills, warn them and ask before removing.
+
+---
+
+## Post-Fix
+
+After applying fixes, inform user:
+> Fixes applied. **Restart Claude Code** for changes to take effect.`,
+    'deepinit.md': `---
+description: Index full codebase recursively with hierarchical AGENTS.md files
+---
+
+Target: $ARGUMENTS
+
+## Argument Parsing
+
+Parse the arguments for flags and path:
+- \`--update\` or \`-u\`: Update mode only (skip directories without existing AGENTS.md)
+- \`--dry-run\`: Show what would be created without writing files
+- \`[path]\`: Target directory (defaults to current directory if not specified)
+
+Examples:
+- \`/deepinit\` → Initialize current directory
+- \`/deepinit ./src\` → Initialize ./src directory
+- \`/deepinit --update\` → Update existing AGENTS.md files only
+- \`/deepinit ./src --update\` → Update existing AGENTS.md in ./src
+
+## Deep Initialization Task
+
+You are performing a **deep codebase initialization** - creating hierarchical AGENTS.md files that document every directory in the project.
+
+### What This Does
+
+1. **Recursively Analyzes** every directory in the codebase
+2. **Creates AGENTS.md** files that describe each directory's purpose and contents
+3. **Hierarchical Tagging** - lower-level files reference their parent AGENTS.md
+4. **Smart Updates** - if AGENTS.md exists, compares and merges changes
+
+### Execution Strategy
+
+Use **parallel exploration** with the explore agent to analyze directories, then use **olympian** agents to create the AGENTS.md files.
+
+#### Phase 1: Discovery
+
+\`\`\`
+Task(subagent_type="olympus:explore", prompt="Map the directory structure of this codebase. List all directories recursively (excluding node_modules, .git, dist, build, __pycache__, .venv). Return as a tree structure.")
+\`\`\`
+
+#### Phase 2: Hierarchical Generation
+
+Start from the root and work down:
+
+1. **Root Level First** - Create \`/AGENTS.md\` for the entire project
+2. **First-Level Directories** - Create \`src/AGENTS.md\`, \`lib/AGENTS.md\`, etc.
+3. **Deeper Levels** - Continue recursively, each referencing parent
+
+#### Phase 3: Content Generation Per Directory
+
+For each directory, the AGENTS.md should contain:
+
+\`\`\`markdown
+<!-- Parent: ../AGENTS.md -->
+# {Directory Name}
+
+## Purpose
+[What this directory contains and its role in the project]
+
+## Key Files
+- \`file1.ts\` - [description]
+- \`file2.ts\` - [description]
+
+## Subdirectories
+- \`subdir1/\` - [brief purpose, see subdir1/AGENTS.md]
+- \`subdir2/\` - [brief purpose, see subdir2/AGENTS.md]
+
+## For AI Agents
+[Special instructions for AI agents working in this directory]
+
+## Dependencies
+[Key dependencies or relationships with other parts of the codebase]
+\`\`\`
+
+#### Phase 4: Compare and Update (if exists)
+
+If an AGENTS.md already exists:
+1. Read the existing file
+2. Compare with the new analysis
+3. Preserve any manual annotations (look for \`<!-- MANUAL -->\` tags)
+4. Merge new discoveries while keeping existing documentation
+5. Update outdated information
+
+**Update Mode (\`--update\` flag)**:
+When \`--update\` is specified in arguments:
+- **Only process directories that already have AGENTS.md**
+- Skip directories without existing documentation
+- Focus on refreshing existing docs rather than creating new ones
+- Use this for maintaining documentation as codebase evolves
+
+**Dry Run Mode (\`--dry-run\` flag)**:
+When \`--dry-run\` is specified:
+- List all directories that would be processed
+- Show which files would be created/updated
+- Do NOT write any files
+- Report summary of planned changes
+
+### Parallelization Strategy
+
+- **Batch Processing**: Process directories at the same level in parallel
+- **Level Order**: Complete one level before starting the next (ensures parent references exist)
+- **Use Multiple Agents**: Spawn olympian agents for parallel file creation
+
+### Quality Checks
+
+After generation:
+- [ ] Every non-empty directory has an AGENTS.md
+- [ ] Parent references are correct (\`<!-- Parent: ../AGENTS.md -->\`)
+- [ ] File descriptions are accurate
+- [ ] No broken references to subdirectories
+
+### Begin Execution
+
+Start now. Create a todo list tracking each directory, then systematically generate AGENTS.md files from root to leaves.`
 };
 // SKILL_DEFINITIONS removed - skills are now only in COMMAND_DEFINITIONS to avoid duplicates
 // Skills are installed to ~/.claude/commands/<skill>/skill.md