cognitive-core 0.1.0 → 0.2.0

package/dist/types/trajectory-source.d.ts

@@ -0,0 +1,39 @@
+import type { Trajectory } from './trajectory.js';
+import type { AnalysisResult } from '../learning/analyzer.js';
+/**
+ * A trajectory paired with its optional pre-computed analysis.
+ * If analysis is missing, the consumer should compute it.
+ */
+export interface TrajectoryWithAnalysis {
+    trajectory: Trajectory;
+    analysis?: AnalysisResult;
+}
+/**
+ * Options for filtering trajectories when loading.
+ */
+export interface TrajectoryLoadOptions {
+    /** Only load trajectories created after this date */
+    since?: Date;
+    /** Filter to a specific domain */
+    domain?: string;
+    /** Maximum number of trajectories to return */
+    limit?: number;
+    /** Only include successful trajectories */
+    successOnly?: boolean;
+}
+/**
+ * TrajectorySource — abstract interface for loading trajectories from
+ * different backends (in-memory arrays, filesystem, pipeline accumulators, etc.).
+ *
+ * Consumers of this interface (e.g. KnowledgeBank.extractFrom) don't care
+ * where trajectories come from — they just load and process them.
+ */
+export interface TrajectorySource {
+    /** Human-readable name for this source */
+    readonly name: string;
+    /** Load trajectories, optionally filtered */
+    load(options?: TrajectoryLoadOptions): Promise<TrajectoryWithAnalysis[]>;
+    /** Count available trajectories without loading them */
+    count(options?: TrajectoryLoadOptions): Promise<number>;
+}
+//# sourceMappingURL=trajectory-source.d.ts.map

package/dist/types/trajectory-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trajectory-source.d.ts","sourceRoot":"","sources":["../../src/types/trajectory-source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAM9D;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,UAAU,CAAC;IACvB,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,qDAAqD;IACrD,KAAK,CAAC,EAAE,IAAI,CAAC;IACb,kCAAkC;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B,0CAA0C;IAC1C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,6CAA6C;IAC7C,IAAI,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,sBAAsB,EAAE,CAAC,CAAC;IAEzE,wDAAwD;IACxD,KAAK,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACzD"}

package/dist/types/trajectory-source.js

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

package/dist/types/trajectory-source.js.map

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

package/dist/utils/error-classifier.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Unified error classification utility.
+ *
+ * Provides a single canonical error type mapping used by TrajectoryAnalyzer,
+ * ReflexionGenerator, KnowledgeExtractor, and other learning components.
+ */
+/**
+ * Canonical error types recognized by the classifier.
+ */
+export type ErrorType = 'type-error' | 'import-error' | 'syntax-error' | 'timeout' | 'permission-error' | 'not-found' | 'network-error' | 'test-failure' | 'assertion-error' | 'general-error';
+/**
+ * Result of classifying an error string.
+ */
+export interface ErrorClassification {
+    /** Canonical error type */
+    type: ErrorType;
+    /** Human-readable description */
+    description: string;
+}
+/**
+ * Classify an error message into a canonical error type.
+ * Returns `null` if no pattern matches.
+ */
+export declare function classifyError(errorInfo: string): ErrorClassification | null;
+/**
+ * Get just the error type string (convenience wrapper).
+ * Returns `null` if no pattern matches.
+ */
+export declare function classifyErrorType(errorInfo: string): ErrorType | null;
+//# sourceMappingURL=error-classifier.d.ts.map

package/dist/utils/error-classifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-classifier.d.ts","sourceRoot":"","sources":["../../src/utils/error-classifier.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,MAAM,SAAS,GACjB,YAAY,GACZ,cAAc,GACd,cAAc,GACd,SAAS,GACT,kBAAkB,GAClB,WAAW,GACX,eAAe,GACf,cAAc,GACd,iBAAiB,GACjB,eAAe,CAAC;AAEpB;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,2BAA2B;IAC3B,IAAI,EAAE,SAAS,CAAC;IAChB,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;CACrB;AA2DD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,mBAAmB,GAAG,IAAI,CAU3E;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAGrE"}

package/dist/utils/error-classifier.js

@@ -0,0 +1,85 @@
+/**
+ * Unified error classification utility.
+ *
+ * Provides a single canonical error type mapping used by TrajectoryAnalyzer,
+ * ReflexionGenerator, KnowledgeExtractor, and other learning components.
+ */
+/**
+ * Ordered list of error classification rules.
+ * More specific patterns come first; 'general-error' is the fallback.
+ */
+const ERROR_RULES = [
+    {
+        test: (s) => /type\s*error/i.test(s) || (s.includes('type') && s.includes('error')),
+        type: 'type-error',
+        description: 'Type mismatch error',
+    },
+    {
+        test: (s) => /import|module not found|cannot find module/i.test(s),
+        type: 'import-error',
+        description: 'Import or module resolution error',
+    },
+    {
+        test: (s) => /syntax\s*error/i.test(s),
+        type: 'syntax-error',
+        description: 'Syntax error in code',
+    },
+    {
+        test: (s) => /timeout|timed?\s*out/i.test(s),
+        type: 'timeout',
+        description: 'Operation timed out',
+    },
+    {
+        test: (s) => /permission\s*denied|forbidden|unauthorized/i.test(s),
+        type: 'permission-error',
+        description: 'Permission denied',
+    },
+    {
+        test: (s) => /not\s*found|missing|no\s*such\s*file/i.test(s),
+        type: 'not-found',
+        description: 'Resource not found',
+    },
+    {
+        test: (s) => /network|connection|ECONNREFUSED|ENOTFOUND/i.test(s),
+        type: 'network-error',
+        description: 'Network or connection error',
+    },
+    {
+        test: (s) => /test.*fail|fail.*test|assertion|assert/i.test(s),
+        type: 'test-failure',
+        description: 'Test or assertion failure',
+    },
+    {
+        test: (s) => /assertion|assert/i.test(s),
+        type: 'assertion-error',
+        description: 'Assertion failed',
+    },
+    {
+        test: (s) => /exception|error/i.test(s),
+        type: 'general-error',
+        description: 'General error',
+    },
+];
+/**
+ * Classify an error message into a canonical error type.
+ * Returns `null` if no pattern matches.
+ */
+export function classifyError(errorInfo) {
+    if (!errorInfo)
+        return null;
+    for (const rule of ERROR_RULES) {
+        if (rule.test(errorInfo)) {
+            return { type: rule.type, description: rule.description };
+        }
+    }
+    return null;
+}
+/**
+ * Get just the error type string (convenience wrapper).
+ * Returns `null` if no pattern matches.
+ */
+export function classifyErrorType(errorInfo) {
+    const result = classifyError(errorInfo);
+    return result?.type ?? null;
+}
+//# sourceMappingURL=error-classifier.js.map

package/dist/utils/error-classifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-classifier.js","sourceRoot":"","sources":["../../src/utils/error-classifier.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA2BH;;;GAGG;AACH,MAAM,WAAW,GAAkF;IACjG;QACE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QACnF,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE,qBAAqB;KACnC;IACD;QACE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,6CAA6C,CAAC,IAAI,CAAC,CAAC,CAAC;QAClE,IAAI,EAAE,cAAc;QACpB,WAAW,EAAE,mCAAmC;KACjD;IACD;QACE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC;QACtC,IAAI,EAAE,cAAc;QACpB,WAAW,EAAE,sBAAsB;KACpC;IACD;QACE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,uBAAuB,CAAC,IAAI,CAAC,CAAC,CAAC;QAC5C,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,qBAAqB;KACnC;IACD;QACE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,6CAA6C,CAAC,IAAI,CAAC,CAAC,CAAC;QAClE,IAAI,EAAE,kBAAkB;QACxB,WAAW,EAAE,mBAAmB;KACjC;IACD;QACE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,uCAAuC,CAAC,IAAI,CAAC,CAAC,CAAC;QAC5D,IAAI,EAAE,WAAW;QACjB,WAAW,EAAE,oBAAoB;KAClC;IACD;QACE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,4CAA4C,CAAC,IAAI,CAAC,CAAC,CAAC;QACjE,IAAI,EAAE,eAAe;QACrB,WAAW,EAAE,6BAA6B;KAC3C;IACD;QACE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,yCAAyC,CAAC,IAAI,CAAC,CAAC,CAAC;QAC9D,IAAI,EAAE,cAAc;QACpB,WAAW,EAAE,2BAA2B;KACzC;IACD;QACE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC;QACxC,IAAI,EAAE,iBAAiB;QACvB,WAAW,EAAE,kBAAkB;KAChC;IACD;QACE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC;QACvC,IAAI,EAAE,eAAe;QACrB,WAAW,EAAE,eAAe;KAC7B;CACF,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,SAAiB;IAC7C,IAAI,CAAC,SAAS;QAAE,OAAO,IAAI,CAAC;IAE5B,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;QAC/B,IAAI,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;YACzB,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC;QAC5D,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,SAAiB;IACjD,MAAM,MAAM,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC;IACxC,OAAO,MAAM,EAAE,IAAI,IAAI,IAAI,CAAC;AAC9B,CAAC"}

package/dist/utils/frontmatter.d.ts

@@ -0,0 +1,34 @@
+import { type KnowledgeNoteFrontmatter, type KnowledgeNote } from '../types/knowledge.js';
+/**
+ * Parse markdown content with YAML frontmatter into a KnowledgeNoteFrontmatter + body.
+ *
+ * Uses the `yaml` npm package for full-fidelity parsing (nested objects,
+ * arrays of objects, etc.). Validates against the Zod schema.
+ *
+ * Returns null frontmatter if the content has no frontmatter block or
+ * if the frontmatter fails validation (logged, not thrown).
+ */
+export declare function parseKnowledgeFrontmatter(content: string): {
+    frontmatter: KnowledgeNoteFrontmatter | null;
+    body: string;
+};
+/**
+ * Serialize a KnowledgeNoteFrontmatter into a YAML frontmatter block.
+ *
+ * Keeps simple top-level fields (created, updated, tags) in a format
+ * that minimem's simpler parser can partially read.
+ */
+export declare function serializeKnowledgeFrontmatter(frontmatter: KnowledgeNoteFrontmatter): string;
+/**
+ * Serialize a full KnowledgeNote (frontmatter + body) into markdown content.
+ */
+export declare function serializeKnowledgeNote(note: KnowledgeNote): string;
+/**
+ * Parse a full markdown file into a KnowledgeNote.
+ * Returns null if frontmatter is missing or invalid.
+ *
+ * @param content - The raw markdown file content
+ * @param filePath - The file path (stored on the note for reference)
+ */
+export declare function parseKnowledgeNote(content: string, filePath: string): KnowledgeNote | null;
+//# sourceMappingURL=frontmatter.d.ts.map

package/dist/utils/frontmatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.d.ts","sourceRoot":"","sources":["../../src/utils/frontmatter.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,wBAAwB,EAC7B,KAAK,aAAa,EACnB,MAAM,uBAAuB,CAAC;AAI/B;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG;IAC1D,WAAW,EAAE,wBAAwB,GAAG,IAAI,CAAC;IAC7C,IAAI,EAAE,MAAM,CAAC;CACd,CA6BA;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAC3C,WAAW,EAAE,wBAAwB,GACpC,MAAM,CA4BR;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAGlE;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GACf,aAAa,GAAG,IAAI,CAStB"}

package/dist/utils/frontmatter.js

@@ -0,0 +1,93 @@
+import { parse as parseYaml, stringify as stringifyYaml } from 'yaml';
+import { KnowledgeNoteFrontmatterSchema, } from '../types/knowledge.js';
+const FRONTMATTER_REGEX = /^---\n([\s\S]*?)\n---\n?([\s\S]*)$/;
+/**
+ * Parse markdown content with YAML frontmatter into a KnowledgeNoteFrontmatter + body.
+ *
+ * Uses the `yaml` npm package for full-fidelity parsing (nested objects,
+ * arrays of objects, etc.). Validates against the Zod schema.
+ *
+ * Returns null frontmatter if the content has no frontmatter block or
+ * if the frontmatter fails validation (logged, not thrown).
+ */
+export function parseKnowledgeFrontmatter(content) {
+    const match = content.match(FRONTMATTER_REGEX);
+    if (!match) {
+        return { frontmatter: null, body: content };
+    }
+    const [, yamlBlock, body] = match;
+    try {
+        const raw = parseYaml(yamlBlock);
+        if (!raw || typeof raw !== 'object') {
+            return { frontmatter: null, body };
+        }
+        const parsed = KnowledgeNoteFrontmatterSchema.safeParse(raw);
+        if (!parsed.success) {
+            console.warn(`[frontmatter] Validation failed for note: ${JSON.stringify(parsed.error.issues)}`);
+            return { frontmatter: null, body };
+        }
+        return { frontmatter: parsed.data, body: body.trim() };
+    }
+    catch (error) {
+        console.warn(`[frontmatter] YAML parse error: ${error instanceof Error ? error.message : String(error)}`);
+        return { frontmatter: null, body: content };
+    }
+}
+/**
+ * Serialize a KnowledgeNoteFrontmatter into a YAML frontmatter block.
+ *
+ * Keeps simple top-level fields (created, updated, tags) in a format
+ * that minimem's simpler parser can partially read.
+ */
+export function serializeKnowledgeFrontmatter(frontmatter) {
+    // Build a clean object for serialization, omitting null/undefined/empty values
+    const obj = {
+        id: frontmatter.id,
+        type: frontmatter.type,
+    };
+    if (frontmatter.domain.length > 0)
+        obj.domain = frontmatter.domain;
+    if (frontmatter.entities.length > 0)
+        obj.entities = frontmatter.entities;
+    if (frontmatter.tags.length > 0)
+        obj.tags = frontmatter.tags;
+    obj.confidence = frontmatter.confidence;
+    obj.source = frontmatter.source;
+    if (frontmatter.links.length > 0)
+        obj.links = frontmatter.links;
+    obj.created = frontmatter.created;
+    obj.updated = frontmatter.updated;
+    if (frontmatter.supersedes)
+        obj.supersedes = frontmatter.supersedes;
+    const yaml = stringifyYaml(obj, {
+        lineWidth: 120,
+        defaultKeyType: 'PLAIN',
+        defaultStringType: 'PLAIN',
+    });
+    return `---\n${yaml}---\n`;
+}
+/**
+ * Serialize a full KnowledgeNote (frontmatter + body) into markdown content.
+ */
+export function serializeKnowledgeNote(note) {
+    const header = serializeKnowledgeFrontmatter(note.frontmatter);
+    return `${header}\n${note.body}\n`;
+}
+/**
+ * Parse a full markdown file into a KnowledgeNote.
+ * Returns null if frontmatter is missing or invalid.
+ *
+ * @param content - The raw markdown file content
+ * @param filePath - The file path (stored on the note for reference)
+ */
+export function parseKnowledgeNote(content, filePath) {
+    const { frontmatter, body } = parseKnowledgeFrontmatter(content);
+    if (!frontmatter)
+        return null;
+    return {
+        frontmatter,
+        body,
+        filePath,
+    };
+}
+//# sourceMappingURL=frontmatter.js.map

package/dist/utils/frontmatter.js.map

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

package/dist/utils/index.d.ts

@@ -1,4 +1,8 @@
 export { cosineSimilarity, jaccardSimilarity, textSimilarity, ngramSimilarity, tokenize, findTopK, } from './similarity.js';
 export { ensureDir, saveJson, loadJson, listFiles, exists, JsonStore, saveIndex, loadIndex, type StorageOptions, } from './storage.js';
+export { PartitionedStore, type PartitionedStoreOptions, } from './partitioned-store.js';
 export { ValidationError, validateString, validateOptionalString, validateNumber, validateOptionalNumber, validateArray, validateVector, validateTaskInput, validateTrajectoryStepCount, validateMCPArgs, TaskInputSchema, MCPSearchPlaybooksSchema, MCPGetPlaybookDetailsSchema, MCPGetPlaybooksByDomainSchema, type TaskInput, } from './validation.js';
+export { parseKnowledgeFrontmatter, serializeKnowledgeFrontmatter, serializeKnowledgeNote, parseKnowledgeNote, } from './frontmatter.js';
+export { classifyError, classifyErrorType, type ErrorType, type ErrorClassification, } from './error-classifier.js';
+export { detectRepeatedActions, extractToolNames, type RepeatedAction, } from './trajectory-helpers.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,QAAQ,EACR,QAAQ,GACT,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,MAAM,EACN,SAAS,EACT,SAAS,EACT,SAAS,EACT,KAAK,cAAc,GACpB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,eAAe,EACf,cAAc,EACd,sBAAsB,EACtB,cAAc,EACd,sBAAsB,EACtB,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,2BAA2B,EAC3B,eAAe,EACf,eAAe,EACf,wBAAwB,EACxB,2BAA2B,EAC3B,6BAA6B,EAC7B,KAAK,SAAS,GACf,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,QAAQ,EACR,QAAQ,GACT,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,MAAM,EACN,SAAS,EACT,SAAS,EACT,SAAS,EACT,KAAK,cAAc,GACpB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,gBAAgB,EAChB,KAAK,uBAAuB,GAC7B,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,eAAe,EACf,cAAc,EACd,sBAAsB,EACtB,cAAc,EACd,sBAAsB,EACtB,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,2BAA2B,EAC3B,eAAe,EACf,eAAe,EACf,wBAAwB,EACxB,2BAA2B,EAC3B,6BAA6B,EAC7B,KAAK,SAAS,GACf,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,yBAAyB,EACzB,6BAA6B,EAC7B,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,KAAK,SAAS,EACd,KAAK,mBAAmB,GACzB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,qBAAqB,EACrB,gBAAgB,EAChB,KAAK,cAAc,GACpB,MAAM,yBAAyB,CAAC"}

package/dist/utils/index.js

@@ -1,4 +1,8 @@
 export { cosineSimilarity, jaccardSimilarity, textSimilarity, ngramSimilarity, tokenize, findTopK, } from './similarity.js';
 export { ensureDir, saveJson, loadJson, listFiles, exists, JsonStore, saveIndex, loadIndex, } from './storage.js';
+export { PartitionedStore, } from './partitioned-store.js';
 export { ValidationError, validateString, validateOptionalString, validateNumber, validateOptionalNumber, validateArray, validateVector, validateTaskInput, validateTrajectoryStepCount, validateMCPArgs, TaskInputSchema, MCPSearchPlaybooksSchema, MCPGetPlaybookDetailsSchema, MCPGetPlaybooksByDomainSchema, } from './validation.js';
+export { parseKnowledgeFrontmatter, serializeKnowledgeFrontmatter, serializeKnowledgeNote, parseKnowledgeNote, } from './frontmatter.js';
+export { classifyError, classifyErrorType, } from './error-classifier.js';
+export { detectRepeatedActions, extractToolNames, } from './trajectory-helpers.js';
 //# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,QAAQ,EACR,QAAQ,GACT,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,MAAM,EACN,SAAS,EACT,SAAS,EACT,SAAS,GAEV,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,eAAe,EACf,cAAc,EACd,sBAAsB,EACtB,cAAc,EACd,sBAAsB,EACtB,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,2BAA2B,EAC3B,eAAe,EACf,eAAe,EACf,wBAAwB,EACxB,2BAA2B,EAC3B,6BAA6B,GAE9B,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,QAAQ,EACR,QAAQ,GACT,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,MAAM,EACN,SAAS,EACT,SAAS,EACT,SAAS,GAEV,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,gBAAgB,GAEjB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,eAAe,EACf,cAAc,EACd,sBAAsB,EACtB,cAAc,EACd,sBAAsB,EACtB,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,2BAA2B,EAC3B,eAAe,EACf,eAAe,EACf,wBAAwB,EACxB,2BAA2B,EAC3B,6BAA6B,GAE9B,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,yBAAyB,EACzB,6BAA6B,EAC7B,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,aAAa,EACb,iBAAiB,GAGlB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,qBAAqB,EACrB,gBAAgB,GAEjB,MAAM,yBAAyB,CAAC"}

package/dist/utils/partitioned-store.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Partitioned Store
+ *
+ * Domain-partitioned wrapper around JsonStore. Items are routed to partition
+ * subdirectories based on a caller-supplied key function. Queries can target
+ * a single partition (fast) or scan all partitions (full).
+ *
+ * On first init with existing flat data (no partition subdirs), items are
+ * auto-migrated into partition directories. This is a one-time operation.
+ */
+export interface PartitionedStoreOptions {
+    autoSaveInterval?: number;
+    pretty?: boolean;
+}
+/**
+ * Domain-partitioned key-value store backed by JSON files
+ */
+export declare class PartitionedStore<T> {
+    private partitions;
+    private keyIndex;
+    private baseDir;
+    private collection;
+    private partitionKeyFn;
+    private options;
+    private initialized;
+    constructor(baseDir: string, collection: string, partitionKeyFn: (item: T) => string | undefined, options?: PartitionedStoreOptions);
+    /**
+     * Initialize — discover existing partitions, auto-migrate flat data if needed
+     */
+    init(): Promise<void>;
+    /**
+     * Get an item by key. If partition is known, searches only that partition.
+     */
+    get(key: string, partition?: string): T | undefined;
+    /**
+     * Set an item — auto-routes to the correct partition based on partitionKeyFn
+     */
+    set(key: string, value: T): void;
+    /**
+     * Delete an item by key
+     */
+    delete(key: string): boolean;
+    /**
+     * Check if a key exists
+     */
+    has(key: string): boolean;
+    /**
+     * Get all values within a single partition
+     */
+    valuesInPartition(partition: string): T[];
+    /**
+     * Get all values across all partitions
+     */
+    values(): T[];
+    /**
+     * Get all keys across all partitions
+     */
+    keys(): string[];
+    /**
+     * Get total item count across all partitions
+     */
+    size(): number;
+    /**
+     * Get names of all partitions
+     */
+    getPartitionNames(): string[];
+    /**
+     * Get all entries across all partitions
+     */
+    entries(): Array<[string, T]>;
+    /**
+     * Flush all dirty partitions to disk
+     */
+    flush(): Promise<void>;
+    /**
+     * Save a single item immediately
+     */
+    save(key: string): Promise<void>;
+    /**
+     * Close all partitions
+     */
+    close(): Promise<void>;
+    /**
+     * Get or create a partition's JsonStore, loading its data
+     */
+    private getOrCreatePartition;
+    /**
+     * Migrate flat layout (files directly in collection dir) to partitioned layout.
+     * Only runs if flat JSON files exist alongside no partition directories.
+     */
+    private maybeMigrate;
+}
+//# sourceMappingURL=partitioned-store.d.ts.map

package/dist/utils/partitioned-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"partitioned-store.d.ts","sourceRoot":"","sources":["../../src/utils/partitioned-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AASH,MAAM,WAAW,uBAAuB;IACtC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,qBAAa,gBAAgB,CAAC,CAAC;IAC7B,OAAO,CAAC,UAAU,CAAwC;IAC1D,OAAO,CAAC,QAAQ,CAAkC;IAClD,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,cAAc,CAAkC;IACxD,OAAO,CAAC,OAAO,CAA0B;IACzC,OAAO,CAAC,WAAW,CAAS;gBAG1B,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,cAAc,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,GAAG,SAAS,EAC/C,OAAO,CAAC,EAAE,uBAAuB;IAQnC;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAyB3B;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAmBnD;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IA2BhC;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAiB5B;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAQzB;;OAEG;IACH,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,CAAC,EAAE;IAIzC;;OAEG;IACH,MAAM,IAAI,CAAC,EAAE;IAQb;;OAEG;IACH,IAAI,IAAI,MAAM,EAAE;IAQhB;;OAEG;IACH,IAAI,IAAI,MAAM;IAQd;;OAEG;IACH,iBAAiB,IAAI,MAAM,EAAE;IAI7B;;OAEG;IACH,OAAO,IAAI,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAQ7B;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAM5B;;OAEG;IACG,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOtC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAM5B;;OAEG;YACW,oBAAoB;IAoBlC;;;OAGG;YACW,YAAY;CA2B3B"}