@jamesaphoenix/tx-test-utils 0.4.2

package/dist/factories/candidate.factory.d.ts

@@ -0,0 +1,151 @@
+/**
+ * Candidate factory for creating test learning candidate data.
+ *
+ * Learning candidates are potential learnings extracted from transcripts
+ * that await promotion to the learnings table.
+ *
+ * @module @tx/test-utils/factories/candidate
+ */
+import type { TestDatabase } from "../database/index.js";
+/**
+ * Confidence level for a learning candidate.
+ */
+export type CandidateConfidence = "high" | "medium" | "low";
+/**
+ * Status of a learning candidate.
+ */
+export type CandidateStatus = "pending" | "promoted" | "rejected" | "merged";
+/**
+ * Learning candidate entity.
+ * Represents a potential learning extracted from a transcript.
+ */
+export interface LearningCandidate {
+    readonly id: number;
+    readonly content: string;
+    readonly confidence: CandidateConfidence;
+    readonly category: string | null;
+    readonly sourceFile: string;
+    readonly sourceRunId: string | null;
+    readonly sourceTaskId: string | null;
+    readonly extractedAt: Date;
+    readonly status: CandidateStatus;
+    readonly reviewedAt: Date | null;
+    readonly reviewedBy: string | null;
+    readonly promotedLearningId: number | null;
+    readonly rejectionReason: string | null;
+}
+/**
+ * Options for creating a test learning candidate.
+ */
+export interface CreateCandidateOptions {
+    /** Candidate ID (auto-generated if not provided) */
+    id?: number;
+    /** The extracted learning content */
+    content?: string;
+    /** Confidence level (high, medium, low) */
+    confidence?: CandidateConfidence;
+    /** Category of the learning */
+    category?: string | null;
+    /** Source JSONL file path */
+    sourceFile?: string;
+    /** Source run ID */
+    sourceRunId?: string | null;
+    /** Source task ID */
+    sourceTaskId?: string | null;
+    /** Extraction timestamp */
+    extractedAt?: Date;
+    /** Candidate status */
+    status?: CandidateStatus;
+    /** Review timestamp */
+    reviewedAt?: Date | null;
+    /** Reviewer identifier ('auto' or user ID) */
+    reviewedBy?: string | null;
+    /** ID of the promoted learning (if promoted) */
+    promotedLearningId?: number | null;
+    /** Reason for rejection (if rejected) */
+    rejectionReason?: string | null;
+}
+/**
+ * Factory class for creating test learning candidates.
+ *
+ * @example
+ * ```typescript
+ * const db = await Effect.runPromise(createTestDatabase())
+ * const factory = new CandidateFactory(db)
+ *
+ * // Create high-confidence candidate (will be auto-promoted)
+ * const high = factory.highConfidence({ content: 'Always use Effect-TS' })
+ *
+ * // Create pending candidate for review
+ * const pending = factory.pending({ content: 'Consider using Effect-TS' })
+ *
+ * // Create promoted candidate
+ * const promoted = factory.promoted({ content: 'Use Effect-TS', promotedLearningId: 1 })
+ * ```
+ */
+export declare class CandidateFactory {
+    private counter;
+    private readonly db;
+    constructor(db: TestDatabase);
+    /**
+     * Create a single test learning candidate.
+     */
+    create(options?: CreateCandidateOptions): LearningCandidate;
+    /**
+     * Create multiple test candidates.
+     */
+    createMany(count: number, options?: CreateCandidateOptions): LearningCandidate[];
+    /**
+     * Create a high-confidence candidate (ready for auto-promotion).
+     */
+    highConfidence(options?: CreateCandidateOptions): LearningCandidate;
+    /**
+     * Create a medium-confidence candidate (needs review).
+     */
+    mediumConfidence(options?: CreateCandidateOptions): LearningCandidate;
+    /**
+     * Create a low-confidence candidate (needs review).
+     */
+    lowConfidence(options?: CreateCandidateOptions): LearningCandidate;
+    /**
+     * Create a pending candidate awaiting review.
+     */
+    pending(options?: CreateCandidateOptions): LearningCandidate;
+    /**
+     * Create a promoted candidate.
+     */
+    promoted(options: CreateCandidateOptions & {
+        promotedLearningId: number;
+    }): LearningCandidate;
+    /**
+     * Create a rejected candidate.
+     */
+    rejected(rejectionReason: string, options?: CreateCandidateOptions): LearningCandidate;
+    /**
+     * Create a merged candidate (merged with existing learning).
+     */
+    merged(existingLearningId: number, options?: CreateCandidateOptions): LearningCandidate;
+    /**
+     * Create a candidate from a specific source.
+     */
+    fromSource(sourceFile: string, sourceRunId?: string | null, sourceTaskId?: string | null, options?: CreateCandidateOptions): LearningCandidate;
+    /**
+     * Reset the internal counter.
+     */
+    reset(): void;
+}
+/**
+ * Create a single test learning candidate (convenience function).
+ *
+ * @example
+ * ```typescript
+ * const db = await Effect.runPromise(createTestDatabase())
+ * const candidate = createTestCandidate(db, {
+ *   content: 'Always validate user input',
+ *   confidence: 'high',
+ *   category: 'security'
+ * })
+ * ```
+ */
+export declare const createTestCandidate: (db: TestDatabase, options?: CreateCandidateOptions) => LearningCandidate;
+//# sourceMappingURL=candidate.factory.d.ts.map

package/dist/factories/candidate.factory.d.ts.map

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

package/dist/factories/candidate.factory.js

@@ -0,0 +1,194 @@
+/**
+ * Candidate factory for creating test learning candidate data.
+ *
+ * Learning candidates are potential learnings extracted from transcripts
+ * that await promotion to the learnings table.
+ *
+ * @module @tx/test-utils/factories/candidate
+ */
+/**
+ * Factory class for creating test learning candidates.
+ *
+ * @example
+ * ```typescript
+ * const db = await Effect.runPromise(createTestDatabase())
+ * const factory = new CandidateFactory(db)
+ *
+ * // Create high-confidence candidate (will be auto-promoted)
+ * const high = factory.highConfidence({ content: 'Always use Effect-TS' })
+ *
+ * // Create pending candidate for review
+ * const pending = factory.pending({ content: 'Consider using Effect-TS' })
+ *
+ * // Create promoted candidate
+ * const promoted = factory.promoted({ content: 'Use Effect-TS', promotedLearningId: 1 })
+ * ```
+ */
+export class CandidateFactory {
+    counter = 0;
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    /**
+     * Create a single test learning candidate.
+     */
+    create(options = {}) {
+        this.counter++;
+        const now = new Date();
+        const id = options.id ?? this.counter;
+        const content = options.content ?? `Test candidate learning ${this.counter}`;
+        const confidence = options.confidence ?? "medium";
+        const category = options.category ?? null;
+        const sourceFile = options.sourceFile ?? `~/.claude/projects/test/session-${this.counter}.jsonl`;
+        const sourceRunId = options.sourceRunId ?? null;
+        const sourceTaskId = options.sourceTaskId ?? null;
+        const extractedAt = options.extractedAt ?? now;
+        const status = options.status ?? "pending";
+        const reviewedAt = options.reviewedAt ?? null;
+        const reviewedBy = options.reviewedBy ?? null;
+        const promotedLearningId = options.promotedLearningId ?? null;
+        const rejectionReason = options.rejectionReason ?? null;
+        this.db.run(`INSERT INTO learning_candidates (id, content, confidence, category, source_file, source_run_id, source_task_id, extracted_at, status, reviewed_at, reviewed_by, promoted_learning_id, rejection_reason)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, [
+            id,
+            content,
+            confidence,
+            category,
+            sourceFile,
+            sourceRunId,
+            sourceTaskId,
+            extractedAt.toISOString(),
+            status,
+            reviewedAt ? reviewedAt.toISOString() : null,
+            reviewedBy,
+            promotedLearningId,
+            rejectionReason
+        ]);
+        return {
+            id,
+            content,
+            confidence,
+            category,
+            sourceFile,
+            sourceRunId,
+            sourceTaskId,
+            extractedAt,
+            status,
+            reviewedAt,
+            reviewedBy,
+            promotedLearningId,
+            rejectionReason
+        };
+    }
+    /**
+     * Create multiple test candidates.
+     */
+    createMany(count, options = {}) {
+        const candidates = [];
+        for (let i = 0; i < count; i++) {
+            candidates.push(this.create({
+                ...options,
+                content: options.content ? `${options.content} ${i + 1}` : undefined
+            }));
+        }
+        return candidates;
+    }
+    /**
+     * Create a high-confidence candidate (ready for auto-promotion).
+     */
+    highConfidence(options = {}) {
+        return this.create({ ...options, confidence: "high" });
+    }
+    /**
+     * Create a medium-confidence candidate (needs review).
+     */
+    mediumConfidence(options = {}) {
+        return this.create({ ...options, confidence: "medium" });
+    }
+    /**
+     * Create a low-confidence candidate (needs review).
+     */
+    lowConfidence(options = {}) {
+        return this.create({ ...options, confidence: "low" });
+    }
+    /**
+     * Create a pending candidate awaiting review.
+     */
+    pending(options = {}) {
+        return this.create({ ...options, status: "pending" });
+    }
+    /**
+     * Create a promoted candidate.
+     */
+    promoted(options) {
+        const now = new Date();
+        return this.create({
+            ...options,
+            status: "promoted",
+            reviewedAt: options.reviewedAt ?? now,
+            reviewedBy: options.reviewedBy ?? "auto"
+        });
+    }
+    /**
+     * Create a rejected candidate.
+     */
+    rejected(rejectionReason, options = {}) {
+        const now = new Date();
+        return this.create({
+            ...options,
+            status: "rejected",
+            rejectionReason,
+            reviewedAt: options.reviewedAt ?? now,
+            reviewedBy: options.reviewedBy ?? "manual"
+        });
+    }
+    /**
+     * Create a merged candidate (merged with existing learning).
+     */
+    merged(existingLearningId, options = {}) {
+        const now = new Date();
+        return this.create({
+            ...options,
+            status: "merged",
+            promotedLearningId: existingLearningId,
+            reviewedAt: options.reviewedAt ?? now,
+            reviewedBy: options.reviewedBy ?? "auto"
+        });
+    }
+    /**
+     * Create a candidate from a specific source.
+     */
+    fromSource(sourceFile, sourceRunId = null, sourceTaskId = null, options = {}) {
+        return this.create({
+            ...options,
+            sourceFile,
+            sourceRunId,
+            sourceTaskId
+        });
+    }
+    /**
+     * Reset the internal counter.
+     */
+    reset() {
+        this.counter = 0;
+    }
+}
+/**
+ * Create a single test learning candidate (convenience function).
+ *
+ * @example
+ * ```typescript
+ * const db = await Effect.runPromise(createTestDatabase())
+ * const candidate = createTestCandidate(db, {
+ *   content: 'Always validate user input',
+ *   confidence: 'high',
+ *   category: 'security'
+ * })
+ * ```
+ */
+export const createTestCandidate = (db, options = {}) => {
+    const factory = new CandidateFactory(db);
+    return factory.create(options);
+};
+//# sourceMappingURL=candidate.factory.js.map

package/dist/factories/candidate.factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"candidate.factory.js","sourceRoot":"","sources":["../../src/factories/candidate.factory.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAkEH;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,OAAO,gBAAgB;IACnB,OAAO,GAAG,CAAC,CAAA;IACF,EAAE,CAAc;IAEjC,YAAY,EAAgB;QAC1B,IAAI,CAAC,EAAE,GAAG,EAAE,CAAA;IACd,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,UAAkC,EAAE;QACzC,IAAI,CAAC,OAAO,EAAE,CAAA;QACd,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAA;QAEtB,MAAM,EAAE,GAAG,OAAO,CAAC,EAAE,IAAI,IAAI,CAAC,OAAO,CAAA;QACrC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,2BAA2B,IAAI,CAAC,OAAO,EAAE,CAAA;QAC5E,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,QAAQ,CAAA;QACjD,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,IAAI,CAAA;QACzC,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,mCAAmC,IAAI,CAAC,OAAO,QAAQ,CAAA;QAChG,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,IAAI,CAAA;QAC/C,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,IAAI,CAAA;QACjD,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,GAAG,CAAA;QAC9C,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,SAAS,CAAA;QAC1C,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,IAAI,CAAA;QAC7C,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,IAAI,CAAA;QAC7C,MAAM,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,IAAI,IAAI,CAAA;QAC7D,MAAM,eAAe,GAAG,OAAO,CAAC,eAAe,IAAI,IAAI,CAAA;QAEvD,IAAI,CAAC,EAAE,CAAC,GAAG,CACT;sDACgD,EAChD;YACE,EAAE;YACF,OAAO;YACP,UAAU;YACV,QAAQ;YACR,UAAU;YACV,WAAW;YACX,YAAY;YACZ,WAAW,CAAC,WAAW,EAAE;YACzB,MAAM;YACN,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI;YAC5C,UAAU;YACV,kBAAkB;YAClB,eAAe;SAChB,CACF,CAAA;QAED,OAAO;YACL,EAAE;YACF,OAAO;YACP,UAAU;YACV,QAAQ;YACR,UAAU;YACV,WAAW;YACX,YAAY;YACZ,WAAW;YACX,MAAM;YACN,UAAU;YACV,UAAU;YACV,kBAAkB;YAClB,eAAe;SAChB,CAAA;IACH,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,KAAa,EAAE,UAAkC,EAAE;QAC5D,MAAM,UAAU,GAAwB,EAAE,CAAA;QAC1C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;YAC/B,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;gBAC1B,GAAG,OAAO;gBACV,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS;aACrE,CAAC,CAAC,CAAA;QACL,CAAC;QACD,OAAO,UAAU,CAAA;IACnB,CAAC;IAED;;OAEG;IACH,cAAc,CAAC,UAAkC,EAAE;QACjD,OAAO,IAAI,CAAC,MAAM,CAAC,EAAE,GAAG,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,CAAA;IACxD,CAAC;IAED;;OAEG;IACH,gBAAgB,CAAC,UAAkC,EAAE;QACnD,OAAO,IAAI,CAAC,MAAM,CAAC,EAAE,GAAG,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,CAAA;IAC1D,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,UAAkC,EAAE;QAChD,OAAO,IAAI,CAAC,MAAM,CAAC,EAAE,GAAG,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAA;IACvD,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,UAAkC,EAAE;QAC1C,OAAO,IAAI,CAAC,MAAM,CAAC,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAA;IACvD,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,OAAgE;QACvE,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAA;QACtB,OAAO,IAAI,CAAC,MAAM,CAAC;YACjB,GAAG,OAAO;YACV,MAAM,EAAE,UAAU;YAClB,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,GAAG;YACrC,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,MAAM;SACzC,CAAC,CAAA;IACJ,CAAC;IAED;;OAEG;IACH,QAAQ,CACN,eAAuB,EACvB,UAAkC,EAAE;QAEpC,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAA;QACtB,OAAO,IAAI,CAAC,MAAM,CAAC;YACjB,GAAG,OAAO;YACV,MAAM,EAAE,UAAU;YAClB,eAAe;YACf,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,GAAG;YACrC,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,QAAQ;SAC3C,CAAC,CAAA;IACJ,CAAC;IAED;;OAEG;IACH,MAAM,CACJ,kBAA0B,EAC1B,UAAkC,EAAE;QAEpC,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAA;QACtB,OAAO,IAAI,CAAC,MAAM,CAAC;YACjB,GAAG,OAAO;YACV,MAAM,EAAE,QAAQ;YAChB,kBAAkB,EAAE,kBAAkB;YACtC,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,GAAG;YACrC,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,MAAM;SACzC,CAAC,CAAA;IACJ,CAAC;IAED;;OAEG;IACH,UAAU,CACR,UAAkB,EAClB,cAA6B,IAAI,EACjC,eAA8B,IAAI,EAClC,UAAkC,EAAE;QAEpC,OAAO,IAAI,CAAC,MAAM,CAAC;YACjB,GAAG,OAAO;YACV,UAAU;YACV,WAAW;YACX,YAAY;SACb,CAAC,CAAA;IACJ,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,OAAO,GAAG,CAAC,CAAA;IAClB,CAAC;CACF;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CACjC,EAAgB,EAChB,UAAkC,EAAE,EACjB,EAAE;IACrB,MAAM,OAAO,GAAG,IAAI,gBAAgB,CAAC,EAAE,CAAC,CAAA;IACxC,OAAO,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;AAChC,CAAC,CAAA"}

package/dist/factories/edge.factory.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Edge factory for creating test graph edge data.
+ *
+ * @module @tx/test-utils/factories/edge
+ */
+import type { Edge, EdgeType, NodeType } from "@jamesaphoenix/tx-types";
+import type { TestDatabase } from "../database/index.js";
+/**
+ * Options for creating a test edge.
+ */
+export interface CreateEdgeOptions {
+    /** Edge ID (auto-generated if not provided) */
+    id?: number;
+    /** Type of edge relationship */
+    edgeType?: EdgeType;
+    /** Source node type */
+    sourceType?: NodeType;
+    /** Source node ID */
+    sourceId?: string;
+    /** Target node type */
+    targetType?: NodeType;
+    /** Target node ID */
+    targetId?: string;
+    /** Edge weight (0-1) */
+    weight?: number;
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+    /** Creation timestamp */
+    createdAt?: Date;
+    /** Invalidation timestamp (null if active) */
+    invalidatedAt?: Date | null;
+}
+/**
+ * Factory class for creating test graph edges.
+ *
+ * @example
+ * ```typescript
+ * const db = await Effect.runPromise(createTestDatabase())
+ * const factory = new EdgeFactory(db)
+ *
+ * // Create edge between two learnings
+ * const edge = factory.betweenLearnings(1, 2, 'SIMILAR_TO', 0.85)
+ *
+ * // Create anchor edge from learning to file
+ * const anchor = factory.anchorToFile(1, 'src/service.ts')
+ *
+ * // Create custom edge
+ * const custom = factory.create({
+ *   edgeType: 'DERIVED_FROM',
+ *   sourceType: 'learning',
+ *   sourceId: '1',
+ *   targetType: 'run',
+ *   targetId: 'run-123'
+ * })
+ * ```
+ */
+export declare class EdgeFactory {
+    private counter;
+    private readonly db;
+    constructor(db: TestDatabase);
+    /**
+     * Create a single test edge.
+     */
+    create(options?: CreateEdgeOptions): Edge;
+    /**
+     * Create multiple test edges.
+     */
+    createMany(count: number, options?: CreateEdgeOptions): Edge[];
+    /**
+     * Create an edge between two learnings.
+     */
+    betweenLearnings(sourceId: number | string, targetId: number | string, edgeType?: EdgeType, weight?: number): Edge;
+    /**
+     * Create an anchor edge from learning to file.
+     */
+    anchorToFile(learningId: number | string, filePath: string, weight?: number): Edge;
+    /**
+     * Create a derivation edge from learning to run.
+     */
+    derivedFromRun(learningId: number | string, runId: string, weight?: number): Edge;
+    /**
+     * Create a usage edge from learning to run.
+     */
+    usedInRun(learningId: number | string, runId: string, weight?: number): Edge;
+    /**
+     * Create an invalidation edge.
+     */
+    invalidatedBy(learningId: number | string, invalidatorId: number | string, weight?: number): Edge;
+    /**
+     * Reset the internal counter.
+     */
+    reset(): void;
+}
+/**
+ * Create a single test edge (convenience function).
+ *
+ * @example
+ * ```typescript
+ * const db = await Effect.runPromise(createTestDatabase())
+ * const edge = createTestEdge(db, {
+ *   edgeType: 'SIMILAR_TO',
+ *   sourceId: '1',
+ *   targetId: '2',
+ *   weight: 0.9
+ * })
+ * ```
+ */
+export declare const createTestEdge: (db: TestDatabase, options?: CreateEdgeOptions) => Edge;
+/**
+ * Create an edge between two learnings (convenience function).
+ *
+ * @example
+ * ```typescript
+ * const db = await Effect.runPromise(createTestDatabase())
+ * const edge = createEdgeBetweenLearnings(db, 1, 2, 'SIMILAR_TO', 0.85)
+ * ```
+ */
+export declare const createEdgeBetweenLearnings: (db: TestDatabase, sourceId: number | string, targetId: number | string, edgeType?: EdgeType, weight?: number) => Edge;
+//# sourceMappingURL=edge.factory.d.ts.map

package/dist/factories/edge.factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"edge.factory.d.ts","sourceRoot":"","sources":["../../src/factories/edge.factory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,IAAI,EAEJ,QAAQ,EACR,QAAQ,EACT,MAAM,yBAAyB,CAAA;AAChC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAExD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,+CAA+C;IAC/C,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,gCAAgC;IAChC,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB,uBAAuB;IACvB,UAAU,CAAC,EAAE,QAAQ,CAAA;IACrB,qBAAqB;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,uBAAuB;IACvB,UAAU,CAAC,EAAE,QAAQ,CAAA;IACrB,qBAAqB;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,wBAAwB;IACxB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAClC,yBAAyB;IACzB,SAAS,CAAC,EAAE,IAAI,CAAA;IAChB,8CAA8C;IAC9C,aAAa,CAAC,EAAE,IAAI,GAAG,IAAI,CAAA;CAC5B;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,OAAO,CAAI;IACnB,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAc;gBAErB,EAAE,EAAE,YAAY;IAI5B;;OAEG;IACH,MAAM,CAAC,OAAO,GAAE,iBAAsB,GAAG,IAAI;IA8C7C;;OAEG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,iBAAsB,GAAG,IAAI,EAAE;IAQlE;;OAEG;IACH,gBAAgB,CACd,QAAQ,EAAE,MAAM,GAAG,MAAM,EACzB,QAAQ,EAAE,MAAM,GAAG,MAAM,EACzB,QAAQ,GAAE,QAAuB,EACjC,MAAM,SAAM,GACX,IAAI;IAWP;;OAEG;IACH,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,SAAM,GAAG,IAAI;IAW/E;;OAEG;IACH,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,SAAM,GAAG,IAAI;IAW9E;;OAEG;IACH,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,SAAM,GAAG,IAAI;IAWzE;;OAEG;IACH,aAAa,CACX,UAAU,EAAE,MAAM,GAAG,MAAM,EAC3B,aAAa,EAAE,MAAM,GAAG,MAAM,EAC9B,MAAM,SAAM,GACX,IAAI;IAWP;;OAEG;IACH,KAAK,IAAI,IAAI;CAGd;AAED;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,cAAc,GACzB,IAAI,YAAY,EAChB,UAAS,iBAAsB,KAC9B,IAGF,CAAA;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,0BAA0B,GACrC,IAAI,YAAY,EAChB,UAAU,MAAM,GAAG,MAAM,EACzB,UAAU,MAAM,GAAG,MAAM,EACzB,WAAU,QAAuB,EACjC,eAAY,KACX,IAGF,CAAA"}

package/dist/factories/edge.factory.js

@@ -0,0 +1,191 @@
+/**
+ * Edge factory for creating test graph edge data.
+ *
+ * @module @tx/test-utils/factories/edge
+ */
+/**
+ * Factory class for creating test graph edges.
+ *
+ * @example
+ * ```typescript
+ * const db = await Effect.runPromise(createTestDatabase())
+ * const factory = new EdgeFactory(db)
+ *
+ * // Create edge between two learnings
+ * const edge = factory.betweenLearnings(1, 2, 'SIMILAR_TO', 0.85)
+ *
+ * // Create anchor edge from learning to file
+ * const anchor = factory.anchorToFile(1, 'src/service.ts')
+ *
+ * // Create custom edge
+ * const custom = factory.create({
+ *   edgeType: 'DERIVED_FROM',
+ *   sourceType: 'learning',
+ *   sourceId: '1',
+ *   targetType: 'run',
+ *   targetId: 'run-123'
+ * })
+ * ```
+ */
+export class EdgeFactory {
+    counter = 0;
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    /**
+     * Create a single test edge.
+     */
+    create(options = {}) {
+        this.counter++;
+        const now = new Date();
+        const id = options.id ?? this.counter;
+        const edgeType = options.edgeType ?? "SIMILAR_TO";
+        const sourceType = options.sourceType ?? "learning";
+        const sourceId = options.sourceId ?? String(this.counter);
+        const targetType = options.targetType ?? "learning";
+        const targetId = options.targetId ?? String(this.counter + 1);
+        const weight = options.weight ?? 1.0;
+        const metadata = options.metadata ?? {};
+        const createdAt = options.createdAt ?? now;
+        const invalidatedAt = options.invalidatedAt ?? null;
+        this.db.run(`INSERT INTO learning_edges (id, edge_type, source_type, source_id, target_type, target_id, weight, metadata, created_at, invalidated_at)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, [
+            id,
+            edgeType,
+            sourceType,
+            sourceId,
+            targetType,
+            targetId,
+            weight,
+            JSON.stringify(metadata),
+            createdAt.toISOString(),
+            invalidatedAt ? invalidatedAt.toISOString() : null
+        ]);
+        return {
+            id: id,
+            edgeType,
+            sourceType,
+            sourceId,
+            targetType,
+            targetId,
+            weight,
+            metadata,
+            createdAt,
+            invalidatedAt
+        };
+    }
+    /**
+     * Create multiple test edges.
+     */
+    createMany(count, options = {}) {
+        const edges = [];
+        for (let i = 0; i < count; i++) {
+            edges.push(this.create(options));
+        }
+        return edges;
+    }
+    /**
+     * Create an edge between two learnings.
+     */
+    betweenLearnings(sourceId, targetId, edgeType = "SIMILAR_TO", weight = 1.0) {
+        return this.create({
+            edgeType,
+            sourceType: "learning",
+            sourceId: String(sourceId),
+            targetType: "learning",
+            targetId: String(targetId),
+            weight
+        });
+    }
+    /**
+     * Create an anchor edge from learning to file.
+     */
+    anchorToFile(learningId, filePath, weight = 1.0) {
+        return this.create({
+            edgeType: "ANCHORED_TO",
+            sourceType: "learning",
+            sourceId: String(learningId),
+            targetType: "file",
+            targetId: filePath,
+            weight
+        });
+    }
+    /**
+     * Create a derivation edge from learning to run.
+     */
+    derivedFromRun(learningId, runId, weight = 1.0) {
+        return this.create({
+            edgeType: "DERIVED_FROM",
+            sourceType: "learning",
+            sourceId: String(learningId),
+            targetType: "run",
+            targetId: runId,
+            weight
+        });
+    }
+    /**
+     * Create a usage edge from learning to run.
+     */
+    usedInRun(learningId, runId, weight = 1.0) {
+        return this.create({
+            edgeType: "USED_IN_RUN",
+            sourceType: "learning",
+            sourceId: String(learningId),
+            targetType: "run",
+            targetId: runId,
+            weight
+        });
+    }
+    /**
+     * Create an invalidation edge.
+     */
+    invalidatedBy(learningId, invalidatorId, weight = 1.0) {
+        return this.create({
+            edgeType: "INVALIDATED_BY",
+            sourceType: "learning",
+            sourceId: String(learningId),
+            targetType: "learning",
+            targetId: String(invalidatorId),
+            weight
+        });
+    }
+    /**
+     * Reset the internal counter.
+     */
+    reset() {
+        this.counter = 0;
+    }
+}
+/**
+ * Create a single test edge (convenience function).
+ *
+ * @example
+ * ```typescript
+ * const db = await Effect.runPromise(createTestDatabase())
+ * const edge = createTestEdge(db, {
+ *   edgeType: 'SIMILAR_TO',
+ *   sourceId: '1',
+ *   targetId: '2',
+ *   weight: 0.9
+ * })
+ * ```
+ */
+export const createTestEdge = (db, options = {}) => {
+    const factory = new EdgeFactory(db);
+    return factory.create(options);
+};
+/**
+ * Create an edge between two learnings (convenience function).
+ *
+ * @example
+ * ```typescript
+ * const db = await Effect.runPromise(createTestDatabase())
+ * const edge = createEdgeBetweenLearnings(db, 1, 2, 'SIMILAR_TO', 0.85)
+ * ```
+ */
+export const createEdgeBetweenLearnings = (db, sourceId, targetId, edgeType = "SIMILAR_TO", weight = 1.0) => {
+    const factory = new EdgeFactory(db);
+    return factory.betweenLearnings(sourceId, targetId, edgeType, weight);
+};
+//# sourceMappingURL=edge.factory.js.map

package/dist/factories/edge.factory.js.map

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