sneakoscope 7.3.0 → 7.5.0

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

@@ -12,7 +12,7 @@ import { buildIssueLedgerFromGeneratedCallouts } from './image-ux-review/callout
 import { planImageUxFixTasks } from './image-ux-review/fix-task-planner.js';
 import { runImageUxFixLoop } from './image-ux-review/fix-loop.js';
 import { buildRecapturePlan } from './image-ux-review/recapture.js';
-import { addVisualAnchor, ingestImage } from './wiki-image/image-voxel-ledger.js';
+import { addImageRelation, addVisualAnchor, ingestImage } from './wiki-image/image-voxel-ledger.js';
 import { validateFinalHonestModeReport } from './artifact-schemas.js';
 import { imagegenEvidenceClassBlockers, isFullImagegenOutputSource } from './imagegen/imagegen-evidence.js';
 export const IMAGE_UX_REVIEW_GATE_ARTIFACT = 'image-ux-review-gate.json';
@@ -69,6 +69,35 @@ export function imageUxReviewGateAllowsReferenceCloseout(gate = {}) {
         && gate?.verified_level === 'verified_partial'
         && gate?.full_review_passed !== true;
 }
+export function imageUxReviewCommandOutcome(gate = {}, proofOk = false, opts = {}) {
+    const reviewReportCompleted = gate?.review_report_completed === true;
+    const reviewOnlyCompletionAllowed = opts.allowReviewOnlyCompletion === true;
+    const reviewOnlyCompleted = reviewOnlyCompletionAllowed && reviewReportCompleted;
+    const gateAndProofPassed = gate?.passed === true && proofOk === true;
+    const fullReviewPassed = gate?.full_review_passed === true && gateAndProofPassed;
+    return {
+        ok: gateAndProofPassed || reviewOnlyCompleted,
+        status: fullReviewPassed
+            ? 'passed'
+            : reviewOnlyCompleted
+                ? 'review_completed'
+                : gateAndProofPassed
+                    ? gate?.status || 'passed'
+                    : 'blocked',
+        completion_scope: fullReviewPassed
+            ? 'full_review_and_optional_fix_verification'
+            : reviewOnlyCompleted
+                ? 'capture_imagegen_ocr_and_ux_report'
+                : null,
+        review_report_completed: reviewReportCompleted,
+        review_only_completion_allowed: reviewOnlyCompletionAllowed,
+        full_review_passed: gate?.full_review_passed === true,
+        requires_human_review: gate?.requires_human_review === true,
+        unresolved_p0_p1_count: Number(gate?.unresolved_p0_p1_count || 0),
+        safety_blockers: Array.isArray(gate?.blockers) ? gate.blockers : [],
+        proof_ok: proofOk === true
+    };
+}
 function cleanText(value, fallback = '') {
     const text = String(value ?? '').replace(/\s+/g, ' ').trim();
     return text || fallback;
@@ -340,6 +369,17 @@ export function buildImageUxIssueLedger(contract = {}, generatedReviewLedger = b
     };
 }
 export function buildImageUxIterationReport(contract = {}, policy = buildImageUxReviewPolicy(contract), generatedReviewLedger = buildImageUxGeneratedReviewLedger(contract), issueLedger = buildImageUxIssueLedger(contract, generatedReviewLedger), fixTaskPlan = planImageUxFixTasks(issueLedger), fixLoop = runImageUxFixLoop(issueLedger, fixTaskPlan), recapturePlan = buildRecapturePlan(fixLoop)) {
+    const generatedImage = (generatedReviewLedger.generated_review_images || [])[0] || null;
+    const issues = Array.isArray(issueLedger.issues) ? issueLedger.issues : [];
+    const basedOnGeneratedImage = issueLedger.extracted_from_generated_callout === true
+        && issues.length > 0
+        && issues.every((issue) => issue.extracted_from_generated_image === true
+            && issue.generated_image_sha256 === generatedImage?.sha256);
+    const requiresHumanReview = (fixTaskPlan.tasks || []).some((task) => task.requires_human_review === true);
+    const severityCounts = Object.fromEntries(['P0', 'P1', 'P2', 'P3'].map((severity) => [
+        severity,
+        issues.filter((issue) => issue.severity === severity).length
+    ]));
     const passed = generatedReviewLedger.passed === true
         && issueLedger.passed === true
         && fixLoop.passed === true
@@ -351,6 +391,43 @@ export function buildImageUxIterationReport(contract = {}, policy = buildImageUx
         schema_version: 2,
         created_at: nowIso(),
         contract_hash: contract.sealed_hash || null,
+        report_type: 'ux_ui_change_report',
+        review_report_completed: generatedReviewLedger.passed === true
+            && issueLedger.validation?.ok === true
+            && basedOnGeneratedImage,
+        full_review_passed: passed,
+        requires_human_review: requiresHumanReview,
+        unresolved_p0_p1_count: Number(issueLedger.blocking_issue_count || 0),
+        analysis_basis: {
+            primary_evidence: 'generated_annotated_review_image',
+            generated_image_path: generatedImage?.path || null,
+            generated_image_sha256: generatedImage?.sha256 || null,
+            generated_image_id: generatedImage?.id || null,
+            source_screen_id: generatedImage?.source_screen_id || 'screen-1',
+            issue_extraction_source: issueLedger.extraction_source || IMAGE_UX_REVIEW_GENERATED_REVIEW_LEDGER_ARTIFACT,
+            based_on_generated_image: basedOnGeneratedImage
+        },
+        executive_summary: {
+            issue_count: issues.length,
+            severity_counts: severityCounts,
+            highest_priority: issues.find((issue) => ['P0', 'P1'].includes(issue.severity))?.severity
+                || issues[0]?.severity
+                || null
+        },
+        recommendations: issues.map((issue) => ({
+            issue_id: issue.id,
+            callout_id: issue.callout_id,
+            severity: issue.severity,
+            title: issue.title,
+            observed_problem: issue.detail,
+            likely_cause: issue.likely_cause,
+            recommended_ux_ui_change: issue.fix_action,
+            target_surface: issue.target_surface,
+            generated_image_bbox: issue.bbox,
+            generated_image_sha256: issue.generated_image_sha256,
+            confidence: issue.confidence,
+            verification_status: issue.fix_verification_status
+        })),
         loop_policy: {
             max_full_surface_passes: policy.max_full_surface_passes,
             max_screen_retries: policy.max_screen_retries,
@@ -416,6 +493,15 @@ export function defaultImageUxReviewGate(contract = {}, parts = {}) {
     const wrongnessChecked = parts.wrongnessChecked === true || generatedReviewLedger.blockers?.length === 0;
     const honestModeEvidence = parts.honestModeEvidence || null;
     const honestModeComplete = parts.honestModeComplete === true && (honestModeEvidence?.ok === true || parts.honestModeEvidenceRequired !== true);
+    const requiresHumanReview = (fixTaskPlan.tasks || []).some((task) => task.requires_human_review === true);
+    const reviewReportCompleted = realSourceScreenshotPresent
+        && officialOrUserScreenshotSource
+        && generatedReviewLedger.passed === true
+        && realGeneratedCount > 0
+        && calloutExtractionSchemaValid
+        && issueLedger.extracted_from_generated_callout === true
+        && iterationReport.review_report_completed === true
+        && iterationReport.analysis_basis?.based_on_generated_image === true;
     const referenceCloseoutPassed = generatedImageUnavailable
         && realSourceScreenshotPresent
         && officialOrUserScreenshotSource
@@ -436,6 +522,10 @@ export function defaultImageUxReviewGate(contract = {}, parts = {}) {
         status: 'blocked',
         verified_level: 'blocked',
         full_review_passed: false,
+        review_report_completed: reviewReportCompleted,
+        completion_scope: reviewReportCompleted ? 'capture_imagegen_ocr_and_ux_report' : null,
+        requires_human_review: requiresHumanReview,
+        unresolved_p0_p1_count: Number(issueLedger.blocking_issue_count || 0),
         reference_only: false,
         real_source_screenshot_present: realSourceScreenshotPresent,
         computer_use_or_user_screenshot_source: officialOrUserScreenshotSource,
@@ -448,7 +538,8 @@ export function defaultImageUxReviewGate(contract = {}, parts = {}) {
         fix_loop_executed_or_not_needed: fixLoopExecutedOrNotNeeded,
         changed_screens_rechecked: changedScreensRechecked,
         image_voxel_reference_anchor_created: imageVoxelReferenceAnchorCreated,
-        image_voxel_relations_created: parts.imageVoxelRelationsCreated === true || realGeneratedImages.some((image) => image.image_voxel_relation === 'generated_callout_review_of') === true,
+        image_voxel_relations_created: parts.imageVoxelRelationsCreated === true,
+        image_voxel_relation_evidence: parts.imageVoxelRelationEvidence || null,
         wrongness_checked: wrongnessChecked,
         honest_mode_complete: honestModeComplete,
         required_artifacts: [
@@ -497,8 +588,18 @@ export function defaultImageUxReviewGate(contract = {}, parts = {}) {
     return {
         ...gate,
         passed: fullPassed || referenceCloseoutPassed,
-        status: fullPassed ? 'passed' : referenceCloseoutPassed ? 'verified_partial_reference' : 'blocked',
-        verified_level: fullPassed ? 'verified' : referenceCloseoutPassed ? 'verified_partial' : 'blocked',
+        status: fullPassed
+            ? 'passed'
+            : referenceCloseoutPassed
+                ? 'verified_partial_reference'
+                : reviewReportCompleted
+                    ? 'review_completed'
+                    : 'blocked',
+        verified_level: fullPassed
+            ? 'verified'
+            : referenceCloseoutPassed || reviewReportCompleted
+                ? 'verified_partial'
+                : 'blocked',
         full_review_passed: fullPassed,
         reference_only: referenceCloseoutPassed
     };
@@ -515,6 +616,7 @@ export async function writeImageUxReviewRouteArtifacts(dir, contract = {}, opts
     const existingImagegenResponse = await readExistingJson(dir, IMAGE_UX_REVIEW_GPT_IMAGE_2_RESPONSE_ARTIFACT);
     const generatedReviewLedger = buildImageUxGeneratedReviewLedger(contract, inventory, existingGenerated, { root });
     const sourceReferenceEvidence = await ensureImageUxSourceReferenceEvidence(root, dir, inventory);
+    const imageVoxelRelationEvidence = await ensureImageUxGeneratedRelationEvidence(root, dir, inventory, generatedReviewLedger, sourceReferenceEvidence);
     const issueLedger = buildImageUxIssueLedger(contract, generatedReviewLedger, existingIssues);
     const fixTaskPlan = planImageUxFixTasks(issueLedger);
     const fixLoop = runImageUxFixLoop(issueLedger, fixTaskPlan, opts.fixLoop || {});
@@ -540,7 +642,8 @@ export async function writeImageUxReviewRouteArtifacts(dir, contract = {}, opts
         recapturePlan,
         iterationReport,
         imageVoxelReferenceAnchorCreated: sourceReferenceEvidence.ok === true,
-        imageVoxelRelationsCreated: opts.imageVoxelRelationsCreated === true,
+        imageVoxelRelationsCreated: opts.imageVoxelRelationsCreated === true || imageVoxelRelationEvidence.ok === true,
+        imageVoxelRelationEvidence,
         wrongnessChecked: opts.wrongnessChecked === true,
         honestModeComplete: honestModeEvidence.ok === true,
         honestModeEvidenceRequired: true,
@@ -599,7 +702,9 @@ export function imageUxReviewProofEvidence(gate = {}, artifacts = {}) {
         open_p0_p1_count: issueLedger.blocking_issue_count || 0,
         fixed_p0_p1_count: (issueLedger.issues || []).filter((issue) => ['P0', 'P1'].includes(issue.severity) && issue.status === 'fixed').length,
         recapture_re_review_status: artifacts.recapture_plan?.changed_screens_rechecked_or_not_applicable ? 'complete_or_not_applicable' : 'blocked',
-        image_voxel_relation_count: referenceOnly ? 0 : realGeneratedImages.filter((image) => image.image_voxel_relation).length,
+        image_voxel_relation_count: referenceOnly
+            ? 0
+            : gate.image_voxel_relations_created === true ? realGeneratedImages.length : 0,
         computer_use_evidence_mode: artifacts.inventory?.source_screens?.some((screen) => screen.capture_source === 'codex_native_computer_use_screenshot' || screen.capture_source === 'codex_computer_use_screenshot') ? 'native_computer_use_source_screenshot' : artifacts.inventory?.source_screens?.some((screen) => screen.capture_source === 'codex_chrome_extension_screenshot') ? 'chrome_extension_source_screenshot' : 'user_or_static_screenshot',
         claims: {
             ux_review_source_screenshot_verified: artifacts.inventory?.passed === true,
@@ -609,7 +714,7 @@ export function imageUxReviewProofEvidence(gate = {}, artifacts = {}) {
             ux_review_changed_screens_rechecked: artifacts.recapture_plan?.changed_screens_rechecked_or_not_applicable === true,
             ux_review_image_voxel_relations_verified: referenceOnly
                 ? gate.source_reference_evidence?.ok === true
-                : realGeneratedImages.some((image) => image.image_voxel_relation)
+                : gate.image_voxel_relations_created === true
         },
         full_verification_blockers: gate.full_verification_blockers || gate.blockers || [],
         blockers: gate.blockers || []
@@ -668,6 +773,72 @@ async function ensureImageUxSourceReferenceEvidence(root, dir, inventory = {}) {
         issues
     };
 }
+async function ensureImageUxGeneratedRelationEvidence(root, dir, inventory = {}, generatedReviewLedger = {}, sourceReferenceEvidence = {}) {
+    const missionId = path.basename(String(dir));
+    const sourceScreen = (inventory.source_screens || []).find((screen) => screen.status === 'captured' && screen.source);
+    const generatedImages = (generatedReviewLedger.generated_review_images || [])
+        .filter((image) => image.real_generated === true && image.mock !== true && image.path);
+    if (!missionId || !sourceScreen || !generatedImages.length || sourceReferenceEvidence.ok !== true) {
+        return {
+            schema: 'sks.image-ux-generated-relation-evidence.v1',
+            ok: false,
+            reason: !missionId
+                ? 'mission_id_missing'
+                : !sourceScreen
+                    ? 'captured_source_screenshot_missing'
+                    : !generatedImages.length
+                        ? 'real_generated_image_missing'
+                        : 'source_reference_anchor_missing',
+            relations: 0,
+            issues: []
+        };
+    }
+    const sourceImageId = `${missionId}-${sourceScreen.id}-source`;
+    const anchorIds = Array.isArray(sourceReferenceEvidence.anchor_ids) ? sourceReferenceEvidence.anchor_ids : [];
+    const relationIds = [];
+    const issues = [];
+    for (const image of generatedImages) {
+        const generatedImageId = `${missionId}-${image.id}`;
+        try {
+            const ingested = await ingestImage(root, image.path, {
+                missionId,
+                source: 'image-ux-review:gpt-image-2-generated-callout',
+                id: generatedImageId
+            });
+            if (!ingested.ok) {
+                issues.push(...(ingested.validation?.issues || [`generated_image_ingest_failed:${image.id}`]));
+                continue;
+            }
+            const relation = await addImageRelation(root, {
+                missionId,
+                route: '$Image-UX-Review',
+                type: 'generated_callout_review_of',
+                beforeImageId: sourceImageId,
+                afterImageId: generatedImageId,
+                sourceImageId,
+                generatedImageId,
+                anchors: anchorIds,
+                status: 'verified_partial',
+                verification: 'gpt-image-2-generated-callout-bound-to-source'
+            });
+            if (relation.ok)
+                relationIds.push(`${sourceImageId}->${generatedImageId}`);
+            else
+                issues.push(...(relation.validation?.issues || [`generated_image_relation_failed:${image.id}`]));
+        }
+        catch (err) {
+            issues.push(err instanceof Error ? err.message : String(err));
+        }
+    }
+    return {
+        schema: 'sks.image-ux-generated-relation-evidence.v1',
+        ok: relationIds.length === generatedImages.length && issues.length === 0,
+        relations: relationIds.length,
+        relation_ids: relationIds,
+        anchor_ids: anchorIds,
+        issues
+    };
+}
 async function ensureImageUxHonestModeEvidence(dir, parts = {}, opts = {}) {
     const missionId = path.basename(String(dir));
     const existing = await readExistingJson(dir, IMAGE_UX_REVIEW_HONEST_MODE_ARTIFACT);
@@ -744,6 +915,10 @@ export async function buildImageUxCalloutExtractionReport(root, extraction = {},
         schema: 'sks.image-ux-callout-extraction-report.v1',
         created_at: nowIso(),
         provider: extraction.provider || opts.provider || 'unknown',
+        analysis_input: 'generated_annotated_review_image',
+        generated_image_is_primary_evidence: true,
+        source_screenshot_used_for_extraction: false,
+        generated_image_id: opts.generatedImageId || ledger.generated_image_id || issues[0]?.generated_review_image_id || null,
         generated_image_path: generatedPath,
         generated_image_sha256: generatedSha,
         source_screenshot_sha256: sourceSha,

package/dist/core/imagegen/codex-lb-imagegen-target.js

@@ -6,13 +6,20 @@ export const CODEX_LB_IMAGEGEN_TARGET_SCHEMA = 'sks.codex-lb-imagegen-target.v1'
 export async function resolveCodexLbImagegenTarget(opts = {}) {
     const env = opts.env || process.env;
     const home = opts.home || env.HOME || os.homedir();
+    const codexHome = opts.codexHome || env.CODEX_HOME || path.join(home, '.codex');
     const configText = typeof opts.configText === 'string'
         ? opts.configText
-        : await readText(path.join(home, '.codex', 'config.toml'), '').catch(() => '');
+        : await readText(path.join(codexHome, 'config.toml'), '').catch(() => '');
     const selected = topLevelTomlString(configText, 'model_provider') === 'codex-lb';
-    const loaded = await loadCodexLbEnv({ home, processEnv: env }).catch(() => null);
-    const catalogModels = await readCatalogModels(configText, home);
-    const explicit = String(opts.explicitModel || env.SKS_IMAGEGEN_RESPONSES_MODEL || env.OPENAI_MODEL || '').trim();
+    const loaded = await loadCodexLbEnv({
+        home,
+        processEnv: env,
+        envPath: path.join(codexHome, 'sks-codex-lb.env'),
+        legacyEnvPath: path.join(codexHome, 'sks.env'),
+        metadataPath: path.join(codexHome, 'sks-codex-lb.json')
+    }).catch(() => null);
+    const catalogModels = await readCatalogModels(configText, home, codexHome);
+    const explicit = String(opts.explicitModel || env.SKS_IMAGEGEN_RESPONSES_MODEL || '').trim();
     const configuredModel = topLevelTomlString(configText, 'model');
     const { model, model_source } = explicit
         ? { model: explicit, model_source: 'explicit' }
@@ -46,16 +53,17 @@ function codexLbImagegenBlocker(state) {
         return 'codex_lb_imagegen_model_unresolved';
     return null;
 }
-async function readCatalogModels(configText, home) {
+async function readCatalogModels(configText, home, codexHome) {
     const configured = topLevelTomlString(configText, 'model_catalog_json');
     const candidates = [
-        configured ? path.resolve(configured.replace(/^~(?=\/|$)/, home)) : '',
-        path.join(home, '.codex', 'sks-codex-lb-tool-catalog.json')
+        configured ? resolveCatalogPath(configured, home, codexHome) : '',
+        path.join(codexHome, 'sks-codex-lb-tool-catalog.json')
     ].filter(Boolean);
     for (const file of candidates) {
         const payload = await readJson(file, null).catch(() => null);
         const rows = Array.isArray(payload?.models) ? payload.models : Array.isArray(payload?.data) ? payload.data : [];
         const slugs = rows
+            .filter((row) => row?.supported_in_api !== false && !hiddenCatalogRow(row))
             .map((row) => String(row?.slug || row?.id || row?.model || '').trim())
             .filter(Boolean);
         if (slugs.length)
@@ -63,6 +71,13 @@ async function readCatalogModels(configText, home) {
     }
     return [];
 }
+function resolveCatalogPath(configured, home, codexHome) {
+    const expanded = configured.replace(/^~(?=\/|$)/, home);
+    return path.isAbsolute(expanded) ? expanded : path.resolve(codexHome, expanded);
+}
+function hiddenCatalogRow(row) {
+    return ['hide', 'hidden', 'internal', 'none', 'unavailable'].includes(String(row?.visibility || '').trim().toLowerCase());
+}
 function topLevelTomlString(text, key) {
     const topLevel = String(text || '').split(/\n\s*\[/)[0] || '';
     const re = new RegExp(`(^|\\n)\\s*${key.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}\\s*=\\s*"([^"]*)"\\s*(?:#.*)?(?=\\n|$)`);

package/dist/core/imagegen/imagegen-capability.js

@@ -1,6 +1,6 @@
 import os from 'node:os';
 import path from 'node:path';
-import { codexLbEnvPath, loadCodexLbEnv, parseShellEnvValue } from '../codex-lb/codex-lb-env.js';
+import { loadCodexLbEnv, parseShellEnvValue } from '../codex-lb/codex-lb-env.js';
 import { nowIso, readText, runProcess, which } from '../fsx.js';
 import { redactSecrets, redactString } from '../secret-redaction.js';
 import { evaluateImagegenAuthReadiness } from './imagegen-auth-readiness.js';
@@ -97,7 +97,8 @@ export async function detectImagegenCapability(opts = {}) {
 }
 async function detectCodexLbImagegenAuth(opts = {}, env = process.env) {
     const home = opts.home || env.HOME || process.env.HOME || os.homedir();
-    const configPath = opts.configPath || path.join(home, '.codex', 'config.toml');
+    const codexHome = opts.codexHome || env.CODEX_HOME || path.join(home, '.codex');
+    const configPath = opts.configPath || path.join(codexHome, 'config.toml');
     const configText = typeof opts.configText === 'string'
         ? opts.configText
         : await readText(configPath, '').catch(() => '');
@@ -107,11 +108,17 @@ async function detectCodexLbImagegenAuth(opts = {}, env = process.env) {
     const requiresOpenAiAuth = tomlBoolean(block, 'requires_openai_auth');
     const envKey = tomlString(block, 'env_key');
     const baseUrl = tomlString(block, 'base_url') || String(env.CODEX_LB_BASE_URL || '').trim();
-    const envPath = opts.codexLbEnvPath || codexLbEnvPath(home);
+    const envPath = opts.codexLbEnvPath || path.join(codexHome, 'sks-codex-lb.env');
     const injectedEnvText = typeof opts.codexLbEnvText === 'string' ? opts.codexLbEnvText : null;
     const keyFromInjectedFile = injectedEnvText !== null && envKey ? parseShellEnvValue(injectedEnvText, envKey) : '';
     const loaded = injectedEnvText === null
-        ? await loadCodexLbEnv({ home, processEnv: env, envPath }).catch(() => null)
+        ? await loadCodexLbEnv({
+            home,
+            processEnv: env,
+            envPath,
+            legacyEnvPath: path.join(codexHome, 'sks.env'),
+            metadataPath: path.join(codexHome, 'sks-codex-lb.json')
+        }).catch(() => null)
         : null;
     const apiKeyPresent = Boolean(opts.codexLbApiKey || keyFromInjectedFile || loaded?.secret_api_key);
     const apiKeySource = opts.codexLbApiKey

package/dist/core/imagegen/require-imagegen.js

@@ -1,15 +1,27 @@
 import { detectImagegenCapability } from './imagegen-capability.js';
 import { repairCodexImagegen } from '../doctor/imagegen-repair.js';
 export async function requireCodexImagegen(root, opts = {}) {
-    const capability = await detectImagegenCapability({
-        codexBin: opts.codexBin || undefined,
+    const capabilityOpts = {
         timeoutMs: opts.timeoutMs || 5000
-    }).catch((err) => ({
+    };
+    if (opts.codexBin !== undefined && opts.codexBin !== null)
+        capabilityOpts.codexBin = opts.codexBin;
+    if (opts.home !== undefined)
+        capabilityOpts.home = opts.home;
+    if (opts.codexHome !== undefined)
+        capabilityOpts.codexHome = opts.codexHome;
+    if (opts.env !== undefined)
+        capabilityOpts.env = opts.env;
+    if (opts.configText !== undefined)
+        capabilityOpts.configText = opts.configText;
+    if (opts.codexLbEnvText !== undefined)
+        capabilityOpts.codexLbEnvText = opts.codexLbEnvText;
+    const capability = await detectImagegenCapability(capabilityOpts).catch((err) => ({
         ok: false,
         core_ready: false,
         blockers: [err instanceof Error ? err.message : String(err)]
     }));
-    const capabilityReadyBeforeRepair = capability.core_ready === true;
+    const capabilityReadyBeforeRepair = imagegenPreflightReady(capability);
     const repair = opts.autoRepair === true && !capabilityReadyBeforeRepair
         ? await repairCodexImagegen({
             root,
@@ -25,7 +37,10 @@ export async function requireCodexImagegen(root, opts = {}) {
     const finalCapability = repair
         ? repair.after || capability
         : capability;
-    const capabilityReady = finalCapability.core_ready === true || repair?.capability_ready === true;
+    const capabilityReady = imagegenPreflightReady(finalCapability) || repair?.capability_ready === true;
+    const preflightProvider = finalCapability.core_ready === true
+        ? 'codex_app_builtin'
+        : codexLbImagegenReady(finalCapability) ? 'codex_lb' : null;
     const currentTaskToolManifestVerified = repair?.current_task_tool_manifest_verified === true;
     const generatedOutputVerified = finalCapability.real_output_verified_by_capability_check === true
         || repair?.real_generation_verified === true;
@@ -55,6 +70,7 @@ export async function requireCodexImagegen(root, opts = {}) {
         preflight_ready: preflightReady,
         preflight_only: true,
         preflight_does_not_satisfy_generated_output_proof: true,
+        preflight_provider: preflightProvider,
         capability_ready: capabilityReady,
         route_ready: routeReady,
         current_task_tool_manifest_verified: currentTaskToolManifestVerified,
@@ -80,3 +96,11 @@ export async function requireCodexImagegen(root, opts = {}) {
         blockers
     };
 }
+function imagegenPreflightReady(capability) {
+    return capability?.core_ready === true || codexLbImagegenReady(capability);
+}
+function codexLbImagegenReady(capability) {
+    return capability?.codex_lb?.selected === true
+        && capability?.codex_lb?.available === true
+        && capability?.codex_lb?.blocker == null;
+}

package/dist/core/init/skills.js

@@ -12,7 +12,7 @@ import { reconcileRetiredAgentRoleResidue } from '../agents/agent-role-config.js
 import { ensureConfinedDirectory, inspectConfinedPath, moveConfinedPath, publicPathError, removeConfinedDirectoryIfEmpty, removeManagedPathVerified, uniqueConfinedPath } from '../managed-path-safety.js';
 import { collectNestedProjectRoots } from '../doctor/current-project-guidance-nested.js';
 import { coreEngineeringDirectiveReferenceText, engineeringSanityPolicyText } from '../lean-engineering-policy.js';
-import { AWESOME_DESIGN_MD_REFERENCE, CODEX_APP_IMAGE_GENERATION_DOC_URL, CODEX_COMPUTER_USE_ONLY_POLICY, CODEX_IMAGEGEN_EVIDENCE_SOURCE, CODEX_IMAGEGEN_REQUIRED_POLICY, CODEX_WEB_VERIFICATION_POLICY, DEFAULT_CODEX_APP_PLUGINS, DESIGN_SYSTEM_SSOT, DOLLAR_COMMANDS, DOLLAR_SKILL_NAMES, FROM_CHAT_IMG_CHECKLIST_ARTIFACT, FROM_CHAT_IMG_COVERAGE_ARTIFACT, FROM_CHAT_IMG_QA_LOOP_ARTIFACT, FROM_CHAT_IMG_TEMP_TRIWIKI_ARTIFACT, FROM_CHAT_IMG_TEMP_TRIWIKI_SESSIONS, GETDESIGN_REFERENCE, IMAGEGEN_SOCIAL_SOURCE_POLICY, LEGACY_DOLLAR_SKILL_NAMES, OPENAI_CHATGPT_IMAGES_2_DOC_URL, OPENAI_GPT_IMAGE_2_MODEL_DOC_URL, OPENAI_IMAGE_GENERATION_DOC_URL, PPT_CONDITIONAL_SKILL_ALLOWLIST, PPT_PIPELINE_MCP_ALLOWLIST, PPT_PIPELINE_SKILL_ALLOWLIST, RECOMMENDED_SKILLS, RESERVED_CODEX_PLUGIN_SKILL_NAMES, SOLUTION_SCOUT_SKILL_NAME, chatCaptureIntakeText, context7ConfigToml, getdesignReferencePolicyText, imageUxReviewPipelinePolicyText, outcomeRubricPolicyText, pptPipelineAllowlistPolicyText, productDesignPluginPolicyText, speedLanePolicyText, stackCurrentDocsPolicyText, triwikiContextTrackingText, triwikiStagePolicyText } from '../routes.js';
+import { AWESOME_DESIGN_MD_REFERENCE, CODEX_APP_IMAGE_GENERATION_DOC_URL, CODEX_COMPUTER_USE_ONLY_POLICY, CODEX_IMAGEGEN_EVIDENCE_SOURCE, CODEX_IMAGEGEN_REQUIRED_POLICY, CODEX_WEB_VERIFICATION_POLICY, DEFAULT_CODEX_APP_PLUGINS, DESIGN_SYSTEM_SSOT, DOLLAR_COMMANDS, DOLLAR_SKILL_NAMES, FROM_CHAT_IMG_CHECKLIST_ARTIFACT, FROM_CHAT_IMG_COVERAGE_ARTIFACT, FROM_CHAT_IMG_QA_LOOP_ARTIFACT, FROM_CHAT_IMG_TEMP_TRIWIKI_ARTIFACT, FROM_CHAT_IMG_TEMP_TRIWIKI_SESSIONS, GETDESIGN_REFERENCE, IMAGEGEN_SOCIAL_SOURCE_POLICY, LEGACY_DOLLAR_SKILL_NAMES, OPENAI_CHATGPT_IMAGES_2_DOC_URL, OPENAI_GPT_IMAGE_2_MODEL_DOC_URL, OPENAI_IMAGE_GENERATION_DOC_URL, PPT_CONDITIONAL_SKILL_ALLOWLIST, PPT_PIPELINE_MCP_ALLOWLIST, PPT_PIPELINE_SKILL_ALLOWLIST, RECOMMENDED_SKILLS, RESERVED_CODEX_PLUGIN_SKILL_NAMES, SOLUTION_SCOUT_SKILL_NAME, chatCaptureIntakeText, context7ConfigToml, getdesignReferencePolicyText, outcomeRubricPolicyText, pptPipelineAllowlistPolicyText, productDesignPluginPolicyText, speedLanePolicyText, stackCurrentDocsPolicyText, triwikiContextTrackingText, triwikiStagePolicyText } from '../routes.js';
 import { prefixKnownSksDollarReferences, sksPrefixedSkillName } from '../routes/dollar-prefix.js';
 import { escapeRegExp } from '../text/regex.js';
 const SKS_SKILL_MANIFEST_FILE = '.sks-generated.json';
@@ -21,6 +21,12 @@ const GENERATED_PRUNE_POLICY = 'remove_previous_sks_generated_paths_absent_from_
 const REFLECTION_MEMORY_PATH = '.sneakoscope/memory/q2_facts/post-route-reflection.md';
 const MANAGED_SKILL_MARKER_RE = /BEGIN SKS (?:IMMUTABLE CORE|MANAGED) SKILL/;
 const FORGE_SKILL_MARKER_RE = /BEGIN SKS FORGE SKILL/;
+const RETIRED_PUBLIC_IMAGE_UX_REVIEW_SKILL_ALIASES = [
+    'sks-ux-review',
+    'sks-visual-review',
+    'sks-ui-ux-review'
+];
+const RETIRED_PUBLIC_IMAGE_UX_REVIEW_SKILL_ALIAS_SET = new Set(RETIRED_PUBLIC_IMAGE_UX_REVIEW_SKILL_ALIASES);
 export const REMOVED_SKS_SKILL_NAMES = [
     'old-workflow',
     'team-legacy',
@@ -85,7 +91,6 @@ function reflectionInstructionText(commandPrefix = 'sks') {
 async function installOfficialSkills(root) {
     const quarantinedUserCollisions = [];
     const quarantinedManifestCollisions = await prepareReservedSkillManifestsForWrite(root);
-    const imageUxReviewSkill = (name) => `---\nname: ${name}\ndescription: $Image-UX-Review/$UX-Review imagegen/gpt-image-2 annotated UI/UX review loop.\n---\n\nUse only for $Image-UX-Review, $UX-Review, $visual-review, or $ui-ux-review UI/UX review requests. ${imageUxReviewPipelinePolicyText()} Route start must check Codex App imagegen capability and run the SKS imagegen repair loop once; if $imagegen/gpt-image-2 is still unavailable, stop with codex_imagegen_unavailable instead of doing text-only review or direct API substitution. Core loop: capture or attach source UI screenshots, then invoke Codex App $imagegen with gpt-image-2 to create a new generated annotated review image from each source screenshot, then analyze the generated review image with vision/OCR into image-ux-issue-ledger.json, then apply only requested safe fixes and recheck changed screens. Text-only screenshot critique cannot satisfy full verification; missing generated annotated review images keep full image-ux-review-gate.json verification blocked, but may close verified_partial/reference-only when source screenshots plus hashes, docs evidence, source Image Voxel anchors, and Honest Mode evidence exist. For live web/browser/webapp capture use Codex Chrome Extension first and halt if it is not installed/enabled; use Codex Computer Use only for native Mac/non-web app screens. Required artifacts: image-ux-review-policy.json, image-ux-screen-inventory.json, image-ux-generated-review-ledger.json, image-ux-issue-ledger.json, image-ux-iteration-report.json, image-ux-review-gate.json. Finish with reflection and Honest Mode.\n`;
     const canonicalMadSksSqlPlanePolicy = madSksSqlPlanePolicyText()
         .replace(/^---[\s\S]*?---\s*/, '')
         .trim();
@@ -136,10 +141,6 @@ async function installOfficialSkills(root) {
         'gx-visual-validate': `---\nname: gx-visual-validate\ndescription: Validate render metadata against vgraph.json and beta.json.\n---\n\nRun sks gx validate and drift; fail stale or incomplete hashes, nodes, edges, invariants, or anchors.\n`,
         'turbo-context-pack': `---\nname: turbo-context-pack\ndescription: Build ultra-low-token context packet with Q4 bits, Q3 tags, top-K claims, and minimal evidence.\n---\n\nDefault to Q4/Q3 plus TriWiki RGBA anchors and attention.use_first. Add Q2/Q1 only when needed or when attention.hydrate_first says source hydration is required. Keep id, hash, path, and coordinate tuple for hydration.\n`,
         'performance-evaluator': `---\nname: performance-evaluator\ndescription: Evaluate SKS performance, evidence-backed token usage, serialized-size proxies, accuracy-proxy, context-compression, or workflow improvements.\n---\n\nUse sks eval run/compare before claims. Treat serialized_size_bytes as a deterministic non-token proxy. Claim token savings only when actual baseline and candidate token counts include an evidence source; otherwise report token savings as not measured. Report accuracy_delta/proxy, required_recall, support, and meaningful_improvement without substituting proxy size for token evidence.\n`,
-        'image-ux-review': imageUxReviewSkill('image-ux-review'),
-        'ux-review': imageUxReviewSkill('ux-review'),
-        'visual-review': imageUxReviewSkill('visual-review'),
-        'ui-ux-review': imageUxReviewSkill('ui-ux-review'),
         'imagegen': `---\nname: imagegen\ndescription: Required bridge to Codex App built-in image generation for logos, image assets, raster visuals, and image edits.\n---\n\nUse for generated or edited image assets: logo, product image, illustration, sprite, mockup, texture, cutout, or bitmap. Prefer the official Codex App built-in image generation feature documented at ${CODEX_APP_IMAGE_GENERATION_DOC_URL}: ask naturally or invoke \`$imagegen\`. SKS route code checks capability before image-dependent routes, attempts doctor imagegen repair once, and reports codex_imagegen_unavailable if Codex App $imagegen still is not ready. For newest-model requests, make the prompt explicit: "Use ChatGPT Images 2.0 / GPT Image 2.0 with gpt-image-2." Useful official references are ${OPENAI_CHATGPT_IMAGES_2_DOC_URL}, ${OPENAI_GPT_IMAGE_2_MODEL_DOC_URL}, and ${OPENAI_IMAGE_GENERATION_DOC_URL}. Codex App image generation counts against Codex usage limits. Capability detection is not output proof; full SKS evidence requires a real selected raster output path or generated review image artifact. Direct OpenAI API fallback is non-Codex evidence and does not satisfy SKS route evidence unless a separate non-Codex API task is explicitly requested. ${IMAGEGEN_SOCIAL_SOURCE_POLICY} ${CODEX_IMAGEGEN_REQUIRED_POLICY} Do not substitute placeholder SVG/HTML/CSS for requested raster assets; follow design.md when relevant.\n`,
         'imagegen-source-scout': `---\nname: imagegen-source-scout\ndescription: Source scout for current GPT Image 2.0/gpt-image-2 prompt guidance, official docs, and X/social workflow signals.\n---\n\nUse when the user asks for the latest imagegen docs, ChatGPT Images 2.0 / GPT Image 2.0 / gpt-image-2 behavior, X/social reactions, prompt examples, or community workflow hints before creating an image prompt or SKS imagegen policy. Source order: official OpenAI announcement (${OPENAI_CHATGPT_IMAGES_2_DOC_URL}), Codex App image generation docs (${CODEX_APP_IMAGE_GENERATION_DOC_URL}), gpt-image-2 model docs (${OPENAI_GPT_IMAGE_2_MODEL_DOC_URL}), OpenAI Image Generation API docs (${OPENAI_IMAGE_GENERATION_DOC_URL}), then public X/social/community search for prompt-quality heuristics only. ${IMAGEGEN_SOCIAL_SOURCE_POLICY} If social or web search is unavailable, record that social coverage is unverified and continue from official docs. Output a compact evidence split: official capability/evidence rules, prompt heuristics, social/workflow signals, and blockers. Do not generate images itself; pair this with the imagegen skill for actual raster output.\n`,
         'getdesign-reference': `---\nname: getdesign-reference\ndescription: Use getdesign.md official design reference as an input to the design.md SSOT for UI/UX, presentation, and HTML/PDF systems.\n---\n\nUse when creating or improving design.md, UI/UX design systems, deck-like HTML artifacts, presentation PDFs, or brand-inspired visual systems. design.md is the only design decision SSOT; reference ${GETDESIGN_REFERENCE.url}, ${GETDESIGN_REFERENCE.docs_url}, and ${AWESOME_DESIGN_MD_REFERENCE.url} only as source inputs to synthesize or update that SSOT or a route-local style-token artifact. Prefer the official Codex skill if available with \`${GETDESIGN_REFERENCE.codex_skill_install}\`. If the skill CLI is unavailable, use this generated skill plus official docs/API/CLI/SDK references and curated DESIGN.md examples as inputs. Do not claim getdesign MCP is configured unless a current official MCP surface is actually installed.\n`,
@@ -907,7 +908,9 @@ function buildFallbackSkillsManifest() {
         ...RECOMMENDED_SKILLS.map((name) => canonicalSkillNameFromValue(name)),
         ...DOLLAR_COMMANDS.map((command) => canonicalSkillNameFromValue(String(command.command || '').replace(/^\$/, ''))),
         ...buildSksCoreSkillManifest().skills.map((skill) => skill.canonical_name)
-    ].filter((name) => Boolean(name) && !REMOVED_SKS_SKILL_NAME_SET.has(String(name))));
+    ].filter((name) => Boolean(name)
+        && !REMOVED_SKS_SKILL_NAME_SET.has(String(name))
+        && !RETIRED_PUBLIC_IMAGE_UX_REVIEW_SKILL_ALIAS_SET.has(String(name))));
     return {
         schema: PACKAGED_SKILLS_MANIFEST_SCHEMA,
         package_version: PACKAGE_VERSION,
@@ -1161,7 +1164,7 @@ function isGeneratedSksPluginCollisionSkill(text, name) {
     return /Maximum-speed \$Computer-Use\/\$CU lane|Codex App pipeline activation:|Sneakoscope generated|Dollar-command route generated by SKS/i.test(s);
 }
 function enrichSkillContent(name, content) {
-    if (!['sks', 'answer', 'wiki', 'qa-loop', 'ppt', 'image-ux-review', 'ux-review', 'visual-review', 'ui-ux-review', 'computer-use-fast', 'cu', 'goal', 'research', 'autoresearch', 'db', 'gx', 'reflection', 'prompt-pipeline', 'pipeline-runner', 'context7-docs', 'turbo-context-pack', 'hproof-evidence-bind'].includes(name))
+    if (!['sks', 'answer', 'wiki', 'qa-loop', 'ppt', 'image-ux-review', 'computer-use-fast', 'cu', 'goal', 'research', 'autoresearch', 'db', 'gx', 'reflection', 'prompt-pipeline', 'pipeline-runner', 'context7-docs', 'turbo-context-pack', 'hproof-evidence-bind'].includes(name))
         return content;
     const text = String(content || '').trimEnd();
     const activation = pipelineActivationText(name);
@@ -1179,7 +1182,7 @@ Context tracking:
 `;
 }
 function pipelineActivationText(name) {
-    const stateful = new Set(['sks', 'qa-loop', 'ppt', 'image-ux-review', 'ux-review', 'visual-review', 'ui-ux-review', 'computer-use-fast', 'cu', 'goal', 'research', 'autoresearch', 'db', 'gx', 'prompt-pipeline', 'pipeline-runner']);
+    const stateful = new Set(['sks', 'qa-loop', 'ppt', 'image-ux-review', 'computer-use-fast', 'cu', 'goal', 'research', 'autoresearch', 'db', 'gx', 'prompt-pipeline', 'pipeline-runner']);
     if (!stateful.has(name))
         return '';
     return `Codex App pipeline activation:
@@ -1229,6 +1232,7 @@ async function removeGeneratedAgentSkillAliases(root, skillNames) {
     const current = new Set(skillNames);
     const obsolete = [
         ...SKS_SKILL_NAMES_TO_CLEAN_UP,
+        ...RETIRED_PUBLIC_IMAGE_UX_REVIEW_SKILL_ALIASES,
         'qaloop',
         'wiki-refresh',
         'wikirefresh',
@@ -1242,7 +1246,7 @@ async function removeGeneratedAgentSkillAliases(root, skillNames) {
         if (current.has(name))
             continue;
         const dir = path.join(root, '.agents', 'skills', name);
-        const action = await cleanupGeneratedSkillResidue(root, dir, name, (text) => isGeneratedSksAgentSkill(text, name), 'generated-agent-skill-user-content-collision');
+        const action = await cleanupGeneratedSkillResidue(root, dir, name, (text) => isGeneratedSksAgentSkill(text, name) || isRetiredGeneratedImageUxReviewAlias(text, name), 'generated-agent-skill-user-content-collision');
         if (action === 'removed')
             removed.push(path.relative(root, dir));
         if (action === 'quarantined')
@@ -1282,6 +1286,14 @@ function isGeneratedSksAgentSkill(text, name) {
         return false;
     return /Sneakoscope generated|Fallback Codex App picker alias|Codex App picker alias for|Dollar-command route generated by SKS/i.test(s);
 }
+function isRetiredGeneratedImageUxReviewAlias(text, name) {
+    if (!RETIRED_PUBLIC_IMAGE_UX_REVIEW_SKILL_ALIAS_SET.has(String(name)))
+        return false;
+    const s = String(text || '');
+    return MANAGED_SKILL_MARKER_RE.test(s)
+        && new RegExp(`^name:\\s*${escapeRegExp(name)}\\s*$`, 'm').test(s)
+        && /imagegen\/gpt-image-2 annotated UI\/UX review loop/i.test(s);
+}
 function isGeneratedSksLegacySkill(text, name) {
     if (typeof text !== 'string')
         return false;