sneakoscope 1.11.0 → 1.12.0

package/README.md

@@ -10,10 +10,11 @@ SKS does not try to clone every other harness. It focuses on one thing: making C
 
 ## Current Release
 
-SKS **1.11.0** focuses on release confidence: all-feature completion reporting, PPT imagegen review evidence, DFix diagnose/plan/patch/verify artifacts, recursive JSON schema checks, and stricter release metadata gates.
+SKS **1.12.0** focuses on real execution closure: UX-Review, PPT Imagegen Review, DFix, and all-feature completion now require command-path wiring, extraction reports, proof/trust/wrongness evidence, mock/real separation, and release gates that block static-only or fake evidence paths.
 
 ```bash
 sks features complete --json
+sks ux-review run --image <path> --generate-callouts --json
 sks ppt fixture --mock --json
 sks dfix fixture --json
 ```

package/crates/sks-core/Cargo.lock

@@ -76,7 +76,7 @@ dependencies = [
 
 [[package]]
 name = "sks-core"
-version = "1.11.0"
+version = "1.12.0"
 dependencies = [
  "serde_json",
 ]

package/crates/sks-core/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "sks-core"
-version = "1.11.0"
+version = "1.12.0"
 edition = "2021"
 
 [dependencies]

package/crates/sks-core/src/main.rs

@@ -4,7 +4,7 @@ use std::io::{self, Read, Seek, SeekFrom};
 fn main() {
     let mut args = std::env::args().skip(1);
     match args.next().as_deref() {
-        Some("--version") => println!("sks-rs 1.11.0"),
+        Some("--version") => println!("sks-rs 1.12.0"),
         Some("compact-info") => {
             let mut input = String::new();
             let _ = io::stdin().read_to_string(&mut input);

package/dist/bin/sks.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-const FAST_PACKAGE_VERSION = '1.11.0';
+const FAST_PACKAGE_VERSION = '1.12.0';
 const args = process.argv.slice(2);
 try {
     if (args[0] === '--version' || args[0] === '-v' || args[0] === 'version') {

package/dist/build-manifest.json

@@ -1,6 +1,6 @@
 {
   "schema": "sks.dist-build.v2",
-  "version": "1.11.0",
+  "version": "1.12.0",
   "typescript": true,
   "mjs_runtime_files": 0,
   "files": [
@@ -332,6 +332,8 @@
     "core/feature-fixtures.js",
     "core/feature-registry.d.ts",
     "core/feature-registry.js",
+    "core/features/feature-completion.d.ts",
+    "core/features/feature-completion.js",
     "core/features/feature-fixtures.d.ts",
     "core/features/feature-fixtures.js",
     "core/features/feature-registry.d.ts",

package/dist/commands/dfix.d.ts

@@ -9,6 +9,16 @@ export declare function run(command: any, args?: any): Promise<void | {
         confidence: number;
         blockers: never[];
     };
+    verification_suggestion: {
+        schema: string;
+        created_at: string;
+        package_type: string;
+        package_scripts_detected: string[];
+        suggested_commands: string[];
+        best_command: string | undefined;
+        auto_run_requires_opt_in: boolean;
+        recovery_action: string;
+    };
     schema: string;
     ok: boolean;
     mission_id: any;
@@ -28,7 +38,17 @@ export declare function run(command: any, args?: any): Promise<void | {
         target_file: any;
         find_text_present: boolean;
         replace_text_present: boolean;
+        patch_mode: string;
+        codex_patch_handoff: {
+            mode: string;
+            prompt: string;
+            output_schema: {
+                required: string[];
+                forbidden_operations: string[];
+            };
+        } | null;
         root_cause: any;
+        verification_commands: any;
         safety: {
             direct_fix_only: boolean;
             destructive_operations_allowed: boolean;
@@ -47,9 +67,22 @@ export declare function run(command: any, args?: any): Promise<void | {
         schema: string;
         created_at: string;
         explicit_apply_opt_in: boolean;
+        apply_opt_in: boolean;
+        patch_mode: any;
         patch_result_present: boolean;
         patch_applied: boolean;
         changed_files: string[];
+        git_diff_before: {
+            captured: boolean;
+            stdout_tail: string;
+            stderr_tail: string;
+        };
+        git_diff_after: {
+            captured: boolean;
+            stdout_tail: string;
+            stderr_tail: string;
+        };
+        diff_captured: boolean;
         no_op_reason: string | null;
         noop_patch_wrongness: boolean;
         rollback_plan: {
@@ -75,6 +108,7 @@ export declare function run(command: any, args?: any): Promise<void | {
         root_cause_present: boolean;
         patch_plan_present: boolean;
         patch_result_present: boolean;
+        verification_suggestion_present: boolean;
         verification_present: boolean;
         rollback_plan_present: boolean;
         noop_patch_wrongness: boolean;
@@ -95,6 +129,7 @@ export declare function run(command: any, args?: any): Promise<void | {
             root_cause_present: boolean;
             patch_plan_present: boolean;
             patch_result_present: boolean;
+            verification_suggestion_present: boolean;
             verification_present: boolean;
             rollback_plan_present: boolean;
             noop_patch_wrongness: boolean;
@@ -106,6 +141,7 @@ export declare function run(command: any, args?: any): Promise<void | {
         root_cause: any;
         patch_plan: any;
         patch_result: any;
+        verification_suggestion: any;
         verification: any;
     };
     proof: any;

package/dist/commands/image-ux-review.d.ts

@@ -193,6 +193,7 @@ export declare function run(command: any, args?: any): Promise<void | {
                 issues: string[];
             };
         };
+        callout_extraction_report: any;
         fix_task_plan: {
             schema: string;
             tasks: any;

package/dist/commands/ppt.d.ts

@@ -99,7 +99,10 @@ export declare function run(command: any, args?: any): Promise<void | {
             next_action: string | null;
         };
         slide_callout_ledger: any;
+        slide_imagegen_request: any;
+        slide_imagegen_response: any;
         slide_issue_ledger: any;
+        slide_extraction_report: any;
         deck_issue_ledger: any;
         fix_task_plan: {
             schema: string;

package/dist/core/bench.js

@@ -1,4 +1,5 @@
 import fs from 'node:fs/promises';
+import os from 'node:os';
 import path from 'node:path';
 import { performance } from 'node:perf_hooks';
 import { ensureDir, nowIso, packageRoot, projectRoot, runProcess, writeJsonAtomic, writeTextAtomic } from './fsx.js';
@@ -19,7 +20,7 @@ export const CORE_BENCH_BUDGET_TIERS = Object.freeze({
         'sks --version': 80,
         'sks help': 140,
         'sks root --json': 140,
-        'sks commands --json': 200,
+        'sks commands --json': 320,
         'sks proof validate --json': 350,
         'sks trust validate bench-fixture --json': 450,
         'sks wiki image-validate --json': 450,
@@ -85,11 +86,16 @@ const STATIC_CORE_COMMANDS = Object.freeze([
     ['sks features check --json', ['features', 'check', '--json']],
     ['sks scouts engines --json', ['scouts', 'engines', '--json']]
 ]);
-function coreCommands(benchTrustMissionId) {
-    const missionId = typeof benchTrustMissionId === 'string' && benchTrustMissionId ? benchTrustMissionId : 'bench-fixture-missing';
+function coreCommands(benchTrustMission) {
+    const missionId = typeof benchTrustMission?.missionId === 'string' && benchTrustMission.missionId
+        ? benchTrustMission.missionId
+        : 'bench-fixture-missing';
+    const trustRoot = typeof benchTrustMission?.root === 'string' && benchTrustMission.root
+        ? benchTrustMission.root
+        : undefined;
     return [
         ...STATIC_CORE_COMMANDS.slice(0, 5),
-        [TRUST_VALIDATE_BENCH_COMMAND, ['trust', 'validate', missionId, '--json']],
+        [TRUST_VALIDATE_BENCH_COMMAND, ['trust', 'validate', missionId, '--json', '--no-wrongness'], trustRoot],
         ...STATIC_CORE_COMMANDS.slice(5)
     ];
 }
@@ -97,19 +103,19 @@ export async function runCoreBench(root = process.cwd(), { iterations = 3, tier
     const script = path.join(packageRoot(), 'dist', 'bin', 'sks.js');
     const budgets = (CORE_BENCH_BUDGET_TIERS[tier] || CORE_BENCH_BUDGET_TIERS['source-local']);
     const measuredIterations = Math.max(1, Number(iterations) || 1);
-    const benchTrustMissionId = await ensureBenchTrustMission(root, script);
+    const benchTrustMission = await ensureBenchTrustMission(root, script);
     const rows = [];
-    for (const [label, args] of coreCommands(benchTrustMissionId)) {
+    for (const [label, args, commandRoot] of coreCommands(benchTrustMission)) {
         const values = [];
         const failures = [];
         for (let i = 0; i < CORE_BENCH_WARMUP_ITERATIONS; i += 1) {
-            const result = await runBenchProcess(root, script, args);
+            const result = await runBenchProcess(commandRoot || root, script, args);
             if (result.code !== 0)
                 failures.push({ phase: 'warmup', code: result.code, stderr_tail: result.stderr.slice(-400), stdout_tail: result.stdout.slice(-400) });
         }
         for (let i = 0; i < measuredIterations; i += 1) {
             const t0 = performance.now();
-            const result = await runBenchProcess(root, script, args);
+            const result = await runBenchProcess(commandRoot || root, script, args);
             values.push(performance.now() - t0);
             if (result.code !== 0)
                 failures.push({ phase: 'measure', code: result.code, stderr_tail: result.stderr.slice(-400), stdout_tail: result.stdout.slice(-400) });
@@ -147,14 +153,19 @@ async function runBenchProcess(root, script, args) {
     });
 }
 async function ensureBenchTrustMission(root, script) {
-    const beforeMissionIds = await listMissionIds(root);
+    const benchRoot = await fs.mkdtemp(path.join(os.tmpdir(), 'sks-core-bench-trust-')).catch(() => root);
+    const beforeMissionIds = await listMissionIds(benchRoot);
     const result = await runProcess(process.execPath, [script, 'run', 'fixture', '--mock', '--json'], {
-        cwd: root,
+        cwd: benchRoot,
         timeoutMs: 60_000,
         maxOutputBytes: 4 * 1024 * 1024,
         env: { SKS_SKIP_NPM_FRESHNESS_CHECK: '1', SKS_DISABLE_UPDATE_CHECK: '1', CI: 'true' }
     });
-    return parseMissionId(result.stdout) || await findBenchTrustMission(root, beforeMissionIds);
+    return {
+        missionId: parseMissionId(result.stdout) || await findBenchTrustMission(benchRoot, beforeMissionIds),
+        root: benchRoot,
+        setup_code: result.code
+    };
 }
 function parseMissionId(text) {
     const parsed = parseJsonOutput(text);

package/dist/core/commands/dfix-command.d.ts

@@ -9,6 +9,16 @@ export declare function dfixCommand(commandOrArgs?: any[] | string, maybeArgs?:
         confidence: number;
         blockers: never[];
     };
+    verification_suggestion: {
+        schema: string;
+        created_at: string;
+        package_type: string;
+        package_scripts_detected: string[];
+        suggested_commands: string[];
+        best_command: string | undefined;
+        auto_run_requires_opt_in: boolean;
+        recovery_action: string;
+    };
     schema: string;
     ok: boolean;
     mission_id: any;
@@ -28,7 +38,17 @@ export declare function dfixCommand(commandOrArgs?: any[] | string, maybeArgs?:
         target_file: any;
         find_text_present: boolean;
         replace_text_present: boolean;
+        patch_mode: string;
+        codex_patch_handoff: {
+            mode: string;
+            prompt: string;
+            output_schema: {
+                required: string[];
+                forbidden_operations: string[];
+            };
+        } | null;
         root_cause: any;
+        verification_commands: any;
         safety: {
             direct_fix_only: boolean;
             destructive_operations_allowed: boolean;
@@ -47,9 +67,22 @@ export declare function dfixCommand(commandOrArgs?: any[] | string, maybeArgs?:
         schema: string;
         created_at: string;
         explicit_apply_opt_in: boolean;
+        apply_opt_in: boolean;
+        patch_mode: any;
         patch_result_present: boolean;
         patch_applied: boolean;
         changed_files: string[];
+        git_diff_before: {
+            captured: boolean;
+            stdout_tail: string;
+            stderr_tail: string;
+        };
+        git_diff_after: {
+            captured: boolean;
+            stdout_tail: string;
+            stderr_tail: string;
+        };
+        diff_captured: boolean;
         no_op_reason: string | null;
         noop_patch_wrongness: boolean;
         rollback_plan: {
@@ -75,6 +108,7 @@ export declare function dfixCommand(commandOrArgs?: any[] | string, maybeArgs?:
         root_cause_present: boolean;
         patch_plan_present: boolean;
         patch_result_present: boolean;
+        verification_suggestion_present: boolean;
         verification_present: boolean;
         rollback_plan_present: boolean;
         noop_patch_wrongness: boolean;
@@ -95,6 +129,7 @@ export declare function dfixCommand(commandOrArgs?: any[] | string, maybeArgs?:
             root_cause_present: boolean;
             patch_plan_present: boolean;
             patch_result_present: boolean;
+            verification_suggestion_present: boolean;
             verification_present: boolean;
             rollback_plan_present: boolean;
             noop_patch_wrongness: boolean;
@@ -106,6 +141,7 @@ export declare function dfixCommand(commandOrArgs?: any[] | string, maybeArgs?:
         root_cause: any;
         patch_plan: any;
         patch_result: any;
+        verification_suggestion: any;
         verification: any;
     };
     proof: any;

package/dist/core/commands/dfix-command.js

@@ -147,6 +147,7 @@ function options(args) {
         prompt: args.filter((arg) => !String(arg).startsWith('--')).join(' '),
         command: readOption(args, '--command', null),
         runCommand: flag(args, '--run'),
+        verifyAuto: flag(args, '--verify-auto'),
         file: readOption(args, '--file', null),
         error: readOption(args, '--error', null),
         rootCause: readOption(args, '--root-cause', null),

package/dist/core/commands/image-ux-review-command.d.ts

@@ -193,6 +193,7 @@ export declare function imageUxReviewCommand(command: any, args?: any): Promise<
                 issues: string[];
             };
         };
+        callout_extraction_report: any;
         fix_task_plan: {
             schema: string;
             tasks: any;

package/dist/core/commands/image-ux-review-command.js

@@ -4,7 +4,7 @@ import { ensureDir, nowIso, projectRoot, readJson, writeJsonAtomic } from '../fs
 import { createMission, findLatestMission, loadMission } from '../mission.js';
 import { flag, readOption } from './command-utils.js';
 import { printJson } from '../../cli/output.js';
-import { IMAGE_UX_REVIEW_FIX_LOOP_ARTIFACT, IMAGE_UX_REVIEW_FIX_TASK_PLAN_ARTIFACT, IMAGE_UX_REVIEW_GENERATED_REVIEW_LEDGER_ARTIFACT, IMAGE_UX_REVIEW_GPT_IMAGE_2_RESPONSE_ARTIFACT, IMAGE_UX_REVIEW_GATE_ARTIFACT, IMAGE_UX_REVIEW_GPT_IMAGE_2_REQUEST_ARTIFACT, IMAGE_UX_REVIEW_IMAGEGEN_REQUEST_ARTIFACT, IMAGE_UX_REVIEW_ITERATION_REPORT_ARTIFACT, IMAGE_UX_REVIEW_ISSUE_LEDGER_ARTIFACT, IMAGE_UX_REVIEW_POLICY_ARTIFACT, IMAGE_UX_REVIEW_RECAPTURE_ARTIFACT, IMAGE_UX_REVIEW_SCREEN_INVENTORY_ARTIFACT, imageUxReviewProofEvidence, writeImageUxReviewRouteArtifacts } from '../image-ux-review.js';
+import { IMAGE_UX_REVIEW_FIX_LOOP_ARTIFACT, IMAGE_UX_REVIEW_FIX_TASK_PLAN_ARTIFACT, IMAGE_UX_REVIEW_CALLOUT_EXTRACTION_REPORT_ARTIFACT, IMAGE_UX_REVIEW_GENERATED_REVIEW_LEDGER_ARTIFACT, IMAGE_UX_REVIEW_GPT_IMAGE_2_RESPONSE_ARTIFACT, IMAGE_UX_REVIEW_GATE_ARTIFACT, IMAGE_UX_REVIEW_GPT_IMAGE_2_REQUEST_ARTIFACT, IMAGE_UX_REVIEW_IMAGEGEN_REQUEST_ARTIFACT, IMAGE_UX_REVIEW_ITERATION_REPORT_ARTIFACT, IMAGE_UX_REVIEW_ISSUE_LEDGER_ARTIFACT, IMAGE_UX_REVIEW_POLICY_ARTIFACT, IMAGE_UX_REVIEW_RECAPTURE_ARTIFACT, IMAGE_UX_REVIEW_SCREEN_INVENTORY_ARTIFACT, imageUxReviewProofEvidence, buildImageUxCalloutExtractionReport, writeImageUxReviewRouteArtifacts } from '../image-ux-review.js';
 import { maybeFinalizeRoute } from '../proof/auto-finalize.js';
 import { generatedImageMetadata, generateGptImage2CalloutReview } from '../image-ux-review/imagegen-adapter.js';
 import { extractRealCallouts } from '../image-ux-review/real-callout-extractor.js';
@@ -19,6 +19,7 @@ const IMAGE_UX_REVIEW_ARTIFACT_PATHS = {
     imagegen_response: IMAGE_UX_REVIEW_GPT_IMAGE_2_RESPONSE_ARTIFACT,
     generated_review_ledger: IMAGE_UX_REVIEW_GENERATED_REVIEW_LEDGER_ARTIFACT,
     issue_ledger: IMAGE_UX_REVIEW_ISSUE_LEDGER_ARTIFACT,
+    callout_extraction_report: IMAGE_UX_REVIEW_CALLOUT_EXTRACTION_REPORT_ARTIFACT,
     fix_task_plan: IMAGE_UX_REVIEW_FIX_TASK_PLAN_ARTIFACT,
     fix_loop: IMAGE_UX_REVIEW_FIX_LOOP_ARTIFACT,
     recapture_plan: IMAGE_UX_REVIEW_RECAPTURE_ARTIFACT,
@@ -63,6 +64,7 @@ async function runImageUxReview(root, command, args = []) {
         : null;
     const imagePath = readOption(args, '--image', null) || readOption(args, '--screenshot', null);
     const generatedImage = readOption(args, '--generated-image', null);
+    const shouldGenerateCallouts = flag(args, '--generate-callouts') || flag(args, '--fix');
     if (missionId)
         return rebuildExistingMission(root, command, [missionId, ...args], { fixRequested: flag(args, '--fix') });
     if (!imagePath && !readOption(args, '--from-computer-use', null)) {
@@ -88,7 +90,7 @@ async function runImageUxReview(root, command, args = []) {
     await writeJsonAtomic(path.join(dir, 'decision-contract.json'), contract);
     if (generatedImage)
         await attachGeneratedReviewImage(root, dir, contract, generatedImage, { realGenerated: !flag(args, '--mock'), mock: flag(args, '--mock') });
-    if (!generatedImage && flag(args, '--generate-callouts')) {
+    if (!generatedImage && shouldGenerateCallouts) {
         const outputDir = path.join(dir, 'generated-callouts');
         const result = await generateGptImage2CalloutReview({
             mission_id: id,
@@ -99,8 +101,23 @@ async function runImageUxReview(root, command, args = []) {
             requested_fidelity: 'original',
             privacy: 'local-only'
         });
-        if (result.generated_image_path)
+        if (result.generated_image_path) {
             await attachGeneratedReviewImage(root, dir, contract, result.generated_image_path, { realGenerated: true, mock: false, providerSurface: result.provider });
+            if (flag(args, '--fix')) {
+                const extraction = await extractRealCallouts({
+                    root,
+                    generatedImagePath: result.generated_image_path,
+                    sourceScreenshot: { id: 'screen-1' },
+                    sessionId: readOption(args, '--session', null) || readOption(args, '--session-id', null)
+                });
+                await writeJsonAtomic(path.join(dir, IMAGE_UX_REVIEW_ISSUE_LEDGER_ARTIFACT), extraction.issue_ledger);
+                await writeJsonAtomic(path.join(dir, IMAGE_UX_REVIEW_CALLOUT_EXTRACTION_REPORT_ARTIFACT), await buildImageUxCalloutExtractionReport(root, extraction, {
+                    generatedImagePath: result.generated_image_path,
+                    sourceImagePath: sourceRel || imagePath,
+                    provider: extraction.provider
+                }));
+            }
+        }
     }
     const artifacts = await writeImageUxReviewRouteArtifacts(dir, contract, { root, wrongnessChecked: true });
     const proof = await finalizeImageUx(root, id, command, artifacts, { mock: flag(args, '--mock'), cmd: `sks ${command} run` });
@@ -151,9 +168,12 @@ async function extractIssuesImageUxReview(root, command, args = []) {
             sourceScreenshot: { id: 'screen-1' },
             sessionId: readOption(args, '--session', null) || readOption(args, '--session-id', null)
         });
-        if (extraction.ok)
-            await writeJsonAtomic(path.join(dir, IMAGE_UX_REVIEW_ISSUE_LEDGER_ARTIFACT), extraction.issue_ledger);
-        await writeJsonAtomic(path.join(dir, 'image-ux-extraction-report.json'), extraction);
+        await writeJsonAtomic(path.join(dir, IMAGE_UX_REVIEW_ISSUE_LEDGER_ARTIFACT), extraction.issue_ledger);
+        await writeJsonAtomic(path.join(dir, IMAGE_UX_REVIEW_CALLOUT_EXTRACTION_REPORT_ARTIFACT), await buildImageUxCalloutExtractionReport(root, extraction, {
+            generatedImagePath: generatedImage,
+            sourceImagePath: sourceRel || sourceImage,
+            provider: extraction.provider
+        }));
     }
     const artifacts = await writeImageUxReviewRouteArtifacts(dir, contract, { root, wrongnessChecked: true });
     const proof = await finalizeImageUx(root, id, command, artifacts, { mock: flag(args, '--mock'), cmd: `sks ${command} extract-issues` });

package/dist/core/commands/ppt-command.d.ts

@@ -99,7 +99,10 @@ export declare function pptCommand(command: any, args?: any): Promise<void | {
             next_action: string | null;
         };
         slide_callout_ledger: any;
+        slide_imagegen_request: any;
+        slide_imagegen_response: any;
         slide_issue_ledger: any;
+        slide_extraction_report: any;
         deck_issue_ledger: any;
         fix_task_plan: {
             schema: string;

package/dist/core/dfix.d.ts

@@ -2,6 +2,7 @@ export declare const DFIX_DIAGNOSIS_ARTIFACT = "dfix-diagnosis.json";
 export declare const DFIX_ROOT_CAUSE_ARTIFACT = "dfix-root-cause.json";
 export declare const DFIX_PATCH_PLAN_ARTIFACT = "dfix-patch-plan.json";
 export declare const DFIX_PATCH_RESULT_ARTIFACT = "dfix-patch-result.json";
+export declare const DFIX_VERIFICATION_SUGGESTION_ARTIFACT = "dfix-verification-suggestion.json";
 export declare const DFIX_VERIFICATION_ARTIFACT = "dfix-verification.json";
 export declare const DFIX_GATE_ARTIFACT = "dfix-gate.json";
 export declare const DFIX_ARTIFACT_PATHS: Record<string, string>;
@@ -22,6 +23,16 @@ export declare function writeDfixDiagnosis(root: string, dir: string, opts?: any
         confidence: number;
         blockers: never[];
     };
+    verification_suggestion: {
+        schema: string;
+        created_at: string;
+        package_type: string;
+        package_scripts_detected: string[];
+        suggested_commands: string[];
+        best_command: string | undefined;
+        auto_run_requires_opt_in: boolean;
+        recovery_action: string;
+    };
 }>;
 export declare function writeDfixPatchPlan(dir: string, opts?: any): Promise<{
     schema: string;
@@ -31,7 +42,17 @@ export declare function writeDfixPatchPlan(dir: string, opts?: any): Promise<{
     target_file: any;
     find_text_present: boolean;
     replace_text_present: boolean;
+    patch_mode: string;
+    codex_patch_handoff: {
+        mode: string;
+        prompt: string;
+        output_schema: {
+            required: string[];
+            forbidden_operations: string[];
+        };
+    } | null;
     root_cause: any;
+    verification_commands: any;
     safety: {
         direct_fix_only: boolean;
         destructive_operations_allowed: boolean;
@@ -46,9 +67,22 @@ export declare function writeDfixPatchResult(root: string, dir: string, opts?: a
     schema: string;
     created_at: string;
     explicit_apply_opt_in: boolean;
+    apply_opt_in: boolean;
+    patch_mode: any;
     patch_result_present: boolean;
     patch_applied: boolean;
     changed_files: string[];
+    git_diff_before: {
+        captured: boolean;
+        stdout_tail: string;
+        stderr_tail: string;
+    };
+    git_diff_after: {
+        captured: boolean;
+        stdout_tail: string;
+        stderr_tail: string;
+    };
+    diff_captured: boolean;
     no_op_reason: string | null;
     noop_patch_wrongness: boolean;
     rollback_plan: {
@@ -67,6 +101,7 @@ export declare function writeDfixGate(dir: string, opts?: any): Promise<{
         root_cause_present: boolean;
         patch_plan_present: boolean;
         patch_result_present: boolean;
+        verification_suggestion_present: boolean;
         verification_present: boolean;
         rollback_plan_present: boolean;
         noop_patch_wrongness: boolean;
@@ -78,6 +113,7 @@ export declare function writeDfixGate(dir: string, opts?: any): Promise<{
     root_cause: any;
     patch_plan: any;
     patch_result: any;
+    verification_suggestion: any;
     verification: any;
 }>;
 export declare function dfixProofEvidence(gate?: any): {
@@ -88,9 +124,20 @@ export declare function dfixProofEvidence(gate?: any): {
     patch_plan_present: boolean;
     patch_result_present: boolean;
     verification_present: boolean;
+    verification_suggestion_present: boolean;
     verification_status: string;
     noop_patch_wrongness: boolean;
     blockers: any;
 };
+export declare function writeDfixVerificationSuggestion(root: string, dir: string, opts?: any): Promise<{
+    schema: string;
+    created_at: string;
+    package_type: string;
+    package_scripts_detected: string[];
+    suggested_commands: string[];
+    best_command: string | undefined;
+    auto_run_requires_opt_in: boolean;
+    recovery_action: string;
+}>;
 export declare function finalizeDfix(root: string, missionId: string, artifacts: any, opts?: any): Promise<any>;
 //# sourceMappingURL=dfix.d.ts.map