@farmslot/protocol 0.53.0 → 0.55.0

package/dist/recipe/pipeline-visual-judgments.d.ts

@@ -1,7 +1,9 @@
 import type { PipelineVisualReviewerBinding } from './claim-reviews.js';
 import type { EvidenceMomentRef } from './evidence.js';
 export declare const PIPELINE_VISUAL_RESULT_SCHEMA = "pipeline-visual-judgments-v1";
-export type NativeResultSchema = typeof PIPELINE_VISUAL_RESULT_SCHEMA;
+/** Authorised repair review: per-source visual results plus retained-claim applicability. */
+export declare const PIPELINE_REPAIR_VISUAL_RESULT_SCHEMA = "pipeline-visual-judgments-v2";
+export type NativeResultSchema = typeof PIPELINE_VISUAL_RESULT_SCHEMA | typeof PIPELINE_REPAIR_VISUAL_RESULT_SCHEMA;
 export interface PipelineVisualJudgment {
     claimId: string;
     verdict: 'confirmed' | 'rejected';
@@ -18,10 +20,29 @@ export interface PipelineVisualJudgments {
     closureIdentity: string;
     judgments: PipelineVisualJudgment[];
 }
-export interface NativeStructuredResult {
-    schema: NativeResultSchema;
-    value: PipelineVisualJudgments;
+/** A reviewer's explicit current-head classification of one retained criterion. */
+export interface PipelineRepairApplicability {
+    claimId: string;
+    recipeRunId: string;
+    closureIdentity: string;
+    unaffected: boolean;
+    reason: string;
+}
+export interface PipelineRepairVisualJudgments {
+    schemaVersion: 2;
+    headSha: string;
+    scopeDigest: string;
+    /** Existing visual-judgment results, one per fresh source with claims awaiting review. */
+    sources: PipelineVisualJudgments[];
+    retained: PipelineRepairApplicability[];
 }
+export type NativeStructuredResult = {
+    schema: typeof PIPELINE_VISUAL_RESULT_SCHEMA;
+    value: PipelineVisualJudgments;
+} | {
+    schema: typeof PIPELINE_REPAIR_VISUAL_RESULT_SCHEMA;
+    value: PipelineRepairVisualJudgments;
+};
 /** Gateway-captured review input; shared task files cannot supply it. */
 export interface PipelineVisualReviewInput {
     headSha: string;
@@ -32,11 +53,29 @@ export interface PipelineVisualReviewInput {
         text: string;
     }>;
 }
+/** Gateway-captured repair review input: fresh visual sources and retained criteria to classify. */
+export interface PipelineRepairVisualReviewInput {
+    schemaVersion: 2;
+    headSha: string;
+    repairId: string;
+    scopeDigest: string;
+    sources: PipelineVisualReviewInput[];
+    retained: Array<{
+        claimId: string;
+        text: string;
+        recipeRunId: string;
+        closureIdentity: string;
+        /** The source's recorded revision; the reviewer diffs from here to headSha. */
+        sourceHeadSha: string;
+    }>;
+}
+export type PipelineReviewInput = PipelineVisualReviewInput | PipelineRepairVisualReviewInput;
+export declare function isPipelineRepairVisualReviewInput(input: PipelineReviewInput): input is PipelineRepairVisualReviewInput;
 /** Validated completed native turn retained until a matching package is prepared. */
 export interface PipelineVisualReviewResult {
     headSha: string;
     binding: PipelineVisualReviewerBinding;
-    result: PipelineVisualJudgments;
+    result: PipelineVisualJudgments | PipelineRepairVisualJudgments;
     completedAt: string;
 }
 /** The same schema constrains the provider and validates its completed result. */
@@ -121,7 +160,142 @@ export declare const PIPELINE_VISUAL_JUDGMENTS_SCHEMA: {
         };
     };
 };
+export declare const PIPELINE_REPAIR_VISUAL_JUDGMENTS_SCHEMA: {
+    type: string;
+    additionalProperties: boolean;
+    required: string[];
+    properties: {
+        schemaVersion: {
+            type: string;
+            enum: number[];
+        };
+        headSha: {
+            type: string;
+            pattern: string;
+        };
+        scopeDigest: {
+            type: string;
+            pattern: string;
+        };
+        sources: {
+            type: string;
+            items: {
+                type: string;
+                additionalProperties: boolean;
+                required: string[];
+                properties: {
+                    schemaVersion: {
+                        type: string;
+                        enum: number[];
+                    };
+                    recipeRunId: {
+                        type: string;
+                        pattern: string;
+                    };
+                    closureIdentity: {
+                        type: string;
+                        pattern: string;
+                    };
+                    judgments: {
+                        type: string;
+                        items: {
+                            type: string;
+                            additionalProperties: boolean;
+                            required: string[];
+                            properties: {
+                                claimId: {
+                                    type: string;
+                                    pattern: string;
+                                };
+                                verdict: {
+                                    type: string;
+                                    enum: string[];
+                                };
+                                reason: {
+                                    type: string;
+                                    pattern: string;
+                                };
+                                reviewedFiles: {
+                                    type: string;
+                                    items: {
+                                        type: string;
+                                        additionalProperties: boolean;
+                                        required: string[];
+                                        properties: {
+                                            path: {
+                                                type: string;
+                                                pattern: string;
+                                            };
+                                            digest: {
+                                                type: string;
+                                                pattern: string;
+                                            };
+                                        };
+                                    };
+                                };
+                                moments: {
+                                    type: string;
+                                    items: {
+                                        type: string;
+                                        additionalProperties: boolean;
+                                        required: string[];
+                                        properties: {
+                                            recipeRunId: {
+                                                type: string;
+                                                pattern: string;
+                                            };
+                                            videoDigest: {
+                                                type: string;
+                                                pattern: string;
+                                            };
+                                            traceIndex: {
+                                                type: string;
+                                                minimum: number;
+                                            };
+                                        };
+                                    };
+                                };
+                            };
+                        };
+                    };
+                };
+            };
+        };
+        retained: {
+            type: string;
+            items: {
+                type: string;
+                additionalProperties: boolean;
+                required: string[];
+                properties: {
+                    claimId: {
+                        type: string;
+                        pattern: string;
+                    };
+                    recipeRunId: {
+                        type: string;
+                        pattern: string;
+                    };
+                    closureIdentity: {
+                        type: string;
+                        pattern: string;
+                    };
+                    unaffected: {
+                        type: string;
+                    };
+                    reason: {
+                        type: string;
+                        pattern: string;
+                    };
+                };
+            };
+        };
+    };
+};
 export declare function isNativeResultSchema(value: unknown): value is NativeResultSchema;
+/** The JSON schema a provider is constrained with for a declared result contract. */
+export declare function nativeResultJsonSchema(schema: NativeResultSchema): Record<string, unknown>;
 export declare function isPipelineVisualJudgments(value: unknown): value is PipelineVisualJudgments;
+export declare function isPipelineRepairVisualJudgments(value: unknown): value is PipelineRepairVisualJudgments;
 export declare function nativeStructuredResult(schema: unknown, value: unknown): NativeStructuredResult | undefined;
 //# sourceMappingURL=pipeline-visual-judgments.d.ts.map

package/dist/recipe/pipeline-visual-judgments.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pipeline-visual-judgments.d.ts","sourceRoot":"","sources":["../../src/recipe/pipeline-visual-judgments.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,oBAAoB,CAAC;AAExE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAGvD,eAAO,MAAM,6BAA6B,iCAAiC,CAAC;AAC5E,MAAM,MAAM,kBAAkB,GAAG,OAAO,6BAA6B,CAAC;AAEtE,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,WAAW,GAAG,UAAU,CAAC;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAClD,OAAO,EAAE,iBAAiB,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,uBAAuB;IACtC,aAAa,EAAE,CAAC,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,sBAAsB,EAAE,CAAC;CACrC;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,kBAAkB,CAAC;IAC3B,KAAK,EAAE,uBAAuB,CAAC;CAChC;AAED,yEAAyE;AACzE,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,sBAAsB,EAAE,SAAS,GAAG,QAAQ,CAAC,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACtF;AAED,qFAAqF;AACrF,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,6BAA6B,CAAC;IACvC,MAAM,EAAE,uBAAuB,CAAC;IAChC,WAAW,EAAE,MAAM,CAAC;CACrB;AAKD,kFAAkF;AAClF,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4C5C,CAAC;AAEF,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,kBAAkB,CAEhF;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,uBAAuB,CAqB1F;AAED,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,OAAO,EACf,KAAK,EAAE,OAAO,GACb,sBAAsB,GAAG,SAAS,CAIpC"}
+{"version":3,"file":"pipeline-visual-judgments.d.ts","sourceRoot":"","sources":["../../src/recipe/pipeline-visual-judgments.ts"],"names":[],"mappings":"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"}

package/dist/recipe/pipeline-visual-judgments.js

@@ -1,6 +1,11 @@
 import { isRecord } from './common.js';
 import { validateRecipeParams } from './params.js';
 export const PIPELINE_VISUAL_RESULT_SCHEMA = 'pipeline-visual-judgments-v1';
+/** Authorised repair review: per-source visual results plus retained-claim applicability. */
+export const PIPELINE_REPAIR_VISUAL_RESULT_SCHEMA = 'pipeline-visual-judgments-v2';
+export function isPipelineRepairVisualReviewInput(input) {
+    return 'schemaVersion' in input && input.schemaVersion === 2;
+}
 const text = { type: 'string', pattern: '\\S' };
 const digest = { type: 'string', pattern: '^sha256:[a-f0-9]{64}$' };
 /** The same schema constrains the provider and validates its completed result. */
@@ -49,8 +54,40 @@ export const PIPELINE_VISUAL_JUDGMENTS_SCHEMA = {
         },
     },
 };
+export const PIPELINE_REPAIR_VISUAL_JUDGMENTS_SCHEMA = {
+    type: 'object',
+    additionalProperties: false,
+    required: ['schemaVersion', 'headSha', 'scopeDigest', 'sources', 'retained'],
+    properties: {
+        schemaVersion: { type: 'integer', enum: [2] },
+        headSha: { type: 'string', pattern: '^[a-f0-9]{40,64}$' },
+        scopeDigest: digest,
+        sources: { type: 'array', items: PIPELINE_VISUAL_JUDGMENTS_SCHEMA },
+        retained: {
+            type: 'array',
+            items: {
+                type: 'object',
+                additionalProperties: false,
+                required: ['claimId', 'recipeRunId', 'closureIdentity', 'unaffected', 'reason'],
+                properties: {
+                    claimId: text,
+                    recipeRunId: text,
+                    closureIdentity: digest,
+                    unaffected: { type: 'boolean' },
+                    reason: text,
+                },
+            },
+        },
+    },
+};
 export function isNativeResultSchema(value) {
-    return value === PIPELINE_VISUAL_RESULT_SCHEMA;
+    return value === PIPELINE_VISUAL_RESULT_SCHEMA || value === PIPELINE_REPAIR_VISUAL_RESULT_SCHEMA;
+}
+/** The JSON schema a provider is constrained with for a declared result contract. */
+export function nativeResultJsonSchema(schema) {
+    return schema === PIPELINE_REPAIR_VISUAL_RESULT_SCHEMA
+        ? PIPELINE_REPAIR_VISUAL_JUDGMENTS_SCHEMA
+        : PIPELINE_VISUAL_JUDGMENTS_SCHEMA;
 }
 export function isPipelineVisualJudgments(value) {
     if (!isRecord(value) ||
@@ -70,9 +107,32 @@ export function isPipelineVisualJudgments(value) {
     }
     return true;
 }
+export function isPipelineRepairVisualJudgments(value) {
+    if (!isRecord(value) ||
+        validateRecipeParams(value, PIPELINE_REPAIR_VISUAL_JUDGMENTS_SCHEMA).status !== 'valid' ||
+        !Array.isArray(value.sources) ||
+        !Array.isArray(value.retained) ||
+        !value.sources.every(isPipelineVisualJudgments))
+        return false;
+    const sources = new Set();
+    for (const source of value.sources) {
+        if (sources.has(source.recipeRunId))
+            return false;
+        sources.add(source.recipeRunId);
+    }
+    const retained = new Set();
+    for (const row of value.retained) {
+        if (retained.has(row.claimId))
+            return false;
+        retained.add(row.claimId);
+    }
+    return true;
+}
 export function nativeStructuredResult(schema, value) {
-    return isNativeResultSchema(schema) && isPipelineVisualJudgments(value)
-        ? { schema, value }
-        : undefined;
+    if (schema === PIPELINE_VISUAL_RESULT_SCHEMA && isPipelineVisualJudgments(value))
+        return { schema, value };
+    if (schema === PIPELINE_REPAIR_VISUAL_RESULT_SCHEMA && isPipelineRepairVisualJudgments(value))
+        return { schema, value };
+    return undefined;
 }
 //# sourceMappingURL=pipeline-visual-judgments.js.map

package/dist/recipe/pipeline-visual-judgments.js.map

@@ -1 +1 @@
-{"version":3,"file":"pipeline-visual-judgments.js","sourceRoot":"","sources":["../../src/recipe/pipeline-visual-judgments.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"pipeline-visual-judgments.js","sourceRoot":"","sources":["../../src/recipe/pipeline-visual-judgments.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAEnD,MAAM,CAAC,MAAM,6BAA6B,GAAG,8BAA8B,CAAC;AAC5E,6FAA6F;AAC7F,MAAM,CAAC,MAAM,oCAAoC,GAAG,8BAA8B,CAAC;AAsEnF,MAAM,UAAU,iCAAiC,CAC/C,KAA0B;IAE1B,OAAO,eAAe,IAAI,KAAK,IAAI,KAAK,CAAC,aAAa,KAAK,CAAC,CAAC;AAC/D,CAAC;AAUD,MAAM,IAAI,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;AAChD,MAAM,MAAM,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,uBAAuB,EAAE,CAAC;AAEpE,kFAAkF;AAClF,MAAM,CAAC,MAAM,gCAAgC,GAAG;IAC9C,IAAI,EAAE,QAAQ;IACd,oBAAoB,EAAE,KAAK;IAC3B,QAAQ,EAAE,CAAC,eAAe,EAAE,aAAa,EAAE,iBAAiB,EAAE,WAAW,CAAC;IAC1E,UAAU,EAAE;QACV,aAAa,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE;QAC7C,WAAW,EAAE,IAAI;QACjB,eAAe,EAAE,MAAM;QACvB,SAAS,EAAE;YACT,IAAI,EAAE,OAAO;YACb,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,oBAAoB,EAAE,KAAK;gBAC3B,QAAQ,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,eAAe,EAAE,SAAS,CAAC;gBACtE,UAAU,EAAE;oBACV,OAAO,EAAE,IAAI;oBACb,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,UAAU,CAAC,EAAE;oBAC5D,MAAM,EAAE,IAAI;oBACZ,aAAa,EAAE;wBACb,IAAI,EAAE,OAAO;wBACb,KAAK,EAAE;4BACL,IAAI,EAAE,QAAQ;4BACd,oBAAoB,EAAE,KAAK;4BAC3B,QAAQ,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC;4BAC5B,UAAU,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE;yBACnC;qBACF;oBACD,OAAO,EAAE;wBACP,IAAI,EAAE,OAAO;wBACb,KAAK,EAAE;4BACL,IAAI,EAAE,QAAQ;4BACd,oBAAoB,EAAE,KAAK;4BAC3B,QAAQ,EAAE,CAAC,aAAa,EAAE,aAAa,EAAE,YAAY,CAAC;4BACtD,UAAU,EAAE;gCACV,WAAW,EAAE,IAAI;gCACjB,WAAW,EAAE,MAAM;gCACnB,UAAU,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE;6BAC5C;yBACF;qBACF;iBACF;aACF;SACF;KACF;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,uCAAuC,GAAG;IACrD,IAAI,EAAE,QAAQ;IACd,oBAAoB,EAAE,KAAK;IAC3B,QAAQ,EAAE,CAAC,eAAe,EAAE,SAAS,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,CAAC;IAC5E,UAAU,EAAE;QACV,aAAa,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE;QAC7C,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,mBAAmB,EAAE;QACzD,WAAW,EAAE,MAAM;QACnB,OAAO,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,gCAAgC,EAAE;QACnE,QAAQ,EAAE;YACR,IAAI,EAAE,OAAO;YACb,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,oBAAoB,EAAE,KAAK;gBAC3B,QAAQ,EAAE,CAAC,SAAS,EAAE,aAAa,EAAE,iBAAiB,EAAE,YAAY,EAAE,QAAQ,CAAC;gBAC/E,UAAU,EAAE;oBACV,OAAO,EAAE,IAAI;oBACb,WAAW,EAAE,IAAI;oBACjB,eAAe,EAAE,MAAM;oBACvB,UAAU,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;oBAC/B,MAAM,EAAE,IAAI;iBACb;aACF;SACF;KACF;CACF,CAAC;AAEF,MAAM,UAAU,oBAAoB,CAAC,KAAc;IACjD,OAAO,KAAK,KAAK,6BAA6B,IAAI,KAAK,KAAK,oCAAoC,CAAC;AACnG,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,sBAAsB,CAAC,MAA0B;IAC/D,OAAO,MAAM,KAAK,oCAAoC;QACpD,CAAC,CAAC,uCAAuC;QACzC,CAAC,CAAC,gCAAgC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,KAAc;IACtD,IACE,CAAC,QAAQ,CAAC,KAAK,CAAC;QAChB,oBAAoB,CAAC,KAAK,EAAE,gCAAgC,CAAC,CAAC,MAAM,KAAK,OAAO;QAChF,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC;QAE/B,OAAO,KAAK,CAAC;IACf,MAAM,MAAM,GAAG,IAAI,GAAG,EAAU,CAAC;IACjC,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;QAClC,IACE,CAAC,QAAQ,CAAC,GAAG,CAAC;YACd,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ;YAC/B,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC;YACvB,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;YACjC,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC;YAC3B,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC,MAAM,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC;YAElD,OAAO,KAAK,CAAC;QACf,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC1B,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,+BAA+B,CAC7C,KAAc;IAEd,IACE,CAAC,QAAQ,CAAC,KAAK,CAAC;QAChB,oBAAoB,CAAC,KAAK,EAAE,uCAAuC,CAAC,CAAC,MAAM,KAAK,OAAO;QACvF,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC;QAC7B,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC;QAC9B,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,yBAAyB,CAAC;QAE/C,OAAO,KAAK,CAAC;IACf,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,KAAK,MAAM,MAAM,IAAI,KAAK,CAAC,OAAoC,EAAE,CAAC;QAChE,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC;YAAE,OAAO,KAAK,CAAC;QAClD,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IAClC,CAAC;IACD,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;IACnC,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,QAAyC,EAAE,CAAC;QAClE,IAAI,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC;YAAE,OAAO,KAAK,CAAC;QAC5C,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC5B,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,MAAe,EACf,KAAc;IAEd,IAAI,MAAM,KAAK,6BAA6B,IAAI,yBAAyB,CAAC,KAAK,CAAC;QAC9E,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IAC3B,IAAI,MAAM,KAAK,oCAAoC,IAAI,+BAA+B,CAAC,KAAK,CAAC;QAC3F,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IAC3B,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/recipe/repair.d.ts

@@ -0,0 +1,93 @@
+import { type RecipeValidationResult } from './common.js';
+import { type EvidenceMomentRef, type RecipeClaimDeclaration, type RecipeClaimEvidence, type RecipeClaimProofMode } from './evidence.js';
+/** The publication gate action that returns qualified Issues to the retained worker. */
+export declare const SEND_BACK_TO_AGENT_ACTION = "send-feedback";
+/** Gateway-written worker input; the run store keeps its authoritative digest. */
+export declare const RECIPE_REPAIR_SCOPE_TASK_PATH = "artifacts/visual-repair-scope.json";
+/** Checked scope copy retained in the fresh attempt. */
+export declare const RECIPE_REPAIR_SCOPE_FILE = "repair-scope.json";
+/** Engine-owned claim-to-source selection retained in the fresh attempt. */
+export declare const RECIPE_REPAIR_SELECTION_FILE = "repair-selection.json";
+/** An original recorded execution that non-rejected criteria may keep. */
+export interface RecipeRepairSource {
+    recipeRunId: string;
+    closureIdentity: string;
+    /** Task-relative root of the retained package. */
+    artifactRoot: string;
+    /** Commit the source was recorded at; applicability diffs start here. */
+    headSha: string;
+}
+/** A qualified Issue frozen from its gateway receipt. */
+export interface RecipeRepairRejection {
+    claimId: string;
+    /** Original proof mode; fresh proof must not weaken it. */
+    proofMode: RecipeClaimProofMode;
+    receiptId: string;
+    reason: string;
+    recipeRunId: string;
+    closureIdentity: string;
+    reviewedFiles: {
+        path: string;
+        digest: string;
+    }[];
+    moments: EvidenceMomentRef[];
+}
+export interface RecipeRepairScope {
+    schemaVersion: 1;
+    repairId: string;
+    runId: string;
+    generation: number;
+    decisionId: string;
+    packageHash: string;
+    packageHeadSha: string;
+    reviewBaseSha: string;
+    /** Retained review loop whose existing worker-fix budget pays for this repair. */
+    reviewId: string;
+    /** Agent context owning the retained worker. */
+    workerContextId: string;
+    /** Task-relative path of the separate repair recipe. The main task recipe is unchanged. */
+    repairRecipe: string;
+    /** The full task registration. */
+    claims: RecipeClaimDeclaration[];
+    sources: RecipeRepairSource[];
+    /** Every non-rejected registered criterion and the original source it currently selects. */
+    retained: {
+        claimId: string;
+        recipeRunId: string;
+    }[];
+    rejected: RecipeRepairRejection[];
+}
+export type RecipeRepairClaimSource = {
+    claimId: string;
+    source: 'fresh';
+} | {
+    claimId: string;
+    source: 'retained';
+    recipeRunId: string;
+    closureIdentity: string;
+};
+export interface RecipeRepairSelection {
+    schemaVersion: 1;
+    repairId: string;
+    scopeDigest: string;
+    /** The fresh execution. */
+    recipeRunId: string;
+    claims: RecipeRepairClaimSource[];
+}
+/** One identity per package and sorted rejection receipts, so retries reuse the same charge. */
+export declare function recipeRepairId(input: {
+    runId: string;
+    packageHash: string;
+    receiptIds: readonly string[];
+}): string;
+export declare function recipeRepairScopeDigest(scope: RecipeRepairScope): string;
+/** Rejected criteria always re-prove; others keep retained proof only when the fresh graph left them missing. */
+export declare function selectRepairClaimSources(scope: RecipeRepairScope, fresh: readonly RecipeClaimEvidence[]): RecipeRepairClaimSource[];
+export declare function validateRecipeRepairScope(value: unknown): RecipeValidationResult;
+export declare function isRecipeRepairScope(value: unknown): value is RecipeRepairScope;
+/** The selection must be exactly the engine rule over the scope and the fresh claims. */
+export declare function validateRecipeRepairSelection(value: unknown, scope: RecipeRepairScope, fresh: {
+    recipeRunId: string;
+    criteria: readonly RecipeClaimEvidence[];
+}): RecipeValidationResult;
+//# sourceMappingURL=repair.d.ts.map

package/dist/recipe/repair.d.ts.map

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

package/dist/recipe/repair.js

@@ -0,0 +1,213 @@
+import { addFinding, createContext, finishResult, isNonEmptyString, isRecord, isRelativeArtifactPath, } from './common.js';
+import { digestRecipeDocument } from './digest.js';
+import { normalizeRecipeClaimId, validateRecipeClaimDeclarations, } from './evidence.js';
+/** The publication gate action that returns qualified Issues to the retained worker. */
+export const SEND_BACK_TO_AGENT_ACTION = 'send-feedback';
+/** Gateway-written worker input; the run store keeps its authoritative digest. */
+export const RECIPE_REPAIR_SCOPE_TASK_PATH = 'artifacts/visual-repair-scope.json';
+/** Checked scope copy retained in the fresh attempt. */
+export const RECIPE_REPAIR_SCOPE_FILE = 'repair-scope.json';
+/** Engine-owned claim-to-source selection retained in the fresh attempt. */
+export const RECIPE_REPAIR_SELECTION_FILE = 'repair-selection.json';
+/** One identity per package and sorted rejection receipts, so retries reuse the same charge. */
+export function recipeRepairId(input) {
+    const digest = digestRecipeDocument({
+        runId: input.runId,
+        packageHash: input.packageHash,
+        receiptIds: [...input.receiptIds].sort(),
+    });
+    return `repair-${digest.slice('sha256:'.length, 'sha256:'.length + 24)}`;
+}
+export function recipeRepairScopeDigest(scope) {
+    return digestRecipeDocument(scope);
+}
+/** Rejected criteria always re-prove; others keep retained proof only when the fresh graph left them missing. */
+export function selectRepairClaimSources(scope, fresh) {
+    const rejected = new Set(scope.rejected.map(({ claimId }) => claimId));
+    return scope.claims.map(({ id }) => {
+        const claimId = normalizeRecipeClaimId(id);
+        const freshClaim = fresh.find((claim) => claim.id === claimId);
+        if (rejected.has(claimId) || (freshClaim && freshClaim.verdict !== 'missing'))
+            return { claimId, source: 'fresh' };
+        const retained = scope.retained.find((row) => row.claimId === claimId);
+        const source = scope.sources.find((row) => row.recipeRunId === retained.recipeRunId);
+        return {
+            claimId,
+            source: 'retained',
+            recipeRunId: source.recipeRunId,
+            closureIdentity: source.closureIdentity,
+        };
+    });
+}
+const DIGEST = /^sha256:[a-f0-9]{64}$/u;
+/** The ready gate's frozen package identity: a bare sha256 hex digest. */
+const PACKAGE_HASH = /^[a-f0-9]{64}$/u;
+const COMMIT = /^[a-f0-9]{40,64}$/u;
+const EXECUTION = /^[A-Za-z0-9._-]+$/u;
+const PROOF_MODES = ['state', 'visual', 'mixed'];
+function validExecutionId(value) {
+    return typeof value === 'string' && EXECUTION.test(value) && !['.', '..'].includes(value);
+}
+function validMoments(value) {
+    return (Array.isArray(value) &&
+        value.every((moment) => isRecord(moment) &&
+            validExecutionId(moment.recipeRunId) &&
+            typeof moment.videoDigest === 'string' &&
+            DIGEST.test(moment.videoDigest) &&
+            Number.isInteger(moment.traceIndex) &&
+            Number(moment.traceIndex) >= 0));
+}
+function validFiles(value) {
+    return (Array.isArray(value) &&
+        value.every((file) => isRecord(file) &&
+            isNonEmptyString(file.path) &&
+            isRelativeArtifactPath(file.path) &&
+            typeof file.digest === 'string' &&
+            DIGEST.test(file.digest)));
+}
+export function validateRecipeRepairScope(value) {
+    const context = createContext();
+    const issue = (path, message) => addFinding(context, 'error', 'recipe.invalid_repair_scope', path, message);
+    if (!isRecord(value)) {
+        issue('scope', 'A repair scope must be an object.');
+        return finishResult(context);
+    }
+    if (value.schemaVersion !== 1)
+        issue('schemaVersion', 'Unsupported repair scope version.');
+    for (const field of [
+        'repairId',
+        'runId',
+        'decisionId',
+        'reviewId',
+        'workerContextId',
+        'repairRecipe',
+    ])
+        if (!isNonEmptyString(value[field]))
+            issue(field, `${field} is required.`);
+    if (!Number.isInteger(value.generation) || Number(value.generation) < 0)
+        issue('generation', 'A run generation is required.');
+    if (typeof value.packageHash !== 'string' || !PACKAGE_HASH.test(value.packageHash))
+        issue('packageHash', 'A frozen package digest is required.');
+    for (const field of ['packageHeadSha', 'reviewBaseSha'])
+        if (typeof value[field] !== 'string' || !COMMIT.test(value[field]))
+            issue(field, `${field} must be a full commit.`);
+    if (typeof value.repairRecipe === 'string' &&
+        (!isRelativeArtifactPath(value.repairRecipe) || value.repairRecipe.startsWith('artifacts/')))
+        issue('repairRecipe', 'The repair recipe must be a task-owned relative path.');
+    const declarations = validateRecipeClaimDeclarations(value.claims);
+    for (const finding of declarations.findings)
+        addFinding(context, finding.severity, finding.code, `claims.${finding.path}`, finding.message);
+    const claims = Array.isArray(value.claims) ? value.claims.filter(isRecord) : [];
+    if (!claims.length)
+        issue('claims', 'The full task registration is required.');
+    if (claims.some((claim) => claim.parentId !== undefined))
+        issue('claims', 'Nested criteria cannot be repaired by claim selection.');
+    const registered = claims.map((claim) => normalizeRecipeClaimId(String(claim.id)));
+    const sources = Array.isArray(value.sources) ? value.sources : [];
+    const sourceIds = new Set();
+    for (const [index, source] of sources.entries()) {
+        if (!isRecord(source) ||
+            !validExecutionId(source.recipeRunId) ||
+            sourceIds.has(source.recipeRunId) ||
+            typeof source.closureIdentity !== 'string' ||
+            !DIGEST.test(source.closureIdentity) ||
+            typeof source.artifactRoot !== 'string' ||
+            !source.artifactRoot.startsWith('artifacts/') ||
+            !isRelativeArtifactPath(source.artifactRoot) ||
+            typeof source.headSha !== 'string' ||
+            !COMMIT.test(source.headSha)) {
+            issue(`sources[${index}]`, 'Invalid or duplicate retained source.');
+            continue;
+        }
+        sourceIds.add(source.recipeRunId);
+    }
+    if (!sources.length)
+        issue('sources', 'At least one original source is required.');
+    const rejected = Array.isArray(value.rejected) ? value.rejected : [];
+    const rejectedIds = new Set();
+    for (const [index, row] of rejected.entries()) {
+        const path = `rejected[${index}]`;
+        if (!isRecord(row) ||
+            typeof row.claimId !== 'string' ||
+            !registered.includes(row.claimId) ||
+            rejectedIds.has(row.claimId) ||
+            !PROOF_MODES.includes(String(row.proofMode)) ||
+            !isNonEmptyString(row.receiptId) ||
+            !isNonEmptyString(row.reason) ||
+            !validExecutionId(row.recipeRunId) ||
+            !sourceIds.has(row.recipeRunId) ||
+            typeof row.closureIdentity !== 'string' ||
+            !DIGEST.test(row.closureIdentity) ||
+            !validFiles(row.reviewedFiles) ||
+            !validMoments(row.moments)) {
+            issue(path, 'Invalid, unregistered or duplicate rejected criterion.');
+            continue;
+        }
+        rejectedIds.add(row.claimId);
+    }
+    if (!rejected.length)
+        issue('rejected', 'A repair requires at least one Issue.');
+    const retained = Array.isArray(value.retained) ? value.retained : [];
+    const retainedIds = new Set();
+    for (const [index, row] of retained.entries()) {
+        if (!isRecord(row) ||
+            typeof row.claimId !== 'string' ||
+            !registered.includes(row.claimId) ||
+            rejectedIds.has(row.claimId) ||
+            retainedIds.has(row.claimId) ||
+            typeof row.recipeRunId !== 'string' ||
+            !sourceIds.has(row.recipeRunId)) {
+            issue(`retained[${index}]`, 'Invalid, rejected or duplicate retained criterion.');
+            continue;
+        }
+        retainedIds.add(row.claimId);
+    }
+    if (registered.some((id) => !rejectedIds.has(id) && !retainedIds.has(id)))
+        issue('retained', 'Every non-rejected criterion must name its current source.');
+    if (isNonEmptyString(value.runId) &&
+        typeof value.packageHash === 'string' &&
+        value.repairId !==
+            recipeRepairId({
+                runId: value.runId,
+                packageHash: value.packageHash,
+                receiptIds: rejected.filter(isRecord).map((row) => String(row.receiptId)),
+            }))
+        issue('repairId', 'Repair identity does not bind the package and rejection receipts.');
+    return finishResult(context);
+}
+export function isRecipeRepairScope(value) {
+    return validateRecipeRepairScope(value).status === 'valid';
+}
+/** The selection must be exactly the engine rule over the scope and the fresh claims. */
+export function validateRecipeRepairSelection(value, scope, fresh) {
+    const context = createContext();
+    const issue = (path, message) => addFinding(context, 'error', 'recipe.invalid_repair_selection', path, message);
+    if (!isRecord(value)) {
+        issue('selection', 'A repair selection must be an object.');
+        return finishResult(context);
+    }
+    if (value.schemaVersion !== 1)
+        issue('schemaVersion', 'Unsupported repair selection version.');
+    if (value.repairId !== scope.repairId)
+        issue('repairId', 'Selection belongs to another repair.');
+    if (value.scopeDigest !== recipeRepairScopeDigest(scope))
+        issue('scopeDigest', 'Selection does not bind the retained repair scope.');
+    if (value.recipeRunId !== fresh.recipeRunId)
+        issue('recipeRunId', 'Selection belongs to another fresh execution.');
+    const registered = new Set(scope.claims.map(({ id }) => normalizeRecipeClaimId(id)));
+    const freshIds = new Set(fresh.criteria.map(({ id }) => id));
+    if (fresh.criteria.length !== registered.size ||
+        freshIds.size !== registered.size ||
+        [...registered].some((id) => !freshIds.has(id)))
+        issue('claims', 'The fresh execution must keep the full task registration.');
+    for (const rejection of scope.rejected) {
+        const claim = fresh.criteria.find(({ id }) => id === rejection.claimId);
+        if (claim && claim.proofMode !== rejection.proofMode)
+            issue(`claims.${rejection.claimId}.proofMode`, `Fresh proof must keep the original ${rejection.proofMode} proof mode.`);
+    }
+    if (digestRecipeDocument(value.claims) !==
+        digestRecipeDocument(selectRepairClaimSources(scope, fresh.criteria)))
+        issue('claims', 'Selection differs from the engine claim-source rule.');
+    return finishResult(context);
+}
+//# sourceMappingURL=repair.js.map