@nodetool-ai/cli 0.8.1 → 0.8.3

package/dist/harness/registry.js

@@ -25,6 +25,8 @@
  * the selfchecks of every harness covering a touched surface. The gate — not
  * the author — selects the checks.
  */
+import { computeAffected } from "../affected/affected.js";
+import { isGlobalGateFile } from "./changed-files.js";
 /**
  * The pure suites behind the script↔storyboard link and the guided creation
  * flows. One constant because the entry's `command` and its `selfcheck` must
@@ -54,7 +56,10 @@ const GAME_FLOW_SUITES = "npm run test --workspace=packages/protocol -- game &&
     "npm run test --workspace=packages/game-nodes && " +
     "npm run test --workspace=packages/game-runtime && " +
     "npm run test --workspace=packages/game-renderer && " +
-    "npm run test --workspace=packages/websocket -- trpc-games";
+    "npm run test --workspace=packages/websocket -- trpc-games trpc-game-asset-browser gameDraftHistory style-presets && " +
+    "npm run test --workspace=packages/agents -- game && " +
+    "npm run test --workspace=packages/cli -- game-command && " +
+    "npm run test --workspace=web -- src/stores/game src/components/game src/components/setup/game src/hooks/game";
 /**
  * Durable generation recovery without a provider call. These suites exercise
  * acceptance and lease fencing, explicit FAL queue binding, receipt ordering,
@@ -91,8 +96,9 @@ const TIMELINE_MODEL3D_SUITES = "npm run test --workspace=packages/video-nodes -
 const TIMELINE_NATIVE_MEDIA_EDITING_SUITES = "npm run test --workspace=packages/timeline -- extension && " +
     "npm run test --workspace=packages/runtime -- video-extension && " +
     "npm run test --workspace=packages/websocket -- video-extension-inference && " +
-    "npm run test --workspace=packages/agents -- timeline-generative-edit timeline-tool-loop && " +
-    "npm run test --workspace=web -- useTimelineAgentBridge timelineTools nativeMediaEditingAcceptance nativeMediaEditingPreview timelineExtension useTimelineExtension ExtendClipPanel";
+    "npm run test --workspace=packages/agents -- timeline-headless-media-parity timeline-tool-contracts timeline-generative-edit timeline-tool-loop && " +
+    "npm run test --workspace=web -- useTimelineAgentBridge timelineTools nativeMediaEditingAcceptance nativeMediaEditingPreview timelineExtension useTimelineExtension ExtendClipPanel" +
+    " && npm run test --workspace=packages/websocket -- generation-recovery-media";
 /**
  * The audio-driven-motion suites: `bake_audio_animation`'s own arithmetic
  * (the two clock hops, the envelope/beats curve shapes) plus the end-to-end
@@ -200,6 +206,21 @@ export const HARNESSES = [
             cost: "expensive"
         }
     },
+    {
+        id: "manimgx",
+        title: "ManimGX scene inspection and render (nodetool.manimgx.* nodes)",
+        command: "npm run test:real --workspace=packages/manimgx-nodes",
+        kind: "execution",
+        capabilities: ["no-db"],
+        docs: "packages/manimgx-nodes/README.md",
+        selfcheck: {
+            // Renders and inspects real scenes through the nodes, with an image
+            // input. It needs manimgx installed (Python 3.13+, GPU or lavapipe),
+            // so the default gate skips it without --expensive.
+            command: "npm run test:real --workspace=packages/manimgx-nodes",
+            cost: "expensive"
+        }
+    },
     {
         id: "dsl-native-flow",
         title: "Native flow (call a node as a function, host backend + guest surface)",
@@ -214,6 +235,31 @@ export const HARNESSES = [
         docs: "docs/dsl-native-flow-design.md",
         selfcheck: {
             command: "npm run test --workspace=packages/dsl -- flow-core flow-streaming flow-abort",
+            cost: "cheap",
+            suiteOnly: true
+        }
+    },
+    {
+        id: "app-runs",
+        title: "Durable app operation and generation attachment check",
+        command: "npm run test --workspace=packages/execution -- app-operation app-run-generation",
+        kind: "execution",
+        capabilities: [],
+        docs: "docs/harnesses.md § App runs phase 1",
+        selfcheck: {
+            command: "npm run test --workspace=packages/execution -- app-operation app-run-generation",
+            cost: "cheap"
+        }
+    },
+    {
+        id: "run-traces",
+        title: "Durable app trace, content policy and ancestry check",
+        command: "npm run test --workspace=packages/execution --workspace=packages/runtime --workspace=packages/models --workspace=packages/websocket -- run-trace external-trace-privacy http-tracing",
+        kind: "execution",
+        capabilities: [],
+        docs: "docs/harnesses.md § Run traces phase 2",
+        selfcheck: {
+            command: "npm run test --workspace=packages/execution --workspace=packages/runtime --workspace=packages/models --workspace=packages/websocket -- run-trace external-trace-privacy http-tracing",
             cost: "cheap"
         }
     },
@@ -225,10 +271,88 @@ export const HARNESSES = [
         capabilities: ["json", "interact", "no-db"],
         docs: "docs/harnesses.md § nodetool app debug",
         selfcheck: {
-            command: "npm run dev:nodetool -- app debug packages/base-nodes/nodetool/examples/apps/ad-maker.app.json --no-run",
+            // Ad Maker shows one step at a time, so the check walks both steps the
+            // way a person does before it judges whether every run is reachable.
+            command: "npm run dev:nodetool -- app debug packages/base-nodes/nodetool/examples/apps/ad-maker.app.json --no-run --interact '[{\"set\":{\"key\":\"step\",\"value\":\"settle-the-message\"}},{\"set\":{\"key\":\"step\",\"value\":\"direct-the-campaign-image\"}}]'",
+            cost: "cheap"
+        }
+    },
+    {
+        id: "run-readers",
+        title: "Run reader, debug history and CLI failure-path check",
+        command: "npm run test --workspace=packages/execution --workspace=packages/models --workspace=packages/websocket --workspace=packages/agents --workspace=packages/cli -- runs-phase3 app-debug-versioned-targets app-debug-workflow-inputs-phase3 capabilities-runs runs-command runs-integration run-readers job-find runs-trpc sandbox-api-coverage",
+        kind: "execution",
+        capabilities: ["json"],
+        docs: "docs/harnesses.md § Run readers phase 3",
+        selfcheck: {
+            command: "npm run test --workspace=packages/execution --workspace=packages/models --workspace=packages/websocket --workspace=packages/agents --workspace=packages/cli -- runs-phase3 app-debug-versioned-targets app-debug-workflow-inputs-phase3 capabilities-runs runs-command runs-integration run-readers job-find runs-trpc sandbox-api-coverage",
+            cost: "cheap"
+        }
+    },
+    {
+        id: "browser-run-spans",
+        title: "Browser run ownership, ancestry and restart check",
+        command: "npm run test --workspace=packages/websocket -- browser-run-spans-phase4 browser-app-run-phase4 app-runs-workflow",
+        kind: "execution",
+        capabilities: [],
+        docs: "docs/harnesses.md § Run inspection phase 4",
+        selfcheck: {
+            command: "npm run test --workspace=packages/websocket -- browser-run-spans-phase4 browser-app-run-phase4 app-runs-workflow",
+            cost: "cheap"
+        }
+    },
+    {
+        id: "run-inspection-ui",
+        title: "Stored trace, activity replay and browser recorder check",
+        command: "npm run test --workspace=web -- --runInBand --testPathPattern='browserRunTrace|browserWorkflowRunner|WorkflowRunner.test|TracePanel.test|TraceStore|useRuns|runTraceCache|appRunActivity|AgentActivityWidget|useWidgetRuntime|sketchPadWidget|workflowFormWidget|chatWidgets|mediaWidgets|buttonWidget|recorderWidgets|conditionalWidget|errorTraceReporting|ChatSurface.test|AskRunAgentButton|useAppRuntime|runJsScript.test'",
+        kind: "execution",
+        capabilities: [],
+        docs: "docs/harnesses.md § Run inspection phase 4",
+        selfcheck: {
+            command: "npm run test --workspace=web -- --runInBand --testPathPattern='browserRunTrace|browserWorkflowRunner|WorkflowRunner.test|TracePanel.test|TraceStore|useRuns|runTraceCache|appRunActivity|AgentActivityWidget|useWidgetRuntime|sketchPadWidget|workflowFormWidget|chatWidgets|mediaWidgets|buttonWidget|recorderWidgets|conditionalWidget|errorTraceReporting|ChatSurface.test|AskRunAgentButton|useAppRuntime|runJsScript.test'",
+            cost: "cheap"
+        }
+    },
+    {
+        id: "run-inspection-browser",
+        title: "Browser action ancestry and Trace/Logs reload journey",
+        command: "npm run test:journeys --workspace=web -- run-observability.spec.ts",
+        kind: "execution",
+        capabilities: ["browser"],
+        docs: "docs/harnesses.md § Run inspection phase 4"
+    },
+    {
+        id: "app-instance-history",
+        title: "Instance management, pinned versions and history projection check",
+        command: "npm run test --workspace=packages/models --workspace=packages/execution --workspace=packages/websocket -- app-instance run-list-app-metadata runs-phase3 app-operation",
+        kind: "execution",
+        capabilities: [],
+        docs: "docs/harnesses.md § App instances and history phase 5",
+        selfcheck: {
+            command: "npm run test --workspace=packages/models --workspace=packages/execution --workspace=packages/websocket -- app-instance run-list-app-metadata runs-phase3 app-operation",
             cost: "cheap"
         }
     },
+    {
+        id: "app-instance-history-ui",
+        title: "Instance tabs, management cache and app host check",
+        command: "npm run test --workspace=web -- --runInBand --testPathPattern='WorkspaceTabsStore|useAppInstances|useAppInstance|ApplicationSurface|ApplicationRunView|AppRuntimeView|AppRunHistory|useAppRuntime'",
+        kind: "execution",
+        capabilities: [],
+        docs: "docs/harnesses.md § App instances and history phase 5",
+        selfcheck: {
+            command: "npm run test --workspace=web -- --runInBand --testPathPattern='WorkspaceTabsStore|useAppInstances|useAppInstance|ApplicationSurface|ApplicationRunView|AppRuntimeView|AppRunHistory|useAppRuntime'",
+            cost: "cheap"
+        }
+    },
+    {
+        id: "app-instance-history-browser",
+        title: "Independent app instances and read-only historical results journey",
+        command: "npm run test:journeys --workspace=web -- app-instances.spec.ts run-observability.spec.ts",
+        kind: "execution",
+        capabilities: ["browser"],
+        docs: "docs/harnesses.md § App instances and history phase 5"
+    },
     {
         id: "app-build",
         title: "Mini-app build harness (spec→plan→author→check→run→judge)",
@@ -290,6 +414,21 @@ export const HARNESSES = [
             cost: "cheap"
         }
     },
+    {
+        id: "timeline-score",
+        title: "Timeline craft scorecard (agent output vs. shipped showcase examples)",
+        command: "nodetool timeline score <id|file.json> [--json] [--min-score <n>] [--sheet <out.png>]",
+        kind: "static",
+        capabilities: ["json", "no-db"],
+        docs: "docs/harnesses.md § nodetool timeline score",
+        selfcheck: {
+            // Deterministic: the metrics/formula core, plus the reference band
+            // computed from the shipped examples at test time — no model, no key.
+            command: "npm run test --workspace=packages/execution -- timeline-score && " +
+                "npm run test --workspace=packages/cli -- timeline-score",
+            cost: "cheap"
+        }
+    },
     {
         id: "serein-timeline-repro",
         title: "Serein timeline motion frame reproduction",
@@ -354,7 +493,11 @@ export const HARNESSES = [
         capabilities: ["no-db"],
         agentTool: "bake_audio_animation",
         docs: "docs/harnesses.md § Audio-driven timeline motion",
-        selfcheck: { command: TIMELINE_AUDIO_DRIVE_SUITES, cost: "cheap" }
+        selfcheck: {
+            command: TIMELINE_AUDIO_DRIVE_SUITES,
+            cost: "cheap",
+            suiteOnly: true
+        }
     },
     {
         id: "timeline-generated-matte",
@@ -471,7 +614,8 @@ export const HARNESSES = [
         docs: "docs/harnesses.md § nodetool chat",
         selfcheck: {
             command: "npm run test --workspace=packages/cli -- tests/chat-app.test.ts tests/chat-media.test.ts tests/terminal-keyboard.test.ts tests/terminal-input.test.ts tests/terminal-mouse.test.ts tests/terminal-screen.test.ts tests/chat-prompts.test.ts tests/chat-sessions.test.ts tests/websocket-client.test.ts",
-            cost: "cheap"
+            cost: "cheap",
+            suiteOnly: true
         }
     },
     {
@@ -688,6 +832,20 @@ export const HARNESSES = [
             cost: "cheap"
         }
     },
+    {
+        id: "mutator",
+        title: "Mutation testing (nodetool-mutator)",
+        command: "npm run mutate -- --base origin/main packages/<name>/src",
+        kind: "static",
+        capabilities: ["no-db"],
+        docs: "docs/harnesses.md § npm run mutate",
+        selfcheck: {
+            // Parses and binds every site in the tool's own source through the
+            // built CLI, without running a test.
+            command: "npm run mutate -- --scan packages/mutator/src",
+            cost: "cheap"
+        }
+    },
     {
         id: "recipes",
         title: "Recipe chains (shipped manifests, the app listing, the site pages)",
@@ -728,7 +886,8 @@ export const HARNESSES = [
         docs: "docs/plans/tutorial-focus-animation.md",
         selfcheck: {
             command: "npm run test --workspace=demo",
-            cost: "cheap"
+            cost: "cheap",
+            suiteOnly: true
         }
     },
     {
@@ -760,7 +919,8 @@ export const HARNESSES = [
             // resolution, drain/shutdown. Multi-minute (255 files), so this stays
             // an --expensive selfcheck rather than the default gate.
             command: "npm run test --workspace=packages/websocket",
-            cost: "expensive"
+            cost: "expensive",
+            suiteOnly: true
         }
     },
     {
@@ -772,7 +932,8 @@ export const HARNESSES = [
         docs: "packages/models/AGENTS.md",
         selfcheck: {
             command: "npm run test --workspace=packages/models",
-            cost: "cheap"
+            cost: "cheap",
+            suiteOnly: true
         }
     },
     {
@@ -925,16 +1086,15 @@ export const SURFACES = [
         // `capability-suites` covers the seam — dispatch, classification, and what
         // a process with no action layer answers. The half below it runs in
         // `npm run test:integration --workspace=packages/browser`, which
-        // launches a real Chrome with the built extension loaded and drives the
-        // production transport end to end. It is not a selfcheck: it downloads
-        // Chrome and binds port 7777, so a diff to the relay still needs it run
-        // by hand.
+        // launches a real Chrome with the built extension loaded and its native
+        // host registered, and drives the production transport end to end. It is
+        // not a selfcheck: it downloads Chrome, so a diff to the relay still
+        // needs it run by hand.
         paths: [
             "chrome-extension/",
             "packages/browser/",
             "packages/agents/src/capabilities/browser.ts",
-            "packages/agents/src/capabilities/browser.specs.ts",
-            "packages/websocket/src/extension-cdp-bridge.ts"
+            "packages/agents/src/capabilities/browser.specs.ts"
         ]
     },
     {
@@ -995,9 +1155,13 @@ export const SURFACES = [
         title: "Native game creation and editing",
         harnesses: ["game-flow", "capability-suites", "validate"],
         paths: [
+            "packages/cli/src/commands/game.ts",
+            "packages/protocol/src/game.ts",
+            "packages/protocol/src/game3d.ts",
             "packages/protocol/src/game-design.ts",
             "packages/protocol/src/game-graph.ts",
             "packages/protocol/src/game-flow-prompt.ts",
+            "packages/protocol/src/native-game-templates.ts",
             "packages/protocol/src/style-presets.ts",
             "packages/game-nodes/",
             "packages/game-runtime/",
@@ -1006,9 +1170,125 @@ export const SURFACES = [
             "packages/godot-templates/",
             "packages/base-nodes/tests/game-graph-chips.test.ts",
             "packages/websocket/src/trpc/routers/games.ts",
+            "packages/websocket/src/trpc/routers/gameDraftHistory.ts",
             "packages/websocket/src/lib/style-presets.ts",
+            "web/src/components/game/",
+            "web/src/components/setup/game/",
+            "web/src/hooks/game/",
+            "web/src/stores/game/",
+            "web/tests/journeys/native-game3d-editor.spec.ts",
             "web/src/components/workspace/GameSurface.tsx",
-            "web/src/components/projects/NewProjectSurface.tsx"
+            "web/src/components/projects/NewProjectSurface.tsx",
+            "packages/protocol/src/game-script-params.ts"
+        ]
+    },
+    {
+        id: "app-runs",
+        title: "App instances and durable operation runs",
+        harnesses: ["app-runs"],
+        paths: [
+            "packages/models/src/app-instance.ts",
+            "packages/models/src/migrations/versions.ts",
+            "packages/protocol/src/api-schemas/app-runs.ts",
+            "packages/execution/src/service/app-operation.ts",
+            "packages/execution/src/app-run-generation.ts",
+            "packages/websocket/src/lib/app-instances-service.ts",
+            "packages/websocket/src/routes/app-runs.ts",
+            "packages/websocket/src/trpc/routers/app-instances.ts",
+            "packages/websocket/src/trpc/routers/app-runs.ts",
+            "web/src/components/appbuilder/runtime/"
+        ]
+    },
+    {
+        id: "run-traces",
+        title: "Server run trace persistence and privacy",
+        harnesses: ["run-traces"],
+        paths: [
+            "packages/protocol/src/run-trace.ts",
+            "packages/models/src/run-trace.ts",
+            "packages/models/src/migrations/run-traces.ts",
+            "packages/models/src/schema/run-traces.ts",
+            "packages/models/src/schema-pg/run-traces.ts",
+            "packages/runtime/src/run-trace-",
+            "packages/runtime/src/telemetry.ts",
+            "packages/runtime/src/trace-exporters.ts",
+            "packages/runtime/src/providers/loop-tracing.ts",
+            "packages/execution/src/run-trace-store.ts",
+            "packages/execution/src/service/run-trace-lifecycle.ts",
+            "packages/websocket/src/lib/http-tracing.ts",
+            "packages/websocket/src/storage-retention.ts"
+        ]
+    },
+    {
+        id: "run-readers",
+        title: "Common run inspection for agents and CLI",
+        harnesses: ["run-readers"],
+        paths: [
+            "packages/protocol/src/run-readers.ts",
+            "packages/protocol/src/api-schemas/runs.ts",
+            "packages/models/src/run-readers.ts",
+            "packages/execution/src/runs.ts",
+            "packages/execution/src/app-debug/run-recording.ts",
+            "packages/execution/src/service/app-debug-service.ts",
+            "packages/agents/src/capabilities/runs",
+            "packages/agents/src/capabilities/jobs.ts",
+            "packages/agents/src/evals/codeact-api-runs.ts",
+            "packages/cli/src/commands/runs.ts",
+            "packages/cli/src/app-debug/harness.ts",
+            "packages/websocket/src/trpc/routers/runs.ts",
+            "packages/websocket/src/lib/app-debug-service.ts"
+        ]
+    },
+    {
+        id: "run-inspection",
+        title: "Browser run ingestion and durable UI inspection",
+        harnesses: ["browser-run-spans", "run-inspection-ui", "run-inspection-browser"],
+        paths: [
+            "packages/protocol/src/browser-run-traces.ts",
+            "packages/execution/src/browser-app-run.ts",
+            "packages/execution/src/browser-run-spans.ts",
+            "packages/execution/src/browser-trace-policy.ts",
+            "packages/websocket/src/routes/run-spans.ts",
+            "packages/websocket/src/lib/test-ui-run-routes.ts",
+            "web/src/lib/browserRunTrace.ts",
+            "web/src/lib/workflow/browserWorkflowRunner.ts",
+            "web/src/components/panels/TracePanel.tsx",
+            "web/src/components/appbuilder/runtime/",
+            "web/src/components/appbuilder/AppRuntimeView.tsx",
+            "web/src/components/appbuilder/puck/useWidgetRuntime.ts",
+            "web/src/components/appbuilder/puck/conditionalWidget.tsx",
+            "web/src/components/workspace/ChatSurface.tsx",
+            "web/src/stores/ChatDraftStore.ts",
+            "web/src/components/appbuilder/puck/AgentActivityWidget.tsx",
+            "web/src/components/runs/",
+            "web/src/serverState/useRuns.ts",
+            "web/src/serverState/runTraceCache.ts",
+            "web/src/serverState/appRunActivity.ts",
+            "web/src/hooks/useAppOperationRun.ts",
+            "web/src/hooks/useRunInspection.ts",
+            "web/src/stores/TraceStore.ts",
+            "web/tests/journeys/run-observability.spec.ts"
+        ]
+    },
+    {
+        id: "app-instance-history",
+        title: "App instance management and historical results",
+        harnesses: ["app-instance-history", "app-instance-history-ui", "app-instance-history-browser"],
+        paths: [
+            "packages/models/src/app-instance",
+            "packages/models/src/run-readers.ts",
+            "packages/execution/src/runs.ts",
+            "packages/protocol/src/api-schemas/app-runs.ts",
+            "packages/websocket/src/lib/app-instances-service.ts",
+            "packages/websocket/src/routes/app-runs.ts",
+            "packages/websocket/src/trpc/routers/app-instances.ts",
+            "web/src/components/appbuilder/",
+            "web/src/components/workspace/ApplicationSurface.tsx",
+            "web/src/components/workspace/TabContent.tsx",
+            "web/src/stores/WorkspaceTabsStore.ts",
+            "web/src/serverState/useAppInstances.ts",
+            "web/src/serverState/useRuns.ts",
+            "web/tests/journeys/app-instances.spec.ts"
         ]
     },
     {
@@ -1017,6 +1297,7 @@ export const SURFACES = [
         harnesses: ["app-debug", "app-build", "eval"],
         paths: [
             "packages/app-runtime/",
+            "packages/app-export/",
             "packages/agents/src/app-build/",
             "packages/execution/src/app-debug/",
             "packages/base-nodes/nodetool/examples/apps/",
@@ -1038,6 +1319,7 @@ export const SURFACES = [
             "timeline-validate",
             "timeline-debug",
             "timeline-render",
+            "timeline-score",
             "timeline-versions",
             "eval"
         ],
@@ -1048,10 +1330,12 @@ export const SURFACES = [
             "packages/cli/src/timeline-debug/",
             "packages/cli/src/commands/timeline-versions.ts",
             "packages/cli/src/commands/timeline-render.ts",
+            "packages/cli/src/commands/timeline-score.ts",
             "packages/video-nodes/src/nodes/timeline/compositeRender.ts",
             "packages/agents/src/tools/timeline-version-tools.ts",
             "packages/models/src/timeline-sequence-version.ts",
-            "packages/websocket/src/trpc/routers/timeline.ts"
+            "packages/websocket/src/trpc/routers/timeline.ts",
+            "scripts/motion-craft-eval.mjs"
         ]
     },
     {
@@ -1084,6 +1368,14 @@ export const SURFACES = [
         harnesses: ["timeline-native-media-editing"],
         paths: [
             "packages/timeline/src/generative.ts",
+            "packages/agents/src/capabilities/timelines.ts",
+            "packages/agents/src/capabilities/timeline-media-edit.ts",
+            "packages/agents/src/capabilities/timeline-clip-frames.ts",
+            "packages/agents/tests/timeline-headless-media-parity.test.ts",
+            "packages/runtime/src/trim-video-window.ts",
+            "packages/websocket/src/timeline-generation-recovery.ts",
+            "packages/websocket/src/lib/media.ts",
+            "packages/websocket/tests/generation-recovery-media.test.ts",
             "packages/timeline/src/extension.ts",
             "packages/timeline/src/extensionRequest.ts",
             "packages/timeline/src/takes.ts",
@@ -1103,17 +1395,6 @@ export const SURFACES = [
             "web/src/lib/tools/builtin/timeline.ts"
         ]
     },
-    {
-        id: "timeline-native-media-editing-server-generation-gap",
-        title: "Server edit_timeline generative-edit submission",
-        harnesses: [],
-        paths: ["packages/agents/src/capabilities/timelines.ts"],
-        gap: "edit_timeline deliberately excludes ui_timeline_generatively_edit_clip: " +
-            "it can persist a timeline document but cannot submit or reconcile a " +
-            "durable media-generation job. A future harness should drive that " +
-            "server-side job through candidate creation, explicit apply_take, and " +
-            "a restored undo snapshot without inventing an asset id."
-    },
     {
         id: "timeline-audio-drive",
         title: "Audio-driven timeline motion (bake_audio_animation, audio analysis)",
@@ -1276,7 +1557,9 @@ export const SURFACES = [
             "packages/audio-nodes/src/nodes/game.ts",
             "packages/game-nodes/src/nodes/game.ts",
             "packages/agents/src/capabilities/game.ts",
-            "packages/agents/src/capabilities/game.specs.ts"
+            "packages/agents/src/capabilities/game.specs.ts",
+            "packages/agents/src/capabilities/game3d.ts",
+            "packages/agents/src/capabilities/game-asset-source.ts"
         ]
     },
     {
@@ -1285,6 +1568,12 @@ export const SURFACES = [
         harnesses: ["blender"],
         paths: ["packages/blender-nodes/"]
     },
+    {
+        id: "manimgx",
+        title: "ManimGX scenes (runner, nodes, authoring skill)",
+        harnesses: ["manimgx"],
+        paths: ["packages/manimgx-nodes/"]
+    },
     {
         id: "entities",
         title: "Entity library (ingredients, prompt injection, ui_entity_* tools)",
@@ -1361,7 +1650,9 @@ export const SURFACES = [
         paths: [
             "demo/src/",
             "demo/scripts/render-tutorials.ts",
-            "demo/scripts/render-marketing.ts"
+            "demo/scripts/render-marketing.ts",
+            "demo/scripts/encode-hero.mjs",
+            "demo/scripts/vibe-track.ts"
         ]
     },
     {
@@ -1390,6 +1681,12 @@ export const SURFACES = [
             "scripts/provider-codegen-check.mjs"
         ]
     },
+    {
+        id: "mutation-testing",
+        title: "Mutation testing tool and its score report",
+        harnesses: ["mutator"],
+        paths: ["packages/mutator/", "scripts/mutation-score.mjs"]
+    },
     {
         id: "deploy-image",
         title: "Deployed GHCR image (Fly.io / self-hosted)",
@@ -1499,6 +1796,7 @@ export const SURFACES = [
             "packages/together-nodes/",
             "packages/topaz-nodes/",
             "packages/transformers-js-nodes/",
+            "packages/whisper-cpp/",
             "packages/video-nodes/",
             // Portable runner (graph + registry → a Request/Response handler); CI
             // groups it with the node packages for the same reason.
@@ -1666,11 +1964,21 @@ export function auditPathClaims(rootDirs, surfaces = SURFACES, unclaimed = UNCLA
         return !claims.some((p) => p.startsWith(prefix) || prefix.startsWith(p));
     });
 }
-export function planGate(changedFiles, harnesses = HARNESSES, surfaces = SURFACES) {
+/**
+ * Select checks for a diff. Without `packages`, a surface is touched only by a
+ * changed path under one of its prefixes. With them, a surface is also touched
+ * when one of its paths lies inside a workspace downstream of a changed one,
+ * since its code then runs against changed code (`viaDependency`).
+ */
+export function planGate(changedFiles, harnesses = HARNESSES, surfaces = SURFACES, packages) {
     const byId = new Map(harnesses.map((h) => [h.id, h]));
     const touched = new Map();
+    const viaDependency = new Set();
     const unmappedFiles = [];
+    const globalFiles = changedFiles.filter(isGlobalGateFile);
     for (const file of changedFiles) {
+        if (isGlobalGateFile(file))
+            continue;
         let matched = false;
         for (const s of surfaces) {
             if (s.paths.some((p) => file === p || file.startsWith(p))) {
@@ -1683,6 +1991,21 @@ export function planGate(changedFiles, harnesses = HARNESSES, surfaces = SURFACE
         if (!matched)
             unmappedFiles.push(file);
     }
+    if (packages) {
+        const dirs = computeAffected(changedFiles, packages)
+            .affected.map((name) => packages.find((p) => p.name === name)?.dir)
+            .filter((d) => d !== undefined)
+            .map((d) => d.replace(/^\.\//, "").replace(/\/+$/, ""));
+        for (const s of surfaces) {
+            if (touched.has(s.id))
+                continue;
+            const inside = s.paths.some((p) => dirs.some((d) => p === d || p.startsWith(`${d}/`)));
+            if (inside) {
+                touched.set(s.id, []);
+                viaDependency.add(s.id);
+            }
+        }
+    }
     const checkByHarness = new Map();
     const manualByHarness = new Map();
     const uncoveredSurfaces = [];
@@ -1707,6 +2030,7 @@ export function planGate(changedFiles, harnesses = HARNESSES, surfaces = SURFACE
                         harnessId: id,
                         command: h.selfcheck.command,
                         cost: h.selfcheck.cost,
+                        suiteOnly: h.selfcheck.suiteOnly ?? false,
                         surfaces: [s.id]
                     });
                 }
@@ -1726,13 +2050,33 @@ export function planGate(changedFiles, harnesses = HARNESSES, surfaces = SURFACE
             }
         }
     }
+    // A global file selects every selfcheck, as `--all` does; surfaces it
+    // would not otherwise name stay with an empty list.
+    if (globalFiles.length > 0) {
+        for (const h of harnesses) {
+            if (!h.selfcheck || checkByHarness.has(h.id))
+                continue;
+            checkByHarness.set(h.id, {
+                harnessId: h.id,
+                command: h.selfcheck.command,
+                cost: h.selfcheck.cost,
+                suiteOnly: h.selfcheck.suiteOnly ?? false,
+                surfaces: []
+            });
+        }
+    }
     return {
         changedFiles,
-        surfaces: [...touched.entries()].map(([id, files]) => ({ id, files })),
+        surfaces: [...touched.entries()].map(([id, files]) => ({
+            id,
+            files,
+            ...(viaDependency.has(id) && { viaDependency: true })
+        })),
         checks: [...checkByHarness.values()],
         manual: [...manualByHarness.values()],
         uncoveredSurfaces,
-        unmappedFiles
+        unmappedFiles,
+        globalFiles
     };
 }
 //# sourceMappingURL=registry.js.map