@happyvertical/smrt-ingestion 0.55.6 → 0.55.8

package/dist/proposal-contracts.d.ts

@@ -42,6 +42,10 @@ export interface GenerativeProposalInput {
         candidates: ProposalCandidate[];
     }>;
     instructions: string;
+    /** Bounded, currently eligible examples; neither evidence nor authority. */
+    examples?: import('./feedback-dto.js').FeedbackSelection;
+    /** Authenticated human correction carried through fresh extraction; never model authority. */
+    humanCorrection?: IntakeValues;
 }
 /** Inject only trusted SDK-bound adapters. Generative output is always untrusted. */
 export interface ProposalGenerator {

package/dist/proposal-contracts.d.ts.map

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

package/dist/proposal-dto.d.ts

@@ -82,6 +82,10 @@ export interface GenerationOutput {
         candidates: ProposalCandidate[];
     }>;
     provenance: {
+        feedback?: {
+            query: string;
+            selection: import('./feedback-dto.js').FeedbackReferences;
+        };
         configurationVersion: string;
         promptVersion: string;
         catalogDigest: string;

package/dist/proposal-dto.d.ts.map

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

package/dist/proposal-errors.d.ts

@@ -0,0 +1,5 @@
+/** Current generation is authorized, but its immutable candidate revisions are stale. */
+export declare class GenerationSnapshotStaleError extends Error {
+    constructor();
+}
+//# sourceMappingURL=proposal-errors.d.ts.map

package/dist/proposal-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proposal-errors.d.ts","sourceRoot":"","sources":["../src/proposal-errors.ts"],"names":[],"mappings":"AAAA,yFAAyF;AACzF,qBAAa,4BAA6B,SAAQ,KAAK;;CAKtD"}

package/dist/proposal-sdk.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"proposal-sdk.d.ts","sourceRoot":"","sources":["../src/proposal-sdk.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EAGZ,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,KAAK,gBAAgB,EAAoB,MAAM,uBAAuB,CAAC;AAChF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAGjE,8FAA8F;AAC9F,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,EACjC,kBAAkB,EAAE,gBAAgB,EACpC,MAAM,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAC/C,iBAAiB,CAoDnB;AAED,gFAAgF;AAChF,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,IAAI,CAAC,WAAW,EAAE,iBAAiB,GAAG,QAAQ,CAAC,GACtD,cAAc,CAYhB"}
+{"version":3,"file":"proposal-sdk.d.ts","sourceRoot":"","sources":["../src/proposal-sdk.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EAGZ,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,KAAK,gBAAgB,EAAoB,MAAM,uBAAuB,CAAC;AAChF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAGjE,8FAA8F;AAC9F,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,EACjC,kBAAkB,EAAE,gBAAgB,EACpC,MAAM,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAC/C,iBAAiB,CAqDnB;AAED,gFAAgF;AAChF,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,IAAI,CAAC,WAAW,EAAE,iBAAiB,GAAG,QAAQ,CAAC,GACtD,cAAc,CAYhB"}

package/dist/proposals.d.ts

@@ -20,6 +20,8 @@ export declare class IngestionProposalService {
     private allowedProviders;
     private catalog;
     listHandlers(itemId: string): Promise<ProposalCatalogEntry[]>;
+    /** Public retrieval derives catalog/candidates and compatibility on the server. */
+    retrieveFeedback(input: import('./feedback-dto.js').RetrieveFeedbackInput): Promise<import('./feedback-dto.js').FeedbackSelection>;
     findCandidates(input: {
         itemId: string;
         handlerId: string;
@@ -30,10 +32,11 @@ export declare class IngestionProposalService {
     prepareGeneration(itemId: string, attemptId: string): Promise<GenerationStageConfiguration>;
     private extraction;
     private live;
+    private feedbackGate;
     private deadline;
     generate(lease: AnalysisLease): Promise<boolean>;
     private decide;
-    [generationSnapshotRead](itemId: string, run: TransactionRunner<CompletedAnalysisSnapshot>, read: (db: DatabaseInterface) => Promise<CompletedAnalysisSnapshot>): Promise<CompletedAnalysisSnapshot>;
+    [generationSnapshotRead](itemId: string, run: TransactionRunner<CompletedAnalysisSnapshot>, read: (db: DatabaseInterface) => Promise<CompletedAnalysisSnapshot>, afterRead?: (db: DatabaseInterface, snapshot: CompletedAnalysisSnapshot) => Promise<void>, requireReview?: boolean): Promise<CompletedAnalysisSnapshot>;
     /** Internal stage read gate; the foundation owns current snapshot/digest checks. */
     private authorizeCompletedSnapshot;
     preview(input: PreviewGeneratedInput): Promise<GeneratedPreview[]>;

package/dist/proposals.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"proposals.d.ts","sourceRoot":"","sources":["../src/proposals.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAW5D,OAAO,EAGL,sBAAsB,EACtB,KAAK,iBAAiB,EACvB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,KAAK,EACV,4BAA4B,EAC5B,qBAAqB,EACtB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EACV,aAAa,EACb,yBAAyB,EACzB,gBAAgB,EAGhB,qBAAqB,EAErB,oBAAoB,EACrB,MAAM,mBAAmB,CAAC;AAO3B,OAAO,KAAK,EACV,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EACjB,MAAM,aAAa,CAAC;AAErB,mBAAmB,yBAAyB,CAAC;AAC7C,mBAAmB,mBAAmB,CAAC;AACvC,OAAO,EACL,+BAA+B,EAC/B,0BAA0B,GAC3B,MAAM,mBAAmB,CAAC;AAiB3B,oFAAoF;AACpF,qBAAa,wBAAwB;IAKjC,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM;IANzB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAyB;IACnD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;IAC1B,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC;gBAEf,OAAO,EAAE,gBAAgB,EACzB,OAAO,EAAE,gBAAgB,EACzB,MAAM,EAAE,qBAAqB;IAuDhD,OAAO,CAAC,OAAO;IAQf,OAAO,CAAC,KAAK;IAoDb,OAAO,CAAC,gBAAgB;YAOV,OAAO;IA+Cf,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAG7D,cAAc,CAAC,KAAK,EAAE;QAC1B,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,cAAc,EAAE,MAAM,CAAC;QACvB,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,OAAO,CAAC,aAAa,CAAC;IA4EpB,iBAAiB,CACrB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,4BAA4B,CAAC;IAoBxC,OAAO,CAAC,UAAU;YAmCJ,IAAI;YAiCJ,QAAQ;IAmBhB,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC;YAoLxC,MAAM;IAmNpB,CAAC,sBAAsB,CAAC,CACtB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,iBAAiB,CAAC,yBAAyB,CAAC,EACjD,IAAI,EAAE,CAAC,EAAE,EAAE,iBAAiB,KAAK,OAAO,CAAC,yBAAyB,CAAC,GAClE,OAAO,CAAC,yBAAyB,CAAC;IAWrC,oFAAoF;YACtE,0BAA0B;IA6ClC,OAAO,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;CA0HzE"}
+{"version":3,"file":"proposals.d.ts","sourceRoot":"","sources":["../src/proposals.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAW5D,OAAO,EAGL,sBAAsB,EACtB,KAAK,iBAAiB,EACvB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,KAAK,EACV,4BAA4B,EAC5B,qBAAqB,EACtB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EACV,aAAa,EACb,yBAAyB,EACzB,gBAAgB,EAGhB,qBAAqB,EAErB,oBAAoB,EACrB,MAAM,mBAAmB,CAAC;AAQ3B,OAAO,KAAK,EACV,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EACjB,MAAM,aAAa,CAAC;AAErB,mBAAmB,yBAAyB,CAAC;AAC7C,mBAAmB,mBAAmB,CAAC;AACvC,OAAO,EACL,+BAA+B,EAC/B,0BAA0B,GAC3B,MAAM,mBAAmB,CAAC;AAiB3B,oFAAoF;AACpF,qBAAa,wBAAwB;IAKjC,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM;IANzB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAyB;IACnD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;IAC1B,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC;gBAEf,OAAO,EAAE,gBAAgB,EACzB,OAAO,EAAE,gBAAgB,EACzB,MAAM,EAAE,qBAAqB;IAuDhD,OAAO,CAAC,OAAO;IAQf,OAAO,CAAC,KAAK;IAoDb,OAAO,CAAC,gBAAgB;YAOV,OAAO;IAyDf,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAGnE,mFAAmF;IAC7E,gBAAgB,CACpB,KAAK,EAAE,OAAO,mBAAmB,EAAE,qBAAqB,GACvD,OAAO,CAAC,OAAO,mBAAmB,EAAE,iBAAiB,CAAC;IA+BnD,cAAc,CAAC,KAAK,EAAE;QAC1B,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,cAAc,EAAE,MAAM,CAAC;QACvB,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,OAAO,CAAC,aAAa,CAAC;IA4EpB,iBAAiB,CACrB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,4BAA4B,CAAC;IA2BxC,OAAO,CAAC,UAAU;YAmCJ,IAAI;YAmCJ,YAAY;YA6BZ,QAAQ;IAmBhB,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC;YAwQxC,MAAM;IAyNpB,CAAC,sBAAsB,CAAC,CACtB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,iBAAiB,CAAC,yBAAyB,CAAC,EACjD,IAAI,EAAE,CAAC,EAAE,EAAE,iBAAiB,KAAK,OAAO,CAAC,yBAAyB,CAAC,EACnE,SAAS,CAAC,EAAE,CACV,EAAE,EAAE,iBAAiB,EACrB,QAAQ,EAAE,yBAAyB,KAChC,OAAO,CAAC,IAAI,CAAC,EAClB,aAAa,UAAQ,GACpB,OAAO,CAAC,yBAAyB,CAAC;IAoCrC,oFAAoF;YACtE,0BAA0B;IA8ClC,OAAO,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;CA0HzE"}

package/dist/proposals.js

@@ -1,7 +1,8 @@
-import { a as require_ajv, o as __toESM, r as intakeBindingDigest, t as IntakeExecutionService } from "./chunks/execution-C6HJvl9e.js";
+import { l as __toESM, r as intakeBindingDigest, s as require_ajv, t as IntakeExecutionService } from "./chunks/execution-C7sTFXFU.js";
 import { n as generationSnapshotRead, t as discoveryTransaction } from "./chunks/execution-internal-DWteDHM2.js";
 import { a as providerIdentity } from "./chunks/extraction-providers-C66ADDVe.js";
-import { r as proposeDocumentSplits } from "./chunks/extraction-bseWZuWN.js";
+import { i as proposeDocumentSplits, t as GenerationSnapshotStaleError } from "./chunks/proposal-errors-z24VKWnQ.js";
+import { t as IntakeFeedbackService } from "./chunks/feedback-C3OHD4sA.js";
 import { executeDecision } from "@happyvertical/smrt-core";
 //#region src/proposal-validation.ts
 var import_ajv = /* @__PURE__ */ __toESM(require_ajv(), 1);
@@ -257,7 +258,8 @@ function createSDKProposalGenerator(client, configuredIdentity, limits) {
 				role: "user",
 				content: JSON.stringify({
 					evidence: input.evidence,
-					offered: input.offered
+					offered: input.offered,
+					...input.examples ? { examples: input.examples } : {}
 				})
 			}], {
 				model: identity.model,
@@ -391,7 +393,13 @@ var IngestionProposalService = class {
 	}
 	async catalog(itemId, scope) {
 		const evidence = scope?.evidence ?? await this.service.getEvidence(itemId);
-		const discover = scope?.authorize ?? ((id, version, work) => this.execution.withDiscoveryContext(itemId, id, version, work));
+		const discover = scope?.authorize ?? ((id, version, work) => this.execution.withDiscoveryContext(itemId, id, version, (context) => work(context, (model, targetId) => this.options.execution.assertTarget({
+			db: context.db,
+			scope: context.scope,
+			itemId,
+			model,
+			id: targetId
+		}))));
 		const entries = [];
 		for (const handler of this.options.execution.handlers) {
 			if (!handler.discovery?.mediaTypes.some((type) => evidence.some((entry) => entry.mediaType === type))) continue;
@@ -410,6 +418,33 @@ var IngestionProposalService = class {
 	async listHandlers(itemId) {
 		return (await this.catalog(itemId)).map(({ handler }) => handler);
 	}
+	/** Public retrieval derives catalog/candidates and compatibility on the server. */
+	async retrieveFeedback(input) {
+		if (Object.keys(input).some((key) => !["itemId", "query"].includes(key)) || typeof input.query !== "string" || input.query.length > this.config.limits.maxQueryLength) throw new Error("Feedback query unavailable");
+		const catalog = await this.catalog(input.itemId);
+		const offered = [];
+		for (const { handler } of catalog) {
+			const page = await this.findCandidates({
+				itemId: input.itemId,
+				query: input.query,
+				handlerId: handler.id,
+				handlerVersion: handler.version
+			});
+			offered.push({
+				handler,
+				candidates: page.items
+			});
+		}
+		return new IntakeFeedbackService(this.options, this.execution).retrieve({
+			itemId: input.itemId,
+			query: input.query,
+			offered,
+			promptVersion: this.config.promptVersion,
+			configurationVersion: this.config.version,
+			model: this.identity,
+			providers: [this.identity.provider, ...this.decisionIdentity ? [this.decisionIdentity.provider] : []]
+		});
+	}
 	async findCandidates(input) {
 		if (typeof input.query !== "string" || input.query.length > this.config.limits.maxQueryLength) throw new Error("Candidate query limit");
 		const limit = input.limit ?? this.config.limits.maxCandidates;
@@ -458,6 +493,7 @@ var IngestionProposalService = class {
 		if (source.result.provider !== "smrt-ingestion-extraction") throw new Error("Extraction source required");
 		return {
 			stage: "interpret",
+			...source.configuration.humanCorrection ? { humanCorrection: structuredClone(source.configuration.humanCorrection) } : {},
 			proposals: {
 				source: pin(source),
 				configurationVersion: this.config.version,
@@ -484,7 +520,7 @@ var IngestionProposalService = class {
 		}
 		return results;
 	}
-	async live(lease, catalogDigest, offered = []) {
+	async live(lease, catalogDigest, offered = [], feedback) {
 		await this.service.getGenerationInput(lease);
 		const catalog = await this.catalog(lease.itemId);
 		if (intakeBindingDigest(catalog) !== catalogDigest) throw new Error("Generation catalog changed");
@@ -494,9 +530,23 @@ var IngestionProposalService = class {
 			maxInputBytes = Math.min(maxInputBytes, context.policy.maxBytes);
 			for (const candidate of entry.candidates) await context.assertTarget(candidate.model, candidate.id, candidate.revision);
 		});
+		await this.feedbackGate(lease.itemId, offered, feedback);
 		await this.service.getAnalysisInput(lease);
 		return maxInputBytes;
 	}
+	async feedbackGate(itemId, offered, feedback, db) {
+		if (!feedback) return;
+		if (!this.options.feedback) throw new Error("Feedback configuration unavailable");
+		await new IntakeFeedbackService(this.options, this.execution).assertSelection({
+			itemId,
+			query: feedback.query,
+			offered,
+			promptVersion: this.config.promptVersion,
+			configurationVersion: this.config.version,
+			model: this.identity,
+			providers: [this.identity.provider, ...this.decisionIdentity ? [this.decisionIdentity.provider] : []]
+		}, feedback.selection, db);
+	}
 	async deadline(work) {
 		const controller = new AbortController();
 		let timer;
@@ -587,17 +637,45 @@ var IngestionProposalService = class {
 					candidates: candidates.items
 				});
 			}
+			let feedbackSelection;
+			if (this.options.feedback && !generation.configuration.humanCorrection && query.trim() && output.offered.length) {
+				const feedbackQuery = query.slice(0, 4096);
+				feedbackSelection = await new IntakeFeedbackService(this.options, this.execution).retrieve({
+					itemId: lease.itemId,
+					query: feedbackQuery,
+					offered: output.offered,
+					promptVersion: this.config.promptVersion,
+					configurationVersion: this.config.version,
+					model: this.identity,
+					providers: [this.identity.provider, ...this.decisionIdentity ? [this.decisionIdentity.provider] : []]
+				});
+				output.provenance.feedback = {
+					query: feedbackQuery,
+					selection: {
+						version: feedbackSelection.version,
+						configurationDigest: feedbackSelection.configurationDigest,
+						examples: feedbackSelection.examples.map(({ feedbackId, digest: digest2 }) => ({
+							feedbackId,
+							digest: digest2
+						}))
+					}
+				};
+			}
+			const humanCorrection = generation.configuration.humanCorrection;
+			if (intakeBindingDigest(humanCorrection ?? null) !== intakeBindingDigest(source.configuration.humanCorrection ?? null)) throw new StageFailure("integrity");
 			const input = {
 				evidence,
 				offered: output.offered,
-				instructions
+				instructions,
+				...feedbackSelection ? { examples: feedbackSelection } : {},
+				...humanCorrection ? { humanCorrection: structuredClone(record(humanCorrection)) } : {}
 			};
 			if (bytes(input) > Math.min(this.config.limits.maxInputBytes, ...catalog.map((entry) => entry.maxBytes)) || bytes(publication()) > maxBytes) throw new StageFailure("limit");
 			if (!catalog.length || !evidence.some((entry) => entry.segments.some((segment) => segment.text.trim()))) {
 				output.outcome = "unknown";
 				output.warnings.push("no_supported_interpretation");
 			} else {
-				await this.live(lease, expected.catalogDigest, output.offered);
+				if (bytes(input) > await this.live(lease, expected.catalogDigest, output.offered, output.provenance.feedback)) throw new StageFailure("limit");
 				const generated = await this.deadline(async (signal) => {
 					try {
 						return await this.config.generator.generate(structuredClone(input), {
@@ -608,11 +686,19 @@ var IngestionProposalService = class {
 						throw new StageFailure("unavailable");
 					}
 				});
-				await this.live(lease, expected.catalogDigest, output.offered);
+				await this.live(lease, expected.catalogDigest, output.offered, output.provenance.feedback);
 				if (!["complete", "unknown"].includes(generated.completion)) throw new StageFailure("malformed_output");
 				if (generated.completion === "unknown") output.warnings.push("generation_completion_unknown");
 				if (bytes(generated.output) > maxBytes) throw new StageFailure("limit");
 				Object.assign(output, validateSuggestions(generated.output, output.offered, extraction, this.config.limits, generation.revision));
+				if (humanCorrection) {
+					const correction = record(humanCorrection);
+					if (correction.kind !== "logical_split" || !output.splits.some((split) => split.evidenceId === correction.evidenceId && intakeBindingDigest(split.groups) === intakeBindingDigest(correction.groups))) {
+						output.outcome = "needs_review";
+						output.suggestions = [];
+						output.warnings.push("human_split_not_respected");
+					}
+				}
 				output.provenance.usage = safeUsage(generated.usage);
 				if (this.config.decision && output.suggestions.length) await this.decide(lease, output, input);
 				if (extraction.some((entry) => entry.capabilities.some((capability) => capability.truncation === "unknown"))) output.warnings.push("source_completion_unknown");
@@ -640,7 +726,7 @@ var IngestionProposalService = class {
 			output.warnings.push("output_limit");
 			if (bytes(publication()) > maxBytes) return this.service.failAnalysis(lease, "limit");
 		}
-		await this.live(lease, expected.catalogDigest, output.offered);
+		await this.live(lease, expected.catalogDigest, output.offered, output.provenance.feedback);
 		return this.service.completeAnalysis(lease, publication());
 	}
 	async decide(lease, output, input) {
@@ -685,7 +771,7 @@ var IngestionProposalService = class {
 		};
 		const requestBytes = bytes(request);
 		const assertRequestBudget = async () => {
-			const maxInputBytes = await this.live(lease, output.provenance.catalogDigest, output.offered);
+			const maxInputBytes = await this.live(lease, output.provenance.catalogDigest, output.offered, output.provenance.feedback);
 			if (requestBytes > maxInputBytes) throw new StageFailure("limit");
 		};
 		await assertRequestBudget();
@@ -709,7 +795,7 @@ var IngestionProposalService = class {
 				model: this.decisionIdentity.model
 			});
 		});
-		await this.live(lease, output.provenance.catalogDigest, output.offered);
+		await this.live(lease, output.provenance.catalogDigest, output.offered, output.provenance.feedback);
 		if (result.provenance.provider !== this.decisionIdentity.provider || result.provenance.model !== this.decisionIdentity.model) throw new StageFailure("malformed_output");
 		const answers = {};
 		for (const [key, question] of Object.entries(questions)) {
@@ -775,12 +861,23 @@ var IngestionProposalService = class {
 			}
 		});
 	}
-	[generationSnapshotRead](itemId, run, read) {
+	[generationSnapshotRead](itemId, run, read, afterRead, requireReview = false) {
 		return this.execution[discoveryTransaction](run, itemId, async (db, authorize) => {
 			const current = await read(db);
+			if (requireReview) {
+				const offered = record(current.result.output.proposals).offered;
+				if (!Array.isArray(offered) || !offered.length) throw new Error("Review catalogue unavailable");
+			}
 			await this.authorizeCompletedSnapshot(current, authorize);
+			const feedbackOutput = record(current.result.output.proposals);
+			await this.feedbackGate(itemId, feedbackOutput.offered, feedbackOutput.provenance.feedback, db);
+			if (afterRead) {
+				await afterRead(db, current);
+				await this.authorizeCompletedSnapshot(current, authorize);
+				await this.feedbackGate(itemId, feedbackOutput.offered, feedbackOutput.provenance.feedback, db);
+			}
 			return current;
-		});
+		}, requireReview);
 	}
 	/** Internal stage read gate; the foundation owns current snapshot/digest checks. */
 	async authorizeCompletedSnapshot(snapshot, authorize) {
@@ -791,13 +888,15 @@ var IngestionProposalService = class {
 			authorize
 		});
 		if (intakeBindingDigest(catalog) !== output.provenance.catalogDigest || intakeBindingDigest(record(snapshot.configuration.proposals).source) !== intakeBindingDigest(output.source)) throw new Error("Generation visibility changed");
+		let stale = false;
 		for (const entry of output.offered) {
 			if (!catalog.some(({ handler }) => intakeBindingDigest(handler) === intakeBindingDigest(entry.handler))) throw new Error("Handler unavailable");
-			await authorize(entry.handler.id, entry.handler.version, async (context) => {
+			await authorize(entry.handler.id, entry.handler.version, async (context, currentTarget) => {
 				if (!this.allowedProviders(context)) throw new Error("Provider unavailable");
-				for (const candidate of entry.candidates) await context.assertTarget(candidate.model, candidate.id, candidate.revision);
+				for (const candidate of entry.candidates) if ((await currentTarget(candidate.model, candidate.id)).revision !== candidate.revision) stale = true;
 			});
 		}
+		if (stale) throw new GenerationSnapshotStaleError();
 	}
 	async preview(input) {
 		if (!input.selections.length || input.selections.length > this.config.limits.maxSuggestions || new Set(input.selections.map((selection) => selection.index)).size !== input.selections.length || new Set(input.selections.map((selection) => selection.intentionKey)).size !== input.selections.length) throw new Error("Invalid proposal selection");