@qodeca/xezar 0.13.1 → 0.14.0

package/dist/mcp/event-journal.d.ts

@@ -0,0 +1,57 @@
+import { type McpJournalAppendInput, type McpJournalCursorRejection, type McpJournalReadInput, type McpJournalReadResult, type McpJournalRow } from '../contract/index.js';
+/** A cursor refused outright — the caller maps `rejection` onto its own error answer (D-01/D-02). */
+export declare class McpJournalCursorError extends Error {
+    readonly rejection: McpJournalCursorRejection;
+    constructor(error: McpJournalCursorRejection['error'], message: string);
+}
+export interface EventJournalOptions {
+    /** The project's data directory (`projectDataDir(root)`). */
+    dataDir: string;
+    /** The project's registry slug, from the trusted binding — never from a tool argument. */
+    projectId: string;
+    /** Test seam for retention ages; production uses the wall clock. */
+    now?: () => number;
+    /** Values scrubbed from every summary (F-15). Defaults to this host's secret-named env values. */
+    secretValues?: readonly string[];
+    /** Where the one-per-problem warning goes. */
+    warn?: (message: string) => void;
+}
+export declare class EventJournal {
+    #private;
+    readonly projectId: string;
+    readonly indexPath: string;
+    readonly rowsPath: string;
+    private constructor();
+    /**
+     * Load (or create) a project's journal. Never throws on state — only on a caller bug (an invalid
+     * project id, or a second live instance for the same file, which would break gapless numbering).
+     */
+    static open(opts: EventJournalOptions): EventJournal;
+    get epoch(): string;
+    get latestSeq(): number;
+    get oldestSeq(): number | null;
+    /**
+     * False while the journal cannot record a row: it could not be created, or its last append failed.
+     * An unwritable journal journals nothing, so nothing can be delivered from it either (#309 O-3).
+     * The next append that succeeds makes it true again.
+     */
+    get writable(): boolean;
+    /** The cursor at the current head — D-05 § 6.8's "journal position at acceptance". */
+    headCursor(): string;
+    /** Release this file so a later `open` (a restart, in a test) may take it. */
+    close(): void;
+    /** Live rows as they are appended — the replay reader's buffer (#105). Returns the unsubscribe. */
+    subscribe(listener: (row: McpJournalRow) => void): () => void;
+    /**
+     * Append one significant event. Returns the stored row, or `undefined` when it could not be made
+     * durable — in which case no number was spent, so the sequence stays gapless (D-05 § 6.1).
+     * Throws only on invalid input, which is an emitter bug.
+     */
+    append(input: McpJournalAppendInput): McpJournalRow | undefined;
+    /**
+     * Replay strictly after `cursor` (or from the oldest retained row without one), in `journalSeq`
+     * order, at most B-02 rows and B-01 bytes. A cursor whose rows are gone gets `cursor_too_old`
+     * and no rows; a malformed or foreign cursor throws `McpJournalCursorError`.
+     */
+    read(input?: McpJournalReadInput): McpJournalReadResult;
+}

package/dist/mcp/event-journal.js

@@ -0,0 +1,423 @@
+import { randomUUID } from 'node:crypto';
+import { appendFileSync, existsSync, mkdirSync, readFileSync, renameSync, truncateSync, writeFileSync, } from 'node:fs';
+import { join } from 'node:path';
+import { z } from 'zod';
+import { MCP_JOURNAL_CURSOR_MAX_BYTES, MCP_JOURNAL_MIN_RETENTION_DAYS, MCP_JOURNAL_PAGE_BYTES, MCP_JOURNAL_PAGE_ROWS, MCP_JOURNAL_RETAINED_ROWS, mcpJournalAppendInputSchema, mcpJournalProjectIdSchema, mcpJournalRowSchema, } from '../contract/index.js';
+import { collectSecretValues, redactSecrets } from '../core/secret-redaction.js';
+/**
+ * The per-project MCP event journal (#103): an append-only record of the significant events
+ * (E-01–E-06) a project leader may see, with a replay cursor. Decided by D-05 § 6 and bounded by
+ * D-09 § 3 — see `packages/contract/src/mcp-journal.ts` for every shape and number.
+ *
+ * WHAT THIS IS NOT. `RunStore` already keeps one NDJSON transcript per run, and
+ * `GET /api/v1/runs/:id/events` replays one run from it with a cursor, deduping on the run's `seq`.
+ * That `seq` is per RUN and may skip numbers (`emitEphemeral` allocates frames that never reach
+ * disk). The workspace streams replay nothing at all. This journal is a separate file with its own
+ * order: `journalSeq` is per PROJECT and gapless — only a durably appended row gets a number — so a
+ * reader holding 1..N knows nothing between them is missing. Do not "fix" it into consistency with
+ * the run `seq` next door; the difference is the point (D-05 § 6.1).
+ *
+ * Files, both under `<dataDir>/mcp/` (so inside `.local/`, covered by its blanket ignore rule):
+ *  - `event-journal.json`   — `{ v, projectId, epoch, createdAt }`, zod-validated, written by
+ *    atomic tmp+rename, and only when a journal is created or recreated.
+ *  - `event-journal.ndjson` — one row per line, appended. Rewritten (tmp+rename) only to drop rows
+ *    retention has already evicted; surviving lines are copied byte-for-byte, numbers unchanged.
+ *
+ * Zero config: written, never required. Missing files start a fresh journal; a corrupt one starts
+ * fresh with ONE warning and the bad file kept beside it as `.corrupt`; an unwritable directory
+ * drops rows (with one warning) and never throws into the caller. A fresh journal gets a new
+ * `epoch`, so every cursor from the old one is answered `cursor_too_old` — never mis-resolved
+ * against numbers that restarted at 1.
+ *
+ * One writer per project: this process holds at most one open journal per file (enforced below),
+ * and the project's writer claim (#185) keeps a second xezar process off the same data directory.
+ */
+const DAY_MS = 24 * 60 * 60 * 1_000;
+const MIN_RETENTION_MS = MCP_JOURNAL_MIN_RETENTION_DAYS * DAY_MS;
+const indexSchema = z.looseObject({
+    v: z.literal(1),
+    projectId: mcpJournalProjectIdSchema,
+    epoch: z.string().min(1).max(64),
+    createdAt: z.string(),
+});
+const cursorSchema = z.object({
+    v: z.literal(1),
+    p: z.string(),
+    e: z.string(),
+    s: z.number().int().nonnegative(),
+});
+/** A cursor refused outright — the caller maps `rejection` onto its own error answer (D-01/D-02). */
+export class McpJournalCursorError extends Error {
+    rejection;
+    constructor(error, message) {
+        super(message);
+        this.name = 'McpJournalCursorError';
+        this.rejection = { error, message };
+    }
+}
+const openFiles = new Set();
+export class EventJournal {
+    projectId;
+    indexPath;
+    rowsPath;
+    #epoch = '';
+    /** Retained rows, oldest first, consecutive `journalSeq`. */
+    #rows = [];
+    /** The stored line of each retained row, kept verbatim so a compaction never re-serializes. */
+    #lines = [];
+    #latestSeq = 0;
+    /** Evicted lines still physically at the head of the file. */
+    #evictedOnDisk = 0;
+    #fileBytes = 0;
+    #writeWarned = false;
+    #writable = true;
+    #closed = false;
+    #listeners = new Set();
+    #now;
+    #secretValues;
+    #warn;
+    constructor(opts) {
+        this.projectId = mcpJournalProjectIdSchema.parse(opts.projectId);
+        const dir = join(opts.dataDir, 'mcp');
+        this.indexPath = join(dir, 'event-journal.json');
+        this.rowsPath = join(dir, 'event-journal.ndjson');
+        this.#now = opts.now ?? Date.now;
+        this.#secretValues = opts.secretValues ?? collectSecretValues();
+        this.#warn = opts.warn ?? ((message) => console.warn(message));
+    }
+    /**
+     * Load (or create) a project's journal. Never throws on state — only on a caller bug (an invalid
+     * project id, or a second live instance for the same file, which would break gapless numbering).
+     */
+    static open(opts) {
+        const journal = new EventJournal(opts);
+        if (openFiles.has(journal.rowsPath)) {
+            throw new Error(`an event journal is already open for ${journal.rowsPath} — keep one per project`);
+        }
+        openFiles.add(journal.rowsPath);
+        journal.#load();
+        return journal;
+    }
+    get epoch() {
+        return this.#epoch;
+    }
+    get latestSeq() {
+        return this.#latestSeq;
+    }
+    get oldestSeq() {
+        return this.#rows[0]?.journalSeq ?? null;
+    }
+    /**
+     * False while the journal cannot record a row: it could not be created, or its last append failed.
+     * An unwritable journal journals nothing, so nothing can be delivered from it either (#309 O-3).
+     * The next append that succeeds makes it true again.
+     */
+    get writable() {
+        return this.#writable;
+    }
+    /** The cursor at the current head — D-05 § 6.8's "journal position at acceptance". */
+    headCursor() {
+        return this.#cursorAt(this.#latestSeq);
+    }
+    /** Release this file so a later `open` (a restart, in a test) may take it. */
+    close() {
+        if (this.#closed)
+            return;
+        this.#closed = true;
+        this.#listeners.clear();
+        openFiles.delete(this.rowsPath);
+    }
+    /** Live rows as they are appended — the replay reader's buffer (#105). Returns the unsubscribe. */
+    subscribe(listener) {
+        this.#listeners.add(listener);
+        return () => this.#listeners.delete(listener);
+    }
+    /**
+     * Append one significant event. Returns the stored row, or `undefined` when it could not be made
+     * durable — in which case no number was spent, so the sequence stays gapless (D-05 § 6.1).
+     * Throws only on invalid input, which is an emitter bug.
+     */
+    append(input) {
+        if (this.#closed)
+            throw new Error('event journal is closed');
+        const parsed = mcpJournalAppendInputSchema.parse(input);
+        const journalSeq = this.#latestSeq + 1;
+        const row = mcpJournalRowSchema.parse({
+            eventId: `${this.projectId}:${journalSeq}`,
+            journalSeq,
+            ts: new Date(this.#now()).toISOString(),
+            projectId: this.projectId,
+            category: parsed.category,
+            kind: parsed.kind,
+            subject: parsed.subject,
+            origin: parsed.origin,
+            causedBy: parsed.causedBy,
+            // F-15: a summary is prose an emitter composed, so it is scrubbed like transcript text is.
+            summary: redactSecrets(parsed.summary, this.#secretValues),
+            ...(parsed.source === undefined ? {} : { source: parsed.source }),
+        });
+        const line = JSON.stringify(row);
+        try {
+            appendFileSync(this.rowsPath, `${line}\n`, 'utf8');
+        }
+        catch (err) {
+            // A partial write must not survive as a torn line in the middle of the file.
+            try {
+                truncateSync(this.rowsPath, this.#fileBytes);
+            }
+            catch { /* the load path drops a torn tail */ }
+            this.#writable = false;
+            this.#warnWrite(err);
+            return undefined;
+        }
+        this.#fileBytes += Buffer.byteLength(line, 'utf8') + 1;
+        this.#writable = true;
+        this.#latestSeq = journalSeq;
+        const frozen = freezeRow(row);
+        this.#rows.push(frozen);
+        this.#lines.push(line);
+        this.#applyRetention();
+        for (const listener of this.#listeners) {
+            try {
+                listener(frozen);
+            }
+            catch { /* a reader's bug never undoes a durable append */ }
+        }
+        return frozen;
+    }
+    /**
+     * Replay strictly after `cursor` (or from the oldest retained row without one), in `journalSeq`
+     * order, at most B-02 rows and B-01 bytes. A cursor whose rows are gone gets `cursor_too_old`
+     * and no rows; a malformed or foreign cursor throws `McpJournalCursorError`.
+     */
+    read(input = {}) {
+        const limit = Math.min(input.limit ?? MCP_JOURNAL_PAGE_ROWS, MCP_JOURNAL_PAGE_ROWS);
+        const oldest = this.oldestSeq;
+        const firstRetained = oldest ?? this.#latestSeq + 1;
+        let after = firstRetained - 1;
+        if (input.cursor !== undefined) {
+            const cursor = decodeCursor(input.cursor);
+            // Foreign BEFORE stale: another project's cursor is refused, never told what this one holds.
+            if (cursor.p !== this.projectId) {
+                throw new McpJournalCursorError('cursor_project_mismatch', 'this cursor belongs to another project');
+            }
+            if (cursor.e !== this.#epoch || cursor.s < firstRetained - 1)
+                return this.#tooOld(firstRetained);
+            if (cursor.s > this.#latestSeq) {
+                throw new McpJournalCursorError('invalid_cursor', 'this cursor points past the end of the journal');
+            }
+            after = cursor.s;
+        }
+        const events = [];
+        let bytes = 0;
+        for (let i = oldest === null ? this.#rows.length : after + 1 - oldest; i < this.#rows.length; i++) {
+            if (events.length >= limit)
+                break;
+            const size = Buffer.byteLength(JSON.stringify(this.#rows[i]), 'utf8');
+            if (events.length > 0 && bytes + size > MCP_JOURNAL_PAGE_BYTES)
+                break;
+            events.push(this.#rows[i]);
+            bytes += size;
+        }
+        const last = events.at(-1)?.journalSeq ?? after;
+        return {
+            status: 'ok',
+            events,
+            nextCursor: this.#cursorAt(last),
+            hasMore: last < this.#latestSeq,
+            oldestSeq: oldest,
+            latestSeq: this.#latestSeq,
+        };
+    }
+    #tooOld(firstRetained) {
+        return {
+            status: 'cursor_too_old',
+            oldestSeq: this.oldestSeq,
+            latestSeq: this.#latestSeq,
+            resumeCursor: this.#cursorAt(firstRetained - 1),
+            recovery: {
+                required: 'current-state',
+                message: 'Events after this cursor are no longer retained. Read the current state first, then continue from resumeCursor.',
+            },
+        };
+    }
+    #cursorAt(seq) {
+        return Buffer.from(JSON.stringify({ v: 1, p: this.projectId, e: this.#epoch, s: seq }), 'utf8').toString('base64url');
+    }
+    /** B-19: evict from the head only while more than the retained count remain AND the head row is
+     *  at least the minimum age. The retained set therefore stays one contiguous run of numbers. */
+    #applyRetention() {
+        const cutoff = this.#now() - MIN_RETENTION_MS;
+        let drop = 0;
+        while (this.#rows.length - drop > MCP_JOURNAL_RETAINED_ROWS && Date.parse(this.#rows[drop].ts) <= cutoff)
+            drop++;
+        if (drop === 0)
+            return;
+        this.#rows.splice(0, drop);
+        this.#lines.splice(0, drop);
+        this.#evictedOnDisk += drop;
+        // The file may hold at most B-19's count again in evicted lines before it is rewritten — so it
+        // never exceeds twice the retained size, and a steady stream does not rewrite it per append.
+        if (this.#evictedOnDisk >= MCP_JOURNAL_RETAINED_ROWS)
+            this.#compact();
+    }
+    #compact() {
+        const tmp = `${this.rowsPath}.tmp`;
+        const body = this.#lines.length === 0 ? '' : `${this.#lines.join('\n')}\n`;
+        try {
+            writeFileSync(tmp, body, 'utf8');
+            renameSync(tmp, this.rowsPath);
+            this.#fileBytes = Buffer.byteLength(body, 'utf8');
+            this.#evictedOnDisk = 0;
+        }
+        catch (err) {
+            // Eviction is already in effect in memory, and a reload re-derives it; only disk space waits.
+            this.#warnWrite(err);
+        }
+    }
+    #load() {
+        const outcome = this.#readFiles();
+        if (outcome.kind === 'fresh') {
+            if (outcome.warning !== undefined)
+                this.#warn(outcome.warning);
+            this.#startFresh();
+            return;
+        }
+        this.#epoch = outcome.epoch;
+        this.#rows = outcome.rows.map(freezeRow);
+        this.#lines = outcome.lines;
+        this.#latestSeq = outcome.rows.at(-1)?.journalSeq ?? 0;
+        this.#fileBytes = outcome.fileBytes;
+        this.#applyRetention();
+        if (this.#evictedOnDisk > 0)
+            this.#compact();
+    }
+    #readFiles() {
+        const hasIndex = existsSync(this.indexPath);
+        const hasRows = existsSync(this.rowsPath);
+        if (!hasIndex && !hasRows)
+            return { kind: 'fresh' };
+        const corrupt = (reason) => {
+            this.#setAside();
+            return {
+                kind: 'fresh',
+                warning: `[xez] MCP event journal for project ${this.projectId} is corrupt (${reason}) — starting a fresh journal; the old rows are kept as ${this.rowsPath}.corrupt`,
+            };
+        };
+        // Deleting the rows file alone is deleting history: a new epoch, not an error.
+        if (!hasRows)
+            return { kind: 'fresh' };
+        try {
+            const raw = readFileSync(this.rowsPath);
+            if (!hasIndex)
+                return raw.length === 0 ? { kind: 'fresh' } : corrupt('index file missing');
+            let index;
+            try {
+                const parsed = indexSchema.safeParse(JSON.parse(readFileSync(this.indexPath, 'utf8')));
+                if (!parsed.success)
+                    return corrupt('index file invalid');
+                index = parsed.data;
+            }
+            catch {
+                return corrupt('index file unreadable');
+            }
+            if (index.projectId !== this.projectId)
+                return corrupt('index names another project');
+            // A torn final line is an append that never returned, so no caller ever held its number.
+            let body = raw;
+            const lastNewline = raw.lastIndexOf(0x0a);
+            if (lastNewline !== raw.length - 1) {
+                body = raw.subarray(0, lastNewline + 1);
+                try {
+                    truncateSync(this.rowsPath, body.length);
+                }
+                catch { /* read-only: appends fail anyway */ }
+            }
+            const rows = [];
+            const lines = [];
+            for (const line of body.toString('utf8').split('\n')) {
+                if (line.trim() === '')
+                    continue;
+                let value;
+                try {
+                    value = JSON.parse(line);
+                }
+                catch {
+                    return corrupt(`unparseable row after seq ${rows.at(-1)?.journalSeq ?? 0}`);
+                }
+                const parsed = mcpJournalRowSchema.safeParse(value);
+                if (!parsed.success)
+                    return corrupt(`invalid row after seq ${rows.at(-1)?.journalSeq ?? 0}`);
+                const row = parsed.data;
+                const expected = rows.length === 0 ? row.journalSeq : rows.at(-1).journalSeq + 1;
+                if (row.journalSeq !== expected)
+                    return corrupt(`sequence breaks at seq ${expected}`);
+                if (row.projectId !== this.projectId || row.eventId !== `${this.projectId}:${row.journalSeq}`) {
+                    return corrupt(`row ${row.journalSeq} names another project`);
+                }
+                rows.push(row);
+                lines.push(line);
+            }
+            return { kind: 'loaded', epoch: index.epoch, rows, lines, fileBytes: body.length };
+        }
+        catch (err) {
+            return corrupt(err instanceof Error ? err.message : String(err));
+        }
+    }
+    #setAside() {
+        try {
+            if (existsSync(this.rowsPath))
+                renameSync(this.rowsPath, `${this.rowsPath}.corrupt`);
+        }
+        catch { /* the fresh journal overwrites it instead */ }
+    }
+    #startFresh() {
+        this.#epoch = randomUUID();
+        this.#rows = [];
+        this.#lines = [];
+        this.#latestSeq = 0;
+        this.#fileBytes = 0;
+        this.#evictedOnDisk = 0;
+        const tmp = `${this.indexPath}.tmp`;
+        try {
+            mkdirSync(join(this.rowsPath, '..'), { recursive: true, mode: 0o700 });
+            writeFileSync(this.rowsPath, '', 'utf8');
+            writeFileSync(tmp, `${JSON.stringify({ v: 1, projectId: this.projectId, epoch: this.#epoch, createdAt: new Date(this.#now()).toISOString() })}\n`, 'utf8');
+            renameSync(tmp, this.indexPath);
+        }
+        catch (err) {
+            this.#writable = false;
+            this.#warnWrite(err);
+        }
+    }
+    #warnWrite(err) {
+        if (this.#writeWarned)
+            return;
+        this.#writeWarned = true;
+        const message = err instanceof Error ? err.message : String(err);
+        this.#warn(`[xez] MCP event journal for project ${this.projectId} cannot be written (${message}) — events are not being journaled`);
+    }
+}
+function decodeCursor(cursor) {
+    const invalid = () => new McpJournalCursorError('invalid_cursor', 'invalid journal cursor');
+    if (cursor.length === 0 || cursor.length > MCP_JOURNAL_CURSOR_MAX_BYTES)
+        throw invalid();
+    let value;
+    try {
+        value = JSON.parse(Buffer.from(cursor, 'base64url').toString('utf8'));
+    }
+    catch {
+        throw invalid();
+    }
+    const parsed = cursorSchema.safeParse(value);
+    if (!parsed.success)
+        throw invalid();
+    return parsed.data;
+}
+function freezeRow(row) {
+    Object.freeze(row.subject);
+    if (row.source)
+        Object.freeze(row.source);
+    return Object.freeze(row);
+}
+//# sourceMappingURL=event-journal.js.map

package/dist/mcp/event-journal.js.map

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

package/dist/mcp/index.d.ts

@@ -0,0 +1,63 @@
+import { type ProviderStatus } from '../contract/index.js';
+import type { RunStore } from '../runs/store.ts';
+import { ProjectOwnership } from '../workspace/project-owner.ts';
+import { type ServiceTarget } from './bridge.ts';
+import { type WorkspaceEventSource } from './event-catalog.ts';
+import type { ServiceDispatch } from './service-adapter.ts';
+import { type McpServiceHandle } from './service.ts';
+/**
+ * The MCP module's public surface (#86, D-01). `packages/xezar/src/index.ts` imports
+ * it LAZILY from both sides, so an ordinary `serve` that never meets an MCP client
+ * pays nothing for it and cannot be broken by it (N-07).
+ */
+export { runBridge, HEALTH_TOOL, type BridgeOptions, type ServiceTarget } from './bridge.ts';
+export { listenMcpSocket, type McpDoor, type McpServiceHandle, type McpServiceOptions } from './service.ts';
+export { mcpSocketLocation, IPC_PROTOCOL_VERSION } from './ipc.ts';
+export { SUPPORTED_PROTOCOL_VERSIONS, SERVER_CAPABILITIES, negotiateProtocolVersion } from './protocol.ts';
+export { defineTool, textResult, errorResult, type McpTool, type McpToolContext, type McpToolResult } from './tool.ts';
+export interface StartMcpServiceOptions {
+    readonly projectId: string;
+    readonly version: string;
+    /** The running app's in-process entry: every tool dispatches into the cockpit's own routes (N-02). */
+    readonly service?: ServiceDispatch;
+    /** The project's own store — the one the cockpit writes. The catalog listens to it, and
+     *  receipts reconcile a run against it. */
+    readonly store?: RunStore;
+    /** The host-wide workspace bus: the catalog's E-06 source (`provider-status`). */
+    readonly workspaceEvents?: WorkspaceEventSource;
+    /** Provider rows as they are now — the catalog's E-06 baseline. A failure means "no baseline". */
+    readonly providerBaseline?: () => Promise<readonly ProviderStatus[]>;
+    /** Test seams, as for `listenMcpSocket`. Production uses the process's own. */
+    readonly ownership?: ProjectOwnership;
+    readonly env?: NodeJS.ProcessEnv;
+    readonly platform?: NodeJS.Platform;
+    readonly warn?: (message: string) => void;
+    /** Test seam: the event controller's heartbeat (#309). Production uses its 30 s. */
+    readonly leader?: {
+        readonly heartbeatMs?: number;
+    };
+}
+/**
+ * Service side: compose the MCP service for a registered project and open its socket (#243).
+ * Throws a one-line error when the socket cannot open; the cockpit turns that into one warning
+ * and keeps booting (N-07). Everything composed here is released by the handle's `close()`, and
+ * by the throw itself when the socket fails — nothing outlives either.
+ *
+ * The composition lives HERE, once, because the stdio bridge (`runMcpCommand`) executes nothing:
+ * it forwards every call to this socket, so both doors get exactly this behaviour.
+ */
+export declare function startMcpService(opts: StartMcpServiceOptions): Promise<McpServiceHandle>;
+/**
+ * `xez mcp` — spawned by an MCP client with the session's project as its working
+ * directory (D-01 § 4). Serves MCP on stdio until the client closes stdin.
+ */
+export declare function runMcpCommand(opts: {
+    repoRoot: string;
+    version: string;
+}): Promise<void>;
+/**
+ * The cwd only FINDS the socket; it never becomes the authority (D-01 § 4). A read of
+ * the registry: the bridge registers nothing, so a directory xezar has never served
+ * finds no project and answers with how to fix that.
+ */
+export declare function resolveMcpTarget(repoRoot: string): Promise<ServiceTarget>;