looply-cli 0.5.13 → 0.5.17

package/dist/preview-github.js

@@ -0,0 +1,130 @@
+"use strict";
+/**
+ * WHAT A PROVIDER ALREADY SAID ABOUT A PULL REQUEST'S PREVIEW, READ FROM GITHUB.
+ *
+ * Netlify and Heroku both report their preview builds back to GitHub on the
+ * pull request's head commit — Netlify as a commit status
+ * (`netlify/<site>/deploy-preview`, its `target_url` the preview) and as a
+ * deployment; Heroku review apps as a deployment whose status carries the app's
+ * `environment_url`. Reading those means Looply needs no Netlify credentials at
+ * all and no Heroku ones to FIND a preview: it is the provider's own mechanism,
+ * observed.
+ *
+ * Read-only: GET only, with the token `github-api.ts` already uses for pull
+ * requests. One write-free exception, `sourceTarballUrl`, asks GitHub for the
+ * short-lived download link of a commit's source — a GET that is answered with a
+ * redirect — which Heroku needs to build a review app Looply asked for.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.makeGitHubPreviewReader = makeGitHubPreviewReader;
+exports.netlifySignal = netlifySignal;
+exports.herokuSignal = herokuSignal;
+function makeGitHubPreviewReader(deps) {
+    const doFetch = deps.fetch ?? ((url, init) => fetch(url, init));
+    const base = `https://api.github.com/repos/${encodeURIComponent(deps.owner)}/${encodeURIComponent(deps.repo)}`;
+    const headers = {
+        authorization: `Bearer ${deps.token}`,
+        accept: 'application/vnd.github+json',
+        'x-github-api-version': '2022-11-28',
+        'user-agent': 'looply-cli',
+    };
+    async function get(path) {
+        const res = await doFetch(`${base}${path}`, { method: 'GET', headers });
+        const text = await res.text();
+        if (res.status === 404)
+            return null;
+        if (res.status < 200 || res.status >= 300)
+            throw new Error(`GitHub answered ${res.status} to GET ${path}`);
+        return (text === '' ? null : JSON.parse(text));
+    }
+    const str = (x) => (typeof x === 'string' && x !== '' ? x : null);
+    return {
+        async signals(sha) {
+            if (!/^[0-9a-f]{7,64}$/.test(sha))
+                return [];
+            const out = [];
+            const seen = new Set();
+            const status = await get(`/commits/${sha}/status`);
+            for (const s of status?.statuses ?? []) {
+                const name = String(s['context'] ?? '');
+                if (name === '' || seen.has(`s:${name}`))
+                    continue; // newest first: the first of each context is its state
+                seen.add(`s:${name}`);
+                const st = String(s['state']);
+                out.push({
+                    source: 'status',
+                    name,
+                    state: st === 'success' ? 'live' : st === 'pending' ? 'building' : 'failed',
+                    url: str(s['target_url']),
+                    description: str(s['description']),
+                });
+            }
+            const deployments = await get(`/deployments?sha=${sha}&per_page=20`);
+            for (const d of deployments ?? []) {
+                const name = String(d['environment'] ?? '');
+                if (name === '' || seen.has(`d:${name}`))
+                    continue;
+                seen.add(`d:${name}`);
+                const statuses = await get(`/deployments/${Number(d['id'])}/statuses?per_page=1`);
+                const latest = (statuses ?? [])[0];
+                const st = String(latest?.['state'] ?? 'pending');
+                out.push({
+                    source: 'deployment',
+                    name,
+                    state: st === 'success' ? 'live' : st === 'inactive' ? 'inactive' : st === 'failure' || st === 'error' ? 'failed' : 'building',
+                    url: str(latest?.['environment_url']) ?? str(latest?.['target_url']),
+                    description: str(latest?.['description']),
+                });
+            }
+            return out;
+        },
+        async sourceTarballUrl(sha) {
+            if (!/^[0-9a-f]{7,64}$/.test(sha))
+                return null;
+            const res = await doFetch(`${base}/tarball/${sha}`, { method: 'GET', headers, redirect: 'manual' });
+            const loc = res.headers?.get('location') ?? null;
+            return res.status >= 300 && res.status < 400 && loc !== null && loc.startsWith('https://') ? loc : null;
+        },
+        async openPulls(limit) {
+            const list = await get(`/pulls?state=open&per_page=${Math.max(1, Math.min(limit, 30))}&sort=updated&direction=desc`);
+            return (list ?? []).map((p) => ({
+                number: Number(p['number']),
+                url: String(p['html_url'] ?? ''),
+                branch: String(p['head']?.['ref'] ?? ''),
+                headSha: String(p['head']?.['sha'] ?? ''),
+                title: String(p['title'] ?? ''),
+            }));
+        },
+    };
+}
+/* ───────────────────────────────────────────────────── which signal is it ── */
+/** Netlify's deploy-preview signal for this pull request, if any; `site` narrows it to one site. */
+function netlifySignal(signals, site) {
+    const mine = (s) => {
+        const ctx = s.name.toLowerCase();
+        const url = (s.url ?? '').toLowerCase();
+        const isNetlify = (s.source === 'status' && /^netlify\/[^/]+\/deploy-preview$/.test(ctx)) ||
+            (s.source === 'deployment' && /deploy[- ]preview|netlify/.test(ctx)) ||
+            /\.netlify\.app(\/|$)/.test(url);
+        if (!isNetlify)
+            return false;
+        if (site === undefined)
+            return true;
+        return ctx === `netlify/${site.toLowerCase()}/deploy-preview` || url.includes(`--${site.toLowerCase()}.netlify.app`);
+    };
+    // A commit status names the site explicitly; prefer it over a deployment.
+    return signals.find((s) => s.source === 'status' && mine(s)) ?? signals.find(mine) ?? null;
+}
+/** Heroku's review-app deployment for pull request `n` of `pipeline`, if GitHub has one. */
+function herokuSignal(signals, pipeline, n) {
+    const p = pipeline.toLowerCase();
+    const pr = new RegExp(`-pr-${n}(?![0-9])`);
+    return (signals.find((s) => {
+        if (s.source !== 'deployment')
+            return false;
+        const env = s.name.toLowerCase();
+        const url = (s.url ?? '').toLowerCase();
+        return (pr.test(env) || pr.test(url)) && (env.includes(p) || url.includes('herokuapp.com'));
+    }) ?? null);
+}
+//# sourceMappingURL=preview-github.js.map

package/dist/preview-github.js.map

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

package/dist/preview-settings-cache.d.ts

@@ -0,0 +1,33 @@
+import { type PreviewSettings } from '@looply/core';
+/**
+ * THE PROJECT'S REMOTE PREVIEW CHOICE, AS THIS MACHINE LAST HEARD IT.
+ *
+ * Set in AutoRyn per component; pulled by the daemon with the delivery setting
+ * (every five minutes) and written here. A failed pull keeps the last answer.
+ *
+ * Precedence: config.yaml `preview.provider` → this cache → none.
+ */
+export declare const PREVIEW_SETTINGS_FILE = "preview-settings.json";
+export interface PreviewSettingsCache {
+    settings: PreviewSettings | null;
+    updatedAt: string | null;
+    fetchedAt: string;
+}
+export declare function readPreviewSettingsCache(stateDir: string): PreviewSettingsCache | null;
+/** The provider in force: config.yaml's, else the remote one, else null (none). */
+export declare function resolvePreview(local: PreviewSettings | undefined, stateDir: string): {
+    settings: PreviewSettings | null;
+    from: 'config.yaml' | 'remote' | 'default';
+};
+/**
+ * One pull: ask the server, write the cache when the answer changed. Never
+ * throws. A server without the route (older looply-api) answers 404, which is
+ * "no preview", quietly.
+ */
+export declare function makePreviewSettingsPull(deps: {
+    fetch(): Promise<unknown>;
+    stateDir: string;
+    log(line: string): void;
+    now(): number;
+}): () => Promise<'updated' | 'unchanged' | 'failed'>;
+//# sourceMappingURL=preview-settings-cache.d.ts.map

package/dist/preview-settings-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview-settings-cache.d.ts","sourceRoot":"","sources":["../src/preview-settings-cache.ts"],"names":[],"mappings":"AAEA,OAAO,EAA2B,KAAK,eAAe,EAAE,MAAM,cAAc,CAAC;AAG7E;;;;;;;GAOG;AAEH,eAAO,MAAM,qBAAqB,0BAA0B,CAAC;AAE7D,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,eAAe,GAAG,IAAI,CAAC;IACjC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,oBAAoB,GAAG,IAAI,CAiBtF;AAED,mFAAmF;AACnF,wBAAgB,cAAc,CAAC,KAAK,EAAE,eAAe,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,eAAe,GAAG,IAAI,CAAC;IAAC,IAAI,EAAE,aAAa,GAAG,QAAQ,GAAG,SAAS,CAAA;CAAE,CAKrK;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE;IAC5C,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,GAAG,IAAI,MAAM,CAAC;CACf,GAAG,MAAM,OAAO,CAAC,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC,CA+CpD"}

package/dist/preview-settings-cache.js

@@ -0,0 +1,108 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PREVIEW_SETTINGS_FILE = void 0;
+exports.readPreviewSettingsCache = readPreviewSettingsCache;
+exports.resolvePreview = resolvePreview;
+exports.makePreviewSettingsPull = makePreviewSettingsPull;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const core_1 = require("@looply/core");
+const server_client_1 = require("./server-client");
+/**
+ * THE PROJECT'S REMOTE PREVIEW CHOICE, AS THIS MACHINE LAST HEARD IT.
+ *
+ * Set in AutoRyn per component; pulled by the daemon with the delivery setting
+ * (every five minutes) and written here. A failed pull keeps the last answer.
+ *
+ * Precedence: config.yaml `preview.provider` → this cache → none.
+ */
+exports.PREVIEW_SETTINGS_FILE = 'preview-settings.json';
+function readPreviewSettingsCache(stateDir) {
+    try {
+        const raw = JSON.parse((0, node_fs_1.readFileSync)((0, node_path_1.join)(stateDir, exports.PREVIEW_SETTINGS_FILE), 'utf8'));
+        let settings = null;
+        if (raw['settings'] !== null && raw['settings'] !== undefined) {
+            const v = (0, core_1.validatePreviewSettings)(raw['settings']);
+            if (!v.ok)
+                return null;
+            settings = v.settings;
+        }
+        return {
+            settings,
+            updatedAt: typeof raw['updatedAt'] === 'string' ? raw['updatedAt'] : null,
+            fetchedAt: typeof raw['fetchedAt'] === 'string' ? raw['fetchedAt'] : '',
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/** The provider in force: config.yaml's, else the remote one, else null (none). */
+function resolvePreview(local, stateDir) {
+    if (local !== undefined)
+        return { settings: local.provider === 'none' ? null : local, from: 'config.yaml' };
+    const remote = readPreviewSettingsCache(stateDir)?.settings ?? null;
+    if (remote !== null && remote.provider !== 'none')
+        return { settings: remote, from: 'remote' };
+    return { settings: null, from: 'default' };
+}
+/**
+ * One pull: ask the server, write the cache when the answer changed. Never
+ * throws. A server without the route (older looply-api) answers 404, which is
+ * "no preview", quietly.
+ */
+function makePreviewSettingsPull(deps) {
+    let failureReported = false;
+    const reportOnce = (why) => {
+        if (failureReported)
+            return;
+        failureReported = true;
+        deps.log(`preview : could not refresh the project's preview setting — ${why}`);
+    };
+    return async () => {
+        let body;
+        try {
+            body = await deps.fetch();
+        }
+        catch (e) {
+            if (e instanceof server_client_1.ServerError && e.status === 404)
+                return 'failed';
+            if (!(e instanceof server_client_1.ServerError && (e.isOffline || e.isAuth)))
+                reportOnce(e.message);
+            return 'failed';
+        }
+        const b = body;
+        if (typeof b !== 'object' || b === null || !('settings' in b)) {
+            reportOnce('the server answered with something that is not a settings envelope');
+            return 'failed';
+        }
+        let settings = null;
+        if (b.settings !== null) {
+            const v = (0, core_1.validatePreviewSettings)(b.settings);
+            if (!v.ok) {
+                reportOnce(`the server sent a setting this build refuses (${v.key}: ${v.because})`);
+                return 'failed';
+            }
+            settings = v.settings;
+        }
+        failureReported = false;
+        const updatedAt = typeof b.updatedAt === 'string' ? b.updatedAt : null;
+        const before = readPreviewSettingsCache(deps.stateDir);
+        if (before !== null && JSON.stringify(before.settings) === JSON.stringify(settings) && before.updatedAt === updatedAt)
+            return 'unchanged';
+        try {
+            (0, node_fs_1.mkdirSync)(deps.stateDir, { recursive: true });
+            const target = (0, node_path_1.join)(deps.stateDir, exports.PREVIEW_SETTINGS_FILE);
+            const tmp = `${target}.${process.pid}.tmp`;
+            (0, node_fs_1.writeFileSync)(tmp, JSON.stringify({ settings, updatedAt, fetchedAt: new Date(deps.now()).toISOString() }, null, 2) + '\n', 'utf8');
+            (0, node_fs_1.renameSync)(tmp, target);
+        }
+        catch (e) {
+            deps.log(`preview : could not write the preview setting cache (${e.message})`);
+            return 'failed';
+        }
+        deps.log(`preview : project preview setting is ${settings === null ? 'none' : settings.provider}`);
+        return 'updated';
+    };
+}
+//# sourceMappingURL=preview-settings-cache.js.map

package/dist/preview-settings-cache.js.map

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

package/dist/preview-wiring.d.ts

@@ -0,0 +1,35 @@
+import type { LooplyConfig } from './config';
+import { type GitHubApi } from './github-api';
+import { type HerokuApi } from './heroku-api';
+import { type PreviewCommandRunner } from './preview-environments';
+import { type GitHubPreviewReader } from './preview-github';
+import type { ServerClient } from './server-client';
+/**
+ * THE DAEMON'S HANDLE ON PREVIEW SITES: built once per project, so `daemon-cmd`
+ * gains one call on its five-minute cadence and nothing else.
+ *
+ *   tick() — pull the project's preview setting, then one pass over delivered
+ *            pull requests: read or start each open one's preview, tear down
+ *            each closed one's.
+ */
+export interface PreviewAdvancer {
+    tick(): Promise<void>;
+}
+export interface PreviewWiringOpts {
+    cwd: string;
+    stateDir: string;
+    config: Pick<LooplyConfig, 'preview'>;
+    client: Pick<ServerClient, 'recordPreview' | 'projectPreviewSettings'>;
+    projectId: string;
+    log(line: string): void;
+    /** Tests: fakes for every outside party. */
+    github?: (owner: string, repo: string) => Promise<{
+        api: GitHubApi;
+        reader: GitHubPreviewReader;
+    } | null>;
+    heroku?: () => HerokuApi | null;
+    runCommand?: PreviewCommandRunner;
+    now?: () => number;
+}
+export declare function makePreviewAdvancer(opts: PreviewWiringOpts): PreviewAdvancer;
+//# sourceMappingURL=preview-wiring.d.ts.map

package/dist/preview-wiring.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview-wiring.d.ts","sourceRoot":"","sources":["../src/preview-wiring.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,EAA8B,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAC1E,OAAO,EAA8B,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAC1E,OAAO,EASL,KAAK,oBAAoB,EAC1B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAA2B,KAAK,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAErF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD;;;;;;;GAOG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAED,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,IAAI,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC;IACtC,MAAM,EAAE,IAAI,CAAC,YAAY,EAAE,eAAe,GAAG,wBAAwB,CAAC,CAAC;IACvE,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,4CAA4C;IAC5C,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;QAAE,GAAG,EAAE,SAAS,CAAC;QAAC,MAAM,EAAE,mBAAmB,CAAA;KAAE,GAAG,IAAI,CAAC,CAAC;IAC1G,MAAM,CAAC,EAAE,MAAM,SAAS,GAAG,IAAI,CAAC;IAChC,UAAU,CAAC,EAAE,oBAAoB,CAAC;IAClC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,iBAAiB,GAAG,eAAe,CAkE5E"}

package/dist/preview-wiring.js

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.makePreviewAdvancer = makePreviewAdvancer;
+const branch_delivery_1 = require("./branch-delivery");
+const github_api_1 = require("./github-api");
+const heroku_api_1 = require("./heroku-api");
+const preview_environments_1 = require("./preview-environments");
+const preview_github_1 = require("./preview-github");
+const preview_settings_cache_1 = require("./preview-settings-cache");
+function makePreviewAdvancer(opts) {
+    const now = opts.now ?? (() => Date.now());
+    const pull = (0, preview_settings_cache_1.makePreviewSettingsPull)({
+        fetch: () => opts.client.projectPreviewSettings(opts.projectId),
+        stateDir: opts.stateDir,
+        log: opts.log,
+        now,
+    });
+    const github = opts.github ??
+        (async (owner, repo) => {
+            const t = await (0, github_api_1.githubToken)();
+            if (t === null)
+                return null;
+            return { api: (0, github_api_1.makeGitHubApi)({ owner, repo, token: t.token }), reader: (0, preview_github_1.makeGitHubPreviewReader)({ owner, repo, token: t.token }) };
+        });
+    const heroku = opts.heroku ??
+        (() => {
+            const t = (0, heroku_api_1.herokuToken)();
+            return t === null ? null : (0, heroku_api_1.makeHerokuApi)({ token: t.token });
+        });
+    const run = opts.runCommand ?? (0, preview_environments_1.makePreviewCommandRunner)(opts.cwd, opts.stateDir);
+    const settings = () => (0, preview_settings_cache_1.resolvePreview)(opts.config.preview?.settings, opts.stateDir).settings;
+    /** One command driver for the life of the daemon: it holds the background builds. */
+    const command = (0, preview_environments_1.commandDriver)({ ...(opts.config.preview?.command ? { command: opts.config.preview.command } : {}), ...(opts.config.preview?.teardown ? { teardown: opts.config.preview.teardown } : {}) }, run);
+    const store = (0, preview_environments_1.filePreviewStore)(opts.stateDir);
+    const deliveries = (0, branch_delivery_1.fileDeliveryStore)(opts.stateDir);
+    return {
+        async tick() {
+            await pull();
+            // A reader per repository per pass; the drivers read from it.
+            const clients = new Map();
+            const clientFor = async (owner, repo) => {
+                const k = `${owner}/${repo}`;
+                if (!clients.has(k))
+                    clients.set(k, await github(owner, repo).catch(() => null));
+                return clients.get(k);
+            };
+            let current = null;
+            const herokuApi = heroku();
+            const driver = (provider) => {
+                if (current === null)
+                    return null;
+                const s = settings();
+                if (provider === 'command')
+                    return command;
+                if (provider === 'netlify')
+                    return (0, preview_environments_1.netlifyDriver)(s?.provider === 'netlify' ? s : {}, current.reader);
+                // An existing heroku preview whose setting moved away is still torn down on its pipeline name when known.
+                if (s?.provider === 'heroku')
+                    return (0, preview_environments_1.herokuDriver)(s, current.reader, herokuApi);
+                return null;
+            };
+            await (0, preview_environments_1.advancePreviews)({
+                settings,
+                driver,
+                deliveries,
+                store,
+                github: async (owner, repo) => {
+                    current = await clientFor(owner, repo);
+                    return current?.api ?? null;
+                },
+                record: async (goalId, report) => {
+                    if (goalId.startsWith('gol_'))
+                        await opts.client.recordPreview(opts.projectId, goalId, report);
+                },
+                now,
+                log: opts.log,
+            });
+        },
+    };
+}
+//# sourceMappingURL=preview-wiring.js.map

package/dist/preview-wiring.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview-wiring.js","sourceRoot":"","sources":["../src/preview-wiring.ts"],"names":[],"mappings":";;AA8CA,kDAkEC;AA/GD,uDAAsD;AAEtD,6CAA0E;AAC1E,6CAA0E;AAC1E,iEAUgC;AAChC,qDAAqF;AACrF,qEAAmF;AA6BnF,SAAgB,mBAAmB,CAAC,IAAuB;IACzD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IAC3C,MAAM,IAAI,GAAG,IAAA,gDAAuB,EAAC;QACnC,KAAK,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,sBAAsB,CAAC,IAAI,CAAC,SAAS,CAAC;QAC/D,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,GAAG;KACJ,CAAC,CAAC;IACH,MAAM,MAAM,GACV,IAAI,CAAC,MAAM;QACX,CAAC,KAAK,EAAE,KAAa,EAAE,IAAY,EAAE,EAAE;YACrC,MAAM,CAAC,GAAG,MAAM,IAAA,wBAAW,GAAE,CAAC;YAC9B,IAAI,CAAC,KAAK,IAAI;gBAAE,OAAO,IAAI,CAAC;YAC5B,OAAO,EAAE,GAAG,EAAE,IAAA,0BAAa,EAAC,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,IAAA,wCAAuB,EAAC,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC;QACnI,CAAC,CAAC,CAAC;IACL,MAAM,MAAM,GACV,IAAI,CAAC,MAAM;QACX,CAAC,GAAG,EAAE;YACJ,MAAM,CAAC,GAAG,IAAA,wBAAW,GAAE,CAAC;YACxB,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAA,0BAAa,EAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;QAC/D,CAAC,CAAC,CAAC;IACL,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,IAAI,IAAA,+CAAwB,EAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IACjF,MAAM,QAAQ,GAAG,GAA2B,EAAE,CAAC,IAAA,uCAAc,EAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC;IACrH,qFAAqF;IACrF,MAAM,OAAO,GAAG,IAAA,oCAAa,EAAC,EAAE,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;IAChN,MAAM,KAAK,GAAG,IAAA,uCAAgB,EAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC9C,MAAM,UAAU,GAAG,IAAA,mCAAiB,EAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAEpD,OAAO;QACL,KAAK,CAAC,IAAI;YACR,MAAM,IAAI,EAAE,CAAC;YACb,8DAA8D;YAC9D,MAAM,OAAO,GAAG,IAAI,GAAG,EAAkE,CAAC;YAC1F,MAAM,SAAS,GAAG,KAAK,EAAE,KAAa,EAAE,IAAY,EAAE,EAAE;gBACtD,MAAM,CAAC,GAAG,GAAG,KAAK,IAAI,IAAI,EAAE,CAAC;gBAC7B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;oBAAE,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;gBACjF,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAE,CAAC;YACzB,CAAC,CAAC;YACF,IAAI,OAAO,GAA2D,IAAI,CAAC;YAC3E,MAAM,SAAS,GAAG,MAAM,EAAE,CAAC;YAC3B,MAAM,MAAM,GAAG,CAAC,QAAkC,EAAwB,EAAE;gBAC1E,IAAI,OAAO,KAAK,IAAI;oBAAE,OAAO,IAAI,CAAC;gBAClC,MAAM,CAAC,GAAG,QAAQ,EAAE,CAAC;gBACrB,IAAI,QAAQ,KAAK,SAAS;oBAAE,OAAO,OAAO,CAAC;gBAC3C,IAAI,QAAQ,KAAK,SAAS;oBAAE,OAAO,IAAA,oCAAa,EAAC,CAAC,EAAE,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;gBACrG,0GAA0G;gBAC1G,IAAI,CAAC,EAAE,QAAQ,KAAK,QAAQ;oBAAE,OAAO,IAAA,mCAAY,EAAC,CAAC,EAAE,OAAO,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;gBAChF,OAAO,IAAI,CAAC;YACd,CAAC,CAAC;YACF,MAAM,IAAA,sCAAe,EAAC;gBACpB,QAAQ;gBACR,MAAM;gBACN,UAAU;gBACV,KAAK;gBACL,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;oBAC5B,OAAO,GAAG,MAAM,SAAS,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;oBACvC,OAAO,OAAO,EAAE,GAAG,IAAI,IAAI,CAAC;gBAC9B,CAAC;gBACD,MAAM,EAAE,KAAK,EAAE,MAAc,EAAE,MAAqB,EAAE,EAAE;oBACtD,IAAI,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC;wBAAE,MAAM,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;gBACjG,CAAC;gBACD,GAAG;gBACH,GAAG,EAAE,IAAI,CAAC,GAAG;aACd,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/run-spend-report.d.ts

@@ -0,0 +1,55 @@
+import type { SpendRecord } from './spend-ledger';
+/**
+ * WHAT EACH RUN COST, SENT TO THE SERVER SO A DASHBOARD CAN SAY "COST PER TICKET".
+ *
+ * The spend ledger (`~/.looply/spend.jsonl`) is machine-local and append-only;
+ * nothing else ever left the machine. This totals its rows per run and hands the
+ * server the totals — the server already knows which goal each run served, so it
+ * can answer "what did this ticket cost" without the machine knowing about tickets.
+ *
+ * ⚠️ ONLY `spend` ROWS ARE SUMMED. A reservation is an estimate, and a settlement
+ * restates rows that are already here; adding either would count money twice.
+ *
+ * ⚠️ AN INVOCATION WITH NO DOLLARS IS COUNTED AS UNMEASURED, NEVER AS FREE. The
+ * dashboard shows the measured dollars and says how many calls it could not price.
+ *
+ * Read-only on the ledger, bounded per call, and a failure only waits for the
+ * next cadence.
+ */
+export interface RunSpendSummary {
+    readonly runId: string;
+    /** Model invocations recorded for the run. */
+    readonly invocations: number;
+    /** Of those, how many reported no dollar figure. */
+    readonly unmeasured: number;
+    /** Dollars of the invocations that reported one. */
+    readonly usd: number;
+    readonly inputTokens: number;
+    readonly outputTokens: number;
+    readonly cacheReadTokens: number;
+    readonly cacheWriteTokens: number;
+    /** Wall clock spent inside model invocations. */
+    readonly ms: number;
+    /** ISO time of the run's latest row. */
+    readonly lastAt: string;
+}
+/** Runs older than this are not reported (the dashboard looks back 90 days). */
+export declare const RUN_SPEND_LOOKBACK_MS: number;
+/** At most this many runs per request; the rest go on the next cadence. */
+export declare const RUN_SPEND_BATCH = 200;
+/** Totals per run, newest run first, for runs whose latest row is after `sinceMs`. */
+export declare function summariseRunSpend(records: readonly SpendRecord[], sinceMs: number): RunSpendSummary[];
+export interface RunSpendReporterDeps {
+    /** The ledger's rows; `null` when it cannot be read (nothing is sent). */
+    readonly read: () => readonly SpendRecord[] | null;
+    /** Sends one batch; resolves when the server took it. */
+    readonly send: (runs: readonly RunSpendSummary[]) => Promise<unknown>;
+    readonly now?: () => number;
+    readonly log?: (line: string) => void;
+}
+/**
+ * One reporting pass per call. Sends only runs whose totals changed since the
+ * last pass that the server accepted, so a quiet machine sends nothing.
+ */
+export declare function makeRunSpendReporter(deps: RunSpendReporterDeps): () => Promise<number>;
+//# sourceMappingURL=run-spend-report.d.ts.map

package/dist/run-spend-report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-spend-report.d.ts","sourceRoot":"","sources":["../src/run-spend-report.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD;;;;;;;;;;;;;;;;GAgBG;AAEH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,8CAA8C;IAC9C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,oDAAoD;IACpD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,oDAAoD;IACpD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,iDAAiD;IACjD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,wCAAwC;IACxC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,gFAAgF;AAChF,eAAO,MAAM,qBAAqB,QAA2B,CAAC;AAC9D,2EAA2E;AAC3E,eAAO,MAAM,eAAe,MAAM,CAAC;AAInC,sFAAsF;AACtF,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,eAAe,EAAE,CAmCrG;AAED,MAAM,WAAW,oBAAoB;IACnC,0EAA0E;IAC1E,QAAQ,CAAC,IAAI,EAAE,MAAM,SAAS,WAAW,EAAE,GAAG,IAAI,CAAC;IACnD,yDAAyD;IACzD,QAAQ,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,SAAS,eAAe,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACtE,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IAC5B,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACvC;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,oBAAoB,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,CAuBtF"}

package/dist/run-spend-report.js

@@ -0,0 +1,84 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RUN_SPEND_BATCH = exports.RUN_SPEND_LOOKBACK_MS = void 0;
+exports.summariseRunSpend = summariseRunSpend;
+exports.makeRunSpendReporter = makeRunSpendReporter;
+/** Runs older than this are not reported (the dashboard looks back 90 days). */
+exports.RUN_SPEND_LOOKBACK_MS = 90 * 24 * 60 * 60 * 1000;
+/** At most this many runs per request; the rest go on the next cadence. */
+exports.RUN_SPEND_BATCH = 200;
+const n = (v) => (typeof v === 'number' && Number.isFinite(v) && v >= 0 ? v : 0);
+/** Totals per run, newest run first, for runs whose latest row is after `sinceMs`. */
+function summariseRunSpend(records, sinceMs) {
+    const byRun = new Map();
+    for (const r of records) {
+        if (typeof r.runId !== 'string' || r.runId === '')
+            continue;
+        if (r.kind !== undefined && r.kind !== 'spend')
+            continue;
+        let s = byRun.get(r.runId);
+        if (!s) {
+            s = {
+                runId: r.runId,
+                invocations: 0,
+                unmeasured: 0,
+                usd: 0,
+                inputTokens: 0,
+                outputTokens: 0,
+                cacheReadTokens: 0,
+                cacheWriteTokens: 0,
+                ms: 0,
+                lastAt: r.at,
+            };
+            byRun.set(r.runId, s);
+        }
+        s.invocations += 1;
+        if (typeof r.usd === 'number' && Number.isFinite(r.usd))
+            s.usd += r.usd;
+        else
+            s.unmeasured += 1;
+        s.inputTokens += n(r.inputTokens);
+        s.outputTokens += n(r.outputTokens);
+        s.cacheReadTokens += n(r.cacheReadTokens);
+        s.cacheWriteTokens += n(r.cacheWriteTokens);
+        s.ms += n(r.ms);
+        if (Date.parse(r.at) > Date.parse(s.lastAt))
+            s.lastAt = r.at;
+    }
+    return [...byRun.values()]
+        .filter((s) => Date.parse(s.lastAt) >= sinceMs)
+        .map((s) => ({ ...s, usd: Math.round(s.usd * 1e6) / 1e6 }))
+        .sort((a, b) => Date.parse(b.lastAt) - Date.parse(a.lastAt));
+}
+/**
+ * One reporting pass per call. Sends only runs whose totals changed since the
+ * last pass that the server accepted, so a quiet machine sends nothing.
+ */
+function makeRunSpendReporter(deps) {
+    const sent = new Map();
+    const now = deps.now ?? (() => Date.now());
+    let failing = false;
+    return async () => {
+        const records = deps.read();
+        if (records === null)
+            return 0;
+        const changed = summariseRunSpend(records, now() - exports.RUN_SPEND_LOOKBACK_MS).filter((s) => sent.get(s.runId) !== `${s.invocations}|${s.lastAt}`);
+        const batch = changed.slice(0, exports.RUN_SPEND_BATCH);
+        if (batch.length === 0)
+            return 0;
+        try {
+            await deps.send(batch);
+        }
+        catch (e) {
+            if (!failing)
+                deps.log?.(`spend   : could not report run costs (${e.message}); will retry`);
+            failing = true;
+            return 0;
+        }
+        failing = false;
+        for (const s of batch)
+            sent.set(s.runId, `${s.invocations}|${s.lastAt}`);
+        return batch.length;
+    };
+}
+//# sourceMappingURL=run-spend-report.js.map

package/dist/run-spend-report.js.map

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

package/dist/server-client.d.ts

@@ -3,6 +3,8 @@ import type { Attestation, Classification, CoverageKind, Disposition, Requiremen
 import type { VisualProofUpload } from '@looply/core';
 import type { AgentSettings, MachineSettings, WorkspacesReport, AccountReport, MachineSlots, BranchDeliveryReport, DeliverySettings, AnyEvent, Goal, GoalAutonomyState, GoalState, MachineSettlableState, PursuitEndCode, GoalHold } from '@looply/core';
 import type { IngestAck } from './uploader';
+import type { PreviewReport, PreviewSettings } from '@looply/core';
+import type { RunSpendSummary } from './run-spend-report';
 /**
  * The machine's client for the looply server.
  *
@@ -113,6 +115,14 @@ export declare class ServerClient {
      * (`GET /v1/machine/settings`; the id comes from the token). Cached by the
      * daemon — see `machine-settings.ts`.
      */
+    /**
+     * What each of this project's runs cost, totalled from the machine's spend
+     * ledger (`run-spend-report.ts`). The server keeps the totals on the run rows it
+     * already has, and ignores run ids that are not this project's on this machine.
+     */
+    reportRunSpend(machineId: string, projectId: string, runs: readonly RunSpendSummary[]): Promise<{
+        updated: number;
+    }>;
     machineSettings(): Promise<{
         settings: MachineSettings;
         updatedAt: string | null;
@@ -268,6 +278,18 @@ export declare class ServerClient {
         }>;
         at: string;
     }>;
+    /**
+     * The project's remote preview choice (`GET /v1/projects/:id/preview-settings`).
+     * The daemon caches the answer — see `preview-settings-cache.ts`.
+     */
+    projectPreviewSettings(projectId: string): Promise<{
+        settings: PreviewSettings | null;
+        updatedAt: string | null;
+    }>;
+    /** Where a delivered goal's preview site stands — building, live, failed, removed (machine token). */
+    recordPreview(projectId: string, goalId: string, report: PreviewReport): Promise<{
+        preview: PreviewReport;
+    }>;
     projectGoals(projectId: string): Promise<{
         goals: Goal[];
     }>;