paths-engine 0.0.0-stage → 0.1.0

package/dist/core/ingestion/generic-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generic-adapter.js","sourceRoot":"","sources":["../../../src/core/ingestion/generic-adapter.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,cAAc;IACzB,MAAM,CAAC,SAAS,CAAC,KAA0B;QACzC,IAAI,CAAC,KAAK,CAAC,eAAe,IAAI,KAAK,CAAC,eAAe,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxE,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;QACxD,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,YAAY,IAAI,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAClE,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;QACpD,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,UAAU,IAAI,KAAK,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9D,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;QACjD,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}

package/dist/core/ingestion/git-adapter.d.ts

@@ -0,0 +1,12 @@
+import { IngestionEventInput } from './types.js';
+export interface GitCommitInput {
+    hash: string;
+    message: string;
+    author?: string;
+    authorDate?: string;
+    filesTouched?: string[];
+}
+export declare class GitAdapter {
+    static normalizeCommit(projectId: number, lineageId: number, commit: GitCommitInput): IngestionEventInput;
+}
+//# sourceMappingURL=git-adapter.d.ts.map

package/dist/core/ingestion/git-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-adapter.d.ts","sourceRoot":"","sources":["../../../src/core/ingestion/git-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEjD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,qBAAa,UAAU;IACrB,MAAM,CAAC,eAAe,CACpB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,cAAc,GACrB,mBAAmB;CA8BvB"}

package/dist/core/ingestion/git-adapter.js

@@ -0,0 +1,31 @@
+export class GitAdapter {
+    static normalizeCommit(projectId, lineageId, commit) {
+        const summary = commit.message.trim();
+        if (summary.length === 0) {
+            throw new Error('Git commit message cannot be empty.');
+        }
+        const occurredAt = commit.authorDate ?? new Date().toISOString();
+        return {
+            projectId,
+            sourceSystem: 'git',
+            externalEventId: commit.hash,
+            eventType: 'commit',
+            sourceRecord: {
+                hash: commit.hash,
+                message: commit.message,
+                author: commit.author ?? null,
+                authorDate: commit.authorDate ?? null,
+                filesTouched: commit.filesTouched ?? [],
+            },
+            occurredAt,
+            targetCanonicalType: 'node',
+            nodePayload: {
+                lineageId,
+                summary,
+                filesTouched: commit.filesTouched,
+                tool: 'git',
+            },
+        };
+    }
+}
+//# sourceMappingURL=git-adapter.js.map

package/dist/core/ingestion/git-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-adapter.js","sourceRoot":"","sources":["../../../src/core/ingestion/git-adapter.ts"],"names":[],"mappings":"AAUA,MAAM,OAAO,UAAU;IACrB,MAAM,CAAC,eAAe,CACpB,SAAiB,EACjB,SAAiB,EACjB,MAAsB;QAEtB,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QACtC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;QACzD,CAAC;QAED,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAEjE,OAAO;YACL,SAAS;YACT,YAAY,EAAE,KAAK;YACnB,eAAe,EAAE,MAAM,CAAC,IAAI;YAC5B,SAAS,EAAE,QAAQ;YACnB,YAAY,EAAE;gBACZ,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,IAAI;gBAC7B,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,IAAI;gBACrC,YAAY,EAAE,MAAM,CAAC,YAAY,IAAI,EAAE;aACxC;YACD,UAAU;YACV,mBAAmB,EAAE,MAAM;YAC3B,WAAW,EAAE;gBACX,SAAS;gBACT,OAAO;gBACP,YAAY,EAAE,MAAM,CAAC,YAAY;gBACjC,IAAI,EAAE,KAAK;aACZ;SACF,CAAC;IACJ,CAAC;CACF"}

package/dist/core/ingestion/github-adapter.d.ts

@@ -0,0 +1,23 @@
+import { IngestionEventInput } from './types.js';
+export interface GitHubIssueInput {
+    id: string | number;
+    number?: number;
+    title: string;
+    body?: string;
+    url?: string;
+    createdAt: string;
+    lineageId?: number | null;
+}
+export interface GitHubPullRequestInput {
+    number: number;
+    title: string;
+    url?: string;
+    mergedAt?: string;
+    author?: string;
+    changedFiles?: string[];
+}
+export declare class GitHubAdapter {
+    static normalizeIssue(projectId: number, issue: GitHubIssueInput): IngestionEventInput;
+    static normalizePullRequest(projectId: number, lineageId: number, pr: GitHubPullRequestInput): IngestionEventInput;
+}
+//# sourceMappingURL=github-adapter.d.ts.map

package/dist/core/ingestion/github-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-adapter.d.ts","sourceRoot":"","sources":["../../../src/core/ingestion/github-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEjD,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,qBAAa,aAAa;IACxB,MAAM,CAAC,cAAc,CACnB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,gBAAgB,GACtB,mBAAmB;IA4BtB,MAAM,CAAC,oBAAoB,CACzB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,EAAE,EAAE,sBAAsB,GACzB,mBAAmB;CA2BvB"}

package/dist/core/ingestion/github-adapter.js

@@ -0,0 +1,55 @@
+export class GitHubAdapter {
+    static normalizeIssue(projectId, issue) {
+        const text = issue.title.trim();
+        if (text.length === 0) {
+            throw new Error('GitHub issue title cannot be empty.');
+        }
+        return {
+            projectId,
+            sourceSystem: 'github',
+            externalEventId: `issue-${issue.id}`,
+            eventType: 'issue',
+            sourceRecord: {
+                id: issue.id,
+                number: issue.number ?? null,
+                title: issue.title,
+                body: issue.body ?? null,
+                url: issue.url ?? null,
+                createdAt: issue.createdAt,
+            },
+            occurredAt: issue.createdAt,
+            targetCanonicalType: 'todo',
+            todoPayload: {
+                text,
+                lineageId: issue.lineageId ?? null,
+            },
+        };
+    }
+    static normalizePullRequest(projectId, lineageId, pr) {
+        const summary = `PR #${pr.number}: ${pr.title.trim()}`;
+        const occurredAt = pr.mergedAt ?? new Date().toISOString();
+        return {
+            projectId,
+            sourceSystem: 'github',
+            externalEventId: `pr-${pr.number}`,
+            eventType: 'commit',
+            sourceRecord: {
+                number: pr.number,
+                title: pr.title,
+                url: pr.url ?? null,
+                mergedAt: pr.mergedAt ?? null,
+                author: pr.author ?? null,
+                changedFiles: pr.changedFiles ?? [],
+            },
+            occurredAt,
+            targetCanonicalType: 'node',
+            nodePayload: {
+                lineageId,
+                summary,
+                filesTouched: pr.changedFiles,
+                tool: 'github',
+            },
+        };
+    }
+}
+//# sourceMappingURL=github-adapter.js.map

package/dist/core/ingestion/github-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-adapter.js","sourceRoot":"","sources":["../../../src/core/ingestion/github-adapter.ts"],"names":[],"mappings":"AAqBA,MAAM,OAAO,aAAa;IACxB,MAAM,CAAC,cAAc,CACnB,SAAiB,EACjB,KAAuB;QAEvB,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QAChC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;QACzD,CAAC;QAED,OAAO;YACL,SAAS;YACT,YAAY,EAAE,QAAQ;YACtB,eAAe,EAAE,SAAS,KAAK,CAAC,EAAE,EAAE;YACpC,SAAS,EAAE,OAAO;YAClB,YAAY,EAAE;gBACZ,EAAE,EAAE,KAAK,CAAC,EAAE;gBACZ,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,IAAI;gBAC5B,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,IAAI;gBACxB,GAAG,EAAE,KAAK,CAAC,GAAG,IAAI,IAAI;gBACtB,SAAS,EAAE,KAAK,CAAC,SAAS;aAC3B;YACD,UAAU,EAAE,KAAK,CAAC,SAAS;YAC3B,mBAAmB,EAAE,MAAM;YAC3B,WAAW,EAAE;gBACX,IAAI;gBACJ,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,IAAI;aACnC;SACF,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,oBAAoB,CACzB,SAAiB,EACjB,SAAiB,EACjB,EAA0B;QAE1B,MAAM,OAAO,GAAG,OAAO,EAAE,CAAC,MAAM,KAAK,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;QACvD,MAAM,UAAU,GAAG,EAAE,CAAC,QAAQ,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAE3D,OAAO;YACL,SAAS;YACT,YAAY,EAAE,QAAQ;YACtB,eAAe,EAAE,MAAM,EAAE,CAAC,MAAM,EAAE;YAClC,SAAS,EAAE,QAAQ;YACnB,YAAY,EAAE;gBACZ,MAAM,EAAE,EAAE,CAAC,MAAM;gBACjB,KAAK,EAAE,EAAE,CAAC,KAAK;gBACf,GAAG,EAAE,EAAE,CAAC,GAAG,IAAI,IAAI;gBACnB,QAAQ,EAAE,EAAE,CAAC,QAAQ,IAAI,IAAI;gBAC7B,MAAM,EAAE,EAAE,CAAC,MAAM,IAAI,IAAI;gBACzB,YAAY,EAAE,EAAE,CAAC,YAAY,IAAI,EAAE;aACpC;YACD,UAAU;YACV,mBAAmB,EAAE,MAAM;YAC3B,WAAW,EAAE;gBACX,SAAS;gBACT,OAAO;gBACP,YAAY,EAAE,EAAE,CAAC,YAAY;gBAC7B,IAAI,EAAE,QAAQ;aACf;SACF,CAAC;IACJ,CAAC;CACF"}

package/dist/core/ingestion/index.d.ts

@@ -0,0 +1,6 @@
+export { IngestionService } from './ingestion.service.js';
+export { GitAdapter, GitCommitInput } from './git-adapter.js';
+export { GitHubAdapter, GitHubIssueInput, GitHubPullRequestInput, } from './github-adapter.js';
+export { GenericAdapter } from './generic-adapter.js';
+export * from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/ingestion/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/ingestion/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,cAAc,YAAY,CAAC"}

package/dist/core/ingestion/index.js

@@ -0,0 +1,6 @@
+export { IngestionService } from './ingestion.service.js';
+export { GitAdapter } from './git-adapter.js';
+export { GitHubAdapter, } from './github-adapter.js';
+export { GenericAdapter } from './generic-adapter.js';
+export * from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/core/ingestion/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/ingestion/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAkB,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EACL,aAAa,GAGd,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,cAAc,YAAY,CAAC"}

package/dist/core/ingestion/ingestion.service.d.ts

@@ -0,0 +1,25 @@
+import { Store } from '../db/store.js';
+import { ExternalEventRepository } from '../db/external-event-repository.js';
+import { NodeRepository } from '../db/node-repository.js';
+import { LineageRepository } from '../db/lineage-repository.js';
+import { TodoRepository } from '../db/todo-repository.js';
+import { KnowledgeRepository } from '../db/knowledge-repository.js';
+import { ExternalEvent } from '../types/external-event.js';
+import { IngestionEventInput, IngestionResult } from './types.js';
+export declare class IngestionService {
+    private readonly store;
+    private readonly eventRepo;
+    private readonly nodeRepo;
+    private readonly lineageRepo;
+    private readonly todoRepo;
+    private readonly knowledgeRepo;
+    constructor(store: Store, eventRepo: ExternalEventRepository, nodeRepo: NodeRepository, lineageRepo: LineageRepository, todoRepo: TodoRepository, knowledgeRepo: KnowledgeRepository);
+    ingestEvent(event: IngestionEventInput): IngestionResult;
+    getEventHistory(projectId: number): ExternalEvent[];
+    private createCanonicalEntity;
+    private validateLineage;
+    private createCanonicalNode;
+    private createCanonicalTodo;
+    private createCanonicalKnowledge;
+}
+//# sourceMappingURL=ingestion.service.d.ts.map

package/dist/core/ingestion/ingestion.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ingestion.service.d.ts","sourceRoot":"","sources":["../../../src/core/ingestion/ingestion.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvC,OAAO,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAC;AAC7E,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAE3D,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AASlE,qBAAa,gBAAgB;IAEzB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,aAAa;gBALb,KAAK,EAAE,KAAK,EACZ,SAAS,EAAE,uBAAuB,EAClC,QAAQ,EAAE,cAAc,EACxB,WAAW,EAAE,iBAAiB,EAC9B,QAAQ,EAAE,cAAc,EACxB,aAAa,EAAE,mBAAmB;IAGrD,WAAW,CAAC,KAAK,EAAE,mBAAmB,GAAG,eAAe;IA6CxD,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,EAAE;IAInD,OAAO,CAAC,qBAAqB;IAgB7B,OAAO,CAAC,eAAe;IAWvB,OAAO,CAAC,mBAAmB;IAwB3B,OAAO,CAAC,mBAAmB;IAkB3B,OAAO,CAAC,wBAAwB;CAmBjC"}

package/dist/core/ingestion/ingestion.service.js

@@ -0,0 +1,109 @@
+function serializeSourceRecord(sourceRecord) {
+    if (typeof sourceRecord === 'string') {
+        return sourceRecord;
+    }
+    return JSON.stringify(sourceRecord);
+}
+export class IngestionService {
+    store;
+    eventRepo;
+    nodeRepo;
+    lineageRepo;
+    todoRepo;
+    knowledgeRepo;
+    constructor(store, eventRepo, nodeRepo, lineageRepo, todoRepo, knowledgeRepo) {
+        this.store = store;
+        this.eventRepo = eventRepo;
+        this.nodeRepo = nodeRepo;
+        this.lineageRepo = lineageRepo;
+        this.todoRepo = todoRepo;
+        this.knowledgeRepo = knowledgeRepo;
+    }
+    ingestEvent(event) {
+        return this.store.transaction(() => {
+            const existing = this.eventRepo.findByExternalId(event.projectId, event.sourceSystem, event.externalEventId);
+            if (existing) {
+                return {
+                    status: 'duplicate',
+                    eventId: existing.id,
+                    canonicalEntityType: existing.canonicalEntityType,
+                    canonicalEntityId: existing.canonicalEntityId,
+                };
+            }
+            const nowIso = new Date().toISOString();
+            const createdEvent = this.eventRepo.createEvent({
+                projectId: event.projectId,
+                externalEventId: event.externalEventId,
+                sourceSystem: event.sourceSystem,
+                eventType: event.eventType,
+                sourceRecord: serializeSourceRecord(event.sourceRecord),
+                occurredAt: event.occurredAt,
+                ingestedAt: nowIso,
+                createdAt: nowIso,
+                canonicalEntityType: null,
+                canonicalEntityId: null,
+            });
+            const { entityType, entityId } = this.createCanonicalEntity(event);
+            if (entityType && entityId !== null) {
+                this.eventRepo.linkCanonical(createdEvent.id, entityType, entityId);
+            }
+            return {
+                status: 'ingested',
+                eventId: createdEvent.id,
+                canonicalEntityType: entityType,
+                canonicalEntityId: entityId,
+            };
+        });
+    }
+    getEventHistory(projectId) {
+        return this.eventRepo.listByProject(projectId);
+    }
+    createCanonicalEntity(event) {
+        switch (event.targetCanonicalType) {
+            case 'node':
+                return this.createCanonicalNode(event);
+            case 'todo':
+                return this.createCanonicalTodo(event);
+            case 'knowledge':
+                return this.createCanonicalKnowledge(event);
+            default:
+                return { entityType: null, entityId: null };
+        }
+    }
+    validateLineage(lineageId, projectId) {
+        const lineage = this.lineageRepo.findById(lineageId);
+        if (!lineage) {
+            throw new Error(`Lineage ${lineageId} does not exist.`);
+        }
+        if (lineage.projectId !== projectId) {
+            throw new Error(`Lineage ${lineageId} belongs to a different project.`);
+        }
+        return lineage;
+    }
+    createCanonicalNode(event) {
+        if (!event.nodePayload) {
+            throw new Error('Missing nodePayload for targetCanonicalType "node"');
+        }
+        const lineage = this.validateLineage(event.nodePayload.lineageId, event.projectId);
+        const latestNode = this.nodeRepo.findLatestByLineageId(lineage.id);
+        const parentNodeId = latestNode ? latestNode.id : null;
+        const tool = event.nodePayload.tool ?? (event.sourceSystem === 'git' ? 'git' : 'ingest');
+        const node = this.nodeRepo.createWithTouch(lineage.id, tool, event.nodePayload.summary, parentNodeId, event.nodePayload.filesTouched);
+        return { entityType: 'node', entityId: node.id };
+    }
+    createCanonicalTodo(event) {
+        if (!event.todoPayload) {
+            throw new Error('Missing todoPayload for targetCanonicalType "todo"');
+        }
+        const todo = this.todoRepo.create(event.projectId, event.todoPayload.text, event.todoPayload.lineageId, event.todoPayload.originNodeId);
+        return { entityType: 'todo', entityId: todo.id };
+    }
+    createCanonicalKnowledge(event) {
+        if (!event.knowledgePayload) {
+            throw new Error('Missing knowledgePayload for targetCanonicalType "knowledge"');
+        }
+        const knowledge = this.knowledgeRepo.createWithSupersede(event.projectId, event.knowledgePayload.category, event.knowledgePayload.fact, event.knowledgePayload.why, event.knowledgePayload.originNodeId ?? null, event.knowledgePayload.supersedesId ?? null);
+        return { entityType: 'knowledge', entityId: knowledge.id };
+    }
+}
+//# sourceMappingURL=ingestion.service.js.map

package/dist/core/ingestion/ingestion.service.js.map

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

package/dist/core/ingestion/types.d.ts

@@ -0,0 +1,38 @@
+import { SourceSystem, ExternalEventType } from '../types/external-event.js';
+export interface IngestionNodePayload {
+    lineageId: number;
+    summary: string;
+    filesTouched?: string[];
+    tool?: string;
+}
+export interface IngestionTodoPayload {
+    text: string;
+    lineageId?: number | null;
+    originNodeId?: number | null;
+}
+export interface IngestionKnowledgePayload {
+    category: string;
+    fact: string;
+    why: string;
+    originNodeId?: number | null;
+    supersedesId?: number | null;
+}
+export interface IngestionEventInput {
+    projectId: number;
+    sourceSystem: SourceSystem | string;
+    externalEventId: string;
+    eventType: ExternalEventType | string;
+    sourceRecord: Record<string, unknown> | string;
+    occurredAt: string;
+    targetCanonicalType?: 'node' | 'todo' | 'knowledge';
+    nodePayload?: IngestionNodePayload;
+    todoPayload?: IngestionTodoPayload;
+    knowledgePayload?: IngestionKnowledgePayload;
+}
+export interface IngestionResult {
+    status: 'ingested' | 'duplicate';
+    eventId: number;
+    canonicalEntityType: string | null;
+    canonicalEntityId: number | null;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/ingestion/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/ingestion/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAE7E,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,YAAY,GAAG,MAAM,CAAC;IACpC,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,iBAAiB,GAAG,MAAM,CAAC;IACtC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC;IAC/C,UAAU,EAAE,MAAM,CAAC;IACnB,mBAAmB,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,WAAW,CAAC;IACpD,WAAW,CAAC,EAAE,oBAAoB,CAAC;IACnC,WAAW,CAAC,EAAE,oBAAoB,CAAC;IACnC,gBAAgB,CAAC,EAAE,yBAAyB,CAAC;CAC9C;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,UAAU,GAAG,WAAW,CAAC;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC"}

package/dist/core/ingestion/types.js

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

package/dist/core/ingestion/types.js.map

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

package/dist/core/knowledge.d.ts

@@ -0,0 +1,13 @@
+import { KnowledgeRepository } from './db/knowledge-repository.js';
+import { KnowledgeConfirmationRepository } from './db/knowledge-confirmation-repository.js';
+import { LineageRepository } from './db/lineage-repository.js';
+import { NodeRepository } from './db/node-repository.js';
+import { Knowledge } from './types/knowledge.js';
+import { KnowledgeConfirmation } from './types/knowledge-confirmation.js';
+export declare function saveKnowledge(knowledgeRepo: KnowledgeRepository, lineageRepo: LineageRepository, nodeRepo: NodeRepository, projectId: number, category: string, fact: string, why: string, originNodeId?: number, supersedesId?: number): Knowledge;
+export declare function flagKnowledgeConflict(knowledgeRepo: KnowledgeRepository, projectId: number, id: number, reason: string): Knowledge;
+export declare function resolveKnowledgeConflict(knowledgeRepo: KnowledgeRepository, projectId: number, id: number, resolvedBy: string, resolutionKnowledgeId?: number): Knowledge;
+export declare function confirmKnowledge(knowledgeRepo: KnowledgeRepository, confirmationRepo: KnowledgeConfirmationRepository, nodeRepo: NodeRepository, lineageRepo: LineageRepository, projectId: number, id: number, originNodeId?: number, tool?: string): KnowledgeConfirmation;
+export declare function getActiveKnowledge(knowledgeRepo: KnowledgeRepository, projectId: number): Knowledge[];
+export declare function searchKnowledge(knowledgeRepo: KnowledgeRepository, projectId: number, query: string): Knowledge[];
+//# sourceMappingURL=knowledge.d.ts.map

package/dist/core/knowledge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge.d.ts","sourceRoot":"","sources":["../../src/core/knowledge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAAE,+BAA+B,EAAE,MAAM,2CAA2C,CAAC;AAC5F,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,SAAS,EAA2C,MAAM,sBAAsB,CAAC;AAC1F,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAsE1E,wBAAgB,aAAa,CAC3B,aAAa,EAAE,mBAAmB,EAClC,WAAW,EAAE,iBAAiB,EAC9B,QAAQ,EAAE,cAAc,EACxB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,EACX,YAAY,CAAC,EAAE,MAAM,EACrB,YAAY,CAAC,EAAE,MAAM,GACpB,SAAS,CA0BX;AAED,wBAAgB,qBAAqB,CACnC,aAAa,EAAE,mBAAmB,EAClC,SAAS,EAAE,MAAM,EACjB,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,MAAM,GACb,SAAS,CAeX;AAED,wBAAgB,wBAAwB,CACtC,aAAa,EAAE,mBAAmB,EAClC,SAAS,EAAE,MAAM,EACjB,EAAE,EAAE,MAAM,EACV,UAAU,EAAE,MAAM,EAClB,qBAAqB,CAAC,EAAE,MAAM,GAC7B,SAAS,CAmBX;AAED,wBAAgB,gBAAgB,CAC9B,aAAa,EAAE,mBAAmB,EAClC,gBAAgB,EAAE,+BAA+B,EACjD,QAAQ,EAAE,cAAc,EACxB,WAAW,EAAE,iBAAiB,EAC9B,SAAS,EAAE,MAAM,EACjB,EAAE,EAAE,MAAM,EACV,YAAY,CAAC,EAAE,MAAM,EACrB,IAAI,CAAC,EAAE,MAAM,GACZ,qBAAqB,CASvB;AAED,wBAAgB,kBAAkB,CAChC,aAAa,EAAE,mBAAmB,EAClC,SAAS,EAAE,MAAM,GAChB,SAAS,EAAE,CAEb;AAED,wBAAgB,eAAe,CAC7B,aAAa,EAAE,mBAAmB,EAClC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,GACZ,SAAS,EAAE,CAGb"}

package/dist/core/knowledge.js

@@ -0,0 +1,101 @@
+import { KNOWLEDGE_CATEGORIES } from './types/knowledge.js';
+function validateNonEmpty(value, errorMessage) {
+    const trimmed = value.trim();
+    if (trimmed.length === 0) {
+        throw new Error(errorMessage);
+    }
+    return trimmed;
+}
+function getKnowledgeInProject(knowledgeRepo, id, projectId, label = 'Knowledge') {
+    const item = knowledgeRepo.findById(id);
+    if (!item) {
+        throw new Error(`${label} ${id} does not exist.`);
+    }
+    if (item.projectId !== projectId) {
+        throw new Error(`${label} ${id} belongs to a different project.`);
+    }
+    return item;
+}
+function validateOriginNode(nodeRepo, lineageRepo, originNodeId, projectId) {
+    if (originNodeId === undefined) {
+        return;
+    }
+    const node = nodeRepo.findById(originNodeId);
+    if (!node) {
+        throw new Error(`Node ${originNodeId} does not exist.`);
+    }
+    const nodeLineage = lineageRepo.findById(node.lineageId);
+    if (!nodeLineage) {
+        throw new Error(`Lineage for node ${originNodeId} does not exist.`);
+    }
+    if (nodeLineage.projectId !== projectId) {
+        throw new Error(`Node ${originNodeId} belongs to a different project.`);
+    }
+}
+function validateReplacementKnowledge(knowledgeRepo, resolutionKnowledgeId, sourceId, projectId) {
+    if (resolutionKnowledgeId === sourceId) {
+        throw new Error(`Knowledge ${sourceId} cannot be resolved by itself.`);
+    }
+    const replacement = getKnowledgeInProject(knowledgeRepo, resolutionKnowledgeId, projectId, 'Resolution knowledge');
+    if (replacement.status !== 'active') {
+        throw new Error(`Resolution knowledge ${resolutionKnowledgeId} must be active (status is ${replacement.status}).`);
+    }
+}
+export function saveKnowledge(knowledgeRepo, lineageRepo, nodeRepo, projectId, category, fact, why, originNodeId, supersedesId) {
+    const trimmedFact = validateNonEmpty(fact, 'Knowledge fact cannot be empty.');
+    const trimmedWhy = validateNonEmpty(why, 'Knowledge why rationale cannot be empty.');
+    if (!KNOWLEDGE_CATEGORIES.includes(category)) {
+        const allowed = KNOWLEDGE_CATEGORIES.join(', ');
+        throw new Error(`Category must be one of ${allowed}.`);
+    }
+    validateOriginNode(nodeRepo, lineageRepo, originNodeId, projectId);
+    if (supersedesId !== undefined) {
+        const target = getKnowledgeInProject(knowledgeRepo, supersedesId, projectId);
+        if (target.status !== 'active') {
+            throw new Error(`Knowledge ${supersedesId} is already superseded.`);
+        }
+    }
+    return knowledgeRepo.createWithSupersede(projectId, category, trimmedFact, trimmedWhy, originNodeId ?? null, supersedesId ?? null);
+}
+export function flagKnowledgeConflict(knowledgeRepo, projectId, id, reason) {
+    const trimmedReason = validateNonEmpty(reason, 'Conflict reason cannot be empty.');
+    const target = getKnowledgeInProject(knowledgeRepo, id, projectId);
+    if (target.status === 'conflicted') {
+        throw new Error(`Knowledge ${id} is already conflicted.`);
+    }
+    if (target.status === 'superseded') {
+        throw new Error(`Knowledge ${id} is superseded and cannot be conflicted.`);
+    }
+    if (target.status !== 'active') {
+        throw new Error(`Knowledge ${id} must be active to be flagged as conflicted.`);
+    }
+    return knowledgeRepo.markConflicted(id, trimmedReason);
+}
+export function resolveKnowledgeConflict(knowledgeRepo, projectId, id, resolvedBy, resolutionKnowledgeId) {
+    const trimmedResolvedBy = validateNonEmpty(resolvedBy, 'ResolvedBy actor cannot be empty.');
+    const target = getKnowledgeInProject(knowledgeRepo, id, projectId);
+    if (target.status !== 'conflicted') {
+        throw new Error(`Knowledge ${id} is not in conflicted status.`);
+    }
+    if (resolutionKnowledgeId !== undefined) {
+        validateReplacementKnowledge(knowledgeRepo, resolutionKnowledgeId, id, projectId);
+        return knowledgeRepo.resolveConflict(id, trimmedResolvedBy, resolutionKnowledgeId, 'superseded');
+    }
+    return knowledgeRepo.resolveConflict(id, trimmedResolvedBy, null, 'active');
+}
+export function confirmKnowledge(knowledgeRepo, confirmationRepo, nodeRepo, lineageRepo, projectId, id, originNodeId, tool) {
+    const target = getKnowledgeInProject(knowledgeRepo, id, projectId);
+    if (target.status === 'superseded') {
+        throw new Error(`Knowledge ${id} is superseded and cannot be confirmed.`);
+    }
+    validateOriginNode(nodeRepo, lineageRepo, originNodeId, projectId);
+    return confirmationRepo.create(id, originNodeId ?? null, tool ?? null);
+}
+export function getActiveKnowledge(knowledgeRepo, projectId) {
+    return knowledgeRepo.findActiveByProjectId(projectId);
+}
+export function searchKnowledge(knowledgeRepo, projectId, query) {
+    const trimmedQuery = validateNonEmpty(query, 'Search query cannot be empty.');
+    return knowledgeRepo.searchByProjectId(projectId, trimmedQuery);
+}
+//# sourceMappingURL=knowledge.js.map

package/dist/core/knowledge.js.map

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

package/dist/core/lineage.d.ts

@@ -0,0 +1,11 @@
+import { LineageRepository } from './db/lineage-repository.js';
+import { NodeRepository } from './db/node-repository.js';
+import { Lineage, LineageSummary } from './types/lineage.js';
+export declare function createLineage(lineageRepo: LineageRepository, projectId: number, name: string): Lineage;
+export declare function getLineages(lineageRepo: LineageRepository, projectId: number): Lineage[];
+export declare function getLineageSummaries(lineageRepo: LineageRepository, nodeRepo: NodeRepository, projectId: number): LineageSummary[];
+export declare function touchLineage(lineageRepo: LineageRepository, lineageId: number): void;
+export declare function setCurrentLineage(lineageRepo: LineageRepository, projectId: number, lineageId: number): Lineage;
+export declare function getCurrentLineage(lineageRepo: LineageRepository, projectId: number): Lineage | null;
+export declare function resolveLineage(lineageRepo: LineageRepository, projectId: number, explicitId?: number): Lineage;
+//# sourceMappingURL=lineage.d.ts.map

package/dist/core/lineage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lineage.d.ts","sourceRoot":"","sources":["../../src/core/lineage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAiB7D,wBAAgB,aAAa,CAC3B,WAAW,EAAE,iBAAiB,EAC9B,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,GACX,OAAO,CAgBT;AAED,wBAAgB,WAAW,CAAC,WAAW,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,EAAE,CAExF;AAED,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,iBAAiB,EAC9B,QAAQ,EAAE,cAAc,EACxB,SAAS,EAAE,MAAM,GAChB,cAAc,EAAE,CAmBlB;AAED,wBAAgB,YAAY,CAAC,WAAW,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAEpF;AAED,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,iBAAiB,EAC9B,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,OAAO,CAWT;AAED,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,iBAAiB,EAC9B,SAAS,EAAE,MAAM,GAChB,OAAO,GAAG,IAAI,CAMhB;AAED,wBAAgB,cAAc,CAC5B,WAAW,EAAE,iBAAiB,EAC9B,SAAS,EAAE,MAAM,EACjB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAaT"}

package/dist/core/lineage.js

@@ -0,0 +1,75 @@
+function requireProjectLineage(lineageRepo, projectId, lineageId) {
+    const lineage = lineageRepo.findById(lineageId);
+    if (!lineage) {
+        throw new Error(`Lineage ${lineageId} does not exist.`);
+    }
+    if (lineage.projectId !== projectId) {
+        throw new Error(`Lineage ${lineageId} belongs to a different project.`);
+    }
+    return lineage;
+}
+export function createLineage(lineageRepo, projectId, name) {
+    const trimmedName = name.trim();
+    if (trimmedName.length === 0) {
+        throw new Error('Lineage name cannot be empty.');
+    }
+    const existing = lineageRepo.findByNameAndProjectId(projectId, trimmedName);
+    if (existing) {
+        throw new Error(`A lineage named '${existing.name}' already exists for this project.`);
+    }
+    const lineage = lineageRepo.create(projectId, trimmedName);
+    lineageRepo.setCurrentLineage(projectId, lineage.id);
+    lineageRepo.touch(lineage.id);
+    return lineageRepo.findById(lineage.id);
+}
+export function getLineages(lineageRepo, projectId) {
+    return lineageRepo.findByProjectId(projectId);
+}
+export function getLineageSummaries(lineageRepo, nodeRepo, projectId) {
+    const lineages = lineageRepo.findByProjectId(projectId);
+    if (lineages.length === 0) {
+        return [];
+    }
+    const currentLineageId = lineageRepo.getCurrentLineageId(projectId);
+    const nodeCounts = nodeRepo.countByLineageIds(lineages.map((lineage) => lineage.id));
+    return lineages.map((lineage) => ({
+        id: lineage.id,
+        projectId: lineage.projectId,
+        name: lineage.name,
+        status: lineage.status,
+        createdAt: lineage.createdAt,
+        lastActiveAt: lineage.lastActiveAt,
+        nodeCount: nodeCounts.get(lineage.id) ?? 0,
+        isCurrent: lineage.id === currentLineageId,
+    }));
+}
+export function touchLineage(lineageRepo, lineageId) {
+    lineageRepo.touch(lineageId);
+}
+export function setCurrentLineage(lineageRepo, projectId, lineageId) {
+    const lineage = requireProjectLineage(lineageRepo, projectId, lineageId);
+    if (lineage.status === 'archived') {
+        throw new Error(`Lineage ${lineageId} is archived and cannot be set as current.`);
+    }
+    lineageRepo.setCurrentLineage(projectId, lineageId);
+    lineageRepo.touch(lineageId);
+    return lineageRepo.findById(lineageId);
+}
+export function getCurrentLineage(lineageRepo, projectId) {
+    const id = lineageRepo.getCurrentLineageId(projectId);
+    if (id === null) {
+        return null;
+    }
+    return lineageRepo.findById(id) ?? null;
+}
+export function resolveLineage(lineageRepo, projectId, explicitId) {
+    if (explicitId !== undefined) {
+        return requireProjectLineage(lineageRepo, projectId, explicitId);
+    }
+    const current = getCurrentLineage(lineageRepo, projectId);
+    if (!current) {
+        throw new Error('No active lineage selected.\nRun:\n  paths lineage use <id>\n  or\n  paths lineage new "<name>"');
+    }
+    return current;
+}
+//# sourceMappingURL=lineage.js.map

package/dist/core/lineage.js.map

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