claude-code-workflow 6.3.54 → 7.0.0

package/ccw/dist/core/hooks/keyword-detector.d.ts

@@ -0,0 +1,106 @@
+/**
+ * KeywordDetector - Detects magic keywords in user prompts
+ *
+ * Detects magic keywords in user prompts and returns the appropriate
+ * mode message to inject into context.
+ *
+ * Ported from oh-my-opencode's keyword-detector hook with adaptations
+ * for CCW architecture.
+ */
+/**
+ * Supported keyword types for mode detection
+ */
+export type KeywordType = 'cancel' | 'ralph' | 'autopilot' | 'ultrapilot' | 'team' | 'ultrawork' | 'swarm' | 'pipeline' | 'ralplan' | 'plan' | 'tdd' | 'ultrathink' | 'deepsearch' | 'analyze' | 'codex' | 'gemini';
+/**
+ * Detected keyword with metadata
+ */
+export interface DetectedKeyword {
+    /** Type of the detected keyword */
+    type: KeywordType;
+    /** The actual matched keyword string */
+    keyword: string;
+    /** Position in the original text where the keyword was found */
+    position: number;
+}
+/**
+ * Keyword patterns for each mode
+ */
+export declare const KEYWORD_PATTERNS: Record<KeywordType, RegExp>;
+/**
+ * Priority order for keyword detection
+ * Higher priority keywords are checked first and take precedence in conflict resolution
+ */
+export declare const KEYWORD_PRIORITY: KeywordType[];
+/**
+ * Remove code blocks from text to prevent false positives
+ * Handles both fenced code blocks and inline code
+ *
+ * @param text - The text to clean
+ * @returns Text with code blocks removed
+ */
+export declare function removeCodeBlocks(text: string): string;
+/**
+ * Sanitize text for keyword detection by removing structural noise.
+ * Strips XML tags, URLs, file paths, and code blocks.
+ *
+ * @param text - The text to sanitize
+ * @returns Sanitized text ready for keyword detection
+ */
+export declare function sanitizeText(text: string): string;
+/**
+ * Detect keywords in text and return matches with type info
+ *
+ * @param text - The text to analyze
+ * @param options - Optional configuration
+ * @returns Array of detected keywords with metadata
+ */
+export declare function detectKeywords(text: string, options?: {
+    teamEnabled?: boolean;
+}): DetectedKeyword[];
+/**
+ * Check if text contains any magic keyword
+ *
+ * @param text - The text to check
+ * @returns true if any keyword is detected
+ */
+export declare function hasKeyword(text: string): boolean;
+/**
+ * Get all detected keywords with conflict resolution applied
+ *
+ * Conflict resolution rules:
+ * - cancel suppresses everything (exclusive)
+ * - team beats autopilot (mutual exclusion)
+ *
+ * @param text - The text to analyze
+ * @param options - Optional configuration
+ * @returns Array of resolved keyword types in priority order
+ */
+export declare function getAllKeywords(text: string, options?: {
+    teamEnabled?: boolean;
+}): KeywordType[];
+/**
+ * Get the highest priority keyword detected with conflict resolution
+ *
+ * @param text - The text to analyze
+ * @param options - Optional configuration
+ * @returns The primary detected keyword or null if none found
+ */
+export declare function getPrimaryKeyword(text: string, options?: {
+    teamEnabled?: boolean;
+}): DetectedKeyword | null;
+/**
+ * Get keyword type for a given keyword string
+ *
+ * @param keyword - The keyword string to look up
+ * @returns The keyword type or null if not found
+ */
+export declare function getKeywordType(keyword: string): KeywordType | null;
+/**
+ * Check if a specific keyword type is detected in text
+ *
+ * @param text - The text to check
+ * @param type - The keyword type to look for
+ * @returns true if the keyword type is detected
+ */
+export declare function hasKeywordType(text: string, type: KeywordType): boolean;
+//# sourceMappingURL=keyword-detector.d.ts.map

package/ccw/dist/core/hooks/keyword-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyword-detector.d.ts","sourceRoot":"","sources":["../../../src/core/hooks/keyword-detector.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;GAEG;AACH,MAAM,MAAM,WAAW,GACnB,QAAQ,GACR,OAAO,GACP,WAAW,GACX,YAAY,GACZ,MAAM,GACN,WAAW,GACX,OAAO,GACP,UAAU,GACV,SAAS,GACT,MAAM,GACN,KAAK,GACL,YAAY,GACZ,YAAY,GACZ,SAAS,GACT,OAAO,GACP,QAAQ,CAAC;AAEb;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,mCAAmC;IACnC,IAAI,EAAE,WAAW,CAAC;IAClB,wCAAwC;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,gEAAgE;IAChE,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAiBxD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,WAAW,EAIzC,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CASrD;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAYjD;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;IAAE,WAAW,CAAC,EAAE,OAAO,CAAA;CAAE,GAClC,eAAe,EAAE,CAkCnB;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEhD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;IAAE,WAAW,CAAC,EAAE,OAAO,CAAA;CAAE,GAClC,WAAW,EAAE,CAiBf;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;IAAE,WAAW,CAAC,EAAE,OAAO,CAAA;CAAE,GAClC,eAAe,GAAG,IAAI,CAexB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAWlE;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAIvE"}

package/ccw/dist/core/hooks/keyword-detector.js

@@ -0,0 +1,194 @@
+/**
+ * KeywordDetector - Detects magic keywords in user prompts
+ *
+ * Detects magic keywords in user prompts and returns the appropriate
+ * mode message to inject into context.
+ *
+ * Ported from oh-my-opencode's keyword-detector hook with adaptations
+ * for CCW architecture.
+ */
+/**
+ * Keyword patterns for each mode
+ */
+export const KEYWORD_PATTERNS = {
+    cancel: /\b(cancelomc|stopomc)\b/i,
+    ralph: /\b(ralph)\b/i,
+    autopilot: /\b(autopilot|auto[\s-]?pilot|fullsend|full\s+auto)\b/i,
+    ultrapilot: /\b(ultrapilot|ultra-pilot)\b|\bparallel\s+build\b|\bswarm\s+build\b/i,
+    ultrawork: /\b(ultrawork|ulw)\b/i,
+    swarm: /\bswarm\s+\d+\s+agents?\b|\bcoordinated\s+agents\b|\bteam\s+mode\b/i,
+    team: /(?<!\b(?:my|the|our|a|his|her|their|its)\s)\bteam\b|\bcoordinated\s+team\b/i,
+    pipeline: /\bagent\s+pipeline\b|\bchain\s+agents\b/i,
+    ralplan: /\b(ralplan)\b/i,
+    plan: /\bplan\s+(this|the)\b/i,
+    tdd: /\b(tdd)\b|\btest\s+first\b/i,
+    ultrathink: /\b(ultrathink)\b/i,
+    deepsearch: /\b(deepsearch)\b|\bsearch\s+the\s+codebase\b|\bfind\s+in\s+(the\s+)?codebase\b/i,
+    analyze: /\b(deep[\s-]?analyze|deepanalyze)\b/i,
+    codex: /\b(ask|use|delegate\s+to)\s+(codex|gpt)\b/i,
+    gemini: /\b(ask|use|delegate\s+to)\s+gemini\b/i
+};
+/**
+ * Priority order for keyword detection
+ * Higher priority keywords are checked first and take precedence in conflict resolution
+ */
+export const KEYWORD_PRIORITY = [
+    'cancel', 'ralph', 'autopilot', 'ultrapilot', 'team', 'ultrawork',
+    'swarm', 'pipeline', 'ralplan', 'plan', 'tdd',
+    'ultrathink', 'deepsearch', 'analyze', 'codex', 'gemini'
+];
+/**
+ * Remove code blocks from text to prevent false positives
+ * Handles both fenced code blocks and inline code
+ *
+ * @param text - The text to clean
+ * @returns Text with code blocks removed
+ */
+export function removeCodeBlocks(text) {
+    // Remove fenced code blocks (``` or ~~~)
+    let result = text.replace(/```[\s\S]*?```/g, '');
+    result = result.replace(/~~~[\s\S]*?~~~/g, '');
+    // Remove inline code (single backticks)
+    result = result.replace(/`[^`]+`/g, '');
+    return result;
+}
+/**
+ * Sanitize text for keyword detection by removing structural noise.
+ * Strips XML tags, URLs, file paths, and code blocks.
+ *
+ * @param text - The text to sanitize
+ * @returns Sanitized text ready for keyword detection
+ */
+export function sanitizeText(text) {
+    // Remove XML tag blocks (opening + content + closing; tag names must match)
+    let result = text.replace(/<(\w[\w-]*)[\s>][\s\S]*?<\/\1>/g, '');
+    // Remove self-closing XML tags
+    result = result.replace(/<\w[\w-]*(?:\s[^>]*)?\s*\/>/g, '');
+    // Remove URLs
+    result = result.replace(/https?:\/\/\S+/g, '');
+    // Remove file paths - requires leading / or ./ or multi-segment dir/file.ext
+    result = result.replace(/(^|[\s"'`(])(?:\.?\/(?:[\w.-]+\/)*[\w.-]+|(?:[\w.-]+\/)+[\w.-]+\.\w+)/gm, '$1');
+    // Remove code blocks (fenced and inline)
+    result = removeCodeBlocks(result);
+    return result;
+}
+/**
+ * Detect keywords in text and return matches with type info
+ *
+ * @param text - The text to analyze
+ * @param options - Optional configuration
+ * @returns Array of detected keywords with metadata
+ */
+export function detectKeywords(text, options) {
+    const detected = [];
+    const cleanedText = sanitizeText(text);
+    const teamEnabled = options?.teamEnabled ?? false;
+    // Check each keyword type in priority order
+    for (const type of KEYWORD_PRIORITY) {
+        // Skip team-related types when team feature is disabled
+        if ((type === 'team' || type === 'ultrapilot' || type === 'swarm') && !teamEnabled) {
+            continue;
+        }
+        const pattern = KEYWORD_PATTERNS[type];
+        const match = cleanedText.match(pattern);
+        if (match && match.index !== undefined) {
+            detected.push({
+                type,
+                keyword: match[0],
+                position: match.index
+            });
+            // Legacy ultrapilot/swarm also activate team mode internally
+            if (teamEnabled && (type === 'ultrapilot' || type === 'swarm')) {
+                detected.push({
+                    type: 'team',
+                    keyword: match[0],
+                    position: match.index
+                });
+            }
+        }
+    }
+    return detected;
+}
+/**
+ * Check if text contains any magic keyword
+ *
+ * @param text - The text to check
+ * @returns true if any keyword is detected
+ */
+export function hasKeyword(text) {
+    return detectKeywords(text).length > 0;
+}
+/**
+ * Get all detected keywords with conflict resolution applied
+ *
+ * Conflict resolution rules:
+ * - cancel suppresses everything (exclusive)
+ * - team beats autopilot (mutual exclusion)
+ *
+ * @param text - The text to analyze
+ * @param options - Optional configuration
+ * @returns Array of resolved keyword types in priority order
+ */
+export function getAllKeywords(text, options) {
+    const detected = detectKeywords(text, options);
+    if (detected.length === 0)
+        return [];
+    let types = Array.from(new Set(detected.map(d => d.type)));
+    // Exclusive: cancel suppresses everything
+    if (types.includes('cancel'))
+        return ['cancel'];
+    // Mutual exclusion: team beats autopilot (ultrapilot/swarm now map to team at detection)
+    if (types.includes('team') && types.includes('autopilot')) {
+        types = types.filter(t => t !== 'autopilot');
+    }
+    // Sort by priority order
+    return KEYWORD_PRIORITY.filter(k => types.includes(k));
+}
+/**
+ * Get the highest priority keyword detected with conflict resolution
+ *
+ * @param text - The text to analyze
+ * @param options - Optional configuration
+ * @returns The primary detected keyword or null if none found
+ */
+export function getPrimaryKeyword(text, options) {
+    const allKeywords = getAllKeywords(text, options);
+    if (allKeywords.length === 0) {
+        return null;
+    }
+    // Get the highest priority keyword type
+    const primaryType = allKeywords[0];
+    // Find the original detected keyword for this type
+    const detected = detectKeywords(text, options);
+    const match = detected.find(d => d.type === primaryType);
+    return match || null;
+}
+/**
+ * Get keyword type for a given keyword string
+ *
+ * @param keyword - The keyword string to look up
+ * @returns The keyword type or null if not found
+ */
+export function getKeywordType(keyword) {
+    const normalizedKeyword = keyword.toLowerCase();
+    for (const type of KEYWORD_PRIORITY) {
+        const pattern = KEYWORD_PATTERNS[type];
+        if (pattern.test(normalizedKeyword)) {
+            return type;
+        }
+    }
+    return null;
+}
+/**
+ * Check if a specific keyword type is detected in text
+ *
+ * @param text - The text to check
+ * @param type - The keyword type to look for
+ * @returns true if the keyword type is detected
+ */
+export function hasKeywordType(text, type) {
+    const cleanedText = sanitizeText(text);
+    const pattern = KEYWORD_PATTERNS[type];
+    return pattern.test(cleanedText);
+}
+//# sourceMappingURL=keyword-detector.js.map

package/ccw/dist/core/hooks/keyword-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyword-detector.js","sourceRoot":"","sources":["../../../src/core/hooks/keyword-detector.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAmCH;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAgC;IAC3D,MAAM,EAAE,0BAA0B;IAClC,KAAK,EAAE,cAAc;IACrB,SAAS,EAAE,uDAAuD;IAClE,UAAU,EAAE,sEAAsE;IAClF,SAAS,EAAE,sBAAsB;IACjC,KAAK,EAAE,qEAAqE;IAC5E,IAAI,EAAE,6EAA6E;IACnF,QAAQ,EAAE,0CAA0C;IACpD,OAAO,EAAE,gBAAgB;IACzB,IAAI,EAAE,wBAAwB;IAC9B,GAAG,EAAE,6BAA6B;IAClC,UAAU,EAAE,mBAAmB;IAC/B,UAAU,EAAE,iFAAiF;IAC7F,OAAO,EAAE,sCAAsC;IAC/C,KAAK,EAAE,4CAA4C;IACnD,MAAM,EAAE,uCAAuC;CAChD,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAkB;IAC7C,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,EAAE,WAAW;IACjE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK;IAC7C,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ;CACzD,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,yCAAyC;IACzC,IAAI,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC;IACjD,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC;IAE/C,wCAAwC;IACxC,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAExC,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,4EAA4E;IAC5E,IAAI,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,iCAAiC,EAAE,EAAE,CAAC,CAAC;IACjE,+BAA+B;IAC/B,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,8BAA8B,EAAE,EAAE,CAAC,CAAC;IAC5D,cAAc;IACd,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC;IAC/C,6EAA6E;IAC7E,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,yEAAyE,EAAE,IAAI,CAAC,CAAC;IACzG,yCAAyC;IACzC,MAAM,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAClC,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAC5B,IAAY,EACZ,OAAmC;IAEnC,MAAM,QAAQ,GAAsB,EAAE,CAAC;IACvC,MAAM,WAAW,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IACvC,MAAM,WAAW,GAAG,OAAO,EAAE,WAAW,IAAI,KAAK,CAAC;IAElD,4CAA4C;IAC5C,KAAK,MAAM,IAAI,IAAI,gBAAgB,EAAE,CAAC;QACpC,wDAAwD;QACxD,IAAI,CAAC,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,YAAY,IAAI,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACnF,SAAS;QACX,CAAC;QAED,MAAM,OAAO,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;QACvC,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAEzC,IAAI,KAAK,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YACvC,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI;gBACJ,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;gBACjB,QAAQ,EAAE,KAAK,CAAC,KAAK;aACtB,CAAC,CAAC;YAEH,6DAA6D;YAC7D,IAAI,WAAW,IAAI,CAAC,IAAI,KAAK,YAAY,IAAI,IAAI,KAAK,OAAO,CAAC,EAAE,CAAC;gBAC/D,QAAQ,CAAC,IAAI,CAAC;oBACZ,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;oBACjB,QAAQ,EAAE,KAAK,CAAC,KAAK;iBACtB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,cAAc,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;AACzC,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,cAAc,CAC5B,IAAY,EACZ,OAAmC;IAEnC,MAAM,QAAQ,GAAG,cAAc,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAE/C,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAErC,IAAI,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAE3D,0CAA0C;IAC1C,IAAI,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IAEhD,yFAAyF;IACzF,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;QAC1D,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,WAAW,CAAC,CAAC;IAC/C,CAAC;IAED,yBAAyB;IACzB,OAAO,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;AACzD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAC/B,IAAY,EACZ,OAAmC;IAEnC,MAAM,WAAW,GAAG,cAAc,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAElD,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,wCAAwC;IACxC,MAAM,WAAW,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;IAEnC,mDAAmD;IACnD,MAAM,QAAQ,GAAG,cAAc,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC/C,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC;IAEzD,OAAO,KAAK,IAAI,IAAI,CAAC;AACvB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,OAAe;IAC5C,MAAM,iBAAiB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAEhD,KAAK,MAAM,IAAI,IAAI,gBAAgB,EAAE,CAAC;QACpC,MAAM,OAAO,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;QACvC,IAAI,OAAO,CAAC,IAAI,CAAC,iBAAiB,CAAC,EAAE,CAAC;YACpC,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,IAAiB;IAC5D,MAAM,WAAW,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IACvC,MAAM,OAAO,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACvC,OAAO,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;AACnC,CAAC"}

package/ccw/dist/core/hooks/recovery-handler.d.ts

@@ -0,0 +1,114 @@
+/**
+ * RecoveryHandler - Session Recovery and PreCompact Handler
+ *
+ * Handles PreCompact hook events and session recovery for state preservation
+ * during context compaction and session restarts.
+ *
+ * Features:
+ *   - PreCompact checkpoint creation before context compaction
+ *   - Session recovery detection and message injection
+ *   - Mutex lock to prevent concurrent compaction operations
+ *
+ * Based on oh-my-claudecode pre-compact pattern.
+ */
+import type { Checkpoint } from '../services/checkpoint-service.js';
+/**
+ * Input from PreCompact hook event
+ */
+export interface PreCompactInput {
+    /** Session ID */
+    session_id: string;
+    /** Path to transcript file */
+    transcript_path?: string;
+    /** Current working directory */
+    cwd: string;
+    /** Permission mode */
+    permission_mode?: string;
+    /** Hook event name */
+    hook_event_name: 'PreCompact';
+    /** Trigger type */
+    trigger: 'manual' | 'auto';
+    /** Custom instructions */
+    custom_instructions?: string;
+}
+/**
+ * Output for hook handlers
+ */
+export interface HookOutput {
+    /** Whether to continue with the operation */
+    continue: boolean;
+    /** System message for context injection */
+    systemMessage?: string;
+}
+/**
+ * Options for RecoveryHandler
+ */
+export interface RecoveryHandlerOptions {
+    /** Project root path */
+    projectPath: string;
+    /** Enable logging */
+    enableLogging?: boolean;
+}
+/**
+ * Handler for PreCompact hook events and session recovery
+ */
+export declare class RecoveryHandler {
+    private projectPath;
+    private enableLogging;
+    constructor(options: RecoveryHandlerOptions);
+    /**
+     * Handle PreCompact hook event
+     *
+     * Creates a checkpoint before compaction to preserve state.
+     * Uses mutex to prevent concurrent compaction for the same directory.
+     *
+     * @param input - PreCompact hook input
+     * @returns Promise resolving to hook output with checkpoint summary
+     */
+    handlePreCompact(input: PreCompactInput): Promise<HookOutput>;
+    /**
+     * Internal PreCompact handler (unserialized)
+     */
+    private doHandlePreCompact;
+    /**
+     * Check for recoverable checkpoint for a session
+     *
+     * @param sessionId - The session ID to check
+     * @returns The most recent checkpoint or null if none found
+     */
+    checkRecovery(sessionId: string): Promise<Checkpoint | null>;
+    /**
+     * Generate recovery message for context injection
+     *
+     * @param checkpoint - The checkpoint to format
+     * @returns Formatted recovery message
+     */
+    formatRecoveryMessage(checkpoint: Checkpoint): Promise<string>;
+    /**
+     * Check if compaction is currently in progress for a directory
+     *
+     * @param directory - The directory to check
+     * @returns true if compaction is in progress
+     */
+    isCompactionInProgress(directory: string): boolean;
+    /**
+     * Get the number of callers queued behind an in-flight compaction
+     *
+     * @param directory - The directory to check
+     * @returns Number of queued callers (0 if no compaction in progress)
+     */
+    getCompactionQueueDepth(directory: string): number;
+    /**
+     * Log a message if logging is enabled
+     */
+    private log;
+}
+/**
+ * Create a RecoveryHandler instance
+ *
+ * @param options - Handler options
+ * @returns RecoveryHandler instance
+ */
+export declare function createRecoveryHandler(options: RecoveryHandlerOptions): RecoveryHandler;
+export default RecoveryHandler;
+//# sourceMappingURL=recovery-handler.d.ts.map

package/ccw/dist/core/hooks/recovery-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recovery-handler.d.ts","sourceRoot":"","sources":["../../../src/core/hooks/recovery-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAqB,MAAM,mCAAmC,CAAC;AAMvF;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,iBAAiB;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,8BAA8B;IAC9B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gCAAgC;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,sBAAsB;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,sBAAsB;IACtB,eAAe,EAAE,YAAY,CAAC;IAC9B,mBAAmB;IACnB,OAAO,EAAE,QAAQ,GAAG,MAAM,CAAC;IAC3B,0BAA0B;IAC1B,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,6CAA6C;IAC7C,QAAQ,EAAE,OAAO,CAAC;IAClB,2CAA2C;IAC3C,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,wBAAwB;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,qBAAqB;IACrB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAyBD;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,aAAa,CAAU;gBAEnB,OAAO,EAAE,sBAAsB;IAS3C;;;;;;;;OAQG;IACG,gBAAgB,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC;IAgCnE;;OAEG;YACW,kBAAkB;IAsEhC;;;;;OAKG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAsBlE;;;;;OAKG;IACG,qBAAqB,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;IA2BpE;;;;;OAKG;IACH,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAIlD;;;;;OAKG;IACH,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAQlD;;OAEG;IACH,OAAO,CAAC,GAAG;CAMZ;AAMD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,GAAG,eAAe,CAEtF;AAMD,eAAe,eAAe,CAAC"}

package/ccw/dist/core/hooks/recovery-handler.js

@@ -0,0 +1,244 @@
+/**
+ * RecoveryHandler - Session Recovery and PreCompact Handler
+ *
+ * Handles PreCompact hook events and session recovery for state preservation
+ * during context compaction and session restarts.
+ *
+ * Features:
+ *   - PreCompact checkpoint creation before context compaction
+ *   - Session recovery detection and message injection
+ *   - Mutex lock to prevent concurrent compaction operations
+ *
+ * Based on oh-my-claudecode pre-compact pattern.
+ */
+// =============================================================================
+// Compaction Mutex
+// =============================================================================
+/**
+ * Per-directory in-flight compaction promises.
+ * When a compaction is already running for a directory, new callers
+ * await the existing promise instead of running concurrently.
+ * This prevents race conditions when multiple subagent results
+ * arrive simultaneously (swarm/ultrawork).
+ */
+const inflightCompactions = new Map();
+/**
+ * Queue depth counter per directory for diagnostics.
+ * Tracks how many callers are waiting on an in-flight compaction.
+ */
+const compactionQueueDepth = new Map();
+// =============================================================================
+// RecoveryHandler Class
+// =============================================================================
+/**
+ * Handler for PreCompact hook events and session recovery
+ */
+export class RecoveryHandler {
+    projectPath;
+    enableLogging;
+    constructor(options) {
+        this.projectPath = options.projectPath;
+        this.enableLogging = options.enableLogging ?? false;
+    }
+    // ---------------------------------------------------------------------------
+    // Public: PreCompact Handler
+    // ---------------------------------------------------------------------------
+    /**
+     * Handle PreCompact hook event
+     *
+     * Creates a checkpoint before compaction to preserve state.
+     * Uses mutex to prevent concurrent compaction for the same directory.
+     *
+     * @param input - PreCompact hook input
+     * @returns Promise resolving to hook output with checkpoint summary
+     */
+    async handlePreCompact(input) {
+        const directory = input.cwd || this.projectPath;
+        // Check for in-flight compaction
+        const inflight = inflightCompactions.get(directory);
+        if (inflight) {
+            const depth = (compactionQueueDepth.get(directory) ?? 0) + 1;
+            compactionQueueDepth.set(directory, depth);
+            try {
+                // Await the existing compaction result
+                return await inflight;
+            }
+            finally {
+                const current = compactionQueueDepth.get(directory) ?? 1;
+                if (current <= 1) {
+                    compactionQueueDepth.delete(directory);
+                }
+                else {
+                    compactionQueueDepth.set(directory, current - 1);
+                }
+            }
+        }
+        // No in-flight compaction - run it and register the promise
+        const compactionPromise = this.doHandlePreCompact(input);
+        inflightCompactions.set(directory, compactionPromise);
+        try {
+            return await compactionPromise;
+        }
+        finally {
+            inflightCompactions.delete(directory);
+        }
+    }
+    /**
+     * Internal PreCompact handler (unserialized)
+     */
+    async doHandlePreCompact(input) {
+        this.log(`Creating checkpoint for session ${input.session_id} (trigger: ${input.trigger})`);
+        try {
+            // Import services dynamically
+            const { CheckpointService } = await import('../services/checkpoint-service.js');
+            const { ModeRegistryService } = await import('../services/mode-registry-service.js');
+            // Create checkpoint service
+            const checkpointService = new CheckpointService({
+                projectPath: this.projectPath,
+                enableLogging: this.enableLogging
+            });
+            // Get mode registry for active modes
+            const modeRegistry = new ModeRegistryService({
+                projectPath: this.projectPath,
+                enableLogging: this.enableLogging
+            });
+            // Collect active mode states
+            const activeModes = modeRegistry.getActiveModes(input.session_id);
+            const modeStates = {};
+            for (const mode of activeModes) {
+                modeStates[mode] = {
+                    active: true,
+                    activatedAt: new Date().toISOString()
+                };
+            }
+            // Create checkpoint
+            const trigger = input.trigger === 'manual' ? 'manual' : 'compact';
+            const checkpoint = await checkpointService.createCheckpoint(input.session_id, trigger, {
+                modeStates: modeStates,
+                workflowState: null,
+                memoryContext: null
+            });
+            // Save checkpoint
+            await checkpointService.saveCheckpoint(checkpoint);
+            // Format recovery message
+            const systemMessage = checkpointService.formatRecoveryMessage(checkpoint);
+            this.log(`Checkpoint created: ${checkpoint.id}`);
+            return {
+                continue: true,
+                systemMessage
+            };
+        }
+        catch (error) {
+            this.log(`Error creating checkpoint: ${error.message}`);
+            // Return success even on error - don't block compaction
+            return {
+                continue: true,
+                systemMessage: `[PRECOMPACT WARNING] Checkpoint creation failed: ${error.message}. Proceeding with compaction.`
+            };
+        }
+    }
+    // ---------------------------------------------------------------------------
+    // Public: Recovery Detection
+    // ---------------------------------------------------------------------------
+    /**
+     * Check for recoverable checkpoint for a session
+     *
+     * @param sessionId - The session ID to check
+     * @returns The most recent checkpoint or null if none found
+     */
+    async checkRecovery(sessionId) {
+        try {
+            const { CheckpointService } = await import('../services/checkpoint-service.js');
+            const checkpointService = new CheckpointService({
+                projectPath: this.projectPath,
+                enableLogging: this.enableLogging
+            });
+            const checkpoint = await checkpointService.getLatestCheckpoint(sessionId);
+            if (checkpoint) {
+                this.log(`Found recoverable checkpoint: ${checkpoint.id} (trigger: ${checkpoint.trigger})`);
+            }
+            return checkpoint;
+        }
+        catch (error) {
+            this.log(`Error checking recovery: ${error.message}`);
+            return null;
+        }
+    }
+    /**
+     * Generate recovery message for context injection
+     *
+     * @param checkpoint - The checkpoint to format
+     * @returns Formatted recovery message
+     */
+    async formatRecoveryMessage(checkpoint) {
+        try {
+            const { CheckpointService } = await import('../services/checkpoint-service.js');
+            const checkpointService = new CheckpointService({
+                projectPath: this.projectPath,
+                enableLogging: false
+            });
+            return checkpointService.formatRecoveryMessage(checkpoint);
+        }
+        catch (error) {
+            // Fallback to basic format
+            return `# Session Recovery
+
+**Checkpoint ID:** ${checkpoint.id}
+**Created:** ${checkpoint.created_at}
+**Trigger:** ${checkpoint.trigger}
+**Session:** ${checkpoint.session_id}
+
+*This checkpoint was created to preserve session state.*`;
+        }
+    }
+    // ---------------------------------------------------------------------------
+    // Public: Mutex Status
+    // ---------------------------------------------------------------------------
+    /**
+     * Check if compaction is currently in progress for a directory
+     *
+     * @param directory - The directory to check
+     * @returns true if compaction is in progress
+     */
+    isCompactionInProgress(directory) {
+        return inflightCompactions.has(directory);
+    }
+    /**
+     * Get the number of callers queued behind an in-flight compaction
+     *
+     * @param directory - The directory to check
+     * @returns Number of queued callers (0 if no compaction in progress)
+     */
+    getCompactionQueueDepth(directory) {
+        return compactionQueueDepth.get(directory) ?? 0;
+    }
+    // ---------------------------------------------------------------------------
+    // Private: Utility Methods
+    // ---------------------------------------------------------------------------
+    /**
+     * Log a message if logging is enabled
+     */
+    log(message) {
+        if (this.enableLogging) {
+            const timestamp = new Date().toISOString();
+            console.log(`[RecoveryHandler ${timestamp}] ${message}`);
+        }
+    }
+}
+// =============================================================================
+// Factory Function
+// =============================================================================
+/**
+ * Create a RecoveryHandler instance
+ *
+ * @param options - Handler options
+ * @returns RecoveryHandler instance
+ */
+export function createRecoveryHandler(options) {
+    return new RecoveryHandler(options);
+}
+// =============================================================================
+// Default Export
+// =============================================================================
+export default RecoveryHandler;
+//# sourceMappingURL=recovery-handler.js.map