@s_s/agent-kit 1.0.0

package/build/hook-types.d.ts

@@ -0,0 +1,155 @@
+import type { AgentType } from './types.js';
+/**
+ * Content injection intent.
+ * Injects text into agent context at various lifecycle points.
+ */
+export interface InjectIntent {
+    type: 'inject';
+    /** Reminder injected on every user message turn. */
+    perTurn: string;
+    /** Reminder injected at session start. */
+    sessionStart?: string;
+    /** Reminder injected before context compaction. */
+    compaction?: string;
+    /** Reminder injected at session end. */
+    sessionEnd?: string;
+}
+/**
+ * Tool call interception result.
+ */
+export interface ToolCallInterceptResult {
+    /** Block the tool call entirely. */
+    block?: boolean;
+    /** Reason for blocking (shown to agent). */
+    reason?: string;
+    /** Modified arguments to pass to the tool (if not blocking). */
+    args?: Record<string, unknown>;
+}
+/**
+ * Tool call context passed to handler.
+ */
+export interface ToolCallContext {
+    toolName: string;
+    args: Record<string, unknown>;
+}
+/**
+ * Pre-tool-call interception intent.
+ * Intercept tool calls before execution — can block or modify arguments.
+ */
+export interface BeforeToolCallIntent {
+    type: 'beforeToolCall';
+    /** Regex pattern to match tool names. Omit or '*' to match all. */
+    match?: RegExp | string;
+    /** Handler that decides whether to block or modify the tool call. */
+    handler: (ctx: ToolCallContext) => ToolCallInterceptResult | void;
+}
+/**
+ * Tool call observation context.
+ */
+export interface ToolCallObserveContext {
+    toolName: string;
+    args: Record<string, unknown>;
+    result: string;
+    error?: string;
+}
+/**
+ * Post-tool-call observation intent.
+ * Observe tool call results — cannot modify, only react.
+ */
+export interface AfterToolCallIntent {
+    type: 'afterToolCall';
+    /** Regex pattern to match tool names. Omit or '*' to match all. */
+    match?: RegExp | string;
+    /** Handler that reacts to tool call completion. */
+    handler: (ctx: ToolCallObserveContext) => void;
+}
+/**
+ * Session lifecycle context.
+ */
+export interface SessionContext {
+    sessionId?: string;
+}
+/**
+ * Session lifecycle intent.
+ * React to session start and/or end.
+ */
+export interface OnSessionIntent {
+    type: 'onSession';
+    /** Handler called when session starts. */
+    start?: (ctx: SessionContext) => void;
+    /** Handler called when session ends. */
+    end?: (ctx: SessionContext) => void;
+}
+/**
+ * Permission decision.
+ */
+export type PermissionDecision = 'allow' | 'deny' | 'ask';
+/**
+ * Permission request context.
+ */
+export interface PermissionContext {
+    toolName: string;
+    args: Record<string, unknown>;
+}
+/**
+ * Permission decision intent.
+ * Intercept permission requests and decide allow/deny/ask.
+ */
+export interface OnPermissionIntent {
+    type: 'onPermission';
+    /** Regex pattern to match tool names. Omit or '*' to match all. */
+    match?: RegExp | string;
+    /** Handler that decides the permission outcome. */
+    handler: (ctx: PermissionContext) => PermissionDecision;
+}
+/**
+ * Union of all intent types.
+ */
+export type HookIntent = InjectIntent | BeforeToolCallIntent | AfterToolCallIntent | OnSessionIntent | OnPermissionIntent;
+/**
+ * Discriminant values for intent types.
+ */
+export type IntentType = HookIntent['type'];
+/** Claude Code / Codex native hook event names. */
+export type ClaudeCodeHookName = 'SessionStart' | 'InstructionsLoaded' | 'UserPromptSubmit' | 'PreToolUse' | 'PermissionRequest' | 'PostToolUse' | 'PostToolUseFailure' | 'Notification' | 'SubagentStart' | 'SubagentStop' | 'Stop' | 'TeammateIdle' | 'TaskCompleted' | 'ConfigChange' | 'WorktreeCreate' | 'WorktreeRemove' | 'PreCompact' | 'PostCompact' | 'Elicitation' | 'ElicitationResult' | 'SessionEnd';
+/** OpenCode native hook names. */
+export type OpenCodeHookName = 'event' | 'config' | 'tool' | 'auth' | 'chat.message' | 'chat.params' | 'chat.headers' | 'permission.ask' | 'command.execute.before' | 'tool.execute.before' | 'shell.env' | 'tool.execute.after' | 'experimental.chat.messages.transform' | 'experimental.chat.system.transform' | 'experimental.session.compacting' | 'experimental.text.complete' | 'tool.definition';
+/** OpenClaw plugin hook names (24). */
+export type OpenClawPluginHookName = 'before_model_resolve' | 'before_prompt_build' | 'before_agent_start' | 'llm_input' | 'llm_output' | 'agent_end' | 'before_compaction' | 'after_compaction' | 'before_reset' | 'message_received' | 'message_sending' | 'message_sent' | 'before_tool_call' | 'after_tool_call' | 'tool_result_persist' | 'before_message_write' | 'session_start' | 'session_end' | 'subagent_spawning' | 'subagent_delivery_target' | 'subagent_spawned' | 'subagent_ended' | 'gateway_start' | 'gateway_stop';
+/** OpenClaw internal hook names (type:action). */
+export type OpenClawInternalHookName = 'command:new' | 'command:reset' | 'command:stop' | 'session:compact:before' | 'session:compact:after' | 'agent:bootstrap' | 'gateway:startup' | 'message:received' | 'message:sent' | 'message:transcribed' | 'message:preprocessed';
+/** All OpenClaw hook names (plugin + internal). */
+export type OpenClawHookName = OpenClawPluginHookName | OpenClawInternalHookName;
+/** Map from agent type to its native hook name union. */
+export type NativeHookNameMap = {
+    'claude-code': ClaudeCodeHookName;
+    codex: ClaudeCodeHookName;
+    opencode: OpenCodeHookName;
+    openclaw: OpenClawHookName;
+};
+/**
+ * Raw hook registration.
+ * Provides the handler code (as string) for a specific agent's native hook.
+ * When a raw hook targets the same native hook as an intent, raw wins.
+ */
+export interface RawHookRegistration<A extends AgentType = AgentType> {
+    agent: A;
+    hookName: A extends keyof NativeHookNameMap ? NativeHookNameMap[A] : string;
+    /** Handler code as string — will be written directly into the generated file. */
+    handler: string;
+    /** Optional matcher (regex string). Only used by agents that support it. */
+    matcher?: string;
+}
+/**
+ * Extend hook registration.
+ * Runs after the intent-generated handler for the same native hook.
+ * Cannot replace, only augment.
+ */
+export interface ExtendHookRegistration<A extends AgentType = AgentType> {
+    agent: A;
+    hookName: A extends keyof NativeHookNameMap ? NativeHookNameMap[A] : string;
+    /** Extension code as string — appended to the intent-generated handler. */
+    handler: string;
+    /** Optional matcher (regex string). Only used by agents that support it. */
+    matcher?: string;
+}

package/build/hook-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=hook-types.js.map

package/build/hook-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-types.js","sourceRoot":"","sources":["../src/hook-types.ts"],"names":[],"mappings":""}

package/build/hooks.d.ts

@@ -0,0 +1,30 @@
+import type { AgentType, HookInstallResult } from './types.js';
+/**
+ * Install hooks for the given agent type.
+ *
+ * Reads all registered intents, raw hooks, and extend hooks from the hook
+ * registry. Translates them into native hook files using the agent-specific
+ * translator. Runs degradation checks and conflict detection.
+ *
+ * @internal — called by the Kit object returned from createKit().
+ */
+export declare function installHooks(name: string, agent: AgentType): Promise<HookInstallResult>;
+/**
+ * Uninstall hooks for the given agent type.
+ *
+ * Removes hook files from the hook directory and cleans up settings.json
+ * entries for agents that use them (Claude Code, Codex).
+ *
+ * @internal — called by the Kit object returned from createKit().
+ */
+export declare function uninstallHooks(name: string, agent: AgentType): Promise<{
+    success: boolean;
+    removed: string[];
+    error?: string;
+}>;
+/**
+ * Check if hooks are already installed for the given agent type.
+ *
+ * @internal — called by the Kit object returned from createKit().
+ */
+export declare function hasHooksInstalled(name: string, agent: AgentType): Promise<boolean>;

package/build/hooks.js

@@ -0,0 +1,333 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import os from 'node:os';
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+import { AGENT_REGISTRY } from './types.js';
+import { getIntents, getRawHooks, getExtendHooks } from './hook-registry.js';
+import { checkAllDegradation } from './hook-capabilities.js';
+import { ClaudeCodeTranslator } from './hook-translators/claude-code.js';
+import { OpenCodeTranslator } from './hook-translators/opencode.js';
+import { OpenClawTranslator } from './hook-translators/openclaw.js';
+const execFileAsync = promisify(execFile);
+// ---------------------------------------------------------------------------
+// Translator factory
+// ---------------------------------------------------------------------------
+function getTranslator(agent) {
+    switch (agent) {
+        case 'claude-code':
+            return new ClaudeCodeTranslator('claude-code');
+        case 'codex':
+            return new ClaudeCodeTranslator('codex');
+        case 'opencode':
+            return new OpenCodeTranslator();
+        case 'openclaw':
+            return new OpenClawTranslator();
+    }
+}
+// ---------------------------------------------------------------------------
+// installHooks — main entry point
+// ---------------------------------------------------------------------------
+/**
+ * Install hooks for the given agent type.
+ *
+ * Reads all registered intents, raw hooks, and extend hooks from the hook
+ * registry. Translates them into native hook files using the agent-specific
+ * translator. Runs degradation checks and conflict detection.
+ *
+ * @internal — called by the Kit object returned from createKit().
+ */
+export async function installHooks(name, agent) {
+    const home = os.homedir();
+    const entry = AGENT_REGISTRY[agent];
+    const hookDir = entry.getHookDir(home, name);
+    const result = {
+        success: false,
+        hookDir,
+        filesWritten: [],
+        settingsUpdated: false,
+        notes: [],
+        warnings: [],
+        skipped: [],
+    };
+    const intents = getIntents();
+    const rawHooks = getRawHooks();
+    const extendHooks = getExtendHooks();
+    // Check if there's anything to install
+    if (intents.length === 0 && rawHooks.size === 0 && extendHooks.size === 0) {
+        result.error =
+            'No hooks registered. Use hooks.inject(), hooks.beforeToolCall(), etc. to declare hook behavior.';
+        return result;
+    }
+    try {
+        // Step 1: Run degradation checks
+        const intentTypes = [...new Set(intents.map((i) => i.type))];
+        const degradations = checkAllDegradation(agent, intentTypes);
+        for (const d of degradations) {
+            if (d.level === 'unsupported') {
+                result.warnings.push(d.message);
+            }
+            else if (d.level === 'partial') {
+                result.warnings.push(d.message);
+            }
+        }
+        // Step 2: Filter raw/extend hooks for this agent
+        const agentRawHooks = new Map();
+        for (const [key, reg] of rawHooks) {
+            if (key.startsWith(`${agent}::`)) {
+                agentRawHooks.set(key, reg);
+            }
+        }
+        const agentExtendHooks = new Map();
+        for (const [key, regs] of extendHooks) {
+            if (key.startsWith(`${agent}::`)) {
+                agentExtendHooks.set(key, regs);
+            }
+        }
+        // Step 3: Translate intents → native files
+        const translator = getTranslator(agent);
+        const translation = translator.translate(intents, agentRawHooks, agentExtendHooks, name);
+        // Merge translation warnings and skipped
+        result.warnings.push(...translation.warnings);
+        result.skipped.push(...translation.skipped);
+        // Step 4: Write hook files
+        if (Object.keys(translation.files).length === 0) {
+            result.notes.push('No hook files generated for this agent.');
+            result.success = true;
+            return result;
+        }
+        await fs.mkdir(hookDir, { recursive: true });
+        for (const [fileName, content] of Object.entries(translation.files)) {
+            const filePath = path.join(hookDir, fileName);
+            await fs.writeFile(filePath, content, 'utf-8');
+            if (fileName.endsWith('.sh')) {
+                await fs.chmod(filePath, 0o755);
+            }
+            result.filesWritten.push(filePath);
+        }
+        // Step 5: Merge settings.json for agents that need it (Claude Code / Codex)
+        if (entry.getSettingsPath) {
+            const settingsPath = entry.getSettingsPath(home);
+            const shellFiles = Object.keys(translation.files).filter((f) => f.endsWith('.sh'));
+            if (shellFiles.length > 0) {
+                await mergeHookSettings(settingsPath, hookDir, shellFiles, name);
+                result.settingsUpdated = true;
+            }
+        }
+        // Step 6: Agent-specific post-install
+        if (agent === 'openclaw') {
+            try {
+                await execFileAsync('openclaw', ['hooks', 'enable', name]);
+                result.notes.push(`Hook activated via \`openclaw hooks enable ${name}\`.`);
+            }
+            catch {
+                result.notes.push(`Run \`openclaw hooks enable ${name}\` to activate the hook.`);
+            }
+        }
+        result.success = true;
+    }
+    catch (err) {
+        result.error = err instanceof Error ? err.message : String(err);
+    }
+    return result;
+}
+// ---------------------------------------------------------------------------
+// uninstallHooks
+// ---------------------------------------------------------------------------
+/**
+ * Uninstall hooks for the given agent type.
+ *
+ * Removes hook files from the hook directory and cleans up settings.json
+ * entries for agents that use them (Claude Code, Codex).
+ *
+ * @internal — called by the Kit object returned from createKit().
+ */
+export async function uninstallHooks(name, agent) {
+    const home = os.homedir();
+    const entry = AGENT_REGISTRY[agent];
+    const hookDir = entry.getHookDir(home, name);
+    const removed = [];
+    try {
+        // Remove hook directory
+        try {
+            const files = await fs.readdir(hookDir);
+            for (const file of files) {
+                const filePath = path.join(hookDir, file);
+                await fs.unlink(filePath);
+                removed.push(filePath);
+            }
+            await fs.rmdir(hookDir);
+        }
+        catch {
+            // Directory may not exist — that's fine
+        }
+        // Clean settings.json for Claude Code / Codex
+        if (entry.getSettingsPath) {
+            const settingsPath = entry.getSettingsPath(home);
+            await cleanHookSettings(settingsPath, name);
+        }
+        // Deactivate for OpenClaw
+        if (agent === 'openclaw') {
+            try {
+                await execFileAsync('openclaw', ['hooks', 'disable', name]);
+            }
+            catch {
+                // Best effort
+            }
+        }
+        return { success: true, removed };
+    }
+    catch (err) {
+        return { success: false, removed, error: err instanceof Error ? err.message : String(err) };
+    }
+}
+// ---------------------------------------------------------------------------
+// hasHooksInstalled
+// ---------------------------------------------------------------------------
+/**
+ * Check if hooks are already installed for the given agent type.
+ *
+ * @internal — called by the Kit object returned from createKit().
+ */
+export async function hasHooksInstalled(name, agent) {
+    const home = os.homedir();
+    const entry = AGENT_REGISTRY[agent];
+    const hookDir = entry.getHookDir(home, name);
+    try {
+        const files = await fs.readdir(hookDir);
+        return files.length > 0;
+    }
+    catch {
+        return false;
+    }
+}
+// ---------------------------------------------------------------------------
+// Settings merge (Claude Code / Codex)
+// ---------------------------------------------------------------------------
+/**
+ * Merge hook entries into settings.json for Claude Code / Codex.
+ * Maps each shell script to its corresponding native hook event based on filename conventions.
+ */
+async function mergeHookSettings(settingsPath, hookDir, shellFiles, toolName) {
+    let settings = {};
+    try {
+        const raw = await fs.readFile(settingsPath, 'utf-8');
+        settings = JSON.parse(raw);
+    }
+    catch {
+        // Start fresh
+    }
+    if (!settings.hooks || typeof settings.hooks !== 'object') {
+        settings.hooks = {};
+    }
+    const hooks = settings.hooks;
+    // Map filename patterns to native hook events
+    const fileToEvent = {
+        inject: 'UserPromptSubmit',
+        'session-start': 'SessionStart',
+        'session-end': 'SessionEnd',
+        compaction: 'PreCompact',
+        'before-tool': 'PreToolUse',
+        'after-tool': 'PostToolUse',
+        'on-session-start': 'SessionStart',
+        'on-session-end': 'SessionEnd',
+        permission: 'PermissionRequest',
+    };
+    for (const fileName of shellFiles) {
+        const activatorPath = path.join(hookDir, fileName);
+        // Determine the event from filename
+        let event;
+        // Check raw hooks first (pattern: toolName-raw-hookname.sh)
+        const rawMatch = fileName.match(/^.+-raw-(.+)\.sh$/);
+        if (rawMatch) {
+            // Raw hooks use the hook name directly (case-insensitive lookup)
+            event = rawMatch[1].charAt(0).toUpperCase() + rawMatch[1].slice(1);
+        }
+        else {
+            // Intent-generated hooks use filename conventions
+            for (const [pattern, hookEvent] of Object.entries(fileToEvent)) {
+                if (fileName.includes(pattern)) {
+                    event = hookEvent;
+                    break;
+                }
+            }
+        }
+        if (!event)
+            continue;
+        const hookEntry = {
+            matcher: '',
+            hooks: [{ type: 'command', command: activatorPath }],
+        };
+        if (!Array.isArray(hooks[event])) {
+            hooks[event] = [];
+        }
+        // Remove existing entries for this tool
+        hooks[event] = hooks[event].filter((entry) => {
+            if (!entry || typeof entry !== 'object')
+                return true;
+            const e = entry;
+            if (!Array.isArray(e.hooks))
+                return true;
+            return !e.hooks.some((h) => {
+                if (!h || typeof h !== 'object')
+                    return false;
+                const hook = h;
+                return typeof hook.command === 'string' && hook.command.includes(toolName);
+            });
+        });
+        hooks[event].push(hookEntry);
+    }
+    await fs.mkdir(path.dirname(settingsPath), { recursive: true });
+    await fs.writeFile(settingsPath, JSON.stringify(settings, null, 2) + '\n', 'utf-8');
+}
+/**
+ * Remove all hook entries for a tool from settings.json.
+ */
+async function cleanHookSettings(settingsPath, toolName) {
+    let settings;
+    try {
+        const raw = await fs.readFile(settingsPath, 'utf-8');
+        settings = JSON.parse(raw);
+    }
+    catch {
+        return; // No settings file to clean
+    }
+    if (!settings.hooks || typeof settings.hooks !== 'object')
+        return;
+    const hooks = settings.hooks;
+    let changed = false;
+    for (const [event, entries] of Object.entries(hooks)) {
+        if (!Array.isArray(entries))
+            continue;
+        const filtered = entries.filter((entry) => {
+            if (!entry || typeof entry !== 'object')
+                return true;
+            const e = entry;
+            if (!Array.isArray(e.hooks))
+                return true;
+            const hasToolHook = e.hooks.some((h) => {
+                if (!h || typeof h !== 'object')
+                    return false;
+                const hook = h;
+                return typeof hook.command === 'string' && hook.command.includes(toolName);
+            });
+            return !hasToolHook;
+        });
+        if (filtered.length !== entries.length) {
+            hooks[event] = filtered;
+            changed = true;
+        }
+        // Remove empty event arrays
+        if (filtered.length === 0) {
+            delete hooks[event];
+        }
+    }
+    // Remove empty hooks object
+    if (Object.keys(hooks).length === 0) {
+        delete settings.hooks;
+    }
+    if (changed) {
+        await fs.writeFile(settingsPath, JSON.stringify(settings, null, 2) + '\n', 'utf-8');
+    }
+}
+//# sourceMappingURL=hooks.js.map

package/build/hooks.js.map

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

package/build/index.d.ts

@@ -0,0 +1,9 @@
+export { createKit } from './create-kit.js';
+export type { AgentType, StorageScope, ScopeOptions, KitOptions, Kit, HookInstallResult, SkippedIntent, } from './types.js';
+export { AGENT_TYPES, CLIENT_NAME_MAP } from './types.js';
+export type { InjectIntent, BeforeToolCallIntent, AfterToolCallIntent, OnSessionIntent, OnPermissionIntent, HookIntent, IntentType, ToolCallContext, ToolCallInterceptResult, ToolCallObserveContext, SessionContext, PermissionDecision, PermissionContext, RawHookRegistration, ExtendHookRegistration, } from './hook-types.js';
+export type { SupportLevel, CapabilityEntry, DegradationWarning } from './hook-capabilities.js';
+export { CAPABILITY_MATRIX, checkDegradation, checkAllDegradation, isIntentFullyUnsupported, } from './hook-capabilities.js';
+export { detectProjectRoot } from './platform.js';
+export { detectAgent, detectAgentFromClient } from './detect.js';
+export { hooks } from './hook-registry.js';

package/build/index.js

@@ -0,0 +1,11 @@
+// Core factory
+export { createKit } from './create-kit.js';
+export { AGENT_TYPES, CLIENT_NAME_MAP } from './types.js';
+export { CAPABILITY_MATRIX, checkDegradation, checkAllDegradation, isIntentFullyUnsupported, } from './hook-capabilities.js';
+// Platform (only detectProjectRoot is standalone; getDataDir is on Kit)
+export { detectProjectRoot } from './platform.js';
+// Detection
+export { detectAgent, detectAgentFromClient } from './detect.js';
+// Hooks — declaration API (global, not bound to kit instance)
+export { hooks } from './hook-registry.js';
+//# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,eAAe;AACf,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAY5C,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAuB1D,OAAO,EACH,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,EACnB,wBAAwB,GAC3B,MAAM,wBAAwB,CAAC;AAEhC,wEAAwE;AACxE,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAElD,YAAY;AACZ,OAAO,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEjE,8DAA8D;AAC9D,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC"}

package/build/platform.d.ts

@@ -0,0 +1,17 @@
+import type { ResolvedKitConfig, ScopeOptions } from './types.js';
+/**
+ * Get platform-appropriate data directory path.
+ *
+ * - global: follows platform conventions (macOS ~/Library/Application Support, Linux XDG, Windows APPDATA)
+ * - project: `<projectRoot>/.<name>` (or custom dir name)
+ *
+ * @internal — called by the Kit object returned from createKit().
+ */
+export declare function getDataDir(config: ResolvedKitConfig, options?: ScopeOptions): string;
+/**
+ * Detect project root directory.
+ *
+ * Resolution order: git root > project marker files (.git, package.json, etc.) > cwd fallback.
+ * This is an independent function — does not require createKit().
+ */
+export declare function detectProjectRoot(cwd?: string): Promise<string>;

package/build/platform.js

@@ -0,0 +1,79 @@
+import path from 'node:path';
+import os from 'node:os';
+import fs from 'node:fs/promises';
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+const execFileAsync = promisify(execFile);
+const PROJECT_ROOT_MARKERS = ['.git', 'package.json', 'pyproject.toml', 'Cargo.toml', 'go.mod'];
+/**
+ * Get platform-appropriate data directory path.
+ *
+ * - global: follows platform conventions (macOS ~/Library/Application Support, Linux XDG, Windows APPDATA)
+ * - project: `<projectRoot>/.<name>` (or custom dir name)
+ *
+ * @internal — called by the Kit object returned from createKit().
+ */
+export function getDataDir(config, options) {
+    const scope = options?.scope ?? 'global';
+    if (scope === 'project') {
+        if (!options?.projectRoot) {
+            throw new Error('getDataDir: projectRoot is required when scope is "project".');
+        }
+        const dirName = config.dirs?.project ?? `.${config.name}`;
+        return path.join(options.projectRoot, dirName);
+    }
+    // Global scope
+    const envVar = config.envOverride ?? `${config.name.toUpperCase().replace(/-/g, '_')}_DATA_DIR`;
+    const envDir = process.env[envVar];
+    if (envDir)
+        return envDir;
+    const dirName = config.dirs?.global ?? config.name;
+    const home = os.homedir();
+    const platform = process.platform;
+    switch (platform) {
+        case 'darwin':
+            return path.join(home, 'Library', 'Application Support', dirName);
+        case 'win32':
+            return path.join(process.env.APPDATA || path.join(home, 'AppData', 'Roaming'), dirName);
+        default:
+            return path.join(process.env.XDG_DATA_HOME || path.join(home, '.local', 'share'), dirName);
+    }
+}
+/**
+ * Detect project root directory.
+ *
+ * Resolution order: git root > project marker files (.git, package.json, etc.) > cwd fallback.
+ * This is an independent function — does not require createKit().
+ */
+export async function detectProjectRoot(cwd) {
+    const startDir = cwd ?? process.cwd();
+    // Try git root first
+    try {
+        const { stdout } = await execFileAsync('git', ['rev-parse', '--show-toplevel'], { cwd: startDir });
+        const gitRoot = stdout.trim();
+        if (gitRoot)
+            return gitRoot;
+    }
+    catch {
+        // Not a git repo or git not available
+    }
+    // Walk up looking for project markers
+    let current = path.resolve(startDir);
+    while (true) {
+        for (const marker of PROJECT_ROOT_MARKERS) {
+            try {
+                await fs.access(path.join(current, marker));
+                return current;
+            }
+            catch {
+                continue;
+            }
+        }
+        const parent = path.dirname(current);
+        if (parent === current)
+            break;
+        current = parent;
+    }
+    return path.resolve(startDir);
+}
+//# sourceMappingURL=platform.js.map