@ashlr/hub 3.10.0 → 3.11.0

package/dist/core/cloud/cloud-api.js

@@ -0,0 +1,599 @@
+import { passesMutationGate, readBody, sendJson } from '../web/api.js';
+import { scrubSecrets } from '../util/scrub.js';
+import { isNeedsYouItem, NEEDS_YOU_DETAIL_MAX, NEEDS_YOU_TITLE_MAX, } from '../verse/workbench-types.js';
+import { cloudBudgetView } from './budget.js';
+import { cloudOverview, launchCloudTask, runSelfImprove } from './service.js';
+import { listCloudTasks, readCloudTask, updateCloudBudget, writeCloudTask } from './store.js';
+import { refreshCloudTasks } from './tracker.js';
+import { CLOUD_TASK_ID_PATTERN, VERSE_CLOUD_BUDGET_PATH, VERSE_CLOUD_IMPROVE_PATH, VERSE_CLOUD_LAUNCH_PATH, VERSE_CLOUD_PATH, VERSE_CLOUD_REFRESH_PATH, VERSE_CLOUD_TASKS_PATH, } from './types.js';
+// ---------------------------------------------------------------------------
+// Input validation (pure, exported for tests)
+// ---------------------------------------------------------------------------
+/** Same shape the service validates (spec C1); checked here too so bad input is a 400, not a failed task. */
+export const CLOUD_REPO_PATTERN = /^[A-Za-z0-9-]+\/[A-Za-z0-9._-]+$/;
+/**
+ * A conservative git branch name: what `git check-ref-format --branch`
+ * accepts minus the exotic parts. The session clones this branch, so a
+ * typo'd or hostile name must stop at the door, not in a PTY.
+ */
+const BRANCH_RE = /^[A-Za-z0-9][A-Za-z0-9._/-]{0,199}$/;
+/** Launch bodies carry a prompt of up to CLOUD_PROMPT_MAX_CHARS (20 000) chars — up to 80 KB of UTF-8. */
+const LAUNCH_BODY_MAX_BYTES = 128 * 1024;
+const SMALL_BODY_MAX_BYTES = 4 * 1024;
+const TITLE_MAX = 200;
+const IMPROVE_MAX_COUNT = 5;
+/** Budget figures above this are typos, not budgets ($1M of credits, a million sessions). */
+const BUDGET_NUMBER_MAX = 1_000_000;
+const LAUNCH_KEYS = new Set(['repo', 'baseBranch', 'title', 'prompt', 'origin']);
+const LAUNCH_ORIGINS = ['chat', 'operator', 'cli'];
+const BUDGET_NUMBER_KEYS = ['creditsTotalUsd', 'creditsSpentAdjustmentUsd', 'estimatedCostPerSessionUsd'];
+const BUDGET_COUNT_KEYS = ['maxConcurrent', 'maxSessionsPerDay'];
+const BUDGET_KEYS = new Set([...BUDGET_NUMBER_KEYS, ...BUDGET_COUNT_KEYS, 'selfImprove']);
+const SELF_IMPROVE_KEYS = new Set(['enabled', 'repo', 'maxPerDay', 'reserveUsd']);
+export class CloudInputError extends Error {
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function rejectUnknownKeys(body, allowed, where = '') {
+    for (const key of Object.keys(body)) {
+        if (!allowed.has(key))
+            throw new CloudInputError(`Unknown field ${where}${key}.`);
+    }
+}
+export function isValidCloudRepo(value) {
+    return typeof value === 'string' && value.length <= 200 && CLOUD_REPO_PATTERN.test(value);
+}
+export function isValidBranchName(value) {
+    return typeof value === 'string'
+        && BRANCH_RE.test(value)
+        && !value.includes('..')
+        && !value.includes('//')
+        && !value.endsWith('/')
+        && !value.endsWith('.')
+        && !value.endsWith('.lock');
+}
+/** Strict parse of a launch body; throws CloudInputError with a plain sentence. `origin` defaults to operator. */
+export function parseCloudLaunchBody(body) {
+    rejectUnknownKeys(body, LAUNCH_KEYS);
+    const { repo, baseBranch, title, prompt, origin } = body;
+    if (!isValidCloudRepo(repo))
+        throw new CloudInputError('Repo must look like owner/name.');
+    if (typeof prompt !== 'string' || prompt.trim().length === 0)
+        throw new CloudInputError('Describe the task to run.');
+    const out = { repo, prompt, origin: 'operator' };
+    if (baseBranch !== undefined) {
+        if (!isValidBranchName(baseBranch))
+            throw new CloudInputError('Base branch is not a valid branch name.');
+        out.baseBranch = baseBranch;
+    }
+    if (title !== undefined) {
+        if (typeof title !== 'string' || title.length > TITLE_MAX) {
+            throw new CloudInputError(`Title must be text of at most ${TITLE_MAX} characters.`);
+        }
+        if (title.trim().length > 0)
+            out.title = title.trim();
+    }
+    if (origin !== undefined) {
+        if (!LAUNCH_ORIGINS.includes(origin)) {
+            throw new CloudInputError(`Origin must be one of: ${LAUNCH_ORIGINS.join(', ')}.`);
+        }
+        out.origin = origin;
+    }
+    return out;
+}
+function budgetNumber(key, value, whole) {
+    if (typeof value !== 'number' || !Number.isFinite(value))
+        throw new CloudInputError(`${key} must be a number.`);
+    if (value < 0)
+        throw new CloudInputError(`${key} can't be negative.`);
+    if (value > BUDGET_NUMBER_MAX)
+        throw new CloudInputError(`${key} is too large.`);
+    if (whole && !Number.isInteger(value))
+        throw new CloudInputError(`${key} must be a whole number.`);
+    return value;
+}
+/**
+ * Strict parse of a budget update: types and signs only. Clamping to sane
+ * maxima is the store's job (updateCloudBudget), so the two never disagree
+ * about what "sane" means.
+ */
+export function parseCloudBudgetBody(body) {
+    rejectUnknownKeys(body, BUDGET_KEYS);
+    const out = {};
+    for (const key of BUDGET_NUMBER_KEYS) {
+        if (body[key] !== undefined)
+            out[key] = budgetNumber(key, body[key], false);
+    }
+    for (const key of BUDGET_COUNT_KEYS) {
+        if (body[key] !== undefined)
+            out[key] = budgetNumber(key, body[key], true);
+    }
+    if (body['selfImprove'] !== undefined) {
+        const raw = body['selfImprove'];
+        if (!isRecord(raw))
+            throw new CloudInputError('selfImprove must be an object.');
+        rejectUnknownKeys(raw, SELF_IMPROVE_KEYS, 'selfImprove.');
+        const self = {};
+        if (raw['enabled'] !== undefined) {
+            if (typeof raw['enabled'] !== 'boolean')
+                throw new CloudInputError('selfImprove.enabled must be true or false.');
+            self.enabled = raw['enabled'];
+        }
+        if (raw['repo'] !== undefined) {
+            if (!isValidCloudRepo(raw['repo']))
+                throw new CloudInputError('selfImprove.repo must look like owner/name.');
+            self.repo = raw['repo'];
+        }
+        if (raw['maxPerDay'] !== undefined)
+            self.maxPerDay = budgetNumber('selfImprove.maxPerDay', raw['maxPerDay'], true);
+        if (raw['reserveUsd'] !== undefined)
+            self.reserveUsd = budgetNumber('selfImprove.reserveUsd', raw['reserveUsd'], false);
+        if (Object.keys(self).length > 0)
+            out.selfImprove = self;
+    }
+    if (Object.keys(out).length === 0)
+        throw new CloudInputError('Nothing to update.');
+    return out;
+}
+export function parseCloudImproveBody(body) {
+    rejectUnknownKeys(body, new Set(['count']));
+    const count = body['count'];
+    if (count === undefined)
+        return { count: 1 };
+    if (typeof count !== 'number' || !Number.isInteger(count) || count < 1 || count > IMPROVE_MAX_COUNT) {
+        throw new CloudInputError(`Count must be a whole number from 1 to ${IMPROVE_MAX_COUNT}.`);
+    }
+    return { count };
+}
+// ---------------------------------------------------------------------------
+// Dismiss (local record only — never GitHub)
+// ---------------------------------------------------------------------------
+export const CLOUD_DISMISS_REASON = 'Dismissed in Verse.';
+/**
+ * Mark a task `closed` with "Dismissed in Verse." — idempotent for a task
+ * already closed. Refused for a MERGED task (closing it would rewrite what
+ * happened) and while a launch is still in flight (the service would then
+ * overwrite the dismissal with `running`).
+ */
+export function dismissCloudTask(id, now = new Date()) {
+    const task = readCloudTask(id);
+    if (!task)
+        return { ok: false, status: 404, error: 'No cloud task with that id.' };
+    if (task.state === 'closed')
+        return { ok: true, task };
+    if (task.state === 'merged')
+        return { ok: false, status: 409, error: 'This task was merged; there is nothing to dismiss.' };
+    if (task.state === 'queued' || task.state === 'launching') {
+        return { ok: false, status: 409, error: 'This task is still launching. Try again in a minute.' };
+    }
+    const next = { ...task, state: 'closed', stateReason: CLOUD_DISMISS_REASON, updatedAt: now.toISOString() };
+    writeCloudTask(next);
+    return { ok: true, task: next };
+}
+// ---------------------------------------------------------------------------
+// Needs-you producer
+// ---------------------------------------------------------------------------
+/** Failed launches stay in Needs-you this long (spec C2). */
+export const CLOUD_FAILED_WINDOW_MS = 24 * 60 * 60 * 1000;
+/** The cache behind needsYouItems() is rebuilt, off the caller's stack, when older than this. */
+const NEEDS_YOU_CACHE_MS = 15_000;
+/** Newest tasks considered for Needs-you — PR-open and fresh failures are always among recent ones. */
+const NEEDS_YOU_TASK_SCAN = 200;
+function clip(text, max) {
+    // eslint-disable-next-line no-control-regex
+    const flat = text.replace(/[\u0000-\u001f\u007f\u2028\u2029]+/g, ' ').replace(/\s+/g, ' ').trim();
+    return flat.length <= max ? flat : `${flat.slice(0, max - 1).trimEnd()}…`;
+}
+function taskTitle(task) {
+    const t = clip(task.title ?? '', 80);
+    return t.length > 0 ? t : 'Untitled cloud task';
+}
+function dismissAction(task, confirmFirst) {
+    return {
+        kind: 'done',
+        label: 'Dismiss',
+        request: { method: 'POST', path: `${VERSE_CLOUD_TASKS_PATH}/${task.id}/dismiss`, body: {} },
+        confirm: confirmFirst
+            ? {
+                title: 'Stop tracking this cloud task?',
+                body: 'Verse marks it closed. The pull request on GitHub is not touched.',
+                confirmLabel: 'Dismiss',
+            }
+            : null,
+        destructive: false,
+    };
+}
+function isoOr(value, fallback) {
+    return typeof value === 'string' && !Number.isNaN(Date.parse(value)) ? new Date(value).toISOString() : fallback;
+}
+/**
+ * PURE: the Needs-you items for `tasks` at `now`.
+ *
+ * WHY THESE SOURCES AND KINDS: the Needs-you contract (workbench-types.ts
+ * §2) has a closed set of sources and kinds, and the web drawer and the
+ * desktop shell switch on both exhaustively, so a new one is not additive.
+ * A cloud PR is exactly an `owner-lane-pr` — a PR that is never merged
+ * automatically and waits for Mason — filed under `fleet`, the source the
+ * drawer already reads for that kind. A failed launch is a failed piece of
+ * work the operator started (often from a chat's "Run in cloud"), so it is a
+ * `chats` / `chat-failed` item with no session to open.
+ */
+export function cloudNeedsYouItems(tasks, now) {
+    const nowIso = now.toISOString();
+    const out = [];
+    for (const task of tasks) {
+        let item = null;
+        if (task.state === 'pr-open' && task.pr) {
+            const report = task.report;
+            const summary = report ? scrubSecrets(report.summary) : 'No report yet: the pull request has no ashlr-cloud-report block.';
+            const status = report && report.status !== 'done' ? ` (${report.status})` : '';
+            item = {
+                id: `fleet:owner-lane-pr:cloud-${task.id}`,
+                source: 'fleet',
+                kind: 'owner-lane-pr',
+                severity: 'info',
+                title: clip(`Cloud task ready for review: ${taskTitle(task)}`, NEEDS_YOU_TITLE_MAX),
+                detail: clip(`${summary}${status}`, NEEDS_YOU_DETAIL_MAX) || null,
+                since: isoOr(task.updatedAt, nowIso),
+                expiresAt: null,
+                subject: { repo: task.repo, pr: task.pr.number, seatId: null, sessionId: null, engine: 'claude' },
+                target: { kind: 'url', url: task.pr.url },
+                actions: [dismissAction(task, true)],
+            };
+        }
+        else if (task.state === 'failed') {
+            const at = Date.parse(task.updatedAt);
+            if (Number.isNaN(at) || now.getTime() - at > CLOUD_FAILED_WINDOW_MS)
+                continue;
+            const reason = task.stateReason ? scrubSecrets(task.stateReason) : 'The cloud session could not be started.';
+            item = {
+                id: `chats:chat-failed:cloud-${task.id}`,
+                source: 'chats',
+                kind: 'chat-failed',
+                severity: 'warn',
+                title: clip(`Cloud launch failed: ${taskTitle(task)}`, NEEDS_YOU_TITLE_MAX),
+                detail: clip(reason, NEEDS_YOU_DETAIL_MAX) || null,
+                since: isoOr(task.updatedAt, nowIso),
+                expiresAt: new Date(at + CLOUD_FAILED_WINDOW_MS).toISOString(),
+                subject: { repo: task.repo, pr: null, seatId: null, sessionId: null, engine: 'claude' },
+                target: { kind: 'section', section: 'command', anchor: 'cloud' },
+                actions: [dismissAction(task, false)],
+            };
+        }
+        // The same boundary activity applies to Track B producers: a task record
+        // with a non-https PR url or a malformed time never reaches the drawer.
+        if (item && isNeedsYouItem(item))
+            out.push(item);
+    }
+    return out;
+}
+let needsYouCache = null;
+let needsYouPending = false;
+let needsYouReadTasks = () => listCloudTasks(NEEDS_YOU_TASK_SCAN);
+function rebuildNeedsYou() {
+    try {
+        needsYouCache = { at: Date.now(), items: cloudNeedsYouItems(needsYouReadTasks(), new Date()) };
+    }
+    catch {
+        // Keep the last good answer: a transient store error must not flash an
+        // empty drawer. Stamp it so the next rebuild waits a cache period.
+        needsYouCache = { at: Date.now(), items: needsYouCache?.items ?? [] };
+    }
+}
+function scheduleNeedsYouRebuild() {
+    if (needsYouPending)
+        return;
+    needsYouPending = true;
+    setImmediate(() => {
+        needsYouPending = false;
+        rebuildNeedsYou();
+    });
+}
+/**
+ * Needs-you producer (activity-api.ts calls it on every poll). Returns the
+ * cached items in O(1) and, when the cache is stale, rebuilds it on a later
+ * tick — the task store is file I/O and never runs on the poll's stack. The
+ * first call answers [] (cloud items are additive to sources that vouch for
+ * themselves) and has the real answer ready for the next poll.
+ */
+export function needsYouItems() {
+    if (!needsYouCache || Date.now() - needsYouCache.at >= NEEDS_YOU_CACHE_MS)
+        scheduleNeedsYouRebuild();
+    return needsYouCache ? [...needsYouCache.items] : [];
+}
+/** After a mutation: the next poll should see it without waiting out the cache. */
+function invalidateNeedsYou() {
+    if (needsYouCache)
+        needsYouCache = { ...needsYouCache, at: 0 };
+    scheduleNeedsYouRebuild();
+}
+/** Test seam: replace the task reader (null restores) and drop the cache. */
+export function setCloudNeedsYouReaderForTest(read) {
+    needsYouReadTasks = read ?? (() => listCloudTasks(NEEDS_YOU_TASK_SCAN));
+    needsYouCache = null;
+    needsYouPending = false;
+}
+const inFlight = {};
+/**
+ * One run of `name` at a time across the scheduler AND the routes: a POST
+ * /refresh during a scheduled refresh joins it instead of racing a second
+ * `gh` sweep over the same task files.
+ */
+function guarded(name, run) {
+    const current = inFlight[name];
+    if (current)
+        return current;
+    const next = run().finally(() => {
+        delete inFlight[name];
+        invalidateNeedsYou();
+    });
+    inFlight[name] = next;
+    return next;
+}
+export function refreshCloudTasksGuarded() {
+    return guarded('refresh', () => refreshCloudTasks());
+}
+/**
+ * The operator's "Improve Verse" must not be answered with the scheduler's
+ * auto run (different gate, different count), so it waits for a run in
+ * flight to settle and then starts its own — still one at a time.
+ */
+async function improveGuarded(opts) {
+    const current = inFlight.improve;
+    if (current)
+        await current.catch(() => undefined);
+    return guarded('improve', () => runSelfImprove(opts));
+}
+// ---------------------------------------------------------------------------
+// Background scheduler
+// ---------------------------------------------------------------------------
+export const CLOUD_REFRESH_EVERY_MS = 10 * 60 * 1000;
+export const CLOUD_IMPROVE_EVERY_MS = 60 * 60 * 1000;
+export const CLOUD_IMPROVE_FIRST_DELAY_MS = 2 * 60 * 1000;
+/** Why this process must not run the scheduler; null when it may. */
+export function cloudSchedulerRefusal(env = process.env) {
+    // Never from a test run: a timer that outlives a test could launch a real
+    // (paid) cloud session or write under whatever HOME the next test set.
+    if (env['VITEST'] || env['NODE_ENV'] === 'test')
+        return 'test process';
+    if (env['ASHLR_CLOUD_AUTO'] === '0')
+        return 'disabled by ASHLR_CLOUD_AUTO=0';
+    return null;
+}
+let scheduler = null;
+function errorText(err) {
+    // Scrubbed: the log line may be read by anyone who can read the server's
+    // stderr, and a gh / git error can quote a token-bearing URL.
+    return scrubSecrets(err instanceof Error ? err.message : String(err)).slice(0, 300);
+}
+/**
+ * Start the process-wide scheduler once (idempotent, never throws). True when
+ * it runs. Jobs are guarded against overlapping runs — a tick that finds its
+ * previous run still going is skipped, not queued — and a failure is logged
+ * once per DISTINCT error, then stays quiet until it changes or clears.
+ */
+export function startCloudScheduler(env = process.env, deps = {}) {
+    if (scheduler)
+        return true;
+    if (cloudSchedulerRefusal(env) !== null)
+        return false;
+    const refresh = deps.refresh ?? (() => refreshCloudTasksGuarded());
+    const improve = deps.improve ?? (() => improveGuarded({ count: 1, auto: true }));
+    const log = deps.log ?? ((message) => { console.warn(`[ashlr] ${message}`); });
+    const state = { timers: [], running: {}, lastError: {} };
+    const tick = (name, job) => {
+        if (state.running[name])
+            return;
+        state.running[name] = true;
+        let promise;
+        try {
+            promise = job();
+        }
+        catch (err) {
+            promise = Promise.reject(err);
+        }
+        void promise
+            .then(() => { delete state.lastError[name]; })
+            .catch((err) => {
+            const text = errorText(err);
+            if (state.lastError[name] !== text) {
+                state.lastError[name] = text;
+                try {
+                    log(`cloud ${name} failed (${text}); retrying on the next tick`);
+                }
+                catch { /* never throws */ }
+            }
+        })
+            .finally(() => { state.running[name] = false; });
+    };
+    try {
+        const every = (ms, fn) => {
+            const t = setInterval(fn, ms);
+            t.unref?.();
+            state.timers.push(t);
+        };
+        every(CLOUD_REFRESH_EVERY_MS, () => tick('refresh', refresh));
+        every(CLOUD_IMPROVE_EVERY_MS, () => tick('improve', improve));
+        const first = setTimeout(() => tick('improve', improve), CLOUD_IMPROVE_FIRST_DELAY_MS);
+        first.unref?.();
+        state.timers.push(first);
+    }
+    catch {
+        for (const t of state.timers)
+            clearInterval(t);
+        return false;
+    }
+    scheduler = state;
+    return true;
+}
+/** Stop the scheduler (tests, shutdown). Safe to call when it never started. */
+export function stopCloudScheduler() {
+    if (!scheduler)
+        return;
+    // clearInterval clears a setTimeout handle too (one timer id space).
+    for (const t of scheduler.timers)
+        clearInterval(t);
+    scheduler = null;
+}
+export function cloudSchedulerRunning() {
+    return scheduler !== null;
+}
+// ---------------------------------------------------------------------------
+// Request helpers
+// ---------------------------------------------------------------------------
+function sendInvalid(res, message) {
+    sendJson(res, 400, { code: 'VERSE_INVALID', error: message });
+}
+function rejectQuery(req, res) {
+    let params;
+    try {
+        params = new URL(req.url ?? '/', 'http://localhost').searchParams;
+    }
+    catch {
+        sendInvalid(res, 'Invalid query string.');
+        return true;
+    }
+    const first = params.keys().next();
+    if (first.done)
+        return false;
+    sendInvalid(res, `Unknown query parameter: ${first.value}.`);
+    return true;
+}
+async function readMutationBody(ctx, req, res, maxBytes) {
+    // The mount already gated this POST; re-checking keeps the module safe if
+    // it is ever mounted or called some other way.
+    if (!ctx.allowDispatch) {
+        sendJson(res, 404, { error: 'not found' });
+        return null;
+    }
+    if (!passesMutationGate(req, res, ctx.token))
+        return null;
+    if (rejectQuery(req, res))
+        return null;
+    let raw;
+    try {
+        raw = await readBody(req, maxBytes);
+    }
+    catch {
+        sendJson(res, 413, { code: 'VERSE_TOO_LARGE', error: 'Request body too large.' });
+        return null;
+    }
+    let parsed;
+    try {
+        parsed = raw.trim().length === 0 ? {} : JSON.parse(raw);
+    }
+    catch {
+        sendInvalid(res, 'Invalid JSON body.');
+        return null;
+    }
+    if (!isRecord(parsed)) {
+        sendInvalid(res, 'Body must be a JSON object.');
+        return null;
+    }
+    return parsed;
+}
+const TASK_DISMISS_RE = /^\/api\/verse\/cloud\/tasks\/([^/]+)\/dismiss$/;
+function ownsPath(path) {
+    return path === VERSE_CLOUD_PATH || path.startsWith(`${VERSE_CLOUD_PATH}/`);
+}
+// ---------------------------------------------------------------------------
+// Handler
+// ---------------------------------------------------------------------------
+export const handleCloudApi = async (ctx, req, res, path, method) => {
+    if (!ownsPath(path))
+        return false;
+    try {
+        if (path === VERSE_CLOUD_PATH) {
+            if (method !== 'GET') {
+                sendJson(res, 404, { error: `not found: ${method} ${path}` });
+                return true;
+            }
+            if (rejectQuery(req, res))
+                return true;
+            sendJson(res, 200, await cloudOverview());
+            return true;
+        }
+        // Every other cloud route is a POST.
+        if (method !== 'POST') {
+            sendJson(res, 404, { error: `not found: ${method} ${path}` });
+            return true;
+        }
+        if (path === VERSE_CLOUD_LAUNCH_PATH) {
+            const body = await readMutationBody(ctx, req, res, LAUNCH_BODY_MAX_BYTES);
+            if (!body)
+                return true;
+            const request = parseCloudLaunchBody(body);
+            const result = await launchCloudTask(request);
+            invalidateNeedsYou();
+            // A refusal or failed launch keeps the full CloudLaunchResponse body, so
+            // a client that only reads `error` on a non-2xx still shows the reason.
+            sendJson(res, result.ok ? 200 : 409, result);
+            return true;
+        }
+        if (path === VERSE_CLOUD_BUDGET_PATH) {
+            const body = await readMutationBody(ctx, req, res, SMALL_BODY_MAX_BYTES);
+            if (!body)
+                return true;
+            // Validate BEFORE any write: a malformed body touches nothing.
+            const update = parseCloudBudgetBody(body);
+            const budget = updateCloudBudget(update);
+            sendJson(res, 200, cloudBudgetView(listCloudTasks(), budget, new Date()));
+            return true;
+        }
+        if (path === VERSE_CLOUD_REFRESH_PATH) {
+            const body = await readMutationBody(ctx, req, res, SMALL_BODY_MAX_BYTES);
+            if (!body)
+                return true;
+            rejectUnknownKeys(body, new Set());
+            sendJson(res, 200, await refreshCloudTasksGuarded());
+            return true;
+        }
+        if (path === VERSE_CLOUD_IMPROVE_PATH) {
+            const body = await readMutationBody(ctx, req, res, SMALL_BODY_MAX_BYTES);
+            if (!body)
+                return true;
+            const { count } = parseCloudImproveBody(body);
+            // The operator's "Improve Verse" button: canLaunch gate only (auto: false).
+            sendJson(res, 200, await improveGuarded({ count, auto: false }));
+            return true;
+        }
+        const dismiss = TASK_DISMISS_RE.exec(path);
+        if (dismiss) {
+            const body = await readMutationBody(ctx, req, res, SMALL_BODY_MAX_BYTES);
+            if (!body)
+                return true;
+            rejectUnknownKeys(body, new Set());
+            const id = dismiss[1];
+            if (!CLOUD_TASK_ID_PATTERN.test(id)) {
+                sendInvalid(res, 'That is not a cloud task id.');
+                return true;
+            }
+            const result = dismissCloudTask(id);
+            if (!result.ok) {
+                sendJson(res, result.status, { error: result.error });
+                return true;
+            }
+            invalidateNeedsYou();
+            sendJson(res, 200, { ok: true, task: result.task });
+            return true;
+        }
+        sendJson(res, 404, { error: `not found: ${method} ${path}` });
+        return true;
+    }
+    catch (err) {
+        if (err instanceof CloudInputError) {
+            sendInvalid(res, err.message);
+            return true;
+        }
+        // Never the raw message: service errors can carry checkout paths.
+        if (!res.headersSent)
+            sendJson(res, 500, { error: 'cloud request failed' });
+        return true;
+    }
+};
+// The scheduler starts with the module (spec C2). The Verse server loads this
+// module on the first activity poll (activity-api.ts reads needsYouItems) or
+// the first /api/verse/cloud request; a test runner never starts it.
+startCloudScheduler();
+//# sourceMappingURL=cloud-api.js.map

package/dist/core/cloud/cloud-api.js.map

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

package/dist/core/cloud/delivery-contract.d.ts

@@ -0,0 +1,25 @@
+/**
+ * The delivery contract appended to every cloud task prompt (unit C1), and
+ * the parser for what the session reports back in its PR body.
+ *
+ * WHY a contract at all: Verse cannot read a cloud session back (attach is
+ * not enabled for the account), so GitHub is the only channel. A session that
+ * delivers anywhere but `ashlr-cloud/<taskId>` is invisible to the tracker,
+ * and one that merges bypasses custody — so both are spelled out, every time.
+ */
+import { type CloudTaskReport, type CloudTaskV1 } from './types.js';
+/** A report block is a few hundred bytes; past this it is not a report, it is a dump. */
+export declare const CLOUD_REPORT_MAX_BLOCK_CHARS: number;
+/**
+ * The full prompt handed to `claude --cloud`: the task text, then the
+ * contract — create and work on branch `task.branch` from `task.baseBranch`;
+ * never push to any other branch; never merge; run the repo's relevant tests;
+ * commit; push; open a DRAFT PR against `task.baseBranch` titled
+ * `${CLOUD_PR_TITLE_PREFIX} <title>`; the PR body ends with a fenced
+ * `${CLOUD_REPORT_FENCE}` JSON block matching CloudTaskReport. If nothing
+ * needs changing, still push an empty commit on the branch and open the PR
+ * with status "no-change" so Verse sees completion.
+ */
+export declare function buildCloudPrompt(task: CloudTaskV1): string;
+/** Last well-formed `ashlr-cloud-report` block in the body, validated; else null. */
+export declare function parseCloudReport(prBody: string | null | undefined): CloudTaskReport | null;