@eddacraft/anvil-kindling-integration 0.1.0

package/dist/config.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Kindling Configuration Schema (KINDLING-002)
+ *
+ * Defines configuration for the Kindling integration layer.
+ * Configuration is read from `.anvilrc` or `anvil.config.json` in the project root.
+ *
+ * @see kindling-service.ts for how config is consumed
+ */
+import { z } from 'zod';
+/**
+ * Capture flags: which observation kinds to record
+ */
+export declare const CaptureConfigSchema: z.ZodObject<{
+    sessions: z.ZodDefault<z.ZodBoolean>;
+    gates: z.ZodDefault<z.ZodBoolean>;
+    actions: z.ZodDefault<z.ZodBoolean>;
+    plans: z.ZodDefault<z.ZodBoolean>;
+    human_inputs: z.ZodDefault<z.ZodBoolean>;
+    constraints: z.ZodDefault<z.ZodBoolean>;
+    errors: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+export type CaptureConfig = z.infer<typeof CaptureConfigSchema>;
+/**
+ * Retention policy
+ */
+export declare const RetentionConfigSchema: z.ZodObject<{
+    days: z.ZodDefault<z.ZodNumber>;
+    auto_prune: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+export type RetentionConfig = z.infer<typeof RetentionConfigSchema>;
+/**
+ * Query limit defaults
+ */
+export declare const QueryLimitConfigSchema: z.ZodObject<{
+    max_results: z.ZodDefault<z.ZodNumber>;
+    max_payload_bytes: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+export type QueryLimitConfig = z.infer<typeof QueryLimitConfigSchema>;
+/**
+ * Full Kindling configuration
+ */
+export declare const KindlingConfigSchema: z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    database_path: z.ZodDefault<z.ZodString>;
+    retention: z.ZodDefault<z.ZodObject<{
+        days: z.ZodDefault<z.ZodNumber>;
+        auto_prune: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    capture: z.ZodDefault<z.ZodObject<{
+        sessions: z.ZodDefault<z.ZodBoolean>;
+        gates: z.ZodDefault<z.ZodBoolean>;
+        actions: z.ZodDefault<z.ZodBoolean>;
+        plans: z.ZodDefault<z.ZodBoolean>;
+        human_inputs: z.ZodDefault<z.ZodBoolean>;
+        constraints: z.ZodDefault<z.ZodBoolean>;
+        errors: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    query_limits: z.ZodDefault<z.ZodObject<{
+        max_results: z.ZodDefault<z.ZodNumber>;
+        max_payload_bytes: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type KindlingConfig = z.infer<typeof KindlingConfigSchema>;
+/**
+ * Default configuration: disabled, sensible defaults for everything else
+ */
+export declare const DEFAULT_KINDLING_CONFIG: KindlingConfig;
+/**
+ * Load Kindling configuration from the project root.
+ *
+ * Searches for `.anvilrc` or `anvil.config.json` in the given directory.
+ * Expects a JSON file with an optional `kindling` key containing the config.
+ *
+ * Returns the default (disabled) config if no file is found or if the
+ * `kindling` key is absent.
+ *
+ * @param projectRoot - Absolute path to the project root directory
+ * @returns Parsed and validated KindlingConfig
+ */
+export declare function loadKindlingConfig(projectRoot: string): KindlingConfig;
+/**
+ * Check whether a specific observation kind should be captured based on config.
+ *
+ * @param config - Kindling configuration
+ * @param kind - Observation kind string
+ * @returns true if the observation should be captured
+ */
+export declare function shouldCapture(config: KindlingConfig, kind: string): boolean;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAQxB;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;iBAQ9B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;iBAGhC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE;;GAEG;AACH,eAAO,MAAM,sBAAsB;;;iBAejC,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;iBAuB/B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAMlE;;GAEG;AACH,eAAO,MAAM,uBAAuB,EAAE,cAA+C,CAAC;AAWtF;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,cAAc,CAwCtE;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CA4B3E"}

package/dist/config.js

@@ -0,0 +1,173 @@
+/**
+ * Kindling Configuration Schema (KINDLING-002)
+ *
+ * Defines configuration for the Kindling integration layer.
+ * Configuration is read from `.anvilrc` or `anvil.config.json` in the project root.
+ *
+ * @see kindling-service.ts for how config is consumed
+ */
+import { z } from 'zod';
+import { readFileSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+// =============================================================================
+// Configuration Schema
+// =============================================================================
+/**
+ * Capture flags: which observation kinds to record
+ */
+export const CaptureConfigSchema = z.object({
+    sessions: z.boolean().default(true).describe('Record session start/end'),
+    gates: z.boolean().default(true).describe('Record gate evaluations'),
+    actions: z.boolean().default(true).describe('Record action executions'),
+    plans: z.boolean().default(true).describe('Record plan lifecycle events'),
+    human_inputs: z.boolean().default(true).describe('Record human inputs'),
+    constraints: z.boolean().default(true).describe('Record constraint applications'),
+    errors: z.boolean().default(true).describe('Record errors'),
+});
+/**
+ * Retention policy
+ */
+export const RetentionConfigSchema = z.object({
+    days: z.number().int().positive().default(90).describe('Days to retain observations'),
+    auto_prune: z.boolean().default(false).describe('Automatically prune on session start'),
+});
+/**
+ * Query limit defaults
+ */
+export const QueryLimitConfigSchema = z.object({
+    max_results: z
+        .number()
+        .int()
+        .positive()
+        .max(1000)
+        .default(100)
+        .describe('Default max results per query'),
+    max_payload_bytes: z
+        .number()
+        .int()
+        .positive()
+        .max(10 * 1024 * 1024)
+        .default(1024 * 1024)
+        .describe('Default max payload size in bytes'),
+});
+/**
+ * Full Kindling configuration
+ */
+export const KindlingConfigSchema = z.object({
+    enabled: z.boolean().default(false).describe('Whether Kindling recording is active'),
+    database_path: z
+        .string()
+        .default('.anvil/kindling.db')
+        .describe('Path to the SQLite database (relative to project root)'),
+    retention: RetentionConfigSchema.default(() => ({
+        days: 90,
+        auto_prune: false,
+    })),
+    capture: CaptureConfigSchema.default(() => ({
+        sessions: true,
+        gates: true,
+        actions: true,
+        plans: true,
+        human_inputs: true,
+        constraints: true,
+        errors: true,
+    })),
+    query_limits: QueryLimitConfigSchema.default(() => ({
+        max_results: 100,
+        max_payload_bytes: 1024 * 1024,
+    })),
+});
+// =============================================================================
+// Default Configuration
+// =============================================================================
+/**
+ * Default configuration: disabled, sensible defaults for everything else
+ */
+export const DEFAULT_KINDLING_CONFIG = KindlingConfigSchema.parse({});
+// =============================================================================
+// Configuration Loading
+// =============================================================================
+/**
+ * Known configuration file names, checked in order
+ */
+const CONFIG_FILE_NAMES = ['.anvilrc', 'anvil.config.json'];
+/**
+ * Load Kindling configuration from the project root.
+ *
+ * Searches for `.anvilrc` or `anvil.config.json` in the given directory.
+ * Expects a JSON file with an optional `kindling` key containing the config.
+ *
+ * Returns the default (disabled) config if no file is found or if the
+ * `kindling` key is absent.
+ *
+ * @param projectRoot - Absolute path to the project root directory
+ * @returns Parsed and validated KindlingConfig
+ */
+export function loadKindlingConfig(projectRoot) {
+    for (const fileName of CONFIG_FILE_NAMES) {
+        const filePath = join(projectRoot, fileName);
+        if (!existsSync(filePath)) {
+            continue;
+        }
+        try {
+            const raw = readFileSync(filePath, 'utf-8');
+            const parsed = JSON.parse(raw);
+            if (parsed === null || typeof parsed !== 'object') {
+                continue;
+            }
+            const record = parsed;
+            if (!('kindling' in record) || record['kindling'] === undefined) {
+                // Config file exists but has no kindling section
+                return DEFAULT_KINDLING_CONFIG;
+            }
+            const result = KindlingConfigSchema.safeParse(record['kindling']);
+            if (result.success) {
+                return result.data;
+            }
+            // Invalid config shape -- fall back to defaults rather than crashing
+            // The caller (service layer) will operate in disabled mode
+            return DEFAULT_KINDLING_CONFIG;
+        }
+        catch {
+            // JSON parse error or read error -- fall back to defaults
+            return DEFAULT_KINDLING_CONFIG;
+        }
+    }
+    // No config file found
+    return DEFAULT_KINDLING_CONFIG;
+}
+/**
+ * Check whether a specific observation kind should be captured based on config.
+ *
+ * @param config - Kindling configuration
+ * @param kind - Observation kind string
+ * @returns true if the observation should be captured
+ */
+export function shouldCapture(config, kind) {
+    if (!config.enabled) {
+        return false;
+    }
+    switch (kind) {
+        case 'session_start':
+        case 'session_end':
+            return config.capture.sessions;
+        case 'gate_evaluated':
+            return config.capture.gates;
+        case 'action_executed':
+            return config.capture.actions;
+        case 'plan_created':
+        case 'plan_edited':
+        case 'plan_approved':
+        case 'plan_rejected':
+            return config.capture.plans;
+        case 'human_input':
+            return config.capture.human_inputs;
+        case 'constraint_applied':
+            return config.capture.constraints;
+        case 'error':
+            return config.capture.errors;
+        default:
+            // Unknown kinds are captured by default when enabled
+            return true;
+    }
+}

package/dist/emitters/action-emitter.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Action Emitter (KINDLING-005)
+ *
+ * Emits action_executed observations when commands, tool invocations,
+ * file operations, or diff applications occur.
+ */
+import type { KindlingService } from '../kindling-service.js';
+/**
+ * Action execution details to be recorded
+ */
+export interface ActionDetails {
+    session_id: string;
+    action_type: 'command' | 'tool_invocation' | 'file_write' | 'file_delete' | 'diff_apply';
+    details: {
+        command?: string;
+        tool_name?: string;
+        file_paths?: string[];
+        diff_summary?: {
+            additions: number;
+            deletions: number;
+            files_changed: number;
+        };
+        working_directory: string;
+        environment_target?: string;
+    };
+    governed_by_gate_id?: string;
+    governed_by_plan_id?: string;
+    outcome: 'success' | 'failure' | 'partial';
+    exit_code?: number;
+    duration_ms: number;
+}
+/**
+ * Emit an action_executed observation.
+ *
+ * @param service - KindlingService instance
+ * @param actionDetails - Action execution details
+ * @returns The generated action_id
+ */
+export declare function emitActionExecuted(service: KindlingService, actionDetails: ActionDetails): string;
+//# sourceMappingURL=action-emitter.d.ts.map

package/dist/emitters/action-emitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-emitter.d.ts","sourceRoot":"","sources":["../../src/emitters/action-emitter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAU9D;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,SAAS,GAAG,iBAAiB,GAAG,YAAY,GAAG,aAAa,GAAG,YAAY,CAAC;IACzF,OAAO,EAAE;QACP,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;QACtB,YAAY,CAAC,EAAE;YACb,SAAS,EAAE,MAAM,CAAC;YAClB,SAAS,EAAE,MAAM,CAAC;YAClB,aAAa,EAAE,MAAM,CAAC;SACvB,CAAC;QACF,iBAAiB,EAAE,MAAM,CAAC;QAC1B,kBAAkB,CAAC,EAAE,MAAM,CAAC;KAC7B,CAAC;IACF,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,OAAO,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB;AAMD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,aAAa,GAAG,MAAM,CAmCjG"}

package/dist/emitters/action-emitter.js

@@ -0,0 +1,52 @@
+/**
+ * Action Emitter (KINDLING-005)
+ *
+ * Emits action_executed observations when commands, tool invocations,
+ * file operations, or diff applications occur.
+ */
+import { randomUUID } from 'node:crypto';
+import { createDebugger } from '../utils/debug.js';
+const debug = createDebugger('kindling');
+// =============================================================================
+// Emitter
+// =============================================================================
+/**
+ * Emit an action_executed observation.
+ *
+ * @param service - KindlingService instance
+ * @param actionDetails - Action execution details
+ * @returns The generated action_id
+ */
+export function emitActionExecuted(service, actionDetails) {
+    const actionId = randomUUID();
+    debug('emitting action_executed', {
+        actionId,
+        actionType: actionDetails.action_type,
+        outcome: actionDetails.outcome,
+    });
+    const observation = {
+        kind: 'action_executed',
+        session_id: actionDetails.session_id,
+        timestamp: new Date().toISOString(),
+        action_id: actionId,
+        action_type: actionDetails.action_type,
+        details: {
+            command: actionDetails.details.command,
+            tool_name: actionDetails.details.tool_name,
+            file_paths: actionDetails.details.file_paths,
+            diff_summary: actionDetails.details.diff_summary,
+            working_directory: actionDetails.details.working_directory,
+            environment_target: actionDetails.details.environment_target,
+        },
+        governed_by_gate_id: actionDetails.governed_by_gate_id,
+        governed_by_plan_id: actionDetails.governed_by_plan_id,
+        outcome: actionDetails.outcome,
+        exit_code: actionDetails.exit_code,
+        duration_ms: actionDetails.duration_ms,
+    };
+    // Fire-and-forget
+    service.emit(observation).catch(() => {
+        // Silently swallow
+    });
+    return actionId;
+}

package/dist/emitters/constraint-emitter.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Constraint Emitter (KINDLING-007b)
+ *
+ * Emits constraint_applied observations when Anvil prevents an action
+ * due to policy, scope, environment, or approval requirements.
+ */
+import type { KindlingService } from '../kindling-service.js';
+/**
+ * Constraint application details to be recorded
+ */
+export interface ConstraintDetails {
+    session_id: string;
+    constraint_type: 'policy' | 'rule' | 'scope' | 'environment' | 'approval_required';
+    prevented_action: {
+        action_type: string;
+        action_target?: string;
+    };
+    reason: string;
+    scope?: string;
+    environment?: string;
+    options_available?: string[];
+    options_allowed?: string[];
+}
+/**
+ * Emit a constraint_applied observation.
+ *
+ * @param service - KindlingService instance
+ * @param constraint - Constraint application details
+ * @returns The generated constraint_id
+ */
+export declare function emitConstraintApplied(service: KindlingService, constraint: ConstraintDetails): string;
+//# sourceMappingURL=constraint-emitter.d.ts.map

package/dist/emitters/constraint-emitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constraint-emitter.d.ts","sourceRoot":"","sources":["../../src/emitters/constraint-emitter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAO9D;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,aAAa,GAAG,mBAAmB,CAAC;IACnF,gBAAgB,EAAE;QAChB,WAAW,EAAE,MAAM,CAAC;QACpB,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC;IACF,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAMD;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,eAAe,EACxB,UAAU,EAAE,iBAAiB,GAC5B,MAAM,CA0BR"}

package/dist/emitters/constraint-emitter.js

@@ -0,0 +1,41 @@
+/**
+ * Constraint Emitter (KINDLING-007b)
+ *
+ * Emits constraint_applied observations when Anvil prevents an action
+ * due to policy, scope, environment, or approval requirements.
+ */
+import { randomUUID } from 'node:crypto';
+// =============================================================================
+// Emitter
+// =============================================================================
+/**
+ * Emit a constraint_applied observation.
+ *
+ * @param service - KindlingService instance
+ * @param constraint - Constraint application details
+ * @returns The generated constraint_id
+ */
+export function emitConstraintApplied(service, constraint) {
+    const constraintId = randomUUID();
+    const observation = {
+        kind: 'constraint_applied',
+        session_id: constraint.session_id,
+        timestamp: new Date().toISOString(),
+        constraint_id: constraintId,
+        constraint_type: constraint.constraint_type,
+        prevented_action: {
+            action_type: constraint.prevented_action.action_type,
+            action_target: constraint.prevented_action.action_target,
+        },
+        reason: constraint.reason,
+        scope: constraint.scope,
+        environment: constraint.environment,
+        options_available: constraint.options_available,
+        options_allowed: constraint.options_allowed,
+    };
+    // Fire-and-forget
+    service.emit(observation).catch(() => {
+        // Silently swallow
+    });
+    return constraintId;
+}

package/dist/emitters/error-emitter.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Error Emitter (KINDLING-008)
+ *
+ * Emits error observations when failures occur.
+ * "Errors are not noise, they are data."
+ */
+import type { KindlingService } from '../kindling-service.js';
+/**
+ * Error details to be recorded
+ */
+export interface ErrorDetails {
+    session_id: string;
+    error_type: 'command_failure' | 'tool_error' | 'aborted_execution' | 'partial_state' | 'validation_failure';
+    context: {
+        component: string;
+        action_id?: string;
+        gate_id?: string;
+    };
+    error_message: string;
+    error_code?: string;
+    exit_code?: number;
+    recoverable: boolean;
+    partial_state_description?: string;
+}
+/**
+ * Emit an error observation.
+ *
+ * @param service - KindlingService instance
+ * @param errorDetails - Error details
+ * @returns The generated error_id
+ */
+export declare function emitError(service: KindlingService, errorDetails: ErrorDetails): string;
+//# sourceMappingURL=error-emitter.d.ts.map

package/dist/emitters/error-emitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-emitter.d.ts","sourceRoot":"","sources":["../../src/emitters/error-emitter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAU9D;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EACN,iBAAiB,GACjB,YAAY,GACZ,mBAAmB,GACnB,eAAe,GACf,oBAAoB,CAAC;IACzB,OAAO,EAAE;QACP,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;IACrB,yBAAyB,CAAC,EAAE,MAAM,CAAC;CACpC;AAMD;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,YAAY,GAAG,MAAM,CAiCtF"}

package/dist/emitters/error-emitter.js

@@ -0,0 +1,50 @@
+/**
+ * Error Emitter (KINDLING-008)
+ *
+ * Emits error observations when failures occur.
+ * "Errors are not noise, they are data."
+ */
+import { randomUUID } from 'node:crypto';
+import { createDebugger } from '../utils/debug.js';
+const debug = createDebugger('kindling');
+// =============================================================================
+// Emitter
+// =============================================================================
+/**
+ * Emit an error observation.
+ *
+ * @param service - KindlingService instance
+ * @param errorDetails - Error details
+ * @returns The generated error_id
+ */
+export function emitError(service, errorDetails) {
+    const errorId = randomUUID();
+    debug('emitting error observation', {
+        errorId,
+        errorType: errorDetails.error_type,
+        component: errorDetails.context.component,
+        recoverable: errorDetails.recoverable,
+    });
+    const observation = {
+        kind: 'error',
+        session_id: errorDetails.session_id,
+        timestamp: new Date().toISOString(),
+        error_id: errorId,
+        error_type: errorDetails.error_type,
+        context: {
+            component: errorDetails.context.component,
+            action_id: errorDetails.context.action_id,
+            gate_id: errorDetails.context.gate_id,
+        },
+        error_message: errorDetails.error_message,
+        error_code: errorDetails.error_code,
+        exit_code: errorDetails.exit_code,
+        recoverable: errorDetails.recoverable,
+        partial_state_description: errorDetails.partial_state_description,
+    };
+    // Fire-and-forget
+    service.emit(observation).catch(() => {
+        // Silently swallow
+    });
+    return errorId;
+}

package/dist/emitters/gate-emitter.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Gate Emitter (KINDLING-004)
+ *
+ * Emits gate_evaluated observations when gates are checked.
+ * Gate evaluations form the governance record -- why things were
+ * allowed or blocked.
+ */
+import type { KindlingService } from '../kindling-service.js';
+/**
+ * Gate evaluation result to be recorded
+ */
+export interface GateResult {
+    session_id: string;
+    gate_id: string;
+    gate_version?: string;
+    inputs: {
+        file_count?: number;
+        changed_files?: string[];
+        baseline_hash?: string;
+    };
+    outcome: 'pass' | 'fail' | 'error' | 'skipped';
+    rules_evaluated: string[];
+    rules_violated?: string[];
+    enforcement: 'blocking' | 'warning' | 'informational';
+    duration_ms: number;
+    violation_count?: number;
+    warning_count?: number;
+}
+/**
+ * Emit a gate_evaluated observation.
+ *
+ * @param service - KindlingService instance
+ * @param gateResult - Gate evaluation result
+ * @returns The generated gate_eval_id
+ */
+export declare function emitGateEvaluated(service: KindlingService, gateResult: GateResult): string;
+//# sourceMappingURL=gate-emitter.d.ts.map

package/dist/emitters/gate-emitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gate-emitter.d.ts","sourceRoot":"","sources":["../../src/emitters/gate-emitter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAU9D;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE;QACN,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;QACzB,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC;IACF,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;IAC/C,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,WAAW,EAAE,UAAU,GAAG,SAAS,GAAG,eAAe,CAAC;IACtD,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAMD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,UAAU,GAAG,MAAM,CAmC1F"}

package/dist/emitters/gate-emitter.js

@@ -0,0 +1,53 @@
+/**
+ * Gate Emitter (KINDLING-004)
+ *
+ * Emits gate_evaluated observations when gates are checked.
+ * Gate evaluations form the governance record -- why things were
+ * allowed or blocked.
+ */
+import { randomUUID } from 'node:crypto';
+import { createDebugger } from '../utils/debug.js';
+const debug = createDebugger('kindling');
+// =============================================================================
+// Emitter
+// =============================================================================
+/**
+ * Emit a gate_evaluated observation.
+ *
+ * @param service - KindlingService instance
+ * @param gateResult - Gate evaluation result
+ * @returns The generated gate_eval_id
+ */
+export function emitGateEvaluated(service, gateResult) {
+    const gateEvalId = randomUUID();
+    debug('emitting gate_evaluated', {
+        gateId: gateResult.gate_id,
+        outcome: gateResult.outcome,
+        gateEvalId,
+    });
+    const observation = {
+        kind: 'gate_evaluated',
+        session_id: gateResult.session_id,
+        timestamp: new Date().toISOString(),
+        gate_eval_id: gateEvalId,
+        gate_id: gateResult.gate_id,
+        gate_version: gateResult.gate_version,
+        inputs: {
+            file_count: gateResult.inputs.file_count,
+            changed_files: gateResult.inputs.changed_files,
+            baseline_hash: gateResult.inputs.baseline_hash,
+        },
+        outcome: gateResult.outcome,
+        rules_evaluated: gateResult.rules_evaluated,
+        rules_violated: gateResult.rules_violated,
+        enforcement: gateResult.enforcement,
+        duration_ms: gateResult.duration_ms,
+        violation_count: gateResult.violation_count,
+        warning_count: gateResult.warning_count,
+    };
+    // Fire-and-forget
+    service.emit(observation).catch(() => {
+        // Silently swallow
+    });
+    return gateEvalId;
+}

package/dist/emitters/human-input-emitter.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Human Input Emitter (KINDLING-007a)
+ *
+ * Emits human_input observations when a user makes a decision
+ * (approval, override, rejection, manual edit, confirmation, cancellation).
+ */
+import type { KindlingService } from '../kindling-service.js';
+/**
+ * Human input details to be recorded
+ */
+export interface HumanInputDetails {
+    session_id: string;
+    input_type: 'approval' | 'override' | 'rejection' | 'manual_edit' | 'confirmation' | 'cancellation';
+    context: {
+        prompt?: string;
+        target?: string;
+    };
+    decision: string;
+    reason?: string;
+    user_identifier: string;
+}
+/**
+ * Emit a human_input observation.
+ *
+ * @param service - KindlingService instance
+ * @param input - Human input details
+ * @returns A generated ID for linking purposes
+ */
+export declare function emitHumanInput(service: KindlingService, input: HumanInputDetails): string;
+//# sourceMappingURL=human-input-emitter.d.ts.map

package/dist/emitters/human-input-emitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"human-input-emitter.d.ts","sourceRoot":"","sources":["../../src/emitters/human-input-emitter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAO9D;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EACN,UAAU,GACV,UAAU,GACV,WAAW,GACX,aAAa,GACb,cAAc,GACd,cAAc,CAAC;IACnB,OAAO,EAAE;QACP,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;CACzB;AAMD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,eAAe,EAAE,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAuBzF"}