oh-my-opencode 0.3.4 → 0.4.1

package/dist/config/schema.d.ts

@@ -22,33 +22,33 @@ export declare const AgentOverrideConfigSchema: z.ZodObject<{
     color: z.ZodOptional<z.ZodString>;
     permission: z.ZodOptional<z.ZodObject<{
         edit: z.ZodOptional<z.ZodEnum<{
-            ask: "ask";
             allow: "allow";
             deny: "deny";
+            ask: "ask";
         }>>;
         bash: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
-            ask: "ask";
             allow: "allow";
             deny: "deny";
-        }>, z.ZodRecord<z.ZodString, z.ZodEnum<{
             ask: "ask";
+        }>, z.ZodRecord<z.ZodString, z.ZodEnum<{
             allow: "allow";
             deny: "deny";
+            ask: "ask";
         }>>]>>;
         webfetch: z.ZodOptional<z.ZodEnum<{
-            ask: "ask";
             allow: "allow";
             deny: "deny";
+            ask: "ask";
         }>>;
         doom_loop: z.ZodOptional<z.ZodEnum<{
-            ask: "ask";
             allow: "allow";
             deny: "deny";
+            ask: "ask";
         }>>;
         external_directory: z.ZodOptional<z.ZodEnum<{
-            ask: "ask";
             allow: "allow";
             deny: "deny";
+            ask: "ask";
         }>>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
@@ -69,33 +69,33 @@ export declare const AgentOverridesSchema: z.ZodObject<{
         color: z.ZodOptional<z.ZodString>;
         permission: z.ZodOptional<z.ZodObject<{
             edit: z.ZodOptional<z.ZodEnum<{
-                ask: "ask";
                 allow: "allow";
                 deny: "deny";
+                ask: "ask";
             }>>;
             bash: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
-                ask: "ask";
                 allow: "allow";
                 deny: "deny";
-            }>, z.ZodRecord<z.ZodString, z.ZodEnum<{
                 ask: "ask";
+            }>, z.ZodRecord<z.ZodString, z.ZodEnum<{
                 allow: "allow";
                 deny: "deny";
+                ask: "ask";
             }>>]>>;
             webfetch: z.ZodOptional<z.ZodEnum<{
-                ask: "ask";
                 allow: "allow";
                 deny: "deny";
+                ask: "ask";
             }>>;
             doom_loop: z.ZodOptional<z.ZodEnum<{
-                ask: "ask";
                 allow: "allow";
                 deny: "deny";
+                ask: "ask";
             }>>;
             external_directory: z.ZodOptional<z.ZodEnum<{
-                ask: "ask";
                 allow: "allow";
                 deny: "deny";
+                ask: "ask";
             }>>;
         }, z.core.$strip>>;
     }, z.core.$strip>>>;
@@ -115,33 +115,33 @@ export declare const AgentOverridesSchema: z.ZodObject<{
         color: z.ZodOptional<z.ZodString>;
         permission: z.ZodOptional<z.ZodObject<{
             edit: z.ZodOptional<z.ZodEnum<{
-                ask: "ask";
                 allow: "allow";
                 deny: "deny";
+                ask: "ask";
             }>>;
             bash: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
-                ask: "ask";
                 allow: "allow";
                 deny: "deny";
-            }>, z.ZodRecord<z.ZodString, z.ZodEnum<{
                 ask: "ask";
+            }>, z.ZodRecord<z.ZodString, z.ZodEnum<{
                 allow: "allow";
                 deny: "deny";
+                ask: "ask";
             }>>]>>;
             webfetch: z.ZodOptional<z.ZodEnum<{
-                ask: "ask";
                 allow: "allow";
                 deny: "deny";
+                ask: "ask";
             }>>;
             doom_loop: z.ZodOptional<z.ZodEnum<{
-                ask: "ask";
                 allow: "allow";
                 deny: "deny";
+                ask: "ask";
             }>>;
             external_directory: z.ZodOptional<z.ZodEnum<{
-                ask: "ask";
                 allow: "allow";
                 deny: "deny";
+                ask: "ask";
             }>>;
         }, z.core.$strip>>;
     }, z.core.$strip>>>;
@@ -161,33 +161,33 @@ export declare const AgentOverridesSchema: z.ZodObject<{
         color: z.ZodOptional<z.ZodString>;
         permission: z.ZodOptional<z.ZodObject<{
             edit: z.ZodOptional<z.ZodEnum<{
-                ask: "ask";
                 allow: "allow";
                 deny: "deny";
+                ask: "ask";
             }>>;
             bash: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
-                ask: "ask";
                 allow: "allow";
                 deny: "deny";
-            }>, z.ZodRecord<z.ZodString, z.ZodEnum<{
                 ask: "ask";
+            }>, z.ZodRecord<z.ZodString, z.ZodEnum<{
                 allow: "allow";
                 deny: "deny";
+                ask: "ask";
             }>>]>>;
             webfetch: z.ZodOptional<z.ZodEnum<{
-                ask: "ask";
                 allow: "allow";
                 deny: "deny";
+                ask: "ask";
             }>>;
             doom_loop: z.ZodOptional<z.ZodEnum<{
-                ask: "ask";
                 allow: "allow";
                 deny: "deny";
+                ask: "ask";
             }>>;
             external_directory: z.ZodOptional<z.ZodEnum<{
-                ask: "ask";
                 allow: "allow";
                 deny: "deny";
+                ask: "ask";
             }>>;
         }, z.core.$strip>>;
     }, z.core.$strip>>>;
@@ -207,33 +207,33 @@ export declare const AgentOverridesSchema: z.ZodObject<{
         color: z.ZodOptional<z.ZodString>;
         permission: z.ZodOptional<z.ZodObject<{
             edit: z.ZodOptional<z.ZodEnum<{
-                ask: "ask";
                 allow: "allow";
                 deny: "deny";
+                ask: "ask";
             }>>;
             bash: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
-                ask: "ask";
                 allow: "allow";
                 deny: "deny";
-            }>, z.ZodRecord<z.ZodString, z.ZodEnum<{
                 ask: "ask";
+            }>, z.ZodRecord<z.ZodString, z.ZodEnum<{
                 allow: "allow";
                 deny: "deny";
+                ask: "ask";
             }>>]>>;
             webfetch: z.ZodOptional<z.ZodEnum<{
-                ask: "ask";
                 allow: "allow";
                 deny: "deny";
+                ask: "ask";
             }>>;
             doom_loop: z.ZodOptional<z.ZodEnum<{
-                ask: "ask";
                 allow: "allow";
                 deny: "deny";
+                ask: "ask";
             }>>;
             external_directory: z.ZodOptional<z.ZodEnum<{
-                ask: "ask";
                 allow: "allow";
                 deny: "deny";
+                ask: "ask";
             }>>;
         }, z.core.$strip>>;
     }, z.core.$strip>>>;
@@ -253,33 +253,33 @@ export declare const AgentOverridesSchema: z.ZodObject<{
         color: z.ZodOptional<z.ZodString>;
         permission: z.ZodOptional<z.ZodObject<{
             edit: z.ZodOptional<z.ZodEnum<{
-                ask: "ask";
                 allow: "allow";
                 deny: "deny";
+                ask: "ask";
             }>>;
             bash: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
-                ask: "ask";
                 allow: "allow";
                 deny: "deny";
-            }>, z.ZodRecord<z.ZodString, z.ZodEnum<{
                 ask: "ask";
+            }>, z.ZodRecord<z.ZodString, z.ZodEnum<{
                 allow: "allow";
                 deny: "deny";
+                ask: "ask";
             }>>]>>;
             webfetch: z.ZodOptional<z.ZodEnum<{
-                ask: "ask";
                 allow: "allow";
                 deny: "deny";
+                ask: "ask";
             }>>;
             doom_loop: z.ZodOptional<z.ZodEnum<{
-                ask: "ask";
                 allow: "allow";
                 deny: "deny";
+                ask: "ask";
             }>>;
             external_directory: z.ZodOptional<z.ZodEnum<{
-                ask: "ask";
                 allow: "allow";
                 deny: "deny";
+                ask: "ask";
             }>>;
         }, z.core.$strip>>;
     }, z.core.$strip>>>;
@@ -321,33 +321,33 @@ export declare const OhMyOpenCodeConfigSchema: z.ZodObject<{
             color: z.ZodOptional<z.ZodString>;
             permission: z.ZodOptional<z.ZodObject<{
                 edit: z.ZodOptional<z.ZodEnum<{
-                    ask: "ask";
                     allow: "allow";
                     deny: "deny";
+                    ask: "ask";
                 }>>;
                 bash: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
-                    ask: "ask";
                     allow: "allow";
                     deny: "deny";
-                }>, z.ZodRecord<z.ZodString, z.ZodEnum<{
                     ask: "ask";
+                }>, z.ZodRecord<z.ZodString, z.ZodEnum<{
                     allow: "allow";
                     deny: "deny";
+                    ask: "ask";
                 }>>]>>;
                 webfetch: z.ZodOptional<z.ZodEnum<{
-                    ask: "ask";
                     allow: "allow";
                     deny: "deny";
+                    ask: "ask";
                 }>>;
                 doom_loop: z.ZodOptional<z.ZodEnum<{
-                    ask: "ask";
                     allow: "allow";
                     deny: "deny";
+                    ask: "ask";
                 }>>;
                 external_directory: z.ZodOptional<z.ZodEnum<{
-                    ask: "ask";
                     allow: "allow";
                     deny: "deny";
+                    ask: "ask";
                 }>>;
             }, z.core.$strip>>;
         }, z.core.$strip>>>;
@@ -367,33 +367,33 @@ export declare const OhMyOpenCodeConfigSchema: z.ZodObject<{
             color: z.ZodOptional<z.ZodString>;
             permission: z.ZodOptional<z.ZodObject<{
                 edit: z.ZodOptional<z.ZodEnum<{
-                    ask: "ask";
                     allow: "allow";
                     deny: "deny";
+                    ask: "ask";
                 }>>;
                 bash: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
-                    ask: "ask";
                     allow: "allow";
                     deny: "deny";
-                }>, z.ZodRecord<z.ZodString, z.ZodEnum<{
                     ask: "ask";
+                }>, z.ZodRecord<z.ZodString, z.ZodEnum<{
                     allow: "allow";
                     deny: "deny";
+                    ask: "ask";
                 }>>]>>;
                 webfetch: z.ZodOptional<z.ZodEnum<{
-                    ask: "ask";
                     allow: "allow";
                     deny: "deny";
+                    ask: "ask";
                 }>>;
                 doom_loop: z.ZodOptional<z.ZodEnum<{
-                    ask: "ask";
                     allow: "allow";
                     deny: "deny";
+                    ask: "ask";
                 }>>;
                 external_directory: z.ZodOptional<z.ZodEnum<{
-                    ask: "ask";
                     allow: "allow";
                     deny: "deny";
+                    ask: "ask";
                 }>>;
             }, z.core.$strip>>;
         }, z.core.$strip>>>;
@@ -413,33 +413,33 @@ export declare const OhMyOpenCodeConfigSchema: z.ZodObject<{
             color: z.ZodOptional<z.ZodString>;
             permission: z.ZodOptional<z.ZodObject<{
                 edit: z.ZodOptional<z.ZodEnum<{
-                    ask: "ask";
                     allow: "allow";
                     deny: "deny";
+                    ask: "ask";
                 }>>;
                 bash: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
-                    ask: "ask";
                     allow: "allow";
                     deny: "deny";
-                }>, z.ZodRecord<z.ZodString, z.ZodEnum<{
                     ask: "ask";
+                }>, z.ZodRecord<z.ZodString, z.ZodEnum<{
                     allow: "allow";
                     deny: "deny";
+                    ask: "ask";
                 }>>]>>;
                 webfetch: z.ZodOptional<z.ZodEnum<{
-                    ask: "ask";
                     allow: "allow";
                     deny: "deny";
+                    ask: "ask";
                 }>>;
                 doom_loop: z.ZodOptional<z.ZodEnum<{
-                    ask: "ask";
                     allow: "allow";
                     deny: "deny";
+                    ask: "ask";
                 }>>;
                 external_directory: z.ZodOptional<z.ZodEnum<{
-                    ask: "ask";
                     allow: "allow";
                     deny: "deny";
+                    ask: "ask";
                 }>>;
             }, z.core.$strip>>;
         }, z.core.$strip>>>;
@@ -459,33 +459,33 @@ export declare const OhMyOpenCodeConfigSchema: z.ZodObject<{
             color: z.ZodOptional<z.ZodString>;
             permission: z.ZodOptional<z.ZodObject<{
                 edit: z.ZodOptional<z.ZodEnum<{
-                    ask: "ask";
                     allow: "allow";
                     deny: "deny";
+                    ask: "ask";
                 }>>;
                 bash: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
-                    ask: "ask";
                     allow: "allow";
                     deny: "deny";
-                }>, z.ZodRecord<z.ZodString, z.ZodEnum<{
                     ask: "ask";
+                }>, z.ZodRecord<z.ZodString, z.ZodEnum<{
                     allow: "allow";
                     deny: "deny";
+                    ask: "ask";
                 }>>]>>;
                 webfetch: z.ZodOptional<z.ZodEnum<{
-                    ask: "ask";
                     allow: "allow";
                     deny: "deny";
+                    ask: "ask";
                 }>>;
                 doom_loop: z.ZodOptional<z.ZodEnum<{
-                    ask: "ask";
                     allow: "allow";
                     deny: "deny";
+                    ask: "ask";
                 }>>;
                 external_directory: z.ZodOptional<z.ZodEnum<{
-                    ask: "ask";
                     allow: "allow";
                     deny: "deny";
+                    ask: "ask";
                 }>>;
             }, z.core.$strip>>;
         }, z.core.$strip>>>;
@@ -505,33 +505,33 @@ export declare const OhMyOpenCodeConfigSchema: z.ZodObject<{
             color: z.ZodOptional<z.ZodString>;
             permission: z.ZodOptional<z.ZodObject<{
                 edit: z.ZodOptional<z.ZodEnum<{
-                    ask: "ask";
                     allow: "allow";
                     deny: "deny";
+                    ask: "ask";
                 }>>;
                 bash: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
-                    ask: "ask";
                     allow: "allow";
                     deny: "deny";
-                }>, z.ZodRecord<z.ZodString, z.ZodEnum<{
                     ask: "ask";
+                }>, z.ZodRecord<z.ZodString, z.ZodEnum<{
                     allow: "allow";
                     deny: "deny";
+                    ask: "ask";
                 }>>]>>;
                 webfetch: z.ZodOptional<z.ZodEnum<{
-                    ask: "ask";
                     allow: "allow";
                     deny: "deny";
+                    ask: "ask";
                 }>>;
                 doom_loop: z.ZodOptional<z.ZodEnum<{
-                    ask: "ask";
                     allow: "allow";
                     deny: "deny";
+                    ask: "ask";
                 }>>;
                 external_directory: z.ZodOptional<z.ZodEnum<{
-                    ask: "ask";
                     allow: "allow";
                     deny: "deny";
+                    ask: "ask";
                 }>>;
             }, z.core.$strip>>;
         }, z.core.$strip>>>;

package/dist/features/background-agent/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./types";
+export { BackgroundManager } from "./manager";

package/dist/features/background-agent/manager.d.ts

@@ -0,0 +1,37 @@
+import type { PluginInput } from "@opencode-ai/plugin";
+import type { BackgroundTask, LaunchInput } from "./types";
+interface EventProperties {
+    sessionID?: string;
+    info?: {
+        id?: string;
+    };
+    [key: string]: unknown;
+}
+interface Event {
+    type: string;
+    properties?: EventProperties;
+}
+export declare class BackgroundManager {
+    private tasks;
+    private notifications;
+    private client;
+    private directory;
+    private pollingInterval?;
+    constructor(ctx: PluginInput);
+    launch(input: LaunchInput): Promise<BackgroundTask>;
+    getTask(id: string): BackgroundTask | undefined;
+    getTasksByParentSession(sessionID: string): BackgroundTask[];
+    findBySession(sessionID: string): BackgroundTask | undefined;
+    handleEvent(event: Event): void;
+    markForNotification(task: BackgroundTask): void;
+    getPendingNotifications(sessionID: string): BackgroundTask[];
+    clearNotifications(sessionID: string): void;
+    private clearNotificationsForTask;
+    private startPolling;
+    private stopPolling;
+    private notifyParentSession;
+    private formatDuration;
+    private hasRunningTasks;
+    private pollRunningTasks;
+}
+export {};

package/dist/features/background-agent/types.d.ts

@@ -0,0 +1,27 @@
+export type BackgroundTaskStatus = "running" | "completed" | "error" | "cancelled";
+export interface TaskProgress {
+    toolCalls: number;
+    lastTool?: string;
+    lastUpdate: Date;
+}
+export interface BackgroundTask {
+    id: string;
+    sessionID: string;
+    parentSessionID: string;
+    parentMessageID: string;
+    description: string;
+    agent: string;
+    status: BackgroundTaskStatus;
+    startedAt: Date;
+    completedAt?: Date;
+    result?: string;
+    error?: string;
+    progress?: TaskProgress;
+}
+export interface LaunchInput {
+    description: string;
+    prompt: string;
+    agent: string;
+    parentSessionID: string;
+    parentMessageID: string;
+}

package/dist/google-auth.d.ts

@@ -0,0 +1,3 @@
+import type { Plugin } from "@opencode-ai/plugin";
+declare const GoogleAntigravityAuthPlugin: Plugin;
+export default GoogleAntigravityAuthPlugin;

package/dist/hooks/anthropic-auto-compact/types.d.ts

@@ -6,7 +6,18 @@ export interface ParsedTokenLimitError {
     providerID?: string;
     modelID?: string;
 }
+export interface RetryState {
+    attempt: number;
+    lastAttemptTime: number;
+}
 export interface AutoCompactState {
     pendingCompact: Set<string>;
     errorDataBySession: Map<string, ParsedTokenLimitError>;
+    retryStateBySession: Map<string, RetryState>;
 }
+export declare const RETRY_CONFIG: {
+    readonly maxAttempts: 5;
+    readonly initialDelayMs: 2000;
+    readonly backoffFactor: 2;
+    readonly maxDelayMs: 30000;
+};

package/dist/hooks/auto-update-checker/cache.d.ts

@@ -0,0 +1 @@
+export declare function invalidateCache(): boolean;

package/dist/hooks/auto-update-checker/checker.d.ts

@@ -0,0 +1,6 @@
+import type { UpdateCheckResult } from "./types";
+export declare function isLocalDevMode(directory: string): boolean;
+export declare function findPluginEntry(directory: string): string | null;
+export declare function getCachedVersion(): string | null;
+export declare function getLatestVersion(): Promise<string | null>;
+export declare function checkForUpdate(directory: string): Promise<UpdateCheckResult>;

package/dist/hooks/auto-update-checker/constants.d.ts

@@ -0,0 +1,8 @@
+export declare const PACKAGE_NAME = "oh-my-opencode";
+export declare const NPM_REGISTRY_URL = "https://registry.npmjs.org/-/package/oh-my-opencode/dist-tags";
+export declare const NPM_FETCH_TIMEOUT = 5000;
+export declare const CACHE_DIR: string;
+export declare const VERSION_FILE: string;
+export declare const INSTALLED_PACKAGE_JSON: string;
+export declare const USER_CONFIG_DIR: string;
+export declare const USER_OPENCODE_CONFIG: string;

package/dist/hooks/auto-update-checker/index.d.ts

@@ -0,0 +1,12 @@
+import type { PluginInput } from "@opencode-ai/plugin";
+export declare function createAutoUpdateCheckerHook(ctx: PluginInput): {
+    event: ({ event }: {
+        event: {
+            type: string;
+            properties?: unknown;
+        };
+    }) => Promise<void>;
+};
+export type { UpdateCheckResult } from "./types";
+export { checkForUpdate } from "./checker";
+export { invalidateCache } from "./cache";

package/dist/hooks/auto-update-checker/types.d.ts

@@ -0,0 +1,19 @@
+export interface NpmDistTags {
+    latest: string;
+    [key: string]: string;
+}
+export interface OpencodeConfig {
+    plugin?: string[];
+    [key: string]: unknown;
+}
+export interface PackageJson {
+    version: string;
+    name?: string;
+    [key: string]: unknown;
+}
+export interface UpdateCheckResult {
+    needsUpdate: boolean;
+    currentVersion: string | null;
+    latestVersion: string | null;
+    isLocalDev: boolean;
+}

package/dist/hooks/background-notification/index.d.ts

@@ -0,0 +1,12 @@
+import type { BackgroundManager } from "../../features/background-agent";
+interface Event {
+    type: string;
+    properties?: Record<string, unknown>;
+}
+interface EventInput {
+    event: Event;
+}
+export declare function createBackgroundNotificationHook(manager: BackgroundManager): {
+    event: ({ event }: EventInput) => Promise<void>;
+};
+export type { BackgroundNotificationHookConfig } from "./types";

package/dist/hooks/background-notification/types.d.ts

@@ -0,0 +1,4 @@
+import type { BackgroundTask } from "../../features/background-agent";
+export interface BackgroundNotificationHookConfig {
+    formatNotification?: (tasks: BackgroundTask[]) => string;
+}

package/dist/hooks/index.d.ts

@@ -1,7 +1,7 @@
-export { createTodoContinuationEnforcer } from "./todo-continuation-enforcer";
+export { createTodoContinuationEnforcer, type TodoContinuationEnforcer } from "./todo-continuation-enforcer";
 export { createContextWindowMonitorHook } from "./context-window-monitor";
 export { createSessionNotification } from "./session-notification";
-export { createSessionRecoveryHook } from "./session-recovery";
+export { createSessionRecoveryHook, type SessionRecoveryHook } from "./session-recovery";
 export { createCommentCheckerHooks } from "./comment-checker";
 export { createGrepOutputTruncatorHook } from "./grep-output-truncator";
 export { createDirectoryAgentsInjectorHook } from "./directory-agents-injector";
@@ -10,3 +10,6 @@ export { createEmptyTaskResponseDetectorHook } from "./empty-task-response-detec
 export { createAnthropicAutoCompactHook } from "./anthropic-auto-compact";
 export { createThinkModeHook } from "./think-mode";
 export { createClaudeCodeHooksHook } from "./claude-code-hooks";
+export { createRulesInjectorHook } from "./rules-injector";
+export { createBackgroundNotificationHook } from "./background-notification";
+export { createAutoUpdateCheckerHook } from "./auto-update-checker";

package/dist/hooks/rules-injector/constants.d.ts

@@ -0,0 +1,6 @@
+export declare const OPENCODE_STORAGE: string;
+export declare const RULES_INJECTOR_STORAGE: string;
+export declare const PROJECT_MARKERS: string[];
+export declare const PROJECT_RULE_SUBDIRS: [string, string][];
+export declare const USER_RULE_DIR = ".claude/rules";
+export declare const RULE_EXTENSIONS: string[];

package/dist/hooks/rules-injector/finder.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Candidate rule file with metadata for filtering and sorting
+ */
+export interface RuleFileCandidate {
+    /** Absolute path to the rule file */
+    path: string;
+    /** Real path after symlink resolution (for duplicate detection) */
+    realPath: string;
+    /** Whether this is a global/user-level rule */
+    isGlobal: boolean;
+    /** Directory distance from current file (9999 for global rules) */
+    distance: number;
+}
+/**
+ * Find project root by walking up from startPath.
+ * Checks for PROJECT_MARKERS (.git, pyproject.toml, package.json, etc.)
+ *
+ * @param startPath - Starting path to search from (file or directory)
+ * @returns Project root path or null if not found
+ */
+export declare function findProjectRoot(startPath: string): string | null;
+/**
+ * Calculate directory distance between a rule file and current file.
+ * Distance is based on common ancestor within project root.
+ *
+ * @param rulePath - Path to the rule file
+ * @param currentFile - Path to the current file being edited
+ * @param projectRoot - Project root for relative path calculation
+ * @returns Distance (0 = same directory, higher = further)
+ */
+export declare function calculateDistance(rulePath: string, currentFile: string, projectRoot: string | null): number;
+/**
+ * Find all rule files for a given context.
+ * Searches from currentFile upward to projectRoot for rule directories,
+ * then user-level directory (~/.claude/rules).
+ *
+ * IMPORTANT: This searches EVERY directory from file to project root.
+ * Not just the project root itself.
+ *
+ * @param projectRoot - Project root path (or null if outside any project)
+ * @param homeDir - User home directory
+ * @param currentFile - Current file being edited (for distance calculation)
+ * @returns Array of rule file candidates sorted by distance
+ */
+export declare function findRuleFiles(projectRoot: string | null, homeDir: string, currentFile: string): RuleFileCandidate[];