@hearsay-tools/squawk 0.0.0-stage → 0.17.0-dev.5682

package/dist/server/completion-actions.js

@@ -0,0 +1,261 @@
+import { archivePullRequests, pullRequestKey } from '../runs/pull-requests.js';
+/** Durable task intent drives bounded background work. No browser, agent, or recovery is needed. */
+export class CompletionActionCoordinator {
+    deps;
+    interval;
+    timer;
+    stopped = false;
+    busy = false;
+    projectCursor = 0;
+    cursors = new Map();
+    retries = new Map();
+    constructor(deps, interval = 15_000) {
+        this.deps = deps;
+        this.interval = interval;
+    }
+    start() {
+        if (this.timer || this.busy)
+            return;
+        this.stopped = false;
+        const poll = async () => {
+            await this.tick();
+            if (!this.stopped) {
+                this.timer = setTimeout(poll, this.interval);
+                this.timer.unref?.();
+            }
+        };
+        this.timer = setTimeout(poll, 0);
+        this.timer.unref?.();
+    }
+    stop() { this.stopped = true; if (this.timer)
+        clearTimeout(this.timer); this.timer = undefined; }
+    async tick() {
+        if (this.busy || this.stopped)
+            return;
+        this.busy = true;
+        try {
+            const projects = (await this.deps.projects()).filter(project => project.status !== 'missing');
+            const ids = new Set(projects.map(project => project.id));
+            for (const id of this.cursors.keys())
+                if (!ids.has(id))
+                    this.cursors.delete(id);
+            // Four projects and four tasks per project. Keyset cursors keep blocked tasks fair.
+            for (let i = 0; i < Math.min(4, projects.length) && !this.stopped; i++) {
+                const project = projects[this.projectCursor++ % projects.length];
+                await this.deps.withStore(project, async (store, valid) => {
+                    await this.processProjectCompletions(project, store, valid);
+                }).catch(() => undefined); // An unavailable project cannot stop the other projects.
+            }
+            while (this.retries.size > 1024)
+                this.retries.delete(this.retries.keys().next().value);
+        }
+        finally {
+            this.busy = false;
+        }
+    }
+    async processProjectCompletions(project, store, valid) {
+        if (!valid() || this.stopped)
+            return;
+        const page = store.listCompletionCandidates(this.cursors.get(project.id) ?? 0, 16);
+        this.cursors.set(project.id, page.length === 16 ? page.at(-1).seq : 0);
+        let admitted = 0;
+        for (const item of page) {
+            if (!valid() || this.stopped)
+                break;
+            if (!await this.processCompletionCandidate(project, store, valid, item))
+                continue;
+            if (++admitted === 4) {
+                this.cursors.set(project.id, item.seq);
+                break;
+            }
+        }
+    }
+    async processCompletionCandidate(project, store, valid, item) {
+        const saved = store.getRun(item.id), run = saved ? { ...saved } : undefined, token = run?.completionAction?.id;
+        if (!run || !token)
+            return false;
+        const key = `${project.id}:${run.id}:${token}`;
+        if ((this.retries.get(key)?.nextAt ?? 0) > Date.now())
+            return false;
+        const current = () => {
+            if (this.stopped || !valid())
+                return false;
+            const latest = store.getRun(item.id);
+            return store.canCompleteAction(item.id, token) && latest?.branch === run.branch;
+        };
+        try {
+            return await this.runClaimedCompletion(project, store, run, token, key, current);
+        }
+        catch {
+            if (current()) {
+                store.completeAction(run.id, token, 'blocked', 'PR auto-merge is unavailable. Check GitHub, retry later, or turn it off.');
+                this.backoff(key);
+            }
+            return true;
+        }
+        finally {
+            store.unpin(run.id, 'maintenance');
+        }
+    }
+    async runClaimedCompletion(project, store, run, token, key, current) {
+        if (!current())
+            return false;
+        store.pin(run.id, 'maintenance');
+        if (!store.claimCompletionAction(run.id, token))
+            return false;
+        await store.prepareArchiveOnMerge(run.id);
+        if (!current())
+            return false;
+        const result = await this.process(project, run, current);
+        if (result === undefined || !current())
+            return false;
+        store.completeAction(run.id, token, result ? 'blocked' : 'complete', result);
+        if (result)
+            this.backoff(key);
+        else
+            this.retries.delete(key);
+        return true;
+    }
+    backoff(key) {
+        const attempts = Math.min(6, (this.retries.get(key)?.attempts ?? 0) + 1);
+        this.retries.delete(key);
+        this.retries.set(key, { attempts, nextAt: Date.now() + Math.min(300_000, this.interval * 2 ** (attempts - 1)) });
+    }
+    /** undefined means intent changed; empty string means all verified work is complete. */
+    async process(project, run, current) {
+        if (!run.autoMergePr)
+            return '';
+        const created = createdPullRequests(run);
+        const early = createdPullRequestsReady(run, created);
+        if (early !== undefined)
+            return early;
+        const branch = run.branch;
+        if (!branch)
+            return 'The task has no owned branch. Merge its PR manually or turn off Auto-merge PR.';
+        const resolved = await this.resolveMergeDriver(project, current);
+        if (!resolved.ok)
+            return resolved.result;
+        const local = localCreatedIdentities(created, resolved.repository);
+        if (typeof local === 'string')
+            return local;
+        const head = await this.deps.head(project, branch);
+        if (!current())
+            return;
+        if (!head)
+            return 'The task branch is unavailable. Restore it or merge the PR manually.';
+        for (const identity of local) {
+            const result = await this.mergeCreatedPullRequest(project, branch, identity, resolved, head, current);
+            if (result !== true)
+                return result;
+        }
+        return '';
+    }
+    async resolveMergeDriver(project, current) {
+        const resolved = await this.deps.forge(project);
+        if (!current())
+            return { ok: false };
+        if (!resolved)
+            return { ok: false, result: 'PR auto-merge is unavailable for this repository. Merge manually or turn it off.' };
+        const { driver, repository } = resolved;
+        if (!driver.prMergeState || !driver.mergePR)
+            return { ok: false, result: 'PR auto-merge is unavailable for this repository. Merge manually or turn it off.' };
+        return { ok: true, driver: driver, repository };
+    }
+    async mergeCreatedPullRequest(project, branch, identity, resolved, head, current) {
+        const { driver, repository } = resolved;
+        let result = await driver.prMergeState(identity.number, { refresh: true });
+        if (!current())
+            return;
+        if (!result.available)
+            return result.reason;
+        let state = result.mergeState;
+        const ownership = () => prOwnedByTask(state, branch, head, identity, repository);
+        if (!ownership())
+            return 'The PR branch or head differs from this task. Review and push the task branch before retrying.';
+        if (state.state === 'merged')
+            return true; // Reconcile a successful mutation whose response was lost.
+        if (state.state !== 'open')
+            return 'The task PR is closed without a merge. Reopen it or turn off Auto-merge PR.';
+        if (state.isDraft) {
+            const ready = await this.markDraftReady(driver, identity.number, branch, head, current);
+            if (!ready || typeof ready === 'string')
+                return ready;
+            result = ready;
+            state = result.mergeState;
+            if (!ownership())
+                return 'The PR changed while it was marked ready. Review its branch and head.';
+        }
+        const blocker = mergeBlocker(state);
+        if (blocker)
+            return blocker;
+        return this.commitPullRequestMerge(project, driver, identity.number, branch, head, state, current);
+    }
+    async markDraftReady(driver, number, branch, head, current) {
+        if (!driver.readyPR)
+            return 'The task PR is a draft. Mark it ready or turn off Auto-merge PR.';
+        const result = await driver.readyPR(number, { expectedHeadSha: head, expectedHeadRef: branch, canProceed: current });
+        if (!current())
+            return;
+        if (!result.available)
+            return result.reason;
+        return result;
+    }
+    async commitPullRequestMerge(project, driver, number, branch, head, state, current) {
+        // Re-read local branch before the mutation; the forge re-reads remote state and intent.
+        if (await this.deps.head(project, branch) !== head || !current())
+            return current() ? 'The task branch changed. Wait for CI on the new head.' : undefined;
+        const merged = await driver.mergePR(number, { method: state.defaultMethod, expectedHeadSha: head,
+            expectedHeadRef: branch, requirePassingChecks: true, canProceed: current });
+        if (!current())
+            return;
+        if (!merged.merged)
+            return merged.error;
+        return true;
+    }
+}
+function createdPullRequests(run) {
+    const created = run.pullRequests?.filter(pr => pr.source === 'created') ?? [];
+    if (run.pullRequestUrl && !created.some(pr => pr.url === run.pullRequestUrl)) {
+        const number = Number(/\/pull\/([1-9][0-9]*)\/?$/.exec(run.pullRequestUrl)?.[1]);
+        if (number)
+            created.push({ number, url: run.pullRequestUrl, source: 'created' });
+    }
+    return created;
+}
+function createdPullRequestsReady(run, created) {
+    if (!created.length) {
+        if (run.pullRequests?.length || run.referencedPullRequestUrl || run.prNumber || run.markerRefs?.pr)
+            return 'No PR is verified as created by this task. Check its PR association, merge manually, or turn off Auto-merge PR.';
+        return '';
+    }
+    if (!run.branch || (!run.worktreePath && run.delegation?.role !== 'worker'))
+        return 'The task has no owned branch. Merge its PR manually or turn off Auto-merge PR.';
+    if (created.length > 16)
+        return 'Too many created PRs to merge automatically. Review and merge them manually.';
+    return undefined;
+}
+function localCreatedIdentities(created, repository) {
+    const local = archivePullRequests([{ pullRequests: created.map(pr => ({ ...pr, url: pr.url ?? '' })) }], repository);
+    const own = archivePullRequests([{ pullRequestUrl: `${repository}/pull/1` }], repository)?.[0];
+    if (!local || !own || local.some(pr => pr.owner !== own.owner || pr.repo !== own.repo))
+        return 'A created PR has an unknown or different repository. Check its association or merge manually.';
+    return local;
+}
+function prOwnedByTask(state, branch, head, identity, repository) {
+    return state.headRef === branch && state.headSha === head &&
+        !!archivePullRequests([{ pullRequestUrl: state.url }], repository)?.some(pr => pullRequestKey(pr) === pullRequestKey(identity));
+}
+function mergeBlocker(state) {
+    if (state.isDraft)
+        return 'The PR is still a draft. Mark it ready or merge manually.';
+    if (!state.checks.length)
+        return 'Waiting for CI checks on the current PR head.';
+    if (state.checks.some(check => check.state !== 'passing'))
+        return 'Waiting for all CI checks on the current PR head to pass.';
+    if (!state.canMerge)
+        return state.blockers.map(blocker => blocker.message).join(' ') || 'Waiting for GitHub review and branch requirements.';
+    if (!state.defaultMethod || !state.methods.includes(state.defaultMethod))
+        return 'The repository has no permitted merge method. Merge manually.';
+    return undefined;
+}
+//# sourceMappingURL=completion-actions.js.map

package/dist/server/completion-actions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion-actions.js","sourceRoot":"","sources":["../../src/server/completion-actions.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAgB/E,oGAAoG;AACpG,MAAM,OAAO,2BAA2B;IAQT,IAAI;IAAyC,QAAQ;IAP1E,KAAK,CAA6C;IAClD,OAAO,GAAG,KAAK,CAAC;IAChB,IAAI,GAAG,KAAK,CAAC;IACb,aAAa,GAAG,CAAC,CAAC;IACT,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;IACpC,OAAO,GAAG,IAAI,GAAG,EAAgD,CAAC;IAEnF,YAA6B,IAA0B,EAAmB,QAAQ,GAAG,MAAM;oBAA9D,IAAI;wBAAyC,QAAQ;IAAY,CAAC;IAE/F,KAAK;QACH,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,IAAI;YAAE,OAAO;QACpC,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;QACrB,MAAM,IAAI,GAAG,KAAK,IAAI,EAAE;YACtB,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;YAClB,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;gBAAC,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;gBAAC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC;YAAC,CAAC;QAC5F,CAAC,CAAC;QACF,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QAAC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC;IACzD,CAAC;IAED,IAAI,KAAW,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK;QAAE,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC,CAAC,CAAC;IAEvG,KAAK,CAAC,IAAI;QACR,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO;QACtC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC;YAC9F,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC;YACzD,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE;gBAAE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;oBAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YAChF,oFAAoF;YACpF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,EAAE,CAAC;gBACvE,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,aAAa,EAAE,GAAG,QAAQ,CAAC,MAAM,CAAE,CAAC;gBAClE,MAAM,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;oBACxD,MAAM,IAAI,CAAC,yBAAyB,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;gBAC9D,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,yDAAyD;YACtF,CAAC;YACD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,GAAG,IAAI;gBAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAM,CAAC,CAAC;QAC1F,CAAC;gBAAS,CAAC;YAAC,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC;QAAC,CAAC;IAClC,CAAC;IAEO,KAAK,CAAC,yBAAyB,CAAC,OAAuB,EAAE,KAAe,EAAE,KAAoB;QACpG,IAAI,CAAC,KAAK,EAAE,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO;QACrC,MAAM,IAAI,GAAG,KAAK,CAAC,wBAAwB,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;QACnF,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,IAAI,CAAC,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACxE,IAAI,QAAQ,GAAG,CAAC,CAAC;QACjB,KAAK,MAAM,IAAI,IAAI,IAAI,EAAE,CAAC;YACxB,IAAI,CAAC,KAAK,EAAE,IAAI,IAAI,CAAC,OAAO;gBAAE,MAAM;YACpC,IAAI,CAAC,MAAM,IAAI,CAAC,0BAA0B,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC;gBAAE,SAAS;YAClF,IAAI,EAAE,QAAQ,KAAK,CAAC,EAAE,CAAC;gBAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;gBAAC,MAAM;YAAC,CAAC;QAC1E,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,0BAA0B,CACtC,OAAuB,EAAE,KAAe,EAAE,KAAoB,EAAE,IAAiC;QAEjG,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,EAAE,KAAK,GAAG,GAAG,EAAE,gBAAgB,EAAE,EAAE,CAAC;QAC/G,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK;YAAE,OAAO,KAAK,CAAC;QACjC,MAAM,GAAG,GAAG,GAAG,OAAO,CAAC,EAAE,IAAI,GAAG,CAAC,EAAE,IAAI,KAAK,EAAE,CAAC;QAC/C,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE;YAAE,OAAO,KAAK,CAAC;QACpE,MAAM,OAAO,GAAG,GAAG,EAAE;YACnB,IAAI,IAAI,CAAC,OAAO,IAAI,CAAC,KAAK,EAAE;gBAAE,OAAO,KAAK,CAAC;YAC3C,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACrC,OAAO,KAAK,CAAC,iBAAiB,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,CAAC,IAAI,MAAM,EAAE,MAAM,KAAK,GAAG,CAAC,MAAM,CAAC;QAClF,CAAC,CAAC;QACF,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,oBAAoB,CAAC,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;QACnF,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,OAAO,EAAE,EAAE,CAAC;gBACd,KAAK,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,0EAA0E,CAAC,CAAC;gBAC3H,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YACpB,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;gBAAS,CAAC;YAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,aAAa,CAAC,CAAC;QAAC,CAAC;IACnD,CAAC;IAEO,KAAK,CAAC,oBAAoB,CAChC,OAAuB,EAAE,KAAe,EAAE,GAAc,EAAE,KAAa,EAAE,GAAW,EAAE,OAAsB;QAE5G,IAAI,CAAC,OAAO,EAAE;YAAE,OAAO,KAAK,CAAC;QAC7B,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,aAAa,CAAC,CAAC;QACjC,IAAI,CAAC,KAAK,CAAC,qBAAqB,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QAC9D,MAAM,KAAK,CAAC,qBAAqB,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC1C,IAAI,CAAC,OAAO,EAAE;YAAE,OAAO,KAAK,CAAC;QAC7B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;QACzD,IAAI,MAAM,KAAK,SAAS,IAAI,CAAC,OAAO,EAAE;YAAE,OAAO,KAAK,CAAC;QACrD,KAAK,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QAC7E,IAAI,MAAM;YAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;;YAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7D,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,OAAO,CAAC,GAAW;QACzB,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,QAAQ,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACzE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACzB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,QAAQ,GAAG,CAAC,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACnH,CAAC;IAED,wFAAwF;IAChF,KAAK,CAAC,OAAO,CAAC,OAAuB,EAAE,GAAc,EAAE,OAAsB;QACnF,IAAI,CAAC,GAAG,CAAC,WAAW;YAAE,OAAO,EAAE,CAAC;QAChC,MAAM,OAAO,GAAG,mBAAmB,CAAC,GAAG,CAAC,CAAC;QACzC,MAAM,KAAK,GAAG,wBAAwB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QACrD,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,KAAK,CAAC;QACtC,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,MAAM;YAAE,OAAO,gFAAgF,CAAC;QACrG,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACjE,IAAI,CAAC,QAAQ,CAAC,EAAE;YAAE,OAAO,QAAQ,CAAC,MAAM,CAAC;QACzC,MAAM,KAAK,GAAG,sBAAsB,CAAC,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC;QACnE,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;QAC5C,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACnD,IAAI,CAAC,OAAO,EAAE;YAAE,OAAO;QACvB,IAAI,CAAC,IAAI;YAAE,OAAO,sEAAsE,CAAC;QACzF,KAAK,MAAM,QAAQ,IAAI,KAAK,EAAE,CAAC;YAC7B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,uBAAuB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;YACtG,IAAI,MAAM,KAAK,IAAI;gBAAE,OAAO,MAAM,CAAC;QACrC,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC;IAEO,KAAK,CAAC,kBAAkB,CAC9B,OAAuB,EAAE,OAAsB;QAE/C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAChD,IAAI,CAAC,OAAO,EAAE;YAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC;QACrC,IAAI,CAAC,QAAQ;YAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,kFAAkF,EAAE,CAAC;QAChI,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,QAAQ,CAAC;QACxC,IAAI,CAAC,MAAM,CAAC,YAAY,IAAI,CAAC,MAAM,CAAC,OAAO;YAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,kFAAkF,EAAE,CAAC;QAC9J,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,MAAqB,EAAE,UAAU,EAAE,CAAC;IACjE,CAAC;IAEO,KAAK,CAAC,uBAAuB,CACnC,OAAuB,EAAE,MAAc,EAAE,QAAoC,EAC7E,QAAqD,EAAE,IAAY,EAAE,OAAsB;QAE3F,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,QAAQ,CAAC;QACxC,IAAI,MAAM,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3E,IAAI,CAAC,OAAO,EAAE;YAAE,OAAO;QACvB,IAAI,CAAC,MAAM,CAAC,SAAS;YAAE,OAAO,MAAM,CAAC,MAAM,CAAC;QAC5C,IAAI,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC;QAC9B,MAAM,SAAS,GAAG,GAAG,EAAE,CAAC,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;QACjF,IAAI,CAAC,SAAS,EAAE;YAAE,OAAO,gGAAgG,CAAC;QAC1H,IAAI,KAAK,CAAC,KAAK,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC,CAAC,2DAA2D;QACtG,IAAI,KAAK,CAAC,KAAK,KAAK,MAAM;YAAE,OAAO,6EAA6E,CAAC;QACjH,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;YAClB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;YACxF,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;gBAAE,OAAO,KAAK,CAAC;YACtD,MAAM,GAAG,KAAK,CAAC;YACf,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC;YAC1B,IAAI,CAAC,SAAS,EAAE;gBAAE,OAAO,uEAAuE,CAAC;QACnG,CAAC;QACD,MAAM,OAAO,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;QACpC,IAAI,OAAO;YAAE,OAAO,OAAO,CAAC;QAC5B,OAAO,IAAI,CAAC,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IACrG,CAAC;IAEO,KAAK,CAAC,cAAc,CAC1B,MAAmB,EAAE,MAAc,EAAE,MAAc,EAAE,IAAY,EAAE,OAAsB;QAEzF,IAAI,CAAC,MAAM,CAAC,OAAO;YAAE,OAAO,kEAAkE,CAAC;QAC/F,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE,eAAe,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC;QACrH,IAAI,CAAC,OAAO,EAAE;YAAE,OAAO;QACvB,IAAI,CAAC,MAAM,CAAC,SAAS;YAAE,OAAO,MAAM,CAAC,MAAM,CAAC;QAC5C,OAAO,MAAM,CAAC;IAChB,CAAC;IAEO,KAAK,CAAC,sBAAsB,CAClC,OAAuB,EAAE,MAAmB,EAAE,MAAc,EAAE,MAAc,EAAE,IAAY,EAC1F,KAAwB,EAAE,OAAsB;QAEhD,wFAAwF;QACxF,IAAI,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,IAAI,IAAI,CAAC,OAAO,EAAE;YAAE,OAAO,OAAO,EAAE,CAAC,CAAC,CAAC,uDAAuD,CAAC,CAAC,CAAC,SAAS,CAAC;QACzJ,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,aAAc,EAAE,eAAe,EAAE,IAAI;YAC/F,eAAe,EAAE,MAAM,EAAE,oBAAoB,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC;QAC9E,IAAI,CAAC,OAAO,EAAE;YAAE,OAAO;QACvB,IAAI,CAAC,MAAM,CAAC,MAAM;YAAE,OAAO,MAAM,CAAC,KAAK,CAAC;QACxC,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AAED,SAAS,mBAAmB,CAAC,GAAc;IACzC,MAAM,OAAO,GAAG,GAAG,CAAC,YAAY,EAAE,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,MAAM,KAAK,SAAS,CAAC,IAAI,EAAE,CAAC;IAC9E,IAAI,GAAG,CAAC,cAAc,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,KAAK,GAAG,CAAC,cAAc,CAAC,EAAE,CAAC;QAC7E,MAAM,MAAM,GAAG,MAAM,CAAC,2BAA2B,CAAC,IAAI,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QACjF,IAAI,MAAM;YAAE,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,CAAC,cAAc,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;IACnF,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,wBAAwB,CAAC,GAAc,EAAE,OAA+C;IAC/F,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QACpB,IAAI,GAAG,CAAC,YAAY,EAAE,MAAM,IAAI,GAAG,CAAC,wBAAwB,IAAI,GAAG,CAAC,QAAQ,IAAI,GAAG,CAAC,UAAU,EAAE,EAAE;YAChG,OAAO,iHAAiH,CAAC;QAC3H,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,IAAI,CAAC,GAAG,CAAC,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC,YAAY,IAAI,GAAG,CAAC,UAAU,EAAE,IAAI,KAAK,QAAQ,CAAC;QACzE,OAAO,gFAAgF,CAAC;IAC1F,IAAI,OAAO,CAAC,MAAM,GAAG,EAAE;QAAE,OAAO,8EAA8E,CAAC;IAC/G,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,sBAAsB,CAC7B,OAA+C,EAAE,UAAkB;IAEnE,MAAM,KAAK,GAAG,mBAAmB,CAAC,CAAC,EAAE,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,UAAU,CAAC,CAAC;IACrH,MAAM,GAAG,GAAG,mBAAmB,CAAC,CAAC,EAAE,cAAc,EAAE,GAAG,UAAU,SAAS,EAAE,CAAC,EAAE,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC/F,IAAI,CAAC,KAAK,IAAI,CAAC,GAAG,IAAI,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,KAAK,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,CAAC;QACpF,OAAO,+FAA+F,CAAC;IACzG,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,aAAa,CACpB,KAAwB,EAAE,MAAc,EAAE,IAAY,EAAE,QAAoC,EAAE,UAAkB;IAEhH,OAAO,KAAK,CAAC,OAAO,KAAK,MAAM,IAAI,KAAK,CAAC,OAAO,KAAK,IAAI;QACvD,CAAC,CAAC,mBAAmB,CAAC,CAAC,EAAE,cAAc,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,UAAU,CAAC,EAAE,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,cAAc,CAAC,EAAE,CAAC,KAAK,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC;AACpI,CAAC;AAED,SAAS,YAAY,CAAC,KAAwB;IAC5C,IAAI,KAAK,CAAC,OAAO;QAAE,OAAO,2DAA2D,CAAC;IACtF,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM;QAAE,OAAO,+CAA+C,CAAC;IACjF,IAAI,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,KAAK,SAAS,CAAC;QAAE,OAAO,2DAA2D,CAAC;IAC9H,IAAI,CAAC,KAAK,CAAC,QAAQ;QAAE,OAAO,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,oDAAoD,CAAC;IAC7I,IAAI,CAAC,KAAK,CAAC,aAAa,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,aAAa,CAAC;QAAE,OAAO,+DAA+D,CAAC;IACjJ,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/server/config-merge.d.ts

@@ -0,0 +1,11 @@
+import type { SetConfigInput } from '../contract/index.js';
+type RawConfig = Record<string, unknown>;
+/** Merge parsed config fields without materializing defaults or mutating either input. */
+export declare function mergeConfig(raw: RawConfig, body: SetConfigInput): RawConfig;
+/**
+ * `PUT /config`'s write: merge `body` into the project's `config.json` under the config lock.
+ * A file only the schema refuses is merged into. One that is not a JSON object is never
+ * overwritten, since the user's keys in it would be lost: the answer is why it cannot be read.
+ */
+export declare function writeMergedConfig(dataDir: string, body: SetConfigInput): Promise<string | undefined>;
+export {};

package/dist/server/config-merge.js

@@ -0,0 +1,74 @@
+import { updateConfigFile } from '../config.js';
+/** Undefined leaves a key alone; each field supplies its existing clear sentinels. */
+function applyValue(raw, key, value, clear = [null]) {
+    if (value === undefined)
+        return;
+    if (clear.includes(value))
+        delete raw[key];
+    else
+        raw[key] = value;
+}
+function applyWorktreeSetup(raw, body) {
+    // null or no commands = no setup: delete the key rather than store an empty list.
+    const setup = body.worktreeSetup;
+    if (setup === undefined)
+        return;
+    if (setup === null || setup.commands.length === 0)
+        delete raw.worktreeSetup;
+    else
+        raw.worktreeSetup = {
+            commands: setup.commands,
+            ...(setup.timeoutSeconds !== undefined ? { timeoutSeconds: setup.timeoutSeconds } : {}),
+        };
+}
+function applyDefaultModels(raw, body) {
+    if (body.defaultModels === undefined)
+        return;
+    // Per-runner merge, so setting codex's preset never clobbers claude's.
+    // Unknown keys from the existing file survive too.
+    const current = raw.defaultModels && typeof raw.defaultModels === 'object'
+        ? { ...raw.defaultModels }
+        : {};
+    for (const [runner, model] of Object.entries(body.defaultModels)) {
+        applyValue(current, runner, model, [null, '']);
+    }
+    if (Object.keys(current).length === 0)
+        delete raw.defaultModels;
+    else
+        raw.defaultModels = current;
+}
+// Keep the old field order, including insertion order in the serialized config.
+const fieldAppliers = {
+    baseBranch: (raw, body) => applyValue(raw, 'baseBranch', body.baseBranch),
+    defaultRunner: (raw, body) => applyValue(raw, 'defaultRunner', body.defaultRunner),
+    // '' and null both clear: an emptied textarea means "no extra prompt".
+    systemPrompt: (raw, body) => applyValue(raw, 'systemPrompt', body.systemPrompt, [null, '']),
+    maxParallel: (raw, body) => applyValue(raw, 'maxParallel', body.maxParallel),
+    // null clears back to the default (10); a number (including 0 = unlimited)
+    // is stored as-is.
+    worktreeRetention: (raw, body) => applyValue(raw, 'worktreeRetention', body.worktreeRetention),
+    liveTitleUpdates: (raw, body) => applyValue(raw, 'liveTitleUpdates', body.liveTitleUpdates),
+    archiveOnMerge: (raw, body) => applyValue(raw, 'archiveOnMerge', body.archiveOnMerge),
+    reviewGate: (raw, body) => applyValue(raw, 'reviewGate', body.reviewGate),
+    // null or 0 both mean "no ceiling" — drop the key back to the default.
+    memoryLimitMb: (raw, body) => applyValue(raw, 'memoryLimitMb', body.memoryLimitMb, [null, 0]),
+    worktreeSetup: applyWorktreeSetup,
+    defaultModels: applyDefaultModels,
+};
+/** Merge parsed config fields without materializing defaults or mutating either input. */
+export function mergeConfig(raw, body) {
+    // The reader accepts arrays too; preserve their JSON serialization behavior.
+    const next = Array.isArray(raw) ? Object.assign([...raw], raw) : { ...raw };
+    for (const apply of Object.values(fieldAppliers))
+        apply(next, body);
+    return next;
+}
+/**
+ * `PUT /config`'s write: merge `body` into the project's `config.json` under the config lock.
+ * A file only the schema refuses is merged into. One that is not a JSON object is never
+ * overwritten, since the user's keys in it would be lost: the answer is why it cannot be read.
+ */
+export function writeMergedConfig(dataDir, body) {
+    return updateConfigFile(dataDir, (current) => current.raw ? { write: mergeConfig(current.raw, body), result: undefined } : { refuse: current.ok ? undefined : current.issue });
+}
+//# sourceMappingURL=config-merge.js.map

package/dist/server/config-merge.js.map

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

package/dist/server/create-project.d.ts

@@ -0,0 +1,71 @@
+import type { GithubOwnersResponse } from '../contract/index.js';
+import { type CheckoutProgressEvent } from './checkout.ts';
+export type CommandResult = {
+    ok: true;
+    stdout: string;
+} | {
+    ok: false;
+    error: string;
+    notFound?: boolean;
+};
+/** Run one command (never through a shell). Injected so tests can drive the
+ *  flow without `gh`, a network, or a git identity. `onLine` receives
+ *  progress/stderr lines as they arrive. */
+export type CommandRunner = (cmd: 'git' | 'gh', args: string[], opts: {
+    cwd: string;
+    onLine?: (line: string) => void;
+    signal?: AbortSignal | undefined;
+}) => Promise<CommandResult>;
+export declare const spawnCommandRunner: CommandRunner;
+/**
+ * `CEZ_DRY_RUN=1` — real `git` (it is local and required anyway), fake `gh`
+ * and a fake `git push`. Answers the pre-checks as a signed-in account whose
+ * name is free and whose template is valid. The fake template clone writes
+ * only inside the directory the caller created, as a real repo with one commit,
+ * so the registered project can host task worktrees like a real one.
+ */
+export declare const dryRunCommandRunner: CommandRunner;
+export type CreateProjectFailure = {
+    ok: false;
+    status: 400 | 409 | 500;
+    error: string;
+} | {
+    ok: false;
+    status: 503;
+    error: string;
+    reason: string;
+};
+/** `kind` — what was created: a local-only repo, an empty GitHub-backed one, or one from a
+ *  template. `warning` — the GitHub repository exists but a later step did not finish. */
+export type CreateProjectResult = {
+    ok: true;
+    target: string;
+    name: string;
+    slug?: string;
+    kind: 'local' | 'github' | 'template';
+    warning?: string;
+} | CreateProjectFailure;
+export interface CreateProjectOptions {
+    /** Project name — both the folder name and, with `github`, the repo name. */
+    name: string;
+    /** Present ⇒ also create a PRIVATE GitHub repository under `owner`. */
+    github?: {
+        owner: string;
+        template?: string | undefined;
+    } | undefined;
+    /** The checkout root, ALREADY `~`-expanded by the caller. */
+    projectsDir: string;
+    onProgress: (event: CheckoutProgressEvent) => void;
+    checkoutId?: string | undefined;
+    /** Cancels the steps BEFORE `gh repo create` only (see the module docstring). */
+    signal?: AbortSignal | undefined;
+    /** Test seam; defaults to spawning real commands (or the dry-run fake). */
+    run?: CommandRunner;
+    /** Test seam for the template wait. */
+    sleep?: (ms: number) => Promise<void>;
+}
+export declare function createProject(opts: CreateProjectOptions): Promise<CreateProjectResult>;
+/** `GET /api/v1/projects/github-owners` — who a new repository may belong to:
+ *  the signed-in user first, then their organisations, each with its avatar
+ *  (and an org's description) for the dialog's owner cards. */
+export declare function listGithubOwners(run?: CommandRunner): Promise<GithubOwnersResponse>;