@eddacraft/kindling-core 0.1.0

package/dist/validation/observation.js

@@ -0,0 +1,110 @@
+/**
+ * Observation validation
+ */
+import { randomUUID } from 'crypto';
+import { ok, err, isObservationKind, } from '../types/index.js';
+/**
+ * Validate and normalize an observation input
+ *
+ * Auto-generates:
+ * - id (if not provided)
+ * - ts (if not provided)
+ * - redacted (defaults to false)
+ * - provenance (defaults to empty object)
+ *
+ * @param input - Observation input to validate
+ * @returns Result containing validated Observation or validation errors
+ */
+export function validateObservation(input) {
+    const errors = [];
+    // Type check
+    if (typeof input !== 'object' || input === null) {
+        return err([{ field: 'input', message: 'Input must be an object' }]);
+    }
+    const data = input;
+    // Validate kind (required)
+    if (!data.kind) {
+        errors.push({ field: 'kind', message: 'kind is required' });
+    }
+    else if (!isObservationKind(data.kind)) {
+        errors.push({
+            field: 'kind',
+            message: `Invalid observation kind: ${data.kind}`,
+            value: data.kind,
+        });
+    }
+    // Validate content (required, non-empty string)
+    if (!data.content) {
+        errors.push({ field: 'content', message: 'content is required' });
+    }
+    else if (typeof data.content !== 'string') {
+        errors.push({
+            field: 'content',
+            message: 'content must be a string',
+            value: typeof data.content,
+        });
+    }
+    else if (data.content.trim().length === 0) {
+        errors.push({ field: 'content', message: 'content cannot be empty' });
+    }
+    // Validate scopeIds (required)
+    if (!data.scopeIds) {
+        errors.push({ field: 'scopeIds', message: 'scopeIds is required' });
+    }
+    else if (typeof data.scopeIds !== 'object' || data.scopeIds === null) {
+        errors.push({
+            field: 'scopeIds',
+            message: 'scopeIds must be an object',
+        });
+    }
+    // Validate provenance (optional, must be object)
+    if (data.provenance !== undefined) {
+        if (typeof data.provenance !== 'object' || data.provenance === null || Array.isArray(data.provenance)) {
+            errors.push({
+                field: 'provenance',
+                message: 'provenance must be an object',
+            });
+        }
+    }
+    // Validate ts (optional, must be positive number)
+    if (data.ts !== undefined) {
+        if (typeof data.ts !== 'number') {
+            errors.push({
+                field: 'ts',
+                message: 'ts must be a number',
+                value: typeof data.ts,
+            });
+        }
+        else if (data.ts < 0) {
+            errors.push({
+                field: 'ts',
+                message: 'ts must be non-negative',
+                value: data.ts,
+            });
+        }
+    }
+    // Validate redacted (optional, must be boolean)
+    if (data.redacted !== undefined && typeof data.redacted !== 'boolean') {
+        errors.push({
+            field: 'redacted',
+            message: 'redacted must be a boolean',
+            value: typeof data.redacted,
+        });
+    }
+    // Return errors if any
+    if (errors.length > 0) {
+        return err(errors);
+    }
+    // Construct validated observation with defaults
+    const observation = {
+        id: data.id || randomUUID(),
+        kind: data.kind,
+        content: data.content,
+        provenance: data.provenance || {},
+        ts: data.ts || Date.now(),
+        scopeIds: data.scopeIds,
+        redacted: data.redacted || false,
+    };
+    return ok(observation);
+}
+//# sourceMappingURL=observation.js.map

package/dist/validation/observation.js.map

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

package/dist/validation/pin.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Pin validation
+ */
+import type { Pin, ValidationError, Result } from '../types/index.js';
+/**
+ * Validate and normalize a pin input
+ *
+ * Auto-generates:
+ * - id (if not provided)
+ * - createdAt (if not provided)
+ *
+ * @param input - Pin input to validate
+ * @returns Result containing validated Pin or validation errors
+ */
+export declare function validatePin(input: unknown): Result<Pin, ValidationError[]>;
+//# sourceMappingURL=pin.d.ts.map

package/dist/validation/pin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pin.d.ts","sourceRoot":"","sources":["../../src/validation/pin.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EACV,GAAG,EACH,eAAe,EACf,MAAM,EACP,MAAM,mBAAmB,CAAC;AAO3B;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,GAAG,EAAE,eAAe,EAAE,CAAC,CAwG1E"}

package/dist/validation/pin.js

@@ -0,0 +1,116 @@
+/**
+ * Pin validation
+ */
+import { randomUUID } from 'crypto';
+import { ok, err, isPinTargetType, } from '../types/index.js';
+/**
+ * Validate and normalize a pin input
+ *
+ * Auto-generates:
+ * - id (if not provided)
+ * - createdAt (if not provided)
+ *
+ * @param input - Pin input to validate
+ * @returns Result containing validated Pin or validation errors
+ */
+export function validatePin(input) {
+    const errors = [];
+    // Type check
+    if (typeof input !== 'object' || input === null) {
+        return err([{ field: 'input', message: 'Input must be an object' }]);
+    }
+    const data = input;
+    // Validate targetType (required)
+    if (!data.targetType) {
+        errors.push({ field: 'targetType', message: 'targetType is required' });
+    }
+    else if (!isPinTargetType(data.targetType)) {
+        errors.push({
+            field: 'targetType',
+            message: `Invalid pin target type: ${data.targetType}`,
+            value: data.targetType,
+        });
+    }
+    // Validate targetId (required, non-empty string)
+    if (!data.targetId) {
+        errors.push({ field: 'targetId', message: 'targetId is required' });
+    }
+    else if (typeof data.targetId !== 'string') {
+        errors.push({
+            field: 'targetId',
+            message: 'targetId must be a string',
+            value: typeof data.targetId,
+        });
+    }
+    else if (data.targetId.trim().length === 0) {
+        errors.push({ field: 'targetId', message: 'targetId cannot be empty' });
+    }
+    // Validate scopeIds (required)
+    if (!data.scopeIds) {
+        errors.push({ field: 'scopeIds', message: 'scopeIds is required' });
+    }
+    else if (typeof data.scopeIds !== 'object' || data.scopeIds === null) {
+        errors.push({
+            field: 'scopeIds',
+            message: 'scopeIds must be an object',
+        });
+    }
+    // Validate reason (optional, must be string)
+    if (data.reason !== undefined && typeof data.reason !== 'string') {
+        errors.push({
+            field: 'reason',
+            message: 'reason must be a string',
+            value: typeof data.reason,
+        });
+    }
+    // Validate createdAt (optional, must be positive number)
+    if (data.createdAt !== undefined) {
+        if (typeof data.createdAt !== 'number') {
+            errors.push({
+                field: 'createdAt',
+                message: 'createdAt must be a number',
+                value: typeof data.createdAt,
+            });
+        }
+        else if (data.createdAt < 0) {
+            errors.push({
+                field: 'createdAt',
+                message: 'createdAt must be non-negative',
+                value: data.createdAt,
+            });
+        }
+    }
+    // Validate expiresAt (optional, must be positive number)
+    if (data.expiresAt !== undefined) {
+        if (typeof data.expiresAt !== 'number') {
+            errors.push({
+                field: 'expiresAt',
+                message: 'expiresAt must be a number',
+                value: typeof data.expiresAt,
+            });
+        }
+        else if (data.expiresAt < 0) {
+            errors.push({
+                field: 'expiresAt',
+                message: 'expiresAt must be non-negative',
+                value: data.expiresAt,
+            });
+        }
+    }
+    // Return errors if any
+    if (errors.length > 0) {
+        return err(errors);
+    }
+    // Construct validated pin with defaults
+    const pin = {
+        id: data.id || randomUUID(),
+        targetType: data.targetType,
+        targetId: data.targetId,
+        reason: data.reason,
+        createdAt: data.createdAt || Date.now(),
+        expiresAt: data.expiresAt,
+        scopeIds: data.scopeIds,
+    };
+    return ok(pin);
+}
+//# sourceMappingURL=pin.js.map

package/dist/validation/pin.js.map

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

package/dist/validation/summary.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Summary validation
+ */
+import type { Summary, ValidationError, Result } from '../types/index.js';
+/**
+ * Validate and normalize a summary input
+ *
+ * Auto-generates:
+ * - id (if not provided)
+ * - createdAt (if not provided)
+ *
+ * @param input - Summary input to validate
+ * @returns Result containing validated Summary or validation errors
+ */
+export declare function validateSummary(input: unknown): Result<Summary, ValidationError[]>;
+//# sourceMappingURL=summary.d.ts.map

package/dist/validation/summary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"summary.d.ts","sourceRoot":"","sources":["../../src/validation/summary.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EACV,OAAO,EACP,eAAe,EACf,MAAM,EACP,MAAM,mBAAmB,CAAC;AAO3B;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,OAAO,EAAE,eAAe,EAAE,CAAC,CAqGlF"}

package/dist/validation/summary.js

@@ -0,0 +1,117 @@
+/**
+ * Summary validation
+ */
+import { randomUUID } from 'crypto';
+import { ok, err, isValidConfidence, } from '../types/index.js';
+/**
+ * Validate and normalize a summary input
+ *
+ * Auto-generates:
+ * - id (if not provided)
+ * - createdAt (if not provided)
+ *
+ * @param input - Summary input to validate
+ * @returns Result containing validated Summary or validation errors
+ */
+export function validateSummary(input) {
+    const errors = [];
+    // Type check
+    if (typeof input !== 'object' || input === null) {
+        return err([{ field: 'input', message: 'Input must be an object' }]);
+    }
+    const data = input;
+    // Validate capsuleId (required, non-empty string)
+    if (!data.capsuleId) {
+        errors.push({ field: 'capsuleId', message: 'capsuleId is required' });
+    }
+    else if (typeof data.capsuleId !== 'string') {
+        errors.push({
+            field: 'capsuleId',
+            message: 'capsuleId must be a string',
+            value: typeof data.capsuleId,
+        });
+    }
+    else if (data.capsuleId.trim().length === 0) {
+        errors.push({ field: 'capsuleId', message: 'capsuleId cannot be empty' });
+    }
+    // Validate content (required, non-empty string)
+    if (!data.content) {
+        errors.push({ field: 'content', message: 'content is required' });
+    }
+    else if (typeof data.content !== 'string') {
+        errors.push({
+            field: 'content',
+            message: 'content must be a string',
+            value: typeof data.content,
+        });
+    }
+    else if (data.content.trim().length === 0) {
+        errors.push({ field: 'content', message: 'content cannot be empty' });
+    }
+    // Validate confidence (required, must be 0.0-1.0)
+    if (data.confidence === undefined || data.confidence === null) {
+        errors.push({ field: 'confidence', message: 'confidence is required' });
+    }
+    else if (typeof data.confidence !== 'number') {
+        errors.push({
+            field: 'confidence',
+            message: 'confidence must be a number',
+            value: typeof data.confidence,
+        });
+    }
+    else if (!isValidConfidence(data.confidence)) {
+        errors.push({
+            field: 'confidence',
+            message: 'confidence must be between 0.0 and 1.0',
+            value: data.confidence,
+        });
+    }
+    // Validate evidenceRefs (required, must be array of strings)
+    if (!data.evidenceRefs) {
+        errors.push({ field: 'evidenceRefs', message: 'evidenceRefs is required' });
+    }
+    else if (!Array.isArray(data.evidenceRefs)) {
+        errors.push({
+            field: 'evidenceRefs',
+            message: 'evidenceRefs must be an array',
+        });
+    }
+    else if (!data.evidenceRefs.every((id) => typeof id === 'string')) {
+        errors.push({
+            field: 'evidenceRefs',
+            message: 'evidenceRefs must contain only strings',
+        });
+    }
+    // Validate createdAt (optional, must be positive number)
+    if (data.createdAt !== undefined) {
+        if (typeof data.createdAt !== 'number') {
+            errors.push({
+                field: 'createdAt',
+                message: 'createdAt must be a number',
+                value: typeof data.createdAt,
+            });
+        }
+        else if (data.createdAt < 0) {
+            errors.push({
+                field: 'createdAt',
+                message: 'createdAt must be non-negative',
+                value: data.createdAt,
+            });
+        }
+    }
+    // Return errors if any
+    if (errors.length > 0) {
+        return err(errors);
+    }
+    // Construct validated summary with defaults
+    const summary = {
+        id: data.id || randomUUID(),
+        capsuleId: data.capsuleId,
+        content: data.content,
+        confidence: data.confidence,
+        createdAt: data.createdAt || Date.now(),
+        evidenceRefs: data.evidenceRefs,
+    };
+    return ok(summary);
+}
+//# sourceMappingURL=summary.js.map

package/dist/validation/summary.js.map

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

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@eddacraft/kindling-core",
+  "version": "0.1.0",
+  "description": "Core domain model and orchestration for Kindling - local memory engine for AI-assisted development",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "kindling",
+    "ai",
+    "memory",
+    "context",
+    "llm",
+    "agent",
+    "observations",
+    "capsules",
+    "retrieval"
+  ],
+  "author": "EddaCraft <hello@eddacraft.ai>",
+  "homepage": "https://github.com/EddaCraft/kindling/tree/main/packages/kindling-core#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/EddaCraft/kindling.git",
+    "directory": "packages/kindling-core"
+  },
+  "bugs": {
+    "url": "https://github.com/EddaCraft/kindling/issues"
+  },
+  "license": "Apache-2.0",
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "typescript": "^5.3.0",
+    "vitest": "^3.2.4"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc --build",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "type-check": "tsc --noEmit",
+    "lint": "eslint src",
+    "clean": "rm -rf dist"
+  }
+}