oh-my-claude-sisyphus 3.8.16 → 3.9.1

package/dist/hooks/clear-suggestions/constants.js

@@ -0,0 +1,102 @@
+/**
+ * Clear Suggestions Constants
+ *
+ * Messages, thresholds, and configuration defaults for the
+ * adaptive /clear suggestions system.
+ */
+/**
+ * Cooldown period between clear suggestions (5 minutes)
+ */
+export const CLEAR_SUGGESTION_COOLDOWN_MS = 5 * 60 * 1000;
+/**
+ * Maximum suggestions per session
+ */
+export const MAX_CLEAR_SUGGESTIONS = 2;
+/**
+ * Context usage threshold to trigger context+artifacts suggestion (50%)
+ */
+export const CONTEXT_THRESHOLD = 0.50;
+/**
+ * Consecutive failure count for degradation signal
+ */
+export const FAILURE_THRESHOLD = 3;
+/**
+ * Failure window - only count failures within this window (10 minutes)
+ */
+export const FAILURE_WINDOW_MS = 10 * 60 * 1000;
+/**
+ * Message for workflow completion trigger
+ */
+export const WORKFLOW_COMPLETE_MESSAGE = (modeName, artifacts) => `SESSION RESET SUGGESTION
+
+The **${modeName}** workflow has completed successfully. Starting fresh with /clear would give you:
+- A clean context window for your next task
+- Faster, more reliable responses
+- No stale context from the completed workflow
+
+${artifacts}
+Type **/clear** to start fresh, or continue working in this session.
+`;
+/**
+ * Message for architect verification trigger
+ */
+export const ARCHITECT_VERIFIED_MESSAGE = (artifacts) => `SESSION RESET SUGGESTION
+
+Architect verification has **passed** - your work is approved. This is an ideal moment to reset:
+- The verification cycle consumed significant context
+- Your completed work is saved in project files
+- A fresh session will be more responsive for the next task
+
+${artifacts}
+Type **/clear** to start fresh, or continue working in this session.
+`;
+/**
+ * Message for planning complete trigger
+ */
+export const PLANNING_COMPLETE_MESSAGE = (artifacts) => `SESSION RESET SUGGESTION
+
+Planning is **complete** and your plan has been saved to disk. Consider resetting:
+- The planning interview used substantial context
+- Your plan files are preserved and will be auto-loaded
+- Execution will be more reliable in a fresh session
+
+${artifacts}
+Type **/clear** to start fresh, or continue working in this session.
+`;
+/**
+ * Message for context+artifacts trigger
+ */
+export const CONTEXT_ARTIFACTS_MESSAGE = (usagePct, artifacts) => `SESSION RESET SUGGESTION
+
+Context usage is at **${usagePct}%** but your progress is safely preserved in project files. Consider resetting:
+- High context usage can cause degraded performance
+- /clear reloads your CLAUDE.md and project context automatically
+- Your artifacts will be available in the new session
+
+${artifacts}
+Type **/clear** to start fresh, or use **/compact** if you want to continue this session.
+`;
+/**
+ * Message for degradation signals trigger
+ */
+export const DEGRADATION_SIGNALS_MESSAGE = (failureCount, artifacts) => `SESSION RESET SUGGESTION
+
+Detected **${failureCount} consecutive failures** which may indicate context degradation. A fresh start could help:
+- Accumulated context can cause tool call failures
+- /clear gives you a clean slate while preserving all files
+- Your work is saved on disk and will not be lost
+
+${artifacts}
+Type **/clear** to start fresh, or continue troubleshooting in this session.
+`;
+/**
+ * Format preserved artifacts into a readable list
+ */
+export function formatPreservedArtifacts(artifacts) {
+    if (artifacts.length === 0) {
+        return '';
+    }
+    const lines = artifacts.map(a => `  - ${a.description}`);
+    return `**Preserved artifacts** (available after /clear):\n${lines.join('\n')}\n`;
+}
+//# sourceMappingURL=constants.js.map

package/dist/hooks/clear-suggestions/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/hooks/clear-suggestions/constants.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;AAE1D;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC;AAEvC;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,CAAC;AAEtC;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC;AAEnC;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAEhD;;GAEG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,QAAgB,EAAE,SAAiB,EAAU,EAAE,CACvF;;QAEM,QAAQ;;;;;EAKd,SAAS;;CAEV,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,SAAiB,EAAU,EAAE,CACtE;;;;;;;EAOA,SAAS;;CAEV,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,SAAiB,EAAU,EAAE,CACrE;;;;;;;EAOA,SAAS;;CAEV,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,QAAgB,EAAE,SAAiB,EAAU,EAAE,CACvF;;wBAEsB,QAAQ;;;;;EAK9B,SAAS;;CAEV,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,YAAoB,EAAE,SAAiB,EAAU,EAAE,CAC7F;;aAEW,YAAY;;;;;EAKvB,SAAS;;CAEV,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,wBAAwB,CACtC,SAAuD;IAEvD,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;IACzD,OAAO,sDAAsD,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;AACpF,CAAC"}

package/dist/hooks/clear-suggestions/index.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Clear Suggestions Hook
+ *
+ * Adaptive /clear suggestions system that intelligently recommends session
+ * resets when it would improve reliability and performance.
+ *
+ * Features:
+ * - 5 semantic triggers for context-aware suggestions
+ * - 5-minute cooldown between suggestions
+ * - Maximum 2 suggestions per session
+ * - Non-intrusive messaging explaining WHY clearing helps
+ * - Lists preserved artifacts (plans, notes, decisions)
+ *
+ * Complements (doesn't replace) existing /compact suggestions.
+ */
+import type { ClearSuggestionState, ClearSuggestionConfig, ClearSuggestionResult, ClearSuggestionInput } from './types.js';
+/**
+ * Main check function - evaluates all triggers and returns suggestion if appropriate
+ */
+export declare function checkClearSuggestion(input: ClearSuggestionInput, config?: ClearSuggestionConfig): ClearSuggestionResult;
+/**
+ * Mark planning as just completed (called by plan/ralplan skills)
+ */
+export declare function markPlanningComplete(sessionId: string): void;
+/**
+ * Reset session state (called on /clear)
+ */
+export declare function resetClearSuggestionState(sessionId: string): void;
+/**
+ * Get current session stats (for debugging)
+ */
+export declare function getClearSuggestionStats(sessionId: string): ClearSuggestionState | null;
+/**
+ * Clean up stale sessions (older than 30 minutes)
+ */
+export declare function cleanupStaleSessions(): void;
+/**
+ * Create a clear suggestion hook instance
+ */
+export declare function createClearSuggestionHook(config?: ClearSuggestionConfig): {
+    /**
+     * PostToolUse - Check if we should suggest /clear
+     */
+    postToolUse: (input: {
+        tool_name: string;
+        session_id: string;
+        directory: string;
+        tool_response?: string;
+        context_usage_ratio?: number;
+    }) => string | null;
+    /**
+     * Stop event - Reset failure tracking
+     */
+    stop: (input: {
+        session_id: string;
+    }) => void;
+};
+export type { ClearSuggestionTrigger, ClearSuggestionState, ClearSuggestionConfig, ClearSuggestionResult, ClearSuggestionInput, PreservedArtifact, } from './types.js';
+export { CLEAR_SUGGESTION_COOLDOWN_MS, MAX_CLEAR_SUGGESTIONS, CONTEXT_THRESHOLD, FAILURE_THRESHOLD, } from './constants.js';
+export { detectWorkflowComplete, detectArchitectVerified, detectPlanningComplete, detectContextWithArtifacts, detectDegradationSignals, isToolFailure, discoverPreservedArtifacts, checkModeJustCompleted, checkArchitectJustVerified, } from './triggers.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/hooks/clear-suggestions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/clear-suggestions/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAEV,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,EACrB,oBAAoB,EAErB,MAAM,YAAY,CAAC;AA8JpB;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,oBAAoB,EAC3B,MAAM,CAAC,EAAE,qBAAqB,GAC7B,qBAAqB,CAmGvB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAE5D;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAEjE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,oBAAoB,GAAG,IAAI,CAEtF;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAS3C;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,CAAC,EAAE,qBAAqB;IAEpE;;OAEG;yBACkB;QACnB,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC;QAClB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,mBAAmB,CAAC,EAAE,MAAM,CAAC;KAC9B,KAAG,MAAM,GAAG,IAAI;IAmBjB;;OAEG;kBACW;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,KAAG,IAAI;EAI9C;AAGD,YAAY,EACV,sBAAsB,EACtB,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,EACrB,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,4BAA4B,EAC5B,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,sBAAsB,EACtB,uBAAuB,EACvB,sBAAsB,EACtB,0BAA0B,EAC1B,wBAAwB,EACxB,aAAa,EACb,0BAA0B,EAC1B,sBAAsB,EACtB,0BAA0B,GAC3B,MAAM,eAAe,CAAC"}

package/dist/hooks/clear-suggestions/index.js

@@ -0,0 +1,282 @@
+/**
+ * Clear Suggestions Hook
+ *
+ * Adaptive /clear suggestions system that intelligently recommends session
+ * resets when it would improve reliability and performance.
+ *
+ * Features:
+ * - 5 semantic triggers for context-aware suggestions
+ * - 5-minute cooldown between suggestions
+ * - Maximum 2 suggestions per session
+ * - Non-intrusive messaging explaining WHY clearing helps
+ * - Lists preserved artifacts (plans, notes, decisions)
+ *
+ * Complements (doesn't replace) existing /compact suggestions.
+ */
+import { CLEAR_SUGGESTION_COOLDOWN_MS, MAX_CLEAR_SUGGESTIONS, WORKFLOW_COMPLETE_MESSAGE, ARCHITECT_VERIFIED_MESSAGE, PLANNING_COMPLETE_MESSAGE, CONTEXT_ARTIFACTS_MESSAGE, DEGRADATION_SIGNALS_MESSAGE, formatPreservedArtifacts, } from './constants.js';
+import { detectWorkflowComplete, detectArchitectVerified, detectPlanningComplete, detectContextWithArtifacts, detectDegradationSignals, isToolFailure, discoverPreservedArtifacts, checkModeJustCompleted, checkArchitectJustVerified, } from './triggers.js';
+import { isAnyModeActive } from '../mode-registry/index.js';
+/**
+ * In-memory session state tracking
+ */
+const sessionStates = new Map();
+/**
+ * Get or create session state
+ */
+function getSessionState(sessionId) {
+    let state = sessionStates.get(sessionId);
+    if (!state) {
+        state = {
+            sessionId,
+            lastSuggestionTime: 0,
+            suggestionCount: 0,
+            consecutiveFailures: 0,
+            failureTimestamps: [],
+        };
+        sessionStates.set(sessionId, state);
+    }
+    return state;
+}
+/**
+ * Update session state
+ */
+function updateSessionState(sessionId, updates) {
+    const state = getSessionState(sessionId);
+    Object.assign(state, updates);
+}
+/**
+ * Record a suggestion was shown
+ */
+function recordSuggestion(sessionId) {
+    const state = getSessionState(sessionId);
+    state.lastSuggestionTime = Date.now();
+    state.suggestionCount++;
+    // Clear one-time flags
+    state.workflowJustCompleted = undefined;
+    state.architectJustVerified = undefined;
+    state.planningJustCompleted = undefined;
+}
+/**
+ * Record a tool failure
+ */
+function recordFailure(sessionId) {
+    const state = getSessionState(sessionId);
+    state.consecutiveFailures++;
+    state.failureTimestamps.push(Date.now());
+    // Keep only recent timestamps (last 10)
+    if (state.failureTimestamps.length > 10) {
+        state.failureTimestamps = state.failureTimestamps.slice(-10);
+    }
+}
+/**
+ * Reset failure count (called on successful tool execution)
+ */
+function resetFailures(sessionId) {
+    const state = getSessionState(sessionId);
+    state.consecutiveFailures = 0;
+}
+/**
+ * Check if cooldown has elapsed
+ */
+function isCooldownElapsed(sessionId, config) {
+    const state = getSessionState(sessionId);
+    const cooldownMs = config?.cooldownMs ?? CLEAR_SUGGESTION_COOLDOWN_MS;
+    const elapsed = Date.now() - state.lastSuggestionTime;
+    return elapsed >= cooldownMs;
+}
+/**
+ * Check if max suggestions reached
+ */
+function isMaxSuggestionsReached(sessionId, config) {
+    const state = getSessionState(sessionId);
+    const maxSuggestions = config?.maxSuggestions ?? MAX_CLEAR_SUGGESTIONS;
+    return state.suggestionCount >= maxSuggestions;
+}
+/**
+ * Generate message for a trigger
+ */
+function generateMessage(trigger, artifacts, state, contextUsageRatio) {
+    const artifactsText = formatPreservedArtifacts(artifacts.map(a => ({ type: a.type, description: a.description })));
+    switch (trigger) {
+        case 'workflow_complete': {
+            const modeName = state.workflowJustCompleted || 'workflow';
+            const modeDisplayNames = {
+                ralph: 'Ralph',
+                autopilot: 'Autopilot',
+                ultrawork: 'Ultrawork',
+                ultraqa: 'UltraQA',
+                ultrapilot: 'Ultrapilot',
+                swarm: 'Swarm',
+                pipeline: 'Pipeline',
+                ecomode: 'Ecomode',
+            };
+            const displayName = modeDisplayNames[modeName] || modeName;
+            return WORKFLOW_COMPLETE_MESSAGE(displayName, artifactsText);
+        }
+        case 'architect_verified':
+            return ARCHITECT_VERIFIED_MESSAGE(artifactsText);
+        case 'planning_complete':
+            return PLANNING_COMPLETE_MESSAGE(artifactsText);
+        case 'context_artifacts': {
+            const usagePct = Math.round((contextUsageRatio ?? 0.5) * 100);
+            return CONTEXT_ARTIFACTS_MESSAGE(usagePct, artifactsText);
+        }
+        case 'degradation_signals': {
+            const failureCount = state.consecutiveFailures;
+            return DEGRADATION_SIGNALS_MESSAGE(failureCount, artifactsText);
+        }
+        default:
+            return '';
+    }
+}
+/**
+ * Main check function - evaluates all triggers and returns suggestion if appropriate
+ */
+export function checkClearSuggestion(input, config) {
+    const { sessionId, directory, toolName, toolOutput, contextUsageRatio } = input;
+    // Check if disabled
+    if (config?.enabled === false) {
+        return { shouldSuggest: false, skipReason: 'disabled' };
+    }
+    // Don't suggest /clear while an OMC mode is actively running
+    // Only suggest after the mode completes
+    if (isAnyModeActive(directory)) {
+        return { shouldSuggest: false, skipReason: 'mode_active' };
+    }
+    // Check max suggestions
+    if (isMaxSuggestionsReached(sessionId, config)) {
+        return { shouldSuggest: false, skipReason: 'max_suggestions_reached' };
+    }
+    // Check cooldown
+    if (!isCooldownElapsed(sessionId, config)) {
+        return { shouldSuggest: false, skipReason: 'cooldown_active' };
+    }
+    // Get session state
+    const state = getSessionState(sessionId);
+    // Track tool failures/successes
+    if (toolName && toolOutput) {
+        if (isToolFailure(toolName, toolOutput)) {
+            recordFailure(sessionId);
+        }
+        else {
+            resetFailures(sessionId);
+        }
+    }
+    // Check for mode completions
+    const completedModes = ['ralph', 'autopilot', 'ultrawork', 'ultraqa'];
+    for (const mode of completedModes) {
+        if (checkModeJustCompleted(directory, mode)) {
+            updateSessionState(sessionId, { workflowJustCompleted: mode });
+            break;
+        }
+    }
+    // Check for architect verification
+    if (checkArchitectJustVerified(directory)) {
+        updateSessionState(sessionId, { architectJustVerified: true });
+    }
+    // Discover preserved artifacts
+    const artifacts = discoverPreservedArtifacts(directory);
+    // Evaluate triggers in priority order
+    // Priority: workflow_complete > architect_verified > planning_complete > context_artifacts > degradation_signals
+    let trigger = null;
+    // 1. Workflow complete (highest priority - clear win)
+    trigger = detectWorkflowComplete(state);
+    if (trigger) {
+        const message = generateMessage(trigger, artifacts, state, contextUsageRatio);
+        recordSuggestion(sessionId);
+        return { shouldSuggest: true, trigger, message, preservedArtifacts: artifacts };
+    }
+    // 2. Architect verified
+    trigger = detectArchitectVerified(state);
+    if (trigger) {
+        const message = generateMessage(trigger, artifacts, state, contextUsageRatio);
+        recordSuggestion(sessionId);
+        return { shouldSuggest: true, trigger, message, preservedArtifacts: artifacts };
+    }
+    // 3. Planning complete
+    trigger = detectPlanningComplete(state);
+    if (trigger) {
+        const message = generateMessage(trigger, artifacts, state, contextUsageRatio);
+        recordSuggestion(sessionId);
+        return { shouldSuggest: true, trigger, message, preservedArtifacts: artifacts };
+    }
+    // 4. Context >50% with artifacts
+    trigger = detectContextWithArtifacts(contextUsageRatio, artifacts, config);
+    if (trigger) {
+        const message = generateMessage(trigger, artifacts, state, contextUsageRatio);
+        recordSuggestion(sessionId);
+        return { shouldSuggest: true, trigger, message, preservedArtifacts: artifacts };
+    }
+    // 5. Degradation signals (lowest priority - only if nothing else triggered)
+    trigger = detectDegradationSignals(state, config);
+    if (trigger) {
+        const message = generateMessage(trigger, artifacts, state, contextUsageRatio);
+        recordSuggestion(sessionId);
+        return { shouldSuggest: true, trigger, message, preservedArtifacts: artifacts };
+    }
+    return { shouldSuggest: false, skipReason: 'no_triggers_fired' };
+}
+/**
+ * Mark planning as just completed (called by plan/ralplan skills)
+ */
+export function markPlanningComplete(sessionId) {
+    updateSessionState(sessionId, { planningJustCompleted: true });
+}
+/**
+ * Reset session state (called on /clear)
+ */
+export function resetClearSuggestionState(sessionId) {
+    sessionStates.delete(sessionId);
+}
+/**
+ * Get current session stats (for debugging)
+ */
+export function getClearSuggestionStats(sessionId) {
+    return sessionStates.get(sessionId) ?? null;
+}
+/**
+ * Clean up stale sessions (older than 30 minutes)
+ */
+export function cleanupStaleSessions() {
+    const now = Date.now();
+    const maxAge = 30 * 60 * 1000; // 30 minutes
+    for (const [sessionId, state] of sessionStates) {
+        if (state.lastSuggestionTime > 0 && now - state.lastSuggestionTime > maxAge) {
+            sessionStates.delete(sessionId);
+        }
+    }
+}
+/**
+ * Create a clear suggestion hook instance
+ */
+export function createClearSuggestionHook(config) {
+    return {
+        /**
+         * PostToolUse - Check if we should suggest /clear
+         */
+        postToolUse: (input) => {
+            const result = checkClearSuggestion({
+                sessionId: input.session_id,
+                directory: input.directory,
+                toolName: input.tool_name,
+                toolOutput: input.tool_response,
+                contextUsageRatio: input.context_usage_ratio,
+            }, config);
+            if (result.shouldSuggest && result.message) {
+                return result.message;
+            }
+            return null;
+        },
+        /**
+         * Stop event - Reset failure tracking
+         */
+        stop: (input) => {
+            resetFailures(input.session_id);
+        },
+    };
+}
+// Re-export constants
+export { CLEAR_SUGGESTION_COOLDOWN_MS, MAX_CLEAR_SUGGESTIONS, CONTEXT_THRESHOLD, FAILURE_THRESHOLD, } from './constants.js';
+// Re-export trigger functions for testing
+export { detectWorkflowComplete, detectArchitectVerified, detectPlanningComplete, detectContextWithArtifacts, detectDegradationSignals, isToolFailure, discoverPreservedArtifacts, checkModeJustCompleted, checkArchitectJustVerified, } from './triggers.js';
+//# sourceMappingURL=index.js.map

package/dist/hooks/clear-suggestions/index.js.map

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

package/dist/hooks/clear-suggestions/triggers.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Clear Suggestions Trigger Detection
+ *
+ * Implements the 5 semantic triggers that determine when to suggest /clear:
+ * 1. Workflow complete - ralph/autopilot/ultrawork finished
+ * 2. Architect verified - architect approval passed
+ * 3. Planning complete - ralplan/plan skill completed
+ * 4. Context >50% + artifacts - high context but plan files exist
+ * 5. Degradation signals - 3+ consecutive failures
+ */
+import type { ClearSuggestionTrigger, ClearSuggestionState, ClearSuggestionConfig, PreservedArtifact } from './types.js';
+/**
+ * Detect if a workflow (ralph/autopilot/ultrawork) just completed.
+ *
+ * Checks state files for modes that transitioned from active to inactive
+ * within the current hook call.
+ */
+export declare function detectWorkflowComplete(state: ClearSuggestionState): ClearSuggestionTrigger | null;
+/**
+ * Detect if architect verification just passed.
+ *
+ * Reads ralph verification state to see if architect approved.
+ */
+export declare function detectArchitectVerified(state: ClearSuggestionState): ClearSuggestionTrigger | null;
+/**
+ * Detect if planning just completed.
+ *
+ * Checks if a plan skill or ralplan skill just finished.
+ */
+export declare function detectPlanningComplete(state: ClearSuggestionState): ClearSuggestionTrigger | null;
+/**
+ * Detect if context is above threshold and artifacts exist to reload.
+ *
+ * This trigger fires when context is high but the user has saved artifacts
+ * (plans, PRDs, notes) that would automatically reload after /clear.
+ */
+export declare function detectContextWithArtifacts(contextUsageRatio: number | undefined, artifacts: PreservedArtifact[], config?: ClearSuggestionConfig): ClearSuggestionTrigger | null;
+/**
+ * Detect degradation signals from consecutive failures.
+ *
+ * Tracks recent tool failures and triggers when the threshold is exceeded.
+ */
+export declare function detectDegradationSignals(state: ClearSuggestionState, config?: ClearSuggestionConfig): ClearSuggestionTrigger | null;
+/**
+ * Check if a tool output indicates a failure
+ */
+export declare function isToolFailure(toolName: string, toolOutput: string): boolean;
+/**
+ * Discover preserved artifacts in the project directory.
+ *
+ * Scans for plans, PRDs, specs, progress files, notepads, and wisdom files
+ * that would survive a /clear and be available in the new session.
+ */
+export declare function discoverPreservedArtifacts(directory: string): PreservedArtifact[];
+/**
+ * Check if a mode just completed by comparing current state with previous state.
+ *
+ * Reads mode state files to detect transitions from active to inactive.
+ */
+export declare function checkModeJustCompleted(directory: string, modeName: string): boolean;
+/**
+ * Check if architect verification just passed
+ */
+export declare function checkArchitectJustVerified(directory: string): boolean;
+//# sourceMappingURL=triggers.d.ts.map

package/dist/hooks/clear-suggestions/triggers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"triggers.d.ts","sourceRoot":"","sources":["../../../src/hooks/clear-suggestions/triggers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAGzH;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,oBAAoB,GAC1B,sBAAsB,GAAG,IAAI,CAK/B;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,oBAAoB,GAC1B,sBAAsB,GAAG,IAAI,CAK/B;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,oBAAoB,GAC1B,sBAAsB,GAAG,IAAI,CAK/B;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACxC,iBAAiB,EAAE,MAAM,GAAG,SAAS,EACrC,SAAS,EAAE,iBAAiB,EAAE,EAC9B,MAAM,CAAC,EAAE,qBAAqB,GAC7B,sBAAsB,GAAG,IAAI,CAa/B;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,oBAAoB,EAC3B,MAAM,CAAC,EAAE,qBAAqB,GAC7B,sBAAsB,GAAG,IAAI,CAc/B;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAyC3E;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAwCjF;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACf,OAAO,CAsCT;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAmBrE"}