paths-engine 0.0.0-stage → 0.1.0

package/dist/core/node.d.ts

@@ -0,0 +1,27 @@
+import { NodeRepository, NodeSearchResult } from './db/node-repository.js';
+import { LineageRepository } from './db/lineage-repository.js';
+import { KnowledgeRepository } from './db/knowledge-repository.js';
+import { Node } from './types/node.js';
+export declare function isGitDiscoveryDisabled(): boolean;
+export declare function deriveFilesTouched(cwd?: string): string[];
+export interface LogNodeOptions {
+    explicitLineageId?: number;
+    filesTouched?: string[];
+    cwd?: string;
+    knowledgeIds?: number[];
+    knowledgeRepo?: KnowledgeRepository;
+}
+export declare function logNode(nodeRepo: NodeRepository, lineageRepo: LineageRepository, projectId: number, tool: string, summary: string, explicitLineageIdOrOptions?: number | LogNodeOptions, filesTouched?: string[], cwd?: string, knowledgeIds?: number[], knowledgeRepo?: KnowledgeRepository): Node;
+export declare function getNodes(nodeRepo: NodeRepository, lineageRepo: LineageRepository, projectId: number, lineageId: number, limit?: number): Node[];
+export declare function getLatestNode(nodeRepo: NodeRepository, lineageRepo: LineageRepository, projectId: number, lineageId: number): Node | null;
+export declare function getLineageHistory(nodeRepo: NodeRepository, lineageRepo: LineageRepository, projectId: number, explicitLineageId?: number, full?: boolean): Node[];
+export interface LineageHistoryBatchItem {
+    lineageId: number;
+    lineageName: string;
+    projectId: number;
+    status: 'active' | 'archived';
+    nodes: Node[];
+}
+export declare function getMultiLineageHistory(nodeRepo: NodeRepository, lineageRepo: LineageRepository, lineageIds: number[], full?: boolean): LineageHistoryBatchItem[];
+export declare function searchNodeHistory(nodeRepo: NodeRepository, projectId: number, query: string, lineageId?: number, limit?: number): NodeSearchResult[];
+//# sourceMappingURL=node.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../src/core/node.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3E,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAEnE,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAKvC,wBAAgB,sBAAsB,IAAI,OAAO,CAEhD;AAED,wBAAgB,kBAAkB,CAAC,GAAG,GAAE,MAAsB,GAAG,MAAM,EAAE,CAsBxE;AAqBD,MAAM,WAAW,cAAc;IAC7B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,aAAa,CAAC,EAAE,mBAAmB,CAAC;CACrC;AAgDD,wBAAgB,OAAO,CACrB,QAAQ,EAAE,cAAc,EACxB,WAAW,EAAE,iBAAiB,EAC9B,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,0BAA0B,CAAC,EAAE,MAAM,GAAG,cAAc,EACpD,YAAY,CAAC,EAAE,MAAM,EAAE,EACvB,GAAG,CAAC,EAAE,MAAM,EACZ,YAAY,CAAC,EAAE,MAAM,EAAE,EACvB,aAAa,CAAC,EAAE,mBAAmB,GAClC,IAAI,CAuDN;AAED,wBAAgB,QAAQ,CACtB,QAAQ,EAAE,cAAc,EACxB,WAAW,EAAE,iBAAiB,EAC9B,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,KAAK,CAAC,EAAE,MAAM,GACb,IAAI,EAAE,CAGR;AAED,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,cAAc,EACxB,WAAW,EAAE,iBAAiB,EAC9B,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,IAAI,GAAG,IAAI,CAGb;AAED,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,cAAc,EACxB,WAAW,EAAE,iBAAiB,EAC9B,SAAS,EAAE,MAAM,EACjB,iBAAiB,CAAC,EAAE,MAAM,EAC1B,IAAI,CAAC,EAAE,OAAO,GACb,IAAI,EAAE,CASR;AAED,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,QAAQ,GAAG,UAAU,CAAC;IAC9B,KAAK,EAAE,IAAI,EAAE,CAAC;CACf;AAED,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,cAAc,EACxB,WAAW,EAAE,iBAAiB,EAC9B,UAAU,EAAE,MAAM,EAAE,EACpB,IAAI,CAAC,EAAE,OAAO,GACb,uBAAuB,EAAE,CA6B3B;AAED,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,cAAc,EACxB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,SAAS,CAAC,EAAE,MAAM,EAClB,KAAK,CAAC,EAAE,MAAM,GACb,gBAAgB,EAAE,CAOpB"}

package/dist/core/node.js

@@ -0,0 +1,145 @@
+import { execSync } from 'child_process';
+import { resolveLineage } from './lineage.js';
+export function isGitDiscoveryDisabled() {
+    return process.env.PATHS_DISABLE_GIT_DISCOVERY === '1';
+}
+export function deriveFilesTouched(cwd = process.cwd()) {
+    if (isGitDiscoveryDisabled()) {
+        return [];
+    }
+    try {
+        const rawOutput = execSync('git diff --name-only HEAD', {
+            cwd,
+            encoding: 'utf-8',
+            stdio: ['ignore', 'pipe', 'ignore'],
+            timeout: 5000,
+            maxBuffer: 1024 * 1024,
+        });
+        const lines = rawOutput.split(/\r?\n/);
+        const parsedPaths = lines
+            .map((line) => line.trim())
+            .filter((line) => line.length > 0);
+        return [...new Set(parsedPaths)];
+    }
+    catch {
+        return [];
+    }
+}
+function getOwnedEntity(entity, name, id, projectId) {
+    if (!entity) {
+        throw new Error(`${name} ${id} does not exist.`);
+    }
+    if (entity.projectId !== projectId) {
+        throw new Error(`${name} ${id} belongs to a different project.`);
+    }
+    return entity;
+}
+function isLogNodeOptions(value) {
+    return typeof value === 'object' && value !== null;
+}
+function resolveLogNodeOptions(lineageIdOrOptions, filesTouched, cwd, knowledgeIds, knowledgeRepo) {
+    return isLogNodeOptions(lineageIdOrOptions)
+        ? lineageIdOrOptions
+        : {
+            explicitLineageId: lineageIdOrOptions,
+            filesTouched,
+            cwd,
+            knowledgeIds,
+            knowledgeRepo,
+        };
+}
+function resolveFilesTouched(filesTouched, cwd) {
+    if (filesTouched !== undefined) {
+        return filesTouched;
+    }
+    const isTestRun = cwd === undefined && process.env.NODE_ENV === 'test';
+    return isGitDiscoveryDisabled() || isTestRun ? [] : deriveFilesTouched(cwd);
+}
+function validateKnowledgeTarget(knowledge, id, projectId) {
+    const target = getOwnedEntity(knowledge, 'Knowledge', id, projectId);
+    if (target.originNodeId !== null) {
+        throw new Error(`Knowledge ${id} already originated from session node ${target.originNodeId}.`);
+    }
+    return target;
+}
+export function logNode(nodeRepo, lineageRepo, projectId, tool, summary, explicitLineageIdOrOptions, filesTouched, cwd, knowledgeIds, knowledgeRepo) {
+    const trimmedSummary = summary.trim();
+    if (trimmedSummary.length === 0) {
+        throw new Error('Session summary cannot be empty.');
+    }
+    const options = resolveLogNodeOptions(explicitLineageIdOrOptions, filesTouched, cwd, knowledgeIds, knowledgeRepo);
+    const lineage = resolveLineage(lineageRepo, projectId, options.explicitLineageId);
+    const parentNodeId = nodeRepo.findLatestByLineageId(lineage.id)?.id ?? null;
+    const resolvedFiles = resolveFilesTouched(options.filesTouched, options.cwd);
+    const finalTool = tool.trim() || 'manual';
+    const linkTargets = options.knowledgeIds ?? [];
+    const shouldLink = linkTargets.length > 0;
+    if (shouldLink && !options.knowledgeRepo) {
+        throw new Error('KnowledgeRepository is required when linking knowledge to a session node.');
+    }
+    const createSessionNode = () => {
+        if (options.knowledgeRepo && shouldLink) {
+            for (const id of linkTargets) {
+                validateKnowledgeTarget(options.knowledgeRepo.findById(id), id, projectId);
+            }
+        }
+        const node = nodeRepo.createWithTouch(lineage.id, finalTool, trimmedSummary, parentNodeId, resolvedFiles);
+        if (options.knowledgeRepo && shouldLink) {
+            for (const id of linkTargets) {
+                options.knowledgeRepo.linkOriginNode(id, node.id);
+            }
+        }
+        return node;
+    };
+    return options.knowledgeIds !== undefined
+        ? nodeRepo.transaction(createSessionNode)
+        : createSessionNode();
+}
+export function getNodes(nodeRepo, lineageRepo, projectId, lineageId, limit) {
+    getOwnedEntity(lineageRepo.findById(lineageId), 'Lineage', lineageId, projectId);
+    return nodeRepo.findByLineageId(lineageId, limit);
+}
+export function getLatestNode(nodeRepo, lineageRepo, projectId, lineageId) {
+    getOwnedEntity(lineageRepo.findById(lineageId), 'Lineage', lineageId, projectId);
+    return nodeRepo.findLatestByLineageId(lineageId) ?? null;
+}
+export function getLineageHistory(nodeRepo, lineageRepo, projectId, explicitLineageId, full) {
+    const lineage = resolveLineage(lineageRepo, projectId, explicitLineageId);
+    return getNodes(nodeRepo, lineageRepo, projectId, lineage.id, full ? undefined : 15);
+}
+export function getMultiLineageHistory(nodeRepo, lineageRepo, lineageIds, full) {
+    if (lineageIds.length === 0) {
+        return [];
+    }
+    const lineages = [];
+    for (const id of lineageIds) {
+        const lineage = lineageRepo.findById(id);
+        if (!lineage) {
+            throw new Error(`Lineage ${id} does not exist.`);
+        }
+        lineages.push(lineage);
+    }
+    const nodes = nodeRepo.findByLineageIds(lineageIds, full ? undefined : 15);
+    const nodesByLineageId = new Map();
+    for (const node of nodes) {
+        const list = nodesByLineageId.get(node.lineageId) ?? [];
+        list.push(node);
+        nodesByLineageId.set(node.lineageId, list);
+    }
+    return lineages.map((lineage) => ({
+        lineageId: lineage.id,
+        lineageName: lineage.name,
+        projectId: lineage.projectId,
+        status: lineage.status,
+        nodes: nodesByLineageId.get(lineage.id) ?? [],
+    }));
+}
+export function searchNodeHistory(nodeRepo, projectId, query, lineageId, limit) {
+    const trimmed = query.trim();
+    if (trimmed.length === 0) {
+        throw new Error('Search query cannot be empty.');
+    }
+    const effectiveLimit = Math.min(Math.max(limit ?? 20, 1), 100);
+    return nodeRepo.search(projectId, trimmed, lineageId, effectiveLimit);
+}
+//# sourceMappingURL=node.js.map

package/dist/core/node.js.map

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

package/dist/core/plan.d.ts

@@ -0,0 +1,26 @@
+import { Store } from './db/store.js';
+import { PlanRepository } from './db/plan-repository.js';
+import { ProjectRepository } from './db/project-repository.js';
+import { LineageRepository } from './db/lineage-repository.js';
+import { Plan } from './types/plan.js';
+export interface CreatePlanParams {
+    projectId: number;
+    title: string;
+    intent: string;
+    approach: string;
+    definitionOfDone: string;
+    lineageId?: number | null;
+}
+export interface UpdatePlanParams {
+    title?: string;
+    intent?: string;
+    approach?: string;
+    definitionOfDone?: string;
+}
+export declare function getPlan(planRepo: PlanRepository, projectId: number, planId: number): Plan;
+export declare function createPlan(store: Store, planRepo: PlanRepository, projectRepo: ProjectRepository, lineageRepo: LineageRepository, params: CreatePlanParams): Plan;
+export declare function getActivePlan(planRepo: PlanRepository, projectId: number): Plan | null;
+export declare function completePlan(planRepo: PlanRepository, projectId: number, planId: number, completionSummary: string): Plan;
+export declare function abandonPlan(planRepo: PlanRepository, projectId: number, planId: number, abandonmentReason: string): Plan;
+export declare function updatePlan(planRepo: PlanRepository, projectId: number, planId: number, updates: UpdatePlanParams): Plan;
+//# sourceMappingURL=plan.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../src/core/plan.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAsB,IAAI,EAA0B,MAAM,iBAAiB,CAAC;AAEnF,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AA2CD,wBAAgB,OAAO,CACrB,QAAQ,EAAE,cAAc,EACxB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb,IAAI,CAWN;AAiDD,wBAAgB,UAAU,CACxB,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,cAAc,EACxB,WAAW,EAAE,iBAAiB,EAC9B,WAAW,EAAE,iBAAiB,EAC9B,MAAM,EAAE,gBAAgB,GACvB,IAAI,CAmBN;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAEtF;AAED,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,cAAc,EACxB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,iBAAiB,EAAE,MAAM,GACxB,IAAI,CAIN;AAED,wBAAgB,WAAW,CACzB,QAAQ,EAAE,cAAc,EACxB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,iBAAiB,EAAE,MAAM,GACxB,IAAI,CAIN;AAED,wBAAgB,UAAU,CACxB,QAAQ,EAAE,cAAc,EACxB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,gBAAgB,GACxB,IAAI,CAIN"}

package/dist/core/plan.js

@@ -0,0 +1,109 @@
+const UPDATABLE_FIELDS = [
+    ['title', 'title'],
+    ['intent', 'intent'],
+    ['approach', 'approach'],
+    ['definitionOfDone', 'definition of done'],
+];
+function requireNonBlank(value, field) {
+    const trimmed = value.trim();
+    if (trimmed.length === 0) {
+        throw new Error(`Plan ${field} cannot be empty.`);
+    }
+    return trimmed;
+}
+function requireProject(projectRepo, projectId) {
+    const project = projectRepo.findById(projectId);
+    if (!project) {
+        throw new Error(`Project ${projectId} does not exist.`);
+    }
+}
+function validateLineage(lineageRepo, projectId, lineageId) {
+    if (lineageId === undefined || lineageId === null) {
+        return;
+    }
+    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.`);
+    }
+}
+export function getPlan(planRepo, projectId, planId) {
+    const plan = planRepo.findById(planId);
+    if (!plan) {
+        throw new Error(`Plan ${planId} does not exist.`);
+    }
+    if (plan.projectId !== projectId) {
+        throw new Error(`Plan ${planId} belongs to a different project.`);
+    }
+    return plan;
+}
+function requireOwnedActivePlan(planRepo, projectId, planId) {
+    const plan = getPlan(planRepo, projectId, planId);
+    if (plan.status !== 'active') {
+        throw new Error(`Plan ${planId} is ${plan.status} and cannot be modified.`);
+    }
+    return plan;
+}
+function insertPlanReplacingActive(planRepo, input) {
+    const existing = planRepo.findActiveByProjectId(input.projectId);
+    if (!existing) {
+        return planRepo.create(input);
+    }
+    // Release the single-active slot first; the successor link is set
+    // after the new row exists (FK + partial unique index both hold).
+    planRepo.markReplaced(existing.id, null);
+    const created = planRepo.create(input);
+    planRepo.markReplaced(existing.id, created.id);
+    return created;
+}
+function buildUpdateFields(updates) {
+    const fields = {};
+    for (const [key, label] of UPDATABLE_FIELDS) {
+        const value = updates[key];
+        if (value === undefined) {
+            continue;
+        }
+        fields[key] = requireNonBlank(value, label);
+    }
+    if (Object.keys(fields).length === 0) {
+        throw new Error('No plan fields provided to update.');
+    }
+    return fields;
+}
+export function createPlan(store, planRepo, projectRepo, lineageRepo, params) {
+    requireProject(projectRepo, params.projectId);
+    validateLineage(lineageRepo, params.projectId, params.lineageId);
+    const title = requireNonBlank(params.title, 'title');
+    const intent = requireNonBlank(params.intent, 'intent');
+    const approach = requireNonBlank(params.approach, 'approach');
+    const definitionOfDone = requireNonBlank(params.definitionOfDone, 'definition of done');
+    return store.transaction(() => insertPlanReplacingActive(planRepo, {
+        projectId: params.projectId,
+        lineageId: params.lineageId ?? null,
+        title,
+        intent,
+        approach,
+        definitionOfDone,
+    }));
+}
+export function getActivePlan(planRepo, projectId) {
+    return planRepo.findActiveByProjectId(projectId);
+}
+export function completePlan(planRepo, projectId, planId, completionSummary) {
+    requireOwnedActivePlan(planRepo, projectId, planId);
+    const summary = requireNonBlank(completionSummary, 'completion summary');
+    return planRepo.markCompleted(planId, summary);
+}
+export function abandonPlan(planRepo, projectId, planId, abandonmentReason) {
+    requireOwnedActivePlan(planRepo, projectId, planId);
+    const reason = requireNonBlank(abandonmentReason, 'abandonment reason');
+    return planRepo.markAbandoned(planId, reason);
+}
+export function updatePlan(planRepo, projectId, planId, updates) {
+    requireOwnedActivePlan(planRepo, projectId, planId);
+    const fields = buildUpdateFields(updates);
+    return planRepo.updateContent(planId, fields);
+}
+//# sourceMappingURL=plan.js.map

package/dist/core/plan.js.map

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

package/dist/core/project.d.ts

@@ -0,0 +1,10 @@
+import { Store } from './db/store.js';
+import { Project } from './types/project.js';
+export declare function isApplicationDirectory(dirPath: string): boolean;
+export declare function resolveProjectRoot(targetPath: string): string;
+export declare const MAX_PROJECT_KEY_LENGTH = 512;
+export declare function getMaxProjectCreationsPerProcess(): number;
+export declare function validateProjectKey(key: string): void;
+export declare function resolveProjectKey(cwd: string): string;
+export declare function getOrCreateProject(store: Store, cwd: string): Project;
+//# sourceMappingURL=project.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../src/core/project.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAEtC,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAE7C,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAU/D;AAED,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAyB7D;AAED,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAK1C,wBAAgB,gCAAgC,IAAI,MAAM,CAMzD;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAWpD;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CA4BrD;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAgBrE"}

package/dist/core/project.js

@@ -0,0 +1,108 @@
+import { execSync } from 'child_process';
+import path from 'path';
+import fs from 'fs';
+import { ProjectRepository } from './db/project-repository.js';
+export function isApplicationDirectory(dirPath) {
+    const normalized = path.resolve(dirPath).toLowerCase();
+    const markers = [
+        'appdata\\local\\programs',
+        'appdata/local/programs',
+        'program files',
+        'program files (x86)',
+        'windows\\system32',
+    ];
+    return markers.some((marker) => normalized.includes(marker));
+}
+export function resolveProjectRoot(targetPath) {
+    let searchDir = path.resolve(targetPath);
+    try {
+        if (fs.existsSync(searchDir) && fs.statSync(searchDir).isFile()) {
+            searchDir = path.dirname(searchDir);
+        }
+    }
+    catch {
+        // Non-existent path or stat failure; keep searchDir
+    }
+    try {
+        const topLevel = execSync('git rev-parse --show-toplevel', {
+            cwd: searchDir,
+            encoding: 'utf-8',
+            stdio: ['ignore', 'pipe', 'ignore'],
+        }).trim();
+        if (topLevel && !topLevel.startsWith('http://') && !topLevel.startsWith('https://')) {
+            return path.resolve(topLevel);
+        }
+    }
+    catch {
+        // Non-git folder or git error falls back to searchDir
+    }
+    return searchDir;
+}
+export const MAX_PROJECT_KEY_LENGTH = 512;
+const DEFAULT_MAX_PROJECT_CREATIONS_PER_PROCESS = 100;
+let projectCreationsThisProcess = 0;
+export function getMaxProjectCreationsPerProcess() {
+    const raw = Number(process.env.PATHS_MAX_PROJECT_CREATIONS);
+    if (Number.isInteger(raw) && raw > 0) {
+        return raw;
+    }
+    return DEFAULT_MAX_PROJECT_CREATIONS_PER_PROCESS;
+}
+export function validateProjectKey(key) {
+    if (typeof key !== 'string' || !key.trim()) {
+        throw new Error('Project key must be a non-empty string.');
+    }
+    if (key.length > MAX_PROJECT_KEY_LENGTH) {
+        throw new Error('Project key exceeds maximum length.');
+    }
+    // eslint-disable-next-line no-control-regex
+    if (/[\x00-\x1F\x7F]/.test(key)) {
+        throw new Error('Project key contains invalid control characters.');
+    }
+}
+export function resolveProjectKey(cwd) {
+    let searchDir = cwd;
+    try {
+        if (fs.existsSync(cwd) && fs.statSync(cwd).isFile()) {
+            searchDir = path.dirname(cwd);
+        }
+    }
+    catch {
+        // Non-existent path or stat failure; keep cwd
+    }
+    try {
+        const remoteUrl = execSync('git config --get remote.origin.url', {
+            cwd: searchDir,
+            encoding: 'utf-8',
+            stdio: ['ignore', 'pipe', 'ignore'],
+        }).trim();
+        if (remoteUrl) {
+            validateProjectKey(remoteUrl);
+            return remoteUrl;
+        }
+    }
+    catch {
+        // Non-git folder, git error, or invalid remote falls back to absolute path
+    }
+    const fallback = path.resolve(searchDir);
+    validateProjectKey(fallback);
+    return fallback;
+}
+export function getOrCreateProject(store, cwd) {
+    const rootDir = resolveProjectRoot(cwd);
+    const key = resolveProjectKey(cwd);
+    const repo = new ProjectRepository(store);
+    const existing = repo.findByKey(key);
+    if (existing) {
+        if (existing.pathHint === rootDir) {
+            return existing;
+        }
+        return repo.upsert(key, rootDir);
+    }
+    projectCreationsThisProcess += 1;
+    if (projectCreationsThisProcess > getMaxProjectCreationsPerProcess()) {
+        throw new Error('Project creation budget exceeded for this process.');
+    }
+    return repo.upsert(key, rootDir);
+}
+//# sourceMappingURL=project.js.map

package/dist/core/project.js.map

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

package/dist/core/rollup.d.ts

@@ -0,0 +1,7 @@
+import { NodeRepository } from './db/node-repository.js';
+import { RollupRepository } from './db/rollup-repository.js';
+import { LineageRepository } from './db/lineage-repository.js';
+import { Rollup } from './types/node.js';
+export declare function createRollup(nodeRepo: NodeRepository, rollupRepo: RollupRepository, lineageRepo: LineageRepository, projectId: number, lineageId: number, fromNodeId: number, toNodeId: number, summary: string): Rollup;
+export declare function getRollups(rollupRepo: RollupRepository, lineageId: number): Rollup[];
+//# sourceMappingURL=rollup.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rollup.d.ts","sourceRoot":"","sources":["../../src/core/rollup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAsDzC,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,cAAc,EACxB,UAAU,EAAE,gBAAgB,EAC5B,WAAW,EAAE,iBAAiB,EAC9B,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GACd,MAAM,CAmBR;AAED,wBAAgB,UAAU,CACxB,UAAU,EAAE,gBAAgB,EAC5B,SAAS,EAAE,MAAM,GAChB,MAAM,EAAE,CAEV"}

package/dist/core/rollup.js

@@ -0,0 +1,48 @@
+function validateLineage(lineageRepo, lineageId, projectId) {
+    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.`);
+    }
+}
+function validateSessionNodeEndpoint(nodeRepo, nodeId, lineageId, role) {
+    const node = nodeRepo.findById(nodeId);
+    if (!node) {
+        throw new Error(`${role} node ${nodeId} does not exist.`);
+    }
+    if (node.lineageId !== lineageId) {
+        throw new Error(`${role} node ${nodeId} belongs to a different lineage.`);
+    }
+    if (node.nodeType !== 'session') {
+        throw new Error(`${role} node ${nodeId} is a rollup node; rollups cannot span other rollups.`);
+    }
+}
+function validateNoRangeOverlap(rollupRepo, lineageId, fromNodeId, toNodeId) {
+    const existingRollups = rollupRepo.findByLineageId(lineageId);
+    for (const existing of existingRollups) {
+        const overlaps = Math.max(fromNodeId, existing.fromNodeId) <= Math.min(toNodeId, existing.toNodeId);
+        if (overlaps) {
+            throw new Error(`Rollup range [${fromNodeId}, ${toNodeId}] overlaps with existing rollup [${existing.fromNodeId}, ${existing.toNodeId}].`);
+        }
+    }
+}
+export function createRollup(nodeRepo, rollupRepo, lineageRepo, projectId, lineageId, fromNodeId, toNodeId, summary) {
+    const trimmedSummary = summary.trim();
+    if (trimmedSummary.length === 0) {
+        throw new Error('Rollup summary cannot be empty.');
+    }
+    validateLineage(lineageRepo, lineageId, projectId);
+    if (fromNodeId > toNodeId) {
+        throw new Error(`Invalid rollup range: fromNodeId (${fromNodeId}) must be <= toNodeId (${toNodeId}).`);
+    }
+    validateSessionNodeEndpoint(nodeRepo, fromNodeId, lineageId, 'Source');
+    validateSessionNodeEndpoint(nodeRepo, toNodeId, lineageId, 'Target');
+    validateNoRangeOverlap(rollupRepo, lineageId, fromNodeId, toNodeId);
+    return rollupRepo.createRollup(lineageId, fromNodeId, toNodeId, trimmedSummary);
+}
+export function getRollups(rollupRepo, lineageId) {
+    return rollupRepo.findByLineageId(lineageId);
+}
+//# sourceMappingURL=rollup.js.map

package/dist/core/rollup.js.map

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

package/dist/core/security/error-classifier.d.ts

@@ -0,0 +1,35 @@
+export declare class DomainError extends Error {
+    readonly code: string;
+    constructor(message: string, code?: string);
+}
+export declare class NotFoundError extends DomainError {
+    constructor(message: string);
+}
+export declare class ValidationError extends DomainError {
+    constructor(message: string);
+}
+export declare class ConflictError extends DomainError {
+    constructor(message: string);
+}
+export declare class ContextClosedError extends DomainError {
+    constructor(message?: string);
+}
+export interface ClassifiedError {
+    code: string;
+    safeMessage: string;
+    isInternal: boolean;
+}
+/**
+ * Strips sensitive file paths, SQL fragments, and connection strings from error messages.
+ */
+export declare function sanitizeErrorMessage(message: string): string;
+/**
+ * Determines whether an error message indicates an internal infrastructure,
+ * database, or unexpected runtime exception.
+ */
+export declare function isInternalInfrastructureError(message: string): boolean;
+/**
+ * Universal Allowlist-First Error Classifier
+ */
+export declare function classifyError(err: unknown): ClassifiedError;
+//# sourceMappingURL=error-classifier.d.ts.map

package/dist/core/security/error-classifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-classifier.d.ts","sourceRoot":"","sources":["../../../src/core/security/error-classifier.ts"],"names":[],"mappings":"AAAA,qBAAa,WAAY,SAAQ,KAAK;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,OAAO,EAAE,MAAM,EAAE,IAAI,SAAiB;CAMnD;AAED,qBAAa,aAAc,SAAQ,WAAW;gBAChC,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,eAAgB,SAAQ,WAAW;gBAClC,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,aAAc,SAAQ,WAAW;gBAChC,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,kBAAmB,SAAQ,WAAW;gBACrC,OAAO,SAA6B;CAIjD;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;CACrB;AAwDD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAwB5D;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAYtE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,eAAe,CAkD3D"}