@ruso-0/nreki 6.0.0

package/dist/hologram/harvester.js

@@ -0,0 +1,129 @@
+/**
+ * harvester.ts - Background .d.ts extractor for hologram mode.
+ *
+ * Extracts real .d.ts declarations from the TypeScript compiler during idle time,
+ * replacing heuristic Tree-sitter shadows with compiler-grade ones.
+ *
+ * Cooperative scheduler: processes 3 files per event loop cycle using setImmediate.
+ * Epoch-aware: aborts if kernel.logicalTime changed (new edit arrived).
+ * TS4023 errors: marks file as UNPRUNABLE_FOREVER in the cache.
+ */
+// ─── Harvester ───────────────────────────────────────────────────────
+export class DtsHarvester {
+    kernel;
+    cache;
+    queue = new Set();
+    isHarvesting = false;
+    constructor(kernel, cache) {
+        this.kernel = kernel;
+        this.cache = cache;
+    }
+    /** Queue files for .d.ts harvest during idle time. */
+    queueForHarvest(unprunableFiles) {
+        for (const file of unprunableFiles) {
+            if (!this.cache.isUnprunableForever(file)) {
+                this.queue.add(file);
+            }
+        }
+        if (!this.isHarvesting && this.queue.size > 0) {
+            this.startHarvesting(this.kernel.getLogicalTime()).catch(() => { });
+        }
+    }
+    /** Abort current harvest (called when an edit arrives). */
+    abort() {
+        this.isHarvesting = false;
+    }
+    /**
+     * Cooperative scheduler: 3 files per event loop cycle.
+     * Uses setImmediate to yield the event loop between batches.
+     * Aborts if kernel.logicalTime changed (new edit arrived).
+     */
+    async startHarvesting(epochId) {
+        if (this.isHarvesting) {
+            return { filesHarvested: 0, filesMarkedUnprunable: 0, aborted: false, durationMs: 0 };
+        }
+        this.isHarvesting = true;
+        const t0 = performance.now();
+        let filesHarvested = 0;
+        let filesMarkedUnprunable = 0;
+        const BATCH_SIZE = 3;
+        const files = Array.from(this.queue);
+        this.queue.clear();
+        for (let i = 0; i < files.length; i += BATCH_SIZE) {
+            // Abort check: stop if abort() was called or a new edit has arrived
+            if (!this.isHarvesting || this.kernel.getLogicalTime() !== epochId) {
+                this.isHarvesting = false;
+                return {
+                    filesHarvested,
+                    filesMarkedUnprunable,
+                    aborted: true,
+                    durationMs: performance.now() - t0,
+                };
+            }
+            const batch = files.slice(i, i + BATCH_SIZE);
+            for (const filePath of batch) {
+                const result = this.harvestSingleFile(filePath);
+                if (result === "harvested") {
+                    filesHarvested++;
+                }
+                else if (result === "unprunable") {
+                    filesMarkedUnprunable++;
+                }
+            }
+            // Yield event loop for cooperative scheduling
+            if (i + BATCH_SIZE < files.length) {
+                await new Promise(resolve => {
+                    if (typeof globalThis.setImmediate === "function") {
+                        setImmediate(resolve);
+                    }
+                    else {
+                        setTimeout(resolve, 0);
+                    }
+                });
+            }
+        }
+        this.isHarvesting = false;
+        return {
+            filesHarvested,
+            filesMarkedUnprunable,
+            aborted: false,
+            durationMs: performance.now() - t0,
+        };
+    }
+    /**
+     * Harvest a single file: extract real .d.ts from the compiler.
+     * Returns "harvested" on success, "unprunable" if TS4023, or "skipped".
+     */
+    harvestSingleFile(filePath) {
+        const program = this.kernel.getProgram();
+        if (!program)
+            return "skipped";
+        const sourceFile = program.getSourceFile(filePath);
+        if (!sourceFile)
+            return "skipped";
+        let dtsContent = "";
+        let hasTs4023 = false;
+        const emitResult = program.emit(sourceFile, (fileName, text) => {
+            if (fileName.endsWith(".d.ts")) {
+                dtsContent = text;
+            }
+        }, undefined, true);
+        // Check for TS4023: "Exported variable has or is using name from external module"
+        for (const diag of emitResult.diagnostics) {
+            if (diag.code === 4023) {
+                hasTs4023 = true;
+                break;
+            }
+        }
+        if (hasTs4023) {
+            this.cache.markAsUnprunableForever(filePath);
+            return "unprunable";
+        }
+        if (dtsContent) {
+            this.cache.setShadow(filePath, dtsContent, "harvested");
+            return "harvested";
+        }
+        return "skipped";
+    }
+}
+//# sourceMappingURL=harvester.js.map

package/dist/hologram/harvester.js.map

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

package/dist/hologram/shadow-cache.d.ts

@@ -0,0 +1,49 @@
+/**
+ * shadow-cache.ts - Disk persistence for holographic shadows.
+ *
+ * Persists generated .d.ts shadows between sessions so project re-scans
+ * are incremental. Uses a manifest file for mtime/hash-based staleness
+ * detection and a version guard to invalidate the entire cache when
+ * nrekiVersion or tsVersion changes.
+ *
+ * Cache directory: .nreki/shadows/
+ * Manifest file:   .nreki/shadows/manifest.json
+ */
+export interface ShadowManifest {
+    nrekiVersion: string;
+    tsVersion: string;
+    files: Record<string, {
+        mtime: number;
+        hash: string;
+        status: "pruned" | "unprunable" | "unprunable-forever" | "harvested";
+    }>;
+}
+export declare class ShadowCache {
+    private cacheDir;
+    private manifestPath;
+    private manifest;
+    private shadows;
+    constructor(projectRoot: string);
+    /** Load manifest from disk. Returns the in-memory shadow content map. */
+    load(): Map<string, string>;
+    /** Persist manifest and all shadow content to disk. */
+    save(shadows: Map<string, string>): void;
+    /** Set or update a shadow entry. */
+    setShadow(tsPath: string, content: string, status: "pruned" | "unprunable" | "unprunable-forever" | "harvested"): void;
+    /** Get cached shadow content from the in-memory map. */
+    getShadow(tsPath: string): string | undefined;
+    /** Get files whose mtime has changed since last scan. */
+    getStaleFiles(currentMtimes: Map<string, number>): string[];
+    /** Mark a file as permanently unprunable (e.g., TS4023 errors). */
+    markAsUnprunableForever(tsPath: string): void;
+    /** Check if a file is marked as permanently unprunable. */
+    isUnprunableForever(tsPath: string): boolean;
+    /** Get the current manifest. */
+    getManifest(): ShadowManifest;
+    /** Set version info. Clears cache if versions don't match. */
+    setVersions(nrekiVersion: string, tsVersion: string): boolean;
+    /** Clear entire cache (version guard triggered). */
+    clear(): void;
+    private getShadowFilePath;
+}
+//# sourceMappingURL=shadow-cache.d.ts.map

package/dist/hologram/shadow-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shadow-cache.d.ts","sourceRoot":"","sources":["../../src/hologram/shadow-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAQH,MAAM,WAAW,cAAc;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE;QAClB,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,QAAQ,GAAG,YAAY,GAAG,oBAAoB,GAAG,WAAW,CAAC;KACxE,CAAC,CAAC;CACN;AAID,qBAAa,WAAW;IACpB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,OAAO,CAA6B;gBAEhC,WAAW,EAAE,MAAM;IAM/B,yEAAyE;IACzE,IAAI,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;IA2B3B,uDAAuD;IACvD,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAiBxC,oCAAoC;IACpC,SAAS,CACL,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,QAAQ,GAAG,YAAY,GAAG,oBAAoB,GAAG,WAAW,GACrE,IAAI;IAWP,wDAAwD;IACxD,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAQ7C,yDAAyD;IACzD,aAAa,CAAC,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,EAAE;IAqB3D,mEAAmE;IACnE,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAS7C,2DAA2D;IAC3D,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAI5C,gCAAgC;IAChC,WAAW,IAAI,cAAc;IAI7B,8DAA8D;IAC9D,WAAW,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO;IAe7D,oDAAoD;IACpD,KAAK,IAAI,IAAI;IAkBb,OAAO,CAAC,iBAAiB;CAK5B"}

package/dist/hologram/shadow-cache.js

@@ -0,0 +1,165 @@
+/**
+ * shadow-cache.ts - Disk persistence for holographic shadows.
+ *
+ * Persists generated .d.ts shadows between sessions so project re-scans
+ * are incremental. Uses a manifest file for mtime/hash-based staleness
+ * detection and a version guard to invalidate the entire cache when
+ * nrekiVersion or tsVersion changes.
+ *
+ * Cache directory: .nreki/shadows/
+ * Manifest file:   .nreki/shadows/manifest.json
+ */
+import fs from "fs";
+import path from "path";
+import crypto from "crypto";
+// ─── Shadow Cache ────────────────────────────────────────────────────
+export class ShadowCache {
+    cacheDir;
+    manifestPath;
+    manifest;
+    shadows = new Map();
+    constructor(projectRoot) {
+        this.cacheDir = path.join(projectRoot, ".nreki", "shadows");
+        this.manifestPath = path.join(this.cacheDir, "manifest.json");
+        this.manifest = { nrekiVersion: "", tsVersion: "", files: {} };
+    }
+    /** Load manifest from disk. Returns the in-memory shadow content map. */
+    load() {
+        this.shadows.clear();
+        if (!fs.existsSync(this.manifestPath))
+            return this.shadows;
+        try {
+            const raw = fs.readFileSync(this.manifestPath, "utf-8");
+            this.manifest = JSON.parse(raw);
+        }
+        catch {
+            this.manifest = { nrekiVersion: "", tsVersion: "", files: {} };
+            return this.shadows;
+        }
+        // Load individual shadow files
+        for (const [tsPath, entry] of Object.entries(this.manifest.files)) {
+            if (entry.status === "pruned" || entry.status === "harvested") {
+                const shadowPath = this.getShadowFilePath(tsPath);
+                if (fs.existsSync(shadowPath)) {
+                    try {
+                        this.shadows.set(tsPath, fs.readFileSync(shadowPath, "utf-8"));
+                    }
+                    catch { /* skip corrupted shadow */ }
+                }
+            }
+        }
+        return this.shadows;
+    }
+    /** Persist manifest and all shadow content to disk. */
+    save(shadows) {
+        if (!fs.existsSync(this.cacheDir)) {
+            fs.mkdirSync(this.cacheDir, { recursive: true });
+        }
+        // Write individual shadow files
+        for (const [tsPath, content] of shadows) {
+            const shadowPath = this.getShadowFilePath(tsPath);
+            const dir = path.dirname(shadowPath);
+            if (!fs.existsSync(dir))
+                fs.mkdirSync(dir, { recursive: true });
+            fs.writeFileSync(shadowPath, content, "utf-8");
+        }
+        // Write manifest
+        fs.writeFileSync(this.manifestPath, JSON.stringify(this.manifest, null, 2), "utf-8");
+    }
+    /** Set or update a shadow entry. */
+    setShadow(tsPath, content, status) {
+        const hash = crypto.createHash("sha256").update(content).digest("hex").slice(0, 16);
+        let mtime = 0;
+        try {
+            mtime = fs.statSync(path.normalize(tsPath)).mtimeMs;
+        }
+        catch { /* file may not exist */ }
+        this.manifest.files[tsPath] = { mtime, hash, status };
+        this.shadows.set(tsPath, content);
+    }
+    /** Get cached shadow content from the in-memory map. */
+    getShadow(tsPath) {
+        const entry = this.manifest.files[tsPath];
+        if (!entry || (entry.status !== "pruned" && entry.status !== "harvested")) {
+            return undefined;
+        }
+        return this.shadows.get(tsPath);
+    }
+    /** Get files whose mtime has changed since last scan. */
+    getStaleFiles(currentMtimes) {
+        const stale = [];
+        for (const [tsPath, entry] of Object.entries(this.manifest.files)) {
+            const currentMtime = currentMtimes.get(tsPath);
+            if (currentMtime === undefined) {
+                // File was deleted
+                stale.push(tsPath);
+            }
+            else if (Math.abs(currentMtime - entry.mtime) > 1) {
+                // mtime changed (1ms tolerance for filesystem precision)
+                stale.push(tsPath);
+            }
+        }
+        // Also add files not in manifest (new files)
+        for (const tsPath of currentMtimes.keys()) {
+            if (!(tsPath in this.manifest.files)) {
+                stale.push(tsPath);
+            }
+        }
+        return stale;
+    }
+    /** Mark a file as permanently unprunable (e.g., TS4023 errors). */
+    markAsUnprunableForever(tsPath) {
+        const existing = this.manifest.files[tsPath];
+        if (existing) {
+            existing.status = "unprunable-forever";
+        }
+        else {
+            this.manifest.files[tsPath] = { mtime: 0, hash: "", status: "unprunable-forever" };
+        }
+    }
+    /** Check if a file is marked as permanently unprunable. */
+    isUnprunableForever(tsPath) {
+        return this.manifest.files[tsPath]?.status === "unprunable-forever";
+    }
+    /** Get the current manifest. */
+    getManifest() {
+        return this.manifest;
+    }
+    /** Set version info. Clears cache if versions don't match. */
+    setVersions(nrekiVersion, tsVersion) {
+        if (this.manifest.nrekiVersion &&
+            (this.manifest.nrekiVersion !== nrekiVersion || this.manifest.tsVersion !== tsVersion)) {
+            this.clear();
+            this.manifest.nrekiVersion = nrekiVersion;
+            this.manifest.tsVersion = tsVersion;
+            return true; // Cache was invalidated
+        }
+        this.manifest.nrekiVersion = nrekiVersion;
+        this.manifest.tsVersion = tsVersion;
+        return false;
+    }
+    /** Clear entire cache (version guard triggered). */
+    clear() {
+        this.manifest = {
+            nrekiVersion: this.manifest.nrekiVersion,
+            tsVersion: this.manifest.tsVersion,
+            files: {},
+        };
+        this.shadows.clear();
+        // Remove shadow files from disk
+        if (fs.existsSync(this.cacheDir)) {
+            try {
+                fs.rmSync(this.cacheDir, { recursive: true, force: true });
+                fs.mkdirSync(this.cacheDir, { recursive: true });
+            }
+            catch { /* best effort */ }
+        }
+    }
+    // ─── Private ─────────────────────────────────────────────────────
+    getShadowFilePath(tsPath) {
+        // Use hash of tsPath for flat storage to avoid deep directory trees
+        const hash = crypto.createHash("sha256").update(tsPath).digest("hex").slice(0, 16);
+        return path.join(this.cacheDir, `${hash}.d.ts`);
+    }
+}
+//# sourceMappingURL=shadow-cache.js.map

package/dist/hologram/shadow-cache.js.map

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

package/dist/hologram/shadow-generator.d.ts

@@ -0,0 +1,32 @@
+/**
+ * shadow-generator.ts -Tree-sitter based TypeScript file classifier and .d.ts shadow generator.
+ *
+ * Classifies TypeScript files as PRUNABLE (all exports have explicit type annotations)
+ * or UNPRUNABLE (any export relies on type inference). For prunable files, generates
+ * lightweight .d.ts shadow content that preserves structural type information.
+ *
+ * Uses Tree-sitter for accurate AST walking, not regex.
+ */
+import Parser from "web-tree-sitter";
+import { ParserPool } from "../parser-pool.js";
+export interface ClassifyResult {
+    prunable: boolean;
+    shadow: string | null;
+    reasons: string[];
+    category: "explicit" | "inferred" | "no-exports";
+}
+export interface ScanStats {
+    total: number;
+    pruned: number;
+    unpruned: number;
+    noExports: number;
+}
+export interface ScanResult {
+    prunable: Map<string, string>;
+    unprunable: Set<string>;
+    ambientFiles: string[];
+    stats: ScanStats;
+}
+export declare function classifyAndGenerateShadow(filePath: string, content: string, parser: Parser, language: Parser.Language): ClassifyResult;
+export declare function scanProject(rootDir: string, parserPool: ParserPool): Promise<ScanResult>;
+//# sourceMappingURL=shadow-generator.d.ts.map

package/dist/hologram/shadow-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shadow-generator.d.ts","sourceRoot":"","sources":["../../src/hologram/shadow-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,MAAM,MAAM,iBAAiB,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAM/C,MAAM,WAAW,cAAc;IAC3B,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,UAAU,GAAG,UAAU,GAAG,YAAY,CAAC;CACpD;AAED,MAAM,WAAW,SAAS;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACvB,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACxB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,KAAK,EAAE,SAAS,CAAC;CACpB;AA8tBD,wBAAgB,yBAAyB,CACrC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,CAAC,QAAQ,GAC1B,cAAc,CAuChB;AAkCD,wBAAsB,WAAW,CAC7B,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,UAAU,GACvB,OAAO,CAAC,UAAU,CAAC,CA4FrB"}