/**
 * Shared utilities for hook handlers.
 *
 * @module core/hooks/handlers/utils
 */
import type { HookContext, HookInput } from './types.js';
/**
 * Walk up from `startDir` to find the nearest directory containing `.specweave/config.json`.
 * Returns the project root path, or null if not found.
 */
export declare function findProjectRoot(startDir?: string): string | null;
/**
 * Build a HookContext from a project root path.
 */
export declare function createContext(projectRoot: string): HookContext;
/**
 * Parse a raw stdin string as JSON. Returns empty object on failure.
 */
export declare function parseStdinJson(raw: string): HookInput;
/**
 * Append a log entry to `.specweave/logs/hooks.log` (plaintext, backwards compat)
 * and to `.specweave/logs/hooks/{handler}.log` (structured JSONL via HookLogger).
 * Never throws — logging failures are silently ignored.
 */
export declare function logHook(context: HookContext, handler: string, message: string): void;
//# sourceMappingURL=utils.d.ts.map