@pencere/cli 0.0.0-stage → 0.1.0

package/dist/server-process.js

@@ -0,0 +1,322 @@
+/**
+ * An MCP server that is a process: JSON-RPC messages, one to a line, on its stdin
+ * and stdout (MCP's stdio transport), seen from the client's side.
+ *
+ * This is the one place a server is started. Discovery asks a server what it has
+ * with it, and the adapter that stands in for the program's MCP server on the
+ * terminal's stream (`connector.ts`) forwards to it, so both see the same
+ * environment, the same process group and the same ending.
+ *
+ * Why this and not `StdioClientTransport` of the MCP client package: that one
+ * passes a server six environment variables and no more, which would make a
+ * server start differently under pencere than under the chat client whose
+ * configuration the person copied; and it cannot start the server in a process
+ * group of its own. The server must have one. ⌃C is a signal of the terminal to
+ * the foreground group, the pencere program's own, and a server that took it too
+ * would die before the program had said `bye`, and a Python server would print a
+ * traceback for what the person meant as "close this". The server is ended by the
+ * program that started it: its stdin closes, which every stdio server takes as
+ * the end, then SIGTERM and SIGKILL to its whole group, which catches what a
+ * wrapper (`npx`, `uv run`, `sh -c`) started. A server that leaves on its own when its
+ * stdin closes, or falls, leaves what it started behind in the group, and that gets the
+ * same two endings: the group is the program's to end, not only the process that leads it.
+ */
+import { ReadBuffer, serializeMessage } from "@modelcontextprotocol/client";
+import { spawn } from "node:child_process";
+export const CLOSE_TIMING = { stdin: 1500, term: 1500, kill: 2000 };
+/** After a process ended, how long to wait for the last of its output before letting go of its pipes. */
+const PIPE_GRACE = 250;
+/** How often the process table is asked whether a group is gone, in milliseconds. */
+const GROUP_POLL = 20;
+const LIMITS = { line: 10 * 1024 * 1024 };
+/** The process could not be started. */
+export class StartError extends Error {
+    command;
+    constructor(command, cause) {
+        super(`cannot start "${command}": ${reason(cause)}`, { cause });
+        this.name = "StartError";
+        this.command = command;
+    }
+}
+function reason(error) {
+    const code = error.code;
+    if (code === "ENOENT")
+        return "no such file or directory (is it installed, and on PATH?)";
+    if (code === "EACCES")
+        return "permission denied";
+    return error.message;
+}
+function toError(value) {
+    return value instanceof Error ? value : new Error(String(value));
+}
+/** Resolves `true` when `promise` settles within `ms`, `false` when the time is up first. */
+async function within(promise, ms) {
+    let timer;
+    const late = new Promise((resolve) => {
+        timer = setTimeout(() => resolve(false), ms);
+    });
+    try {
+        return await Promise.race([promise.then(() => true), late]);
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+/** Whether anything is left of the process group `pid` leads. */
+function groupExists(pid) {
+    try {
+        process.kill(-pid, 0);
+        return true;
+    }
+    catch {
+        // Nothing there (ESRCH), or nothing that can be signalled: either way nothing to wait for.
+        return false;
+    }
+}
+/** Resolves `true` when the group is gone within `ms`, `false` when something is left. */
+async function groupGone(pid, ms) {
+    const deadline = Date.now() + ms;
+    while (groupExists(pid)) {
+        if (Date.now() >= deadline)
+            return false;
+        await new Promise((resolve) => setTimeout(resolve, GROUP_POLL));
+    }
+    return true;
+}
+/** The process of a stdio MCP server, as a transport for an MCP client, and a tool to end it. */
+export class ServerProcess {
+    onclose;
+    onerror;
+    onmessage;
+    /** The process has ended and what it wrote has been read: once, before `onclose`. */
+    onexit;
+    #spec;
+    #tail;
+    #timing;
+    #read;
+    #child;
+    #closing = false;
+    #shutdown;
+    /** The process has exited: what it did is known, and what is left is its pipes. */
+    #exited = false;
+    #ended = false;
+    /** The ending of what is left in the process's group, begun when the process ended. */
+    #sweeping = Promise.resolve();
+    #done;
+    #finished;
+    constructor(spec, tail, timing = CLOSE_TIMING, limits = LIMITS) {
+        this.#spec = spec;
+        this.#tail = tail;
+        this.#timing = timing;
+        this.#read = new ReadBuffer({ maxBufferSize: limits.line });
+        this.#done = new Promise((resolve) => {
+            this.#finished = resolve;
+        });
+    }
+    /** Resolves once the process has ended (never, if it was never started). */
+    get ended() {
+        return this.#done;
+    }
+    get pid() {
+        return this.#child?.pid;
+    }
+    /** Starts the process; it is running when this resolves. @throws {StartError} */
+    start() {
+        if (this.#child !== undefined)
+            return Promise.reject(new Error("the server process was started already"));
+        return new Promise((resolve, reject) => {
+            const child = spawn(this.#spec.command, [...this.#spec.args], {
+                stdio: ["pipe", "pipe", "pipe"],
+                // A process group of its own: see the description of this file.
+                detached: true,
+                shell: false,
+            });
+            this.#child = child;
+            let spawned = false;
+            // Not `once`: after the process runs, an error is a signal that was not sent or a write that
+            // did not go through, and there can be more than one; an `error` nobody listens for ends the program.
+            child.on("error", (error) => {
+                // Before `spawn` this is a program that could not be started; after, a signal
+                // or a write that did not go through.
+                if (spawned)
+                    this.onerror?.(error);
+                else {
+                    this.#ended = true;
+                    reject(new StartError(this.#spec.command, error));
+                }
+            });
+            child.once("spawn", () => {
+                spawned = true;
+                resolve();
+            });
+            // A write to a process that has gone fails with EPIPE, and `send` tells the caller
+            // so; the process's end is told by `onexit`, once, and is not an error as well.
+            child.stdin.on("error", () => { });
+            child.stdout.on("error", (error) => this.onerror?.(error));
+            child.stdout.on("data", (chunk) => this.#data(chunk));
+            child.stderr.on("error", () => { });
+            child.stderr.on("data", (chunk) => this.#tail.push(chunk));
+            let status;
+            let expected = false;
+            let timer;
+            /** What the process did, as it is known the moment it is: asked to end or not is decided then. */
+            const exited = (code, signal) => {
+                if (status !== undefined)
+                    return;
+                status = { code, signal };
+                expected = this.#closing;
+                this.#exited = true;
+            };
+            const end = () => {
+                if (!spawned || this.#ended)
+                    return;
+                clearTimeout(timer);
+                this.#ended = true;
+                // The last of its output is read or is not coming: a grandchild may hold the pipes.
+                for (const stream of [child.stdin, child.stdout, child.stderr])
+                    stream?.destroy();
+                this.#read.clear();
+                const exit = { ...(status ?? { code: null, signal: null }), expected };
+                this.#finished(exit);
+                this.onexit?.(exit);
+                this.onclose?.();
+                // Whatever the leader's end was, what it started is not ended with it: right now, with
+                // the group's number still its, what is left in the group is the program's to end.
+                this.#sweeping = this.#sweep();
+            };
+            child.once("exit", (code, signal) => {
+                exited(code, signal);
+                timer = setTimeout(end, PIPE_GRACE);
+            });
+            child.once("close", (code, signal) => {
+                exited(code, signal);
+                end();
+            });
+        });
+    }
+    /**
+     * What the server wrote to stdout: whole lines are messages, and the rest waits for its end. The
+     * chunk is read a line at a time, so that a line past the limit costs the lines around it
+     * nothing: the buffer that gives up on it gives up on what it holds, which is that line.
+     */
+    #data(chunk) {
+        let from = 0;
+        while (from < chunk.length) {
+            const newline = chunk.indexOf(0x0a, from);
+            const to = newline === -1 ? chunk.length : newline + 1;
+            this.#line(chunk.subarray(from, to));
+            from = to;
+        }
+    }
+    #line(piece) {
+        try {
+            this.#read.append(piece);
+        }
+        catch (error) {
+            // A line past the limit is dropped, and the next one is read as it comes.
+            this.onerror?.(toError(error));
+            return;
+        }
+        for (;;) {
+            let message;
+            try {
+                message = this.#read.readMessage();
+            }
+            catch (error) {
+                // A line that is JSON and is not a message: it is gone, and the lines after it are not.
+                this.onerror?.(toError(error));
+                continue;
+            }
+            if (message === null)
+                return;
+            try {
+                this.onmessage?.(message);
+            }
+            catch (error) {
+                this.onerror?.(toError(error));
+            }
+        }
+    }
+    send(message) {
+        const stdin = this.#child?.stdin;
+        if (this.#ended || this.#closing || !stdin?.writable)
+            return Promise.reject(new Error("the server process is not running"));
+        return new Promise((resolve, reject) => {
+            stdin.write(serializeMessage(message), (error) => error === null || error === undefined ? resolve() : reject(error));
+        });
+    }
+    /**
+     * Ends the process, as asked: its stdin closes, and if it has not left by itself
+     * its group gets SIGTERM and then SIGKILL. Resolves when it is gone. A process that
+     * is already gone, or was never started, is a close that has nothing to do.
+     */
+    close() {
+        this.#shutdown ??= this.#shutDown();
+        return this.#shutdown;
+    }
+    async #shutDown() {
+        const child = this.#child;
+        if (child === undefined)
+            return;
+        if (!this.#ended) {
+            // Exited by itself already: closing it is waiting for its pipes, which is not what it
+            // was that ended it.
+            if (this.#exited)
+                await this.#done;
+            else
+                await this.#end(child);
+        }
+        await this.#sweeping;
+    }
+    /** Asks the process to end, as its stdin closing does, and then makes it. */
+    async #end(child) {
+        this.#closing = true;
+        try {
+            child.stdin?.end();
+        }
+        catch {
+            // Closed already: the process is on its way out.
+        }
+        if (await within(this.#done, this.#timing.stdin))
+            return;
+        this.#signal("SIGTERM");
+        if (await within(this.#done, this.#timing.term))
+            return;
+        this.#signal("SIGKILL");
+        await within(this.#done, this.#timing.kill);
+    }
+    /**
+     * The process has ended: what is left in its group (a wrapper's child, `sh -c 'server &'`) is
+     * ended as a leader that would not leave is, SIGTERM and then SIGKILL. Called as the process
+     * ends, so that the group's number is still its and has not been given to another.
+     */
+    async #sweep() {
+        const pid = this.#child?.pid;
+        if (pid === undefined || !groupExists(pid))
+            return;
+        this.#signal("SIGTERM");
+        if (await groupGone(pid, this.#timing.term))
+            return;
+        this.#signal("SIGKILL");
+        await groupGone(pid, this.#timing.kill);
+    }
+    /** To the process's whole group; to the process alone where a group cannot be signalled. */
+    #signal(signal) {
+        const child = this.#child;
+        const pid = child?.pid;
+        if (child === undefined || pid === undefined)
+            return;
+        try {
+            process.kill(-pid, signal);
+        }
+        catch {
+            try {
+                child.kill(signal);
+            }
+            catch {
+                // Gone between the question and the signal.
+            }
+        }
+    }
+}
+//# sourceMappingURL=server-process.js.map

package/dist/server-process.js.map

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

package/dist/tail.d.ts

@@ -0,0 +1,28 @@
+/**
+ * The end of what a server wrote to its stderr.
+ *
+ * While a view is up the terminal's screen is the view's, so what the server says
+ * on stderr would be lost under the alternate screen. It is kept here instead,
+ * a bounded amount, the end of it (the cause of a failure is the last thing a
+ * server says), and shown on the screen the person gets back, if the server failed.
+ */
+/** How much is kept: enough for a stack trace, not for a server that never stops talking. */
+export declare const TAIL_LIMIT: number;
+export declare class Tail {
+    #private;
+    constructor(limit?: number);
+    /** Adds what the server wrote; a character cut between two chunks is kept whole. */
+    push(chunk: Uint8Array | string): void;
+    /** What is kept, as the person is shown it: text, not terminal commands (see {@link plain}). */
+    text(): string;
+    get empty(): boolean;
+    /** Forgets what is kept: it has been shown, and what comes next is about the next run of the server. */
+    clear(): void;
+}
+/**
+ * Text a server wrote, made safe to put on the person's terminal: what is not a
+ * character to read (an escape, which could be a command to the terminal, among
+ * them) is written out as `\u001b`, and a carriage return is a line end. Line ends and
+ * tabs stay.
+ */
+export declare function plain(text: string): string;

package/dist/tail.js

@@ -0,0 +1,57 @@
+/**
+ * The end of what a server wrote to its stderr.
+ *
+ * While a view is up the terminal's screen is the view's, so what the server says
+ * on stderr would be lost under the alternate screen. It is kept here instead,
+ * a bounded amount, the end of it (the cause of a failure is the last thing a
+ * server says), and shown on the screen the person gets back, if the server failed.
+ */
+import { StringDecoder } from "node:string_decoder";
+/** How much is kept: enough for a stack trace, not for a server that never stops talking. */
+export const TAIL_LIMIT = 16 * 1024;
+export class Tail {
+    #limit;
+    #decoder = new StringDecoder("utf8");
+    #text = "";
+    #dropped = false;
+    constructor(limit = TAIL_LIMIT) {
+        this.#limit = limit;
+    }
+    /** Adds what the server wrote; a character cut between two chunks is kept whole. */
+    push(chunk) {
+        this.#text += typeof chunk === "string" ? chunk : this.#decoder.write(Buffer.from(chunk));
+        if (this.#text.length <= this.#limit)
+            return;
+        this.#dropped = true;
+        const cut = this.#text.length - this.#limit;
+        // Whole lines: a line that begins in what was dropped is not worth showing half of.
+        const newline = this.#text.indexOf("\n", cut);
+        const whole = newline === -1 ? "" : this.#text.slice(newline + 1);
+        // A single line longer than the limit has no whole line to keep: its end is.
+        this.#text = whole === "" ? this.#text.slice(cut) : whole;
+    }
+    /** What is kept, as the person is shown it: text, not terminal commands (see {@link plain}). */
+    text() {
+        return (this.#dropped ? "[earlier output left out]\n" : "") + plain(this.#text);
+    }
+    get empty() {
+        return this.#text === "";
+    }
+    /** Forgets what is kept: it has been shown, and what comes next is about the next run of the server. */
+    clear() {
+        this.#text = "";
+        this.#dropped = false;
+    }
+}
+/**
+ * Text a server wrote, made safe to put on the person's terminal: what is not a
+ * character to read (an escape, which could be a command to the terminal, among
+ * them) is written out as `\u001b`, and a carriage return is a line end. Line ends and
+ * tabs stay.
+ */
+export function plain(text) {
+    return text.replace(/\r\n?/g, "\n").replace(
+    // C0 other than tab and line feed, DEL and C1.
+    /[\u0000-\u0008\u000b-\u001f\u007f-\u009f]/g, (c) => `\\u${c.charCodeAt(0).toString(16).padStart(4, "0")}`);
+}
+//# sourceMappingURL=tail.js.map

package/dist/tail.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tail.js","sourceRoot":"","sources":["../src/tail.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,6FAA6F;AAC7F,MAAM,CAAC,MAAM,UAAU,GAAG,EAAE,GAAG,IAAI,CAAC;AAEpC,MAAM,OAAO,IAAI;IACN,MAAM,CAAS;IACf,QAAQ,GAAG,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC;IAC9C,KAAK,GAAG,EAAE,CAAC;IACX,QAAQ,GAAG,KAAK,CAAC;IAEjB,YAAY,KAAK,GAAW,UAAU;QACpC,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;IACtB,CAAC;IAED,oFAAoF;IACpF,IAAI,CAAC,KAA0B;QAC7B,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QAC1F,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO;QAC7C,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC5C,oFAAoF;QACpF,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAC9C,MAAM,KAAK,GAAG,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC;QAClE,6EAA6E;QAC7E,IAAI,CAAC,KAAK,GAAG,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IAC5D,CAAC;IAED,gGAAgG;IAChG,IAAI;QACF,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,6BAA6B,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClF,CAAC;IAED,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,KAAK,KAAK,EAAE,CAAC;IAC3B,CAAC;IAED,wGAAwG;IACxG,KAAK;QACH,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;QAChB,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;IACxB,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,UAAU,KAAK,CAAC,IAAY;IAChC,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,OAAO;IACzC,+CAA+C;IAC/C,4CAA4C,EAC5C,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAC7D,CAAC;AACJ,CAAC"}

package/dist/watch.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Watching files with `node:fs`, for `pencere dev`.
+ *
+ * `fs.watch` says that something under a path changed, not what, and says it more
+ * than once for one write; that is enough, because `Reloader` waits for the files
+ * to be quiet and looks at what they hold before it acts. A directory is watched
+ * recursively; a file is watched through the directory it is in, because an
+ * editor that saves by writing a new file and renaming it over the old one leaves
+ * a watch on the file itself watching a file that is gone.
+ */
+/** What a watched path is for: the view's files, or the server's own. */
+export type Role = "view" | "server";
+/** A path to watch and what a change to it means. */
+export interface Root {
+    readonly path: string;
+    readonly role: Role;
+}
+/** A set of watches, to end. */
+export interface Watching {
+    close(): void;
+}
+/** Starts watching `roots`; `onChange` is told the role of a root something changed under. */
+export type Watch = (roots: readonly Root[], onChange: (role: Role) => void, onError: (message: string) => void) => Watching;
+/** A path that cannot be watched: it is not there, or the system would not. */
+export declare class WatchError extends Error {
+    readonly missing: boolean;
+    constructor(message: string, missing: boolean);
+}
+/**
+ * Whether a path under a watched directory is nothing a person edits: a name that
+ * begins with a dot (a view's own walk leaves them out too), the packages a
+ * project installs and the bytecode a language writes beside its source, which a
+ * server writes by running and so would end every run with a change.
+ */
+export declare function isNoise(relative: string): boolean;
+/**
+ * Watches `roots` with `fs.watch`.
+ *
+ * @throws {WatchError} when a root cannot be watched; what was started before it is ended.
+ */
+export declare const watchRoots: Watch;
+/**
+ * What the paths hold, in a form that changes when they do: the size and the
+ * modification time of every file under them, noise left out. A path that is not
+ * there is part of it, so that a file that went away is a change too.
+ */
+export declare function fingerprintOf(paths: readonly string[]): Promise<string>;

package/dist/watch.js

@@ -0,0 +1,146 @@
+/**
+ * Watching files with `node:fs`, for `pencere dev`.
+ *
+ * `fs.watch` says that something under a path changed, not what, and says it more
+ * than once for one write; that is enough, because `Reloader` waits for the files
+ * to be quiet and looks at what they hold before it acts. A directory is watched
+ * recursively; a file is watched through the directory it is in, because an
+ * editor that saves by writing a new file and renaming it over the old one leaves
+ * a watch on the file itself watching a file that is gone.
+ */
+import { statSync, watch as watchPath } from "node:fs";
+import { readdir, stat } from "node:fs/promises";
+import { basename, dirname, join } from "node:path";
+/** A path that cannot be watched: it is not there, or the system would not. */
+export class WatchError extends Error {
+    missing;
+    constructor(message, missing) {
+        super(message);
+        this.name = "WatchError";
+        this.missing = missing;
+    }
+}
+/**
+ * Whether a path under a watched directory is nothing a person edits: a name that
+ * begins with a dot (a view's own walk leaves them out too), the packages a
+ * project installs and the bytecode a language writes beside its source, which a
+ * server writes by running and so would end every run with a change.
+ */
+export function isNoise(relative) {
+    return relative
+        .split(/[\\/]/)
+        .some((part) => part.startsWith(".") || part === "node_modules" || part === "__pycache__");
+}
+function describe(error) {
+    const code = error?.code;
+    if (code === "ENOENT")
+        return "no such file or directory";
+    if (code === "EACCES")
+        return "permission denied";
+    if (code === "EMFILE" || code === "ENOSPC")
+        return "the system has no more watches to give";
+    return error instanceof Error ? error.message : String(error);
+}
+/**
+ * Watches `roots` with `fs.watch`.
+ *
+ * @throws {WatchError} when a root cannot be watched; what was started before it is ended.
+ */
+export const watchRoots = (roots, onChange, onError) => {
+    const watchers = [];
+    const close = () => {
+        for (const watcher of watchers.splice(0))
+            watcher.close();
+    };
+    try {
+        for (const root of roots)
+            watchers.push(watchRoot(root, onChange, onError));
+    }
+    catch (error) {
+        close();
+        throw error;
+    }
+    return { close };
+};
+function watchRoot(root, onChange, onError) {
+    let isDirectory;
+    try {
+        isDirectory = statSync(root.path).isDirectory();
+    }
+    catch (error) {
+        const missing = error?.code === "ENOENT";
+        throw new WatchError(`cannot watch ${root.path}: ${describe(error)}`, missing);
+    }
+    const heard = (name) => {
+        // `null` is a system that does not say which file: it may be this one.
+        if (name === null)
+            return onChange(root.role);
+        const text = name.toString();
+        if (isDirectory ? !isNoise(text) : text === basename(root.path))
+            onChange(root.role);
+    };
+    let watcher;
+    try {
+        watcher = isDirectory
+            ? watchPath(root.path, { recursive: true }, (_event, name) => heard(name))
+            : watchPath(dirname(root.path), (_event, name) => heard(name));
+    }
+    catch (error) {
+        throw new WatchError(`cannot watch ${root.path}: ${describe(error)}`, false);
+    }
+    watcher.on("error", (error) => {
+        watcher.close();
+        onError(`stopped watching ${root.path}: ${describe(error)}`);
+    });
+    return watcher;
+}
+/**
+ * What the paths hold, in a form that changes when they do: the size and the
+ * modification time of every file under them, noise left out. A path that is not
+ * there is part of it, so that a file that went away is a change too.
+ */
+export async function fingerprintOf(paths) {
+    const lines = [];
+    const visit = async (path) => {
+        let info;
+        try {
+            info = await stat(path);
+        }
+        catch {
+            lines.push(`${path} missing`);
+            return;
+        }
+        if (!info.isDirectory()) {
+            lines.push(`${path} ${info.size} ${info.mtimeMs}`);
+            return;
+        }
+        let entries;
+        try {
+            entries = await readdir(path, { withFileTypes: true });
+        }
+        catch {
+            lines.push(`${path} unreadable`);
+            return;
+        }
+        entries.sort((a, b) => (a.name < b.name ? -1 : a.name > b.name ? 1 : 0));
+        for (const entry of entries) {
+            // A link to a directory is not followed, so that a loop cannot trap the walk.
+            if (isNoise(entry.name) ||
+                (entry.isSymbolicLink() && (await isDirectoryLink(join(path, entry.name)))))
+                continue;
+            await visit(join(path, entry.name));
+        }
+    };
+    for (const path of paths)
+        await visit(path);
+    return lines.join("\n");
+}
+async function isDirectoryLink(path) {
+    try {
+        return (await stat(path)).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=watch.js.map

package/dist/watch.js.map

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