@eddacraft/anvil-kindling-integration 0.1.0

package/dist/emitters/human-input-emitter.js

@@ -0,0 +1,38 @@
+/**
+ * Human Input Emitter (KINDLING-007a)
+ *
+ * Emits human_input observations when a user makes a decision
+ * (approval, override, rejection, manual edit, confirmation, cancellation).
+ */
+import { randomUUID } from 'node:crypto';
+// =============================================================================
+// Emitter
+// =============================================================================
+/**
+ * Emit a human_input observation.
+ *
+ * @param service - KindlingService instance
+ * @param input - Human input details
+ * @returns A generated ID for linking purposes
+ */
+export function emitHumanInput(service, input) {
+    const inputId = randomUUID();
+    const observation = {
+        kind: 'human_input',
+        session_id: input.session_id,
+        timestamp: new Date().toISOString(),
+        input_type: input.input_type,
+        context: {
+            prompt: input.context.prompt,
+            target: input.context.target,
+        },
+        decision: input.decision,
+        reason: input.reason,
+        user_identifier: input.user_identifier,
+    };
+    // Fire-and-forget
+    service.emit(observation).catch(() => {
+        // Silently swallow
+    });
+    return inputId;
+}

package/dist/emitters/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Emitters Barrel Export (KINDLING-003 through 008)
+ *
+ * All emitter functions and their input types, re-exported for convenience.
+ */
+export { emitSessionStart, emitSessionEnd, type SessionStartContext, type SessionEndOutcome, } from './session-emitter.js';
+export { emitGateEvaluated, type GateResult } from './gate-emitter.js';
+export { emitActionExecuted, type ActionDetails } from './action-emitter.js';
+export { emitPlanCreated, emitPlanEdited, emitPlanApproved, emitPlanRejected, type PlanCreatedInput, type PlanEditedInput, type PlanApprovedInput, type PlanRejectedInput, } from './plan-emitter.js';
+export { emitHumanInput, type HumanInputDetails } from './human-input-emitter.js';
+export { emitConstraintApplied, type ConstraintDetails } from './constraint-emitter.js';
+export { emitError, type ErrorDetails } from './error-emitter.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/emitters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/emitters/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,GACvB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAAE,iBAAiB,EAAE,KAAK,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAGvE,OAAO,EAAE,kBAAkB,EAAE,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAG7E,OAAO,EACL,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,GACvB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,cAAc,EAAE,KAAK,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAGlF,OAAO,EAAE,qBAAqB,EAAE,KAAK,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAGxF,OAAO,EAAE,SAAS,EAAE,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/emitters/index.js

@@ -0,0 +1,19 @@
+/**
+ * Emitters Barrel Export (KINDLING-003 through 008)
+ *
+ * All emitter functions and their input types, re-exported for convenience.
+ */
+// Session (KINDLING-003)
+export { emitSessionStart, emitSessionEnd, } from './session-emitter.js';
+// Gate (KINDLING-004)
+export { emitGateEvaluated } from './gate-emitter.js';
+// Action (KINDLING-005)
+export { emitActionExecuted } from './action-emitter.js';
+// Plan (KINDLING-006)
+export { emitPlanCreated, emitPlanEdited, emitPlanApproved, emitPlanRejected, } from './plan-emitter.js';
+// Human Input (KINDLING-007a)
+export { emitHumanInput } from './human-input-emitter.js';
+// Constraint (KINDLING-007b)
+export { emitConstraintApplied } from './constraint-emitter.js';
+// Error (KINDLING-008)
+export { emitError } from './error-emitter.js';

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

@@ -0,0 +1,75 @@
+/**
+ * Plan Emitter (KINDLING-006)
+ *
+ * Emits plan lifecycle observations: created, edited, approved, rejected.
+ * Plans are the governance artifacts that authorize actions.
+ */
+import type { KindlingService } from '../kindling-service.js';
+export interface PlanCreatedInput {
+    session_id: string;
+    plan_id?: string;
+    plan_version: string;
+    plan_path: string;
+    plan_hash: string;
+    created_by: 'human' | 'ai' | 'system';
+    source?: string;
+}
+export interface PlanEditedInput {
+    session_id: string;
+    plan_id: string;
+    previous_version: string;
+    new_version: string;
+    previous_hash: string;
+    new_hash: string;
+    edited_by: 'human' | 'ai' | 'system';
+    change_summary?: string;
+}
+export interface PlanApprovedInput {
+    session_id: string;
+    plan_id: string;
+    plan_version: string;
+    approved_by: string;
+    approval_method: 'cli_confirm' | 'explicit_flag' | 'ci_gate';
+}
+export interface PlanRejectedInput {
+    session_id: string;
+    plan_id: string;
+    plan_version: string;
+    rejected_by: string;
+    rejection_reason?: string;
+}
+/**
+ * Emit a plan_created observation.
+ *
+ * If no plan_id is provided, one is generated.
+ *
+ * @param service - KindlingService instance
+ * @param plan - Plan creation details
+ * @returns The plan_id (generated or provided)
+ */
+export declare function emitPlanCreated(service: KindlingService, plan: PlanCreatedInput): string;
+/**
+ * Emit a plan_edited observation.
+ *
+ * @param service - KindlingService instance
+ * @param edit - Plan edit details
+ * @returns The plan_id
+ */
+export declare function emitPlanEdited(service: KindlingService, edit: PlanEditedInput): string;
+/**
+ * Emit a plan_approved observation.
+ *
+ * @param service - KindlingService instance
+ * @param approval - Plan approval details
+ * @returns The plan_id
+ */
+export declare function emitPlanApproved(service: KindlingService, approval: PlanApprovedInput): string;
+/**
+ * Emit a plan_rejected observation.
+ *
+ * @param service - KindlingService instance
+ * @param rejection - Plan rejection details
+ * @returns The plan_id
+ */
+export declare function emitPlanRejected(service: KindlingService, rejection: PlanRejectedInput): string;
+//# sourceMappingURL=plan-emitter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plan-emitter.d.ts","sourceRoot":"","sources":["../../src/emitters/plan-emitter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAe9D,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,OAAO,GAAG,IAAI,GAAG,QAAQ,CAAC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,OAAO,GAAG,IAAI,GAAG,QAAQ,CAAC;IACrC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,aAAa,GAAG,eAAe,GAAG,SAAS,CAAC;CAC9D;AAED,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAMD;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,gBAAgB,GAAG,MAAM,CAsBxF;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,eAAe,GAAG,MAAM,CAsBtF;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,iBAAiB,GAAG,MAAM,CAmB9F;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,iBAAiB,GAAG,MAAM,CAmB/F"}

package/dist/emitters/plan-emitter.js

@@ -0,0 +1,116 @@
+/**
+ * Plan Emitter (KINDLING-006)
+ *
+ * Emits plan lifecycle observations: created, edited, approved, rejected.
+ * Plans are the governance artifacts that authorize actions.
+ */
+import { randomUUID } from 'node:crypto';
+import { createDebugger } from '../utils/debug.js';
+const debug = createDebugger('kindling');
+// =============================================================================
+// Emitters
+// =============================================================================
+/**
+ * Emit a plan_created observation.
+ *
+ * If no plan_id is provided, one is generated.
+ *
+ * @param service - KindlingService instance
+ * @param plan - Plan creation details
+ * @returns The plan_id (generated or provided)
+ */
+export function emitPlanCreated(service, plan) {
+    const planId = plan.plan_id ?? randomUUID();
+    debug('emitting plan_created', { planId, createdBy: plan.created_by });
+    const observation = {
+        kind: 'plan_created',
+        session_id: plan.session_id,
+        timestamp: new Date().toISOString(),
+        plan_id: planId,
+        plan_version: plan.plan_version,
+        plan_path: plan.plan_path,
+        plan_hash: plan.plan_hash,
+        created_by: plan.created_by,
+        source: plan.source,
+    };
+    // Fire-and-forget
+    service.emit(observation).catch(() => {
+        // Silently swallow
+    });
+    return planId;
+}
+/**
+ * Emit a plan_edited observation.
+ *
+ * @param service - KindlingService instance
+ * @param edit - Plan edit details
+ * @returns The plan_id
+ */
+export function emitPlanEdited(service, edit) {
+    debug('emitting plan_edited', { planId: edit.plan_id, editedBy: edit.edited_by });
+    const observation = {
+        kind: 'plan_edited',
+        session_id: edit.session_id,
+        timestamp: new Date().toISOString(),
+        plan_id: edit.plan_id,
+        previous_version: edit.previous_version,
+        new_version: edit.new_version,
+        previous_hash: edit.previous_hash,
+        new_hash: edit.new_hash,
+        edited_by: edit.edited_by,
+        change_summary: edit.change_summary,
+    };
+    // Fire-and-forget
+    service.emit(observation).catch(() => {
+        // Silently swallow
+    });
+    return edit.plan_id;
+}
+/**
+ * Emit a plan_approved observation.
+ *
+ * @param service - KindlingService instance
+ * @param approval - Plan approval details
+ * @returns The plan_id
+ */
+export function emitPlanApproved(service, approval) {
+    debug('emitting plan_approved', { planId: approval.plan_id, approvedBy: approval.approved_by });
+    const observation = {
+        kind: 'plan_approved',
+        session_id: approval.session_id,
+        timestamp: new Date().toISOString(),
+        plan_id: approval.plan_id,
+        plan_version: approval.plan_version,
+        approved_by: approval.approved_by,
+        approval_method: approval.approval_method,
+    };
+    // Fire-and-forget
+    service.emit(observation).catch(() => {
+        // Silently swallow
+    });
+    return approval.plan_id;
+}
+/**
+ * Emit a plan_rejected observation.
+ *
+ * @param service - KindlingService instance
+ * @param rejection - Plan rejection details
+ * @returns The plan_id
+ */
+export function emitPlanRejected(service, rejection) {
+    debug('emitting plan_rejected', { planId: rejection.plan_id, rejectedBy: rejection.rejected_by });
+    const observation = {
+        kind: 'plan_rejected',
+        session_id: rejection.session_id,
+        timestamp: new Date().toISOString(),
+        plan_id: rejection.plan_id,
+        plan_version: rejection.plan_version,
+        rejected_by: rejection.rejected_by,
+        rejection_reason: rejection.rejection_reason,
+    };
+    // Fire-and-forget
+    service.emit(observation).catch(() => {
+        // Silently swallow
+    });
+    return rejection.plan_id;
+}

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

@@ -0,0 +1,57 @@
+/**
+ * Session Emitter (KINDLING-003)
+ *
+ * Emits session_start and session_end observations.
+ * Sessions form the "spine" of Kindling -- every other observation
+ * is linked to a session via session_id.
+ */
+import type { KindlingService } from '../kindling-service.js';
+/**
+ * Context needed to start a session observation
+ */
+export interface SessionStartContext {
+    working_directory: string;
+    git_ref?: string;
+    git_dirty?: boolean;
+    anvil_version: string;
+    command: string;
+    args: string[];
+    environment: 'development' | 'ci' | 'production' | 'unknown';
+    plan_id?: string;
+}
+/**
+ * Outcome data for ending a session
+ */
+export interface SessionEndOutcome {
+    outcome: 'success' | 'failure' | 'partial' | 'cancelled';
+    exit_code: number;
+    duration_ms: number;
+    summary: {
+        gates_evaluated: number;
+        gates_passed: number;
+        gates_failed: number;
+        actions_executed: number;
+        errors_encountered: number;
+    };
+}
+/**
+ * Emit a session_start observation.
+ *
+ * Generates a new session_id and emits fire-and-forget.
+ * Returns the generated session_id so callers can link subsequent observations.
+ *
+ * @param service - KindlingService instance
+ * @param context - Session start context
+ * @returns The generated session_id
+ */
+export declare function emitSessionStart(service: KindlingService, context: SessionStartContext): string;
+/**
+ * Emit a session_end observation.
+ *
+ * @param service - KindlingService instance
+ * @param sessionId - The session_id from the corresponding session_start
+ * @param outcome - Session outcome data
+ * @returns The session_id (same as input, for chaining)
+ */
+export declare function emitSessionEnd(service: KindlingService, sessionId: string, outcome: SessionEndOutcome): string;
+//# sourceMappingURL=session-emitter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session-emitter.d.ts","sourceRoot":"","sources":["../../src/emitters/session-emitter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAU9D;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,WAAW,EAAE,aAAa,GAAG,IAAI,GAAG,YAAY,GAAG,SAAS,CAAC;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,CAAC;IACzD,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE;QACP,eAAe,EAAE,MAAM,CAAC;QACxB,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,MAAM,CAAC;QACrB,gBAAgB,EAAE,MAAM,CAAC;QACzB,kBAAkB,EAAE,MAAM,CAAC;KAC5B,CAAC;CACH;AAMD;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,mBAAmB,GAAG,MAAM,CA8B/F;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,eAAe,EACxB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,iBAAiB,GACzB,MAAM,CAuBR"}

package/dist/emitters/session-emitter.js

@@ -0,0 +1,80 @@
+/**
+ * Session Emitter (KINDLING-003)
+ *
+ * Emits session_start and session_end observations.
+ * Sessions form the "spine" of Kindling -- every other observation
+ * is linked to a session via session_id.
+ */
+import { randomUUID } from 'node:crypto';
+import { createDebugger } from '../utils/debug.js';
+const debug = createDebugger('kindling');
+// =============================================================================
+// Emitters
+// =============================================================================
+/**
+ * Emit a session_start observation.
+ *
+ * Generates a new session_id and emits fire-and-forget.
+ * Returns the generated session_id so callers can link subsequent observations.
+ *
+ * @param service - KindlingService instance
+ * @param context - Session start context
+ * @returns The generated session_id
+ */
+export function emitSessionStart(service, context) {
+    const sessionId = randomUUID();
+    debug('emitting session_start', {
+        sessionId,
+        command: context.command,
+        environment: context.environment,
+    });
+    const observation = {
+        kind: 'session_start',
+        session_id: sessionId,
+        timestamp: new Date().toISOString(),
+        context: {
+            working_directory: context.working_directory,
+            git_ref: context.git_ref,
+            git_dirty: context.git_dirty,
+            anvil_version: context.anvil_version,
+            command: context.command,
+            args: context.args,
+            environment: context.environment,
+        },
+        plan_id: context.plan_id,
+    };
+    // Fire-and-forget: catch errors silently to not affect main flow
+    service.emit(observation).catch(() => {
+        // Silently swallow -- Kindling must never break the host
+    });
+    return sessionId;
+}
+/**
+ * Emit a session_end observation.
+ *
+ * @param service - KindlingService instance
+ * @param sessionId - The session_id from the corresponding session_start
+ * @param outcome - Session outcome data
+ * @returns The session_id (same as input, for chaining)
+ */
+export function emitSessionEnd(service, sessionId, outcome) {
+    debug('emitting session_end', {
+        sessionId,
+        outcome: outcome.outcome,
+        duration_ms: outcome.duration_ms,
+    });
+    const observation = {
+        kind: 'session_end',
+        session_id: sessionId,
+        timestamp: new Date().toISOString(),
+        outcome: outcome.outcome,
+        exit_code: outcome.exit_code,
+        duration_ms: outcome.duration_ms,
+        summary: outcome.summary,
+    };
+    // Fire-and-forget
+    service.emit(observation).catch(() => {
+        // Silently swallow
+    });
+    return sessionId;
+}

package/dist/index.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Kindling Integration (v1)
+ *
+ * This package provides the complete integration layer between Anvil and Kindling.
+ *
+ * Three surfaces:
+ *
+ * 1. Observation Contract (Write-Only)
+ *    - 11 observation kinds covering session, plan, gate, action, constraint, human, error
+ *    - Immutable, timestamped, linked facts
+ *
+ * 2. Query Contract (Read-Only)
+ *    - 4 query scopes: session, plan, gate, action
+ *    - Mandatory constraints, throttling, output guarantees
+ *
+ * 3. Service Layer (Orchestration)
+ *    - KindlingService: validation, sensitive-data checks, store delegation
+ *    - Emitters: fire-and-forget observation emission
+ *    - KindlingQueryService: high-level query convenience methods
+ *    - Configuration, retention, and query limit enforcement
+ *
+ * GOVERNING RULE:
+ * Kindling is a system of record, not a reasoning engine.
+ * Queries may retrieve facts; interpretation is the caller's responsibility.
+ *
+ * @packageDocumentation
+ */
+export { OBSERVATION_CONTRACT_VERSION, SessionStartObservationSchema, SessionEndObservationSchema, PlanCreatedObservationSchema, PlanEditedObservationSchema, PlanApprovedObservationSchema, PlanRejectedObservationSchema, ActionExecutedObservationSchema, GateEvaluatedObservationSchema, ConstraintAppliedObservationSchema, HumanInputObservationSchema, ErrorObservationSchema, ObservationSchema, type SessionStartObservation, type SessionEndObservation, type PlanCreatedObservation, type PlanEditedObservation, type PlanApprovedObservation, type PlanRejectedObservation, type ActionExecutedObservation, type GateEvaluatedObservation, type ConstraintAppliedObservation, type HumanInputObservation, type ErrorObservation, type Observation, validateObservation, containsSensitiveData, } from './observation-contract.js';
+export { KINDLING_QUERY_CONTRACT_VERSION, QueryScopeSchema, type QueryScope, ResultShapeSchema, type ResultShape, OutputFormatSchema, type OutputFormat, SessionQuerySchema, PlanQuerySchema, GateQuerySchema, ActionQuerySchema, QueryRequestSchema, QueryRequestBaseSchema, type QueryRequest, type QueryRequestBase, type SessionQuery, type PlanQuery, type GateQuery, type ActionQuery, QueryResponseSchema, QueryResponseMetadataSchema, ProvenanceLinkSchema, type QueryResponse, type QueryResponseMetadata, type ProvenanceLink, validateQueryRequest, validateQueryResponse, } from './query-contract.js';
+export { ObservationSchema as QueryObservationSchema } from './query-contract.js';
+export { KindlingConfigSchema, CaptureConfigSchema, RetentionConfigSchema, QueryLimitConfigSchema, type KindlingConfig, type CaptureConfig, type RetentionConfig, type QueryLimitConfig, DEFAULT_KINDLING_CONFIG, loadKindlingConfig, shouldCapture, } from './config.js';
+export { type IKindlingStore, NoOpKindlingStore, KindlingService, ObservationValidationError, QueryValidationError, createKindlingService, } from './kindling-service.js';
+export { validateNoSensitiveData, redactSensitiveFields, type SensitiveDataValidationResult, } from './sensitive-data-validator.js';
+export { emitSessionStart, emitSessionEnd, type SessionStartContext, type SessionEndOutcome, emitGateEvaluated, type GateResult, emitActionExecuted, type ActionDetails, emitPlanCreated, emitPlanEdited, emitPlanApproved, emitPlanRejected, type PlanCreatedInput, type PlanEditedInput, type PlanApprovedInput, type PlanRejectedInput, emitHumanInput, type HumanInputDetails, emitConstraintApplied, type ConstraintDetails, emitError, type ErrorDetails, } from './emitters/index.js';
+export { KindlingQueryService, type QueryOptions, type SessionQueryOptions, type PlanQueryOptions, type ActionQueryOptions, } from './query-service.js';
+export { enforceQueryLimits, limitsFromConfig, type QueryLimits } from './query-limits.js';
+export { type IRetentionCapableStore, type StorageStats, type PruneResult, isRetentionCapable, pruneOldObservations, getStorageStats, } from './retention.js';
+export { getKindlingStatus, formatKindlingStatus, type KindlingStatus, type KindlingStatusConfig, type KindlingStatusStore, } from './status.js';
+export { AnvilKindlingAdapter, type AnvilKindlingAdapterConfig } from './adapter.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,111 @@
+/**
+ * Kindling Integration (v1)
+ *
+ * This package provides the complete integration layer between Anvil and Kindling.
+ *
+ * Three surfaces:
+ *
+ * 1. Observation Contract (Write-Only)
+ *    - 11 observation kinds covering session, plan, gate, action, constraint, human, error
+ *    - Immutable, timestamped, linked facts
+ *
+ * 2. Query Contract (Read-Only)
+ *    - 4 query scopes: session, plan, gate, action
+ *    - Mandatory constraints, throttling, output guarantees
+ *
+ * 3. Service Layer (Orchestration)
+ *    - KindlingService: validation, sensitive-data checks, store delegation
+ *    - Emitters: fire-and-forget observation emission
+ *    - KindlingQueryService: high-level query convenience methods
+ *    - Configuration, retention, and query limit enforcement
+ *
+ * GOVERNING RULE:
+ * Kindling is a system of record, not a reasoning engine.
+ * Queries may retrieve facts; interpretation is the caller's responsibility.
+ *
+ * @packageDocumentation
+ */
+// =============================================================================
+// Observation Contract (Write-Only)
+// =============================================================================
+export { 
+// Version
+OBSERVATION_CONTRACT_VERSION, 
+// Schemas (individual)
+SessionStartObservationSchema, SessionEndObservationSchema, PlanCreatedObservationSchema, PlanEditedObservationSchema, PlanApprovedObservationSchema, PlanRejectedObservationSchema, ActionExecutedObservationSchema, GateEvaluatedObservationSchema, ConstraintAppliedObservationSchema, HumanInputObservationSchema, ErrorObservationSchema, 
+// Schema (union)
+ObservationSchema, 
+// Utilities
+validateObservation, containsSensitiveData, } from './observation-contract.js';
+// =============================================================================
+// Query Contract (Read-Only)
+// =============================================================================
+export { 
+// Version
+KINDLING_QUERY_CONTRACT_VERSION, 
+// Query scopes
+QueryScopeSchema, 
+// Result shape
+ResultShapeSchema, 
+// Output format
+OutputFormatSchema, 
+// Query requests (individual)
+SessionQuerySchema, PlanQuerySchema, GateQuerySchema, ActionQuerySchema, 
+// Query request (union)
+QueryRequestSchema, QueryRequestBaseSchema, 
+// Query response
+QueryResponseSchema, QueryResponseMetadataSchema, ProvenanceLinkSchema, 
+// Utilities
+validateQueryRequest, validateQueryResponse, } from './query-contract.js';
+// Re-export Observation from query-contract for convenience
+export { ObservationSchema as QueryObservationSchema } from './query-contract.js';
+// =============================================================================
+// Configuration (KINDLING-002)
+// =============================================================================
+export { KindlingConfigSchema, CaptureConfigSchema, RetentionConfigSchema, QueryLimitConfigSchema, DEFAULT_KINDLING_CONFIG, loadKindlingConfig, shouldCapture, } from './config.js';
+// =============================================================================
+// Service Layer (KINDLING-001)
+// =============================================================================
+export { NoOpKindlingStore, KindlingService, ObservationValidationError, QueryValidationError, createKindlingService, } from './kindling-service.js';
+// =============================================================================
+// Sensitive Data Validation (KINDLING-015)
+// =============================================================================
+export { validateNoSensitiveData, redactSensitiveFields, } from './sensitive-data-validator.js';
+// =============================================================================
+// Emitters (KINDLING-003 through 008)
+// =============================================================================
+export { 
+// Session
+emitSessionStart, emitSessionEnd, 
+// Gate
+emitGateEvaluated, 
+// Action
+emitActionExecuted, 
+// Plan
+emitPlanCreated, emitPlanEdited, emitPlanApproved, emitPlanRejected, 
+// Human Input
+emitHumanInput, 
+// Constraint
+emitConstraintApplied, 
+// Error
+emitError, } from './emitters/index.js';
+// =============================================================================
+// Query Service (KINDLING-009)
+// =============================================================================
+export { KindlingQueryService, } from './query-service.js';
+// =============================================================================
+// Query Limits (KINDLING-010)
+// =============================================================================
+export { enforceQueryLimits, limitsFromConfig } from './query-limits.js';
+// =============================================================================
+// Retention (KINDLING-016)
+// =============================================================================
+export { isRetentionCapable, pruneOldObservations, getStorageStats, } from './retention.js';
+// =============================================================================
+// Status Utility (KINDLING-014)
+// =============================================================================
+export { getKindlingStatus, formatKindlingStatus, } from './status.js';
+// =============================================================================
+// Adapter (Anvil → Kindling Bridge)
+// =============================================================================
+export { AnvilKindlingAdapter } from './adapter.js';