@lorepack/cli 0.0.0-stage → 0.1.0-alpha.0

package/dist/services/watch.js

@@ -0,0 +1,420 @@
+import { realpathSync, statSync } from 'node:fs';
+import { join, relative, sep } from 'node:path';
+import { createSourceMatcher, discover } from '@lorepack/compiler';
+import { LORE_DIRECTORY } from '@lorepack/core';
+import { watch as chokidarWatch } from 'chokidar';
+import { openStateStore } from './builds.js';
+import { readFreshness } from './status.js';
+export const WATCH_DEFAULTS = {
+    debounceMs: 150,
+    stabilityMs: 120,
+    pollMs: 40,
+    reconcileIntervalMs: 2000,
+};
+export function startWatching(options) {
+    const debounceMs = options.debounceMs ?? WATCH_DEFAULTS.debounceMs;
+    const stabilityMs = options.stabilityMs ?? WATCH_DEFAULTS.stabilityMs;
+    const pollMs = options.pollMs ?? WATCH_DEFAULTS.pollMs;
+    const reconcileIntervalMs = options.reconcileIntervalMs ?? WATCH_DEFAULTS.reconcileIntervalMs;
+    // The same rules discovery uses, so an event and a build cannot disagree about
+    // whether a file is a source of this project.
+    const matcher = createSourceMatcher(options.config);
+    /**
+     * The path the operating system will name in its own events.
+     *
+     * On Windows this is not a formality. A directory reached through an 8.3 short path, which
+     * is what `%TEMP%` under a long user name gives you (`C:\Users\RUNNER~1\...`), makes
+     * libuv abort:
+     *
+     *     Assertion failed: !_wcsnicmp(filename, dir, dirlen), file src\win\fs-event.c, line 72
+     *
+     * It compares the long name the OS reports against the short name it was asked to watch,
+     * they do not match, and the watcher dies. Resolving first means both sides are speaking
+     * about the same string. Symlinked roots have the same shape of problem on every platform.
+     */
+    const watchRoot = resolveRealPath(options.config.projectRoot);
+    const loreDirectory = join(options.config.projectRoot, LORE_DIRECTORY);
+    let state = 'clean';
+    /**
+     * The build `state` is a claim about.
+     *
+     * Freshness is never "the sources are clean", it is "the sources match *this build*", and
+     * the pointer can move without a single file changing. Activation and rollback do exactly
+     * that, and neither produces a filesystem event, so before #200 the cached answer went on
+     * describing the build that was active before: Studio's own write surface could make the
+     * header say "the sources match this build" about a build the sources had moved past.
+     */
+    let describedBuild = activeBuildId();
+    let rebuilds = 0;
+    let noOps = 0;
+    let closed = false;
+    let lastEventAt = null;
+    let lastRebuild = null;
+    /** Paths seen since the last settle, so the stability wait knows what to watch. */
+    let touched = new Set();
+    let timer = null;
+    let running = null;
+    /** A change arrived while a rebuild was in flight, so run again when it finishes. */
+    let again = false;
+    let chain = Promise.resolve();
+    const watcher = chokidarWatch(watchRoot, {
+        // Chokidar v4 removed glob support and v5 has not brought it back, so it is given a
+        // directory and our own matcher decides. Handing it patterns would be two matchers
+        // disagreeing about which files are sources.
+        ignored: (path) => excluded(path, watchRoot, matcher),
+        // The initial scan already happened: it was the build. Replaying it as events would
+        // rebuild an identical build on every startup.
+        ignoreInitial: true,
+        // Complementary to, not a replacement for, the stability wait below. Chokidar's version
+        // decides when to *emit*; ours decides when the bytes are worth hashing, and it is the
+        // one that runs against the paths a rebuild is about to read.
+        awaitWriteFinish: { stabilityThreshold: stabilityMs, pollInterval: pollMs },
+    });
+    const ready = new Promise((resolve) => {
+        watcher.on('ready', () => {
+            // Step 3. The scan/watch race: anything written between the build and this moment was
+            // seen by neither, so the only safe assumption is that something was.
+            chain = chain.then(async () => {
+                await settle('startup reconciliation');
+                resolve();
+            });
+        });
+    });
+    for (const event of ['add', 'change', 'unlink', 'addDir', 'unlinkDir']) {
+        watcher.on(event, (path) => {
+            if (closed)
+                return;
+            touched.add(path);
+            lastEventAt = new Date().toISOString();
+            schedule();
+        });
+    }
+    watcher.on('error', (error) => {
+        // A watcher that fell over must not leave the runtime confidently serving stale context.
+        // Reconciling is the recovery: it re-establishes truth from content rather than from a
+        // stream that has already proved unreliable.
+        options.warn(`Watcher error: ${error instanceof Error ? error.message : String(error)}. Reconciling from disk.\n`);
+        chain = chain.then(() => settle('watcher recovery'));
+    });
+    /**
+     * The floor under the event stream.
+     *
+     * Prescreens on paths, sizes and modification times, which is cheap, and only settles when
+     * that signature moved. A platform that delivers no event still converges within one
+     * interval, and a platform that delivers them promptly pays a directory scan every couple
+     * of seconds and finds nothing.
+     */
+    let signature = '';
+    const sweep = setInterval(() => {
+        if (closed)
+            return;
+        const current = metadataSignature(options.config);
+        if (current === signature)
+            return;
+        const first = signature === '';
+        signature = current;
+        // The first sweep only establishes a baseline: the build that just happened is what it
+        // would otherwise mistake for a change.
+        if (first)
+            return;
+        chain = chain.then(() => settle('sources changed'));
+    }, reconcileIntervalMs);
+    // Never hold the process open on its own account: the supervisor decides when to exit.
+    sweep.unref?.();
+    /**
+     * The active build, read from the pointer.
+     *
+     * One small transaction against the state database, which is what `/v1/build` already does
+     * once per request to name the build it is describing. `null` on any failure, which then
+     * compares unequal to a real id and drives a recompute: erring towards re-establishing is
+     * the safe direction, and a genuinely broken state database surfaces through the routes
+     * that read it properly rather than through a freshness annotation.
+     */
+    function activeBuildId() {
+        try {
+            const store = openStateStore(loreDirectory);
+            try {
+                return store.current()?.buildId ?? null;
+            }
+            finally {
+                store.close();
+            }
+        }
+        catch {
+            return null;
+        }
+    }
+    /** Freshness and the build it describes, written together so they cannot drift apart. */
+    function record(next) {
+        state = next;
+        describedBuild = activeBuildId();
+    }
+    function schedule() {
+        if (timer !== null)
+            clearTimeout(timer);
+        // Step 4. One save is many events, and a rename is a delete plus an add. Coalescing is
+        // what turns an editor's write pattern into one rebuild.
+        timer = setTimeout(() => {
+            timer = null;
+            chain = chain.then(() => settle('sources changed'));
+        }, debounceMs);
+    }
+    /** Steps 5 to 9, once per settled burst of events. */
+    async function settle(reason) {
+        if (closed)
+            return;
+        const paths = [...touched];
+        touched = new Set();
+        await waitForStability(paths, stabilityMs, pollMs);
+        if (closed)
+            return;
+        // Whatever the sweep sees next is measured from here, so the rebuild this settle is
+        // about to perform is not mistaken for a further change.
+        signature = metadataSignature(options.config);
+        // Step 6 and 7. The deciding evidence. A touch, an atomic rename of identical bytes, or
+        // a save that changed nothing all land here and stop.
+        const freshness = await readFreshness({ config: options.config });
+        if (freshness.sourceState === 'clean') {
+            record('clean');
+            if (reason !== 'startup reconciliation') {
+                noOps += 1;
+                options.warn('No changes: the sources still match the active build.\n');
+            }
+            return;
+        }
+        record('dirty');
+        await run(reason);
+    }
+    /**
+     * Re-establish freshness without rebuilding.
+     *
+     * The distinction from `settle` is the whole point. `settle` treats "dirty" as a reason to
+     * build, which is right for an edit and catastrophic for an activation: rolling back to an
+     * older build makes the sources dirty by definition, and a rebuild here would immediately
+     * activate a new build and undo the rollback the reader just asked for.
+     */
+    async function reestablish() {
+        if (closed)
+            return;
+        try {
+            const freshness = await readFreshness({ config: options.config });
+            record(freshness.sourceState);
+        }
+        catch {
+            // Leave it unknown. A failure to establish freshness is not evidence of freshness,
+            // and invariant 6 makes `unknown` the only honest answer available here.
+        }
+    }
+    /** Steps 8 and 9, serialized, and cancelled by anything newer. */
+    async function run(reason) {
+        if (running !== null) {
+            // Supersede: the candidate in flight is already answering an out-of-date question.
+            again = true;
+            running.abort();
+            return;
+        }
+        const controller = new AbortController();
+        running = controller;
+        const startedAt = Date.now();
+        try {
+            options.warn(`${reason}: rebuilding.\n`);
+            const result = await options.rebuild(controller.signal);
+            if (result.created)
+                rebuilds += 1;
+            // After the pointer moved, so `clean` is recorded against the build that is now active.
+            record('clean');
+            lastRebuild = {
+                at: new Date().toISOString(),
+                durationMs: Date.now() - startedAt,
+                created: result.created,
+                failed: false,
+            };
+        }
+        catch (error) {
+            // Recorded whether it succeeded or not. A rebuild that keeps failing is the exact
+            // case someone opens Diagnostics to understand, and a status that only ever showed
+            // successes would show nothing at all.
+            lastRebuild = {
+                at: new Date().toISOString(),
+                durationMs: Date.now() - startedAt,
+                created: false,
+                failed: !controller.signal.aborted,
+            };
+            if (controller.signal.aborted) {
+                // Cancelled by a newer change. `runBuild` removes its own incomplete candidate and
+                // leaves activation alone, so there is nothing to clean up and nothing to report.
+                record('dirty');
+            }
+            else {
+                // Architecture 6.9: a failed rebuild keeps the previous build active and says why.
+                // Serving stale context is recoverable; exiting the supervisor is not.
+                record('dirty');
+                options.warn(`Rebuild failed, so the previous build is still active: ${error instanceof Error ? error.message : String(error)}\n`);
+            }
+        }
+        finally {
+            running = null;
+        }
+        if (again && !closed) {
+            again = false;
+            await settle('superseded by a newer change');
+        }
+    }
+    return {
+        ready,
+        get rebuilds() {
+            return rebuilds;
+        },
+        get noOps() {
+            return noOps;
+        },
+        async freshness() {
+            const active = activeBuildId();
+            if (active === describedBuild)
+                return state;
+            // The pointer moved without a source file changing, which is what an activation or a
+            // rollback is, from Studio or from a terminal running alongside this session. The
+            // cached answer belongs to the build that was active before it.
+            //
+            // Reported `unknown` rather than recomputed here: establishing freshness walks and
+            // hashes the corpus, and `/v1/build` is on the request path of every Studio poll and
+            // every MCP call. The recompute is queued instead, so the next read is accurate and
+            // this one is honest. Invariant 6: `unknown` means unknown, never clean.
+            state = 'unknown';
+            describedBuild = active;
+            chain = chain.then(reestablish);
+            return state;
+        },
+        status() {
+            return {
+                state,
+                watchedPaths: countWatched(watcher.getWatched()),
+                lastEventAt,
+                lastRebuild,
+                rebuilds,
+                noOps,
+            };
+        },
+        async close() {
+            closed = true;
+            clearInterval(sweep);
+            if (timer !== null)
+                clearTimeout(timer);
+            running?.abort();
+            await watcher.close();
+            // Let an in-flight settle unwind rather than tearing out from under it.
+            await chain.catch(() => undefined);
+        },
+    };
+}
+/**
+ * Step 5. Holds until size and modification time stop moving on every touched path.
+ *
+ * An editor that writes in chunks, and a large copy, both produce a file that exists and is
+ * incomplete. Hashing it produces a real hash of the wrong bytes, a build gets created and
+ * activated, and the next save produces another. Waiting is cheaper than being wrong.
+ */
+async function waitForStability(paths, stabilityMs, pollMs) {
+    if (paths.length === 0)
+        return;
+    let previous = signature(paths);
+    let stableFor = 0;
+    const deadline = Date.now() + 5000;
+    while (stableFor < stabilityMs && Date.now() < deadline) {
+        await new Promise((resolve) => setTimeout(resolve, pollMs));
+        const current = signature(paths);
+        stableFor = current === previous ? stableFor + pollMs : 0;
+        previous = current;
+    }
+}
+/**
+ * A cheap signature of the source tree: path, size and modification time.
+ *
+ * Evidence of nothing on its own, which is the point. A file can change without its mtime
+ * moving, so this only decides whether to go and compute the hashes that do decide.
+ */
+function metadataSignature(config) {
+    try {
+        const discovered = discover({ config, allowLargeProject: true });
+        return discovered.artifacts
+            .map((artifact) => {
+            const path = join(config.projectRoot, artifact.relativePath);
+            try {
+                const stats = statSync(path);
+                return `${artifact.relativePath}:${stats.size}:${stats.mtimeMs}`;
+            }
+            catch {
+                return `${artifact.relativePath}:gone`;
+            }
+        })
+            .join('\n');
+    }
+    catch {
+        // A source tree that cannot be walked is not a reason to fail: returning a stable
+        // marker means the sweep simply finds nothing until it can be read again.
+        return 'unscannable';
+    }
+}
+function signature(paths) {
+    return paths
+        .map((path) => {
+        try {
+            const stats = statSync(path);
+            return `${path}:${stats.size}:${stats.mtimeMs}`;
+        }
+        catch {
+            // Gone is a stable state: a delete is a change like any other.
+            return `${path}:gone`;
+        }
+    })
+        .join('\n');
+}
+/**
+ * Whether a path is outside what this project indexes.
+ *
+ * Canonicalized to POSIX separators before matching, because the rules are written that way
+ * and the paths arrive native. Architecture 12.11 states the rule generally: internal ids
+ * use POSIX separators while filesystem calls use native paths.
+ */
+function excluded(path, watchRoot, matcher) {
+    const relativePath = relative(watchRoot, path);
+    if (relativePath === '')
+        return false;
+    // Outside the project entirely, which chokidar can ask about for a symlinked parent.
+    if (relativePath.startsWith('..'))
+        return true;
+    const canonical = relativePath.split(sep).join('/');
+    // Never watch our own output: a build writes into `.lore`, which would trigger a rebuild,
+    // which would write into `.lore`.
+    if (canonical === '.lore' || canonical.startsWith('.lore/'))
+        return true;
+    return matcher.excludes(canonical);
+}
+/**
+ * The canonical path, or the original when it cannot be resolved.
+ *
+ * Falling back rather than throwing: a project that cannot be `realpath`ed is a project the
+ * build has already read successfully, so refusing to watch it would be a worse answer than
+ * watching it by the name we were given.
+ */
+/**
+ * Files under watch, from chokidar's directory-to-entries map.
+ *
+ * Directories are counted too, because they are what a watcher actually holds a handle on,
+ * and a number that excluded them would not match what an operating system limit is about.
+ */
+function countWatched(watched) {
+    let total = 0;
+    for (const entries of Object.values(watched))
+        total += entries.length;
+    return total;
+}
+export function resolveRealPath(path) {
+    try {
+        return realpathSync.native(path);
+    }
+    catch {
+        return path;
+    }
+}
+//# sourceMappingURL=watch.js.map

package/dist/services/watch.js.map

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

package/package.json

@@ -1,6 +1,75 @@
 {
   "name": "@lorepack/cli",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0-alpha.0",
+  "description": "The Lorepack command line interface.",
+  "license": "Apache-2.0",
+  "type": "module",
+  "engines": {
+    "node": ">=24.15 <25"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/public-index.js"
+    }
+  },
+  "main": "./dist/public-index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "studio-dist"
+  ],
+  "scripts": {
+    "build": "tsc -b && node ../../scripts/bundle-cli.mjs",
+    "clean": "rm -rf dist *.tsbuildinfo"
+  },
+  "dependencies": {
+    "@hono/node-server": "2.0.12",
+    "@modelcontextprotocol/client": "2.2.0",
+    "@modelcontextprotocol/hono": "2.0.0",
+    "@modelcontextprotocol/node": "2.0.0",
+    "@modelcontextprotocol/server": "2.0.0",
+    "chokidar": "5.0.0",
+    "commander": "15.0.0",
+    "csv-parse": "7.0.2",
+    "hono": "4.13.7",
+    "jose": "6.2.7",
+    "jsonc-parser": "3.3.1",
+    "mammoth": "1.12.0",
+    "mdast-util-from-markdown": "2.0.2",
+    "pdfjs-dist": "6.2.108",
+    "rehype-parse": "9.0.1",
+    "remark-frontmatter": "5.0.0",
+    "remark-gfm": "4.0.1",
+    "remark-parse": "11.0.0",
+    "sax": "1.6.1",
+    "smol-toml": "1.9.0",
+    "unified": "11.0.5",
+    "yaml": "2.9.0",
+    "yauzl": "3.4.0",
+    "yazl": "3.3.1"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/burakdede/lorepack.git",
+    "directory": "packages/cli"
+  },
+  "bin": {
+    "lorepack": "./dist/public-entry.js"
+  },
+  "devDependencies": {
+    "@lorepack/backend-local": "workspace:*",
+    "@lorepack/compiler": "workspace:*",
+    "@lorepack/connect-clients": "workspace:*",
+    "@lorepack/core": "workspace:*",
+    "@lorepack/deploy-cloudflare": "workspace:*",
+    "@lorepack/mcp": "workspace:*",
+    "@lorepack/parsers": "workspace:*",
+    "@lorepack/runtime": "workspace:*",
+    "@lorepack/test-support": "workspace:*"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  }
+}