@ours.network/fleet 1.2.0-nightly.9 → 2.0.0

package/dist/notifications/target-cleanup.js

@@ -0,0 +1,75 @@
+import { createHash } from 'node:crypto';
+import { existsSync, mkdirSync, readdirSync, readFileSync, rmSync } from 'node:fs';
+import { join } from 'node:path';
+import { replaceFileAtomically } from '../atomic-file.js';
+import { stateRoot } from '../paths.js';
+import { producerConfig } from './outbox.js';
+export const cleanupDir = () => join(stateRoot(), 'notifications', 'removed-targets');
+/** Only a closed agent identity authorizes this producer's role-target cleanup. */
+export function notificationAgentId(target) {
+    if (!target || typeof target !== 'object' || Array.isArray(target))
+        return null;
+    const value = target;
+    return Object.keys(value).every(key => ['kind', 'agentId'].includes(key)) && value.kind === 'agent'
+        && typeof value.agentId === 'string' && /^[A-Za-z0-9_-]{1,120}$/.test(value.agentId) ? value.agentId : null;
+}
+export function hasPendingNotificationTargetCleanup(dir = cleanupDir()) {
+    if (!existsSync(dir))
+        return false;
+    return readdirSync(dir).filter(file => /^[a-f0-9]{64}\.json$/.test(file)).some(file => {
+        try {
+            const value = JSON.parse(readFileSync(join(dir, file), 'utf8'));
+            return !!value && typeof value === 'object' && Object.keys(value).length === 1 && !!notificationAgentId(value.target);
+        }
+        catch (error) {
+            return !(error instanceof SyntaxError);
+        }
+    });
+}
+/** Queue only after the owning lifecycle has established deletion, never on a failed inventory read. */
+export async function retireNotificationTarget(target, config = producerConfig(), dir = cleanupDir(), request = fetch) {
+    if (!config)
+        return;
+    if (!notificationAgentId(target))
+        throw new Error('Invalid notification target');
+    mkdirSync(dir, { recursive: true, mode: 0o700 });
+    replaceFileAtomically(join(dir, createHash('sha256').update(JSON.stringify({ kind: 'agent', agentId: target.agentId })).digest('hex') + '.json'), JSON.stringify({ target }) + '\n', 0o600);
+    await drainNotificationTargetCleanup(config, dir, request, { retain: true });
+}
+/** Persisted retries also run from the ordinary web notification producer after restart. */
+export async function drainNotificationTargetCleanup(config, dir = cleanupDir(), request = fetch, options = {}) {
+    if (!existsSync(dir))
+        return;
+    let attempts = 0;
+    for (const file of readdirSync(dir).filter(file => /^[a-f0-9]{64}\.json$/.test(file))) {
+        if (attempts >= 32)
+            break;
+        const path = join(dir, file);
+        let value;
+        try {
+            value = JSON.parse(readFileSync(path, 'utf8'));
+        }
+        catch {
+            continue;
+        }
+        if (!value || typeof value !== 'object' || Array.isArray(value) || Object.keys(value).length !== 1 || !notificationAgentId(value.target))
+            continue;
+        try {
+            attempts++;
+            if (options.beforeDelete && !(await options.beforeDelete(value.target))) {
+                rmSync(path, { force: true });
+                continue;
+            }
+            const response = await request(config.origin + '/api/v1/delete-target', { method: 'POST', redirect: 'error', signal: AbortSignal.timeout(10000),
+                headers: { ...(config.gatewayCredential ? { 'X-Ours-Api-Token': config.gatewayCredential, 'X-Ours-Notifications-Producer': config.token } : { Authorization: `Bearer ${config.token}` }), 'Content-Type': 'application/json' }, body: JSON.stringify(value) });
+            await response.body?.cancel();
+            if (!response.ok)
+                break;
+            if (!options.retain)
+                rmSync(path, { force: true });
+        }
+        catch {
+            break; /* No credentials or response bodies are included in logs. */
+        }
+    }
+}

package/dist/notifications/task-producer.d.ts

@@ -0,0 +1,20 @@
+import type { ProducerConfig } from './outbox.js';
+/** The Fleet manager owns this sender even when the web console is stopped.
+ * Events are already durable in their owning task commit, so no second outbox
+ * admission/crash window is needed. A failed task does not block other tasks. */
+export declare class TaskNotificationProducer {
+    private readonly config;
+    private readonly warn;
+    private readonly request;
+    private timer?;
+    private dirty;
+    private running?;
+    private offset;
+    private stopped;
+    private readonly shutdown;
+    constructor(config: ProducerConfig, warn?: (line: string) => void, request?: typeof fetch);
+    drain(): Promise<void>;
+    private retry;
+    private drainOnce;
+    close(): Promise<void>;
+}

package/dist/notifications/task-producer.js

@@ -0,0 +1,100 @@
+import { observeFleetResources } from '../application/resource-observer.js';
+import { tasksDir } from '../rooms-tasks/task-state.js';
+import { acknowledgeTaskNotification, pendingTaskNotifications } from '../rooms-tasks/task-state.js';
+/** The Fleet manager owns this sender even when the web console is stopped.
+ * Events are already durable in their owning task commit, so no second outbox
+ * admission/crash window is needed. A failed task does not block other tasks. */
+export class TaskNotificationProducer {
+    config;
+    warn;
+    request;
+    timer;
+    dirty = false;
+    running;
+    offset = 0;
+    stopped = false;
+    shutdown = new AbortController();
+    constructor(config, warn = () => { }, request = fetch) {
+        this.config = config;
+        this.warn = warn;
+        this.request = request;
+        // Subscribe before startup replay: a commit while fetch is pending needs a second pass.
+        observeFleetResources({ retryWatchFailures: true, paths: [tasksDir()], roots: [] }, state => {
+            if (state.health !== 'healthy')
+                this.warn('Task notification observation unavailable; committed events retained');
+            else {
+                this.dirty = true;
+                void this.drain();
+            }
+        }, this.shutdown.signal);
+        void this.drain();
+    }
+    drain() {
+        if (this.stopped)
+            return Promise.resolve();
+        if (this.running)
+            return this.running;
+        this.dirty = false;
+        clearTimeout(this.timer);
+        this.timer = undefined;
+        this.running = this.drainOnce().catch(() => {
+            this.warn('Task notification snapshot unavailable; committed events retained');
+            this.retry();
+        }).finally(() => {
+            this.running = undefined;
+            if (this.dirty && !this.stopped) {
+                this.dirty = false;
+                void this.drain();
+            }
+        });
+        return this.running;
+    }
+    retry() {
+        if (this.stopped || this.timer)
+            return;
+        this.timer = setTimeout(() => { this.timer = undefined; void this.drain(); }, 3000);
+        this.timer.unref();
+    }
+    async drainOnce() {
+        if (this.stopped)
+            return;
+        const pending = pendingTaskNotifications(this.warn);
+        if (!pending.length)
+            return;
+        const start = this.offset % pending.length;
+        const batch = [...pending.slice(start), ...pending.slice(0, start)].slice(0, 32);
+        this.offset = start + batch.length;
+        // Retry only outstanding work; never run an idle discovery timer.
+        this.retry();
+        for (let index = 0; index < batch.length; index += 4) {
+            if (this.stopped)
+                break;
+            await Promise.all(batch.slice(index, index + 4).map(async (task) => {
+                for (const event of task.events.slice(0, 32)) {
+                    if (this.stopped)
+                        break;
+                    try {
+                        const response = await this.request(this.config.origin + '/api/v1/send', {
+                            method: 'POST', redirect: 'error', signal: AbortSignal.any([this.shutdown.signal, AbortSignal.timeout(10_000)]),
+                            headers: { ...(this.config.gatewayCredential
+                                    ? { 'X-Ours-Api-Token': this.config.gatewayCredential, 'X-Ours-Notifications-Producer': this.config.token }
+                                    : { Authorization: `Bearer ${this.config.token}` }), 'Content-Type': 'application/json' },
+                            body: JSON.stringify(event),
+                        });
+                        await response.body?.cancel();
+                        if (!response.ok) {
+                            this.warn(`Task notification delivery pending (HTTP ${response.status}); committed event retained`);
+                            break;
+                        }
+                        acknowledgeTaskNotification(task.taskId, event.eventId);
+                    }
+                    catch {
+                        this.warn('Task notification delivery pending; committed event retained');
+                        break;
+                    }
+                }
+            }));
+        }
+    }
+    async close() { this.stopped = true; clearTimeout(this.timer); this.shutdown.abort(); await this.running; }
+}

package/dist/ops.d.ts

@@ -54,5 +54,7 @@ export declare function up(cfg: FleetConfig, names: string[], deps: OpsDeps, con
 export declare function down(cfg: FleetConfig, names: string[], deps: OpsDeps): Promise<void>;
 /** Re-sync from config + bounce. mode 'keep' resumes context; 'fresh' wipes it. */
 export declare function restartRoles(cfg: FleetConfig, names: string[], deps: OpsDeps, mode: 'keep' | 'fresh', configPath?: string): Promise<void>;
+/** Read-only admission check shared by CLI removal and web preview, before any archive. */
+export declare function assertStandaloneRoleRemoval(cfg: FleetConfig, name: string): void;
 /** Stop + forget a role: unit, state dir, and its fleet.d file when spawned. */
 export declare function rmRole(cfg: FleetConfig, name: string, deps: OpsDeps): Promise<void>;

package/dist/ops.js

@@ -1,3 +1,4 @@
+import { retireNotificationTarget } from './notifications/target-cleanup.js';
 import { chmodSync, existsSync, mkdirSync, readFileSync, writeFileSync, rmSync, unlinkSync, } from 'node:fs';
 import { join } from 'node:path';
 import { randomUUID, createHash } from 'node:crypto';
@@ -5,8 +6,9 @@ import { agentDir, watchdogsRoot } from './paths.js';
 import { findRole } from './config.js';
 import { getAdapter } from './harness/registry.js';
 import { generateBriefing } from './briefing.js';
-import { resetRestartLedger } from './runner.js';
-import { archiveTempState, stopTempSupervisor, tempSupervisorLiveness, } from './temp-lifecycle.js';
+import { managedCliBriefing } from './managed-cli.js';
+import { resetRestartLedger, loadTempRole } from './runner.js';
+import { archiveTempState, stopTempSupervisor, tempSupervisorLiveness, readTempSupervisor, } from './temp-lifecycle.js';
 import { realExec } from './exec.js';
 import { daemonIdentityProvisioner, reconcilePermanentRoleIdentities, } from './creation.js';
 import { provesGeneratedAgentSource } from './generated-agent-source.js';
@@ -28,7 +30,7 @@ export function applyRole(role, opts = {}) {
     // brought up from so the supervised process can reload the SAME file instead of
     // silently falling back to the default ~/fleet.yaml. Temp roles snapshot their
     // whole resolved role into role.yaml instead and don't need this.
-    if (!opts.temp)
+    if (!opts.temp || opts.configPath)
         writeFileSync(join(dir, '.config-path'), (opts.configPath ?? '') + '\n');
     writeFileSync(join(dir, '.identity'), role.identity + '\n');
     if (role.cwd)
@@ -43,6 +45,7 @@ export function applyRole(role, opts = {}) {
         routinesPath: join(dir, 'ROUTINES.md'), briefingBody,
         identityGuarantee: opts.identityGuarantee,
         temporaryIdentity: opts.temp === true,
+        managedCli: managedCliBriefing(role, opts.configPath, opts.temp === true),
     }));
     if (opts.fresh)
         for (const f of ['.booted', '.session-id', '.exit-status'])
@@ -220,8 +223,21 @@ export async function restartRoles(cfg, names, deps, mode, configPath) {
             : `↻ ${role.name} — restarted (resumes; briefing re-synced)`);
     }
 }
+/** Read-only admission check shared by CLI removal and web preview, before any archive. */
+export function assertStandaloneRoleRemoval(cfg, name) {
+    if (cfg.roles.some(role => role.name === name) || !/^[A-Za-z0-9_-]+$/.test(name))
+        return;
+    const dir = agentDir(name, true);
+    if (!existsSync(dir))
+        return;
+    const taskId = readTempSupervisor(dir)?.taskOwner?.taskId
+        ?? (existsSync(join(dir, 'role.yaml')) ? loadTempRole(name).roomMemberStartup?.task_id : undefined);
+    if (taskId)
+        throw Error(`TASK_MEMBER_IS_TASK_OWNED: ${name} belongs to task ${taskId}; use the owning task lifecycle; if its record is missing or corrupt, preserve evidence and restore the original records before retrying task delete`);
+}
 /** Stop + forget a role: unit, state dir, and its fleet.d file when spawned. */
 export async function rmRole(cfg, name, deps) {
+    assertStandaloneRoleRemoval(cfg, name);
     const temporaryDir = /^[A-Za-z0-9_-]+$/.test(name) ? agentDir(name, true) : '';
     const configured = cfg.roles.find(role => role.name === name);
     if (!configured && temporaryDir && existsSync(temporaryDir)) {
@@ -255,6 +271,7 @@ export async function rmRole(cfg, name, deps) {
     rmSync(agentDir(name), { recursive: true, force: true });
     if (generatedSource && existsSync(role.sourceFile)) {
         unlinkSync(role.sourceFile);
+        await retireNotificationTarget({ kind: 'agent', agentId: name }).catch(() => { });
         deps.log(`removed ${role.sourceFile}`);
     }
     deps.log(`removed '${name}' (its ours identity is left intact)`);

package/dist/owner-channel/channel.js

@@ -883,8 +883,15 @@ export class OwnerChannel {
         const recovered = [];
         for (const claim of this.messageRecovery.list()) {
             const item = await this.client.getHistoryItem(claim.wireId);
-            if (!item)
-                throw new Error(`journaled owner message ${claim.wireId} is missing from persistent history`);
+            if (!item) {
+                // The daemon has definitively lost this body. Retrying the claim would
+                // block every later owner message, including after a supervisor restart.
+                // Keep transient lookup errors retryable; only an explicit absence skips.
+                this.messageRecovery.pruneHandled(wireId => wireId === claim.wireId);
+                this.options.log(`[${this.options.role}] skipped journaled owner message ${claim.wireId} `
+                    + `(seq=${claim.seq}): missing from persistent history`);
+                continue;
+            }
             recovered.push(this.historyMessage(item, claim));
         }
         const listed = await this.client.listIncomingMessages();
@@ -1391,6 +1398,7 @@ export class OwnerChannel {
                     await this.fleetOps.provisionTask(task.task_id);
                 return outcome;
             }),
+            observeTaskReadiness: taskId => new TaskRoomApplicationService(this.options.configPath).observeTaskReadiness(taskId),
             taskProvisioningOutcome: taskId => new TaskRoomApplicationService(this.options.configPath).taskProvisioningOutcome(taskId),
             listTasks: filter => new TaskRoomApplicationService(this.options.configPath).listTasks(filter),
             groupedTasks: filter => new TaskRoomApplicationService(this.options.configPath).groupedTasks(filter),
@@ -1977,6 +1985,9 @@ export class OwnerChannel {
         const progressMs = this.options.config.progress_interval_ms;
         let lastSeq = activityCursor;
         let startedAt;
+        // When one turn delivers several waiting prompts, its events carry the turn's
+        // id, not this request's: follow the turn that actually carries this request.
+        const inTurn = (turnId) => turnId === (this.options.session.sharedTurnId?.(queued.promptId) ?? queued.promptId);
         let phase = 'starting request';
         let timer;
         const flushCommentary = () => {
@@ -2033,7 +2044,7 @@ export class OwnerChannel {
         };
         const acceptCommentary = (event) => {
             if (!this.commentsEnabled
-                || active.commentaryDisabled || active.finalizing || event.turnId !== queued.promptId
+                || active.commentaryDisabled || active.finalizing || !inTurn(event.turnId)
                 || event.kind !== 'agent_text' || event.messagePhase !== 'commentary'
                 || event.replayed || event.origin?.kind !== 'owner'
                 || event.origin.requestId !== active.requestId
@@ -2074,7 +2085,7 @@ export class OwnerChannel {
         const reportProgress = () => {
             const events = this.options.session.eventsSince(lastSeq);
             lastSeq = Math.max(lastSeq, this.latestEventSeq(events));
-            const activity = events.filter(event => event.turnId === queued.promptId);
+            const activity = events.filter(event => inTurn(event.turnId));
             if (!activity.length)
                 return;
             startedAt ??= Date.parse(activity[0].at) || Date.now();
@@ -2099,10 +2110,10 @@ export class OwnerChannel {
         const startProgress = (event) => {
             if (timer || progressMs <= 0)
                 return;
-            if (event && event.turnId !== queued.promptId)
+            if (event && !inTurn(event.turnId))
                 return;
             const observed = event ? [event] : this.options.session.eventsSince(activityCursor)
-                .filter(item => item.turnId === queued.promptId);
+                .filter(item => inTurn(item.turnId));
             if (!observed.length)
                 return;
             startedAt = Date.parse(observed[0].at) || Date.now();

package/dist/owner-channel/commands.d.ts

@@ -1,3 +1,4 @@
+import type { TaskReadinessIssue } from '../rooms-tasks/live-readiness.js';
 import type { InterruptOutcome, SessionEvent, SessionSnapshot } from '../session/types.js';
 import type { RoomOrchestrationRecord, TaskOutcome, TaskRecord, TaskTerminalIntent, TaskListRecord } from '../rooms-tasks/types.js';
 import { type OwnerCommentsState } from './notices.js';
@@ -58,6 +59,9 @@ export interface OwnerCommandContext {
     terminalTask(taskId: string, kind: TaskTerminalIntent['kind'], outcome?: TaskOutcome): Promise<void>;
     createTask(input: Omit<CreateTaskRequest, 'actor'>): Promise<TaskRecord>;
     startTask(taskId: string): Promise<TaskProvisioningOutcome | TaskRecord>;
+    observeTaskReadiness?(taskId: string): Promise<{
+        state: 'ready';
+    } | TaskReadinessIssue>;
     taskProvisioningOutcome?(taskId: string): TaskProvisioningOutcome;
     listTasks(filter?: {
         state?: TaskState | TaskState[];

package/dist/owner-channel/commands.js

@@ -47,6 +47,11 @@ function isKnownOwnerRoomState(message) {
     ].some(pattern => pattern.test(message));
 }
 function ownerTaskFailure(error) {
+    if (error instanceof TaskRoomApplicationError && error.code === 'task_not_ready')
+        return {
+            kind: 'state', detail: error.message,
+            action: 'Ask Fleet Coordinator to inspect room and member status and choose supported recovery.',
+        };
     if (error instanceof TaskListError)
         return {
             kind: error.code === 'list_not_found' ? 'not_found'
@@ -301,6 +306,7 @@ export const ownerCommands = [
             const trailingLines = argLines.slice(1).join('\n').trim() || undefined;
             const showTask = async (id) => {
                 const { task: t } = ctx.getTask(id);
+                const readiness = t.state === 'active' ? await ctx.observeTaskReadiness?.(id) : undefined;
                 await ctx.reply(renderMarkdownResult({
                     icon: '📋', title: 'Task details',
                     fields: [
@@ -308,6 +314,8 @@ export const ownerCommands = [
                         { label: 'Title', value: t.title },
                         { label: 'Status', value: taskStatus(t.state), kind: 'markdown' },
                         { label: 'List', value: t.list_name ?? 'default', kind: 'code' },
+                        ...(readiness ? [{ label: 'Readiness', value: readiness.state },
+                            ...('reason' in readiness ? [{ label: 'Reason', value: readiness.reason }] : [])] : []),
                         ...(t.blocked ? [{ label: 'Blocked', value: t.blocked.reason }] : []),
                         ...(t.template ? [{ label: 'Template', value: `${t.template.name}@${t.template.version}`, kind: 'code' }] : []),
                         ...(t.room_id ? [{ label: 'Room', value: t.room_id, kind: 'code' }] : []),

package/dist/owner-channel/lifecycle-outbox.js

@@ -1,6 +1,6 @@
+import { redactErasedContent, writePrivacyFilteredLedger } from '../erased-resources.js';
 import { createHash } from 'node:crypto';
 import { chmodSync, existsSync, readFileSync } from 'node:fs';
-import { replaceFileAtomically } from '../atomic-file.js';
 import { lifecycleEventDigestBasis, validateFleetAuditPresentations, } from '../fleet-command-audit.js';
 const DIGEST = /^[a-f0-9]{64}$/u;
 const LIMIT = 5_000;
@@ -63,7 +63,7 @@ export class FleetLifecycleOutbox {
     }
     pending() {
         this.assertHealthy();
-        return this.entries.filter(entry => entry.delivery === 'pending').map(entry => structuredClone(entry));
+        return redactErasedContent(this.entries).filter(entry => entry.delivery === 'pending').map(entry => structuredClone(entry));
     }
     finish(digest, delivery) {
         this.assertHealthy();
@@ -82,6 +82,7 @@ export class FleetLifecycleOutbox {
             throw new Error(this.corruptReason);
     }
     persist() {
-        replaceFileAtomically(this.path, `${JSON.stringify({ version: 1, entries: this.entries })}\n`, 0o600);
+        this.entries = redactErasedContent(this.entries);
+        writePrivacyFilteredLedger(this.path, { version: 1, entries: this.entries });
     }
 }

package/dist/owner-channel/ours-client.js

@@ -1,7 +1,6 @@
 import { randomUUID } from 'node:crypto';
 import { readFile } from 'node:fs/promises';
-import { extname, join } from 'node:path';
-import { readDaemonConfig, resolveEndpoint } from '../monitor.js';
+import { extname } from 'node:path';
 import { readClientProfile } from '../client-profile.js';
 import { OursError, attachOursClient, } from '@ours.network/sdk/client';
 /** Any failure of a daemon operation. Never carries a message body or a token. */
@@ -131,24 +130,10 @@ export class OursSdkClient {
             return;
         const environment = { ...process.env, ...this.env };
         const profile = readClientProfile(environment);
-        // Reuse existing connection configuration. Identity selection checks the
-        // daemon capability before reading the client's protected token delivery file.
-        const endpoint = !profile && environment.OURS_DAEMON_ID
-            ? resolveEndpoint(environment, false) : undefined;
-        const token = endpoint ? environment.OURS_API_TOKEN?.trim() || readDaemonConfig(environment).apiToken : undefined;
-        const options = profile ? {
+        const options = {
             endpoint: profile.endpoint, expectedInstanceId: profile.expectedInstanceId,
             credentialPath: profile.credentialPath,
             sessionMode: 'external', leaseToken: this.leaseToken, env: {},
-        } : endpoint ? {
-            endpoint: endpoint.origin, expectedInstanceId: environment.OURS_DAEMON_ID,
-            sessionMode: 'external', leaseToken: this.leaseToken,
-            ...(token ? { token } : { credentialPath: join(endpoint.stateDir, 'daemon-token') }),
-        } : {
-            env: environment,
-            leaseToken: this.leaseToken,
-            clientPid: process.pid,
-            fetch: notificationDeadlineFetch(this.deps.fetch ?? globalThis.fetch, this.deps.notificationRequestDeadlineMs ?? NOTIFICATION_REQUEST_DEADLINE_MS),
         };
         this.client = await (this.deps.attachClient?.(options) ?? attachOursClient(options));
         this.terminalReleasePending = true;

package/dist/paths.d.ts

@@ -11,6 +11,11 @@ export declare const home: () => string;
  */
 export declare function deriveXdgRuntimeDir(env?: NodeJS.ProcessEnv, uid?: number | undefined, exists?: (p: string) => boolean): string | undefined;
 export declare const stateRoot: () => string;
+/** The Owner invitation file that tunnel setup writes itself after enrollment. */
+export declare const workspaceOwnerInvite: () => string;
+/** Serializes writers of the workspace binding and of its unfinished replacement record. */
+export declare const workspaceBindingLock: () => string;
+export declare const workspaceReplacementFile: () => string;
 export declare const agentsRoot: () => string;
 export declare const tmpRoot: () => string;
 export declare const logsRoot: () => string;

package/dist/paths.js

@@ -21,6 +21,11 @@ export function deriveXdgRuntimeDir(env = process.env, uid = process.getuid?.(),
     return env.XDG_RUNTIME_DIR;
 }
 export const stateRoot = () => join(home(), '.ours-fleet');
+/** The Owner invitation file that tunnel setup writes itself after enrollment. */
+export const workspaceOwnerInvite = () => join(stateRoot(), 'workspace', 'owner.invite');
+/** Serializes writers of the workspace binding and of its unfinished replacement record. */
+export const workspaceBindingLock = () => join(stateRoot(), 'workspace', '.binding.lock');
+export const workspaceReplacementFile = () => join(stateRoot(), 'workspace', 'replacement.json');
 export const agentsRoot = () => join(stateRoot(), 'agents');
 export const tmpRoot = () => join(stateRoot(), 'tmp');
 export const logsRoot = () => join(stateRoot(), 'logs');

package/dist/preset-migration.js

@@ -67,10 +67,45 @@ const V5_GENERATED_ROLE_DEFAULT_FINGERPRINTS = Object.freeze({
     'agent_templates/Developer.yaml': 'fdd953aab72d042e62780dd273598745aae59521b39edf4876d7676bb7189c83',
     'agent_templates/Critic.yaml': '3e98a28f17876061cfadf984351aa59fdbe19629e514eff52c74546545c64a91',
 });
+// The packaged Coordinator role of revisions 8 and 9 addressed a named owner channel that a
+// fresh installation does not have. Untouched copies adopt the current role; edited ones stay.
+const OWNER_CHANNEL_COORDINATOR_FINGERPRINTS = Object.freeze({
+    'roles/Coordinator.yaml': [
+        '8c8ad28d9bb9ddf9dba8c5c9c7859f25edd8fa10ebf833e2340124a6e49583ec',
+        'f0d8b169ad0a18051b57e5280b93cf01e05faa5c12f4e12bdf89973edf2ef58a',
+    ],
+});
+// The packaged revision-10 LocalCoordinator continuity loop reread ROUTINES.md and the WORKLOG
+// checkpoint on every 15-minute pass. Untouched copies adopt the current template; edited ones stay.
+const REREADING_CONTINUITY_LOOP_FINGERPRINTS = Object.freeze({
+    'agent_templates/LocalCoordinator.yaml': [
+        '53889cd3987e25ca42be64ddcfa1cf46a73ab769070db144f5b7d86085734178',
+    ],
+});
+// The packaged Developer, Critic and Engineer charters before they described one bounded
+// self-reminder per peer wait. Untouched copies adopt the current text; edited ones stay.
+const PEER_WAIT_REMINDER_FINGERPRINTS = Object.freeze({
+    'roles/Developer.yaml': ['2884366ce02760d66d3edbaed2adc83f2959fd7906a7cd3b5a8b90cf601bc3e6'],
+    'roles/Critic.yaml': ['998abdbc5159e8e1c26eb1ca09f9707b005ba1930bd5b7a4989c4d6893804c4a'],
+    'roles/Engineer.yaml': ['a361453ad32cde08797cf90fff17a35bde1871ccea17389448b44398b45ccfa5'],
+});
+// The packaged revision-11 charters before task Progress and the self-contained To review handoff.
+// Untouched copies adopt the current text; edited ones stay.
+const REVIEW_PACKAGE_FINGERPRINTS = Object.freeze({
+    'roles/Developer.yaml': ['cd2da8c9fb4d56b08c618221e38b9c8a2568a59b7d7ee6e44d0f6f55f9dc42e9'],
+    'roles/Critic.yaml': ['b2576fe4b9501581e874daa40b77e0379220c855a76d0fd80945e9fc42e08131'],
+    'roles/Engineer.yaml': ['dc99a42f64c4bc2c5073917f4552a366a0ab95c24bdde9e13d66320d68edac1b'],
+    'roles/LocalCoordinator.yaml': ['1a4c7613de0c374ac49ede31b312fcfd3f4a08d31316cf8dda10e46f25844e03'],
+    'roles/Coordinator.yaml': ['1fa72470f37330a96debdfa6a64004280edcf318fafd5f6a5065a06ee7e87acc'],
+    'agent_templates/LocalCoordinator.yaml': ['931908da43df7c85dd2b106c99c765a3aeb4a97361fa00ce110e3ac93221ce32'],
+});
 const CURRENT_ROLE_DEFAULTS = new Set([
     'roles/Coordinator.yaml', 'roles/LocalCoordinator.yaml', 'roles/Developer.yaml', 'roles/Critic.yaml',
+    'roles/Engineer.yaml',
     'agent_templates/LocalCoordinator.yaml', 'agent_templates/Developer.yaml', 'agent_templates/Critic.yaml',
+    'agent_templates/Engineer.yaml',
     'room_templates/single.yaml', 'room_templates/pair.yaml', 'room_templates/team.yaml',
+    'room_templates/engineering.yaml',
     'agents/FleetCoordinator.yaml',
 ]);
 export const legacyStarterMigrationManifest = Object.freeze({
@@ -193,6 +228,10 @@ export function migratePackagedRoleDefaults(configuration, options = {}, hooks =
             ...Object.keys(V3_ROLE_DEFAULT_FINGERPRINTS),
             ...Object.keys(V4_ROLE_DEFAULT_FINGERPRINTS),
             ...Object.keys(V5_ROLE_DEFAULT_FINGERPRINTS),
+            ...Object.keys(OWNER_CHANNEL_COORDINATOR_FINGERPRINTS),
+            ...Object.keys(REREADING_CONTINUITY_LOOP_FINGERPRINTS),
+            ...Object.keys(PEER_WAIT_REMINDER_FINGERPRINTS),
+            ...Object.keys(REVIEW_PACKAGE_FINGERPRINTS),
         ]);
         for (const relative of known) {
             const path = join(root, relative);
@@ -206,6 +245,10 @@ export function migratePackagedRoleDefaults(configuration, options = {}, hooks =
                 V4_GENERATED_ROLE_DEFAULT_FINGERPRINTS[relative],
                 V5_ROLE_DEFAULT_FINGERPRINTS[relative],
                 V5_GENERATED_ROLE_DEFAULT_FINGERPRINTS[relative],
+                ...(OWNER_CHANNEL_COORDINATOR_FINGERPRINTS[relative] ?? []),
+                ...(REREADING_CONTINUITY_LOOP_FINGERPRINTS[relative] ?? []),
+                ...(PEER_WAIT_REMINDER_FINGERPRINTS[relative] ?? []),
+                ...(REVIEW_PACKAGE_FINGERPRINTS[relative] ?? []),
             ].some(expected => expected !== undefined && actual === expected);
             if (recognized)
                 (CURRENT_ROLE_DEFAULTS.has(relative) ? replacements : removals).push(path);
@@ -258,6 +301,18 @@ export function migratePackagedRoleDefaults(configuration, options = {}, hooks =
                 unlinkSync(target);
             copyFileSync(join(source, relative), target, constants.COPYFILE_EXCL);
             chmodSync(target, 0o600);
+            // New Engineer seats use the existing Developer's selected brain. This
+            // preserves wizard/custom provider choices without copying permissions.
+            if (relative === 'agent_templates/Engineer.yaml' && classified.additions.includes(path)) {
+                const developer = join(root, 'agent_templates/Developer.yaml');
+                if (existsSync(developer)) {
+                    const value = parseFleetDocument(developer, readFileSync(developer, 'utf8'), 'strict').value;
+                    if (value.brain !== undefined && JSON.stringify(value.brain) !== JSON.stringify({ ref: 'claude-default' })) {
+                        const bytes = readFileSync(target, 'utf8').replace('brain: { ref: claude-default }', () => `brain: ${JSON.stringify(value.brain)}`);
+                        writeFileSync(target, bytes, { mode: 0o600 });
+                    }
+                }
+            }
             fsyncPath(target);
         }
         for (const kind of ['roles', 'agent_templates', 'room_templates', 'agents'])

package/dist/process-incarnation.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Which run of a process a PID names. A PID alone is not an identity: after a
+ * reboot or wraparound the same number belongs to an unrelated process, and a
+ * lock or claim keyed on it would then look held forever. The kernel boot id
+ * and the process start time (in clock ticks since boot) pin one incarnation.
+ * Both are Linux-only; elsewhere they are absent and callers stay PID-only.
+ */
+export interface ProcessIncarnation {
+    boot?: string;
+    start?: string;
+}
+export interface IncarnationProbe {
+    bootId(): string | undefined;
+    startTime(pid: number): string | undefined;
+}
+export declare const procIncarnationProbe: IncarnationProbe;
+export declare function processIncarnation(pid: number, probe?: IncarnationProbe): ProcessIncarnation;
+/**
+ * True only when a recorded marker positively proves the live PID is a later
+ * process: a different boot, or a different start time. A marker that was not
+ * recorded, or cannot be read now, proves nothing and keeps the PID check.
+ */
+export declare function incarnationEnded(pid: number, recorded: ProcessIncarnation, probe?: IncarnationProbe): boolean;

package/dist/process-incarnation.js

@@ -0,0 +1,42 @@
+import { readFileSync } from 'node:fs';
+export const procIncarnationProbe = {
+    bootId() {
+        try {
+            return readFileSync('/proc/sys/kernel/random/boot_id', 'utf8').trim() || undefined;
+        }
+        catch {
+            return undefined;
+        }
+    },
+    startTime(pid) {
+        try {
+            const stat = readFileSync(`/proc/${pid}/stat`, 'utf8');
+            return stat.slice(stat.lastIndexOf(')') + 2).split(/\s+/)[19] || undefined;
+        }
+        catch {
+            return undefined;
+        }
+    },
+};
+export function processIncarnation(pid, probe = procIncarnationProbe) {
+    const boot = probe.bootId(), start = probe.startTime(pid);
+    return { ...(boot ? { boot } : {}), ...(start ? { start } : {}) };
+}
+/**
+ * True only when a recorded marker positively proves the live PID is a later
+ * process: a different boot, or a different start time. A marker that was not
+ * recorded, or cannot be read now, proves nothing and keeps the PID check.
+ */
+export function incarnationEnded(pid, recorded, probe = procIncarnationProbe) {
+    if (typeof recorded.boot === 'string') {
+        const boot = probe.bootId();
+        if (boot && boot !== recorded.boot)
+            return true;
+    }
+    if (typeof recorded.start === 'string') {
+        const start = probe.startTime(pid);
+        if (start && start !== recorded.start)
+            return true;
+    }
+    return false;
+}