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

package/dist/services/status.js

@@ -0,0 +1,203 @@
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { openReadOnly } from '@lorepack/backend-local';
+import { compareFingerprints, discover, fingerprintSources } from '@lorepack/compiler';
+import { count, LORE_DIRECTORY, LoreError, } from '@lorepack/core';
+import { readActiveBuild, readBuildCatalog } from './project.js';
+export async function readStatus(options) {
+    const { config } = options;
+    const now = options.now ?? (() => new Date());
+    const loreDirectory = join(config.projectRoot, LORE_DIRECTORY);
+    const discovery = discover({
+        config,
+        ...(options.progress === undefined ? {} : { progress: options.progress }),
+        ...(options.allowLargeProject === undefined
+            ? {}
+            : { allowLargeProject: options.allowLargeProject }),
+    });
+    const fingerprint = await fingerprintSources({
+        artifacts: discovery.artifacts,
+        ...(options.progress === undefined ? {} : { progress: options.progress }),
+    });
+    const active = readActiveBuild(loreDirectory);
+    const previous = active === null ? null : readBuildCatalog(loreDirectory, active.buildId);
+    if (active === null || previous === null) {
+        return {
+            formatVersion: 1,
+            projectName: config.config.name,
+            activeBuildId: null,
+            activeBuildAt: null,
+            buildAgeSeconds: null,
+            sourceState: 'unbuilt',
+            decidedBy: 'content-hash',
+            artifacts: { total: fingerprint.artifacts.length, added: 0, changed: 0, removed: 0 },
+            changes: [],
+            warnings: discovery.warnings.length,
+            remediation: 'lorepack build',
+        };
+    }
+    const dirty = compareFingerprints(fingerprint.artifacts, previous.artifactHashes);
+    const pathOf = pathResolver(fingerprint.artifacts);
+    const createdAt = readBuildCreatedAt(loreDirectory, active.buildId);
+    return {
+        formatVersion: 1,
+        projectName: config.config.name,
+        activeBuildId: active.buildId,
+        activeBuildAt: createdAt,
+        buildAgeSeconds: createdAt === null
+            ? null
+            : Math.max(0, Math.floor((now().getTime() - Date.parse(createdAt)) / 1000)),
+        sourceState: dirty.clean ? 'clean' : 'dirty',
+        decidedBy: 'content-hash',
+        artifacts: {
+            total: fingerprint.artifacts.length,
+            added: dirty.added.length,
+            changed: dirty.changed.length,
+            removed: dirty.removed.length,
+        },
+        changes: [
+            ...dirty.added.map((id) => ({ path: pathOf(id), change: 'added' })),
+            ...dirty.changed.map((id) => ({ path: pathOf(id), change: 'changed' })),
+            ...dirty.removed.map((id) => ({ path: pathOf(id), change: 'removed' })),
+        ].sort((a, b) => (a.path < b.path ? -1 : a.path > b.path ? 1 : 0)),
+        warnings: countBuildWarnings(loreDirectory, active.buildId) ?? discovery.warnings.length,
+        remediation: dirty.clean ? null : 'lorepack build',
+    };
+}
+/**
+ * Freshness for a read-only command: an annotation on the answer, never a precondition
+ * for it.
+ *
+ * Section 4.10 says freshness travels with the result, and it is tempting to read that as
+ * "establish it or fail". That reading cost `lorepack search` its usefulness on any project
+ * above the file envelope: the build existed and was perfectly queryable, and the query was
+ * refused because a guard about the cost of *building* had been consulted first (#147). A
+ * read of a sealed build is not entitled to have an opinion about the source tree.
+ *
+ * So two things differ from `readStatus`:
+ *
+ * - **The envelope does not apply.** It bounds what Lorepack promises about build
+ *   performance, not what it will answer from a build it already made.
+ * - **Nothing here can fail the command.** A source tree that is enormous, unreadable or
+ *   gone leaves freshness `unknown`, which is precisely what the contract's third state
+ *   means, and the caller still gets the build's answer.
+ *
+ * Invariant 6 applies to the degraded case too: `unknown` says Lorepack does not know, and
+ * never that the sources are clean.
+ */
+export async function readFreshness(options) {
+    try {
+        const status = await readStatus({ ...options, allowLargeProject: true });
+        return {
+            sourceState: status.sourceState === 'unbuilt' ? 'unknown' : status.sourceState,
+            reason: null,
+        };
+    }
+    catch (error) {
+        const degraded = degradedFreshness(error);
+        if (degraded === null)
+            throw error;
+        return degraded;
+    }
+}
+/**
+ * Which failures are allowed to become `unknown`, and which must still be raised.
+ *
+ * An allowlist rather than a bare `catch`. Swallowing everything would turn a corrupt
+ * state database into the cheerful and false statement "freshness unknown", which is the
+ * kind of helpfulness that hides a real defect for a phase or two. These three all mean
+ * "something about the source tree stopped us looking", and none of them says anything
+ * about whether the build being read is sound.
+ */
+export function degradedFreshness(error) {
+    if (!(error instanceof LoreError))
+        return null;
+    const degradable = new Set([
+        'LORE_E_ENVELOPE_EXCEEDED',
+        'LORE_E_PATH_ESCAPE',
+        'LORE_E_CASE_COLLISION',
+    ]);
+    if (!degradable.has(error.code))
+        return null;
+    return { sourceState: 'unknown', reason: error.message };
+}
+function pathResolver(artifacts) {
+    const byId = new Map(artifacts.map((artifact) => [artifact.artifactId, artifact.relativePath]));
+    // A removed artifact is no longer on disk, so its path comes from the id, which carries
+    // the source name and the relative path by construction.
+    return (artifactId) => byId.get(artifactId) ?? artifactId.split(':').slice(1).join(':');
+}
+function readBuildCreatedAt(loreDirectory, buildId) {
+    const statePath = join(loreDirectory, 'state.sqlite');
+    if (!existsSync(statePath))
+        return null;
+    const db = openReadOnly(statePath);
+    try {
+        const row = db.prepare('SELECT created_at FROM builds WHERE build_id = ?').get(buildId);
+        return row?.created_at ?? null;
+    }
+    finally {
+        db.close();
+    }
+}
+/** Warnings as the active build recorded them, which is what the AI is actually reading. */
+function countBuildWarnings(loreDirectory, buildId) {
+    const path = join(loreDirectory, 'builds', buildId, 'context.sqlite');
+    if (!existsSync(path))
+        return null;
+    const db = openReadOnly(path);
+    try {
+        const row = db.prepare('SELECT count(*) AS n FROM build_warnings').get();
+        return Number(row.n);
+    }
+    finally {
+        db.close();
+    }
+}
+export function renderStatus(status, verbose) {
+    const lines = [`Project ${status.projectName}`];
+    if (status.activeBuildId === null) {
+        lines.push('');
+        lines.push('No build yet.');
+        lines.push(`  ${count(status.artifacts.total, 'source file')} found`);
+        lines.push('');
+        lines.push('Run `lorepack build` to compile and activate the first build.');
+        return lines.join('\n');
+    }
+    lines.push(`Active build ${status.activeBuildId.slice(0, 17)} (${formatAge(status.buildAgeSeconds)})`);
+    lines.push('');
+    lines.push(status.sourceState === 'clean'
+        ? `Sources are clean. ${count(status.artifacts.total, 'artifact')}, decided by content hash.`
+        : `Sources are dirty: ${status.artifacts.added} added, ${status.artifacts.changed} changed, ${status.artifacts.removed} removed.`);
+    if (verbose && status.changes.length > 0) {
+        lines.push('');
+        for (const kind of ['added', 'changed', 'removed']) {
+            const paths = status.changes.filter((change) => change.change === kind);
+            if (paths.length === 0)
+                continue;
+            lines.push(`${kind}:`);
+            for (const change of paths)
+                lines.push(`  ${change.path}`);
+        }
+    }
+    if (status.warnings > 0) {
+        lines.push(`${count(status.warnings, 'warning')} in the active build.`);
+    }
+    if (status.remediation !== null) {
+        lines.push('');
+        lines.push(`Run \`${status.remediation}\` to make the active context current.`);
+    }
+    return lines.join('\n');
+}
+function formatAge(seconds) {
+    if (seconds === null)
+        return 'age unknown';
+    if (seconds < 60)
+        return `${seconds}s ago`;
+    if (seconds < 3600)
+        return `${Math.floor(seconds / 60)}m ago`;
+    if (seconds < 86400)
+        return `${Math.floor(seconds / 3600)}h ago`;
+    return `${Math.floor(seconds / 86400)}d ago`;
+}
+//# sourceMappingURL=status.js.map

package/dist/services/status.js.map

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

package/dist/services/studio-assets.d.ts

@@ -0,0 +1,13 @@
+/** Where `vite build` writes, relative to this module once compiled into `dist/`. */
+export declare function studioRoot(): string;
+export declare function studioIsBuilt(root?: string): boolean;
+export type AssetHandler = (request: Request) => Response | null;
+/**
+ * Reads one file per request, or returns null so the caller's typed 404 still applies.
+ *
+ * Files are read rather than held in memory: this serves one developer on loopback, the
+ * whole bundle is a few hundred kilobytes, and the operating system's page cache is better
+ * at this than a hand-rolled map would be.
+ */
+export declare function createStudioAssets(root?: string): AssetHandler;
+//# sourceMappingURL=studio-assets.d.ts.map

package/dist/services/studio-assets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"studio-assets.d.ts","sourceRoot":"","sources":["../../src/services/studio-assets.ts"],"names":[],"mappings":"AA6BA,qFAAqF;AACrF,wBAAgB,UAAU,IAAI,MAAM,CAKnC;AAED,wBAAgB,aAAa,CAAC,IAAI,GAAE,MAAqB,GAAG,OAAO,CAElE;AAED,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,QAAQ,GAAG,IAAI,CAAC;AAEjE;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,GAAE,MAAqB,GAAG,YAAY,CAqB5E"}

package/dist/services/studio-assets.js

@@ -0,0 +1,94 @@
+import { existsSync, readFileSync, statSync } from 'node:fs';
+import { dirname, extname, join, normalize, resolve, sep } from 'node:path';
+import { fileURLToPath } from 'node:url';
+/**
+ * Serving Studio's built assets from the package, with no network involved.
+ *
+ * Architecture 4.3 and 15.1: one process, one port, and the app works with the network
+ * disabled. So the assets are files inside the published CLI package, read from disk and
+ * handed to the same Hono app that answers `/v1`. There is no CDN, no asset host, and
+ * nothing to configure.
+ *
+ * This lives in the CLI rather than in `@lorepack/runtime` because reading a filesystem is a
+ * Node concern and that package also has to compile for a Worker. `createApiApp` takes it as
+ * an injected function for exactly that reason.
+ */
+const MEDIA_TYPES = {
+    '.html': 'text/html; charset=utf-8',
+    '.js': 'text/javascript; charset=utf-8',
+    '.css': 'text/css; charset=utf-8',
+    '.woff2': 'font/woff2',
+    '.svg': 'image/svg+xml',
+    '.png': 'image/png',
+    '.ico': 'image/x-icon',
+    '.json': 'application/json; charset=utf-8',
+    '.map': 'application/json; charset=utf-8',
+};
+/** Where `vite build` writes, relative to this module once compiled into `dist/`. */
+export function studioRoot() {
+    const moduleDirectory = dirname(fileURLToPath(import.meta.url));
+    const bundledPath = resolve(moduleDirectory, '..', 'studio-dist');
+    if (existsSync(join(bundledPath, 'index.html')))
+        return bundledPath;
+    return resolve(moduleDirectory, '..', '..', 'studio-dist');
+}
+export function studioIsBuilt(root = studioRoot()) {
+    return existsSync(join(root, 'index.html'));
+}
+/**
+ * Reads one file per request, or returns null so the caller's typed 404 still applies.
+ *
+ * Files are read rather than held in memory: this serves one developer on loopback, the
+ * whole bundle is a few hundred kilobytes, and the operating system's page cache is better
+ * at this than a hand-rolled map would be.
+ */
+export function createStudioAssets(root = studioRoot()) {
+    const index = join(root, 'index.html');
+    return (request) => {
+        if (!existsSync(index))
+            return null;
+        const url = new URL(request.url);
+        const decoded = safePath(root, url.pathname);
+        // Outside the asset root. Not dangerous so much as meaningless, but it is the one thing
+        // a static file server must never get wrong, so it is refused rather than clamped.
+        if (decoded === null)
+            return null;
+        if (decoded !== null && existsSync(decoded) && statSync(decoded).isFile()) {
+            return file(decoded);
+        }
+        // A hash route, so every path that is not a file is the app itself. `/v1` and `/mcp` are
+        // registered before this handler and never reach it.
+        return file(index);
+    };
+}
+function safePath(root, pathname) {
+    let decoded;
+    try {
+        decoded = decodeURIComponent(pathname);
+    }
+    catch {
+        return null;
+    }
+    if (decoded.includes('\0'))
+        return null;
+    const candidate = normalize(join(root, decoded));
+    // `normalize` resolves `..` first, so this comparison is what actually contains the read.
+    if (candidate !== root && !candidate.startsWith(root + sep))
+        return null;
+    return candidate;
+}
+function file(path) {
+    const body = readFileSync(path);
+    const type = MEDIA_TYPES[extname(path).toLowerCase()] ?? 'application/octet-stream';
+    return new Response(new Uint8Array(body), {
+        headers: {
+            'content-type': type,
+            // Vite fingerprints every asset except the entry document, so those are immutable and
+            // the document must never be.
+            'cache-control': path.endsWith('index.html')
+                ? 'no-cache'
+                : 'public, max-age=31536000, immutable',
+        },
+    });
+}
+//# sourceMappingURL=studio-assets.js.map

package/dist/services/studio-assets.js.map

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

package/dist/services/studio-diagnostics.d.ts

@@ -0,0 +1,28 @@
+import type { LoadedConfig } from '@lorepack/core';
+import type { WatchStatus } from './watch.js';
+/**
+ * Everything `lorepack doctor` knows, plus what only a running session can know.
+ *
+ * The checks are not reimplemented here and never will be. `runDoctor` produces the same
+ * report the CLI prints, validated against the same published schema
+ * (`schemas/doctor-report.json`), and this composes it with three things a one-shot command
+ * cannot see: the live watcher, the process serving the request, and which clients are
+ * currently wired to this project.
+ *
+ * Read-only apart from doctor's own temporary in-memory FTS5 probe. Opening a diagnostics
+ * page must never be a side effect, which is also why client status reads configuration files
+ * rather than spawning anything.
+ */
+export interface DiagnosticsInput {
+    readonly config: LoadedConfig;
+    readonly host: string;
+    /** A function, because the port is chosen by binding and is not known before then. */
+    readonly port: () => number;
+    readonly startedAt: string;
+    /** Present when a watcher is running, which is `lorepack dev` and not `lorepack serve`. */
+    readonly watchStatus?: () => WatchStatus;
+}
+export declare function createDiagnosticsEndpoint(input: DiagnosticsInput): () => Promise<unknown>;
+/** Exported for the tests, which assert the endpoint answers for every registered client. */
+export declare const KNOWN_CLIENT_IDS: readonly string[];
+//# sourceMappingURL=studio-diagnostics.d.ts.map

package/dist/services/studio-diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"studio-diagnostics.d.ts","sourceRoot":"","sources":["../../src/services/studio-diagnostics.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAgB,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAGjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,sFAAsF;IACtF,QAAQ,CAAC,IAAI,EAAE,MAAM,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,2FAA2F;IAC3F,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,WAAW,CAAC;CAC1C;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,gBAAgB,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,CAuBzF;AAiED,6FAA6F;AAC7F,eAAO,MAAM,gBAAgB,EAAE,SAAS,MAAM,EAA0C,CAAC"}

package/dist/services/studio-diagnostics.js

@@ -0,0 +1,88 @@
+import { arch, platform, release } from 'node:os';
+import { probeFts5 } from '@lorepack/backend-local';
+import { CLAUDE_CODE_ID, CODEX_ID, createClaudeCodeConnector, createCodexConnector, createVsCodeConnector, SERVER_NAME, VSCODE_ID, } from '@lorepack/connect-clients';
+import { runDoctor } from './doctor.js';
+import { COMPILER_VERSION } from './versions.js';
+export function createDiagnosticsEndpoint(input) {
+    return async () => {
+        const doctor = await runDoctor({
+            cwd: input.config.projectRoot,
+            port: input.port(),
+            // This process is the one holding that port, so "in use" is the expected answer here
+            // rather than a warning about someone else's server.
+            portHeldByThisProject: true,
+        });
+        return {
+            doctor,
+            environment: environment(),
+            session: {
+                host: input.host,
+                port: input.port(),
+                pid: process.pid,
+                startedAt: input.startedAt,
+                watcher: input.watchStatus?.() ?? null,
+            },
+            clients: await clients(input.config),
+        };
+    };
+}
+/**
+ * The facts that describe this machine rather than this project.
+ *
+ * Duplicated in part by individual doctor checks, and deliberately: a check answers "is this
+ * a problem", and these answer "what am I running on", which is the first thing anyone pastes
+ * into a bug report.
+ */
+function environment() {
+    const probe = probeFts5();
+    return {
+        node: process.version,
+        platform: `${platform()} ${release()}`,
+        arch: arch(),
+        sqlite: probe.sqliteVersion,
+        fts5: probe.available,
+        lorepack: COMPILER_VERSION,
+    };
+}
+/**
+ * Which AI clients are installed, and whether this project is wired into them.
+ *
+ * Registration is explicit (architecture 4.8), so this list is the list of connectors that
+ * exist, not a discovery. It reports paths and booleans and never the contents of a
+ * configuration file, which is what keeps a credential in someone's `.claude.json` off this
+ * page (section 15.6).
+ */
+async function clients(config) {
+    const connectors = [createClaudeCodeConnector(), createCodexConnector(), createVsCodeConnector()];
+    const input = {
+        projectRoot: config.projectRoot,
+        serverName: SERVER_NAME,
+        command: {
+            executable: 'lorepack',
+            args: ['mcp', '--project', config.projectRoot, '--ensure-current'],
+        },
+        scope: 'project',
+    };
+    return Promise.all(connectors.map(async (connector) => {
+        try {
+            return { id: connector.id, title: connector.title, ...(await connector.status(input)) };
+        }
+        catch (error) {
+            // A client that cannot be inspected is reported as one, because a Diagnostics page
+            // that failed entirely because one adapter threw would hide the nine things that
+            // were fine.
+            return {
+                id: connector.id,
+                title: connector.title,
+                installed: false,
+                supported: false,
+                configured: false,
+                ownedByLorepack: false,
+                reason: error instanceof Error ? error.message : String(error),
+            };
+        }
+    }));
+}
+/** Exported for the tests, which assert the endpoint answers for every registered client. */
+export const KNOWN_CLIENT_IDS = [CLAUDE_CODE_ID, CODEX_ID, VSCODE_ID];
+//# sourceMappingURL=studio-diagnostics.js.map

package/dist/services/studio-diagnostics.js.map

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

package/dist/services/studio-endpoints.d.ts

@@ -0,0 +1,61 @@
+import { type BuildExclusion, type BuildWarning, type LoadedConfig } from '@lorepack/core';
+/**
+ * The reads Studio needs that are not runtime capabilities.
+ *
+ * Architecture 13.1 fixes `LoreRuntime` at seven capabilities, and every one of them reads
+ * the **active build**. A plan reads the **source tree**, and warnings are a property of a
+ * build's manifest rather than a query against its content. Neither belongs in that
+ * interface, and adding them would change what every backend has to implement, including the
+ * Phase 6 Worker that has no sources to plan against.
+ *
+ * So they are injected host functions on `createApiApp`, exactly like `currentBuild`. A
+ * deployment that cannot answer simply does not register the route.
+ *
+ * Both call the same code the CLI calls, so `lorepack plan` and Studio can never disagree.
+ */
+/**
+ * What a rebuild would change.
+ *
+ * Progress goes to a bus nobody is subscribed to. The CLI renders a stage table here because
+ * a person is watching a terminal; an HTTP caller gets one JSON answer when it is ready, and
+ * a half-rendered progress stream would be noise in it.
+ */
+export declare function createPlanEndpoint(config: LoadedConfig): () => Promise<unknown>;
+export interface WarningGroup {
+    readonly class: BuildWarning['class'];
+    readonly count: number;
+    readonly warnings: readonly BuildWarning[];
+}
+export interface WarningSummary {
+    readonly buildId: string;
+    readonly total: number;
+    readonly groups: readonly WarningGroup[];
+    /**
+     * What ignore rules removed, or `null` for a build made before the record existed.
+     *
+     * `null` and `[]` are different claims and the interfaces render them differently: one is
+     * "this build does not know", the other is "no rule removed anything". Collapsing them
+     * would be the same defect this field exists to fix, one level down.
+     */
+    readonly exclusions: readonly BuildExclusion[] | null;
+    /** Paths removed by a rule, which is not the same number as the number of rules. */
+    readonly excludedByRule: number | null;
+}
+/**
+ * Everything the build left out, in one answer.
+ *
+ * Two different things are "not in the build" and a reader looking for a missing document
+ * does not know which they have: a file with no parser, which produces a warning, and a file
+ * an ignore rule removed, which produces nothing at all until #202. They arrive together so
+ * that no client has to fetch two endpoints and decide how to add them up, which is how two
+ * surfaces come to count the same thing differently.
+ *
+ * Grouped on the server for the same reason: a client that receives a flat list has to invent
+ * the grouping.
+ */
+export declare function createWarningsEndpoint(read: () => Promise<{
+    buildId: string;
+    warnings: readonly BuildWarning[];
+    exclusions?: readonly BuildExclusion[];
+}>): () => Promise<WarningSummary>;
+//# sourceMappingURL=studio-endpoints.d.ts.map

package/dist/services/studio-endpoints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"studio-endpoints.d.ts","sourceRoot":"","sources":["../../src/services/studio-endpoints.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,YAAY,EAElB,MAAM,gBAAgB,CAAC;AAIxB;;;;;;;;;;;;;GAaG;AAEH;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,CAmB/E;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC;IACtC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,SAAS,YAAY,EAAE,CAAC;CAC5C;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,CAAC;IACzC;;;;;;OAMG;IACH,QAAQ,CAAC,UAAU,EAAE,SAAS,cAAc,EAAE,GAAG,IAAI,CAAC;IACtD,oFAAoF;IACpF,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CACxC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,OAAO,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,SAAS,YAAY,EAAE,CAAC;IAClC,UAAU,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;CACxC,CAAC,GACD,MAAM,OAAO,CAAC,cAAc,CAAC,CA8B/B"}

package/dist/services/studio-endpoints.js

@@ -0,0 +1,88 @@
+import { createPlan, readLockfile } from '@lorepack/compiler';
+import { ProgressBus, } from '@lorepack/core';
+import { readPreviousBuild } from './project.js';
+import { lockInputs } from './versions.js';
+/**
+ * The reads Studio needs that are not runtime capabilities.
+ *
+ * Architecture 13.1 fixes `LoreRuntime` at seven capabilities, and every one of them reads
+ * the **active build**. A plan reads the **source tree**, and warnings are a property of a
+ * build's manifest rather than a query against its content. Neither belongs in that
+ * interface, and adding them would change what every backend has to implement, including the
+ * Phase 6 Worker that has no sources to plan against.
+ *
+ * So they are injected host functions on `createApiApp`, exactly like `currentBuild`. A
+ * deployment that cannot answer simply does not register the route.
+ *
+ * Both call the same code the CLI calls, so `lorepack plan` and Studio can never disagree.
+ */
+/**
+ * What a rebuild would change.
+ *
+ * Progress goes to a bus nobody is subscribed to. The CLI renders a stage table here because
+ * a person is watching a terminal; an HTTP caller gets one JSON answer when it is ready, and
+ * a half-rendered progress stream would be noise in it.
+ */
+export function createPlanEndpoint(config) {
+    return async () => {
+        // `readPreviousBuild` reads the pointer without opening the state store for writing, so
+        // there is no handle to release here and a plan cannot block a build.
+        const { previous } = readPreviousBuild(config);
+        {
+            const { plan } = await createPlan({
+                config,
+                previous,
+                previousLock: readLockfile(config.projectRoot),
+                lockInputs: lockInputs(),
+                progress: new ProgressBus(),
+                // A person asking Studio what a rebuild would change wants an answer, not a refusal
+                // about the envelope. The build itself still enforces it.
+                allowLargeProject: true,
+            });
+            return plan;
+        }
+    };
+}
+/**
+ * Everything the build left out, in one answer.
+ *
+ * Two different things are "not in the build" and a reader looking for a missing document
+ * does not know which they have: a file with no parser, which produces a warning, and a file
+ * an ignore rule removed, which produces nothing at all until #202. They arrive together so
+ * that no client has to fetch two endpoints and decide how to add them up, which is how two
+ * surfaces come to count the same thing differently.
+ *
+ * Grouped on the server for the same reason: a client that receives a flat list has to invent
+ * the grouping.
+ */
+export function createWarningsEndpoint(read) {
+    return async () => {
+        const { buildId, warnings, exclusions } = await read();
+        const byClass = new Map();
+        for (const warning of warnings) {
+            const existing = byClass.get(warning.class);
+            if (existing === undefined)
+                byClass.set(warning.class, [warning]);
+            else
+                existing.push(warning);
+        }
+        return {
+            buildId,
+            total: warnings.length,
+            exclusions: exclusions ?? null,
+            excludedByRule: exclusions === undefined
+                ? null
+                : exclusions.reduce((sum, exclusion) => sum + exclusion.count, 0),
+            // Sorted by count, then by name, so the display order is stable across requests and
+            // the largest group is where the eye lands first.
+            groups: [...byClass.entries()]
+                .map(([warningClass, group]) => ({
+                class: warningClass,
+                count: group.length,
+                warnings: group,
+            }))
+                .sort((left, right) => right.count - left.count || left.class.localeCompare(right.class)),
+        };
+    };
+}
+//# sourceMappingURL=studio-endpoints.js.map

package/dist/services/studio-endpoints.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"studio-endpoints.js","sourceRoot":"","sources":["../../src/services/studio-endpoints.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAIL,WAAW,GACZ,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE3C;;;;;;;;;;;;;GAaG;AAEH;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAoB;IACrD,OAAO,KAAK,IAAI,EAAE;QAChB,wFAAwF;QACxF,sEAAsE;QACtE,MAAM,EAAE,QAAQ,EAAE,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;QAC/C,CAAC;YACC,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,UAAU,CAAC;gBAChC,MAAM;gBACN,QAAQ;gBACR,YAAY,EAAE,YAAY,CAAC,MAAM,CAAC,WAAW,CAAC;gBAC9C,UAAU,EAAE,UAAU,EAAE;gBACxB,QAAQ,EAAE,IAAI,WAAW,EAAE;gBAC3B,oFAAoF;gBACpF,0DAA0D;gBAC1D,iBAAiB,EAAE,IAAI;aACxB,CAAC,CAAC;YACH,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAwBD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,sBAAsB,CACpC,IAIE;IAEF,OAAO,KAAK,IAAI,EAAE;QAChB,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,MAAM,IAAI,EAAE,CAAC;QAEvD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAyC,CAAC;QACjE,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YAC5C,IAAI,QAAQ,KAAK,SAAS;gBAAE,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;;gBAC7D,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC9B,CAAC;QAED,OAAO;YACL,OAAO;YACP,KAAK,EAAE,QAAQ,CAAC,MAAM;YACtB,UAAU,EAAE,UAAU,IAAI,IAAI;YAC9B,cAAc,EACZ,UAAU,KAAK,SAAS;gBACtB,CAAC,CAAC,IAAI;gBACN,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,SAAS,EAAE,EAAE,CAAC,GAAG,GAAG,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC;YACrE,oFAAoF;YACpF,kDAAkD;YAClD,MAAM,EAAE,CAAC,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;iBAC3B,GAAG,CAAC,CAAC,CAAC,YAAY,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;gBAC/B,KAAK,EAAE,YAAY;gBACnB,KAAK,EAAE,KAAK,CAAC,MAAM;gBACnB,QAAQ,EAAE,KAAK;aAChB,CAAC,CAAC;iBACF,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;SAC5F,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC"}