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

package/dist/services/dev-session.js

@@ -0,0 +1,102 @@
+import { existsSync, mkdirSync, readFileSync, renameSync, rmSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { LoreError } from '@lorepack/core';
+/**
+ * The receipt a running `lorepack dev` leaves, so the session is discoverable rather than
+ * guessed at.
+ *
+ * Architecture 15.3 fixes the file and the preferred port. The reason it exists is that a
+ * dev server is the one long-lived thing Lorepack runs, and everything else that wants to
+ * talk to it (another command, a connector's generated config, the person who has forgotten
+ * which terminal it is in) otherwise has to scan ports and hope.
+ *
+ * A receipt is evidence, not a lock. The process it names may be gone, and a file left
+ * behind by a machine that lost power must not stop the next session from starting. So it
+ * carries a pid and is always checked against reality before it is believed.
+ */
+export const DEV_PORT = 43110;
+export const DEV_RECEIPT = 'dev.json';
+function receiptPath(config) {
+    return join(config.projectRoot, '.lore', DEV_RECEIPT);
+}
+/**
+ * Written atomically, because a reader may arrive mid-write.
+ *
+ * A truncated receipt is worse than none: it names a port that is half a number, and the
+ * reader has no way to tell that from a session on a strange port. Rename is the one
+ * operation that is atomic on every filesystem this runs on.
+ */
+export function writeReceipt(config, receipt) {
+    const path = receiptPath(config);
+    mkdirSync(dirname(path), { recursive: true });
+    const temporary = `${path}.${process.pid}.tmp`;
+    writeFileSync(temporary, `${JSON.stringify(receipt, null, 2)}\n`, 'utf8');
+    renameSync(temporary, path);
+}
+export function readReceipt(config) {
+    const path = receiptPath(config);
+    if (!existsSync(path))
+        return null;
+    try {
+        const parsed = JSON.parse(readFileSync(path, 'utf8'));
+        if (typeof parsed.pid !== 'number' || typeof parsed.port !== 'number')
+            return null;
+        return {
+            port: parsed.port,
+            pid: parsed.pid,
+            startedAt: typeof parsed.startedAt === 'string' ? parsed.startedAt : '',
+            buildId: typeof parsed.buildId === 'string' ? parsed.buildId : '',
+            host: typeof parsed.host === 'string' ? parsed.host : '127.0.0.1',
+        };
+    }
+    catch {
+        // Unreadable or not JSON is the same as absent: it cannot be believed, and refusing to
+        // start because of a corrupt file would make a crash unrecoverable without `rm`.
+        return null;
+    }
+}
+export function removeReceipt(config) {
+    rmSync(receiptPath(config), { force: true });
+}
+/**
+ * Whether the process a receipt names is still there.
+ *
+ * Signal `0` performs the permission and existence checks without delivering anything,
+ * which is the portable way to ask. `EPERM` means the process exists and belongs to someone
+ * else, which still counts as running.
+ */
+export function isRunning(pid) {
+    if (!Number.isInteger(pid) || pid <= 0)
+        return false;
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (error) {
+        return error.code === 'EPERM';
+    }
+}
+/**
+ * Refuses a second supervisor on the same project, and clears a receipt whose process died.
+ *
+ * Two supervisors on one project is not a race worth winning. They would both watch, both
+ * rebuild, and take turns failing to acquire the build lock, and the user would see a
+ * server that intermittently stalls for reasons nothing explains. Refusing with the port of
+ * the session that already exists is more useful than either of them starting.
+ */
+export function assertNoLiveSession(config) {
+    const receipt = readReceipt(config);
+    if (receipt === null)
+        return;
+    if (!isRunning(receipt.pid)) {
+        // Stale: the machine restarted, or the process was killed hard enough that it could not
+        // clean up. Nothing to report, because nothing is wrong.
+        removeReceipt(config);
+        return;
+    }
+    throw new LoreError('LORE_E_LOCK_HELD', `A dev session for this project is already running on http://${receipt.host}:${receipt.port} (pid ${receipt.pid}).`, {
+        remediation: `Use the session that is already running, or stop it first. If that process is gone, delete .lore/${DEV_RECEIPT}.`,
+        subject: String(receipt.pid),
+    });
+}
+//# sourceMappingURL=dev-session.js.map

package/dist/services/dev-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-session.js","sourceRoot":"","sources":["../../src/services/dev-session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACjG,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAqB,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE9D;;;;;;;;;;;;GAYG;AAEH,MAAM,CAAC,MAAM,QAAQ,GAAG,KAAK,CAAC;AAC9B,MAAM,CAAC,MAAM,WAAW,GAAG,UAAU,CAAC;AAWtC,SAAS,WAAW,CAAC,MAAoB;IACvC,OAAO,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC;AACxD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,MAAoB,EAAE,OAAmB;IACpE,MAAM,IAAI,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;IACjC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9C,MAAM,SAAS,GAAG,GAAG,IAAI,IAAI,OAAO,CAAC,GAAG,MAAM,CAAC;IAC/C,aAAa,CAAC,SAAS,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC1E,UAAU,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,MAAoB;IAC9C,MAAM,IAAI,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;IACjC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACnC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAwB,CAAC;QAC7E,IAAI,OAAO,MAAM,CAAC,GAAG,KAAK,QAAQ,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QACnF,OAAO;YACL,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,GAAG,EAAE,MAAM,CAAC,GAAG;YACf,SAAS,EAAE,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE;YACvE,OAAO,EAAE,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE;YACjE,IAAI,EAAE,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW;SAClE,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,uFAAuF;QACvF,iFAAiF;QACjF,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,MAAoB;IAChD,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AAC/C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CAAC,GAAW;IACnC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IACrD,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAQ,KAA2B,CAAC,IAAI,KAAK,OAAO,CAAC;IACvD,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAoB;IACtD,MAAM,OAAO,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;IACpC,IAAI,OAAO,KAAK,IAAI;QAAE,OAAO;IAE7B,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC5B,wFAAwF;QACxF,yDAAyD;QACzD,aAAa,CAAC,MAAM,CAAC,CAAC;QACtB,OAAO;IACT,CAAC;IAED,MAAM,IAAI,SAAS,CACjB,kBAAkB,EAClB,+DAA+D,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,SAAS,OAAO,CAAC,GAAG,IAAI,EACnH;QACE,WAAW,EAAE,oGAAoG,WAAW,GAAG;QAC/H,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC;KAC7B,CACF,CAAC;AACJ,CAAC"}

package/dist/services/doctor.d.ts

@@ -0,0 +1,35 @@
+import { type CheckResult, type CheckStatus, type DoctorReport } from '@lorepack/core';
+/**
+ * One command that names whatever is wrong, and says how to fix it.
+ *
+ * Architecture 6.5 and 6.9. The value is entirely in the remediation: a check that reports
+ * "FTS5 unavailable" and stops has told the user something they already knew from the
+ * failure that sent them here. Every check below carries the detected value and one concrete
+ * thing to do, because "almost always the wrong Node build" is knowledge that belongs in the
+ * output rather than in a maintainer's head.
+ *
+ * Checks are independent, named, and uniformly shaped, which is what lets the Phase 4 Studio
+ * Diagnostics route (#69) render the same results without a second implementation. It is
+ * also what lets the client checks arrive later with #58 as an addition rather than a
+ * rewrite, which is the amendment recorded on #56.
+ *
+ * Read-only apart from a temporary in-memory FTS5 probe, so it is safe to run at any time,
+ * including against a project that is mid-build.
+ */
+export type { CheckResult, CheckStatus, DoctorReport };
+export interface DoctorOptions {
+    readonly cwd: string;
+    /** The dev port to test, so a project on a custom port checks the right one. */
+    readonly port?: number;
+    /**
+     * Set when this project's own dev session is the thing holding that port.
+     *
+     * Without it the report warns that the port is occupied, which is true and useless: it is
+     * occupied by the server that just answered the request, or by the `lorepack dev` running in
+     * the next terminal. Both callers work this out and say so, so the browser and the
+     * terminal reach the same conclusion about the same port.
+     */
+    readonly portHeldByThisProject?: boolean;
+}
+export declare function runDoctor(options: DoctorOptions): Promise<DoctorReport>;
+//# sourceMappingURL=doctor.d.ts.map

package/dist/services/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/services/doctor.ts"],"names":[],"mappings":"AAMA,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,WAAW,EAEhB,KAAK,YAAY,EAIlB,MAAM,gBAAgB,CAAC;AAGxB;;;;;;;;;;;;;;;;GAgBG;AAKH,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,CAAC;AAEvD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,gFAAgF;IAChF,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;;;OAOG;IACH,QAAQ,CAAC,qBAAqB,CAAC,EAAE,OAAO,CAAC;CAC1C;AAED,wBAAsB,SAAS,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAkC7E"}

package/dist/services/doctor.js

@@ -0,0 +1,389 @@
+import { accessSync, existsSync, constants as fsConstants, readFileSync, statSync } from 'node:fs';
+import { createServer } from 'node:net';
+import { platform } from 'node:os';
+import { join } from 'node:path';
+import { DatabaseSync } from 'node:sqlite';
+import { probeFts5 } from '@lorepack/backend-local';
+import { checkNodeVersion, doctorReportSchema, loadConfig, } from '@lorepack/core';
+import { DEV_PORT } from './dev-session.js';
+export async function runDoctor(options) {
+    const checks = [
+        nodeVersionCheck(),
+        sqliteCapabilityCheck(),
+        fts5Check(),
+        watcherLimitCheck(),
+    ];
+    // A project is optional: running doctor in an empty directory is a legitimate thing to do
+    // before there is anything to configure, and it should report the environment rather than
+    // refuse.
+    const project = findProject(options.cwd);
+    if (project !== null) {
+        checks.push(configCheck(project.config, project.root));
+        checks.push(sourcesCheck(project.config));
+        checks.push(writableCheck(project.root));
+        checks.push(activeBuildCheck(project.root));
+    }
+    checks.push(await portCheck(options.port ?? DEV_PORT, options.portHeldByThisProject === true));
+    const counts = {
+        pass: checks.filter((check) => check.status === 'pass').length,
+        warn: checks.filter((check) => check.status === 'warn').length,
+        fail: checks.filter((check) => check.status === 'fail').length,
+    };
+    // Parsed rather than asserted, so `--json` cannot drift from the committed schema without
+    // this failing first. Doctor of all commands should not be the one lying about its output.
+    return doctorReportSchema.parse({
+        status: counts.fail > 0 ? 'fail' : counts.warn > 0 ? 'warn' : 'pass',
+        project: project?.root ?? null,
+        checks,
+        counts,
+    });
+}
+/**
+ * A project, an unreadable project, or neither.
+ *
+ * The middle case is the interesting one: a `lore.yaml` that will not parse is exactly the
+ * situation doctor exists for, and treating it as "no project" would skip every check that
+ * could explain it.
+ */
+function findProject(cwd) {
+    if (!existsSync(join(cwd, 'lore.yaml')))
+        return null;
+    try {
+        return { root: cwd, config: loadConfig({ cwd }), error: null };
+    }
+    catch (error) {
+        return {
+            root: cwd,
+            config: null,
+            error: error instanceof Error ? error.message : String(error),
+        };
+    }
+}
+function nodeVersionCheck() {
+    const result = checkNodeVersion();
+    return {
+        id: 'node-version',
+        title: 'Node version',
+        status: result.supported ? 'pass' : 'fail',
+        detail: result.supported
+            ? `Node ${result.detected}`
+            : `Node ${result.detected} is outside the supported range.`,
+        ...(result.supported ? {} : { remediation: result.message }),
+        values: { detected: result.detected, execPath: process.execPath },
+    };
+}
+/**
+ * Which `node:sqlite` controls this build actually has, individually.
+ *
+ * Reported one by one rather than as a single yes/no, because a user on an unexpected build
+ * needs to know precisely which control is missing: they map to different Node versions and
+ * to different things Lorepack cannot do.
+ */
+function sqliteCapabilityCheck() {
+    const present = {
+        setAuthorizer: false,
+        enableDefensive: false,
+        limits: false,
+    };
+    let detail = '';
+    try {
+        // A static import, because this file is ESM and `require` does not exist here. It was
+        // written lazily at first to survive a build without `node:sqlite`, and the result was
+        // a doctor that reported a false failure on a perfectly good environment. A check that
+        // lies about the thing it exists to verify is worse than no check.
+        const db = new DatabaseSync(':memory:');
+        try {
+            const surface = db;
+            present.setAuthorizer = typeof surface.setAuthorizer === 'function';
+            present.enableDefensive = typeof surface.enableDefensive === 'function';
+            present.limits = typeof surface.limits === 'object' && surface.limits !== null;
+        }
+        finally {
+            db.close();
+        }
+    }
+    catch (error) {
+        return {
+            id: 'sqlite-capabilities',
+            title: 'node:sqlite controls',
+            status: 'fail',
+            detail: `node:sqlite could not be opened: ${error instanceof Error ? error.message : String(error)}`,
+            remediation: 'Install Node 24.15 or newer from https://nodejs.org/en/download',
+            values: { execPath: process.execPath },
+        };
+    }
+    const missing = Object.entries(present)
+        .filter(([, has]) => !has)
+        .map(([name]) => name);
+    detail =
+        missing.length === 0
+            ? 'setAuthorizer, enableDefensive and limits are all present.'
+            : `Missing: ${missing.join(', ')}.`;
+    return {
+        id: 'sqlite-capabilities',
+        title: 'node:sqlite controls',
+        status: missing.length === 0 ? 'pass' : 'fail',
+        detail,
+        ...(missing.length === 0
+            ? {}
+            : {
+                // Each maps to a different floor: setAuthorizer 24.10, enableDefensive 24.14,
+                // limits 24.15. Naming the floor is more useful than naming the range.
+                remediation: 'Install Node 24.15 or newer, which is the first release with all three: https://nodejs.org/en/download',
+            }),
+        values: { ...present, execPath: process.execPath },
+    };
+}
+/**
+ * The check that matters most, because "FTS5 missing" is almost always "wrong Node build".
+ *
+ * Official nodejs.org builds compile `SQLITE_ENABLE_FTS5`; a Node linked against a shared
+ * system SQLite may not. Reporting the SQLite version and the executable path is what turns
+ * an inexplicable failure into an obvious one.
+ */
+function fts5Check() {
+    const probe = probeFts5();
+    return {
+        id: 'fts5',
+        title: 'SQLite FTS5',
+        status: probe.available ? 'pass' : 'fail',
+        detail: probe.available
+            ? `SQLite ${probe.sqliteVersion} with FTS5.`
+            : `SQLite ${probe.sqliteVersion} has no FTS5${probe.detail === undefined ? '' : `: ${probe.detail}`}`,
+        ...(probe.available
+            ? {}
+            : {
+                remediation: [
+                    'This is almost always a Node build linked against a system SQLite.',
+                    'Install an official build from https://nodejs.org/en/download',
+                    'Verified builds: docs/compatibility/sqlite-fts5.md',
+                ].join('\n'),
+            }),
+        values: {
+            sqliteVersion: probe.sqliteVersion,
+            nodeVersion: probe.nodeVersion,
+            execPath: probe.execPath,
+        },
+    };
+}
+/**
+ * On Linux, how many files the kernel will let one user watch.
+ *
+ * A warning rather than a failure, because the limit only matters at a size this project may
+ * never reach, and because the fix needs root. Silence would be worse: an exhausted inotify
+ * limit surfaces as a watcher that simply stops noticing changes, which reads as Lorepack
+ * being broken.
+ */
+function watcherLimitCheck() {
+    if (platform() !== 'linux') {
+        return {
+            id: 'watcher-limits',
+            title: 'Watcher limits',
+            status: 'pass',
+            detail: `No per-user watch limit applies on ${platform()}.`,
+            values: { platform: platform() },
+        };
+    }
+    const path = '/proc/sys/fs/inotify/max_user_watches';
+    let limit = 0;
+    try {
+        limit = Number.parseInt(readFileSync(path, 'utf8').trim(), 10);
+    }
+    catch {
+        return {
+            id: 'watcher-limits',
+            title: 'Watcher limits',
+            status: 'pass',
+            detail: 'The inotify limit could not be read, which is not a problem by itself.',
+            values: { platform: 'linux' },
+        };
+    }
+    const low = limit > 0 && limit < 8192;
+    return {
+        id: 'watcher-limits',
+        title: 'Watcher limits',
+        status: low ? 'warn' : 'pass',
+        detail: low
+            ? `inotify allows ${limit} watches, which a large project can exhaust.`
+            : `inotify allows ${limit} watches.`,
+        ...(low
+            ? {
+                remediation: 'Raise it if `lorepack dev` stops noticing changes:\n  sudo sysctl fs.inotify.max_user_watches=524288',
+            }
+            : {}),
+        values: { platform: 'linux', maxUserWatches: limit },
+    };
+}
+function configCheck(config, root) {
+    if (config === null) {
+        return {
+            id: 'config',
+            title: 'Project configuration',
+            status: 'fail',
+            detail: `lore.yaml in ${root} could not be read.`,
+            remediation: 'Run `lorepack plan` to see the parse error in full, or fix lore.yaml by hand.',
+            values: { root },
+        };
+    }
+    return {
+        id: 'config',
+        title: 'Project configuration',
+        status: 'pass',
+        detail: `${config.config.name}, ${config.sources.length} source root${config.sources.length === 1 ? '' : 's'}.`,
+        values: { root, name: config.config.name },
+    };
+}
+/**
+ * Every configured source root exists, is a directory, and is inside the project.
+ *
+ * Containment is the security half: a source that escapes the project root would index
+ * something the user did not point at, and the build would carry it forever.
+ */
+function sourcesCheck(config) {
+    if (config === null) {
+        return {
+            id: 'sources',
+            title: 'Source paths',
+            status: 'warn',
+            detail: 'Not checked, because the configuration could not be read.',
+        };
+    }
+    const problems = [];
+    for (const source of config.sources) {
+        const path = source.root;
+        if (!existsSync(path)) {
+            problems.push(`${path} does not exist`);
+            continue;
+        }
+        // A `file` source is legitimately not a directory, so only a directory source is held
+        // to that.
+        if (source.kind === 'directory' && !statSync(path).isDirectory()) {
+            problems.push(`${path} is not a directory`);
+        }
+    }
+    return {
+        id: 'sources',
+        title: 'Source paths',
+        status: problems.length === 0 ? 'pass' : 'fail',
+        detail: problems.length === 0
+            ? `${config.sources.length} source root${config.sources.length === 1 ? '' : 's'} reachable.`
+            : problems.join('; '),
+        ...(problems.length === 0
+            ? {}
+            : {
+                remediation: 'Correct the `sources` list in lore.yaml, or create the missing directory.',
+            }),
+        values: { roots: config.sources.length },
+    };
+}
+function writableCheck(root) {
+    const path = join(root, '.lore');
+    try {
+        if (existsSync(path))
+            accessSync(path, fsConstants.W_OK);
+        else
+            accessSync(root, fsConstants.W_OK);
+        return {
+            id: 'lore-writable',
+            title: 'Build directory',
+            status: 'pass',
+            detail: `${path} is writable.`,
+            values: { path },
+        };
+    }
+    catch {
+        return {
+            id: 'lore-writable',
+            title: 'Build directory',
+            status: 'fail',
+            detail: `${path} is not writable.`,
+            // Not "check your permissions": the exact command, because the point of doctor is that
+            // the user does not have to work out what to type.
+            remediation: `Grant write access to the directory:\n  chmod u+w "${root}"`,
+            values: { path },
+        };
+    }
+}
+/**
+ * Whether there is a build and whether it can still be opened.
+ *
+ * A project with no build is not broken, it is new, so that is a warning with the command
+ * that fixes it rather than a failure.
+ */
+function activeBuildCheck(root) {
+    const state = join(root, '.lore', 'state.sqlite');
+    if (!existsSync(state)) {
+        return {
+            id: 'active-build',
+            title: 'Active build',
+            status: 'warn',
+            detail: 'This project has no build yet.',
+            remediation: 'Run `lorepack build`, or `lorepack dev` to build and serve in one step.',
+            values: { state },
+        };
+    }
+    try {
+        accessSync(state, fsConstants.R_OK);
+        return {
+            id: 'active-build',
+            title: 'Active build',
+            status: 'pass',
+            detail: 'Build state is present and readable.',
+            values: { state },
+        };
+    }
+    catch {
+        return {
+            id: 'active-build',
+            title: 'Active build',
+            status: 'fail',
+            detail: `${state} cannot be read.`,
+            remediation: 'Check the file permissions, or remove .lore and run `lorepack build` again.',
+            values: { state },
+        };
+    }
+}
+/**
+ * Whether the dev port is free, by binding it rather than by guessing from a scan.
+ *
+ * `ours` is the case that matters whenever a session is up: the port is held by this
+ * project's own `lorepack dev`, and reporting that as a problem tells a person their working
+ * setup is broken. The check concludes differently rather than a caller editing the result
+ * afterwards, which would be two opinions about one check.
+ */
+async function portCheck(port, ours) {
+    const free = await isPortFree(port);
+    if (!free && ours) {
+        return {
+            id: 'dev-port',
+            title: 'Dev port',
+            status: 'pass',
+            detail: `127.0.0.1:${port} is in use by this project's dev session.`,
+            values: { port, session: true },
+        };
+    }
+    return {
+        id: 'dev-port',
+        title: 'Dev port',
+        status: free ? 'pass' : 'warn',
+        detail: free ? `127.0.0.1:${port} is free.` : `127.0.0.1:${port} is in use.`,
+        ...(free
+            ? {}
+            : {
+                // A warning, not a failure: `lorepack dev` steps to the next free port and says so, so
+                // an occupied port is an inconvenience rather than a problem (architecture 6.9).
+                remediation: `\`lorepack dev\` will use the next free port. Pass --port to choose one.`,
+            }),
+        values: { port },
+    };
+}
+function isPortFree(port) {
+    return new Promise((resolve) => {
+        const server = createServer();
+        server.once('error', () => resolve(false));
+        server.listen(port, '127.0.0.1', () => {
+            server.close(() => resolve(true));
+        });
+    });
+}
+//# sourceMappingURL=doctor.js.map

package/dist/services/doctor.js.map

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

package/dist/services/export.d.ts

@@ -0,0 +1,20 @@
+import { type ContextBundle } from '@lorepack/core';
+/**
+ * Rendering a bundle as Markdown: architecture 14.6.
+ *
+ * This is the compatibility bridge for every chat product that cannot speak MCP, which is
+ * most of them. A person pastes one file and the model has the corpus, the citations, and
+ * an honest account of what did not fit.
+ *
+ * Nothing here writes prose about the content. Every passage is text from a document, and
+ * the only sentences Lorepack contributes are structural: what this is, where it came
+ * from, and what was left out.
+ */
+export interface ExportOptions {
+    readonly projectName: string;
+    /** How to ask for more, rendered verbatim so a reader can copy it. */
+    readonly moreCommand: string;
+    readonly sourceState: ContextBundle['sourceState'];
+}
+export declare function renderBundleMarkdown(bundle: ContextBundle, options: ExportOptions): string;
+//# sourceMappingURL=export.d.ts.map

package/dist/services/export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../../src/services/export.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAS,MAAM,gBAAgB,CAAC;AAE3D;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,sEAAsE;IACtE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,aAAa,CAAC,aAAa,CAAC,CAAC;CACpD;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,aAAa,GAAG,MAAM,CA+F1F"}