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

package/dist/process-wait/supervisor.d.ts

@@ -0,0 +1,30 @@
+import type { ProcessWaitResult } from '../contract/index.js';
+import { type ExitFileRoots } from './exit-file.ts';
+/**
+ * Watches a background command for a process wait (hearsay-tools/cezarion#1446). Shaped like
+ * `CiWatcherSupervisor`: `watch` settles once with the first outcome, and an aborted watch never
+ * settles. Node has no pidfd and the command is not Cezar's child, so it polls: the exit file
+ * first (a finished command's code wins even if its PID was since reused), then the process
+ * incarnation, then the deadline.
+ */
+export declare const PROCESS_POLL_MS = 5000;
+export type ProcessWatchRequest = {
+    pid: number;
+    startToken?: string | undefined;
+    exitFile?: string;
+    deadline: string;
+    roots: ExitFileRoots;
+};
+/** One check, or undefined while the process still runs before its deadline. Never throws. */
+export declare function probeProcessWait(request: ProcessWatchRequest, now: number): ProcessWaitResult | undefined;
+export declare class ProcessWaitSupervisor {
+    private readonly pollMs;
+    private readonly now;
+    private readonly watches;
+    constructor(options?: {
+        pollMs?: number;
+        now?: () => number;
+    });
+    watch(request: ProcessWatchRequest, signal: AbortSignal): Promise<ProcessWaitResult>;
+    close(): void;
+}

package/dist/process-wait/supervisor.js

@@ -0,0 +1,71 @@
+import { recordedProcessLive } from '../delegation/process-liveness.js';
+import { readExitCode } from './exit-file.js';
+/**
+ * Watches a background command for a process wait (hearsay-tools/cezarion#1446). Shaped like
+ * `CiWatcherSupervisor`: `watch` settles once with the first outcome, and an aborted watch never
+ * settles. Node has no pidfd and the command is not Cezar's child, so it polls: the exit file
+ * first (a finished command's code wins even if its PID was since reused), then the process
+ * incarnation, then the deadline.
+ */
+export const PROCESS_POLL_MS = 5_000;
+const DIAGNOSTIC_MAX = 512;
+/** One check, or undefined while the process still runs before its deadline. Never throws. */
+export function probeProcessWait(request, now) {
+    const observedAt = new Date(now).toISOString();
+    try {
+        if (request.exitFile !== undefined) {
+            const read = readExitCode(request.exitFile, request.roots);
+            if (read.present)
+                return { outcome: 'exit_file', observedAt, ...(read.exitCode === undefined ? { exitFileNote: 'not-an-exit-code' } : { exitCode: read.exitCode }) };
+        }
+        if (!recordedProcessLive({ pid: request.pid, ...(request.startToken === undefined ? {} : { startToken: request.startToken }) }))
+            return { outcome: 'exited', observedAt };
+        if (now >= Date.parse(request.deadline))
+            return { outcome: 'deadline', observedAt };
+        return undefined;
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return { outcome: 'error', observedAt, diagnostic: message.slice(0, DIAGNOSTIC_MAX) };
+    }
+}
+export class ProcessWaitSupervisor {
+    pollMs;
+    now;
+    watches = new Set();
+    constructor(options = {}) {
+        this.pollMs = options.pollMs ?? PROCESS_POLL_MS;
+        this.now = options.now ?? Date.now;
+    }
+    watch(request, signal) {
+        return new Promise(resolve => {
+            const local = new AbortController();
+            this.watches.add(local);
+            const stopped = AbortSignal.any([signal, local.signal]);
+            let timer;
+            const stop = () => { clearTimeout(timer); this.watches.delete(local); };
+            stopped.addEventListener('abort', stop, { once: true });
+            const tick = () => {
+                if (stopped.aborted)
+                    return;
+                const now = this.now();
+                const result = probeProcessWait(request, now);
+                if (result) {
+                    stop();
+                    resolve(result);
+                    return;
+                }
+                // The deadline is honoured on time, not up to one poll late.
+                timer = setTimeout(tick, Math.max(0, Math.min(this.pollMs, Date.parse(request.deadline) - now)));
+                timer.unref?.();
+            };
+            tick();
+        });
+    }
+    close() {
+        for (const watch of this.watches)
+            watch.abort();
+        this.watches.clear();
+    }
+}
+//# sourceMappingURL=supervisor.js.map

package/dist/process-wait/supervisor.js.map

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

package/dist/project-commands.d.ts

@@ -0,0 +1,14 @@
+import { RunStore } from './runs/store.ts';
+/**
+ * CLI commands that write a project's data directory, kept apart from `index.ts` (which runs the
+ * CLI on import) so tests can drive them. Each re-checks the migration fence right before its
+ * first project write.
+ */
+/** `cez init`: scaffold the starter workflow and skill. */
+export declare function initCommand(repoRoot: string): Promise<void>;
+/** The project's run store, at the start of a process: a busy database is waited out
+ *  (`retryBusy`), and a store that cannot open throws its `RunStoreOpenError`. */
+export declare function openStore(repoRoot: string, opts?: {
+    keepLive?: boolean;
+    repoHandleSignal?: AbortSignal;
+}): RunStore;

package/dist/project-commands.js

@@ -0,0 +1,91 @@
+import { markFreshProject } from './project-migration/fresh.js';
+import { noticeLegacyProject, projectPaths } from './project-paths.js';
+import { fallbackWorkflowPath } from './workflows/load.js';
+import { fallbackSkillPath } from './skills.js';
+import { commandText } from './home/command.js';
+import { existsSync, mkdirSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { armRepoHandle } from './runs/arm-repo-handle.js';
+import { RunStore } from './runs/store.js';
+import { ensureDataGitignore } from './data-gitignore.js';
+import { admittedWrite } from './server/cockpit-ownership.js';
+/**
+ * CLI commands that write a project's data directory, kept apart from `index.ts` (which runs the
+ * CLI on import) so tests can drive them. Each re-checks the migration fence right before its
+ * first project write.
+ */
+/** `cez init`: scaffold the starter workflow and skill. */
+export async function initCommand(repoRoot) {
+    const workflowsDir = join(projectPaths(repoRoot).write, 'workflows');
+    const skillsDir = join(projectPaths(repoRoot).write, 'skills');
+    const dataDir = projectPaths(repoRoot).write;
+    admittedWrite(dataDir, () => { markFreshProject(repoRoot); mkdirSync(workflowsDir, { recursive: true }); mkdirSync(skillsDir, { recursive: true }); });
+    const examples = [
+        {
+            path: join(workflowsDir, 'fix-and-verify.yaml'),
+            fallback: () => fallbackWorkflowPath(repoRoot, 'fix-and-verify'),
+            content: `name: fix-and-verify
+description: Implement the task, then run your test command; on failure the agent retries with the failing output.
+steps:
+  - id: implement
+    name: Implement
+    prompt: "{{task}}"
+  - id: verify
+    name: Verify
+    command: "echo 'replace me with: npm test / yarn test / pytest'"
+    onFail:
+      retry: implement
+      max: 2
+`,
+        },
+        {
+            path: join(skillsDir, 'project-conventions.md'),
+            fallback: () => fallbackSkillPath(repoRoot, 'project-conventions'),
+            content: `---
+name: project-conventions
+description: House rules the agent should follow in this repo.
+---
+
+# Project conventions
+
+- Describe your stack, style and testing conventions here.
+- Reference this skill from a workflow step via \`skill: project-conventions\`.
+`,
+        },
+    ];
+    for (const example of examples) {
+        // A starter with the same name under .ai/squawk/ is the user's: a legacy copy would hide it.
+        const fallback = existsSync(example.path) ? undefined : await example.fallback();
+        if (existsSync(example.path)) {
+            console.log(`  = ${example.path} (exists, left untouched)`);
+        }
+        else if (fallback) {
+            console.log(`  = ${fallback} (exists, left untouched)`);
+        }
+        else {
+            // The fallback lookup awaited: a fence may have been taken since the last check.
+            admittedWrite(dataDir, () => writeFileSync(example.path, example.content, 'utf8'));
+            console.log(`  + ${example.path}`);
+        }
+    }
+    admittedWrite(dataDir, () => ensureDataGitignore(repoRoot));
+    console.log(commandText('\nDone. Start the cockpit with: npx cezarion'));
+}
+/** The project's run store, at the start of a process: a busy database is waited out
+ *  (`retryBusy`), and a store that cannot open throws its `RunStoreOpenError`. */
+export function openStore(repoRoot, opts) {
+    noticeLegacyProject(repoRoot);
+    const dataDir = projectPaths(repoRoot).write;
+    // First: an open that fails may already have created the database and the history backups.
+    // No await between the check and the open; later store writes pass the store's own backstop.
+    const store = admittedWrite(dataDir, () => {
+        markFreshProject(repoRoot);
+        ensureDataGitignore(repoRoot);
+        return RunStore.open(dataDir, { keepLive: opts?.keepLive, retryBusy: true });
+    });
+    // Repo-scope the referenced tier (#945) — see `armRepoHandle`. Background, never awaited: a
+    // `gh`-less or offline machine keeps working exactly as it did, just unscoped.
+    armRepoHandle(store, repoRoot, opts?.repoHandleSignal);
+    return store;
+}
+//# sourceMappingURL=project-commands.js.map

package/dist/project-commands.js.map

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

package/dist/project-migration/answer.d.ts

@@ -0,0 +1,23 @@
+import type { ProjectMigrationResult } from './engine.ts';
+/** What `migrate-project` reports. */
+export interface ProjectMigrationAnswer {
+    dryRun: boolean;
+    /** Whether the plan has blockers or conflicts. */
+    blocked: boolean;
+    /** Whether an unfinished migration journal was finished first. */
+    resumed: boolean;
+    /** What a journal finished first moved and rewrote, when one was; a dry run reports it too. */
+    recovered?: string;
+    /** The plan as printed (`describeProjectMigrationPlan`). */
+    report: string;
+    /** `git mv` commands for the tracked files the migration leaves in place, for the user to run. */
+    gitMv: string[];
+    /** The project was already moved: nothing changed. */
+    alreadyMoved: boolean;
+}
+/** A dry run: the engine's whole plan, after any unfinished journal it had to finish first. */
+export declare function dryRunAnswer(repoRoot: string, recovered: ProjectMigrationResult | undefined): Promise<ProjectMigrationAnswer>;
+/** A finished migration (its journal removed): what it moved, repaired and rewrote. */
+export declare function migrationAnswer(result: ProjectMigrationResult): ProjectMigrationAnswer;
+/** The answer as the CLI prints it: what a finished journal did, the report, then what happened. */
+export declare function migrationAnswerText(answer: ProjectMigrationAnswer): string;

package/dist/project-migration/answer.js

@@ -0,0 +1,37 @@
+import { describeProjectMigrationPlan, gitMvCommands, NOT_REWRITTEN, planProjectMigration } from './plan.js';
+/** A finished journal as the plan text: what it moved, repaired and rewrote. */
+function journalReport(result) {
+    const { journal } = result;
+    return describeProjectMigrationPlan({
+        ...journal, journal: '', conflicts: [], blockers: [], gitMv: gitMvCommands(journal.repoRoot, journal.tracked), notRewritten: NOT_REWRITTEN,
+        alreadyMoved: result.alreadyMoved,
+    });
+}
+/** A dry run: the engine's whole plan, after any unfinished journal it had to finish first. */
+export async function dryRunAnswer(repoRoot, recovered) {
+    const plan = await planProjectMigration(repoRoot);
+    return { dryRun: true, blocked: plan.blockers.length > 0 || plan.conflicts.length > 0, resumed: recovered !== undefined, ...(recovered ? { recovered: journalReport(recovered) } : {}),
+        report: describeProjectMigrationPlan(plan), gitMv: plan.gitMv, alreadyMoved: plan.alreadyMoved };
+}
+/** A finished migration (its journal removed): what it moved, repaired and rewrote. */
+export function migrationAnswer(result) {
+    return { dryRun: false, blocked: false, resumed: result.resumed, report: journalReport(result), gitMv: result.gitMv, alreadyMoved: result.alreadyMoved };
+}
+/** The answer as the CLI prints it: what a finished journal did, the report, then what happened. */
+export function migrationAnswerText(answer) {
+    const lines = answer.recovered
+        ? ['An interrupted migration was found and completed first. It did this:', answer.recovered, 'The dry run of what remains:']
+        : [];
+    lines.push(answer.report);
+    if (answer.resumed && !answer.recovered)
+        lines.push('An unfinished migration was finished first.');
+    const next = answer.gitMv.length ? ' Run the git mv commands above and commit them.' : '';
+    if (answer.alreadyMoved && !answer.dryRun)
+        lines.push(`The project was already moved; nothing changed.${next}`);
+    else if (answer.dryRun)
+        lines.push(answer.recovered ? 'Dry run: planning changed nothing; the completed migration above did.' : 'Dry run: nothing was moved or rewritten.');
+    else
+        lines.push(`Migration complete.${next}`);
+    return lines.join('\n');
+}
+//# sourceMappingURL=answer.js.map

package/dist/project-migration/answer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"answer.js","sourceRoot":"","sources":["../../src/project-migration/answer.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,4BAA4B,EAAE,aAAa,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAmB7G,gFAAgF;AAChF,SAAS,aAAa,CAAC,MAA8B;IACnD,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC;IAC3B,OAAO,4BAA4B,CAAC;QAClC,GAAG,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,aAAa,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,OAAO,CAAC,EAAE,YAAY,EAAE,aAAa;QAC1I,YAAY,EAAE,MAAM,CAAC,YAAY;KAClC,CAAC,CAAC;AACL,CAAC;AAED,+FAA+F;AAC/F,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,QAAgB,EAAE,SAA6C;IAChG,MAAM,IAAI,GAAG,MAAM,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IAClD,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,OAAO,EAAE,SAAS,KAAK,SAAS,EAAE,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,aAAa,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACpL,MAAM,EAAE,4BAA4B,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,CAAC;AACrG,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,eAAe,CAAC,MAA8B;IAC5D,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,YAAY,EAAE,MAAM,CAAC,YAAY,EAAE,CAAC;AAC3J,CAAC;AAED,oGAAoG;AACpG,MAAM,UAAU,mBAAmB,CAAC,MAA8B;IAChE,MAAM,KAAK,GAAG,MAAM,CAAC,SAAS;QAC5B,CAAC,CAAC,CAAC,sEAAsE,EAAE,MAAM,CAAC,SAAS,EAAE,8BAA8B,CAAC;QAC5H,CAAC,CAAC,EAAE,CAAC;IACP,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC1B,IAAI,MAAM,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAC;IACnG,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,iDAAiD,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1F,IAAI,MAAM,CAAC,YAAY,IAAI,CAAC,MAAM,CAAC,MAAM;QAAE,KAAK,CAAC,IAAI,CAAC,kDAAkD,IAAI,EAAE,CAAC,CAAC;SAC3G,IAAI,MAAM,CAAC,MAAM;QAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,uEAAuE,CAAC,CAAC,CAAC,0CAA0C,CAAC,CAAC;;QACvK,KAAK,CAAC,IAAI,CAAC,sBAAsB,IAAI,EAAE,CAAC,CAAC;IAC9C,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/project-migration/auto.d.ts

@@ -0,0 +1,73 @@
+import type { Home } from '../home/home.ts';
+import { CockpitOwnership } from '../server/cockpit-ownership.ts';
+import type { ArchiveOnMergeDeps } from '../server/archive-on-merge.ts';
+import type { MigrationFault } from './steps.ts';
+/**
+ * The cockpit's automatic project move (hearsay-tools/cezarion#3089), only with `REBRAND_SWITCH`:
+ * at cockpit start for the boot project and, right after the listener starts, every other registered
+ * project (or earlier, when a request reaches it first), and a project added later when it is added;
+ * after journal recovery and before any ordinary read or task start. It moves the legacy state under
+ * `.ai/cezar/` with the same offline move as `migrate-project` when nothing else is live and the
+ * plan has no blocker or conflict. When anything else is live (another cockpit, a task from before
+ * the restart, a headless run, an automation lease of this cockpit) or the plan has a blocker or
+ * conflict, it does not move: the project is served from both folders as before, a notice names what blocks the
+ * move, and the next start tries again. One attempt per project per cockpit run (its ownership).
+ * Tracked files are never moved: the notice of a finished move lists their `git mv` commands. A
+ * move that fails after its journal exists leaves the project to the recovery path.
+ */
+export type AutomaticMove = {
+    status: 'off' | 'nothing';
+} | {
+    status: 'moved';
+    gitMv: string[];
+} | {
+    status: 'blocked';
+    reason: string;
+};
+/**
+ * Move `root`'s legacy state when nothing else is live; see the module comment. `ownership` is the
+ * caller's claim (kept afterwards); without one a temporary claim is taken and released. One
+ * attempt per project per cockpit run: a later or concurrent call gets that attempt's promise.
+ */
+export declare function moveProjectWhenIdle(root: string, options: {
+    ownership?: CockpitOwnership | undefined;
+    homes: readonly Home[];
+    rebrand?: boolean;
+    self?: number;
+    fault?: MigrationFault;
+    log?: (line: string) => void;
+}): Promise<AutomaticMove>;
+/**
+ * The prepare step of a project for a cockpit: journal recovery, then the automatic move. Every
+ * cockpit path that touches a project before or without its context runs it first: the context
+ * build, the post-listen preparation of every registered project, the archive and completion
+ * ticks and the cold run index. Concurrent callers share the recovery and the move attempt.
+ */
+export declare function prepareProject(root: string, options: {
+    ownership?: CockpitOwnership | undefined;
+    homes: readonly Home[];
+    rebrand?: boolean | undefined;
+    keep?: boolean;
+}): Promise<void>;
+/** Prepare `projects` one after another; a project whose recovery fails or whose move fails after
+ *  its journal exists is logged and stays refused by admission, and never stops the others. Once
+ *  `stopped` answers true (the cockpit is closing), no further project is prepared. */
+export declare function prepareProjects<T extends {
+    root: string;
+    status?: string;
+}>(projects: T[], options: {
+    ownership?: CockpitOwnership | undefined;
+    homes: readonly Home[];
+    rebrand?: boolean | undefined;
+    stopped?: () => boolean;
+}): Promise<T[]>;
+/** The archive and completion ticks: each tick's project list is prepared first, before the
+ *  tick's admission check and its maintenance store. */
+export declare function prepareBeforeTicks(options: Parameters<typeof prepareProjects>[1], deps: ArchiveOnMergeDeps): ArchiveOnMergeDeps;
+/** Whether a cockpit server is closing: set when its `close` is called and by `stop`, before anything closes. */
+export declare function closingSignal(server: {
+    close: (...args: never[]) => unknown;
+}): {
+    stopped: () => boolean;
+    stop: () => void;
+};

package/dist/project-migration/auto.js

@@ -0,0 +1,161 @@
+import { readdirSync } from 'node:fs';
+import { productIdentity } from '../home/identity.js';
+import { markFreshProject } from './fresh.js';
+import { REBRAND_SWITCH } from '../home/switch.js';
+import { noticeLegacyProject, pathPresent, projectMoveMarked, projectPaths } from '../project-paths.js';
+import { CockpitOwnership, migrationFencePaths } from '../server/cockpit-ownership.js';
+import { projectCockpits, projectLiveTasksOffline } from './live.js';
+import { moveUnderFence } from './offline.js';
+import { planProjectMigration } from './plan.js';
+import { ProjectMigrationRecoveryError, recoverProjectMigration } from './recovery.js';
+import { automationLeaseHeld } from '../automations/store.js';
+/** Each cockpit run's (its ownership's) attempt per project: no retry loop inside one run, and a
+ *  caller that comes while the attempt runs waits on it instead of reading the project first. */
+const attempts = new WeakMap();
+/** Whether `.ai/cezar/` holds anything a move would carry: entries besides the `cockpit.lock*` claims. */
+function legacyStatePresent(root) {
+    const legacy = projectPaths(root).write;
+    if (!pathPresent(legacy))
+        return false;
+    try {
+        return readdirSync(legacy).some(name => !name.startsWith('cockpit.lock'));
+    }
+    catch {
+        return false;
+    }
+}
+/** Why the move does not run now, or undefined when nothing else is live. The caller's own process never counts. */
+async function blocker(root, homes, self) {
+    const cockpits = await projectCockpits(root, homes, self);
+    const tasks = projectLiveTasksOffline(root);
+    const reasons = [
+        // A lease this process holds would be renamed from under its holder (a schedule fire opening the project).
+        ...(automationLeaseHeld(projectPaths(root).write) ? ['an automation of this cockpit holds its lease'] : []),
+        ...cockpits.map(cockpit => `cockpit pid ${cockpit.pid}${cockpit.url ? ` at ${cockpit.url}` : cockpit.port ? ` on port ${cockpit.port}` : ''} serves it`),
+        ...tasks.map(task => `task ${task.id} ${task.title} is live (${task.state})`),
+    ];
+    return reasons.length > 0 ? reasons.join('; ') : undefined;
+}
+/** 'nothing' when there is nothing to move, a reason when the move must wait, or undefined to go ahead. */
+async function precheck(root, homes, self) {
+    try {
+        const plan = await planProjectMigration(root);
+        const refusals = [...plan.blockers, ...plan.conflicts.map(conflict => `${conflict.path}: ${conflict.reason}`)];
+        if (refusals.length > 0)
+            return { reason: refusals.join('; ') };
+        if (plan.moves.length === 0)
+            return 'nothing';
+        const live = await blocker(root, homes, self);
+        return live ? { reason: live } : undefined;
+    }
+    catch (error) {
+        return { reason: error instanceof Error ? error.message : String(error) };
+    }
+}
+/**
+ * The move under `ownership`'s fence. Any failure before the journal exists (a refusal, a race, a
+ * file system error claiming the fence) is a reason to wait: nothing moved, the project is served
+ * as before. Only a failure after the journal exists closes the project through recovery.
+ */
+async function move(root, ownership, fault) {
+    try {
+        return { gitMv: (await moveUnderFence(root, ownership, fault)).gitMv };
+    }
+    catch (error) {
+        const journal = migrationFencePaths(projectPaths(root).write)?.journal;
+        if (journal && pathPresent(journal))
+            throw new ProjectMigrationRecoveryError(journal, root, error);
+        return { reason: error instanceof Error ? error.message : String(error) };
+    }
+}
+/** What a later caller of an attempt that already ran sees: nothing left for it to move. */
+function nothingLeft() {
+    return { status: 'nothing' };
+}
+/**
+ * Move `root`'s legacy state when nothing else is live; see the module comment. `ownership` is the
+ * caller's claim (kept afterwards); without one a temporary claim is taken and released. One
+ * attempt per project per cockpit run: a later or concurrent call gets that attempt's promise.
+ */
+export function moveProjectWhenIdle(root, options) {
+    if (!(options.rebrand ?? REBRAND_SWITCH))
+        return Promise.resolve({ status: 'off' });
+    if (!options.ownership)
+        return attempt(root, options);
+    const runs = attempts.get(options.ownership) ?? new Map();
+    attempts.set(options.ownership, runs);
+    const pending = runs.get(root);
+    // A later caller waits for the attempt; its failure was the first caller's (recovery handles a journal it left).
+    if (pending)
+        return pending.then(nothingLeft, nothingLeft);
+    const started = attempt(root, options);
+    runs.set(root, started);
+    return started;
+}
+async function attempt(root, options) {
+    markFreshProject(root, options.rebrand ?? REBRAND_SWITCH);
+    // A completed move marked the project (hearsay-tools/cezarion#3150): `.ai/cezar/` is its fallback now.
+    if (projectMoveMarked(root) || !legacyStatePresent(root))
+        return { status: 'nothing' };
+    const log = options.log ?? ((line) => console.warn(line));
+    const blocked = (reason) => {
+        noticeLegacyProject(root, { releaseEnabled: options.rebrand ?? REBRAND_SWITCH, reason, warn: log });
+        return { status: 'blocked', reason };
+    };
+    const check = await precheck(root, options.homes, options.self ?? process.pid);
+    if (check === 'nothing')
+        return { status: 'nothing' };
+    if (check)
+        return blocked(check.reason);
+    const ownership = options.ownership ?? new CockpitOwnership();
+    try {
+        const result = await move(root, ownership, options.fault);
+        if ('reason' in result)
+            return blocked(result.reason);
+        log(`[${productIdentity(options.rebrand ?? REBRAND_SWITCH).command}] Moved the state of ${root} from .ai/cezar/ to .ai/squawk/.${result.gitMv.length
+            ? ` Tracked files stay; run these and commit:\n${result.gitMv.map(line => `  ${line}`).join('\n')}` : ''}`);
+        return { status: 'moved', gitMv: result.gitMv };
+    }
+    finally {
+        if (!options.ownership)
+            ownership.releaseAll();
+    }
+}
+/**
+ * The prepare step of a project for a cockpit: journal recovery, then the automatic move. Every
+ * cockpit path that touches a project before or without its context runs it first: the context
+ * build, the post-listen preparation of every registered project, the archive and completion
+ * ticks and the cold run index. Concurrent callers share the recovery and the move attempt.
+ */
+export async function prepareProject(root, options) {
+    await recoverProjectMigration(root, { ownership: options.ownership, keep: options.keep ?? false });
+    await moveProjectWhenIdle(root, { ownership: options.ownership, homes: options.homes, ...(options.rebrand === undefined ? {} : { rebrand: options.rebrand }) });
+}
+/** Prepare `projects` one after another; a project whose recovery fails or whose move fails after
+ *  its journal exists is logged and stays refused by admission, and never stops the others. Once
+ *  `stopped` answers true (the cockpit is closing), no further project is prepared. */
+export async function prepareProjects(projects, options) {
+    for (const project of projects) {
+        if (options.stopped?.())
+            break;
+        if (project.status === 'missing')
+            continue;
+        await prepareProject(project.root, options).catch((error) => {
+            console.warn(`[${productIdentity(options.rebrand ?? REBRAND_SWITCH).command}] ${error instanceof Error ? error.message : String(error)}`);
+        });
+    }
+    return projects;
+}
+/** The archive and completion ticks: each tick's project list is prepared first, before the
+ *  tick's admission check and its maintenance store. */
+export function prepareBeforeTicks(options, deps) {
+    return { ...deps, projects: async () => { return prepareProjects([...await deps.projects()], options); } };
+}
+/** Whether a cockpit server is closing: set when its `close` is called and by `stop`, before anything closes. */
+export function closingSignal(server) {
+    let closing = false;
+    const close = server.close.bind(server);
+    server.close = ((...args) => { closing = true; return close(...args); });
+    return { stopped: () => { return closing; }, stop: () => { closing = true; } };
+}
+//# sourceMappingURL=auto.js.map

package/dist/project-migration/auto.js.map

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

package/dist/project-migration/cli.d.ts

@@ -0,0 +1,18 @@
+import type { Home } from '../home/home.ts';
+import { getRepoInfo } from '../server/git.ts';
+import type { MigrationFault } from './steps.ts';
+export interface MigrateProjectDeps {
+    /** The homes whose live cockpits may serve the project. */
+    homes: readonly Home[];
+    /** Test seam: the engine's fault points (`MigrationFault`), and `plan:before` in a dry run. */
+    fault?: MigrationFault;
+    /** Test seam: the process the cockpit check skips (this one). */
+    self?: number;
+    getRepoInfo: typeof getRepoInfo;
+    cwd: () => string;
+    log: (line: string) => void;
+    error: (line: string) => void;
+}
+export declare function runMigrateProjectCommand(argv: string[], deps: MigrateProjectDeps): Promise<number>;
+/** The runner the subcommand table registers. */
+export declare function migrateProjectRunner(homes: (env: NodeJS.ProcessEnv) => readonly Home[]): (argv: string[], env: NodeJS.ProcessEnv) => Promise<number>;

package/dist/project-migration/cli.js

@@ -0,0 +1,57 @@
+import { realpathSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { parseArgs } from 'node:util';
+import { commandText } from '../home/command.js';
+import { getRepoInfo } from '../server/git.js';
+import { migrationAnswerText } from './answer.js';
+import { migrateProjectOffline } from './offline.js';
+/**
+ * `migrate-project [--dry-run] [--repo <dir>]` (hearsay-tools/cezarion#3089): the offline project
+ * migration, run only by the user, registered only with the release switch.
+ */
+const HELP = commandText(`Usage: cez migrate-project [--dry-run] [--repo <dir>]
+Move this project's runtime state from .ai/cezar/ to .ai/squawk/, offline. Stop every
+cockpit that serves the project and finish or cancel every task first; the command
+names what it finds still running. It cannot see a cockpit of another home that
+lists the project but never opened it: stop it yourself, and keep older binaries off
+the project. Tracked files are never moved: the command prints the
+git mv commands to run and commit.
+
+    --dry-run     print every move, repair and rewrite; only an unfinished
+                  migration is completed (and reported) first; exits 1
+                  if the plan has blockers or conflicts
+    --repo <dir>  the project (default: the current directory)
+-h, --help        show this help`);
+export async function runMigrateProjectCommand(argv, deps) {
+    let values;
+    try {
+        ({ values } = parseArgs({ args: argv, options: { 'dry-run': { type: 'boolean' }, repo: { type: 'string' }, help: { type: 'boolean', short: 'h' } }, strict: true, allowPositionals: false }));
+    }
+    catch (error) {
+        deps.error(`${error instanceof Error ? error.message : String(error)}\n\n${HELP}`);
+        return 1;
+    }
+    if (values.help) {
+        deps.log(HELP);
+        return 0;
+    }
+    try {
+        // A missing --repo is a refusal like any other: one line on stderr, exit 1.
+        const cwd = resolve(values.repo ?? deps.cwd());
+        const root = realpathSync((await deps.getRepoInfo(cwd))?.root ?? cwd);
+        const answer = await migrateProjectOffline(root, { homes: deps.homes, dryRun: values['dry-run'] === true, fault: deps.fault, self: deps.self });
+        deps.log(migrationAnswerText(answer));
+        return answer.blocked ? 1 : 0;
+    }
+    catch (error) {
+        deps.error(error instanceof Error ? error.message : String(error));
+        return 1;
+    }
+}
+/** The runner the subcommand table registers. */
+export function migrateProjectRunner(homes) {
+    return (argv, env) => runMigrateProjectCommand(argv, {
+        homes: homes(env), getRepoInfo, cwd: () => process.cwd(), log: line => console.log(line), error: line => console.error(line),
+    });
+}
+//# sourceMappingURL=cli.js.map

package/dist/project-migration/cli.js.map

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