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

package/dist/runs/worker-execution.js

@@ -0,0 +1,30 @@
+import { lstatSync, readdirSync, realpathSync } from 'node:fs';
+import { isAbsolute, join, resolve } from 'node:path';
+import { z } from 'zod';
+/** Terminal task intent survives loss/quarantine of the public run index. Starting a new
+ * generation replaces this entire checkpoint, so an old cleanup cannot authorize reuse. */
+export const workerExecutionSchema = z.object({
+    generation: z.string().uuid(), phase: z.enum(['queued', 'starting', 'complete']), neverMaterialized: z.literal(true).optional(),
+    // Settlement after a same-boot crash with unverified holders is not exit proof (hearsay-tools/cezarion#839).
+    abandoned: z.literal(true).optional(),
+    scratchCleanup: z.object({ resourceId: z.string().uuid(), path: z.string().refine(isAbsolute) }).strict().optional(),
+}).strict().refine(proof => ((!proof.neverMaterialized && !proof.scratchCleanup && !proof.abandoned) || proof.phase === 'complete') &&
+    !(proof.abandoned && proof.neverMaterialized));
+/** Presence, not parseability, reserves scratch. Unknown evidence must never turn into an
+ * orphan merely because runs.json was missing, partly salvaged, or unreadable. Undefined
+ * means enumeration itself is uncertain: callers retain all scratch and retry later. */
+export function workerEvidenceRunIds(dataDir) {
+    const dir = join(dataDir, 'runs');
+    try {
+        if (!lstatSync(dir).isDirectory() || realpathSync(dir) !== resolve(dir))
+            return undefined;
+        return [...new Set(readdirSync(dir).flatMap(name => {
+                const match = /^([0-9a-f-]{36})\.(?:identity|execution|processes)\.json(?:\..*\.tmp)?$/i.exec(name);
+                return match && z.string().uuid().safeParse(match[1]).success ? [match[1]] : [];
+            }))];
+    }
+    catch (error) {
+        return error.code === 'ENOENT' ? [] : undefined;
+    }
+}
+//# sourceMappingURL=worker-execution.js.map

package/dist/runs/worker-execution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-execution.js","sourceRoot":"","sources":["../../src/runs/worker-execution.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC/D,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACtD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;2FAC2F;AAC3F,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC,EAAE,iBAAiB,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE;IAC/H,6GAA6G;IAC7G,SAAS,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE;IACrC,cAAc,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACrH,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,iBAAiB,IAAI,CAAC,KAAK,CAAC,cAAc,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,KAAK,CAAC,KAAK,KAAK,UAAU,CAAC;IACjI,CAAC,CAAC,KAAK,CAAC,SAAS,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC,CAAC;AAGjD;;wFAEwF;AACxF,MAAM,UAAU,oBAAoB,CAAC,OAAe;IAClD,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAClC,IAAI,CAAC;QACH,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,IAAI,YAAY,CAAC,GAAG,CAAC,KAAK,OAAO,CAAC,GAAG,CAAC;YAAE,OAAO,SAAS,CAAC;QAC1F,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE;gBACjD,MAAM,KAAK,GAAG,0EAA0E,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACpG,OAAO,KAAK,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACnF,CAAC,CAAC,CAAC,CAAC,CAAC;IACP,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAAC,OAAQ,KAA+B,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IAAC,CAAC;AACjG,CAAC"}

package/dist/runs/worker-resource-holders.d.ts

@@ -0,0 +1,17 @@
+import type { RunRecord } from '../contract/index.js';
+import { type GenerationProbe, type WorkerProcessRecord } from '../delegation/process-liveness.ts';
+import type { WorkerExecution } from './worker-execution.ts';
+type WorkerOwnedRun = RunRecord & {
+    delegation: Extract<RunRecord['delegation'], {
+        role: 'worker';
+    }>;
+};
+/** The row owns this generation's workspace and the checkpoint is complete, or queued when admitting. */
+export declare function workerResourceAuthorized(run: RunRecord | undefined, proof: WorkerExecution | undefined, id: string, generation: string, resourceId: string, admittingQueued?: boolean): run is WorkerOwnedRun;
+/** Only ENOENT at every path proves absence; existsSync would also hide access errors. */
+export declare function workerResourcePathsGone(paths: readonly string[]): boolean;
+/** Recorded survivors still block reuse when every persistent path is already gone. */
+export declare function workerResourceAbsentHolders(record: WorkerProcessRecord | 'absent'): 'safe' | number[];
+/** Live PIDs that refuse reuse, or `safe` when the generation is gone. */
+export declare function workerResourceLiveHolders(probe: GenerationProbe): 'safe' | number[];
+export {};

package/dist/runs/worker-resource-holders.js

@@ -0,0 +1,34 @@
+/**
+ * Holder proof for worker persistent paths (worktree and scratch). `RunStore.workerResourceHolders`
+ * reads the row and checkpoints, then these helpers decide whether the generation is gone.
+ */
+import { lstatSync } from 'node:fs';
+import { isCurrentProcess, recordedProcessLive } from '../delegation/process-liveness.js';
+/** The row owns this generation's workspace and the checkpoint is complete, or queued when admitting. */
+export function workerResourceAuthorized(run, proof, id, generation, resourceId, admittingQueued) {
+    return !(run?.delegation?.role !== 'worker' || run.delegation.workspace.ownerRunId !== id ||
+        run.delegation.workspace.resourceId !== resourceId || proof?.generation !== generation ||
+        (proof.phase !== 'complete' && !(admittingQueued && proof.phase === 'queued')));
+}
+/** Only ENOENT at every path proves absence; existsSync would also hide access errors. */
+export function workerResourcePathsGone(paths) {
+    return paths.every((path) => {
+        try {
+            lstatSync(path);
+            return false;
+        }
+        catch (error) {
+            return error.code === 'ENOENT';
+        }
+    });
+}
+/** Recorded survivors still block reuse when every persistent path is already gone. */
+export function workerResourceAbsentHolders(record) {
+    return record === 'absent' ||
+        ((!recordedProcessLive(record.controller) || isCurrentProcess(record.controller)) && !record.processes.some(recordedProcessLive)) ? 'safe' : [];
+}
+/** Live PIDs that refuse reuse, or `safe` when the generation is gone. */
+export function workerResourceLiveHolders(probe) {
+    return probe.liveness === 'gone' ? 'safe' : probe.controller !== undefined ? [probe.controller] : probe.pids;
+}
+//# sourceMappingURL=worker-resource-holders.js.map

package/dist/runs/worker-resource-holders.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-resource-holders.js","sourceRoot":"","sources":["../../src/runs/worker-resource-holders.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEpC,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAkD,MAAM,mCAAmC,CAAC;AAK1I,yGAAyG;AACzG,MAAM,UAAU,wBAAwB,CACtC,GAA0B,EAC1B,KAAkC,EAClC,EAAU,EACV,UAAkB,EAClB,UAAkB,EAClB,eAAyB;IAEzB,OAAO,CAAC,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,KAAK,QAAQ,IAAI,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,UAAU,KAAK,EAAE;QACvF,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,UAAU,KAAK,UAAU,IAAI,KAAK,EAAE,UAAU,KAAK,UAAU;QACtF,CAAC,KAAK,CAAC,KAAK,KAAK,UAAU,IAAI,CAAC,CAAC,eAAe,IAAI,KAAK,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC;AACpF,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,uBAAuB,CAAC,KAAwB;IAC9D,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE;QAC1B,IAAI,CAAC;YAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YAAC,OAAO,KAAK,CAAC;QAAC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAAC,OAAQ,KAA+B,CAAC,IAAI,KAAK,QAAQ,CAAC;QAAC,CAAC;IACrH,CAAC,CAAC,CAAC;AACL,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,2BAA2B,CAAC,MAAsC;IAChF,OAAO,MAAM,KAAK,QAAQ;QACxB,CAAC,CAAC,CAAC,mBAAmB,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,gBAAgB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;AACpJ,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,yBAAyB,CAAC,KAAsB;IAC9D,OAAO,KAAK,CAAC,QAAQ,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC;AAC/G,CAAC"}

package/dist/runs/worker-result-commit.d.ts

@@ -0,0 +1,26 @@
+import type { DelegationState, RunRecord, WorkerCollectedResult } from '../contract/index.js';
+import { workerResultFileSchema } from '../contract/index.js';
+type WorkerResultFile = ReturnType<typeof workerResultFileSchema.parse>;
+/** The store methods a worker-result commit needs; no import of `store.ts`. */
+export interface WorkerResultCommitState {
+    redactResult(value: WorkerCollectedResult): WorkerCollectedResult;
+    peek(id: string): RunRecord | undefined;
+    readWorkerResultFile(parentId: string, workerId: string): WorkerResultFile | undefined;
+    readWorkerResult(parentId: string, workerId: string): WorkerCollectedResult | undefined;
+    redactText(text: string): string;
+    workerResultSnapshotPath(parentId: string, workerId: string, snapshotId: string): string;
+    workerResultsDir(parentId: string): string;
+    commitDelegation(patches: ReadonlyArray<{
+        id: string;
+        delegation: DelegationState;
+    }>): void;
+}
+/**
+ * Publish a pointer only after its redacted immutable snapshot reaches disk. Failed index writes retain the old evidence.
+ * A result whose evidence is already stored returns the stored one and writes nothing; `ignoreCleanup` is for a
+ * caller that only needs the payload durable, whatever cleanup phase the stored copy names.
+ */
+export declare function commitStoreWorkerResult(state: WorkerResultCommitState, parentId: string, value: WorkerCollectedResult, diffSnapshot?: string, opts?: {
+    ignoreCleanup?: boolean;
+}): WorkerCollectedResult;
+export {};

package/dist/runs/worker-result-commit.js

@@ -0,0 +1,121 @@
+/**
+ * Publish a worker-result snapshot and its parent pointer. `RunStore.commitWorkerResult` is a
+ * thin call into `commitStoreWorkerResult`; ownership, obsolescence and disk writes stay here.
+ */
+import { randomUUID } from 'node:crypto';
+import { closeSync, constants, existsSync, fsyncSync, openSync, readdirSync, rmSync, renameSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { isDeepStrictEqual } from 'node:util';
+import { workerCollectedResultSchema, workerResultFileSchema } from '../contract/index.js';
+/**
+ * Two collected worker results carry the same evidence: equal but for when they were observed and
+ * which snapshot file holds them, and, with `ignoreCleanup`, the cleanup phase. A retried destroy
+ * that observed nothing new then rewrites and fsyncs nothing (hearsay-tools/cezarion#879).
+ */
+function sameWorkerResult(a, b, opts) {
+    const comparable = (value) => ({ ...value, observedAt: undefined, ...(opts.ignoreCleanup ? { cleanup: undefined } : {}),
+        diff: value.diff.state === 'available' ? { ...value.diff, snapshotId: undefined, path: undefined } : value.diff });
+    return isDeepStrictEqual(comparable(a), comparable(b));
+}
+/**
+ * Publish a pointer only after its redacted immutable snapshot reaches disk. Failed index writes retain the old evidence.
+ * A result whose evidence is already stored returns the stored one and writes nothing; `ignoreCleanup` is for a
+ * caller that only needs the payload durable, whatever cleanup phase the stored copy names.
+ */
+export function commitStoreWorkerResult(state, parentId, value, diffSnapshot, opts = {}) {
+    const result = workerCollectedResultSchema.parse(state.redactResult(value));
+    const parent = state.peek(parentId);
+    const worker = state.peek(result.workerId);
+    assertWorkerResultOwnership(parentId, parent, worker, result);
+    const old = parent.delegation.results?.find((entry) => entry.workerId === result.workerId);
+    const stored = old && state.readWorkerResultFile(parentId, result.workerId);
+    const matched = matchingStoredWorkerResult(stored, result, diffSnapshot, opts, (text) => state.redactText(text));
+    if (matched)
+        return matched;
+    if (workerResultIsObsolete(worker, old, result, () => state.readWorkerResult(parentId, result.workerId))) {
+        throw new Error('worker result is obsolete');
+    }
+    const snapshotId = assignWorkerResultSnapshotPath(result, parentId, (id, workerId, snap) => state.workerResultSnapshotPath(id, workerId, snap), diffSnapshot);
+    const file = workerResultFileSchema.parse({ result, ...(diffSnapshot === undefined ? {} : { diffSnapshot: state.redactText(diffSnapshot) }) });
+    const dir = state.workerResultsDir(parentId);
+    const path = join(dir, `${result.workerId}.${snapshotId}.json`);
+    if (existsSync(path))
+        throw new Error('worker result snapshot identity already exists');
+    writeWorkerResultSnapshot(path, file, parentId, parent, result, snapshotId, old, (patches) => state.commitDelegation(patches));
+    // Keep the latest payload only; bounded previous outcome metadata lives in the pointer.
+    removeStaleWorkerResultSnapshots(dir, result.workerId, snapshotId);
+    return result;
+}
+function assertWorkerResultOwnership(parentId, parent, worker, result) {
+    if (parent?.delegation?.role !== 'root' || result.parentRunId !== parentId ||
+        !parent.delegation.receipts.some((receipt) => receipt.workerId === result.workerId))
+        throw new Error('missing result ownership');
+    if (worker && workerResultRevisionChanged(parentId, worker, result))
+        throw new Error('worker result revision changed');
+}
+function workerResultRevisionChanged(parentId, worker, result) {
+    return worker.delegation?.role !== 'worker' || worker.delegation.parentRunId !== parentId ||
+        worker.delegation.workspace.ownerRunId !== worker.id || (worker.delegation.executionRevision ?? 0) !== result.revision || worker.status !== result.status;
+}
+function matchingStoredWorkerResult(stored, result, diffSnapshot, opts, redactText) {
+    if (stored && sameWorkerResult(stored.result, result, opts) &&
+        stored.diffSnapshot === (diffSnapshot === undefined ? undefined : redactText(diffSnapshot)))
+        return stored.result;
+    return undefined;
+}
+function workerResultIsObsolete(worker, old, result, readStored) {
+    if (!worker && !readStored())
+        return true;
+    if (!old)
+        return false;
+    return old.revision > result.revision || (old.revision === result.revision && old.observedAt > result.observedAt);
+}
+function assignWorkerResultSnapshotPath(result, parentId, snapshotPath, diffSnapshot) {
+    const snapshotId = result.diff.state === 'available' ? result.diff.snapshotId : randomUUID();
+    if (result.diff.state === 'available')
+        result.diff.path = snapshotPath(parentId, result.workerId, snapshotId);
+    if (result.diff.state === 'available' && diffSnapshot === undefined)
+        throw new Error('missing diff snapshot');
+    return snapshotId;
+}
+function workerResultReference(result, snapshotId, old) {
+    return {
+        workerId: result.workerId, revision: result.revision, observedAt: result.observedAt, snapshotId,
+        lastExecutionOutcome: result.lastExecutionOutcome,
+        ...(old ? { previous: old.revision === result.revision ? old.previous : { revision: old.revision, observedAt: old.observedAt, lastExecutionOutcome: old.lastExecutionOutcome } } : {}),
+    };
+}
+function writeWorkerResultSnapshot(path, file, parentId, parent, result, snapshotId, old, commitDelegation) {
+    const temp = `${path}.${randomUUID()}.tmp`;
+    try {
+        const fd = openSync(temp, constants.O_WRONLY | constants.O_CREAT | constants.O_EXCL | constants.O_NOFOLLOW, 0o600);
+        try {
+            writeFileSync(fd, JSON.stringify(file));
+            fsyncSync(fd);
+        }
+        finally {
+            closeSync(fd);
+        }
+        renameSync(temp, path);
+        const reference = workerResultReference(result, snapshotId, old);
+        commitDelegation([{ id: parentId, delegation: { ...parent.delegation,
+                    results: [...(parent.delegation.results ?? []).filter((entry) => entry.workerId !== result.workerId), reference],
+                } }]);
+    }
+    catch (error) {
+        rmSync(temp, { force: true });
+        if (old?.snapshotId !== snapshotId)
+            rmSync(path, { force: true });
+        throw error;
+    }
+}
+function removeStaleWorkerResultSnapshots(dir, workerId, snapshotId) {
+    for (const name of readdirSync(dir))
+        if (name.startsWith(`${workerId}.`) && name !== `${workerId}.${snapshotId}.json`) {
+            try {
+                rmSync(join(dir, name), { force: true });
+            }
+            catch { /* retry on next collection */ }
+        }
+}
+//# sourceMappingURL=worker-result-commit.js.map

package/dist/runs/worker-result-commit.js.map

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

package/dist/self-update/checkouts.d.ts

@@ -0,0 +1,46 @@
+import type { Home } from '../home/home.ts';
+import { runNpm } from './installer.ts';
+export interface CezarCheckout {
+    /** The package root to link: `<worktree>/packages/cezar` (or the worktree itself for the
+     *  single-package layout older branches have). */
+    packageRoot: string;
+    worktree: string;
+    /** Branch name, or the worktree's directory name when HEAD is detached. */
+    branch: string;
+    version: string;
+    built: boolean;
+    /** The id this checkout has (when linked) or would get (when not yet). */
+    id: string;
+    linked: boolean;
+    commit: {
+        sha: string;
+        subject: string;
+        at: string;
+    } | null;
+    builtAt: string | null;
+    /** Built, but HEAD is newer than the build or uncommitted changes require rebuilding. */
+    stale: boolean;
+    /** The cezar task that owns the worktree, from the repo's own run index. */
+    task: {
+        id: string;
+        title: string;
+        status: string;
+    } | null;
+}
+/** The cezar package root inside a checkout, or null when the tree is not cezar's. */
+export declare function cezarPackageRoot(worktree: string): string | null;
+export declare function isBuilt(packageRoot: string): boolean;
+/** The branch a single checkout is on (`link` from a terminal), else its directory name. */
+export declare function branchOf(worktree: string): Promise<string>;
+/**
+ * Every cezar checkout reachable from the project registry (and from existing links, so a repo
+ * that was never registered but was linked once keeps showing its siblings), newest commit
+ * first, each with what it takes to tell it apart: its task, its last commit, its build age.
+ */
+export declare function discoverCheckouts(env: NodeJS.ProcessEnv | undefined, home: Home): Promise<CezarCheckout[]>;
+/**
+ * Build a checkout so it can be linked: `npm install` when its dependencies are missing or out of
+ * date, then the server and cockpit builds. The workspace layout skips the root `build`'s
+ * `check:pack` tarball gate — it proves the release tarball, which a link never uses.
+ */
+export declare function buildCheckout(checkout: Pick<CezarCheckout, 'worktree' | 'packageRoot'>, onLog: (line: string) => void, npm?: typeof runNpm): Promise<void>;

package/dist/self-update/checkouts.js

@@ -0,0 +1,284 @@
+import { projectPaths } from '../project-paths.js';
+/**
+ * Finding cezar's OWN checkouts — the worktrees a developer might want the desktop app (or the
+ * `cezar` launcher) to run instead of a published release. Nothing to configure: every
+ * registered project whose tree holds the `@wjarka/cezarion` package is a cezar repo, and
+ * `git worktree list` in it names every task branch cezar (or the developer) checked out. A
+ * worktree is switchable once it is built (`dist/index.js` and the cockpit's `web/dist`); the
+ * switch itself is `linkCheckout` in layout.ts.
+ */
+import { execFile } from 'node:child_process';
+import { cpSync, existsSync, readFileSync, realpathSync, renameSync, rmSync, statSync } from 'node:fs';
+import { join } from 'node:path';
+import { promisify } from 'node:util';
+import { workspaceConfigPath } from '../paths.js';
+import { loadWorkspaceConfig } from '../workspace/config.js';
+import { findColdRunByCheckout } from '../runs/run-index.js';
+import { projectAdmissionRefusal } from '../server/cockpit-ownership.js';
+import { runNpm } from './installer.js';
+import { linkId, listLinks, PACKAGE_NAME, readManifest, suffixedLinkId } from './layout.js';
+const exec = promisify(execFile);
+function packageVersion(dir) {
+    try {
+        const pkg = JSON.parse(readFileSync(join(dir, 'package.json'), 'utf8'));
+        return pkg.name === PACKAGE_NAME && typeof pkg.version === 'string' ? pkg.version : null;
+    }
+    catch {
+        return null;
+    }
+}
+/** The cezar package root inside a checkout, or null when the tree is not cezar's. */
+export function cezarPackageRoot(worktree) {
+    for (const dir of [join(worktree, 'packages', 'cezar'), worktree]) {
+        if (packageVersion(dir))
+            return dir;
+    }
+    return null;
+}
+export function isBuilt(packageRoot) {
+    return existsSync(join(packageRoot, 'dist', 'index.js')) && existsSync(join(packageRoot, 'web', 'dist', 'index.html'));
+}
+/** When the server build was last written — the older of the two halves would be more honest,
+ *  but `npm run build` writes both in one go and the server is what a restart picks up. */
+function builtAtOf(packageRoot) {
+    try {
+        return statSync(join(packageRoot, 'dist', 'index.js')).mtime.toISOString();
+    }
+    catch {
+        return null;
+    }
+}
+/** HEAD's sha, subject and commit time. Null when git cannot answer. */
+async function lastCommit(worktree) {
+    try {
+        const { stdout } = await exec('git', ['log', '-1', '--format=%h%x1f%cI%x1f%s'], { cwd: worktree, timeout: 5_000 });
+        const [sha, at, subject] = stdout.trim().split('\x1f');
+        return sha && at ? { sha, subject: subject ?? '', at: new Date(at).toISOString() } : null;
+    }
+    catch {
+        return null;
+    }
+}
+/** A dirty tree cannot prove its build matches its sources. Include staged, deleted and
+ *  untracked files; ignored build output does not count. A git failure also requires a rebuild. */
+async function hasUncommittedChanges(worktree) {
+    try {
+        const { stdout } = await exec('git', ['status', '--porcelain', '--untracked-files=normal'], {
+            cwd: worktree, timeout: 5_000, maxBuffer: 4 * 1024 * 1024,
+        });
+        return stdout.trim().length > 0;
+    }
+    catch {
+        return true;
+    }
+}
+/** `git worktree list --porcelain` → [path, branch]. Never throws: not a repo is no worktrees. */
+async function worktreesOf(root) {
+    try {
+        const { stdout } = await exec('git', ['worktree', 'list', '--porcelain'], { cwd: root, timeout: 5_000, maxBuffer: 4 * 1024 * 1024 });
+        const out = [];
+        for (const block of stdout.split(/\n\n+/)) {
+            const path = /^worktree (.+)$/m.exec(block)?.[1];
+            if (!path || /^prunable/m.test(block))
+                continue;
+            const ref = /^branch (.+)$/m.exec(block)?.[1];
+            out.push({ path, branch: ref ? ref.replace(/^refs\/heads\//, '') : null });
+        }
+        return out;
+    }
+    catch {
+        return [];
+    }
+}
+function real(path) {
+    try {
+        return realpathSync(path);
+    }
+    catch {
+        return path;
+    }
+}
+/** The branch a single checkout is on (`link` from a terminal), else its directory name. */
+export async function branchOf(worktree) {
+    try {
+        const { stdout } = await exec('git', ['symbolic-ref', '--short', '-q', 'HEAD'], { cwd: worktree, timeout: 5_000 });
+        if (stdout.trim())
+            return stdout.trim();
+    }
+    catch {
+        // detached HEAD, or not a repo
+    }
+    return worktree.split(/[\\/]/).filter(Boolean).pop() ?? 'checkout';
+}
+/** The main checkout's data directory, which names task worktrees. A project under a migration
+ *  fence is not read: its checkouts show without their tasks. */
+function taskDataDir(trees) {
+    const dataDir = trees.length > 0 ? projectPaths(trees[0].path).write : null;
+    return dataDir && !projectAdmissionRefusal(dataDir) ? dataDir : null;
+}
+/** `root`'s worktrees, listed again after its unfinished migration finishes: the migration moves
+ *  and repairs task worktrees, so a list taken before it names their old paths. The new list
+ *  comes from the main checkout, which no migration moves: `root` may be a task checkout that
+ *  the recovery just moved away. */
+async function recoveredWorktreesOf(root) {
+    const trees = await worktreesOf(root);
+    const main = trees[0]?.path;
+    if (!main || projectAdmissionRefusal(projectPaths(main).write)?.reason !== 'journal')
+        return trees;
+    const recovered = await (await import('../project-migration/recovery.js')).recoverProjectMigration(main).catch(() => undefined);
+    return recovered ? worktreesOf(main) : trees;
+}
+/**
+ * Every cezar checkout reachable from the project registry (and from existing links, so a repo
+ * that was never registered but was linked once keeps showing its siblings), newest commit
+ * first, each with what it takes to tell it apart: its task, its last commit, its build age.
+ */
+export async function discoverCheckouts(env = process.env, home) {
+    const config = await loadWorkspaceConfig(workspaceConfigPath(env, home));
+    const links = listLinks(env, home);
+    const roots = [...config.projects.map((project) => project.root), ...links.map((link) => link.checkout).filter((p) => !!p)];
+    const seen = new Set();
+    const found = [];
+    for (const root of roots) {
+        if (!existsSync(root) || !cezarPackageRoot(root))
+            continue;
+        const trees = await recoveredWorktreesOf(root);
+        // Task worktrees live under the main checkout, whose run store names them.
+        const dataDir = taskDataDir(trees);
+        for (const tree of trees) {
+            const worktree = real(tree.path);
+            if (seen.has(worktree))
+                continue;
+            seen.add(worktree);
+            const packageRoot = cezarPackageRoot(worktree);
+            const version = packageRoot ? packageVersion(packageRoot) : null;
+            if (!packageRoot || !version)
+                continue;
+            const branch = tree.branch ?? worktree.split(/[\\/]/).filter(Boolean).pop() ?? 'checkout';
+            const link = links.find((entry) => entry.checkout === packageRoot);
+            const task = dataDir ? findColdRunByCheckout(dataDir, { worktreePaths: [...new Set([tree.path, worktree])], branch: tree.branch }) : undefined;
+            const built = isBuilt(packageRoot);
+            found.push({
+                packageRoot,
+                worktree,
+                branch,
+                version,
+                built,
+                builtAt: built ? builtAtOf(packageRoot) : null,
+                stale: false,
+                task: task ? { id: task.id, title: task.titleSummary ?? task.title, status: task.status } : null,
+                id: link?.id ?? '',
+                linked: !!link,
+            });
+        }
+    }
+    assignUniqueIds(found, links, env, home);
+    const out = await Promise.all(found.map(async (checkout) => {
+        const [commit, dirty] = await Promise.all([
+            lastCommit(checkout.worktree),
+            checkout.built ? hasUncommittedChanges(checkout.worktree) : false,
+        ]);
+        const stale = checkout.built && (dirty || !!(checkout.builtAt && commit && commit.at > checkout.builtAt));
+        return { ...checkout, commit, stale };
+    }));
+    // Newest work first: that is the branch a developer is most likely reaching for.
+    return out.sort((a, b) => (b.commit?.at ?? '').localeCompare(a.commit?.at ?? ''));
+}
+/**
+ * Give every unlinked checkout an id no other checkout or install answers to: `apply` resolves a
+ * target by id, so two clones on `main` (or `cez/foo` beside `cez-foo`) sharing
+ * `<version>+main` would let a pick of one build and run the other. Links keep theirs; the
+ * first unlinked checkout on a slug keeps the plain id, later ones get `linkCheckout`'s
+ * path-hash suffix — which `linkDiscovered` then passes back so the link lands under it.
+ */
+function assignUniqueIds(found, links, env, home) {
+    const owner = new Map();
+    for (const link of links)
+        owner.set(link.id, link.checkout ?? '');
+    for (const checkout of found) {
+        if (checkout.linked)
+            continue;
+        const base = safeLinkId(checkout.version, checkout.branch);
+        if (!base)
+            continue;
+        // Taken by another checkout, or by any install on disk (`+local` builds included).
+        const taken = owner.get(base) ?? (readManifest(base, env, home) ? '' : undefined);
+        checkout.id = taken === undefined || taken === checkout.packageRoot ? base : safeSuffixed(base, checkout.packageRoot);
+        if (checkout.id)
+            owner.set(checkout.id, checkout.packageRoot);
+    }
+}
+function safeSuffixed(base, packageRoot) {
+    try {
+        return suffixedLinkId(base, packageRoot);
+    }
+    catch {
+        return '';
+    }
+}
+function safeLinkId(version, branch) {
+    try {
+        return linkId(version, branch);
+    }
+    catch {
+        return '';
+    }
+}
+/** `npm install` is due when the checkout has never installed, or its lockfile changed since. */
+function needsInstall(worktree) {
+    try {
+        const installed = statSync(join(worktree, 'node_modules', '.package-lock.json')).mtimeMs;
+        return statSync(join(worktree, 'package-lock.json')).mtimeMs > installed;
+    }
+    catch {
+        return !existsSync(join(worktree, 'node_modules'));
+    }
+}
+/**
+ * Build a checkout so it can be linked: `npm install` when its dependencies are missing or out of
+ * date, then the server and cockpit builds. The workspace layout skips the root `build`'s
+ * `check:pack` tarball gate — it proves the release tarball, which a link never uses.
+ */
+export async function buildCheckout(checkout, onLog, npm = runNpm) {
+    const { worktree, packageRoot } = checkout;
+    if (needsInstall(worktree)) {
+        onLog(`npm install in ${worktree}`);
+        await npm(['install', '--no-audit', '--no-fund'], worktree, onLog);
+    }
+    const scripts = (() => {
+        try {
+            return JSON.parse(readFileSync(join(worktree, 'package.json'), 'utf8')).scripts ?? {};
+        }
+        catch {
+            return {};
+        }
+    })();
+    const steps = packageRoot !== worktree && scripts['build:server'] && scripts['build:web'] ? ['build:server', 'build:web'] : ['build'];
+    // A rebuild of the worktree cezar is running from empties the `web/dist` it serves (vite's
+    // `emptyOutDir`): keep a copy, so a build that fails leaves the old cockpit, not none.
+    const webDist = join(packageRoot, 'web', 'dist');
+    const backup = join(packageRoot, 'web', '.dist-before-build');
+    rmSync(backup, { recursive: true, force: true });
+    if (existsSync(join(webDist, 'index.html')))
+        cpSync(webDist, backup, { recursive: true });
+    try {
+        for (const step of steps) {
+            onLog(`npm run ${step} in ${worktree}`);
+            await npm(['run', step], worktree, onLog);
+        }
+        if (!isBuilt(packageRoot))
+            throw new Error(`${worktree} built, but dist/index.js or web/dist is still missing`);
+    }
+    catch (error) {
+        if (existsSync(backup) && !existsSync(join(webDist, 'index.html'))) {
+            rmSync(webDist, { recursive: true, force: true });
+            renameSync(backup, webDist);
+            onLog('the build failed — restored the previous cockpit build');
+        }
+        throw error;
+    }
+    finally {
+        rmSync(backup, { recursive: true, force: true });
+    }
+}
+//# sourceMappingURL=checkouts.js.map

package/dist/self-update/checkouts.js.map

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

package/dist/self-update/cli.d.ts

@@ -0,0 +1,19 @@
+import type { Home } from '../home/home.ts';
+import { SelfUpdateService } from './service.ts';
+export interface SelfUpdateCliOptions {
+    service: SelfUpdateService;
+    home: Home;
+    channel?: string;
+    version?: string;
+    modifyPath: boolean;
+    /** `link --use`: activate the linked checkout right away. */
+    use?: boolean;
+}
+/** Run `argv[0]` when it names a managed-install command and answer its exit code; anything else
+ *  is not ours. Runs before the global parseArgs: these flags are not cockpit flags. */
+export declare function runManagedCommand(argv: string[], identity: {
+    pkgName: string;
+    version: string;
+    entry: string;
+}, getHome: () => Home): Promise<number | undefined>;
+export declare function runSelfUpdateCommand(command: string, args: string[], opts: SelfUpdateCliOptions): Promise<number>;