@dsh-enhanced/assistant-evolution 0.1.7 → 0.1.12

package/lib/service.js

@@ -1,14 +1,15 @@
-import { createHash } from 'node:crypto';
+import { createHash, randomUUID } from 'node:crypto';
 import { isAbsolute, resolve } from 'node:path';
 import { Context, Service } from '@deepseek-ai/cordis';
 import { createUserMessage } from '@deepseek-ai/dsh-llm';
 import Schema from '@deepseek-ai/schemastery';
+import { canonicalEvaluationHostScope, evaluationLearningProjectionDigest, } from '@dsh-enhanced/assistant-evaluation';
 import { ApprovalSettlementConflict, validateApprovalSettlement, } from '@dsh-enhanced/assistant-policy';
 import { buildGuidance, buildGuidanceSnapshot } from './guidance.js';
 import { evolutionMutationReview } from './review.js';
-import { EvolutionStore, EvolutionStoreError, evolutionDigest } from './store.js';
+import { EvolutionStore, EvolutionStoreError, evolutionDigest, supervisedGrowthAnalystProposalIdempotencyKey, } from './store.js';
 import { registerEvolutionTools } from './tools.js';
-import { legacyEvolutionScope } from './types.js';
+import { legacyEvolutionScope, SUPERVISED_GROWTH_ANALYST_CONTRACT_VERSION, } from './types.js';
 const configSchema = Schema.object({
     databasePath: Schema.string().required(),
     evaluationWindow: Schema.number().step(1).min(1).max(10_000).default(20),
@@ -26,6 +27,17 @@ const configSchema = Schema.object({
     autonomousRollback: Schema.boolean().default(false),
 });
 const evolutionApprovalSource = 'dsh-enhanced-assistant-evolution';
+function registrationOwnedByDeliveryPresentation(registration) {
+    const candidate = registration;
+    try {
+        return typeof candidate.owner === 'object' && candidate.owner !== null
+            && typeof candidate.owner.ownsTrustedDeliveryPresentationRegistration === 'function'
+            && candidate.owner.ownsTrustedDeliveryPresentationRegistration(registration);
+    }
+    catch {
+        return false;
+    }
+}
 export class AssistantEvolutionError extends Error {
     code;
     constructor(code, message) {
@@ -34,6 +46,51 @@ export class AssistantEvolutionError extends Error {
         this.name = 'AssistantEvolutionError';
     }
 }
+/** Fixed Policy subject used by the non-model supervised-growth runbook. */
+export const HOST_RECOVERY_BACKGROUND_ID = 'dsh-enhanced-assistant-recovery';
+/** The only Automation allowed to use the model-visible analyst capability. */
+export const SUPERVISED_GROWTH_ANALYST_AUTOMATION_ID = 'heartbeat:supervised-growth-analyst';
+const evolutionHostScopeBrand = Symbol('assistant-evolution.host-scope');
+/** Canonical, immutable and intentionally non-serializable Host scope token. */
+export function canonicalEvolutionHostScope(input) {
+    const scopeKey = canonicalEvolutionScope(input.workspace, input.preset);
+    const [workspace, preset] = JSON.parse(scopeKey);
+    const branded = { workspace, preset };
+    Object.defineProperty(branded, evolutionHostScopeBrand, {
+        value: true, enumerable: false, configurable: false, writable: false,
+    });
+    return Object.freeze(branded);
+}
+function exactEvolutionHostScope(input) {
+    if (typeof input !== 'object' || input === null || !Object.isFrozen(input)
+        || input[evolutionHostScopeBrand] !== true) {
+        throw new AssistantEvolutionError('invalid-input', 'Host evolution operations require a canonical immutable scope');
+    }
+    const canonical = canonicalEvolutionHostScope(input);
+    if (canonical.workspace !== input.workspace || canonical.preset !== input.preset) {
+        throw new AssistantEvolutionError('invalid-input', 'Host evolution scope is not canonical');
+    }
+    return input;
+}
+function hostText(value, label, maxBytes) {
+    if (typeof value !== 'string') {
+        throw new AssistantEvolutionError('invalid-input', `${label} must be a string`);
+    }
+    const normalized = value.normalize('NFC').trim();
+    if (normalized === '' || Buffer.byteLength(normalized, 'utf8') > maxBytes
+        || hasControl(normalized)) {
+        throw new AssistantEvolutionError('invalid-input', `${label} is invalid`);
+    }
+    return normalized;
+}
+function hasControl(value) {
+    for (const character of value) {
+        const codePoint = character.codePointAt(0);
+        if (codePoint <= 0x1f || codePoint === 0x7f)
+            return true;
+    }
+    return false;
+}
 export function canonicalEvolutionScope(workspace, preset) {
     const normalizedPreset = preset.normalize('NFC').trim();
     if (!isAbsolute(workspace) || normalizedPreset === '') {
@@ -76,13 +133,15 @@ function ruleIdFromStableMutation(stable) {
  */
 export class AssistantEvolutionService extends Service {
     static Config = configSchema;
-    static inject = ['assistantPolicy'];
+    static inject = ['assistantPolicy', 'assistantEvaluation'];
     store;
     policy;
+    context;
     config;
-    injected = new WeakSet();
     now;
     delivery;
+    presentationProducerGeneration = `assistant-evolution-presentation:${randomUUID()}`;
+    presentationSink;
     active = true;
     lastReconciledAt = 0;
     constructor(ctx, input, options = {}) {
@@ -96,6 +155,7 @@ export class AssistantEvolutionService extends Service {
         const policy = ctx.get('assistantPolicy');
         if (policy === undefined)
             throw new Error('assistant-evolution: assistantPolicy service is required');
+        this.context = ctx;
         this.policy = policy;
         this.now = options.now ?? Date.now;
         this.store = new EvolutionStore({
@@ -105,6 +165,7 @@ export class AssistantEvolutionService extends Service {
         ctx.inject(['assistantDelivery'], deliveryCtx => {
             const delivery = deliveryCtx.get('assistantDelivery');
             this.delivery = delivery;
+            this.reconcileApplicationPresentations();
             return () => {
                 if (this.delivery === delivery)
                     this.delivery = undefined;
@@ -124,6 +185,7 @@ export class AssistantEvolutionService extends Service {
         });
         ctx.effect(() => () => {
             this.active = false;
+            this.presentationSink?.dispose();
             this.store.close();
         }, 'assistant-evolution.database');
         if (this.config.reconcileIntervalMs > 0) {
@@ -149,7 +211,47 @@ export class AssistantEvolutionService extends Service {
             lastReconciledAt: this.lastReconciledAt,
         });
     }
-    /** Record one observed outcome as evidence. */
+    trustedDeliveryPresentationProducerGeneration() {
+        this.assertActive();
+        return this.presentationProducerGeneration;
+    }
+    /**
+     * Accept only the publisher minted by the exact live Delivery instance.
+     * The registration is held privately; it is never surfaced to an Agent,
+     * tool schema, proposal payload, or Evolution read API.
+     */
+    registerTrustedDeliveryPresentationSink(registration) {
+        this.assertActive();
+        if (registration.protocol !== 'assistant-delivery/trusted-presentation-producer/v1'
+            || registration.producer !== 'assistant-evolution'
+            || registration.generation !== this.presentationProducerGeneration
+            || typeof registration.publish !== 'function'
+            || !registrationOwnedByDeliveryPresentation(registration)) {
+            throw new AssistantEvolutionError('forbidden', 'trusted Delivery presentation registration is invalid');
+        }
+        const current = this.presentationSink;
+        if (current !== undefined) {
+            if (current.registration === registration)
+                return current.dispose;
+            throw new AssistantEvolutionError('forbidden', 'trusted Delivery presentation sink is already registered');
+        }
+        const token = Symbol('assistant-evolution.trusted-delivery-presentation');
+        let live = true;
+        const dispose = () => {
+            if (!live)
+                return;
+            live = false;
+            if (this.presentationSink?.token === token)
+                this.presentationSink = undefined;
+        };
+        this.presentationSink = Object.freeze({ token, registration, dispose });
+        // Existing durable terminal receipts become eligible as soon as their
+        // exact Delivery publisher appears; the local outbox remains authoritative
+        // if Delivery rejects or later revokes this generation.
+        this.reconcileApplicationPresentations();
+        return dispose;
+    }
+    /** Record one model-reported outcome as learning-ineligible operational audit. */
     recordEpisode(agent, input) {
         const scopeKey = this.authorize(agent, 'append', `situation:${input.situation}`);
         return this.store.recordEpisode({
@@ -159,14 +261,17 @@ export class AssistantEvolutionService extends Service {
             detail: input.detail,
             source: 'foreground',
             trust: 'self-reported',
+            evidenceKind: 'operational',
             ...(input.ruleId === undefined ? {} : { claimedRuleId: input.ruleId }),
             occurredAt: input.occurredAt,
             idempotencyKey: input.idempotencyKey,
         });
     }
     /**
-     * Record an outcome observed by trusted local infrastructure rather than a model
-     * turn, for example a finished background automation run.
+     * Record an execution outcome observed by trusted local infrastructure rather
+     * than a model turn, for example a finished background automation run. It is
+     * deliberately operational and learning-ineligible: execution success/failure
+     * does not establish objective task quality.
      *
      * There is no Agent to authorize here, so this is deliberately narrow: it can
      * only append evidence. It cannot adopt, retire, or read rules, so an automation
@@ -200,11 +305,96 @@ export class AssistantEvolutionService extends Service {
             scopeKey,
             source: 'automation',
             trust: trusted ? 'trusted' : 'legacy',
+            evidenceKind: trusted ? 'operational' : 'legacy-unknown',
             ...(attributed
                 ? { ruleId: receipt.ruleId, guidanceVersion: receipt.guidanceVersion }
                 : input.ruleId === undefined ? {} : { claimedRuleId: input.ruleId }),
         });
     }
+    /**
+     * Deprecated unsafe v5 shape. Free caller-supplied quality fields can never
+     * produce learning-eligible evidence again; use projectEvaluationOutcome().
+     */
+    recordEvaluationOutcome(input) {
+        this.assertActive();
+        void input;
+        throw new AssistantEvolutionError('forbidden', 'free-form Evaluation projection is disabled; use projectEvaluationOutcome with an authoritative receipt');
+    }
+    /**
+     * Project one exact trusted Evaluation row into the learning ledger. The
+     * caller cannot supply outcome, detail, kind, time, situation or attribution.
+     */
+    projectEvaluationOutcome(input) {
+        this.assertActive();
+        if (typeof input !== 'object' || input === null || Array.isArray(input)
+            || Object.keys(input).sort().join(',') !== 'evaluationId,scope') {
+            throw new AssistantEvolutionError('invalid-input', 'Evaluation projection accepts only an exact scope and evaluationId');
+        }
+        const scope = exactEvolutionHostScope(input.scope);
+        const evaluationId = hostText(input.evaluationId, 'evaluationId', 200);
+        const receipt = this.trustedTaskLearningReceipt(scope, evaluationId);
+        const projected = this.applyTrustedTaskLearningReceipt(scope, receipt);
+        if (projected.episode === undefined) {
+            throw new AssistantEvolutionError('forbidden', 'the canonical task revision retracts rather than upserts a behavioural learning vote');
+        }
+        return projected.episode;
+    }
+    /**
+     * Narrow structural seam used only by Evaluation's durable outbox. The raw
+     * scope is canonicalized here; quality fields are still fetched exclusively
+     * from the trusted Evaluation ledger.
+     */
+    projectTrustedEvaluationOutcome(_input) {
+        this.assertActive();
+        throw new AssistantEvolutionError('forbidden', 'raw Evaluation projection protocol is retired; use the versioned task-revision capability');
+    }
+    /** Evaluation protocol v2 sink. Every success echoes the exact applied revision. */
+    projectTrustedEvaluationTaskRevision(input) {
+        this.assertActive();
+        if (typeof input !== 'object' || input === null || Array.isArray(input)
+            || Object.keys(input).sort().join(',') !== 'evaluationId,scope'
+            || typeof input.scope !== 'object' || input.scope === null || Array.isArray(input.scope)
+            || Object.keys(input.scope).sort().join(',') !== 'preset,workspace') {
+            throw new AssistantEvolutionError('invalid-input', 'trusted Evaluation projection input is invalid');
+        }
+        const evaluationId = hostText(input.evaluationId, 'evaluationId', 200);
+        const scope = canonicalEvolutionHostScope(input.scope);
+        const receipt = this.trustedTaskLearningReceipt(scope, evaluationId);
+        const projected = this.applyTrustedTaskLearningReceipt(scope, receipt);
+        return Object.freeze({
+            triggerOutcomeId: evaluationId,
+            subjectKind: receipt.projection.subjectKind,
+            subjectRef: receipt.projection.subjectRef,
+            version: receipt.projection.version,
+            digest: receipt.projection.digest,
+            scopeWatermark: receipt.scopeWatermark,
+            disposition: receipt.projection.disposition,
+            status: projected.replayed ? 'replayed' : 'applied',
+        });
+    }
+    /**
+     * Called by Assistant Automations only after it installed the immutable
+     * production execution context and bound the Policy initiator. This closes
+     * the session-start ordering gap without weakening background Policy.
+     */
+    injectAutomationGuidance(agent, execution) {
+        this.assertActive();
+        const current = agent.ctx
+            .get('assistantAutomationExecution');
+        const installed = current;
+        if (typeof current !== 'object' || current === null || Array.isArray(current)
+            || Object.keys(current).sort().join(',') !== 'automationId,mode,occurrenceId'
+            || installed?.mode !== execution.mode
+            || installed.automationId !== execution.automationId
+            || installed.occurrenceId !== execution.occurrenceId
+            || Object.keys(execution).sort().join(',') !== 'automationId,mode,occurrenceId'
+            || execution.mode !== 'production'
+            || hostText(execution.automationId, 'automationId', 500) !== execution.automationId
+            || hostText(execution.occurrenceId, 'occurrenceId', 500) !== execution.occurrenceId) {
+            throw new AssistantEvolutionError('forbidden', 'automation guidance requires the exact installed production execution context');
+        }
+        this.injectGuidance(agent);
+    }
     /** Query an exact post-injection receipt for trusted automation attribution. */
     async captureAutomationExposure(input) {
         this.assertActive();
@@ -221,20 +411,151 @@ export class AssistantEvolutionService extends Service {
     /** Candidate rule changes implied by current evidence. Never auto-applied. */
     candidates(agent) {
         const scopeKey = this.authorize(agent, 'inspect', 'candidates');
-        return this.store.candidates({
-            scopeKey,
-            window: this.config.evaluationWindow,
-            minSample: this.config.minSample,
-            adoptFailureRate: this.config.adoptFailureRate,
-            retireFailureRate: this.config.retireFailureRate,
-            limit: this.config.maxCandidates,
-            evidenceSampleLimit: this.config.maxEvidenceSamples,
+        return this.candidatesForScope(scopeKey);
+    }
+    /** Agent-free, exact-scope candidate inspection for the fixed Host runbook. */
+    hostCandidates(input) {
+        const scopeKey = this.authorizeHost(input, 'inspect', 'candidates');
+        return this.candidatesForScope(scopeKey);
+    }
+    /**
+     * Review exactly one adoption candidate from the dedicated production
+     * analyst. The random review token is durable and bound to this occurrence;
+     * no foreground or preview session can obtain one.
+     */
+    reviewSupervisedGrowthAdoption(agent) {
+        const execution = this.authorizeSupervisedGrowthAnalyst(agent, 'inspect', 'analyst-adoption');
+        // Even review requires the route that a later proposal will use. This
+        // prevents an analyst with no owner destination from minting stale tokens.
+        this.approvalRoute(agent, undefined);
+        const candidate = this.candidatesForScope(execution.scopeKey)
+            .filter(entry => entry.kind === 'adopt')
+            .sort((left, right) => {
+            const rateOrder = right.stats.failures * left.stats.total
+                - left.stats.failures * right.stats.total;
+            return rateOrder || right.stats.failures - left.stats.failures
+                || right.stats.total - left.stats.total
+                || left.situation.localeCompare(right.situation);
+        })[0];
+        if (candidate === undefined) {
+            return Object.freeze({ contractVersion: SUPERVISED_GROWTH_ANALYST_CONTRACT_VERSION });
+        }
+        const frozen = this.store.registerSupervisedGrowthAnalystReview({
+            scopeKey: execution.scopeKey,
+            occurrenceId: execution.occurrenceId,
+            candidate,
+            evidenceWindow: this.config.evaluationWindow,
+        });
+        return Object.freeze({
+            contractVersion: SUPERVISED_GROWTH_ANALYST_CONTRACT_VERSION,
+            candidate: Object.freeze({
+                ...frozen.review.evidence,
+                reviewToken: frozen.review.reviewToken,
+                proposalExists: frozen.proposalExists,
+            }),
+        });
+    }
+    /**
+     * Turn one frozen analyst review into the normal owner approval. Identity is
+     * evidence-derived; wording changes and concurrent executions join the first
+     * durable proposal instead of producing several cards.
+     */
+    proposeSupervisedGrowthAdoption(agent, input) {
+        if (typeof input !== 'object' || input === null || Array.isArray(input)
+            || Object.keys(input).sort().join(',') !== 'guidance,reviewToken') {
+            throw new AssistantEvolutionError('invalid-input', 'analyst proposal accepts only reviewToken and guidance');
+        }
+        const execution = this.authorizeSupervisedGrowthAnalyst(agent, 'propose', 'proposals');
+        const route = this.approvalRoute(agent, undefined);
+        const reviewToken = hostText(input.reviewToken, 'reviewToken', 200);
+        const review = this.store.getSupervisedGrowthAnalystReview(reviewToken);
+        if (review === undefined || review.scopeKey !== execution.scopeKey
+            || review.occurrenceId !== execution.occurrenceId) {
+            throw new AssistantEvolutionError('not-found', 'analyst review token does not belong to this production execution');
+        }
+        const evidence = review.evidence;
+        if (evidence.contractVersion !== SUPERVISED_GROWTH_ANALYST_CONTRACT_VERSION
+            || evidence.total < this.config.minSample
+            || evidence.failures / evidence.total < this.config.adoptFailureRate) {
+            throw new AssistantEvolutionError('forbidden', 'analyst review no longer satisfies adoption thresholds');
+        }
+        const idempotencyKey = supervisedGrowthAnalystProposalIdempotencyKey({
+            scopeKey: execution.scopeKey,
+            situation: evidence.situation,
+            evidenceDigest: evidence.evidenceDigest,
+            evidenceTotal: evidence.evidenceTotal,
+            contractVersion: evidence.contractVersion,
         });
+        const ruleId = ruleIdFromStableMutation(evolutionDigest([
+            'supervised-growth-analyst-rule/v1',
+            idempotencyKey,
+        ]));
+        const mutation = {
+            op: 'adopt',
+            ruleId,
+            input: {
+                scopeKey: execution.scopeKey,
+                situation: evidence.situation,
+                guidance: input.guidance,
+            },
+            baseline: {
+                scopeKey: execution.scopeKey,
+                situation: evidence.situation,
+                failures: evidence.failures,
+                total: evidence.total,
+            },
+            evidence: {
+                sampleEpisodeIds: evidence.sampleEpisodeIds,
+                digest: evidence.evidenceDigest,
+                total: evidence.evidenceTotal,
+                window: evidence.evidenceWindow,
+                scopeWatermark: evidence.scopeWatermark,
+                taskRevisions: evidence.taskRevisions,
+            },
+        };
+        const ttlMs = this.config.defaultProposalTtlMs;
+        const requester = `automation:${SUPERVISED_GROWTH_ANALYST_AUTOMATION_ID}`;
+        const reviewPresentation = evolutionMutationReview(mutation);
+        const creationIntent = {
+            idempotencyKey,
+            requester,
+            principal: route.principal,
+            action: reviewPresentation.action,
+            resource: reviewPresentation.resource,
+            diff: reviewPresentation.diff,
+            summary: reviewPresentation.summary,
+            ttlMs,
+            ...(route.dispatch === undefined ? {} : { dispatch: route.dispatch }),
+        };
+        const local = this.withLearningWriterFence(mutation, () => (this.store.createSupervisedGrowthAnalystProposal({
+            reviewToken,
+            scopeKey: execution.scopeKey,
+            occurrenceId: execution.occurrenceId,
+            requester,
+            principal: route.principal,
+            mutation,
+            expiresAt: Date.now() + ttlMs,
+            creationIntent,
+        })));
+        if (local.proposal.policyProposalId !== undefined) {
+            if (local.proposal.status !== 'pending') {
+                return result(local.proposal, true, local.proposal.resultRuleId === undefined
+                    ? undefined
+                    : this.store.getRule(local.proposal.resultRuleId));
+            }
+            return this.settleAttached(local.proposal, true) ?? result(local.proposal, true);
+        }
+        return this.submitLocalProposal(local.proposal, local.replayed);
     }
     listRules(agent, status) {
         const scopeKey = this.authorize(agent, 'inspect', 'rules');
         return this.store.listRules(scopeKey, status);
     }
+    /** Agent-free, exact-scope rule inspection for the fixed Host runbook. */
+    hostListRules(input) {
+        const scopeKey = this.authorizeHost(input, 'inspect', `rules:${input.status ?? 'all'}`);
+        return this.store.listRules(scopeKey, input.status);
+    }
     /**
      * Remove one exact active guidance generation through the opt-in low-risk lane.
      *
@@ -243,11 +564,42 @@ export class AssistantEvolutionService extends Service {
      * delegates the evidence/risk/reason decision to one transactional Host path.
      */
     rollback(agent, input) {
+        const normalized = this.normalizedRollbackInput(input);
+        const scopeKey = this.authorize(agent, 'rollback', `rule:${normalized.ruleId}`);
+        return this.rollbackForScope(scopeKey, normalized);
+    }
+    /**
+     * Retire one exact active rule by CAS. The Store admits only quality-eligible
+     * objective/verification evidence attributed to an exact exposure receipt;
+     * operational automation outcomes cannot satisfy this lane.
+     */
+    hostRollbackOne(input) {
+        const normalized = this.normalizedRollbackInput(input);
+        const scopeKey = this.authorizeHost(input, 'rollback', `rule:${normalized.ruleId}`);
+        return this.rollbackForScope(scopeKey, normalized);
+    }
+    /**
+     * Ask the authenticated owner to remove one exact active guidance version.
+     *
+     * This is intentionally a proposal, not a direct rollback: the current Agent
+     * supplies the exact workspace/preset scope, Delivery supplies the owner
+     * principal, and Policy freezes a distinct `evolution.owner-undo` review
+     * tuple. Approval can only retire the rule; it cannot revise its guidance or
+     * grant authority. No regression sample is required because the owner is the
+     * authority withdrawing their own earlier approval.
+     */
+    requestOwnerUndo(agent, input) {
         this.assertActive();
-        if (!this.config.autonomousRollback) {
-            throw new AssistantEvolutionError('forbidden', 'autonomous evolution rollback is disabled');
+        if (typeof input !== 'object' || input === null || Array.isArray(input)) {
+            throw new AssistantEvolutionError('invalid-input', 'owner undo input must be an object');
+        }
+        const keys = Object.keys(input).sort().join(',');
+        if (keys !== 'expectedVersion,operationId,ruleId'
+            && keys !== 'expectedVersion,operationId,ruleId,ttlMs') {
+            throw new AssistantEvolutionError('invalid-input', 'owner undo accepts only ruleId, expectedVersion, operationId, and optional ttlMs');
         }
-        const ruleId = input.ruleId.normalize('NFC').trim();
+        const scopeKey = this.authorize(agent, 'propose', 'proposals');
+        const ruleId = hostText(input.ruleId, 'ruleId', 200);
         if (!/^rule-[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/u
             .test(ruleId)) {
             throw new AssistantEvolutionError('invalid-input', 'ruleId must be an immutable server-issued rule ID');
@@ -256,16 +608,73 @@ export class AssistantEvolutionService extends Service {
             || input.expectedVersion > 1_000_000_000) {
             throw new AssistantEvolutionError('invalid-input', 'expectedVersion must be a positive safe integer');
         }
-        const scopeKey = this.authorize(agent, 'rollback', `rule:${ruleId}`);
-        return this.store.rollbackRule({
+        const operationId = hostText(input.operationId, 'operationId', 500);
+        const ttlMs = input.ttlMs ?? this.config.defaultProposalTtlMs;
+        if (!Number.isSafeInteger(ttlMs) || ttlMs < 1) {
+            throw new AssistantEvolutionError('invalid-input', 'ttlMs must be a positive safe integer');
+        }
+        const targetRule = this.store.getRule(ruleId);
+        if (targetRule === undefined || targetRule.scopeKey !== scopeKey) {
+            throw new AssistantEvolutionError('not-found', 'evolution rule was not found in the Agent scope');
+        }
+        const route = this.approvalRoute(agent, undefined);
+        const requester = `agent:${agent.session.header.agentPreset}:owner-undo`;
+        const mutation = {
+            op: 'owner-undo',
             scopeKey,
             ruleId,
+            situation: targetRule.situation,
+            guidance: targetRule.guidance,
+            generation: targetRule.generation,
             expectedVersion: input.expectedVersion,
-            window: this.config.evaluationWindow,
-            minSample: this.config.minSample,
-            retireFailureRate: this.config.retireFailureRate,
-            evidenceSampleLimit: this.config.maxEvidenceSamples,
+            reason: 'Owner-approved immediate guidance undo.',
+        };
+        // operationId is the caller's retry identity. Deliberately exclude the
+        // target tuple from this key so reusing one operation for another target is
+        // detected as an idempotency conflict instead of creating a second card.
+        const stable = evolutionDigest(['owner-undo-v1', scopeKey, route.principal, operationId]);
+        const idempotencyKey = `evolution-owner-undo:${stable}`;
+        const review = evolutionMutationReview(mutation);
+        const creationIntent = {
+            idempotencyKey,
+            requester,
+            principal: route.principal,
+            action: review.action,
+            resource: review.resource,
+            diff: review.diff,
+            summary: review.summary,
+            ttlMs,
+            ...(route.dispatch === undefined ? {} : { dispatch: route.dispatch }),
+        };
+        const prior = this.store.getProposalByIdempotencyKey(idempotencyKey);
+        if (prior === undefined) {
+            if (targetRule.status !== 'active') {
+                throw new AssistantEvolutionError('not-found', 'active evolution rule was not found in the Agent scope');
+            }
+            if (targetRule.version !== input.expectedVersion) {
+                throw new AssistantEvolutionError('invalid-input', 'owner undo expectedVersion is stale');
+            }
+            if (this.store.ruleApprovalPrincipal(ruleId) !== route.principal) {
+                throw new AssistantEvolutionError('forbidden', 'owner undo route does not match the principal who approved this guidance');
+            }
+        }
+        const local = this.store.createProposal({
+            idempotencyKey,
+            requester,
+            principal: route.principal,
+            mutation,
+            // Policy proposal expiry uses the wall clock; the injectable clock is
+            // reserved for deterministic ledger/audit timestamps.
+            expiresAt: Date.now() + ttlMs,
+            creationIntent,
         });
+        if (local.policyProposalId !== undefined) {
+            if (local.status !== 'pending') {
+                return result(local, true, local.resultRuleId === undefined ? undefined : this.store.getRule(local.resultRuleId));
+            }
+            return this.settleAttached(local, true) ?? result(local, true);
+        }
+        return this.submitLocalProposal(local, false);
     }
     /**
      * Propose adopting or retiring a rule. Returns a pending proposal; the owner
@@ -306,6 +715,9 @@ export class AssistantEvolutionService extends Service {
                     sampleEpisodeIds: candidate.evidence.map(entry => entry.episodeId),
                     digest: candidate.evidenceDigest,
                     total: candidate.evidenceTotal,
+                    window: this.config.evaluationWindow,
+                    scopeWatermark: candidate.scopeWatermark,
+                    taskRevisions: candidate.taskRevisions,
                 },
             };
         }
@@ -330,7 +742,11 @@ export class AssistantEvolutionService extends Service {
             }
             mutation = {
                 op: 'retire',
+                scopeKey,
                 ruleId: existing.id,
+                situation: existing.situation,
+                guidance: existing.guidance,
+                generation: existing.generation,
                 expectedVersion: existing.version,
                 reason: input.mutation.reason,
                 evaluation: candidate.stats,
@@ -339,6 +755,9 @@ export class AssistantEvolutionService extends Service {
                     sampleEpisodeIds: candidate.evidence.map(entry => entry.episodeId),
                     digest: candidate.evidenceDigest,
                     total: candidate.evidenceTotal,
+                    window: this.config.evaluationWindow,
+                    scopeWatermark: candidate.scopeWatermark,
+                    taskRevisions: candidate.taskRevisions,
                 },
             };
         }
@@ -359,14 +778,14 @@ export class AssistantEvolutionService extends Service {
             ttlMs,
             ...(route.dispatch === undefined ? {} : { dispatch: route.dispatch }),
         };
-        const local = this.store.createProposal({
+        const local = this.withLearningWriterFence(mutation, () => this.store.createProposal({
             idempotencyKey,
             requester,
             principal: route.principal,
             mutation,
             expiresAt: Date.now() + ttlMs,
             creationIntent,
-        });
+        }));
         if (local.policyProposalId !== undefined) {
             if (local.status !== 'pending') {
                 return result(local, true, local.resultRuleId === undefined ? undefined : this.store.getRule(local.resultRuleId));
@@ -384,7 +803,17 @@ export class AssistantEvolutionService extends Service {
     reconcileProposals(limit) {
         this.assertActive();
         const settled = [];
-        for (const pending of this.store.listPendingProposals(limit ?? this.config.reconcileLimit)) {
+        const bounded = limit ?? this.config.reconcileLimit;
+        const queue = new Map();
+        for (const proposal of this.store.listUnattachedProposalIntents(bounded)) {
+            queue.set(proposal.proposalId, proposal);
+        }
+        for (const proposal of this.store.listPendingProposals(bounded)) {
+            if (queue.size >= bounded)
+                break;
+            queue.set(proposal.proposalId, proposal);
+        }
+        for (const pending of queue.values()) {
             try {
                 const result = pending.policyProposalId === undefined
                     ? this.submitLocalProposal(pending, false)
@@ -401,12 +830,72 @@ export class AssistantEvolutionService extends Service {
                 this.store.deferPendingProposal(pending.proposalId);
             }
         }
+        this.reconcileApplicationPresentations(limit);
         this.lastReconciledAt = this.now();
         return settled;
     }
+    /**
+     * Publish domain terminal receipts independently from proposal polling. A
+     * crash after Delivery accepts but before the local ack simply republishes the
+     * same revision and digest on restart.
+     */
+    reconcileApplicationPresentations(limit) {
+        this.assertActive();
+        const sink = this.presentationSink;
+        if (sink === undefined)
+            return 0;
+        const bounded = limit ?? this.config.reconcileLimit;
+        let published = 0;
+        for (const entry of this.store.listPendingEvolutionApplicationReceipts(bounded)) {
+            if (this.presentationSink?.token !== sink.token)
+                return published;
+            const receipt = entry.receipt;
+            try {
+                sink.registration.publish(this.applicationPresentation(receipt));
+                this.store.settleEvolutionApplicationPublication({
+                    localProposalId: receipt.localProposalId,
+                    receiptDigest: receipt.receiptDigest,
+                    outcome: 'published',
+                });
+                published += 1;
+            }
+            catch (error) {
+                const code = error instanceof Error
+                    ? `delivery-${error.name.normalize('NFC').toLowerCase().replaceAll(/[^a-z0-9]+/gu, '-').slice(0, 80)}`
+                    : 'delivery-unknown-error';
+                this.store.settleEvolutionApplicationPublication({
+                    localProposalId: receipt.localProposalId,
+                    receiptDigest: receipt.receiptDigest,
+                    outcome: 'retry',
+                    error: code,
+                });
+            }
+        }
+        return published;
+    }
+    applicationPresentation(receipt) {
+        return Object.freeze({
+            presentationKey: `approval-application:${receipt.policyProposalId}`,
+            originalOutboxIdempotencyKey: `approval-card:${receipt.policyProposalId}`,
+            revision: receipt.revision,
+            presentation: Object.freeze({
+                kind: 'approval-application',
+                policyProposalId: receipt.policyProposalId,
+                localProposalId: receipt.localProposalId,
+                applicationStatus: receipt.applicationStatus,
+                operation: receipt.operation,
+                terminalAt: receipt.terminalAt,
+                receiptDigest: receipt.receiptDigest,
+                ...(receipt.ruleId === undefined ? {} : { ruleId: receipt.ruleId }),
+                ...(receipt.resultingRuleVersion === undefined
+                    ? {} : { resultingRuleVersion: receipt.resultingRuleVersion }),
+                ...(receipt.ruleStatus === undefined ? {} : { ruleStatus: receipt.ruleStatus }),
+            }),
+        });
+    }
     submitLocalProposal(local, replayed) {
         const intent = local.creationIntent;
-        if (intent === undefined) {
+        if (intent === undefined || (intent.dispatch !== undefined && intent.dispatch.routeVersion !== 2)) {
             const conflict = this.store.settleProposal({
                 proposalId: local.proposalId,
                 securityConflict: true,
@@ -422,7 +911,7 @@ export class AssistantEvolutionService extends Service {
             diff: intent.diff,
             summary: intent.summary,
             notAfter: local.expiresAt,
-            ...(intent.dispatch === undefined ? {} : { dispatch: intent.dispatch }),
+            ...(intent.dispatch?.routeVersion === 2 ? { dispatch: intent.dispatch } : {}),
         };
         const recovered = this.policy.recoverOrCreateProposal(recoveryInput);
         if (recovered.kind === 'abandoned') {
@@ -430,7 +919,8 @@ export class AssistantEvolutionService extends Service {
                 proposalId: local.proposalId,
                 securityConflict: true,
             });
-            return result(conflict.proposal, replayed || recovered.replayed || conflict.replayed, conflict.rule);
+            const completed = this.store.completeAbandonedProposalRecovery(local.proposalId);
+            return result(completed, replayed || recovered.replayed || conflict.replayed, conflict.rule);
         }
         const decision = recovered.proposal;
         const snapshot = this.policy.getProposal(decision.proposalId);
@@ -488,12 +978,27 @@ export class AssistantEvolutionService extends Service {
             return undefined;
         try {
             const terminal = validateApprovalSettlement(snapshot, local.settlementExpectation);
-            const applied = this.store.settleProposal({
-                proposalId: local.proposalId,
-                policyStatus: terminal.status,
-                policyVersion: terminal.version,
-                reviewExpectation: local.settlementExpectation,
-            });
+            let applied;
+            try {
+                applied = this.withLearningWriterFence(local.mutation, () => this.store.settleProposal({
+                    proposalId: local.proposalId,
+                    policyStatus: terminal.status,
+                    policyVersion: terminal.version,
+                    reviewExpectation: local.settlementExpectation,
+                }));
+            }
+            catch (error) {
+                if (!(error instanceof AssistantEvolutionError) || error.code !== 'forbidden')
+                    throw error;
+                // A stale/missing authoritative fence is itself the domain terminal.
+                // This conflict-only transaction cannot apply a rule and therefore does
+                // not need to acquire Evaluation in the reverse lock order.
+                applied = this.store.settleProposal({
+                    proposalId: local.proposalId,
+                    securityConflict: true,
+                });
+            }
+            this.reconcileApplicationPresentations();
             return result(applied.proposal, replayed || applied.replayed, applied.rule);
         }
         catch (error) {
@@ -503,6 +1008,7 @@ export class AssistantEvolutionService extends Service {
                 proposalId: local.proposalId,
                 securityConflict: true,
             });
+            this.reconcileApplicationPresentations();
             return result(conflict.proposal, replayed || conflict.replayed, conflict.rule);
         }
     }
@@ -510,7 +1016,8 @@ export class AssistantEvolutionService extends Service {
         if (this.delivery !== undefined) {
             const dispatch = this.delivery.prepareAgentApproval(agent, { sourceId: evolutionApprovalSource });
             const workspace = agent?.session.header.cwd;
-            if (dispatch.sourceId !== evolutionApprovalSource || dispatch.workspace !== workspace
+            if (dispatch.routeVersion !== 2
+                || dispatch.sourceId !== evolutionApprovalSource || dispatch.workspace !== workspace
                 || dispatch.principal.trim() === '') {
                 throw new AssistantEvolutionError('invalid-input', 'authenticated approval route does not match the Agent');
             }
@@ -525,6 +1032,315 @@ export class AssistantEvolutionService extends Service {
         }
         return { principal };
     }
+    /**
+     * Acquire Evaluation first and Evolution only inside its synchronous callback.
+     * No code holding an Evolution writer lock is allowed to call this method.
+     */
+    withLearningWriterFence(mutation, callback) {
+        if (mutation.op === 'owner-undo')
+            return callback();
+        const evidence = mutation.evidence;
+        if (evidence === undefined || evidence.scopeWatermark === undefined
+            || evidence.taskRevisions === undefined || evidence.taskRevisions.length !== evidence.total
+            || evidence.taskRevisions.length < 1) {
+            throw new AssistantEvolutionError('forbidden', 'evidence-dependent Evolution operations require a complete Evaluation writer fence');
+        }
+        const scopeKey = mutation.op === 'adopt' ? mutation.input.scopeKey : mutation.scopeKey;
+        let scope;
+        try {
+            const parsed = JSON.parse(scopeKey);
+            if (!Array.isArray(parsed) || parsed.length !== 2
+                || typeof parsed[0] !== 'string' || typeof parsed[1] !== 'string')
+                throw new Error('invalid');
+            scope = { workspace: parsed[0], preset: parsed[1] };
+        }
+        catch {
+            throw new AssistantEvolutionError('forbidden', 'Evolution evidence scope is not canonical');
+        }
+        const evaluation = this.context.get('assistantEvaluation');
+        if (evaluation === undefined
+            || typeof evaluation.withTrustedLearningWriterFence !== 'function') {
+            throw new AssistantEvolutionError('forbidden', 'authoritative Evaluation writer fence capability is unavailable');
+        }
+        const result = evaluation.withTrustedLearningWriterFence({
+            scope: canonicalEvaluationHostScope(scope),
+            scopeWatermark: evidence.scopeWatermark,
+            evidence: evidence.taskRevisions,
+        }, callback);
+        if (typeof result !== 'object' || result === null || !Object.isFrozen(result)
+            || result.matched !== true) {
+            const reason = typeof result === 'object' && result !== null && 'reason' in result
+                ? String(result.reason)
+                : 'invalid-fence-receipt';
+            throw new AssistantEvolutionError('forbidden', `Evolution evidence is stale at the authoritative writer fence: ${reason}`);
+        }
+        return result.value;
+    }
+    candidatesForScope(scopeKey) {
+        return this.store.candidates({
+            scopeKey,
+            window: this.config.evaluationWindow,
+            minSample: this.config.minSample,
+            adoptFailureRate: this.config.adoptFailureRate,
+            retireFailureRate: this.config.retireFailureRate,
+            limit: this.config.maxCandidates,
+            evidenceSampleLimit: this.config.maxEvidenceSamples,
+        });
+    }
+    trustedTaskLearningReceipt(scope, evaluationId) {
+        const evaluation = this.context.get('assistantEvaluation');
+        if (evaluation === undefined || typeof evaluation.getTrustedTaskLearningProjection !== 'function') {
+            throw new AssistantEvolutionError('forbidden', 'authoritative assistantEvaluation lookup is unavailable');
+        }
+        const receipt = evaluation.getTrustedTaskLearningProjection({
+            scope: canonicalEvaluationHostScope(scope),
+            outcomeId: evaluationId,
+        });
+        if (receipt === undefined) {
+            throw new AssistantEvolutionError('not-found', 'trusted Evaluation outcome was not found in the exact scope');
+        }
+        const scopeKey = canonicalEvolutionScope(scope.workspace, scope.preset);
+        if (!Object.isFrozen(receipt) || !Object.isFrozen(receipt.scope)
+            || !Object.isFrozen(receipt.projection)
+            || receipt.triggerOutcomeId !== evaluationId || receipt.scopeKey !== scopeKey
+            || receipt.scope.workspace !== scope.workspace
+            || receipt.scope.preset !== scope.preset
+            || !Number.isSafeInteger(receipt.scopeWatermark) || receipt.scopeWatermark < 1
+            || (receipt.projection.subjectKind !== 'automation-run'
+                && receipt.projection.subjectKind !== 'outcome')
+            || hostText(receipt.projection.subjectRef, 'projection.subjectRef', 1_000)
+                !== receipt.projection.subjectRef
+            || !Number.isSafeInteger(receipt.projection.version) || receipt.projection.version < 1
+            || receipt.projection.version > 1_000_000_000
+            || !/^[a-f\d]{64}$/u.test(receipt.projection.digest)
+            || (receipt.projection.disposition !== 'upsert'
+                && receipt.projection.disposition !== 'retract')
+            || evaluationLearningProjectionDigest(receipt) !== receipt.projection.digest) {
+            throw new AssistantEvolutionError('forbidden', 'Evaluation returned a mismatched trusted receipt');
+        }
+        if (receipt.execution !== undefined && (!Object.isFrozen(receipt.execution)
+            || !Object.isFrozen(receipt.execution.source)
+            || !Object.isFrozen(receipt.execution.evaluator)
+            || !Object.isFrozen(receipt.execution.evidence)
+            || receipt.execution.evidence.some(entry => !Object.isFrozen(entry)))) {
+            throw new AssistantEvolutionError('forbidden', 'Evaluation execution component is mutable');
+        }
+        if (receipt.objective !== undefined && (!Object.isFrozen(receipt.objective)
+            || !Object.isFrozen(receipt.objective.source)
+            || !Object.isFrozen(receipt.objective.evaluator)
+            || !Object.isFrozen(receipt.objective.evidence)
+            || receipt.objective.evidence.some(entry => !Object.isFrozen(entry)))) {
+            throw new AssistantEvolutionError('forbidden', 'Evaluation objective component is mutable');
+        }
+        if (receipt.projection.disposition === 'upsert'
+            && (receipt.objective === undefined
+                || (receipt.objective.status !== 'achieved' && receipt.objective.status !== 'not-achieved')
+                || receipt.projection.evidenceOutcomeId !== receipt.objective.outcomeId)) {
+            throw new AssistantEvolutionError('forbidden', 'an upsert task revision requires one exact binary objective component');
+        }
+        return receipt;
+    }
+    applyTrustedTaskLearningReceipt(scope, receipt) {
+        const scopeKey = canonicalEvolutionScope(scope.workspace, scope.preset);
+        if (receipt.projection.disposition === 'retract') {
+            return this.store.applyTaskLearningProjection({
+                scopeKey,
+                scopeWatermark: receipt.scopeWatermark,
+                subjectKind: receipt.projection.subjectKind,
+                subjectRef: receipt.projection.subjectRef,
+                version: receipt.projection.version,
+                digest: receipt.projection.digest,
+                disposition: 'retract',
+                situation: receipt.situation,
+                occurredAt: receipt.execution?.occurredAt ?? receipt.objective?.occurredAt ?? this.now(),
+            });
+        }
+        const objective = receipt.objective;
+        const verified = this.verifiedAutomationAttribution(receipt, scopeKey);
+        if (verified?.executionKind === 'host') {
+            throw new AssistantEvolutionError('forbidden', 'Host runbook outcomes are not behavioural learning subjects');
+        }
+        return this.store.applyTaskLearningProjection({
+            scopeKey,
+            scopeWatermark: receipt.scopeWatermark,
+            subjectKind: receipt.projection.subjectKind,
+            subjectRef: receipt.projection.subjectRef,
+            version: receipt.projection.version,
+            digest: receipt.projection.digest,
+            disposition: 'upsert',
+            situation: receipt.situation,
+            outcome: objective.status === 'achieved' ? 'succeeded' : 'failed',
+            detail: `authoritative Evaluation objective: ${objective.status}`,
+            evidenceRef: objective.outcomeId,
+            occurredAt: receipt.execution?.occurredAt ?? objective.occurredAt,
+            ...(verified?.attribution === undefined ? {} : verified.attribution),
+        });
+    }
+    verifiedAutomationAttribution(receipt, scopeKey) {
+        if (receipt.projection.subjectKind !== 'automation-run') {
+            return undefined;
+        }
+        const execution = receipt.execution;
+        const runReferences = execution?.evidence.filter(entry => entry.kind === 'automation-run') ?? [];
+        if (execution === undefined || runReferences.length !== 1
+            || runReferences[0].ref !== receipt.projection.subjectRef
+            || !receipt.situation.startsWith('automation:')
+            || execution.source.kind !== 'automation'
+            || execution.source.id !== 'assistant-automations'
+            || execution.evaluator.id !== 'assistant-automations'
+            || !/^(?:terminal|host-runbook)-v[1-9][0-9]*$/u.test(execution.evaluator.version)) {
+            throw new AssistantEvolutionError('forbidden', 'Evaluation receipt has no exact authoritative Automation execution component');
+        }
+        const automationId = receipt.situation.slice('automation:'.length);
+        if (automationId === '') {
+            throw new AssistantEvolutionError('forbidden', 'Evaluation receipt has an invalid automation situation');
+        }
+        const reference = runReferences[0];
+        const resolver = this.context.get('assistantAutomations');
+        if (resolver === undefined || typeof resolver.resolveQualityEvidence !== 'function'
+            || typeof resolver.validateQualityEvidence !== 'function') {
+            throw new AssistantEvolutionError('forbidden', 'authoritative assistantAutomations production proof is unavailable');
+        }
+        let proof;
+        let valid = false;
+        try {
+            proof = resolver.resolveQualityEvidence({
+                automationId,
+                runId: reference.ref,
+                expectedScope: { workspace: receipt.scope.workspace, preset: receipt.scope.preset },
+                expectedSituation: receipt.situation,
+                expectedOccurredAt: execution.occurredAt,
+                evidenceRef: { kind: 'automation-run', ref: reference.ref },
+            });
+            valid = proof !== undefined && resolver.validateQualityEvidence(proof);
+        }
+        catch {
+            throw new AssistantEvolutionError('forbidden', 'assistantAutomations rejected the production quality proof');
+        }
+        if (!valid || proof === undefined || !Object.isFrozen(proof)
+            || (proof.executionKind !== 'agent' && proof.executionKind !== 'host')
+            || proof.automationId !== automationId || proof.runId !== reference.ref
+            || proof.scope.workspace !== receipt.scope.workspace
+            || proof.scope.preset !== receipt.scope.preset
+            || proof.situation !== receipt.situation || proof.occurredAt !== execution.occurredAt
+            || (proof.status === 'timed_out' ? 'timed-out' : proof.status) !== execution.status
+            || proof.evidenceRef.kind !== 'automation-run' || proof.evidenceRef.ref !== reference.ref) {
+            throw new AssistantEvolutionError('forbidden', 'assistantAutomations returned a mismatched production quality proof');
+        }
+        const hasRule = proof.ruleId !== undefined;
+        const hasGuidanceVersion = proof.guidanceVersion !== undefined;
+        // A normal Agent automation always has a session id. Before the first rule
+        // exists there is intentionally no guidance attribution; that baseline is
+        // what makes bootstrap learning possible.
+        if (proof.executionKind === 'host') {
+            if (proof.sessionId !== undefined || hasRule || hasGuidanceVersion) {
+                throw new AssistantEvolutionError('forbidden', 'Host automation proof contains Agent attribution');
+            }
+            return Object.freeze({
+                executionKind: 'host',
+                learningSubjectRef: JSON.stringify(['automation-run', proof.runId]),
+            });
+        }
+        if (!hasRule && !hasGuidanceVersion) {
+            return Object.freeze({
+                executionKind: 'agent',
+                learningSubjectRef: JSON.stringify(['automation-run', proof.runId]),
+            });
+        }
+        if (proof.sessionId === undefined || !hasRule || !hasGuidanceVersion) {
+            throw new AssistantEvolutionError('forbidden', 'automation guidance attribution proof is incomplete');
+        }
+        const exposure = this.store.captureGuidanceExposure(proof.sessionId, scopeKey, receipt.situation);
+        if (exposure === undefined || exposure.ruleId !== proof.ruleId
+            || exposure.guidanceVersion !== proof.guidanceVersion
+            || execution.occurredAt < exposure.exposedAt) {
+            throw new AssistantEvolutionError('forbidden', 'automation guidance attribution does not match an exact Evolution exposure');
+        }
+        return Object.freeze({
+            executionKind: 'agent',
+            learningSubjectRef: JSON.stringify(['automation-run', proof.runId]),
+            attribution: Object.freeze({ ruleId: exposure.ruleId, guidanceVersion: exposure.guidanceVersion }),
+        });
+    }
+    normalizedRollbackInput(input) {
+        this.assertActive();
+        if (!this.config.autonomousRollback) {
+            throw new AssistantEvolutionError('forbidden', 'autonomous evolution rollback is disabled');
+        }
+        const ruleId = hostText(input.ruleId, 'ruleId', 200);
+        if (!/^rule-[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/u
+            .test(ruleId)) {
+            throw new AssistantEvolutionError('invalid-input', 'ruleId must be an immutable server-issued rule ID');
+        }
+        if (!Number.isSafeInteger(input.expectedVersion) || input.expectedVersion < 1
+            || input.expectedVersion > 1_000_000_000) {
+            throw new AssistantEvolutionError('invalid-input', 'expectedVersion must be a positive safe integer');
+        }
+        return { ruleId, expectedVersion: input.expectedVersion };
+    }
+    rollbackForScope(scopeKey, input) {
+        return this.store.rollbackRule({
+            scopeKey,
+            ruleId: input.ruleId,
+            expectedVersion: input.expectedVersion,
+            window: this.config.evaluationWindow,
+            minSample: this.config.minSample,
+            retireFailureRate: this.config.retireFailureRate,
+            evidenceSampleLimit: this.config.maxEvidenceSamples,
+        });
+    }
+    authorizeHost(input, action, resourceId) {
+        this.assertActive();
+        const scope = exactEvolutionHostScope(input.scope);
+        const principal = hostText(input.principal, 'principal', 500);
+        const operationId = hostText(input.operationId, 'operationId', 500);
+        const canonicalResourceId = hostText(resourceId, 'resourceId', 500);
+        const scopeKey = canonicalEvolutionScope(scope.workspace, scope.preset);
+        const idempotencyDigest = createHash('sha256').update(JSON.stringify([
+            HOST_RECOVERY_BACKGROUND_ID,
+            scopeKey,
+            principal,
+            action,
+            canonicalResourceId,
+            operationId,
+        ])).digest('hex');
+        const decision = this.policy.authorize({
+            subject: {
+                kind: 'background',
+                id: HOST_RECOVERY_BACKGROUND_ID,
+                workspace: scope.workspace,
+                principal,
+            },
+            action,
+            resource: { kind: 'evolution', id: canonicalResourceId },
+            context: { initiator: 'background' },
+        }, { idempotencyKey: `evolution-host:${idempotencyDigest}` });
+        if (decision.effect !== 'allow') {
+            throw new AssistantEvolutionError('forbidden', `policy denied Host evolution ${action}`);
+        }
+        return scopeKey;
+    }
+    authorizeSupervisedGrowthAnalyst(agent, action, resourceId) {
+        const scopeKey = this.authorize(agent, action, resourceId);
+        const execution = agent.ctx
+            .get('assistantAutomationExecution');
+        if (typeof execution !== 'object' || execution === null || Array.isArray(execution)
+            || !Object.isFrozen(execution)
+            || Object.keys(execution).sort().join(',') !== 'automationId,mode,occurrenceId') {
+            throw new AssistantEvolutionError('forbidden', 'adoption analyst requires the immutable Automation execution context');
+        }
+        const installed = execution;
+        if (installed.mode !== 'production'
+            || installed.automationId !== SUPERVISED_GROWTH_ANALYST_AUTOMATION_ID
+            || typeof installed.occurrenceId !== 'string') {
+            throw new AssistantEvolutionError('forbidden', 'adoption analyst is restricted to its exact production Automation');
+        }
+        const occurrenceId = hostText(installed.occurrenceId, 'occurrenceId', 500);
+        if (occurrenceId !== installed.occurrenceId) {
+            throw new AssistantEvolutionError('forbidden', 'analyst occurrence identity is not canonical');
+        }
+        return Object.freeze({ scopeKey, occurrenceId });
+    }
     /** Guidance block for the current active rules, as injected into a session. */
     guidance(agent) {
         this.assertActive();
@@ -540,8 +1356,32 @@ export class AssistantEvolutionService extends Service {
         });
     }
     injectGuidance(agent) {
-        if (!this.active || this.injected.has(agent))
+        if (!this.active)
             return;
+        const execution = agent.ctx
+            .get('assistantAutomationExecution');
+        // Missing execution context is a normal foreground session. If a Host marks
+        // the Agent as automation-scoped, only production may receive guidance or
+        // write an exposure receipt. Malformed future modes fail closed as preview.
+        let exactAutomationSituation;
+        if (execution !== undefined) {
+            if (typeof execution !== 'object' || execution === null || Array.isArray(execution)
+                || Object.keys(execution).sort().join(',') !== 'automationId,mode,occurrenceId')
+                return;
+            const installed = execution;
+            if (installed.mode !== 'production' || typeof installed.automationId !== 'string'
+                || typeof installed.occurrenceId !== 'string')
+                return;
+            let automationId;
+            try {
+                automationId = hostText(installed.automationId, 'automationId', 500);
+                hostText(installed.occurrenceId, 'occurrenceId', 500);
+            }
+            catch {
+                return;
+            }
+            exactAutomationSituation = `automation:${automationId}`;
+        }
         const workspace = agent.session.header.cwd;
         const preset = agent.session.header.agentPreset;
         if (workspace === undefined || !isAbsolute(workspace) || preset === undefined || preset.trim() === '')
@@ -553,15 +1393,34 @@ export class AssistantEvolutionService extends Service {
             return;
         const scopeKey = canonicalEvolutionScope(workspace, preset);
         const sessionId = String(agent.session.id);
+        const exposedCount = this.store.countGuidanceExposures(sessionId, scopeKey);
+        const remaining = Math.max(0, this.config.maxInjectedRules - exposedCount);
+        // Before Automation installs its execution context the session is
+        // indistinguishable from foreground. With a multi-rule budget, reserve one
+        // slot so the exact post-setup rule can still fit inside the global cap.
+        const reserved = execution === undefined && this.config.maxInjectedRules > 1 ? 1 : 0;
+        const injectionLimit = Math.max(0, remaining - reserved);
+        if (injectionLimit === 0)
+            return;
         const unseen = this.store.listRules(scopeKey, 'active').filter(rule => !this.store.hasGuidanceExposure(sessionId, scopeKey, rule.id, rule.generation));
-        const snapshot = buildGuidanceSnapshot(unseen, {
+        // A production Automation's exact rule must be selected before the global
+        // max-rules slice. This is also safe when the post-setup hook follows an
+        // earlier session-start: durable exposures remove already injected rules,
+        // so the hook can still inject the previously omitted exact rule.
+        const prioritized = exactAutomationSituation === undefined
+            ? unseen
+            : [
+                ...unseen.filter(rule => rule.situation === exactAutomationSituation),
+                ...unseen.filter(rule => rule.situation !== exactAutomationSituation),
+            ];
+        const snapshot = buildGuidanceSnapshot(prioritized, {
             maxBytes: this.config.maxGuidanceBytes,
-            maxRules: this.config.maxInjectedRules,
+            maxRules: injectionLimit,
+            ...(exactAutomationSituation === undefined
+                ? {} : { prioritySituation: exactAutomationSituation }),
         });
-        if (snapshot.text === '') {
-            this.injected.add(agent);
+        if (snapshot.text === '')
             return;
-        }
         agent.inject(createUserMessage({
             content: [{ type: 'text', text: snapshot.text }],
             source: { kind: 'plugin', plugin: 'assistant-evolution' },
@@ -575,7 +1434,6 @@ export class AssistantEvolutionService extends Service {
                 guidanceVersion: rule.generation,
             });
         }
-        this.injected.add(agent);
     }
     authorize(agent, action, resourceId) {
         this.assertActive();