@quenty/nevermore-cli 4.41.1 → 4.42.1-canary.783.30683193716.0

package/dist/utils/watch/http-watch-registry.test.js

@@ -0,0 +1,211 @@
+import { describe, it, expect } from 'vitest';
+import { HttpWatchRegistry } from './http-watch-registry.js';
+const REGISTER_URL = 'https://watch.example.com/v1/register/7d/';
+function makeRequest(overrides = {}) {
+    return {
+        monitorName: 'integration',
+        repository: 'Quenty/egg-hunt-2026',
+        githubToken: 'token-value',
+        watches: [
+            {
+                name: 'quenty/hub/hub',
+                source: {
+                    type: 'roblox-place',
+                    universeId: 10,
+                    placeId: 20,
+                    versionType: 'published',
+                },
+                baselineVersion: '158',
+                baselineVersionKind: 'roblox-place-version',
+                action: {
+                    type: 'github-workflow-dispatch',
+                    workflow: '.github/workflows/build.yml',
+                    ref: 'main',
+                    inputs: { target: 'integration.places.hub' },
+                },
+            },
+        ],
+        ...overrides,
+    };
+}
+function makeResponse(body, init = {}) {
+    return {
+        ok: (init.status ?? 200) < 400,
+        status: init.status ?? 200,
+        statusText: init.statusText ?? 'OK',
+        text: async () => body,
+    };
+}
+function registryReturning(response, calls) {
+    return new HttpWatchRegistry({
+        registerUrl: REGISTER_URL,
+        fetchImpl: (async (url, init) => {
+            calls?.push({ url, init });
+            return response;
+        }),
+    });
+}
+describe('HttpWatchRegistry', () => {
+    it('posts a MonitorRequest to the register URL', async () => {
+        const calls = [];
+        await registryReturning(makeResponse('{}'), calls).registerAsync(makeRequest());
+        expect(calls).toHaveLength(1);
+        expect(calls[0].url).toBe(REGISTER_URL);
+        expect(calls[0].init.method).toBe('POST');
+        expect(JSON.parse(calls[0].init.body)).toEqual({
+            name: 'integration',
+            auth: {
+                github: {
+                    token: 'token-value',
+                    repository: 'Quenty/egg-hunt-2026',
+                },
+            },
+            watches: [
+                {
+                    name: 'quenty/hub/hub',
+                    source: {
+                        type: 'roblox-place',
+                        universeId: 10,
+                        placeId: 20,
+                        versionType: 'published',
+                    },
+                    baselineVersion: '158',
+                    baselineVersionKind: 'roblox-place-version',
+                    action: {
+                        type: 'github-workflow-dispatch',
+                        workflow: '.github/workflows/build.yml',
+                        ref: 'main',
+                        inputs: { target: 'integration.places.hub' },
+                    },
+                },
+            ],
+        });
+    });
+    it('sends every watch in one request', async () => {
+        const calls = [];
+        const base = makeRequest();
+        await registryReturning(makeResponse('{}'), calls).registerAsync({
+            ...base,
+            watches: [base.watches[0], { ...base.watches[0], name: 'pkg/lobby' }],
+        });
+        expect(calls).toHaveLength(1);
+        expect(JSON.parse(calls[0].init.body).watches).toHaveLength(2);
+    });
+    it('omits the Open Cloud key unless one was shared', async () => {
+        const calls = [];
+        await registryReturning(makeResponse('{}'), calls).registerAsync(makeRequest());
+        expect(JSON.parse(calls[0].init.body).auth).not.toHaveProperty('robloxOpenCloud');
+    });
+    it('includes the Open Cloud key when shared', async () => {
+        const calls = [];
+        await registryReturning(makeResponse('{}'), calls).registerAsync(makeRequest({ robloxApiKey: 'oc-key' }));
+        expect(JSON.parse(calls[0].init.body).auth.robloxOpenCloud).toEqual({ apiKey: 'oc-key' });
+    });
+    // The kind describes the value, so sending it alone would declare the
+    // vocabulary of a baseline that is not there.
+    it('omits the declared kind along with the baseline', async () => {
+        const calls = [];
+        const base = makeRequest();
+        await registryReturning(makeResponse('{}'), calls).registerAsync({
+            ...base,
+            watches: [{ ...base.watches[0], baselineVersion: undefined }],
+        });
+        expect(JSON.parse(calls[0].init.body).watches[0]).not.toHaveProperty('baselineVersionKind');
+    });
+    it('omits baselineVersion when there is no baseline', async () => {
+        const calls = [];
+        const base = makeRequest();
+        await registryReturning(makeResponse('{}'), calls).registerAsync({
+            ...base,
+            watches: [{ ...base.watches[0], baselineVersion: undefined }],
+        });
+        expect(JSON.parse(calls[0].init.body).watches[0]).not.toHaveProperty('baselineVersion');
+    });
+    it('reads back the monitor the service reports', async () => {
+        const result = await registryReturning(makeResponse(JSON.stringify({
+            monitorId: 'mon_9f2a',
+            revision: 'abc123',
+            leaseExpiresAt: '2026-08-06T00:00:00Z',
+            changed: true,
+            watches: [{ name: 'a' }, { name: 'b' }],
+            unexpected: 'ignored',
+        }))).registerAsync(makeRequest());
+        expect(result).toEqual({
+            monitorId: 'mon_9f2a',
+            revision: 'abc123',
+            leaseExpiresAt: '2026-08-06T00:00:00Z',
+            changed: true,
+            watchCount: 2,
+        });
+    });
+    it('reports an unchanged re-apply', async () => {
+        const result = await registryReturning(makeResponse(JSON.stringify({ monitorId: 'mon_1', changed: false }))).registerAsync(makeRequest());
+        expect(result.changed).toBe(false);
+    });
+    it('treats a 2xx with an unusable body as registered without details', async () => {
+        expect(await registryReturning(makeResponse('not json')).registerAsync(makeRequest())).toEqual({});
+    });
+    describe('failure messages', () => {
+        it('leads with the service message and adds our remedy on 401', async () => {
+            await expect(registryReturning(makeResponse(JSON.stringify({ error: 'bad credentials' }), {
+                status: 401,
+                statusText: 'Unauthorized',
+            })).registerAsync(makeRequest())).rejects.toThrowError(/^bad credentials\nSet NEVERMORE_WATCH_TOKEN/);
+        });
+        it('falls back to our own wording when the service says nothing', async () => {
+            await expect(registryReturning(makeResponse('', { status: 401, statusText: 'Unauthorized' })).registerAsync(makeRequest())).rejects.toThrowError(/^GitHub rejected the dispatch token\./);
+        });
+        it('names the repository and required scope on 403', async () => {
+            await expect(registryReturning(makeResponse('', { status: 403, statusText: 'Forbidden' })).registerAsync(makeRequest())).rejects.toThrowError(/cannot write to Quenty\/egg-hunt-2026.*actions: write/s);
+        });
+        it('explains a quota failure on 409', async () => {
+            await expect(registryReturning(makeResponse('', { status: 409, statusText: 'Conflict' })).registerAsync(makeRequest())).rejects.toThrowError(/quota exceeded for Quenty\/egg-hunt-2026/);
+        });
+        it('lists the workflows it referenced on 422', async () => {
+            await expect(registryReturning(makeResponse('', { status: 422, statusText: 'Unprocessable Entity' })).registerAsync(makeRequest())).rejects.toThrowError(/workflow does not exist.*\.github\/workflows\/build\.yml/s);
+        });
+        // Observed against prod: a notify-only monitor was refused 422 because the
+        // Open Cloud key lacked a scope, and the reply appended "Referenced: ." plus
+        // advice about a workflow path — under a message that had nothing to do with
+        // workflows. 422 now covers several causes and the service names which.
+        it('adds no workflow advice when the monitor dispatches none', async () => {
+            const request = makeRequest();
+            request.watches = request.watches.map((watch) => ({
+                ...watch,
+                action: { type: 'notify', payload: { target: 'x' } },
+            }));
+            await expect(registryReturning(makeResponse(JSON.stringify({
+                error: 'The Open Cloud key is not allowed to read place 1 (403).',
+            }), { status: 422, statusText: 'Unprocessable Entity' })).registerAsync(request)).rejects.toThrowError(/not allowed to read place 1/);
+            await expect(registryReturning(makeResponse(JSON.stringify({ error: 'nope' }), {
+                status: 422,
+                statusText: 'Unprocessable Entity',
+            })).registerAsync(request)).rejects.not.toThrowError(/Referenced|workflow/);
+        });
+        it('surfaces the API error body', async () => {
+            await expect(registryReturning(makeResponse(JSON.stringify({ error: 'lease too long' }), {
+                status: 400,
+                statusText: 'Bad Request',
+            })).registerAsync(makeRequest())).rejects.toThrowError(/lease too long/);
+        });
+        it('includes the API validation detail list', async () => {
+            await expect(registryReturning(makeResponse(JSON.stringify({
+                error: "request/body must have required property 'name'",
+                errors: [{ path: '/body/name', errorCode: 'required' }],
+            }), { status: 400, statusText: 'Bad Request' })).registerAsync(makeRequest())).rejects.toThrowError(/\/body\/name/);
+        });
+        it('falls back to status text on an unmapped code', async () => {
+            await expect(registryReturning(makeResponse('', { status: 503, statusText: 'Service Unavailable' })).registerAsync(makeRequest())).rejects.toThrowError(/503 Service Unavailable/);
+        });
+        it('reports the endpoint when the request cannot be made', async () => {
+            const registry = new HttpWatchRegistry({
+                registerUrl: REGISTER_URL,
+                fetchImpl: (async () => {
+                    throw new Error('ENOTFOUND');
+                }),
+            });
+            await expect(registry.registerAsync(makeRequest())).rejects.toThrowError(/could not reach https:\/\/watch\.example\.com/);
+        });
+    });
+});
+//# sourceMappingURL=http-watch-registry.test.js.map

package/dist/utils/watch/http-watch-registry.test.js.map

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

package/dist/utils/watch/local-watch-loop.d.ts

@@ -0,0 +1,50 @@
+import { type BasePlaceVersionKeyword, type PlaceVersionSource } from '@quenty/nevermore-deploy';
+/** One base place being watched, and what to rebuild when it moves. */
+export interface LocalWatchEntry {
+    /** Human label for output, e.g. `integration.places.hub`. */
+    label: string;
+    universeId: number;
+    placeId: number;
+    versionType: BasePlaceVersionKeyword;
+    /**
+     * Version this entry was last built from. Undefined means "adopt whatever
+     * the first poll sees", which avoids a rebuild on startup for a place that
+     * has never been locked.
+     */
+    baseline?: number;
+}
+export interface LocalWatchLoopOptions {
+    entries: LocalWatchEntry[];
+    source: PlaceVersionSource;
+    /** Stop watching after this long. */
+    durationMs: number;
+    pollIntervalMs?: number;
+    /** Rebuild and redeploy. Errors are reported and the loop continues. */
+    redeployAsync: (entry: LocalWatchEntry, version: number) => Promise<void>;
+    /** Lets a caller stop the loop; SIGINT is wired to one by default. */
+    signal?: AbortSignal;
+    /** Injected in tests. */
+    now?: () => number;
+    sleepAsync?: (ms: number, signal: AbortSignal) => Promise<void>;
+}
+export interface LocalWatchLoopResult {
+    /** Rebuilds that completed. */
+    redeploys: number;
+    /** Rebuilds that were attempted and threw. */
+    failures: number;
+    /** True when the duration ran out rather than the user interrupting. */
+    expired: boolean;
+}
+/**
+ * Poll base places and redeploy in-process when one moves.
+ *
+ * This is what `--watch` does outside CI. Registering with the watch service
+ * would be pointless on a laptop: the service's only action is dispatching a
+ * GitHub workflow, which would rebuild on a runner rather than here — so a
+ * local run keeps the loop in the terminal, where the developer can see it.
+ *
+ * Poll failures never end the loop. A watch is meant to be left running for
+ * hours, and a dropped connection is not a reason to stop watching.
+ */
+export declare function runLocalWatchLoopAsync(options: LocalWatchLoopOptions): Promise<LocalWatchLoopResult>;
+//# sourceMappingURL=local-watch-loop.d.ts.map

package/dist/utils/watch/local-watch-loop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-watch-loop.d.ts","sourceRoot":"","sources":["../../../src/utils/watch/local-watch-loop.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,uBAAuB,EAC5B,KAAK,kBAAkB,EACxB,MAAM,0BAA0B,CAAC;AAKlC,uEAAuE;AACvE,MAAM,WAAW,eAAe;IAC9B,6DAA6D;IAC7D,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,uBAAuB,CAAC;IACrC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,MAAM,EAAE,kBAAkB,CAAC;IAC3B,qCAAqC;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,wEAAwE;IACxE,aAAa,EAAE,CAAC,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1E,sEAAsE;IACtE,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,yBAAyB;IACzB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACjE;AAED,MAAM,WAAW,oBAAoB;IACnC,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,QAAQ,EAAE,MAAM,CAAC;IACjB,wEAAwE;IACxE,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,oBAAoB,CAAC,CAgH/B"}

package/dist/utils/watch/local-watch-loop.js

@@ -0,0 +1,103 @@
+import { OutputHelper } from '@quenty/cli-output-helpers';
+/** How often to ask Open Cloud whether a base place moved. */
+const DEFAULT_POLL_INTERVAL_MS = 15_000;
+/**
+ * Poll base places and redeploy in-process when one moves.
+ *
+ * This is what `--watch` does outside CI. Registering with the watch service
+ * would be pointless on a laptop: the service's only action is dispatching a
+ * GitHub workflow, which would rebuild on a runner rather than here — so a
+ * local run keeps the loop in the terminal, where the developer can see it.
+ *
+ * Poll failures never end the loop. A watch is meant to be left running for
+ * hours, and a dropped connection is not a reason to stop watching.
+ */
+export async function runLocalWatchLoopAsync(options) {
+    const { entries, source, durationMs, redeployAsync, pollIntervalMs = DEFAULT_POLL_INTERVAL_MS, now = () => Date.now(), sleepAsync = _sleepAsync, } = options;
+    const controller = new AbortController();
+    const signal = options.signal ?? controller.signal;
+    const onSigint = () => controller.abort();
+    if (!options.signal) {
+        process.on('SIGINT', onSigint);
+    }
+    const seen = new Map(entries.map((e) => [_key(e), e.baseline]));
+    const deadline = now() + durationMs;
+    let redeploys = 0;
+    let failures = 0;
+    OutputHelper.info(`Watching ${entries.length} base place${entries.length === 1 ? '' : 's'} locally. Ctrl-C to stop.`);
+    for (const entry of entries) {
+        OutputHelper.info(`  ${entry.label} — base place ${entry.placeId} (${entry.versionType}${entry.baseline == null ? '' : ` v${entry.baseline}`})`);
+    }
+    try {
+        while (!signal.aborted && now() < deadline) {
+            for (const entry of entries) {
+                if (signal.aborted) {
+                    break;
+                }
+                let latest;
+                try {
+                    latest = await source.resolveLatestPlaceVersionAsync(entry.universeId, entry.placeId, entry.versionType);
+                }
+                catch (err) {
+                    OutputHelper.warn(`Could not check ${entry.label}: ` +
+                        (err instanceof Error ? err.message : String(err)));
+                    continue;
+                }
+                const key = _key(entry);
+                const previous = seen.get(key);
+                if (previous === undefined) {
+                    // First sighting of a place with no recorded baseline: adopt it
+                    // rather than treating "unknown -> something" as a change.
+                    seen.set(key, latest);
+                    continue;
+                }
+                if (latest === previous) {
+                    continue;
+                }
+                OutputHelper.info(`${entry.label}: base place moved v${previous} → v${latest}, rebuilding...`);
+                try {
+                    await redeployAsync(entry, latest);
+                    redeploys++;
+                    // Recorded only on success, so a failed rebuild is retried on the
+                    // next poll instead of being silently skipped forever.
+                    seen.set(key, latest);
+                    OutputHelper.info(`${entry.label}: rebuilt from v${latest}.`);
+                }
+                catch (err) {
+                    failures++;
+                    OutputHelper.error(`${entry.label}: rebuild failed — ` +
+                        (err instanceof Error ? err.message : String(err)));
+                }
+            }
+            if (signal.aborted || now() >= deadline) {
+                break;
+            }
+            await sleepAsync(pollIntervalMs, signal);
+        }
+    }
+    finally {
+        if (!options.signal) {
+            process.off('SIGINT', onSigint);
+        }
+    }
+    const expired = !signal.aborted;
+    OutputHelper.info(expired
+        ? `Watch lease elapsed. ${redeploys} rebuild${redeploys === 1 ? '' : 's'}.`
+        : `Stopped watching. ${redeploys} rebuild${redeploys === 1 ? '' : 's'}.`);
+    return { redeploys, failures, expired };
+}
+function _key(entry) {
+    return `${entry.placeId}:${entry.versionType}`;
+}
+function _sleepAsync(ms, signal) {
+    return new Promise((resolve) => {
+        const timer = setTimeout(finish, ms);
+        function finish() {
+            clearTimeout(timer);
+            signal.removeEventListener('abort', finish);
+            resolve();
+        }
+        signal.addEventListener('abort', finish, { once: true });
+    });
+}
+//# sourceMappingURL=local-watch-loop.js.map

package/dist/utils/watch/local-watch-loop.js.map

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

package/dist/utils/watch/local-watch-loop.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=local-watch-loop.test.d.ts.map

package/dist/utils/watch/local-watch-loop.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-watch-loop.test.d.ts","sourceRoot":"","sources":["../../../src/utils/watch/local-watch-loop.test.ts"],"names":[],"mappings":""}

package/dist/utils/watch/local-watch-loop.test.js

@@ -0,0 +1,170 @@
+import { describe, it, expect, vi } from 'vitest';
+import { runLocalWatchLoopAsync, } from './local-watch-loop.js';
+function makeEntry(overrides = {}) {
+    return {
+        label: 'integration.places.hub',
+        universeId: 10,
+        placeId: 20,
+        versionType: 'published',
+        baseline: 158,
+        ...overrides,
+    };
+}
+/**
+ * Drives the loop deterministically: time only advances when the loop sleeps,
+ * so a test controls exactly how many poll rounds happen.
+ */
+function makeClock(pollIntervalMs) {
+    let current = 0;
+    return {
+        now: () => current,
+        sleepAsync: async () => {
+            current += pollIntervalMs;
+        },
+    };
+}
+describe('runLocalWatchLoopAsync', () => {
+    it('redeploys when the base place moves', async () => {
+        const versions = [158, 158, 159];
+        let i = 0;
+        const redeployed = [];
+        const clock = makeClock(1000);
+        const result = await runLocalWatchLoopAsync({
+            entries: [makeEntry()],
+            source: {
+                resolveLatestPlaceVersionAsync: async () => versions[Math.min(i++, versions.length - 1)],
+            },
+            durationMs: 3000,
+            pollIntervalMs: 1000,
+            redeployAsync: async (_entry, version) => {
+                redeployed.push(version);
+            },
+            ...clock,
+        });
+        expect(redeployed).toEqual([159]);
+        expect(result.redeploys).toBe(1);
+        expect(result.failures).toBe(0);
+        expect(result.expired).toBe(true);
+    });
+    it('does not redeploy while the version holds still', async () => {
+        const redeployed = [];
+        const clock = makeClock(1000);
+        const result = await runLocalWatchLoopAsync({
+            entries: [makeEntry()],
+            source: { resolveLatestPlaceVersionAsync: async () => 158 },
+            durationMs: 5000,
+            pollIntervalMs: 1000,
+            redeployAsync: async (_e, v) => {
+                redeployed.push(v);
+            },
+            ...clock,
+        });
+        expect(redeployed).toEqual([]);
+        expect(result.redeploys).toBe(0);
+    });
+    // An entry with no lock entry has no baseline. Treating "unknown -> 158" as a
+    // change would rebuild immediately on startup for no reason.
+    it('adopts the first observed version when there is no baseline', async () => {
+        const redeployed = [];
+        const clock = makeClock(1000);
+        await runLocalWatchLoopAsync({
+            entries: [makeEntry({ baseline: undefined })],
+            source: { resolveLatestPlaceVersionAsync: async () => 158 },
+            durationMs: 3000,
+            pollIntervalMs: 1000,
+            redeployAsync: async (_e, v) => {
+                redeployed.push(v);
+            },
+            ...clock,
+        });
+        expect(redeployed).toEqual([]);
+    });
+    it('keeps watching after a poll failure', async () => {
+        let call = 0;
+        const redeployed = [];
+        const clock = makeClock(1000);
+        const result = await runLocalWatchLoopAsync({
+            entries: [makeEntry()],
+            source: {
+                resolveLatestPlaceVersionAsync: async () => {
+                    call++;
+                    if (call === 1) {
+                        throw new Error('ECONNRESET');
+                    }
+                    return 159;
+                },
+            },
+            durationMs: 3000,
+            pollIntervalMs: 1000,
+            redeployAsync: async (_e, v) => {
+                redeployed.push(v);
+            },
+            ...clock,
+        });
+        expect(redeployed).toEqual([159]);
+        expect(result.redeploys).toBe(1);
+    });
+    // The new version is recorded only on a successful rebuild, so a transient
+    // build failure is retried rather than silently skipped forever.
+    it('retries a version whose rebuild failed', async () => {
+        let attempts = 0;
+        const clock = makeClock(1000);
+        const result = await runLocalWatchLoopAsync({
+            entries: [makeEntry()],
+            source: { resolveLatestPlaceVersionAsync: async () => 159 },
+            durationMs: 3000,
+            pollIntervalMs: 1000,
+            redeployAsync: async () => {
+                attempts++;
+                if (attempts === 1) {
+                    throw new Error('rojo exploded');
+                }
+            },
+            ...clock,
+        });
+        expect(attempts).toBeGreaterThan(1);
+        expect(result.failures).toBe(1);
+        expect(result.redeploys).toBe(1);
+    });
+    it('stops when the caller aborts', async () => {
+        const controller = new AbortController();
+        const clock = makeClock(1000);
+        const poll = vi.fn(async () => {
+            controller.abort();
+            return 158;
+        });
+        const result = await runLocalWatchLoopAsync({
+            entries: [makeEntry()],
+            source: { resolveLatestPlaceVersionAsync: poll },
+            durationMs: 60_000,
+            pollIntervalMs: 1000,
+            redeployAsync: async () => { },
+            signal: controller.signal,
+            ...clock,
+        });
+        expect(poll).toHaveBeenCalledTimes(1);
+        expect(result.expired).toBe(false);
+    });
+    it('watches every entry independently', async () => {
+        const seen = [];
+        const clock = makeClock(1000);
+        await runLocalWatchLoopAsync({
+            entries: [
+                makeEntry({ label: 'hub', placeId: 20, baseline: 1 }),
+                makeEntry({ label: 'lobby', placeId: 21, baseline: 1 }),
+            ],
+            source: {
+                resolveLatestPlaceVersionAsync: async (_u, placeId) => placeId === 21 ? 2 : 1,
+            },
+            durationMs: 2000,
+            pollIntervalMs: 1000,
+            redeployAsync: async (entry) => {
+                seen.push(entry.label);
+            },
+            ...clock,
+        });
+        expect(seen).toContain('lobby');
+        expect(seen).not.toContain('hub');
+    });
+});
+//# sourceMappingURL=local-watch-loop.test.js.map

package/dist/utils/watch/local-watch-loop.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-watch-loop.test.js","sourceRoot":"","sources":["../../../src/utils/watch/local-watch-loop.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAClD,OAAO,EACL,sBAAsB,GAEvB,MAAM,uBAAuB,CAAC;AAE/B,SAAS,SAAS,CAAC,YAAsC,EAAE;IACzD,OAAO;QACL,KAAK,EAAE,wBAAwB;QAC/B,UAAU,EAAE,EAAE;QACd,OAAO,EAAE,EAAE;QACX,WAAW,EAAE,WAAW;QACxB,QAAQ,EAAE,GAAG;QACb,GAAG,SAAS;KACb,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAS,SAAS,CAAC,cAAsB;IACvC,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,OAAO;QACL,GAAG,EAAE,GAAG,EAAE,CAAC,OAAO;QAClB,UAAU,EAAE,KAAK,IAAI,EAAE;YACrB,OAAO,IAAI,cAAc,CAAC;QAC5B,CAAC;KACF,CAAC;AACJ,CAAC;AAED,QAAQ,CAAC,wBAAwB,EAAE,GAAG,EAAE;IACtC,EAAE,CAAC,qCAAqC,EAAE,KAAK,IAAI,EAAE;QACnD,MAAM,QAAQ,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;QACjC,IAAI,CAAC,GAAG,CAAC,CAAC;QACV,MAAM,UAAU,GAAa,EAAE,CAAC;QAChC,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;QAE9B,MAAM,MAAM,GAAG,MAAM,sBAAsB,CAAC;YAC1C,OAAO,EAAE,CAAC,SAAS,EAAE,CAAC;YACtB,MAAM,EAAE;gBACN,8BAA8B,EAAE,KAAK,IAAI,EAAE,CACzC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAE;aAChD;YACD,UAAU,EAAE,IAAI;YAChB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE;gBACvC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC3B,CAAC;YACD,GAAG,KAAK;SACT,CAAC,CAAC;QAEH,MAAM,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAClC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACjC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAChC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iDAAiD,EAAE,KAAK,IAAI,EAAE;QAC/D,MAAM,UAAU,GAAa,EAAE,CAAC;QAChC,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;QAE9B,MAAM,MAAM,GAAG,MAAM,sBAAsB,CAAC;YAC1C,OAAO,EAAE,CAAC,SAAS,EAAE,CAAC;YACtB,MAAM,EAAE,EAAE,8BAA8B,EAAE,KAAK,IAAI,EAAE,CAAC,GAAG,EAAE;YAC3D,UAAU,EAAE,IAAI;YAChB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE;gBAC7B,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACrB,CAAC;YACD,GAAG,KAAK;SACT,CAAC,CAAC;QAEH,MAAM,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC/B,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;IAEH,8EAA8E;IAC9E,6DAA6D;IAC7D,EAAE,CAAC,6DAA6D,EAAE,KAAK,IAAI,EAAE;QAC3E,MAAM,UAAU,GAAa,EAAE,CAAC;QAChC,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;QAE9B,MAAM,sBAAsB,CAAC;YAC3B,OAAO,EAAE,CAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,CAAC;YAC7C,MAAM,EAAE,EAAE,8BAA8B,EAAE,KAAK,IAAI,EAAE,CAAC,GAAG,EAAE;YAC3D,UAAU,EAAE,IAAI;YAChB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE;gBAC7B,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACrB,CAAC;YACD,GAAG,KAAK;SACT,CAAC,CAAC;QAEH,MAAM,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACjC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,KAAK,IAAI,EAAE;QACnD,IAAI,IAAI,GAAG,CAAC,CAAC;QACb,MAAM,UAAU,GAAa,EAAE,CAAC;QAChC,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;QAE9B,MAAM,MAAM,GAAG,MAAM,sBAAsB,CAAC;YAC1C,OAAO,EAAE,CAAC,SAAS,EAAE,CAAC;YACtB,MAAM,EAAE;gBACN,8BAA8B,EAAE,KAAK,IAAI,EAAE;oBACzC,IAAI,EAAE,CAAC;oBACP,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;wBACf,MAAM,IAAI,KAAK,CAAC,YAAY,CAAC,CAAC;oBAChC,CAAC;oBACD,OAAO,GAAG,CAAC;gBACb,CAAC;aACF;YACD,UAAU,EAAE,IAAI;YAChB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE;gBAC7B,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACrB,CAAC;YACD,GAAG,KAAK;SACT,CAAC,CAAC;QAEH,MAAM,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAClC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;IAEH,2EAA2E;IAC3E,iEAAiE;IACjE,EAAE,CAAC,wCAAwC,EAAE,KAAK,IAAI,EAAE;QACtD,IAAI,QAAQ,GAAG,CAAC,CAAC;QACjB,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;QAE9B,MAAM,MAAM,GAAG,MAAM,sBAAsB,CAAC;YAC1C,OAAO,EAAE,CAAC,SAAS,EAAE,CAAC;YACtB,MAAM,EAAE,EAAE,8BAA8B,EAAE,KAAK,IAAI,EAAE,CAAC,GAAG,EAAE;YAC3D,UAAU,EAAE,IAAI;YAChB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,KAAK,IAAI,EAAE;gBACxB,QAAQ,EAAE,CAAC;gBACX,IAAI,QAAQ,KAAK,CAAC,EAAE,CAAC;oBACnB,MAAM,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC;gBACnC,CAAC;YACH,CAAC;YACD,GAAG,KAAK;SACT,CAAC,CAAC;QAEH,MAAM,CAAC,QAAQ,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;QACpC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAChC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8BAA8B,EAAE,KAAK,IAAI,EAAE;QAC5C,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;QAC9B,MAAM,IAAI,GAAG,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE;YAC5B,UAAU,CAAC,KAAK,EAAE,CAAC;YACnB,OAAO,GAAG,CAAC;QACb,CAAC,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,MAAM,sBAAsB,CAAC;YAC1C,OAAO,EAAE,CAAC,SAAS,EAAE,CAAC;YACtB,MAAM,EAAE,EAAE,8BAA8B,EAAE,IAAI,EAAE;YAChD,UAAU,EAAE,MAAM;YAClB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;YAC7B,MAAM,EAAE,UAAU,CAAC,MAAM;YACzB,GAAG,KAAK;SACT,CAAC,CAAC;QAEH,MAAM,CAAC,IAAI,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;QACtC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,KAAK,IAAI,EAAE;QACjD,MAAM,IAAI,GAAa,EAAE,CAAC;QAC1B,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;QAE9B,MAAM,sBAAsB,CAAC;YAC3B,OAAO,EAAE;gBACP,SAAS,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;gBACrD,SAAS,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;aACxD;YACD,MAAM,EAAE;gBACN,8BAA8B,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,CACpD,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;aACzB;YACD,UAAU,EAAE,IAAI;YAChB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;gBAC7B,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YACzB,CAAC;YACD,GAAG,KAAK;SACT,CAAC,CAAC;QAEH,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QAChC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/utils/watch/register-notify-watches.d.ts

@@ -0,0 +1,41 @@
+import { type WatchOption, type WatchRegistry } from '@quenty/nevermore-deploy';
+import { type LocalWatchEntry } from './local-watch-loop.js';
+import { type StreamWatchEntry } from './stream-watch-loop.js';
+export interface RegisterNotifyWatchesOptions {
+    option: WatchOption;
+    /** Lease key within the repository, as for a dispatching monitor. */
+    monitorName: string;
+    entries: LocalWatchEntry[];
+    /** Open Cloud key to share, so the service can poll a private base place. */
+    robloxApiKey?: string;
+    /** Let the GitHub CLI supply the token when no env var does. */
+    useGhAuth?: boolean;
+    /** Injected in tests; defaults to the HTTP registry. */
+    createRegistry?: (registerUrl: string) => WatchRegistry;
+}
+export type RegisterNotifyWatchesResult = {
+    success: true;
+    monitorId: string;
+    /** Bearer token for the stream; the same one registration used. */
+    credential: string;
+    entries: StreamWatchEntry[];
+} | {
+    success: false;
+    reason: 'no_github_context' | 'no_token' | 'unwatchable_version_type' | 'no_entries' | 'register_failed' | 'no_monitor_id';
+    detail?: string;
+};
+/**
+ * Register a monitor that notifies this process instead of dispatching CI.
+ *
+ * Best-effort on purpose. Every way this can fail — no GitHub identity to
+ * register under, no token, a `"saved"` base place the service cannot poll, a
+ * service that is unreachable — has a working answer already: poll Open Cloud
+ * from here. So a failure downgrades the watch rather than the run, and the
+ * caller falls back.
+ */
+export declare function tryRegisterNotifyWatchesAsync(options: RegisterNotifyWatchesOptions): Promise<RegisterNotifyWatchesResult>;
+/** Why the run is polling instead, in words a user can act on. */
+export declare function describeNotifyWatchFallback(result: RegisterNotifyWatchesResult & {
+    success: false;
+}): string;
+//# sourceMappingURL=register-notify-watches.d.ts.map

package/dist/utils/watch/register-notify-watches.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-notify-watches.d.ts","sourceRoot":"","sources":["../../../src/utils/watch/register-notify-watches.ts"],"names":[],"mappings":"AACA,OAAO,EAKL,KAAK,WAAW,EAChB,KAAK,aAAa,EACnB,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/D,MAAM,WAAW,4BAA4B;IAC3C,MAAM,EAAE,WAAW,CAAC;IACpB,qEAAqE;IACrE,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,6EAA6E;IAC7E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gEAAgE;IAChE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,wDAAwD;IACxD,cAAc,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,aAAa,CAAC;CACzD;AAED,MAAM,MAAM,2BAA2B,GACnC;IACE,OAAO,EAAE,IAAI,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,mEAAmE;IACnE,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,gBAAgB,EAAE,CAAC;CAC7B,GACD;IACE,OAAO,EAAE,KAAK,CAAC;IACf,MAAM,EACF,mBAAmB,GACnB,UAAU,GACV,0BAA0B,GAC1B,YAAY,GACZ,iBAAiB,GACjB,eAAe,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEN;;;;;;;;GAQG;AACH,wBAAsB,6BAA6B,CACjD,OAAO,EAAE,4BAA4B,GACpC,OAAO,CAAC,2BAA2B,CAAC,CA2GtC;AAED,kEAAkE;AAClE,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,2BAA2B,GAAG;IAAE,OAAO,EAAE,KAAK,CAAA;CAAE,GACvD,MAAM,CAqBR"}