@compass-ai/nova 1.0.73 → 1.0.74

package/dist/types/consent.js

@@ -0,0 +1,119 @@
+/**
+ * Type definitions for consent management (GDPR compliance)
+ *
+ * This module defines all TypeScript interfaces and types related to consent management
+ * for the Compass CLI application. It ensures GDPR compliance by providing:
+ * - Granular consent options for different data processing activities
+ * - Consent versioning for policy update tracking
+ * - Consent history for audit purposes
+ * - Status tracking for validity and expiration
+ */
+/**
+ * Current version of the consent policy.
+ * Increment this when the consent terms change to trigger re-consent.
+ */
+export const CONSENT_VERSION = '1.0.0';
+/**
+ * Configuration for all consent prompts shown during setup.
+ * Maps consent property names to their display configuration.
+ */
+export const CONSENT_PROMPTS = {
+    dataCollection: {
+        title: 'Data Collection',
+        description: 'Allow Compass to store conversation history and session data locally for improved functionality.',
+        required: true,
+        defaultValue: true,
+    },
+    telemetry: {
+        title: 'Anonymous Telemetry',
+        description: 'Help improve Compass by sending anonymous usage statistics.',
+        required: false,
+        defaultValue: false,
+    },
+    analytics: {
+        title: 'Analytics',
+        description: 'Allow collection of feature usage patterns to improve the product.',
+        required: false,
+        defaultValue: false,
+    },
+    errorReporting: {
+        title: 'Error Reporting',
+        description: 'Automatically send error reports to help fix bugs.',
+        required: false,
+        defaultValue: true,
+    },
+};
+/**
+ * Type guard to check if an object is a valid Consent object.
+ *
+ * @param obj - Object to check
+ * @returns True if the object is a valid Consent
+ */
+export function isValidConsent(obj) {
+    if (typeof obj !== 'object' || obj === null) {
+        return false;
+    }
+    const consent = obj;
+    return (typeof consent.dataCollection === 'boolean' &&
+        typeof consent.telemetry === 'boolean' &&
+        typeof consent.analytics === 'boolean' &&
+        typeof consent.errorReporting === 'boolean');
+}
+/**
+ * Type guard to check if an object is a valid ConsentRecord.
+ *
+ * @param obj - Object to check
+ * @returns True if the object is a valid ConsentRecord
+ */
+export function isValidConsentRecord(obj) {
+    if (typeof obj !== 'object' || obj === null) {
+        return false;
+    }
+    const record = obj;
+    return (typeof record.id === 'string' &&
+        typeof record.version === 'string' &&
+        typeof record.grantedAt === 'string' &&
+        typeof record.expiresAt === 'string' &&
+        isValidConsent(record.consent));
+}
+/**
+ * Creates a default consent object with all options disabled except required ones.
+ *
+ * @returns Default Consent object
+ */
+export function createDefaultConsent() {
+    return {
+        dataCollection: CONSENT_PROMPTS.dataCollection.defaultValue,
+        telemetry: CONSENT_PROMPTS.telemetry.defaultValue,
+        analytics: CONSENT_PROMPTS.analytics.defaultValue,
+        errorReporting: CONSENT_PROMPTS.errorReporting.defaultValue,
+    };
+}
+/**
+ * Creates a consent object with all options enabled.
+ * Useful for testing or when user opts into everything.
+ *
+ * @returns Consent object with all options enabled
+ */
+export function createFullConsent() {
+    return {
+        dataCollection: true,
+        telemetry: true,
+        analytics: true,
+        errorReporting: true,
+    };
+}
+/**
+ * Creates a minimal consent object with only required options enabled.
+ *
+ * @returns Consent object with only required options
+ */
+export function createMinimalConsent() {
+    return {
+        dataCollection: true, // Required
+        telemetry: false,
+        analytics: false,
+        errorReporting: false,
+    };
+}
+//# sourceMappingURL=consent.js.map

package/dist/types/consent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consent.js","sourceRoot":"","sources":["../../src/types/consent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAmKH;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,OAAO,CAAC;AAEvC;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAyC;IACnE,cAAc,EAAE;QACd,KAAK,EAAE,iBAAiB;QACxB,WAAW,EACT,kGAAkG;QACpG,QAAQ,EAAE,IAAI;QACd,YAAY,EAAE,IAAI;KACnB;IACD,SAAS,EAAE;QACT,KAAK,EAAE,qBAAqB;QAC5B,WAAW,EAAE,6DAA6D;QAC1E,QAAQ,EAAE,KAAK;QACf,YAAY,EAAE,KAAK;KACpB;IACD,SAAS,EAAE;QACT,KAAK,EAAE,WAAW;QAClB,WAAW,EACT,oEAAoE;QACtE,QAAQ,EAAE,KAAK;QACf,YAAY,EAAE,KAAK;KACpB;IACD,cAAc,EAAE;QACd,KAAK,EAAE,iBAAiB;QACxB,WAAW,EAAE,oDAAoD;QACjE,QAAQ,EAAE,KAAK;QACf,YAAY,EAAE,IAAI;KACnB;CACF,CAAC;AAEF;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,GAAY;IACzC,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QAC5C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,OAAO,GAAG,GAA8B,CAAC;IAE/C,OAAO,CACL,OAAO,OAAO,CAAC,cAAc,KAAK,SAAS;QAC3C,OAAO,OAAO,CAAC,SAAS,KAAK,SAAS;QACtC,OAAO,OAAO,CAAC,SAAS,KAAK,SAAS;QACtC,OAAO,OAAO,CAAC,cAAc,KAAK,SAAS,CAC5C,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,GAAY;IAC/C,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QAC5C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,MAAM,GAAG,GAA8B,CAAC;IAE9C,OAAO,CACL,OAAO,MAAM,CAAC,EAAE,KAAK,QAAQ;QAC7B,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ;QAClC,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ;QACpC,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ;QACpC,cAAc,CAAC,MAAM,CAAC,OAAO,CAAC,CAC/B,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB;IAClC,OAAO;QACL,cAAc,EAAE,eAAe,CAAC,cAAc,CAAC,YAAY;QAC3D,SAAS,EAAE,eAAe,CAAC,SAAS,CAAC,YAAY;QACjD,SAAS,EAAE,eAAe,CAAC,SAAS,CAAC,YAAY;QACjD,cAAc,EAAE,eAAe,CAAC,cAAc,CAAC,YAAY;KAC5D,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO;QACL,cAAc,EAAE,IAAI;QACpB,SAAS,EAAE,IAAI;QACf,SAAS,EAAE,IAAI;QACf,cAAc,EAAE,IAAI;KACrB,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB;IAClC,OAAO;QACL,cAAc,EAAE,IAAI,EAAE,WAAW;QACjC,SAAS,EAAE,KAAK;QAChB,SAAS,EAAE,KAAK;QAChB,cAAc,EAAE,KAAK;KACtB,CAAC;AACJ,CAAC"}

package/dist/types/custom-command.d.ts

@@ -0,0 +1,139 @@
+/**
+ * Type definitions for custom slash commands.
+ * Custom commands allow users to define frequently used prompts as Markdown files
+ * that can be executed with arguments, file references, and bash command execution.
+ */
+/**
+ * Frontmatter metadata for custom command files.
+ * Parsed from YAML frontmatter at the top of .md files.
+ */
+export interface CustomCommandFrontmatter {
+    /**
+     * List of tools the command can use.
+     * Uses Bash(command:*) syntax for shell commands.
+     * @example ['Bash(git add:*)', 'Bash(git status:*)', 'Bash(git commit:*)']
+     */
+    'allowed-tools'?: string[];
+    /**
+     * Hint for the arguments expected by the slash command.
+     * Shown to the user when auto-completing the slash command.
+     * @example 'add [tagId] | remove [tagId] | list'
+     */
+    'argument-hint'?: string;
+    /**
+     * Brief description of the command.
+     * If not provided, uses the first line from the prompt.
+     */
+    description?: string;
+    /**
+     * Specific model string to use for this command.
+     * Inherits from the conversation if not specified.
+     * @example 'claude-3-5-haiku-20241022'
+     */
+    model?: string;
+    /**
+     * Whether to prevent the SlashCommand tool from calling this command.
+     * Defaults to false.
+     */
+    'disable-model-invocation'?: boolean;
+}
+/**
+ * Scope of a custom command.
+ * - 'project': Command is in .compass/commands/ and shared with the team
+ * - 'user': Command is in ~/.compass/commands/ and personal
+ */
+export type CustomCommandScope = 'project' | 'user';
+/**
+ * Definition for a custom slash command parsed from a .md file.
+ */
+export interface CustomCommandDefinition {
+    /**
+     * Command name derived from the filename (without .md extension).
+     * @example 'optimize' for .compass/commands/optimize.md
+     */
+    name: string;
+    /**
+     * Full absolute path to the .md file.
+     */
+    filePath: string;
+    /**
+     * Scope of the command (project or user).
+     */
+    scope: CustomCommandScope;
+    /**
+     * Subdirectory path for namespacing.
+     * @example 'frontend' for .compass/commands/frontend/component.md
+     */
+    namespace?: string;
+    /**
+     * Parsed frontmatter metadata from the .md file.
+     */
+    frontmatter: CustomCommandFrontmatter;
+    /**
+     * Raw markdown content after frontmatter has been stripped.
+     */
+    content: string;
+    /**
+     * Command description for display in help.
+     * From frontmatter.description or extracted from first line of content.
+     */
+    description: string;
+}
+/**
+ * Result of processing a custom command's content.
+ * Contains the fully processed prompt ready to send to the LLM.
+ */
+export interface ProcessedCustomCommand {
+    /**
+     * The processed content with all substitutions applied:
+     * - $ARGUMENTS, $1, $2, etc. replaced with actual arguments
+     * - @file references replaced with file contents
+     * - !`command` replaced with bash output
+     */
+    processedContent: string;
+    /**
+     * Tool restrictions from frontmatter, if any.
+     */
+    allowedTools?: string[];
+    /**
+     * Model override from frontmatter, if any.
+     */
+    modelOverride?: string;
+    /**
+     * Whether model invocation is disabled for this command.
+     */
+    disableModelInvocation?: boolean;
+}
+/**
+ * Result of slash command execution.
+ * Extends the simple boolean return to support custom command flow.
+ */
+export interface SlashCommandResult {
+    /**
+     * Whether the command was found and executed.
+     */
+    handled: boolean;
+    /**
+     * If set, continue as natural language with this processed content.
+     * This allows custom commands to inject prompts into the LLM flow.
+     */
+    continueAsPrompt?: string;
+    /**
+     * Tool restrictions to apply when processing this prompt.
+     */
+    toolRestrictions?: string[];
+    /**
+     * Model to use for this prompt, overriding the current model.
+     */
+    modelOverride?: string;
+    /**
+     * Error message if execution failed.
+     */
+    error?: string;
+    /**
+     * If true, call onExit() after the LLM finishes responding to continueAsPrompt.
+     * Used by /exit to consolidate memory before exiting.
+     */
+    exitAfterCompletion?: boolean;
+}
+//# sourceMappingURL=custom-command.d.ts.map

package/dist/types/custom-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-command.d.ts","sourceRoot":"","sources":["../../src/types/custom-command.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;GAGG;AACH,MAAM,WAAW,wBAAwB;IACvC;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAE3B;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,0BAA0B,CAAC,EAAE,OAAO,CAAC;CACtC;AAED;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,MAAM,CAAC;AAEpD;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,KAAK,EAAE,kBAAkB,CAAC;IAE1B;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,WAAW,EAAE,wBAAwB,CAAC;IAEtC;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;;;OAKG;IACH,gBAAgB,EAAE,MAAM,CAAC;IAEzB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IAExB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAClC;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAE5B;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B"}

package/dist/types/custom-command.js

@@ -0,0 +1,7 @@
+/**
+ * Type definitions for custom slash commands.
+ * Custom commands allow users to define frequently used prompts as Markdown files
+ * that can be executed with arguments, file references, and bash command execution.
+ */
+export {};
+//# sourceMappingURL=custom-command.js.map

package/dist/types/custom-command.js.map

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

package/dist/types/git.d.ts

@@ -0,0 +1,20 @@
+export type CommitMessageFormat = 'single-line' | 'multi-line';
+export interface CommitMessageOptions {
+    format?: CommitMessageFormat;
+    maxLength?: number;
+    includeBullets?: boolean;
+}
+export interface CommitMessageStructure {
+    type: string;
+    scope?: string;
+    subject: string;
+    body?: string;
+    bullets?: string[];
+    breaking?: boolean;
+    footer?: string;
+}
+export interface ParsedCommitMessage extends CommitMessageStructure {
+    raw: string;
+    isValid: boolean;
+}
+//# sourceMappingURL=git.d.ts.map

package/dist/types/git.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../src/types/git.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,mBAAmB,GAAG,aAAa,GAAG,YAAY,CAAC;AAE/D,MAAM,WAAW,oBAAoB;IACnC,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAoB,SAAQ,sBAAsB;IACjE,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,OAAO,CAAC;CAClB"}

package/dist/types/git.js

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

package/dist/types/git.js.map

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

package/dist/types/hook.d.ts

@@ -0,0 +1,342 @@
+/**
+ * Type definitions for hooks.
+ * Hooks are shell commands that execute in response to events like tool calls.
+ * Defined in .compass/hooks/ (project) or ~/.compass/hooks/ (personal).
+ *
+ * Claude Code style hooks support:
+ * - PreToolUse: Execute before a tool runs, can block execution
+ * - PostToolUse: Execute after a tool runs, can modify behavior
+ * - UserPromptSubmit: Execute when user submits a prompt
+ * - Notification: Execute for notifications/status updates
+ * - Stop: Execute when the session is stopping
+ */
+/**
+ * Events that can trigger hook execution.
+ */
+export type HookEvent = 'PreToolUse' | 'PostToolUse' | 'UserPromptSubmit' | 'Notification' | 'Stop';
+/**
+ * All supported hook events.
+ */
+export declare const HOOK_EVENTS: HookEvent[];
+/**
+ * Source of a hook definition.
+ * - 'personal': Hook is in ~/.compass/hooks/ (user-specific)
+ * - 'project': Hook is in .compass/hooks/ (shared with team)
+ *
+ * Project hooks take precedence over personal hooks with the same name.
+ */
+export type HookSource = 'personal' | 'project';
+/**
+ * Priority order for hook sources (higher index = higher priority).
+ */
+export declare const HOOK_SOURCE_PRIORITY: HookSource[];
+/**
+ * Matcher for filtering which tool calls trigger a hook.
+ * Used with PreToolUse and PostToolUse events.
+ */
+export interface HookToolMatcher {
+    /**
+     * Tool name patterns to match.
+     * Supports glob patterns like "Bash", "Bash(*)", "edit_file", etc.
+     * If empty or not specified, matches all tools.
+     */
+    toolNames?: string[];
+    /**
+     * Only match if tool input contains these key-value patterns.
+     * @example { "command": "git*" } - matches if command starts with "git"
+     */
+    inputMatchers?: Record<string, string>;
+}
+/**
+ * YAML/JSON frontmatter for hook configuration files.
+ * Hooks can be defined as:
+ * - .compass/hooks/<event>.yaml - Single hook for an event
+ * - .compass/hooks/<event>/<name>.yaml - Multiple hooks for an event
+ *
+ * @example
+ * ```yaml
+ * # .compass/hooks/PreToolUse/block-rm-rf.yaml
+ * ---
+ * description: Block dangerous rm commands
+ * enabled: true
+ * tools:
+ *   - Bash
+ * match:
+ *   command: "rm -rf*"
+ * ---
+ * #!/bin/bash
+ * if [[ "$TOOL_INPUT_COMMAND" == *"rm -rf /"* ]]; then
+ *   echo "BLOCKED: Dangerous rm -rf command"
+ *   exit 1
+ * fi
+ * exit 0
+ * ```
+ */
+export interface HookFrontmatter {
+    /**
+     * Human-readable description of what this hook does.
+     */
+    description?: string;
+    /**
+     * Whether this hook is enabled.
+     * @default true
+     */
+    enabled?: boolean;
+    /**
+     * Tool names this hook applies to (for tool events).
+     * Supports patterns: "Bash", "Bash(*)", "edit_file", "*"
+     */
+    tools?: string[];
+    /**
+     * Input pattern matching for tool events.
+     * Keys are input field names, values are glob patterns.
+     */
+    match?: Record<string, string>;
+    /**
+     * Timeout in milliseconds for hook execution.
+     * @default 30000 (30 seconds)
+     */
+    timeout?: number;
+}
+/**
+ * Complete parsed hook definition ready for use.
+ */
+export interface HookDefinition {
+    /**
+     * Unique identifier for this hook instance.
+     * Format: `${source}-${event}-${name}`
+     */
+    id: string;
+    /**
+     * Hook name derived from filename.
+     */
+    name: string;
+    /**
+     * Event that triggers this hook.
+     */
+    event: HookEvent;
+    /**
+     * Full path to the hook file.
+     */
+    filePath: string;
+    /**
+     * Source of the hook (personal or project).
+     */
+    source: HookSource;
+    /**
+     * Parsed frontmatter configuration.
+     */
+    frontmatter: HookFrontmatter;
+    /**
+     * Shell script content to execute.
+     */
+    script: string;
+    /**
+     * Description for logging/debugging.
+     */
+    description: string;
+    /**
+     * Whether the hook is active (after priority resolution).
+     */
+    isActive: boolean;
+}
+/**
+ * Environment variables passed to hooks.
+ * All values are strings for shell compatibility.
+ */
+export interface HookEnvironment {
+    /**
+     * The event that triggered this hook.
+     */
+    HOOK_EVENT: string;
+    /**
+     * Name of the hook being executed.
+     */
+    HOOK_NAME: string;
+    /**
+     * Current working directory.
+     */
+    HOOK_CWD: string;
+    /**
+     * Session ID if available.
+     */
+    HOOK_SESSION_ID?: string;
+    /**
+     * Name of the tool being called.
+     */
+    TOOL_NAME?: string;
+    /**
+     * Tool call ID.
+     */
+    TOOL_CALL_ID?: string;
+    /**
+     * JSON-encoded tool input.
+     */
+    TOOL_INPUT?: string;
+    /**
+     * Individual tool input fields as TOOL_INPUT_<FIELD_NAME>.
+     * For example, TOOL_INPUT_COMMAND for Bash command.
+     */
+    [key: `TOOL_INPUT_${string}`]: string | undefined;
+    /**
+     * JSON-encoded tool output (PostToolUse only).
+     */
+    TOOL_OUTPUT?: string;
+    /**
+     * Whether the tool succeeded (PostToolUse only).
+     */
+    TOOL_SUCCESS?: string;
+    /**
+     * Tool error message if failed (PostToolUse only).
+     */
+    TOOL_ERROR?: string;
+    /**
+     * The user's prompt text.
+     */
+    USER_PROMPT?: string;
+}
+/**
+ * Context passed to hook execution.
+ */
+export interface HookExecutionContext {
+    /**
+     * Event type that triggered this hook.
+     */
+    event: HookEvent;
+    /**
+     * Current project root directory.
+     */
+    projectRoot: string;
+    /**
+     * Session ID if available.
+     */
+    sessionId?: string;
+    /**
+     * Tool information (for tool events).
+     */
+    tool?: {
+        name: string;
+        callId: string;
+        input: Record<string, unknown>;
+        output?: unknown;
+        success?: boolean;
+        error?: string;
+    };
+    /**
+     * User prompt (for UserPromptSubmit event).
+     */
+    userPrompt?: string;
+    /**
+     * Notification message (for Notification event).
+     */
+    notification?: string;
+}
+/**
+ * Result from executing a single hook.
+ */
+export interface HookExecutionResult {
+    /**
+     * ID of the hook that was executed.
+     */
+    hookId: string;
+    /**
+     * Whether the hook executed successfully (exit code 0).
+     */
+    success: boolean;
+    /**
+     * Exit code from the hook script.
+     */
+    exitCode: number;
+    /**
+     * Standard output from the hook.
+     */
+    stdout: string;
+    /**
+     * Standard error from the hook.
+     */
+    stderr: string;
+    /**
+     * Execution duration in milliseconds.
+     */
+    duration: number;
+    /**
+     * Whether the hook was skipped (disabled or didn't match).
+     */
+    skipped: boolean;
+    /**
+     * Reason for skipping, if applicable.
+     */
+    skipReason?: string;
+    /**
+     * Error message if hook threw an error.
+     */
+    error?: string;
+}
+/**
+ * Combined result from executing all hooks for an event.
+ */
+export interface HookEventResult {
+    /**
+     * Event that was triggered.
+     */
+    event: HookEvent;
+    /**
+     * Whether all hooks passed (none blocked).
+     */
+    allowed: boolean;
+    /**
+     * Message explaining why execution was blocked (if applicable).
+     */
+    blockMessage?: string;
+    /**
+     * Results from individual hooks.
+     */
+    results: HookExecutionResult[];
+    /**
+     * Total execution duration in milliseconds.
+     */
+    totalDuration: number;
+}
+/**
+ * Result from hook discovery across all sources.
+ */
+export interface HookDiscoveryResult {
+    /**
+     * All discovered hooks (including inactive due to overrides).
+     */
+    all: HookDefinition[];
+    /**
+     * Only active hooks (after priority resolution).
+     */
+    active: HookDefinition[];
+    /**
+     * Hooks grouped by event type.
+     */
+    byEvent: Record<HookEvent, HookDefinition[]>;
+    /**
+     * Hooks grouped by source.
+     */
+    bySource: Record<HookSource, HookDefinition[]>;
+}
+/**
+ * Checks if a value is a valid HookEvent.
+ */
+export declare function isValidHookEvent(value: unknown): value is HookEvent;
+/**
+ * Checks if a value is a valid HookSource.
+ */
+export declare function isValidHookSource(value: unknown): value is HookSource;
+/**
+ * Checks if a value is a valid HookFrontmatter object.
+ */
+export declare function isValidHookFrontmatter(value: unknown): value is HookFrontmatter;
+/**
+ * Gets the priority number for a hook source (higher = more priority).
+ */
+export declare function getHookSourcePriority(source: HookSource): number;
+/**
+ * Compares two hooks by source priority.
+ * Returns positive if a has higher priority, negative if b has higher priority.
+ */
+export declare function compareHookPriority(a: HookDefinition, b: HookDefinition): number;
+//# sourceMappingURL=hook.d.ts.map

package/dist/types/hook.d.ts.map

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