@event4u/agent-config 9.10.0 → 9.11.0

package/agents/templates/.ai-video.xml.example

@@ -0,0 +1,247 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  agents/.ai-video.xml.example
+  ============================
+
+  Operator-facing provider configuration for the /video:* command cluster.
+
+  Copy this file to `agents/.ai-video.xml` and fill in the API keys for the
+  providers you actually use. The real file is gitignored and MUST NEVER be
+  committed.
+
+  Loader: scripts/media/lib/load-config.sh
+  Redaction: scripts/media/lib/redact.sh
+  Docs: agents/reference/ai-video/README.md
+-->
+<ai-video version="1">
+
+  <!--
+    Defaults: pick which provider a /video:* run uses when the command
+    does not pass the image-provider / video-provider flags. Must match
+    a provider id="..." declared below.
+
+    Each provider carries a <lifecycle> tag — experimental | stable |
+    deprecated | community — per docs/contracts/provider-lifecycle.md.
+    Day-one shipped tiers are conservative: every adapter is
+    `experimental` until a maintainer captures a real-API smoke trace.
+    The agent refuses to *default* to a non-stable provider silently;
+    it surfaces the tier and asks before running.
+  -->
+  <default-image-provider>openai-images</default-image-provider>
+  <default-video-provider>gemini-veo</default-video-provider>
+
+  <!-- ============================================================ -->
+  <!-- Image providers                                              -->
+  <!-- ============================================================ -->
+
+  <provider id="openai-images" kind="image">
+    <lifecycle>stable</lifecycle>
+    <api-key>sk-REPLACE-ME</api-key>
+    <endpoint>https://api.openai.com/v1</endpoint>
+    <default-model>gpt-image-1</default-model>
+    <dry-run>true</dry-run>
+    <tuning>
+      <aspect>16:9</aspect>
+      <quality>high</quality>
+      <best-of-n>4</best-of-n>
+    </tuning>
+  </provider>
+
+  <!-- ============================================================ -->
+  <!-- Video providers                                              -->
+  <!-- ============================================================ -->
+
+  <provider id="higgsfield" kind="image+video">
+    <lifecycle>stable</lifecycle>
+    <api-key>hf-REPLACE-ME</api-key>
+    <endpoint>https://api.higgsfield.ai/v1</endpoint>
+    <default-model>higgsfield-soul</default-model>
+    <dry-run>true</dry-run>
+    <tuning>
+      <aspect>16:9</aspect>
+      <preset>cinematic</preset>
+      <max-duration>5</max-duration>
+      <best-of-n>2</best-of-n>
+    </tuning>
+  </provider>
+
+  <provider id="gemini-veo" kind="video">
+    <lifecycle>stable</lifecycle>
+    <api-key>AIza-REPLACE-ME</api-key>
+    <endpoint>https://generativelanguage.googleapis.com/v1beta</endpoint>
+    <default-model>veo-3.0-generate-001</default-model>
+    <dry-run>true</dry-run>
+    <tuning>
+      <aspect>16:9</aspect>
+      <fps>24</fps>
+      <max-duration>8</max-duration>
+      <audio-native>true</audio-native>
+    </tuning>
+  </provider>
+
+  <provider id="kling" kind="video">
+    <lifecycle>stable</lifecycle>
+    <access-key>kling-access-REPLACE-ME</access-key>
+    <secret-key>kling-secret-REPLACE-ME</secret-key>
+    <endpoint>https://api.klingai.com/v1</endpoint>
+    <default-model>kling-v2-master</default-model>
+    <dry-run>true</dry-run>
+    <tuning>
+      <aspect>16:9</aspect>
+      <fps>30</fps>
+      <max-duration>10</max-duration>
+      <audio-native>false</audio-native>
+    </tuning>
+  </provider>
+
+  <provider id="sora" kind="video">
+    <lifecycle>stable</lifecycle>
+    <api-key>sora-REPLACE-ME</api-key>
+    <endpoint>https://api.openai.com/v1</endpoint>
+    <default-model>sora-2</default-model>
+    <dry-run>true</dry-run>
+    <tuning>
+      <aspect>16:9</aspect>
+      <fps>30</fps>
+      <max-duration>20</max-duration>
+      <audio-native>true</audio-native>
+    </tuning>
+  </provider>
+
+  <!-- ============================================================ -->
+  <!-- Multiplexer providers — one adapter, many models             -->
+  <!-- Model selection: top-level `model_id` stdin key overrides    -->
+  <!-- <default-model>. Per-model capabilities:                     -->
+  <!-- scripts/ai-video/lib/model-capabilities/<id>.json            -->
+  <!-- Kill-switch: <enabled>false</enabled> refuses every network  -->
+  <!-- subcommand without editing procedures that name the provider.-->
+  <!-- ============================================================ -->
+
+  <provider id="fal" kind="video">
+    <lifecycle>stable</lifecycle>
+    <enabled>true</enabled>
+    <api-key>fal-REPLACE-ME</api-key>
+    <endpoint>https://queue.fal.run</endpoint>
+    <default-model>fal-ai/ltx-2/text-to-video</default-model>
+    <dry-run>true</dry-run>
+    <tuning>
+      <aspect>16:9</aspect>
+      <max-duration>10</max-duration>
+      <audio-native>false</audio-native>
+    </tuning>
+  </provider>
+
+  <provider id="replicate" kind="video">
+    <lifecycle>stable</lifecycle>
+    <enabled>true</enabled>
+    <api-key>r8_REPLACE-ME</api-key>
+    <endpoint>https://api.replicate.com/v1</endpoint>
+    <default-model>kwaivgi/kling-v2.1-master</default-model>
+    <dry-run>true</dry-run>
+    <tuning>
+      <aspect>16:9</aspect>
+      <max-duration>10</max-duration>
+      <audio-native>false</audio-native>
+    </tuning>
+  </provider>
+
+  <!--
+    Local ComfyUI (ADR-060 — container-primary sandbox). No api-key:
+    the adapter talks to YOUR ComfyUI. A loopback endpoint is assumed
+    to be the shipped container posture (read-only image, cap-drop ALL,
+    network-none at generation time — run line in the adapter header).
+    A NON-loopback endpoint is the remote escape hatch: isolation is
+    the operator's responsibility and the block must carry
+    <unsandboxed>accepted</unsandboxed> or the adapter refuses (exit 6).
+    Models: wan22-ti2v-5b (default, Apache-2.0) | ltx-2 (audio-sync).
+    Shipped workflow templates only — operator workflow JSONs are
+    rejected by design. macOS: no CUDA — container path is
+    reference-only; use the remote escape hatch.
+  -->
+  <provider id="comfyui" kind="video">
+    <lifecycle>experimental</lifecycle>
+    <enabled>true</enabled>
+    <endpoint>http://127.0.0.1:8188</endpoint>
+    <default-model>wan22-ti2v-5b</default-model>
+    <dry-run>true</dry-run>
+    <tuning>
+      <aspect>16:9</aspect>
+      <max-duration>5</max-duration>
+      <audio-native>false</audio-native>
+    </tuning>
+  </provider>
+
+  <!-- ============================================================ -->
+  <!-- Audio adapters (music-video orchestration)                   -->
+  <!-- Contract: scripts/ai-video/lib/audio-adapter-contract.md     -->
+  <!-- local-cli adapters wrap an OPERATOR-installed tool (pip) —   -->
+  <!-- no api-key element needed; <enabled>false</enabled> opts a   -->
+  <!-- configured-but-unwanted adapter out (otherwise a missing CLI -->
+  <!-- is a loud config failure, never a silent probe fallback).    -->
+  <!-- ============================================================ -->
+
+  <provider id="allin1" kind="audio-analysis">
+    <lifecycle>experimental</lifecycle>
+    <enabled>true</enabled>
+    <dry-run>true</dry-run>
+  </provider>
+
+  <provider id="whisperx" kind="lyrics">
+    <lifecycle>experimental</lifecycle>
+    <enabled>true</enabled>
+    <dry-run>true</dry-run>
+  </provider>
+
+  <!-- ============================================================ -->
+  <!-- Lip-sync post-process (v2 contract, kind="lipsync")          -->
+  <!-- Sparse budget: lib/model-capabilities/syncso.json            -->
+  <!-- ============================================================ -->
+
+  <!--
+    Local (MIT) lip-sync — offline alternative to syncso. Wraps an
+    OPERATOR-installed MuseTalk (github.com/TMElyralab/MuseTalk); the
+    wrapped entry point is configurable via the MUSETALK_CMD env var.
+    No api-key. Same sparse lipsync_budget discipline as syncso
+    (lib/model-capabilities/musetalk.json) — local renders are free but
+    the quality argument for sparseness is unchanged.
+  -->
+  <provider id="musetalk" kind="lipsync">
+    <lifecycle>experimental</lifecycle>
+    <enabled>true</enabled>
+    <dry-run>true</dry-run>
+  </provider>
+
+  <provider id="syncso" kind="lipsync">
+    <lifecycle>experimental</lifecycle>
+    <enabled>true</enabled>
+    <api-key>sk-REPLACE-ME</api-key>
+    <endpoint>https://api.sync.so</endpoint>
+    <default-model>lipsync-2</default-model>
+    <dry-run>true</dry-run>
+  </provider>
+
+  <!-- ============================================================ -->
+  <!-- Extra slot — future providers without schema bump            -->
+  <!-- Use kind="image" | "video" | "image+video" | "audio-analysis"-->
+  <!-- | "lyrics" | "lipsync".                                      -->
+  <!-- ============================================================ -->
+
+  <extra>
+    <!--
+    <provider id="my-future-backend" kind="video">
+      <lifecycle>experimental</lifecycle>
+      <api-key>REPLACE-ME</api-key>
+      <endpoint>https://example.invalid/v1</endpoint>
+      <default-model>example-1</default-model>
+      <dry-run>true</dry-run>
+      <tuning>
+        <aspect>16:9</aspect>
+        <fps>24</fps>
+        <max-duration>6</max-duration>
+        <audio-native>false</audio-native>
+      </tuning>
+    </provider>
+    -->
+  </extra>
+
+</ai-video>

package/dist/agent-src/rules/design-fidelity.md

@@ -20,7 +20,7 @@ applies_to_user_types:
 routes_to:
   - "guideline:design-fidelity-mechanics"
 workspaces: [engineering]
-packs: [frontend-design]
+packs: [engineering-base, frontend-design]
 ---
 
 # Design Fidelity

package/dist/agent-src/skills/existing-ui-audit/SKILL.md

@@ -31,7 +31,7 @@ Use this skill when:
 Do NOT use when:
 - `directive_set="ui-trivial"` — the trivial path bypasses audit by precondition (≤1 file, ≤5 lines, no new component, no new state, no new dep)
 - `directive_set="backend"` — no UI surface to inventory
-- The audit findings already exist in `state.ui_audit` for this state-file (cached) — re-run only if `package.json` or `composer.json` mtime changed
+- The audit findings already exist in `state.ui_audit` for this state-file — the gate round-trips through SUCCESS once `audit_path` is set, and does **not** re-run for the life of that state-file (see Gotchas for what that does and does not cover)
 
 ## Resource-first context gate (design fidelity)
 
@@ -243,7 +243,20 @@ tool produces, so the import path is uniform.
 - Don't assume a Radix-only `package.json` means shadcn — shadcn requires `components.json` at repo root.
 - `state.ui_audit.shadcn_inventory.version` is often missing; the shadcn CLI does not always pin itself in `package.json`. Record `null` rather than guessing.
 - Greenfield is detected, not assumed — a project with one Blade layout and no components is still greenfield only if tokens AND design system markers AND components are all empty.
-- Re-running the skill on a stale state-file: cache by `(composer.json mtime, package.json mtime)`; if either changed, re-audit and overwrite.
+- **There is no mtime cache.** An earlier revision told you to cache by
+  `(composer.json mtime, package.json mtime)` and re-audit when either changed.
+  No code implemented it, and the key was the wrong one anyway: `apply` adds
+  components without touching a manifest, so a manifest-keyed cache never
+  invalidates on the change that matters. What the engine does is simpler and
+  stricter — `audit.ts` returns SUCCESS unconditionally once `audit_path` is
+  `high_confidence` or `ambiguous`, so the inventory is computed **once per
+  state-file** and never refreshed.
+- **What that means in practice.** A single request is one pass, so the
+  inventory is fresh where it matters. The bounded gap is a run that reuses one
+  state-file across several component additions: components written earlier in
+  that run are absent from the inventory the later ones are checked against.
+  Adding a second component in the same run → re-read the component directories
+  directly rather than trusting `state.ui_audit.components_found`.
 
 ## Anti-slop cross-reference
 

package/dist/agent-src/skills/fe-design/SKILL.md

@@ -63,6 +63,16 @@ where the corpus reports an evidence gap or the audit already pins a
 project pattern. Stack-specific choices come from the dispatched
 implementation skill, not from here.
 
+> **When the corpus is not installed.** `design-intelligence` ships in the
+> `frontend-design` pack; this skill ships in `engineering-base`. A consumer
+> who installed only `laravel` or only `react` therefore has this skill and
+> **not** the corpus. Fall back to the heuristics here and say so in the
+> result — "selected from heuristics; `frontend-design` not installed, so no
+> corpus grounding". The evidence-gap fallback above is about a corpus that
+> answered "nothing here"; this is about a corpus that is absent. Never
+> present an ungrounded pick as grounded, and never record a missing pack as
+> an evidence gap.
+
 ## Component Architecture
 
 ### Page structure (universal shape)

package/dist/agent-src/templates/agents/agent-project-settings.example.yml

@@ -39,7 +39,7 @@ schema_version: 1
 # CI guard: a release bump of `package.json` must update this value
 # in lockstep — see scripts/check_template_pin_drift.ts (road-to-
 # portable-runtime-and-update-check P3.3).
-agent_config_version: "9.10.0"
+agent_config_version: "9.11.0"
 
 # --- Project identity ---
 project:

package/dist/agent-src/templates/scripts/work_engine/directives/ui/apply.ts

@@ -17,14 +17,25 @@ import {
     StepResult,
     agent_directive,
 } from '../../delivery_state.js';
-import { PLACEHOLDER_PATTERNS } from './design.js';
+import { placeholder_paths } from './design.js';
+import {
+    UNSUPPORTED_LANE,
+    bundle_line,
+    unsupported_stack_questions,
+} from './stack_bundles.js';
 
 /** Map `state.stack.frontend` → agent-directive skill name. */
 export const STACK_DIRECTIVES: Record<string, string> = {
     'blade-livewire-flux': 'ui-apply-blade-livewire-flux',
+    'blade-livewire': 'ui-apply-blade-livewire',
+    filament: 'ui-apply-filament',
     'react-shadcn': 'ui-apply-react-shadcn',
+    react: 'ui-apply-react',
     vue: 'ui-apply-vue',
     plain: 'ui-apply-plain',
+    // Present so the `keys == KNOWN_STACKS` invariant holds. Never emitted —
+    // the step intercepts this lane and refuses instead of dispatching.
+    unknown: 'ui-apply-unsupported',
 };
 
 /** Fallback directive when `state.stack` is missing or malformed. */
@@ -104,47 +115,36 @@ function _resolve_directive(state: DeliveryState): string {
     return DEFAULT_DIRECTIVE;
 }
 
-/** Return paths into `envelope['rendered']` whose text matches a pattern. */
+/**
+ * Return paths into `envelope['rendered']` whose text matches a pattern.
+ *
+ * Delegates to the walker shared with `design`, so the producer-side and
+ * consumer-side gates cannot drift apart. They previously held
+ * byte-identical copies of the same array-blind recursion, which meant the
+ * contract's "defense-in-depth" framing described two layers that failed on
+ * exactly the same inputs.
+ */
 function _placeholder_violations_in_output(envelope: Record<string, Any>): string[] {
-    const rendered = envelope['rendered'];
-    if (!_isDict(rendered)) {
-        return [];
-    }
-    const violations: string[] = [];
-    _walk_rendered(rendered, '', violations);
-    return violations;
-}
-
-function _walk_rendered(node: Record<string, Any>, prefix: string, violations: string[]): void {
-    for (const key of Object.keys(node)) {
-        const value = node[key];
-        const path = prefix ? `${prefix}.${key}` : String(key);
-        if (_isDict(value)) {
-            _walk_rendered(value, path, violations);
-            continue;
-        }
-        if (typeof value !== 'string') {
-            continue;
-        }
-        const lowered = value.toLowerCase();
-        for (const pattern of PLACEHOLDER_PATTERNS) {
-            if (lowered.includes(pattern)) {
-                violations.push(path);
-                break;
-            }
-        }
-    }
+    return placeholder_paths(envelope['rendered']);
 }
 
 /** First-pass halt — emit the stack-specific apply directive. */
 function _delegate_to_stack_skill(state: DeliveryState): StepResult {
     const directive = _resolve_directive(state);
     const stack_label = _stack_label(state);
+    if (stack_label === UNSUPPORTED_LANE) {
+        return new StepResult({
+            outcome: Outcome.BLOCKED,
+            questions: unsupported_stack_questions('apply'),
+            message: 'UI apply refused: frontend framework not modelled by any lane.',
+        });
+    }
     return new StepResult({
         outcome: Outcome.BLOCKED,
         questions: [
             agent_directive(directive),
             `> Stack: \`${stack_label}\`. Implementing the locked design brief.`,
+            bundle_line(stack_label, 'build'),
             '> Microcopy is locked — every button label, empty-state ' +
                 'message, and validation message must come verbatim from ' +
                 '`state.ui_design.microcopy`.',

package/dist/agent-src/templates/scripts/work_engine/directives/ui/design.ts

@@ -146,7 +146,17 @@ function _missing_required_keys(design: Record<string, Any>): string[] {
             missing.push(key);
             continue;
         }
-        if (key === 'states' && _isDict(value)) {
+        if (key === 'states') {
+            // A non-object `states` (a string, a list) used to skip the
+            // per-state loop entirely, so `states: "n/a"` satisfied the gate
+            // without covering a single state. Report every required key
+            // instead — the author gets the same actionable list either way.
+            if (!_isDict(value)) {
+                for (const state_key of REQUIRED_STATE_KEYS) {
+                    missing.push(`states.${state_key}`);
+                }
+                continue;
+            }
             for (const state_key of REQUIRED_STATE_KEYS) {
                 if (!_pyTruthy(value[state_key])) {
                     missing.push(`states.${state_key}`);
@@ -157,37 +167,74 @@ function _missing_required_keys(design: Record<string, Any>): string[] {
     return missing;
 }
 
-/** Return microcopy paths whose values match a placeholder pattern. */
+/**
+ * Return brief paths whose values match a placeholder pattern.
+ *
+ * Covers `microcopy` **and** `states`. The five required states were checked
+ * for truthiness only, so `states.error: "TBD"` satisfied the gate — the brief
+ * looked complete while covering nothing. Both slots carry strings the user
+ * signs off on, so both are held to the same bar.
+ *
+ * An explicit `"n/a"` stays legitimate: a static landing page genuinely has no
+ * error or disabled state, and *declaring* that is the opposite of inventing
+ * filler. That is why the gate demands all five keys rather than branching on
+ * page type — the author states the answer instead of the engine guessing which
+ * states a surface ought to have.
+ */
 function _placeholder_violations(design: Record<string, Any>): string[] {
-    const microcopy = design['microcopy'];
-    if (!_isDict(microcopy)) return [];
+    return [
+        ...placeholder_paths(design['microcopy'], 'microcopy'),
+        ...placeholder_paths(design['states'], 'states'),
+    ];
+}
+
+/**
+ * Return every path under `node` whose leaf string carries a placeholder.
+ *
+ * Traverses objects **and arrays**. The array arm is load-bearing, not
+ * defensive: a list is the natural shape for the most common microcopy
+ * (`nav_items`, `menu`, `steps`) and for a rendered file split into lines,
+ * and a walker that recursed into objects only let
+ * `{ nav_items: ["Home", "TODO: Link"] }` through both the brief lock and
+ * the rendered-output gate.
+ *
+ * Array elements are addressed `key[i]` so the halt names the exact element
+ * the author has to fix, not just the list.
+ *
+ * Shared by `design` (producer side, on `microcopy`) and `apply` (consumer
+ * side, on the rendered envelope). One implementation on purpose: the two
+ * call sites previously carried byte-identical copies of the same bug, so
+ * duplicating them bought no independence — see
+ * `docs/contracts/ui-track-flow.md` § implement → apply.
+ */
+export function placeholder_paths(node: Any, prefix = ''): string[] {
     const violations: string[] = [];
-    _walk_microcopy(microcopy, '', violations);
+    _walk_placeholders(node, prefix, violations);
     return violations;
 }
 
-function _walk_microcopy(
-    node: Record<string, Any>,
-    prefix: string,
-    violations: string[],
-): void {
-    for (const key of Object.keys(node)) {
-        const value = node[key];
-        const path = prefix ? `${prefix}.${key}` : String(key);
-        if (_isDict(value)) {
-            _walk_microcopy(value, path, violations);
-            continue;
-        }
-        if (typeof value !== 'string') {
-            continue;
-        }
-        const lowered = value.toLowerCase();
+function _walk_placeholders(node: Any, prefix: string, violations: string[]): void {
+    if (typeof node === 'string') {
+        const lowered = node.toLowerCase();
         for (const pattern of PLACEHOLDER_PATTERNS) {
             if (lowered.includes(pattern)) {
-                violations.push(path);
-                break;
+                violations.push(prefix);
+                return;
             }
         }
+        return;
+    }
+    if (Array.isArray(node)) {
+        node.forEach((value, index) => {
+            _walk_placeholders(value, `${prefix}[${index}]`, violations);
+        });
+        return;
+    }
+    if (_isDict(node)) {
+        for (const key of Object.keys(node)) {
+            const path = prefix ? `${prefix}.${key}` : String(key);
+            _walk_placeholders(node[key], path, violations);
+        }
     }
 }
 
@@ -311,15 +358,23 @@ function _halt_unconfirmed(state: DeliveryState, design: Record<string, Any>): S
     });
 }
 
-/** Count leaf string entries in `microcopy` (recursive). */
-function _count_microcopy(microcopy: Record<string, Any>): number {
-    let total = 0;
-    for (const value of Object.values(microcopy)) {
-        if (_isDict(value)) {
-            total += _count_microcopy(value);
-        } else if (typeof value === 'string') {
-            total += 1;
-        }
+/**
+ * Count leaf string entries in `microcopy` (recursive, arrays included).
+ *
+ * The count is shown in the sign-off the user confirms, so it has to agree
+ * with what the placeholder walker inspects — an object-only count reported
+ * fewer locked strings than were actually locked.
+ */
+function _count_microcopy(microcopy: Any): number {
+    if (typeof microcopy === 'string') return 1;
+    if (Array.isArray(microcopy)) {
+        return microcopy.reduce((total: number, value) => total + _count_microcopy(value), 0);
+    }
+    if (_isDict(microcopy)) {
+        return Object.values(microcopy).reduce(
+            (total: number, value) => total + _count_microcopy(value),
+            0,
+        );
     }
-    return total;
+    return 0;
 }

package/dist/agent-src/templates/scripts/work_engine/directives/ui/polish.ts

@@ -15,6 +15,11 @@ import {
     StepResult,
     agent_directive,
 } from '../../delivery_state.js';
+import {
+    UNSUPPORTED_LANE,
+    bundle_line,
+    unsupported_stack_questions,
+} from './stack_bundles.js';
 
 /** Maximum number of polish rounds per `/work` run. */
 export const POLISH_CEILING = 2;
@@ -31,9 +36,15 @@ export const TOKEN_REPEAT_THRESHOLD = 2;
 /** Map `state.stack.frontend` → agent-directive skill name. */
 export const STACK_DIRECTIVES: Record<string, string> = {
     'blade-livewire-flux': 'ui-polish-blade-livewire-flux',
+    'blade-livewire': 'ui-polish-blade-livewire',
+    filament: 'ui-polish-filament',
     'react-shadcn': 'ui-polish-react-shadcn',
+    react: 'ui-polish-react',
     vue: 'ui-polish-vue',
     plain: 'ui-polish-plain',
+    // Present so the `keys == KNOWN_STACKS` invariant holds. Never emitted —
+    // the step intercepts this lane and refuses instead of dispatching.
+    unknown: 'ui-polish-unsupported',
 };
 
 /** Fallback directive when `state.stack` is missing or malformed. */
@@ -184,6 +195,14 @@ function _delegate_to_polish_skill(
     ceiling: number,
 ): StepResult {
     const directive = _resolve_directive(state);
+    const unsupported_label = _stack_label(state);
+    if (unsupported_label === UNSUPPORTED_LANE) {
+        return new StepResult({
+            outcome: Outcome.BLOCKED,
+            questions: unsupported_stack_questions('polish'),
+            message: 'UI polish refused: frontend framework not modelled by any lane.',
+        });
+    }
     const stack_label = _stack_label(state);
     const next_round = rounds + 1;
     let findings_line =
@@ -203,6 +222,7 @@ function _delegate_to_polish_skill(
         questions: [
             agent_directive(directive),
             `> Stack: \`${stack_label}\`. Polish round ${next_round} of ${ceiling}.`,
+            bundle_line(stack_label, 'build'),
             findings_line,
             '> Fix chart-type / contrast findings against the adopted ' +
                 "corpus rows (design-intelligence § 'Grounding the " +

package/dist/agent-src/templates/scripts/work_engine/directives/ui/review.ts

@@ -16,13 +16,24 @@ import {
     StepResult,
     agent_directive,
 } from '../../delivery_state.js';
+import {
+    UNSUPPORTED_LANE,
+    bundle_line,
+    unsupported_stack_questions,
+} from './stack_bundles.js';
 
-/** Map `state.stack.frontend` → agent-directive skill name. */
+/** Map `state.stack.frontend` → agent-directive verb. */
 export const STACK_DIRECTIVES: Record<string, string> = {
     'blade-livewire-flux': 'ui-design-review-blade-livewire-flux',
+    'blade-livewire': 'ui-design-review-blade-livewire',
+    filament: 'ui-design-review-filament',
     'react-shadcn': 'ui-design-review-react-shadcn',
+    react: 'ui-design-review-react',
     vue: 'ui-design-review-vue',
     plain: 'ui-design-review-plain',
+    // Present so the `keys == KNOWN_STACKS` invariant holds. Never emitted —
+    // the step intercepts this lane and refuses instead of dispatching.
+    unknown: 'ui-design-review-unsupported',
 };
 
 /** Fallback directive when `state.stack` is missing or malformed. */
@@ -181,12 +192,20 @@ function _stack_label(state: DeliveryState): string {
 function _delegate_to_review_skill(state: DeliveryState): StepResult {
     const directive = _resolve_directive(state);
     const stack_label = _stack_label(state);
+    if (stack_label === UNSUPPORTED_LANE) {
+        return new StepResult({
+            outcome: Outcome.BLOCKED,
+            questions: unsupported_stack_questions('review'),
+            message: 'UI review refused: frontend framework not modelled by any lane.',
+        });
+    }
     return new StepResult({
         outcome: Outcome.BLOCKED,
         questions: [
             agent_directive(directive),
             `> Stack: \`${stack_label}\`. Reviewing rendered components ` +
                 'against the locked design brief.',
+            bundle_line(stack_label, 'review'),
             '> The review pass compares `state.ticket.ui_apply.rendered` ' +
                 'against `state.ui_design` (microcopy, states, a11y, layout) ' +
                 'and produces a structured `findings` list.',