Add visual artifact smoke readiness proof

Author: AtomEons

package.json

@@ -44,6 +44,7 @@
     "research:radar": "bun ./scripts/v4/orangebox-research-radar.mjs --json --receipt",
     "horizon:review": "bun ./scripts/v4/orangebox-horizon-review-doctor.mjs --json --receipt",
     "visual:artifact-vault": "bun ./scripts/v4/orangebox-visual-artifact-vault-doctor.mjs --json --receipt",
+    "visual:artifact-smoke": "bun ./scripts/v4/orangebox-visual-artifact-smoke-doctor.mjs --json --receipt",
     "visual:readiness": "bun ./scripts/v4/orangebox-visual-production-readiness-doctor.mjs --json --receipt",
     "assurance:doctor": "bun ./scripts/v4/orangebox-assurance-lab-doctor.mjs --json --receipt",
     "tool:ergonomics": "bun ./scripts/v4/orangebox-tool-ergonomics-doctor.mjs --json --receipt",

scripts/v4/orangebox-feature-acceptance-matrix-doctor.mjs

@@ -325,9 +325,9 @@ async function main() {
       lane: "backend_ops",
       status: "REAL",
       frontend_touch_allowed: false,
-      proof_command: "npm.cmd run visual:artifact-vault && npm.cmd run visual:readiness",
-      acceptance_gate: "Visual readiness receipt is present, control_plane_green=true, artifact_vault_ready=true, visual_tool_cards >= 19, and visual_ready remains explicit.",
-      rollback_path: "Remove the visual artifact vault/readiness package scripts and doctors, then rerun package-script-doctor and feature:proof.",
+      proof_command: "npm.cmd run visual:artifact-vault && npm.cmd run visual:artifact-smoke && npm.cmd run visual:readiness",
+      acceptance_gate: "Visual readiness receipt is present, control_plane_green=true, artifact_vault_ready=true, artifact_smoke_ready=true, visual_tool_cards >= 19, and visual_ready remains explicit.",
+      rollback_path: "Remove the visual artifact vault/smoke/readiness package scripts and doctors, then rerun package-script-doctor and feature:proof.",
       evidence: [
         evidence(path.join(dataRoot, "visual-production-readiness", "latest-visual-production-readiness.json"), "ORANGEBOX_VISUAL_PRODUCTION_CONTROL_READY_RUNTIME_NOT_PROMOTED", {
           accept: (parsed, status) => (
@@ -336,13 +336,17 @@ async function main() {
           ) && parsed?.ok === true
             && parsed?.control_plane_green === true
             && parsed?.summary?.artifact_vault_ready === true
+            && parsed?.summary?.artifact_smoke_ready === true
             && Number(parsed?.summary?.visual_tool_cards || 0) >= 19
             && typeof parsed?.visual_ready === "boolean",
           detail: (parsed) => ({
             visual_ready: parsed?.visual_ready ?? null,
             control_plane_green: parsed?.control_plane_green ?? null,
             artifact_vault_ready: parsed?.summary?.artifact_vault_ready ?? null,
+            artifact_smoke_ready: parsed?.summary?.artifact_smoke_ready ?? null,
             artifact_manifest_path: parsed?.summary?.artifact_manifest_path ?? null,
+            smoke_artifact_path: parsed?.summary?.smoke_artifact_path ?? null,
+            smoke_artifact_sha256: parsed?.summary?.smoke_artifact_sha256 ?? null,
             runtime_ready_lanes: parsed?.summary?.runtime_ready_lanes ?? null,
             visual_tool_cards: parsed?.summary?.visual_tool_cards ?? null,
           }),
@@ -352,25 +356,27 @@ async function main() {
     }),
     matrixRow({
       id: "horizon_review_new_alpha_stack",
-      claim: "Orangebox reviews OBOX Jarvis/OpenJarvis, Goose, Context7, Elysia, AI SDK/Ollama, libSQL, Mastra, and GPU acceleration candidates before promotion.",
+      claim: "Orangebox reviews OBOX Jarvis/OpenJarvis, Goose, Context7, Elysia, LittleOrange/Cortex, AI SDK/Ollama, libSQL, Mastra, and GPU acceleration candidates before promotion.",
       lane: "backend_ops",
       status: "REAL",
       frontend_touch_allowed: false,
       proof_command: "npm.cmd run horizon:review",
-      acceptance_gate: "Horizon review receipt is green with at least 8 candidates, Elysia dependency truth, Goose card truth, and no auto-promotion.",
+      acceptance_gate: "Horizon review receipt is green with at least 9 candidates, Elysia dependency truth, Goose card truth, LittleOrange doctor truth, and no auto-promotion.",
       rollback_path: "Remove the horizon review package script and doctor, then rerun package-script-doctor and feature:proof.",
       evidence: [
         evidence(path.join(dataRoot, "horizon-review", "latest-horizon-review.json"), "ORANGEBOX_HORIZON_REVIEW_READY", {
           accept: (parsed, status) => status === "ORANGEBOX_HORIZON_REVIEW_READY"
             && parsed?.ok === true
-            && Number(parsed?.summary?.candidates_reviewed || 0) >= 8
+            && Number(parsed?.summary?.candidates_reviewed || 0) >= 9
             && parsed?.summary?.elysia_dependency_present === true
-            && parsed?.summary?.goose_card_present === true,
+            && parsed?.summary?.goose_card_present === true
+            && parsed?.summary?.littleorange_doctor_present === true,
           detail: (parsed) => ({
             candidates_reviewed: parsed?.summary?.candidates_reviewed ?? null,
             active_contracts: parsed?.summary?.active_contracts ?? null,
             elysia_dependency_present: parsed?.summary?.elysia_dependency_present ?? null,
             goose_card_present: parsed?.summary?.goose_card_present ?? null,
+            littleorange_doctor_present: parsed?.summary?.littleorange_doctor_present ?? null,
           }),
         }),
       ],

scripts/v4/orangebox-harness-benchmark-doctor.mjs

@@ -148,7 +148,9 @@ const requiredOpsScripts = [
   "research:scout",
   "research:radar",
   "horizon:review",
+  "littleorange:doctor",
   "visual:artifact-vault",
+  "visual:artifact-smoke",
   "visual:readiness",
   "knowledge:improvements",
   "assurance:doctor",
@@ -784,10 +786,11 @@ const tasks = [
     id: "visual_production_readiness_truth",
     category: "visual_runtime_truth",
     oracle: "Visual/media/design readiness must distinguish control-plane proof from promoted runtime power and must not touch the living frontend lane.",
-    budget: { timeout_ms: 1600, max_files_read: 5, max_tool_calls: 0 },
+    budget: { timeout_ms: 1600, max_files_read: 6, max_tool_calls: 0 },
     run(trace) {
       const visual = readJson(path.join(dataRoot, "visual-production-readiness", "latest-visual-production-readiness.json"), trace);
       const vault = readJson(path.join(dataRoot, "visual-artifacts", "latest-visual-artifact-vault.json"), trace);
+      const smoke = readJson(path.join(dataRoot, "visual-artifacts", "latest-visual-artifact-smoke.json"), trace);
       const feature = readJson(path.join(dataRoot, "feature-proof", "latest-feature-acceptance-matrix.json"), trace);
       const project = readJson(path.join(dataRoot, "reports", "project", "latest-project-report.json"), trace);
       const packageJson = readJson(path.join(repoRoot, "package.json"), trace);
@@ -796,16 +799,26 @@ const tasks = [
       const visualRow = feature?.matrix?.find((row) => row.id === "visual_production_readiness");
       const visualProjectRow = project?.scope?.find((row) => row.area === "Visual production readiness");
       if (!packageJson?.scripts?.["visual:artifact-vault"]?.includes("orangebox-visual-artifact-vault-doctor.mjs")) failures.push("Package script visual:artifact-vault missing or wrong");
+      if (!packageJson?.scripts?.["visual:artifact-smoke"]?.includes("orangebox-visual-artifact-smoke-doctor.mjs")) failures.push("Package script visual:artifact-smoke missing or wrong");
       if (!packageJson?.scripts?.["visual:readiness"]?.includes("orangebox-visual-production-readiness-doctor.mjs")) failures.push("Package script visual:readiness missing or wrong");
       if (vault?.status !== "ORANGEBOX_VISUAL_ARTIFACT_VAULT_GREEN" || vault?.vault_ready !== true) failures.push(`Visual artifact vault not green: ${vault?.status || "missing"}`);
       if (vault?.vault?.pointer_only !== true) failures.push("Visual artifact vault does not preserve pointer_only=true");
       if (vault?.vault?.receipt_binary_payload_allowed !== false) failures.push("Visual artifact vault does not forbid receipt binary payloads");
       if (!vault?.proof_artifact?.manifest_path) failures.push("Visual artifact vault does not expose proof manifest path");
+      if (smoke?.status !== "ORANGEBOX_VISUAL_ARTIFACT_SMOKE_GREEN" || smoke?.smoke_ready !== true) failures.push(`Visual artifact smoke not green: ${smoke?.status || "missing"}`);
+      if (smoke?.artifact?.mime_type !== "image/png") failures.push(`Visual artifact smoke mime wrong: ${smoke?.artifact?.mime_type || "missing"}`);
+      if (smoke?.artifact?.runtime_generated_media !== false) failures.push("Visual artifact smoke incorrectly claims runtime_generated_media");
+      if (smoke?.vault?.receipt_binary_payload_allowed !== false) failures.push("Visual artifact smoke does not forbid receipt binary payloads");
+      if (!/^[a-f0-9]{64}$/.test(smoke?.artifact?.sha256 || "")) failures.push("Visual artifact smoke sha256 missing/invalid");
       if (visual?.status !== "ORANGEBOX_VISUAL_PRODUCTION_CONTROL_READY_RUNTIME_NOT_PROMOTED" && visual?.status !== "ORANGEBOX_VISUAL_PRODUCTION_RUNTIME_READY") failures.push(`Visual readiness status wrong/missing: ${visual?.status || "missing"}`);
       if (visual?.ok !== true) failures.push("Visual readiness ok=true missing");
       if (visual?.control_plane_green !== true) failures.push("Visual readiness control_plane_green=true missing");
       if (visual?.summary?.artifact_vault_ready !== true) failures.push("Visual readiness does not mirror artifact_vault_ready=true");
+      if (visual?.summary?.artifact_smoke_ready !== true) failures.push("Visual readiness does not mirror artifact_smoke_ready=true");
+      if (visual?.summary?.visual_artifact_pipeline_ready !== true) failures.push("Visual readiness does not mirror visual_artifact_pipeline_ready=true");
       if (!visual?.summary?.artifact_manifest_path) failures.push("Visual readiness does not mirror artifact manifest path");
+      if (visual?.summary?.smoke_artifact_path !== smoke?.artifact?.artifact_path) failures.push("Visual readiness does not mirror smoke artifact path");
+      if (visual?.summary?.smoke_artifact_sha256 !== smoke?.artifact?.sha256) failures.push("Visual readiness does not mirror smoke artifact hash");
       if (typeof visual?.visual_ready !== "boolean") failures.push("Visual readiness does not expose boolean visual_ready");
       if ((visual?.summary?.visual_tool_cards || 0) < 19) failures.push(`Visual tool card count too low: ${visual?.summary?.visual_tool_cards || 0}`);
       if ((visual?.summary?.control_green_lanes || 0) !== 4) failures.push(`Control-green lane count is not 4: ${visual?.summary?.control_green_lanes || 0}`);
@@ -829,13 +842,18 @@ const tasks = [
           control_green_lanes: visual?.summary?.control_green_lanes ?? null,
           runtime_ready_lanes: visual?.summary?.runtime_ready_lanes ?? null,
           artifact_vault_status: vault?.status || null,
+          artifact_smoke_status: smoke?.status || null,
         })
         : okTask("visual_production_readiness_truth", {
           status: visual.status,
           visual_ready: visual.visual_ready,
           control_plane_green: visual.control_plane_green,
           artifact_vault_ready: visual.summary.artifact_vault_ready,
           artifact_manifest_path: visual.summary.artifact_manifest_path,
+          artifact_smoke_ready: visual.summary.artifact_smoke_ready,
+          smoke_artifact_path: visual.summary.smoke_artifact_path,
+          smoke_artifact_sha256: visual.summary.smoke_artifact_sha256,
+          visual_artifact_pipeline_ready: visual.summary.visual_artifact_pipeline_ready,
           visual_tool_cards: visual.summary.visual_tool_cards,
           control_green_lanes: visual.summary.control_green_lanes,
           runtime_ready_lanes: visual.summary.runtime_ready_lanes,
@@ -862,6 +880,7 @@ const tasks = [
         "openjarvis_eval",
         "context7_mcp_docs_lane",
         "ai_sdk_ollama_transport",
+        "littleorange_cortex_surface",
         "libsql_vector_memory",
         "mastra_agent_framework",
         "tilelang_tilekernels_dflash",
@@ -878,15 +897,19 @@ const tasks = [
       const openJarvis = candidates.find((candidate) => candidate.id === "openjarvis_eval");
       const context7 = candidates.find((candidate) => candidate.id === "context7_mcp_docs_lane");
       const elysia = candidates.find((candidate) => candidate.id === "bun_elysia_api_bridge");
+      const littleOrange = candidates.find((candidate) => candidate.id === "littleorange_cortex_surface");
       if (!String(horizon?.doctrine || "").includes("TriLane remains strategy authority")) failures.push("Horizon doctrine does not preserve TriLane authority");
       if (horizon?.summary?.elysia_dependency_present !== true) failures.push("Horizon review does not prove Elysia dependency presence");
       if (horizon?.summary?.goose_card_present !== true) failures.push("Horizon review does not prove Goose card presence");
+      if (horizon?.summary?.littleorange_doctor_present !== true) failures.push("Horizon review does not prove LittleOrange doctor presence");
       if (!String(goose?.horizon_decision || "").includes("CANDIDATE")) failures.push("Goose is not kept as a candidate");
       if (!String(goose?.promotion_blocker || "").includes("Must not replace TriLane")) failures.push("Goose promotion blocker does not protect TriLane");
       if (!String(openJarvis?.orangebox_state || "").includes("eval_harness")) failures.push("OpenJarvis is not stated as eval harness only");
       if (openJarvis?.installed_or_present !== false) failures.push("OpenJarvis runtime is incorrectly marked installed/present");
       if (!String(context7?.orangebox_state || "").includes("not_installed")) failures.push("Context7 is not stated as not installed");
       if (!String(elysia?.horizon_decision || "").includes("ACTIVE_CONTRACT")) failures.push("Elysia bridge is not kept as active contract");
+      if (!String(littleOrange?.orangebox_state || "").includes("separate_visual_lane")) failures.push("LittleOrange/Cortex is not stated as separate visual lane");
+      if (littleOrange?.installed_or_present !== true) failures.push("LittleOrange doctor is not marked present");
       if (!featureRow?.ok) failures.push("Feature matrix does not prove horizon_review_new_alpha_stack");
       if (projectRow?.status !== "REAL") failures.push("Project report does not list horizon review as REAL");
       return failures.length
@@ -900,6 +923,7 @@ const tasks = [
           candidates_reviewed: horizon.summary.candidates_reviewed,
           elysia_dependency_present: horizon.summary.elysia_dependency_present,
           goose_card_present: horizon.summary.goose_card_present,
+          littleorange_doctor_present: horizon.summary.littleorange_doctor_present,
           feature_row: "horizon_review_new_alpha_stack",
           candidates: required,
         });

scripts/v4/orangebox-horizon-review-doctor.mjs

@@ -150,6 +150,18 @@ async function main() {
       proof_command: "future transport benchmark doctor",
       primary_sources: ["https://ai-sdk.dev/providers/community-providers/ollama", "https://ai-sdk.dev/docs/foundations/providers-and-models"],
     },
+    {
+      id: "littleorange_cortex_surface",
+      name: "LittleOrange / Cortex IDE surface",
+      horizon_decision: "ACTIVE_SEPARATE_VISUAL_SURFACE_VERIFY_ONLY",
+      orangebox_state: pkg.scripts["littleorange:doctor"] ? "doctor_present_separate_visual_lane" : "missing_doctor",
+      installed_or_present: Boolean(pkg.scripts["littleorange:doctor"]),
+      current_role: "custom Orangebox AI code chat surface with recent projects, large chat scroll controls, backend rail probes, route spine, receipts, file tree, model lane, and upgrade radar",
+      promotion_blocker: "Ops may verify receipts and backend connectivity, but frontend edits and release-grade visual proof stay in the separate visual project lane.",
+      next_action: "Run littleorange:doctor and the visual lane proof stack before calling the surface release-ready.",
+      proof_command: "npm.cmd run littleorange:doctor",
+      primary_sources: ["orangebox-v3/docs/V3_MASTER_LEDGER.md", "scripts/v4/littleorange-doctor.mjs"],
+    },
     {
       id: "libsql_vector_memory",
       name: "libSQL local vector memory",
@@ -213,6 +225,7 @@ async function main() {
       dependency_or_registry_present: candidates.filter((candidate) => candidate.installed_or_present).length,
       goose_card_present: Boolean(cardStatus(cards, "goose")),
       elysia_dependency_present: Boolean(pkg.deps.elysia),
+      littleorange_doctor_present: Boolean(pkg.scripts["littleorange:doctor"]),
       ledger_mentions_v3_phases: ["Elysia API Bridge", "MCP + Context7", "Goose Executor", "OpenJarvis Eval Harness"].every((text) => ledgerText.includes(text)),
       package_hash: sha256(JSON.stringify(pkg.deps)),
     },
@@ -223,13 +236,15 @@ async function main() {
       "Goose is a registered candidate and envelope, not a promoted executor.",
       "OpenJarvis is an eval/spec harness, not the active router.",
       "Context7 is a docs-lane candidate, not installed as an always-on MCP lane.",
+      "LittleOrange/Cortex has a doctor and separate visual-surface boundary; Ops verifies it but does not edit its frontend lane here.",
       "AI SDK/Ollama, libSQL vectors, Mastra, TileLang, TileKernels, and DFlash are not active dependencies in this repo right now.",
     ],
     next_actions_ranked: [
       "Run visual:readiness whenever ToolMesh cards or lab doctors change.",
       "Benchmark Elysia sidecar against current rails before making it default.",
       "Run Goose only inside a ghost worktree with the existing envelope and one bounded task.",
       "Use OpenJarvis to evaluate TriLane efficiency, not to replace it.",
+      "Run littleorange:doctor and visual proof in the visual lane before calling LittleOrange release-ready.",
       "Promote Context7 as read-only docs hydration only after MCP quarantine proof.",
       "Keep TileLang/TileKernels/DFlash as Codexa GPU alpha, not N150/dev runtime.",
     ],

scripts/v4/orangebox-ops-readiness-doctor.mjs

@@ -272,16 +272,21 @@ function main() {
       active_contracts: horizonReview?.summary?.active_contracts ?? null,
       elysia_dependency_present: horizonReview?.summary?.elysia_dependency_present ?? null,
       goose_card_present: horizonReview?.summary?.goose_card_present ?? null,
-      note: "Reviews OpenJarvis/OBOX Jarvis, Goose, Context7, Elysia, AI SDK/Ollama, libSQL, Mastra, and GPU acceleration candidates without auto-promoting them.",
+      littleorange_doctor_present: horizonReview?.summary?.littleorange_doctor_present ?? null,
+      note: "Reviews OpenJarvis/OBOX Jarvis, Goose, Context7, Elysia, LittleOrange/Cortex, AI SDK/Ollama, libSQL, Mastra, and GPU acceleration candidates without auto-promoting them.",
     },
     visual_production_readiness: {
-      ok: visualReadiness?.ok === true && visualReadiness?.control_plane_green === true,
+      ok: visualReadiness?.ok === true && visualReadiness?.control_plane_green === true && visualReadiness?.summary?.visual_artifact_pipeline_ready === true,
       path: visualReadinessPath,
       status: visualReadiness?.status || null,
       visual_ready: visualReadiness?.visual_ready ?? null,
       control_plane_green: visualReadiness?.control_plane_green ?? null,
       artifact_vault_ready: visualReadiness?.summary?.artifact_vault_ready ?? null,
       artifact_manifest_path: visualReadiness?.summary?.artifact_manifest_path ?? null,
+      artifact_smoke_ready: visualReadiness?.summary?.artifact_smoke_ready ?? null,
+      smoke_artifact_path: visualReadiness?.summary?.smoke_artifact_path ?? null,
+      smoke_artifact_sha256: visualReadiness?.summary?.smoke_artifact_sha256 ?? null,
+      visual_artifact_pipeline_ready: visualReadiness?.summary?.visual_artifact_pipeline_ready ?? null,
       runtime_ready_lanes: visualReadiness?.summary?.runtime_ready_lanes ?? null,
       visual_tool_cards: visualReadiness?.summary?.visual_tool_cards ?? null,
       note: "Reports visual/media/design runtime truth and artifact vault readiness. It may be green as a readiness doctor while visual_ready remains false until runtime tools are promoted.",