ai-foreman 1.7.7 → 1.7.8

package/dist/statusReporter.d.ts

@@ -21,6 +21,13 @@ export interface AgentStatusSnapshot {
     contextSample: ContextSample;
     sessionUsage?: SessionUsageSample;
     sessionTransition: string;
+    lifecycleState?: string;
+    configuredCeilingPercent?: number;
+    installedNativeTokenLimit?: number;
+    installedNativePercent?: number;
+    compactionCount?: number;
+    compactMaximum?: number;
+    settingsRevision?: number;
     at: string;
 }
 export interface StatusClock {
@@ -47,6 +54,20 @@ export interface AgentStatusReporterInput {
     adapter: BuilderAdapter | (() => BuilderAdapter);
     compactionCount?: number | (() => number);
     handoffGeneration?: number | (() => number);
+    /** Shared enforcement snapshot. When supplied, status never polls occupancy independently. */
+    contextSnapshot?: () => {
+        role: "builder" | "qa";
+        provider: "claude" | "codex";
+        model: string;
+        lifecycleState: string;
+        contextSample: ContextSample;
+        configuredCeilingPercent: number;
+        installedNativeTokenLimit?: number;
+        installedNativePercent?: number;
+        compactionCount: number;
+        compactMaximum: number;
+        settingsRevision: number;
+    } | undefined;
 }
 /**
  * A non-blocking ten-second reporter. It never invents occupancy or cost: an
@@ -59,6 +80,7 @@ export declare class AgentStatusReporter {
     private readonly intervalMs;
     private handle?;
     private lastGoodContext?;
+    private readonly lastGoodByRole;
     constructor(input: AgentStatusReporterInput, emit: (line: string, snapshot: AgentStatusSnapshot) => void, clock?: StatusClock, intervalMs?: number);
     start(): void;
     tick(): Promise<void>;
@@ -82,6 +104,10 @@ export declare class RoleStatusAdapter implements BuilderAdapter {
     adoptSessionRef(ref: import("rafi-spec").ProviderSessionRefV1): void;
     validateSession(): Promise<import("rafi-spec").SessionAvailabilityV1>;
     compact(): Promise<CompactResult>;
+    prepareContextManagement(policy: import("./adapters/types.js").ContextManagementPolicy): Promise<import("./adapters/types.js").PreparedContextManagement>;
+    updateContextManagement(policy: import("./adapters/types.js").ContextManagementPolicy): Promise<import("./adapters/types.js").PreparedContextManagement>;
+    interruptTurnAtCompactionBoundary(providerEventId?: string): Promise<import("./adapters/types.js").InterruptResult>;
+    installManagedTurnDispatcher(dispatcher: import("./adapters/types.js").ManagedTurnDispatcher): void;
     contextUsage(): Promise<ContextUsage | undefined>;
     sessionUsage(): Promise<ProviderSessionUsage | undefined>;
     switchSettings(settings: ProviderSettingSwitch): Promise<CompactResult>;

package/dist/statusReporter.js

@@ -19,6 +19,7 @@ export class AgentStatusReporter {
     intervalMs;
     handle;
     lastGoodContext;
+    lastGoodByRole = new Map();
     constructor(input, emit, clock = systemClock, intervalMs = 10_000) {
         this.input = input;
         this.emit = emit;
@@ -34,23 +35,44 @@ export class AgentStatusReporter {
     async tick() {
         const adapter = this.adapter();
         const now = this.clock.now();
-        let observed;
-        try {
-            observed = await adapter.contextUsage?.();
-        }
-        catch {
-            observed = undefined;
-        }
         let contextSample;
-        if (observed && Number.isFinite(observed.used)) {
-            contextSample = this.contextSample(observed, now);
-            this.lastGoodContext = contextSample;
+        const hasCoordinator = this.input.contextSnapshot !== undefined;
+        const coordinated = this.input.contextSnapshot?.();
+        if (coordinated && coordinated.role === this.input.role) {
+            contextSample = coordinated.contextSample;
+            this.input.provider = coordinated.provider;
+            this.input.model = coordinated.model;
+            this.input.settingsRevision = coordinated.settingsRevision;
+            this.input.compactionCount = coordinated.compactionCount;
+            if (contextSample.freshness === "fresh") {
+                this.lastGoodContext = contextSample;
+                this.lastGoodByRole.set(this.input.role, contextSample);
+            }
         }
-        else if (this.lastGoodContext) {
-            contextSample = { ...this.lastGoodContext, freshness: "stale" };
+        else if (!hasCoordinator) {
+            let observed;
+            try {
+                observed = await adapter.contextUsage?.();
+            }
+            catch {
+                observed = undefined;
+            }
+            if (observed && Number.isFinite(observed.used))
+                contextSample = this.contextSample(observed, now);
+            else if (this.lastGoodContext)
+                contextSample = { ...this.lastGoodContext, freshness: "stale" };
+            else
+                contextSample = { ...this.measuringSample(now), freshness: "unavailable" };
         }
         else {
-            contextSample = { ...this.measuringSample(now), freshness: "unavailable" };
+            const prior = this.lastGoodByRole.get(this.input.role);
+            contextSample = prior
+                ? { ...prior, freshness: "stale" }
+                : { ...this.measuringSample(now), freshness: "unavailable" };
+        }
+        if (contextSample.freshness === "fresh") {
+            this.lastGoodContext = contextSample;
+            this.lastGoodByRole.set(this.input.role, contextSample);
         }
         let sessionUsage;
         if (this.input.displaySessionCost) {
@@ -90,16 +112,19 @@ export class AgentStatusReporter {
         const priorRole = this.input.role;
         const priorAdapter = this.adapter();
         const priorSessionId = priorAdapter.sessionId();
+        if (this.lastGoodContext)
+            this.lastGoodByRole.set(priorRole, this.lastGoodContext);
         Object.assign(this.input, patch);
         if (priorRole !== this.input.role
             || priorAdapter !== this.adapter()
             || priorSessionId !== this.adapter().sessionId()
             || patch.sessionTransition !== undefined)
-            this.lastGoodContext = undefined;
+            this.lastGoodContext = this.lastGoodByRole.get(this.input.role);
         this.emitSnapshot(this.measuringSample(), undefined);
     }
     emitSnapshot(contextSample, sessionUsage, now = this.clock.now()) {
-        const { adapter: _adapter, displaySessionCost: _display, compactionCount: _compactions, handoffGeneration: _handoffs, ...base } = this.input;
+        const coordinated = this.input.contextSnapshot?.();
+        const { adapter: _adapter, displaySessionCost: _display, compactionCount: _compactions, handoffGeneration: _handoffs, contextSnapshot: _contextSnapshot, ...base } = this.input;
         const context = contextSample.used === undefined ? undefined : {
             used: contextSample.used,
             maximum: contextSample.maximum,
@@ -110,13 +135,29 @@ export class AgentStatusReporter {
             ...(context ? { context } : {}),
             contextSample,
             ...(sessionUsage ? { sessionUsage } : {}),
+            ...(coordinated && coordinated.role === this.input.role ? {
+                lifecycleState: coordinated.lifecycleState,
+                configuredCeilingPercent: coordinated.configuredCeilingPercent,
+                installedNativeTokenLimit: coordinated.installedNativeTokenLimit,
+                installedNativePercent: coordinated.installedNativePercent,
+                compactionCount: coordinated.compactionCount,
+                compactMaximum: coordinated.compactMaximum,
+                settingsRevision: coordinated.settingsRevision,
+            } : {
+                compactionCount: contextSample.compactionCount,
+                settingsRevision: contextSample.settingsRevision,
+            }),
             at: now.toISOString(),
         };
         const line = [
             `${snapshot.role} ${snapshot.provider}/${snapshot.model}`,
             `activity=${snapshot.phase}`,
             formatContext(contextSample),
-            `compactions=${contextSample.compactionCount}`,
+            ...(snapshot.configuredCeilingPercent === undefined ? [] : [`ceiling=${snapshot.configuredCeilingPercent}%`]),
+            ...(snapshot.installedNativePercent === undefined ? [] : [`native=${snapshot.installedNativePercent.toFixed(1)}%${snapshot.installedNativeTokenLimit === undefined ? "" : `/${snapshot.installedNativeTokenLimit}`}`]),
+            ...(snapshot.lifecycleState ? [`state=${formatLifecycle(snapshot.lifecycleState)}`] : []),
+            `compactions=${snapshot.compactionCount ?? contextSample.compactionCount}${snapshot.compactMaximum === undefined ? "" : `/${snapshot.compactMaximum}`}`,
+            `revision=${snapshot.settingsRevision ?? contextSample.settingsRevision}`,
             `handoff=${contextSample.handoffGeneration}`,
             `session=${snapshot.sessionTransition}`,
             ...(this.input.displaySessionCost ? [formatSessionUsage(sessionUsage)] : []),
@@ -177,6 +218,12 @@ export class RoleStatusAdapter {
     adoptSessionRef(ref) { this.adapter.adoptSessionRef?.(ref); }
     validateSession() { return this.adapter.validateSession?.() ?? Promise.resolve({ version: 1, status: "unknown", checkedAt: new Date().toISOString(), reason: "legacy-unscoped" }); }
     compact() { this.onActive(this.adapter); return this.adapter.compact?.() ?? Promise.resolve({ ok: false, error: "native compaction unavailable" }); }
+    prepareContextManagement(policy) { this.onActive(this.adapter); if (!this.adapter.prepareContextManagement)
+        return Promise.reject(new Error("native context management unavailable")); return this.adapter.prepareContextManagement(policy); }
+    updateContextManagement(policy) { if (!this.adapter.updateContextManagement)
+        return Promise.reject(new Error("native context reconfiguration unavailable")); return this.adapter.updateContextManagement(policy); }
+    interruptTurnAtCompactionBoundary(providerEventId) { return this.adapter.interruptTurnAtCompactionBoundary?.(providerEventId) ?? Promise.resolve({ ok: false, error: "compaction-boundary interruption unavailable", providerEventId }); }
+    installManagedTurnDispatcher(dispatcher) { this.adapter.installManagedTurnDispatcher?.(dispatcher); }
     contextUsage() { return this.adapter.contextUsage?.() ?? Promise.resolve(undefined); }
     sessionUsage() { return this.adapter.sessionUsage?.() ?? Promise.resolve(undefined); }
     switchSettings(settings) { return this.adapter.switchSettings?.(settings) ?? Promise.resolve({ ok: false, error: "settings switch unavailable" }); }
@@ -215,6 +262,19 @@ function formatContext(sample) {
         : `${sample.percentage.toFixed(1)}% (${sample.used ?? "unknown"}/${sample.maximum ?? "unknown"})`;
     return `context ${occupancy}${sample.freshness === "stale" ? " stale" : ""}`;
 }
+function formatLifecycle(state) {
+    if (state === "initializing")
+        return "measuring";
+    if (state === "threshold_pending")
+        return "pending";
+    if (state === "native_compacting" || state === "host_compacting")
+        return "compacting";
+    if (state === "compacted_unverified")
+        return "verifying";
+    if (state === "handoff_required" || state === "resuming")
+        return "handing off";
+    return state;
+}
 function formatSessionUsage(sample) {
     if (!sample || sample.source === "unavailable")
         return "session usage unavailable";

package/dist/workflowDb.d.ts

@@ -55,13 +55,45 @@ export interface CompactionAttemptRecord {
     sessionRef?: ProviderSessionRefV1;
     sessionKey?: string;
     crossingKey: string;
-    status: "started" | "succeeded" | "failed";
+    status: "started" | "succeeded" | "failed" | "unverified";
+    origin: "provider-auto" | "rafi-manual" | "recovery" | "boundary";
+    providerEventId?: string;
+    thresholdGenerationId?: string;
     beforeSample?: ContextSample;
     afterSample?: ContextSample;
     error?: string;
     createdAt: string;
     updatedAt: string;
 }
+export type ThresholdLifecycleState = "initializing" | "armed" | "threshold_pending" | "native_compacting" | "host_compacting" | "compacted_unverified" | "retrying" | "handoff_required" | "resuming";
+export interface ThresholdGenerationRecord {
+    generationId: string;
+    runId: string;
+    role: "builder" | "qa";
+    providerSessionId?: string;
+    sessionRef?: ProviderSessionRefV1;
+    sessionKey?: string;
+    generation: number;
+    state: ThresholdLifecycleState;
+    configuredCeilingPercent: number;
+    installedNativeTokenLimit?: number;
+    installedNativePercent?: number;
+    settingsRevision: number;
+    model: string;
+    latestSample?: ContextSample;
+    frozenActionDigest?: string;
+    providerEventId?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface ActiveRoleAdapterRecord {
+    runId: string;
+    role: "builder" | "qa";
+    providerSessionId?: string;
+    sessionKey?: string;
+    settingsRevision: number;
+    observedAt: string;
+}
 export interface RoleMutationLease {
     runId: string;
     role: "builder" | "qa";
@@ -108,7 +140,8 @@ export declare class WorkflowDb {
         at: string;
     }>;
     recordSettings(runId: string, role: string, boundary: number, settings: ResolvedAgentSettings, now?: Date): void;
-    recordProjectSettingsRevision(revision: number, defaults: unknown, now?: Date): void;
+    recordProjectSettingsRevision(revision: number, defaults: unknown, targetsOrNow?: Readonly<Record<string, readonly string[]>> | Date, now?: Date): void;
+    projectSettingsRevisionTargets(revision: number): Record<string, string[]>;
     recordTelemetry(runId: string, snapshot: unknown, now?: Date): void;
     recordContextSample(sample: ContextSample): void;
     contextSamples(runId: string, role?: "builder" | "qa"): ContextSample[];
@@ -186,14 +219,26 @@ export declare class WorkflowDb {
         sessionKey?: string;
         crossingKey: string;
         beforeSample?: ContextSample;
+        origin?: CompactionAttemptRecord["origin"];
+        providerEventId?: string;
+        thresholdGenerationId?: string;
     }, now?: Date): CompactionAttemptRecord;
     finishCompactionAttempt(idempotencyKey: string, input: {
         ok: boolean;
         afterSample?: ContextSample;
         error?: string;
+        status?: "succeeded" | "failed" | "unverified";
     }, now?: Date): CompactionAttemptRecord;
     compactionAttempt(idempotencyKey: string): CompactionAttemptRecord | undefined;
+    linkCompactionProviderEvent(idempotencyKey: string, providerEventId: string): CompactionAttemptRecord;
+    compactionAttempts(runId: string, role: "builder" | "qa", providerSession?: string | ProviderSessionRefV1): CompactionAttemptRecord[];
     successfulCompactionCount(runId: string, role: "builder" | "qa", providerSession?: string | ProviderSessionRefV1): number;
+    upsertThresholdGeneration(input: Omit<ThresholdGenerationRecord, "createdAt" | "updatedAt">, now?: Date): ThresholdGenerationRecord;
+    thresholdGeneration(generationId: string): ThresholdGenerationRecord | undefined;
+    thresholdGenerations(runId: string, role?: "builder" | "qa", sessionKey?: string): ThresholdGenerationRecord[];
+    markRoleAdapterActive(input: ActiveRoleAdapterRecord): void;
+    clearRoleAdapterActive(runId: string, role: "builder" | "qa", sessionKey?: string): void;
+    activeRoleAdapters(runId?: string, observedAfter?: string): ActiveRoleAdapterRecord[];
     recordRecoveryDecision(receipt: BuildRecoveryDecisionReceipt): void;
     recoveryDecisions(runId: string): BuildRecoveryDecisionReceipt[];
     beginPublication(runId: string, intent: unknown, previousDigests: unknown, now?: Date): PublicationTransaction;

package/dist/workflowDb.js

@@ -109,8 +109,24 @@ export class WorkflowDb {
             this.insertEvent(runId, "settings_boundary", `role:${role}:${boundary}`, { revision: settings.settings_revision }, now.toISOString());
         })();
     }
-    recordProjectSettingsRevision(revision, defaults, now = new Date()) {
-        this.db.prepare("INSERT OR REPLACE INTO project_settings_revisions(revision,defaults_json,created_at) VALUES(?,?,?)").run(revision, json(defaults), now.toISOString());
+    recordProjectSettingsRevision(revision, defaults, targetsOrNow = {}, now = new Date()) {
+        const targets = targetsOrNow instanceof Date ? {} : targetsOrNow;
+        const recordedAt = targetsOrNow instanceof Date ? targetsOrNow : now;
+        this.db.transaction(() => {
+            this.db.prepare(`INSERT INTO project_settings_revisions(revision,defaults_json,created_at) VALUES(?,?,?)
+        ON CONFLICT(revision) DO UPDATE SET defaults_json=excluded.defaults_json,created_at=excluded.created_at`).run(revision, json(defaults), recordedAt.toISOString());
+            const entries = Object.entries(targets);
+            if (entries.length) {
+                this.db.prepare("DELETE FROM project_settings_revision_targets WHERE revision=?").run(revision);
+                const insert = this.db.prepare("INSERT INTO project_settings_revision_targets(revision,role,fields_json) VALUES(?,?,?)");
+                for (const [role, fields] of entries)
+                    insert.run(revision, role, json([...new Set(fields)].sort()));
+            }
+        })();
+    }
+    projectSettingsRevisionTargets(revision) {
+        const rows = this.db.prepare("SELECT role,fields_json FROM project_settings_revision_targets WHERE revision=? ORDER BY role").all(revision);
+        return Object.fromEntries(rows.map((row) => [row.role, parseJson(row.fields_json)]));
     }
     recordTelemetry(runId, snapshot, now = new Date()) {
         this.ensureRun(runId, "build", now);
@@ -153,12 +169,22 @@ export class WorkflowDb {
             this.db.prepare(`INSERT INTO live_settings_acknowledgments(run_id,role,provider_session_id,session_key,session_ref_json,revision,acknowledged_at)
         VALUES(?,?,?,?,?,?,?) ON CONFLICT(run_id,role,revision) DO UPDATE SET provider_session_id=excluded.provider_session_id,session_key=excluded.session_key,session_ref_json=excluded.session_ref_json,acknowledged_at=excluded.acknowledged_at`)
                 .run(ack.runId, ack.role, session.id, session.key, session.refJson, ack.revision, ack.acknowledgedAt);
+            if (session.key) {
+                this.db.prepare(`INSERT INTO live_settings_session_acknowledgments(run_id,role,provider_session_id,session_key,session_ref_json,revision,acknowledged_at)
+          VALUES(?,?,?,?,?,?,?) ON CONFLICT(run_id,role,session_key,revision) DO UPDATE SET provider_session_id=excluded.provider_session_id,session_ref_json=excluded.session_ref_json,acknowledged_at=excluded.acknowledged_at`)
+                    .run(ack.runId, ack.role, session.id, session.key, session.refJson, ack.revision, ack.acknowledgedAt);
+            }
             this.insertEvent(ack.runId, "live_settings_acknowledged", `settings:${ack.revision}`, { role: ack.role, providerSessionId: session.id, sessionKey: session.key }, ack.acknowledgedAt);
         })();
     }
     settingsAcknowledgments(revision) {
-        const rows = this.db.prepare("SELECT * FROM live_settings_acknowledgments WHERE revision=? ORDER BY acknowledged_at").all(revision);
-        return rows.map((row) => ({ runId: row.run_id, role: row.role, ...(row.provider_session_id ? { providerSessionId: row.provider_session_id } : {}), ...(row.session_key ? { sessionKey: row.session_key } : {}), ...(row.session_ref_json ? { sessionRef: parseJson(row.session_ref_json) } : {}), revision: row.revision, acknowledgedAt: row.acknowledged_at }));
+        const scoped = this.db.prepare("SELECT * FROM live_settings_session_acknowledgments WHERE revision=? ORDER BY acknowledged_at").all(revision);
+        const covered = new Set(scoped.map((row) => `${row.run_id}:${row.role}`));
+        const legacy = this.db.prepare("SELECT * FROM live_settings_acknowledgments WHERE revision=? ORDER BY acknowledged_at").all(revision)
+            .filter((row) => !covered.has(`${row.run_id}:${row.role}`));
+        return [...scoped, ...legacy]
+            .sort((left, right) => left.acknowledged_at.localeCompare(right.acknowledged_at))
+            .map((row) => ({ runId: row.run_id, role: row.role, ...(row.provider_session_id ? { providerSessionId: row.provider_session_id } : {}), ...(row.session_key ? { sessionKey: row.session_key } : {}), ...(row.session_ref_json ? { sessionRef: parseJson(row.session_ref_json) } : {}), revision: row.revision, acknowledgedAt: row.acknowledged_at }));
     }
     appendContinuityEvent(input, now = new Date()) {
         this.ensureRun(input.runId, "build", now);
@@ -440,9 +466,17 @@ export class WorkflowDb {
         this.ensureRun(input.runId);
         const at = now.toISOString();
         const session = sessionParts(input.sessionRef, input.providerSessionId, input.sessionKey);
-        this.db.prepare(`INSERT OR IGNORE INTO compaction_attempts(idempotency_key,run_id,role,provider_session_id,session_key,session_ref_json,crossing_key,status,before_sample_json,created_at,updated_at)
-      VALUES(?,?,?,?,?,?,?,'started',?,?,?)`).run(input.idempotencyKey, input.runId, input.role, session.id, session.key, session.refJson, input.crossingKey, input.beforeSample ? json(input.beforeSample) : null, at, at);
-        return this.compactionAttempt(input.idempotencyKey);
+        this.db.prepare(`INSERT OR IGNORE INTO compaction_attempts(idempotency_key,run_id,role,provider_session_id,session_key,session_ref_json,crossing_key,status,before_sample_json,origin,provider_event_id,threshold_generation_id,created_at,updated_at)
+      VALUES(?,?,?,?,?,?,?,'started',?,?,?,?,?,?)`).run(input.idempotencyKey, input.runId, input.role, session.id, session.key, session.refJson, input.crossingKey, input.beforeSample ? json(input.beforeSample) : null, input.origin ?? "rafi-manual", input.providerEventId ?? null, input.thresholdGenerationId ?? null, at, at);
+        const direct = this.compactionAttempt(input.idempotencyKey);
+        if (direct)
+            return direct;
+        if (session.key && input.providerEventId) {
+            const duplicate = this.db.prepare("SELECT * FROM compaction_attempts WHERE run_id=? AND role=? AND session_key=? AND provider_event_id=?").get(input.runId, input.role, session.key, input.providerEventId);
+            if (duplicate)
+                return compactionAttemptFromRow(duplicate);
+        }
+        throw new Error(`failed to persist compaction attempt ${input.idempotencyKey}`);
     }
     finishCompactionAttempt(idempotencyKey, input, now = new Date()) {
         const prior = this.compactionAttempt(idempotencyKey);
@@ -451,23 +485,100 @@ export class WorkflowDb {
         if (prior.status !== "started")
             return prior;
         this.db.prepare("UPDATE compaction_attempts SET status=?,after_sample_json=?,error=?,updated_at=? WHERE idempotency_key=?")
-            .run(input.ok ? "succeeded" : "failed", input.afterSample ? json(input.afterSample) : null, input.error ? sanitizeText(input.error).slice(0, 2000) : null, now.toISOString(), idempotencyKey);
-        this.insertEvent(prior.runId, input.ok ? "compaction_succeeded" : "compaction_failed", `context:${prior.role}`, { idempotencyKey, providerSessionId: prior.providerSessionId, sessionKey: prior.sessionKey, crossingKey: prior.crossingKey }, now.toISOString());
+            .run(input.status ?? (input.ok ? "succeeded" : "failed"), input.afterSample ? json(input.afterSample) : null, input.error ? sanitizeText(input.error).slice(0, 2000) : null, now.toISOString(), idempotencyKey);
+        const status = input.status ?? (input.ok ? "succeeded" : "failed");
+        this.insertEvent(prior.runId, `compaction_${status}`, `context:${prior.role}`, { idempotencyKey, providerSessionId: prior.providerSessionId, sessionKey: prior.sessionKey, crossingKey: prior.crossingKey, origin: prior.origin, providerEventId: prior.providerEventId }, now.toISOString());
         return this.compactionAttempt(idempotencyKey);
     }
     compactionAttempt(idempotencyKey) {
         const row = this.db.prepare("SELECT * FROM compaction_attempts WHERE idempotency_key=?").get(idempotencyKey);
         return row ? compactionAttemptFromRow(row) : undefined;
     }
+    linkCompactionProviderEvent(idempotencyKey, providerEventId) {
+        const prior = this.compactionAttempt(idempotencyKey);
+        if (!prior)
+            throw new Error(`compaction attempt not found: ${idempotencyKey}`);
+        if (prior.providerEventId === providerEventId)
+            return prior;
+        this.db.prepare("UPDATE compaction_attempts SET provider_event_id=?,updated_at=? WHERE idempotency_key=?")
+            .run(providerEventId, new Date().toISOString(), idempotencyKey);
+        return this.compactionAttempt(idempotencyKey);
+    }
+    compactionAttempts(runId, role, providerSession) {
+        if (!providerSession)
+            return [];
+        const session = sessionParts(typeof providerSession === "object" ? providerSession : undefined, typeof providerSession === "string" ? providerSession : undefined);
+        const rows = session.key
+            ? this.db.prepare("SELECT * FROM compaction_attempts WHERE run_id=? AND role=? AND session_key=? ORDER BY created_at,idempotency_key").all(runId, role, session.key)
+            : this.db.prepare("SELECT * FROM compaction_attempts WHERE run_id=? AND role=? AND provider_session_id=? AND session_key IS NULL ORDER BY created_at,idempotency_key").all(runId, role, session.id);
+        return rows.map(compactionAttemptFromRow);
+    }
     successfulCompactionCount(runId, role, providerSession) {
         if (!providerSession)
             return 0;
         const session = sessionParts(typeof providerSession === "object" ? providerSession : undefined, typeof providerSession === "string" ? providerSession : undefined);
         const row = session.key
-            ? this.db.prepare(`SELECT COUNT(*) AS count FROM compaction_attempts WHERE run_id=? AND role=? AND session_key=? AND status='succeeded'`).get(runId, role, session.key)
-            : this.db.prepare(`SELECT COUNT(*) AS count FROM compaction_attempts WHERE run_id=? AND role=? AND provider_session_id=? AND session_key IS NULL AND status='succeeded'`).get(runId, role, session.id);
+            ? this.db.prepare(`SELECT COUNT(*) AS count FROM compaction_attempts WHERE run_id=? AND role=? AND session_key=? AND status IN ('succeeded','unverified')`).get(runId, role, session.key)
+            : this.db.prepare(`SELECT COUNT(*) AS count FROM compaction_attempts WHERE run_id=? AND role=? AND provider_session_id=? AND session_key IS NULL AND status IN ('succeeded','unverified')`).get(runId, role, session.id);
         return row.count;
     }
+    upsertThresholdGeneration(input, now = new Date()) {
+        this.ensureRun(input.runId);
+        const at = now.toISOString();
+        const session = sessionParts(input.sessionRef, input.providerSessionId, input.sessionKey);
+        this.db.prepare(`INSERT INTO threshold_generations(
+      generation_id,run_id,role,provider_session_id,session_key,session_ref_json,generation,state,configured_ceiling_percent,
+      installed_native_token_limit,installed_native_percent,settings_revision,model,latest_sample_json,frozen_action_digest,provider_event_id,created_at,updated_at
+    ) VALUES(?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?)
+    ON CONFLICT(generation_id) DO UPDATE SET
+      provider_session_id=excluded.provider_session_id,session_key=excluded.session_key,session_ref_json=excluded.session_ref_json,
+      state=excluded.state,configured_ceiling_percent=excluded.configured_ceiling_percent,
+      installed_native_token_limit=excluded.installed_native_token_limit,installed_native_percent=excluded.installed_native_percent,
+      settings_revision=excluded.settings_revision,model=excluded.model,latest_sample_json=excluded.latest_sample_json,
+      frozen_action_digest=COALESCE(excluded.frozen_action_digest,threshold_generations.frozen_action_digest),
+      provider_event_id=COALESCE(excluded.provider_event_id,threshold_generations.provider_event_id),updated_at=excluded.updated_at`).run(input.generationId, input.runId, input.role, session.id, session.key, session.refJson, input.generation, input.state, input.configuredCeilingPercent, input.installedNativeTokenLimit ?? null, input.installedNativePercent ?? null, input.settingsRevision, input.model, input.latestSample ? json(input.latestSample) : null, input.frozenActionDigest ?? null, input.providerEventId ?? null, at, at);
+        return this.thresholdGeneration(input.generationId);
+    }
+    thresholdGeneration(generationId) {
+        const row = this.db.prepare("SELECT * FROM threshold_generations WHERE generation_id=?").get(generationId);
+        return row ? thresholdGenerationFromRow(row) : undefined;
+    }
+    thresholdGenerations(runId, role, sessionKey) {
+        const rows = role && sessionKey
+            ? this.db.prepare("SELECT * FROM threshold_generations WHERE run_id=? AND role=? AND session_key=? ORDER BY generation").all(runId, role, sessionKey)
+            : role
+                ? this.db.prepare("SELECT * FROM threshold_generations WHERE run_id=? AND role=? ORDER BY created_at,generation").all(runId, role)
+                : this.db.prepare("SELECT * FROM threshold_generations WHERE run_id=? ORDER BY created_at,generation").all(runId);
+        return rows.map(thresholdGenerationFromRow);
+    }
+    markRoleAdapterActive(input) {
+        this.ensureRun(input.runId);
+        const sessionKey = input.sessionKey ?? `${input.role}:unscoped:${input.providerSessionId ?? "pending"}`;
+        this.db.prepare(`INSERT INTO active_role_adapter_sessions(run_id,role,provider_session_id,session_key,settings_revision,observed_at)
+      VALUES(?,?,?,?,?,?) ON CONFLICT(run_id,role,session_key) DO UPDATE SET provider_session_id=excluded.provider_session_id,settings_revision=excluded.settings_revision,observed_at=excluded.observed_at`)
+            .run(input.runId, input.role, input.providerSessionId ?? null, sessionKey, input.settingsRevision, input.observedAt);
+    }
+    clearRoleAdapterActive(runId, role, sessionKey) {
+        if (sessionKey)
+            this.db.prepare("DELETE FROM active_role_adapter_sessions WHERE run_id=? AND role=? AND session_key=?").run(runId, role, sessionKey);
+        else
+            this.db.prepare("DELETE FROM active_role_adapter_sessions WHERE run_id=? AND role=?").run(runId, role);
+    }
+    activeRoleAdapters(runId, observedAfter) {
+        const clauses = [];
+        const values = [];
+        if (runId) {
+            clauses.push("run_id=?");
+            values.push(runId);
+        }
+        if (observedAfter) {
+            clauses.push("observed_at>=?");
+            values.push(observedAfter);
+        }
+        const where = clauses.length ? ` WHERE ${clauses.join(" AND ")}` : "";
+        const rows = this.db.prepare(`SELECT * FROM active_role_adapter_sessions${where} ORDER BY run_id,role,session_key`).all(...values);
+        return rows.map((row) => ({ runId: row.run_id, role: row.role, ...(row.provider_session_id ? { providerSessionId: row.provider_session_id } : {}), ...(row.session_key ? { sessionKey: row.session_key } : {}), settingsRevision: row.settings_revision, observedAt: row.observed_at }));
+    }
     recordRecoveryDecision(receipt) {
         this.ensureRun(receipt.runId);
         const digest = digestJson(receipt);
@@ -595,6 +706,7 @@ export class WorkflowDb {
       CREATE TABLE IF NOT EXISTS workflow_events(sequence INTEGER PRIMARY KEY AUTOINCREMENT,run_id TEXT NOT NULL REFERENCES workflow_runs(run_id),event_type TEXT NOT NULL,checkpoint TEXT NOT NULL,payload_json TEXT NOT NULL,created_at TEXT NOT NULL);
       CREATE TABLE IF NOT EXISTS role_settings(run_id TEXT NOT NULL REFERENCES workflow_runs(run_id),role TEXT NOT NULL,boundary INTEGER NOT NULL,revision INTEGER NOT NULL,settings_json TEXT NOT NULL,created_at TEXT NOT NULL,PRIMARY KEY(run_id,role,boundary));
       CREATE TABLE IF NOT EXISTS project_settings_revisions(revision INTEGER PRIMARY KEY,defaults_json TEXT NOT NULL,created_at TEXT NOT NULL);
+      CREATE TABLE IF NOT EXISTS project_settings_revision_targets(revision INTEGER NOT NULL REFERENCES project_settings_revisions(revision),role TEXT NOT NULL,fields_json TEXT NOT NULL,PRIMARY KEY(revision,role));
       CREATE TABLE IF NOT EXISTS workflow_telemetry(id INTEGER PRIMARY KEY AUTOINCREMENT,run_id TEXT NOT NULL REFERENCES workflow_runs(run_id),snapshot_json TEXT NOT NULL,created_at TEXT NOT NULL);
       CREATE TABLE IF NOT EXISTS provider_sessions(id INTEGER PRIMARY KEY AUTOINCREMENT,run_id TEXT NOT NULL REFERENCES workflow_runs(run_id),role TEXT NOT NULL,stream TEXT NOT NULL,provider TEXT NOT NULL,model TEXT NOT NULL,session_id TEXT,session_key TEXT,session_ref_json TEXT,transition TEXT NOT NULL,settings_revision INTEGER NOT NULL,created_at TEXT NOT NULL);
       CREATE TABLE IF NOT EXISTS provider_session_bindings(session_key TEXT PRIMARY KEY,provider_session_id TEXT NOT NULL,role TEXT NOT NULL,session_ref_json TEXT NOT NULL,observed_at TEXT NOT NULL);
@@ -607,12 +719,15 @@ export class WorkflowDb {
       CREATE TABLE IF NOT EXISTS context_samples(sample_id INTEGER PRIMARY KEY AUTOINCREMENT,run_id TEXT NOT NULL REFERENCES workflow_runs(run_id),role TEXT NOT NULL,provider_session_id TEXT,session_key TEXT,session_ref_json TEXT,sample_json TEXT NOT NULL,observed_at TEXT NOT NULL);
       CREATE TABLE IF NOT EXISTS session_usage_samples(sample_id INTEGER PRIMARY KEY AUTOINCREMENT,run_id TEXT NOT NULL REFERENCES workflow_runs(run_id),role TEXT NOT NULL,provider_session_id TEXT,session_key TEXT,session_ref_json TEXT,sample_json TEXT NOT NULL,observed_at TEXT NOT NULL);
       CREATE TABLE IF NOT EXISTS live_settings_acknowledgments(run_id TEXT NOT NULL REFERENCES workflow_runs(run_id),role TEXT NOT NULL,provider_session_id TEXT,session_key TEXT,session_ref_json TEXT,revision INTEGER NOT NULL,acknowledged_at TEXT NOT NULL,PRIMARY KEY(run_id,role,revision));
+      CREATE TABLE IF NOT EXISTS live_settings_session_acknowledgments(run_id TEXT NOT NULL REFERENCES workflow_runs(run_id),role TEXT NOT NULL,provider_session_id TEXT,session_key TEXT NOT NULL,session_ref_json TEXT,revision INTEGER NOT NULL,acknowledged_at TEXT NOT NULL,PRIMARY KEY(run_id,role,session_key,revision));
       CREATE TABLE IF NOT EXISTS continuity_events(sequence INTEGER PRIMARY KEY AUTOINCREMENT,run_id TEXT NOT NULL REFERENCES workflow_runs(run_id),role TEXT NOT NULL,kind TEXT NOT NULL,payload_json TEXT NOT NULL,digest TEXT NOT NULL UNIQUE,authoritative_state_revision INTEGER NOT NULL,session_key TEXT,session_ref_json TEXT,created_at TEXT NOT NULL);
       CREATE TABLE IF NOT EXISTS continuity_checkpoints(checkpoint_id INTEGER PRIMARY KEY AUTOINCREMENT,run_id TEXT NOT NULL REFERENCES workflow_runs(run_id),role TEXT NOT NULL,event_sequence INTEGER NOT NULL,state TEXT NOT NULL,delta_json TEXT NOT NULL,digest TEXT NOT NULL UNIQUE,predecessor_digest TEXT,authoritative_state_revision INTEGER NOT NULL,session_key TEXT,session_ref_json TEXT,created_at TEXT NOT NULL);
       CREATE TABLE IF NOT EXISTS continuity_heads(run_id TEXT NOT NULL REFERENCES workflow_runs(run_id),role TEXT NOT NULL,state TEXT NOT NULL,event_sequence INTEGER NOT NULL,digest TEXT NOT NULL,authoritative_state_revision INTEGER NOT NULL,updated_at TEXT NOT NULL,PRIMARY KEY(run_id,role));
       CREATE TABLE IF NOT EXISTS handoffs(run_id TEXT NOT NULL REFERENCES workflow_runs(run_id),generation INTEGER NOT NULL,role TEXT NOT NULL,manifest_digest TEXT NOT NULL,markdown_digest TEXT NOT NULL,predecessor_session_id TEXT,predecessor_session_key TEXT,predecessor_session_ref_json TEXT,successor_session_id TEXT,successor_session_key TEXT,successor_session_ref_json TEXT,state TEXT NOT NULL,failure TEXT,created_at TEXT NOT NULL,accepted_at TEXT,PRIMARY KEY(run_id,generation));
       CREATE TABLE IF NOT EXISTS role_mutation_leases(run_id TEXT NOT NULL REFERENCES workflow_runs(run_id),role TEXT NOT NULL,generation INTEGER NOT NULL,provider_session_id TEXT NOT NULL,provider_session_key TEXT,provider_session_ref_json TEXT,moved_at TEXT NOT NULL,PRIMARY KEY(run_id,role));
-      CREATE TABLE IF NOT EXISTS compaction_attempts(idempotency_key TEXT PRIMARY KEY,run_id TEXT NOT NULL REFERENCES workflow_runs(run_id),role TEXT NOT NULL,provider_session_id TEXT,session_key TEXT,session_ref_json TEXT,crossing_key TEXT NOT NULL,status TEXT NOT NULL,before_sample_json TEXT,after_sample_json TEXT,error TEXT,created_at TEXT NOT NULL,updated_at TEXT NOT NULL);
+      CREATE TABLE IF NOT EXISTS compaction_attempts(idempotency_key TEXT PRIMARY KEY,run_id TEXT NOT NULL REFERENCES workflow_runs(run_id),role TEXT NOT NULL,provider_session_id TEXT,session_key TEXT,session_ref_json TEXT,crossing_key TEXT NOT NULL,status TEXT NOT NULL,before_sample_json TEXT,after_sample_json TEXT,error TEXT,origin TEXT NOT NULL DEFAULT 'rafi-manual',provider_event_id TEXT,threshold_generation_id TEXT,created_at TEXT NOT NULL,updated_at TEXT NOT NULL);
+      CREATE TABLE IF NOT EXISTS threshold_generations(generation_id TEXT PRIMARY KEY,run_id TEXT NOT NULL REFERENCES workflow_runs(run_id),role TEXT NOT NULL,provider_session_id TEXT,session_key TEXT,session_ref_json TEXT,generation INTEGER NOT NULL,state TEXT NOT NULL,configured_ceiling_percent REAL NOT NULL,installed_native_token_limit INTEGER,installed_native_percent REAL,settings_revision INTEGER NOT NULL,model TEXT NOT NULL,latest_sample_json TEXT,frozen_action_digest TEXT,provider_event_id TEXT,created_at TEXT NOT NULL,updated_at TEXT NOT NULL,UNIQUE(run_id,role,session_key,generation));
+      CREATE TABLE IF NOT EXISTS active_role_adapter_sessions(run_id TEXT NOT NULL REFERENCES workflow_runs(run_id),role TEXT NOT NULL,provider_session_id TEXT,session_key TEXT NOT NULL,settings_revision INTEGER NOT NULL,observed_at TEXT NOT NULL,PRIMARY KEY(run_id,role,session_key));
       CREATE TABLE IF NOT EXISTS recovery_decisions(decision_id INTEGER PRIMARY KEY AUTOINCREMENT,run_id TEXT NOT NULL REFERENCES workflow_runs(run_id),decided_at TEXT NOT NULL,mode TEXT NOT NULL,digest TEXT NOT NULL UNIQUE,session_key TEXT,session_ref_json TEXT,receipt_json TEXT NOT NULL);
       CREATE INDEX IF NOT EXISTS workflow_events_run ON workflow_events(run_id,sequence);
       CREATE INDEX IF NOT EXISTS operations_run ON operation_journal(run_id,status);
@@ -630,7 +745,7 @@ export class WorkflowDb {
             continuity_checkpoints: { session_key: "TEXT", session_ref_json: "TEXT" },
             handoffs: { predecessor_session_key: "TEXT", predecessor_session_ref_json: "TEXT", successor_session_key: "TEXT", successor_session_ref_json: "TEXT" },
             role_mutation_leases: { provider_session_key: "TEXT", provider_session_ref_json: "TEXT" },
-            compaction_attempts: { session_key: "TEXT", session_ref_json: "TEXT" },
+            compaction_attempts: { session_key: "TEXT", session_ref_json: "TEXT", origin: "TEXT NOT NULL DEFAULT 'rafi-manual'", provider_event_id: "TEXT", threshold_generation_id: "TEXT" },
             recovery_decisions: { session_key: "TEXT", session_ref_json: "TEXT" },
         })) {
             for (const [column, definition] of Object.entries(columns))
@@ -642,6 +757,10 @@ export class WorkflowDb {
       CREATE INDEX IF NOT EXISTS context_samples_scoped ON context_samples(run_id,role,session_key,sample_id);
       CREATE INDEX IF NOT EXISTS session_usage_scoped ON session_usage_samples(run_id,role,session_key,sample_id);
       CREATE INDEX IF NOT EXISTS compaction_session_scoped ON compaction_attempts(run_id,role,session_key,status);
+      CREATE UNIQUE INDEX IF NOT EXISTS compaction_native_event_unique ON compaction_attempts(run_id,role,session_key,provider_event_id) WHERE provider_event_id IS NOT NULL;
+      CREATE INDEX IF NOT EXISTS threshold_generation_scoped ON threshold_generations(run_id,role,session_key,generation);
+      CREATE INDEX IF NOT EXISTS active_role_adapter_session_observed ON active_role_adapter_sessions(observed_at,run_id,role);
+      CREATE INDEX IF NOT EXISTS live_settings_session_revision ON live_settings_session_acknowledgments(revision,run_id,role,session_key);
     `);
     }
     ensureColumn(table, column, definition) {
@@ -656,7 +775,23 @@ function continuityEventFromRow(row) { return { sequence: row.sequence, runId: r
 function continuityCheckpointFromRow(row) { return { checkpointId: row.checkpoint_id, runId: row.run_id, role: row.role, sequence: row.event_sequence, state: row.state, delta: parseJson(row.delta_json), digest: row.digest, ...(row.predecessor_digest ? { predecessorDigest: row.predecessor_digest } : {}), authoritativeStateRevision: row.authoritative_state_revision, createdAt: row.created_at, ...(row.session_key ? { sessionKey: row.session_key } : {}), ...(row.session_ref_json ? { sessionRef: parseJson(row.session_ref_json) } : {}) }; }
 function continuityHeadFromRow(row) { return { runId: row.run_id, role: row.role, state: row.state, sequence: row.event_sequence, digest: row.digest, authoritativeStateRevision: row.authoritative_state_revision, updatedAt: row.updated_at }; }
 function handoffFromRow(row) { return { runId: row.run_id, generation: row.generation, manifestDigest: row.manifest_digest, markdownDigest: row.markdown_digest, ...(row.predecessor_session_id ? { predecessorSessionId: row.predecessor_session_id } : {}), ...(row.predecessor_session_ref_json ? { predecessorSessionRef: parseJson(row.predecessor_session_ref_json) } : {}), ...(row.successor_session_id ? { successorSessionId: row.successor_session_id } : {}), ...(row.successor_session_ref_json ? { successorSessionRef: parseJson(row.successor_session_ref_json) } : {}), state: row.state, createdAt: row.created_at, ...(row.accepted_at ? { acceptedAt: row.accepted_at } : {}) }; }
-function compactionAttemptFromRow(row) { return { idempotencyKey: row.idempotency_key, runId: row.run_id, role: row.role, ...(row.provider_session_id ? { providerSessionId: row.provider_session_id } : {}), ...(row.session_key ? { sessionKey: row.session_key } : {}), ...(row.session_ref_json ? { sessionRef: parseJson(row.session_ref_json) } : {}), crossingKey: row.crossing_key, status: row.status, ...(row.before_sample_json ? { beforeSample: parseJson(row.before_sample_json) } : {}), ...(row.after_sample_json ? { afterSample: parseJson(row.after_sample_json) } : {}), ...(row.error ? { error: row.error } : {}), createdAt: row.created_at, updatedAt: row.updated_at }; }
+function compactionAttemptFromRow(row) { return { idempotencyKey: row.idempotency_key, runId: row.run_id, role: row.role, ...(row.provider_session_id ? { providerSessionId: row.provider_session_id } : {}), ...(row.session_key ? { sessionKey: row.session_key } : {}), ...(row.session_ref_json ? { sessionRef: parseJson(row.session_ref_json) } : {}), crossingKey: row.crossing_key, status: row.status, origin: row.origin ?? "rafi-manual", ...(row.provider_event_id ? { providerEventId: row.provider_event_id } : {}), ...(row.threshold_generation_id ? { thresholdGenerationId: row.threshold_generation_id } : {}), ...(row.before_sample_json ? { beforeSample: parseJson(row.before_sample_json) } : {}), ...(row.after_sample_json ? { afterSample: parseJson(row.after_sample_json) } : {}), ...(row.error ? { error: row.error } : {}), createdAt: row.created_at, updatedAt: row.updated_at }; }
+function thresholdGenerationFromRow(row) {
+    return {
+        generationId: row.generation_id, runId: row.run_id, role: row.role,
+        ...(row.provider_session_id ? { providerSessionId: row.provider_session_id } : {}),
+        ...(row.session_key ? { sessionKey: row.session_key } : {}),
+        ...(row.session_ref_json ? { sessionRef: parseJson(row.session_ref_json) } : {}),
+        generation: row.generation, state: row.state, configuredCeilingPercent: row.configured_ceiling_percent,
+        ...(row.installed_native_token_limit === null ? {} : { installedNativeTokenLimit: row.installed_native_token_limit }),
+        ...(row.installed_native_percent === null ? {} : { installedNativePercent: row.installed_native_percent }),
+        settingsRevision: row.settings_revision, model: row.model,
+        ...(row.latest_sample_json ? { latestSample: parseJson(row.latest_sample_json) } : {}),
+        ...(row.frozen_action_digest ? { frozenActionDigest: row.frozen_action_digest } : {}),
+        ...(row.provider_event_id ? { providerEventId: row.provider_event_id } : {}),
+        createdAt: row.created_at, updatedAt: row.updated_at,
+    };
+}
 function json(value) { return JSON.stringify(value ?? null); }
 function parseJson(value) { return JSON.parse(value); }
 function sessionParts(ref, rawId, suppliedKey) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-foreman",
-  "version": "1.7.7",
+  "version": "1.7.8",
   "description": "An orchestrator that keeps Codex CLI / Claude Code builders moving through their step list unattended. Part of Rafi.",
   "license": "Apache-2.0",
   "type": "module",
@@ -137,7 +137,7 @@
     "dev": "tsx src/index.ts",
     "test": "tsx --test test/*.test.ts",
     "typecheck": "tsc --noEmit",
-    "test:live-providers": "RAFI_LIVE_PROVIDER_SESSIONS=1 tsx --test test/providerSmoke.test.ts",
+    "test:live-providers": "RAFI_LIVE_PROVIDER_SESSIONS=1 tsx --test --test-concurrency=1 test/providerSmoke.test.ts test/providerContextAcceptance.test.ts",
     "prepublishOnly": "pnpm build && pnpm test && pnpm typecheck"
   },
   "keywords": [
@@ -158,8 +158,8 @@
     "@anthropic-ai/claude-agent-sdk": "^0.3.148"
   },
   "dependencies": {
-    "special-agents": "0.8.5",
-    "rafi-spec": "0.8.5",
+    "special-agents": "0.8.6",
+    "rafi-spec": "0.8.6",
     "@clack/prompts": "^1.4.0",
     "ajv": "^8.20.0",
     "ajv-formats": "^3.0.1",