@linklabjs/core 0.1.0 → 0.1.1

package/dist/scripts/regenerate.js

@@ -0,0 +1,206 @@
+/**
+ * regenerate.ts — Script de régénération des graphes compilés
+ *
+ * Usage :
+ *   npx tsx regenerate.ts netflix
+ *   npx tsx regenerate.ts dvdrental --pg host=localhost user=postgres password=secret
+ *   npx tsx regenerate.ts all
+ *
+ * Régénère compiled-graph.json pour chaque scénario.
+ * Bumpe automatiquement la version dans le fichier produit.
+ *
+ * Versioning :
+ *   - Graphes générés (netflix, dvdrental) : version dans compiled-graph.json
+ *     format : MAJOR.MINOR.PATCH  ex: 2.0.0
+ *     MAJOR = version du GraphCompiler (structure breaking)
+ *     MINOR = changement de schéma (nouvelles tables/relations)
+ *     PATCH = recompilation (nouveaux poids, métriques)
+ *
+ *   - Graphes manuels (metro, musicians) : version dans raw-graph.json + compiled
+ *     Patch manuel dans raw-graph.json, puis npx tsx regenerate.ts metro
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { fileURLToPath } from 'url';
+import { dirname } from 'path';
+import { JsonSchemaExtractor } from '../schema/JsonSchemaExtractor.js';
+import { SchemaAnalyzer } from '../schema/SchemaAnalyzer.js';
+import { GraphBuilder } from '../schema/GraphBuilder.js';
+import { GraphAssembler } from '../graph/GraphAssembler.js';
+import { GraphCompiler } from '../graph/GraphCompiler.js';
+import { PathFinder } from '../core/PathFinder.js';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const ROOT = path.join(__dirname, '..', 'examples');
+const CONFIG_DIR = path.join(__dirname, '..', '..', 'config');
+// ── Helpers ───────────────────────────────────────────────────────────────────
+function save(filepath, data) {
+    fs.writeFileSync(filepath, JSON.stringify(data, null, 2));
+    const kb = (fs.statSync(filepath).size / 1024).toFixed(1);
+    console.log(`   💾 ${path.basename(filepath).padEnd(25)} ${kb} KB`);
+}
+function bumpPatch(current) {
+    const parts = current.split('.').map(Number);
+    if (parts.length !== 3 || parts.some(isNaN))
+        return '2.0.0';
+    parts[2]++;
+    return parts.join('.');
+}
+function readCurrentVersion(compiledPath) {
+    try {
+        const c = JSON.parse(fs.readFileSync(compiledPath, 'utf-8'));
+        return c.version ?? '2.0.0';
+    }
+    catch {
+        return '2.0.0';
+    }
+}
+// ── Entraînement local (sans provider externe) ────────────────────────────────
+function trainLocal(graph, useCases) {
+    const metrics = new Map();
+    const finder = new PathFinder(graph);
+    for (const uc of useCases) {
+        const paths = finder.findAllPaths(uc.from, uc.to);
+        for (const p of paths) {
+            metrics.set(p.join('→'), {
+                path: p,
+                executions: 10,
+                successes: 10,
+                totalTime: 100,
+                avgTime: 10,
+                minTime: 8,
+                maxTime: 12,
+                used: true,
+                failed: false
+            });
+        }
+    }
+    return metrics;
+}
+// ── Pipeline JSON (netflix, cinema, etc.) ─────────────────────────────────────
+async function regenerateFromJSON(scenario) {
+    const dir = path.join(ROOT, scenario);
+    const dataDir = path.join(dir, 'data');
+    const compiledOut = path.join(dir, 'compiled-graph.json');
+    if (!fs.existsSync(dataDir)) {
+        console.error(`  ❌ data/ not found: ${dataDir}`);
+        return;
+    }
+    console.log(`\n🔄 ${scenario} — pipeline JSON`);
+    console.log('─'.repeat(50));
+    // Step 1 : Extraction
+    const extractor = new JsonSchemaExtractor(dataDir);
+    const techSchema = await extractor.extract();
+    save(path.join(dir, 'schema.json'), techSchema);
+    // Step 2 : Analyse
+    const analyzer = new SchemaAnalyzer(CONFIG_DIR, dataDir);
+    const analyzedSchema = analyzer.analyze(techSchema);
+    save(path.join(dir, 'analyzed-schema.json'), analyzedSchema);
+    // Step 3 : Dictionnaire
+    const builder = new GraphBuilder();
+    const dictionary = builder.build(analyzedSchema, dataDir);
+    save(path.join(dir, 'dictionary.json'), dictionary);
+    // Step 4 : Graphe brut
+    const assembler = new GraphAssembler();
+    const rawGraph = assembler.assemble(dictionary);
+    save(path.join(dir, 'raw-graph.json'), rawGraph);
+    console.log(`   📊 ${rawGraph.nodes.length} nœuds · ${rawGraph.edges.length} arêtes`);
+    // Step 5 : Use cases (lire depuis use-cases.json si présent, sinon défaut)
+    const ucFile = path.join(dir, 'use-cases.json');
+    const useCases = fs.existsSync(ucFile)
+        ? JSON.parse(fs.readFileSync(ucFile, 'utf-8'))
+        : buildDefaultUseCases(rawGraph);
+    const metrics = trainLocal(rawGraph, useCases);
+    save(path.join(dir, 'metrics.json'), Object.fromEntries(metrics));
+    // Step 6 : Compilation
+    const prevVersion = readCurrentVersion(compiledOut);
+    const newVersion = bumpPatch(prevVersion);
+    const compiler = new GraphCompiler({ weightThreshold: 1000, keepFallbacks: true });
+    const compiledGraph = compiler.compile(rawGraph, metrics);
+    compiledGraph.version = newVersion;
+    compiledGraph.scenario = scenario;
+    save(compiledOut, compiledGraph);
+    const stats = GraphCompiler.getStats(compiledGraph);
+    console.log(`\n   ✅ ${stats.totalRoutes} routes  (${stats.physical} physical · ${stats.semantic} semantic)`);
+    console.log(`   📌 version: ${prevVersion} → ${newVersion}`);
+}
+// ── Pipeline manuel (metro, musicians) ───────────────────────────────────────
+// raw-graph.json édité à la main → on recompile seulement
+async function recompileManual(scenario) {
+    const dir = path.join(ROOT, scenario);
+    const rawPath = path.join(dir, 'raw-graph.json');
+    const compiledOut = path.join(dir, 'compiled-graph.json');
+    if (!fs.existsSync(rawPath)) {
+        console.error(`  ❌ raw-graph.json not found: ${rawPath}`);
+        return;
+    }
+    console.log(`\n🔄 ${scenario} — recompile manual graph`);
+    console.log('─'.repeat(50));
+    const rawGraph = JSON.parse(fs.readFileSync(rawPath, 'utf-8'));
+    const ucFile = path.join(dir, 'use-cases.json');
+    const useCases = fs.existsSync(ucFile)
+        ? JSON.parse(fs.readFileSync(ucFile, 'utf-8'))
+        : buildDefaultUseCases(rawGraph);
+    const metrics = trainLocal(rawGraph, useCases);
+    const prevVersion = readCurrentVersion(compiledOut);
+    const newVersion = bumpPatch(prevVersion);
+    const compiler = new GraphCompiler({ weightThreshold: 1000, keepFallbacks: true });
+    const compiledGraph = compiler.compile(rawGraph, metrics);
+    compiledGraph.version = newVersion;
+    compiledGraph.scenario = scenario;
+    save(compiledOut, compiledGraph);
+    const stats = GraphCompiler.getStats(compiledGraph);
+    console.log(`   ✅ ${stats.totalRoutes} routes  (${stats.physical} physical · ${stats.semantic} semantic)`);
+    console.log(`   📌 version: ${prevVersion} → ${newVersion}`);
+}
+// ── Déterminer le type de scénario ────────────────────────────────────────────
+function scenarioType(scenario) {
+    const dir = path.join(ROOT, scenario);
+    if (fs.existsSync(path.join(dir, 'data')))
+        return 'json';
+    if (fs.existsSync(path.join(dir, 'raw-graph.json')))
+        return 'manual';
+    return 'unknown';
+}
+function buildDefaultUseCases(graph) {
+    // Générer des use cases par défaut depuis les nœuds du graphe
+    const nodes = graph.nodes.map((n) => n.id);
+    const cases = [];
+    for (let i = 0; i < Math.min(nodes.length, 4); i++) {
+        for (let j = 0; j < Math.min(nodes.length, 4); j++) {
+            if (i !== j)
+                cases.push({ from: nodes[i], to: nodes[j], description: `${nodes[i]}→${nodes[j]}` });
+        }
+    }
+    return cases;
+}
+// ── Main ──────────────────────────────────────────────────────────────────────
+async function main() {
+    const args = process.argv.slice(2);
+    const scenarios = args[0] === 'all'
+        ? fs.readdirSync(ROOT).filter(d => fs.statSync(path.join(ROOT, d)).isDirectory())
+        : args.filter(a => !a.startsWith('--'));
+    if (!scenarios.length) {
+        console.log('Usage: npx tsx regenerate.ts <scenario|all> [--pg ...]');
+        console.log('Examples:');
+        console.log('  npx tsx regenerate.ts netflix');
+        console.log('  npx tsx regenerate.ts metro musicians');
+        console.log('  npx tsx regenerate.ts all');
+        process.exit(0);
+    }
+    for (const scenario of scenarios) {
+        const type = scenarioType(scenario);
+        if (type === 'json')
+            await regenerateFromJSON(scenario);
+        else if (type === 'manual')
+            await recompileManual(scenario);
+        else
+            console.warn(`  ⚠️  ${scenario}: unknown scenario type (no data/ nor raw-graph.json)`);
+    }
+    console.log('\n✅ Done\n');
+}
+main().catch(err => {
+    console.error('❌', err);
+    process.exit(1);
+});
+//# sourceMappingURL=regenerate.js.map

package/dist/scripts/regenerate.js.map

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

package/dist/types/index.d.ts

@@ -0,0 +1,394 @@
+/**
+ * LinkLab Core Types
+ * * Base type definitions for the entire system
+ */
+export type NodeType = 'table' | 'view' | 'entity' | 'action';
+export interface Column {
+    name: string;
+    type: string;
+    nullable?: boolean;
+    primaryKey?: boolean;
+    foreignKey?: boolean;
+    defaultValue?: any;
+    description?: string;
+}
+export interface GraphNode {
+    id: string;
+    type: string;
+    name?: string;
+    exposed?: boolean;
+    [key: string]: any;
+}
+export interface GraphEdge {
+    from: string;
+    to: string;
+    weight: number;
+    name?: string;
+    via?: string;
+    fromCol?: string;
+    toCol?: string;
+    metadata?: {
+        condition?: string | Record<string, any>;
+        semanticType?: string;
+        [key: string]: any;
+    };
+}
+export interface Graph {
+    nodes: GraphNode[];
+    edges: GraphEdge[];
+}
+export interface RouteStep {
+    fromCol: string;
+    toCol: string;
+}
+export interface RouteInfo {
+    from: string;
+    to: string;
+    primary: {
+        path: string[];
+        edges: RouteStep[];
+        weight: number;
+        joins: number;
+        avgTime: number;
+    };
+    fallbacks: Array<{
+        path: string[];
+        edges: RouteStep[];
+        weight: number;
+        joins: number;
+        avgTime: number;
+    }>;
+    alternativesDiscarded: number;
+}
+export interface GraphMetadata {
+    version?: string;
+    generatedAt?: string;
+    database?: DatabaseInfo;
+    [key: string]: any;
+}
+export interface DatabaseInfo {
+    name: string;
+    type: 'postgresql' | 'mysql' | 'sqlite' | 'mongodb';
+    version?: string;
+}
+export interface ActionDefinition {
+    id: string;
+    description?: string;
+    requiredParams: Column[];
+    provides?: string[];
+    handler: (context: any) => Promise<any>;
+}
+export interface ActionRegistry {
+    register(action: ActionDefinition): void;
+    get(id: string): ActionDefinition | undefined;
+    getAll(): ActionDefinition[];
+}
+export interface ContextLayer {
+    nodeId: string;
+    timestamp: number;
+    data: Record<string, any>;
+    type: 'navigation' | 'action' | 'system';
+}
+export interface EngineConfig {
+    cache?: CacheConfig;
+    debug?: boolean;
+    onResolveContext?: (currentContext: any) => Awaitable<any>;
+    onValidatePath?: (node: GraphNode, context: any) => Awaitable<boolean>;
+}
+export type Path = string[];
+export interface PathDetails {
+    path: Path;
+    length: number;
+    joins: number;
+    weight: number;
+    edges: GraphEdge[];
+    indirect?: boolean;
+}
+export interface PathMetrics {
+    path: Path;
+    weight: number;
+    joins: number;
+    avgTime?: number;
+    executions?: number;
+    minTime?: number;
+    maxTime?: number;
+}
+export type MetricsMap = Map<string, TrainingMetrics>;
+export interface ProviderConfig {
+    host?: string;
+    port?: number;
+    database: string;
+    user?: string;
+    password?: string;
+    connectionString?: string;
+    mock?: boolean;
+    [key: string]: any;
+}
+export interface Provider {
+    query<T = any>(sql: string, params?: any[]): Promise<T[]>;
+    close(): Promise<void>;
+}
+export interface CompiledGraph {
+    version: string;
+    compiledAt: string;
+    config: CompilerConfig;
+    nodes: GraphNode[];
+    routes: RouteInfo[];
+    stats: CompilationStats;
+}
+export interface CompilerConfig {
+    weightThreshold: number;
+    minUsage?: number;
+    keepFallbacks: boolean;
+    maxFallbacks: number;
+    expose?: ExposeConfig;
+}
+export interface CompilationStats {
+    totalPairs: number;
+    routesCompiled: number;
+    routesFiltered: number;
+    compressionRatio: string;
+}
+export interface UseCase {
+    description: string;
+    from: string;
+    to: string;
+    sampleData?: Record<string, any>;
+    expectedPath?: Path;
+}
+export interface TrainingMetrics {
+    path: Path;
+    executions: number;
+    successes?: number;
+    failures?: number;
+    totalTime: number;
+    avgTime: number;
+    minTime: number;
+    maxTime: number;
+    used: boolean;
+    failed?: boolean;
+    error?: string;
+}
+export interface CacheConfig {
+    maxSize?: number;
+    ttl?: number;
+}
+export type Awaitable<T> = T | Promise<T>;
+export type ExposeConfig = 'all' | 'none' | {
+    include: string[];
+} | {
+    exclude: string[];
+};
+export declare class LinkLabError extends Error {
+    code: string;
+    details?: any | undefined;
+    constructor(message: string, code: string, details?: any | undefined);
+}
+export declare class ProviderError extends LinkLabError {
+    constructor(message: string, details?: any);
+}
+export interface TechProperty {
+    name: string;
+    type: string;
+    isPK: boolean;
+    isFK: boolean;
+    references?: {
+        table: string;
+        column: string;
+    };
+    isIndexed: boolean;
+}
+export interface TechEntity {
+    name: string;
+    properties: TechProperty[];
+    rowCount: number;
+}
+export interface TechnicalSchema {
+    source: {
+        type: string;
+        name: string;
+        generatedAt: string;
+    };
+    entities: TechEntity[];
+}
+export interface AnalysisAdvice {
+    type: 'PERFORMANCE' | 'STRUCTURE' | 'VIRTUAL_RELATION';
+    level: 'INFO' | 'WARNING' | 'CRITICAL';
+    message: string;
+    target: string;
+    action?: string;
+}
+export interface ImplicitRelation {
+    fromTable: string;
+    column: string;
+    guessedTable: string;
+}
+export interface AnalyzedSchema extends TechnicalSchema {
+    advices: AnalysisAdvice[];
+    weights: Record<string, number>;
+    implicitRelations: ImplicitRelation[];
+}
+export interface Dictionary {
+    tables: Table[];
+    relations: Relation[];
+}
+export interface Table {
+    name: string;
+    columns: string[];
+    rowCount: number;
+}
+export interface Relation {
+    from: string;
+    to: string;
+    via: string;
+    type: 'physical' | 'physical_reverse' | 'semantic_view' | 'virtual';
+    weight: number;
+    label: string;
+    condition?: {
+        [column: string]: any;
+    };
+    metadataField?: string;
+}
+/**
+ * Schema definitions for physical data discovery
+ */
+export interface ColumnSchema {
+    name: string;
+    type: 'string' | 'number' | 'boolean' | 'date' | 'object' | 'array';
+    isNullable?: boolean;
+    isPrimaryKey?: boolean;
+    isForeignKey?: boolean;
+    references?: {
+        table: string;
+        column: string;
+    };
+}
+export interface TableSchema {
+    name: string;
+    columns: ColumnSchema[];
+    rowCount?: number;
+    fileSize?: number;
+    filePath?: string;
+}
+export interface DatabaseSchema {
+    tables: TableSchema[];
+    relationships: SchemaRelationship[];
+}
+export interface SchemaRelationship {
+    fromTable: string;
+    fromColumn: string;
+    toTable: string;
+    toColumn: string;
+    type: 'one-to-one' | 'one-to-many' | 'many-to-many';
+}
+export type EngineMode = 'PATHFIND' | 'NAVIGATE' | 'SCHEDULE';
+/**
+ * Frame : unité de navigation sur la stack.
+ * Représente un pointeur sémantique vers une entité,
+ * avec son état de résolution.
+ */
+export interface Frame {
+    entity: string;
+    id?: any;
+    state?: 'RESOLVED' | 'UNRESOLVED' | 'DEFERRED';
+    purpose?: string;
+    intent?: Record<string, any>;
+    data?: any;
+    resolvedBy?: {
+        relation: string;
+        via: string;
+        filters?: FrameFilter[];
+    };
+}
+export interface FrameFilter {
+    field: string;
+    operator: 'equals' | 'contains' | 'gt' | 'lt' | 'exists';
+    value: any;
+}
+/**
+ * PathQuery : paramètres pour le mode PATHFIND
+ */
+export interface PathQuery {
+    from: string;
+    to: string;
+    maxPaths?: number;
+    minHops?: number;
+    maxHops?: number;
+    transferPenalty?: number;
+    via?: string[];
+    preferences?: {
+        minimizeTransfers?: boolean;
+        avoidEdges?: string[];
+        [key: string]: any;
+    };
+}
+/**
+ * ScheduleAction : action pour le mode SCHEDULE.
+ * Différenciée de ActionDefinition (infrastructure) pour éviter
+ * tout conflit avec le registre d'actions techniques de V3.
+ */
+export interface ScheduleAction {
+    name: string;
+    weight: number;
+    when?: (stack: Frame[]) => boolean;
+    execute: (stack: Frame[], graph: Graph) => Promise<Frame[]>;
+    cooldown?: number;
+    maxExecutions?: number;
+    terminal?: boolean;
+    onUse?: (stack: Frame[], result: NavigationResult) => void;
+}
+export interface ActionState {
+    cooldownUntil: number;
+    executionCount: number;
+    executed?: boolean;
+    lastResult?: NavigationResult;
+}
+/**
+ * Config du NavigationEngine
+ */
+export interface NavigationEngineConfig {
+    mode: EngineMode;
+    graph: Graph;
+    trail?: import('../navigation/Trail.js').Trail;
+    initialStack?: Frame[];
+    actions?: ScheduleAction[];
+    pathQuery?: PathQuery;
+}
+/**
+ * Résultat d'un step d'exécution
+ */
+export interface EngineStepResult {
+    time: number;
+    mode: EngineMode;
+    phase?: 'RESOLVE' | 'EXECUTE' | 'COMPLETE';
+    selectedAction?: string;
+    resolvedCount?: number;
+    unresolvedCount?: number;
+    path?: NavigationPath;
+    result?: NavigationResult;
+}
+/**
+ * Chemin trouvé par PATHFIND — riche en métadonnées
+ * pour les formatters (ligne, direction, correspondance)
+ */
+export interface NavigationPath {
+    nodes: string[];
+    edges: GraphEdge[];
+    totalWeight: number;
+}
+export interface NavigationResult {
+    type: 'SUCCESS' | 'FAIL' | 'DEFER';
+    reason?: string;
+    data?: any;
+}
+export interface CacheStats {
+    entries: number;
+    size: number;
+    sizeFormatted: string;
+    maxSize: number;
+    usage: string;
+    hits: number;
+    misses: number;
+    hitRate: string;
+}
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/types/index.js

@@ -0,0 +1,21 @@
+/**
+ * LinkLab Core Types
+ * * Base type definitions for the entire system
+ */
+export class LinkLabError extends Error {
+    code;
+    details;
+    constructor(message, code, details) {
+        super(message);
+        this.code = code;
+        this.details = details;
+        this.name = 'LinkLabError';
+    }
+}
+export class ProviderError extends LinkLabError {
+    constructor(message, details) {
+        super(message, 'PROVIDER_ERROR', details);
+        this.name = 'ProviderError';
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAgPH,MAAM,OAAO,YAAa,SAAQ,KAAK;IAG5B;IACA;IAHT,YACE,OAAe,EACR,IAAY,EACZ,OAAa;QAEpB,KAAK,CAAC,OAAO,CAAC,CAAA;QAHP,SAAI,GAAJ,IAAI,CAAQ;QACZ,YAAO,GAAP,OAAO,CAAM;QAGpB,IAAI,CAAC,IAAI,GAAG,cAAc,CAAA;IAC5B,CAAC;CACF;AAED,MAAM,OAAO,aAAc,SAAQ,YAAY;IAC7C,YAAY,OAAe,EAAE,OAAa;QACxC,KAAK,CAAC,OAAO,EAAE,gBAAgB,EAAE,OAAO,CAAC,CAAA;QACzC,IAAI,CAAC,IAAI,GAAG,eAAe,CAAA;IAC7B,CAAC;CACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@linklabjs/core",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "type": "module",
   "description": "LinkLab core — semantic navigation graph engine",
   "author": "Charley Simon",