@event4u/agent-config 2.23.0 → 2.24.0

package/docs/contracts/command-clusters.md

@@ -49,6 +49,7 @@ column 1 of this table.
 | `sync-gitignore` | — | `fix` | new sub-command 2026-05-11 — cluster head retains the existing append-only sync as its default flow; `:fix` adds `--cleanup-legacy` semantics, scrubbing pre-`/agents/` runtime patterns wherever they appear in the consumer's `.gitignore` (inside or outside the managed block) and re-syncing the canonical entries. |
 | `ghostwriter` | — | `fetch` · `write` · `list` · `show` · `delete` | new cluster 2026-05-15 — third voice primitive for AI-assisted writing in the public voice of a public figure. Hybrid storage: real-person profiles live consumer-side under `agents/ghostwriter/<slug>.md` (gitignored by default); package source ships only `fictional: true` fixtures. Zero network code in the package — `:fetch` delegates web-fetch / web-search to the host agent. Mandatory disclosure footer on every `:write` output (no opt-out). Schema: [`ghostwriter-schema`](ghostwriter-schema.md). |
 | `post-as` | — | `me` · `ghostwriter` | new cluster 2026-05-15 — consumer-facing write entry points. `:me` reads `.agent-user.md.voice_sample` and drafts in the maintainer's own voice (no disclosure footer — the user is the author); `:ghostwriter` is a thin alias for `/ghostwriter:write` with the mandatory disclosure footer. Both share the procedural [`write-engine`](write-engine.md) contract — style source and footer are the only axes of variation. |
+| `video` | — | `from-script` · `scene` · `storyboard` · `stitch` | new cluster 2026-05-17 — AI video generation pipeline. Cluster head orchestrates the full flow; `:scene` runs a single scene end-to-end (script → blueprint → still → motion → clip); `:storyboard` expands a script into per-scene blueprints + reference stills with character-lock JSON; `:from-script` walks a multi-scene script through storyboard + per-scene generation; `:stitch` concatenates scene clips with `ffmpeg` against a scene manifest. Provider-agnostic via the adapter contract under `scripts/ai-video/lib/adapter-contract.md`; cost-gated with mandatory `AIV_DRYRUN=true` default and explicit confirmation before live provider calls. |
 
 **Net change:** Phase 1 collapsed 15 atomics → 3 clusters; Phase 2
 collapses 26 atomics → 11 sub-command clusters. Sub-commands use

package/docs/contracts/compression-default-kill-criterion.md

@@ -7,7 +7,7 @@ keep-beta-until: 2026-08-14
 
 > **Status:** v1-measured · criterion not met · default stays `off` · **Owner:** `step-16-caveman-substance.md`
 > Phase 1 closeout · **Sources:** [`bench/reports/caveman-v1.md`](../../bench/reports/caveman-v1.md) ·
-> [`council-synthesis.md` § 7](../../agents/audit-2026-05-14-north-star/council-synthesis.md) ·
+> [`council-synthesis.md` § 7](../../agents/council-sessions/audit-2026-05-14-north-star/council-synthesis.md) <!-- council-ref-allowed: ADR decision trace for v1 kill-criterion verdict --> ·
 > [`caveman-v1-kc-verdict.json`](../../agents/council-responses/caveman-v1-kc-verdict.json) <!-- council-ref-allowed: ADR decision trace for v1 kill-criterion verdict -->
 
 ## Rule

package/docs/contracts/file-ownership-matrix.json

@@ -741,6 +741,36 @@
       "load_context": [],
       "load_context_eager": []
     },
+    ".agent-src.uncompressed/commands/video.md": {
+      "kind": "command",
+      "rule_type": "orchestrator",
+      "load_context": [],
+      "load_context_eager": []
+    },
+    ".agent-src.uncompressed/commands/video/from-script.md": {
+      "kind": "command",
+      "rule_type": null,
+      "load_context": [],
+      "load_context_eager": []
+    },
+    ".agent-src.uncompressed/commands/video/scene.md": {
+      "kind": "command",
+      "rule_type": null,
+      "load_context": [],
+      "load_context_eager": []
+    },
+    ".agent-src.uncompressed/commands/video/stitch.md": {
+      "kind": "command",
+      "rule_type": null,
+      "load_context": [],
+      "load_context_eager": []
+    },
+    ".agent-src.uncompressed/commands/video/storyboard.md": {
+      "kind": "command",
+      "rule_type": null,
+      "load_context": [],
+      "load_context_eager": []
+    },
     ".agent-src.uncompressed/commands/work.md": {
       "kind": "command",
       "rule_type": null,
@@ -981,6 +1011,12 @@
       "load_context": [],
       "load_context_eager": []
     },
+    ".agent-src.uncompressed/personas/ai-video-technical-director.md": {
+      "kind": "persona",
+      "rule_type": null,
+      "load_context": [],
+      "load_context_eager": []
+    },
     ".agent-src.uncompressed/personas/backend-architect.md": {
       "kind": "persona",
       "rule_type": null,
@@ -1047,12 +1083,24 @@
       "load_context": [],
       "load_context_eager": []
     },
+    ".agent-src.uncompressed/personas/hollywood-director.md": {
+      "kind": "persona",
+      "rule_type": null,
+      "load_context": [],
+      "load_context_eager": []
+    },
     ".agent-src.uncompressed/personas/people-strategist.md": {
       "kind": "persona",
       "rule_type": null,
       "load_context": [],
       "load_context_eager": []
     },
+    ".agent-src.uncompressed/personas/pixar-storyboard-artist.md": {
+      "kind": "persona",
+      "rule_type": null,
+      "load_context": [],
+      "load_context_eager": []
+    },
     ".agent-src.uncompressed/personas/product-owner.md": {
       "kind": "persona",
       "rule_type": null,
@@ -1740,6 +1788,12 @@
       "load_context": [],
       "load_context_eager": []
     },
+    ".agent-src.uncompressed/skills/character-consistency/SKILL.md": {
+      "kind": "skill",
+      "rule_type": null,
+      "load_context": [],
+      "load_context_eager": []
+    },
     ".agent-src.uncompressed/skills/check-refs/SKILL.md": {
       "kind": "skill",
       "rule_type": null,
@@ -2304,6 +2358,12 @@
       "load_context": [],
       "load_context_eager": []
     },
+    ".agent-src.uncompressed/skills/motion-choreographer/SKILL.md": {
+      "kind": "skill",
+      "rule_type": null,
+      "load_context": [],
+      "load_context_eager": []
+    },
     ".agent-src.uncompressed/skills/multi-tenancy/SKILL.md": {
       "kind": "skill",
       "rule_type": null,
@@ -2412,6 +2472,12 @@
       "load_context": [],
       "load_context_eager": []
     },
+    ".agent-src.uncompressed/skills/pixar-storyteller/SKILL.md": {
+      "kind": "skill",
+      "rule_type": null,
+      "load_context": [],
+      "load_context_eager": []
+    },
     ".agent-src.uncompressed/skills/playwright-architect/SKILL.md": {
       "kind": "skill",
       "rule_type": null,
@@ -2646,6 +2712,12 @@
       "load_context": [],
       "load_context_eager": []
     },
+    ".agent-src.uncompressed/skills/scene-expander/SKILL.md": {
+      "kind": "skill",
+      "rule_type": null,
+      "load_context": [],
+      "load_context_eager": []
+    },
     ".agent-src.uncompressed/skills/script-writing/SKILL.md": {
       "kind": "skill",
       "rule_type": null,
@@ -2904,6 +2976,12 @@
       "load_context": [],
       "load_context_eager": []
     },
+    ".agent-src.uncompressed/skills/video-director/SKILL.md": {
+      "kind": "skill",
+      "rule_type": null,
+      "load_context": [],
+      "load_context_eager": []
+    },
     ".agent-src.uncompressed/skills/vision-articulation/SKILL.md": {
       "kind": "skill",
       "rule_type": null,
@@ -5177,6 +5255,132 @@
       "via": "self",
       "depth": 0
     },
+    {
+      "source": ".agent-src.uncompressed/commands/video.md",
+      "target": ".agent-src.uncompressed/commands/video.md",
+      "type": "WRITE",
+      "via": "self",
+      "depth": 0
+    },
+    {
+      "source": ".agent-src.uncompressed/commands/video.md",
+      "target": ".agent-src.uncompressed/rules/non-destructive-by-default.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
+    {
+      "source": ".agent-src.uncompressed/commands/video/from-script.md",
+      "target": ".agent-src.uncompressed/commands/video/from-script.md",
+      "type": "WRITE",
+      "via": "self",
+      "depth": 0
+    },
+    {
+      "source": ".agent-src.uncompressed/commands/video/from-script.md",
+      "target": ".agent-src.uncompressed/commands/video/scene.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
+    {
+      "source": ".agent-src.uncompressed/commands/video/from-script.md",
+      "target": ".agent-src.uncompressed/commands/video/stitch.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
+    {
+      "source": ".agent-src.uncompressed/commands/video/from-script.md",
+      "target": ".agent-src.uncompressed/commands/video/storyboard.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
+    {
+      "source": ".agent-src.uncompressed/commands/video/from-script.md",
+      "target": ".agent-src.uncompressed/rules/non-destructive-by-default.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
+    {
+      "source": ".agent-src.uncompressed/commands/video/scene.md",
+      "target": ".agent-src.uncompressed/commands/video/from-script.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
+    {
+      "source": ".agent-src.uncompressed/commands/video/scene.md",
+      "target": ".agent-src.uncompressed/commands/video/scene.md",
+      "type": "WRITE",
+      "via": "self",
+      "depth": 0
+    },
+    {
+      "source": ".agent-src.uncompressed/commands/video/scene.md",
+      "target": ".agent-src.uncompressed/commands/video/stitch.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
+    {
+      "source": ".agent-src.uncompressed/commands/video/scene.md",
+      "target": ".agent-src.uncompressed/commands/video/storyboard.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
+    {
+      "source": ".agent-src.uncompressed/commands/video/stitch.md",
+      "target": ".agent-src.uncompressed/commands/video/from-script.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
+    {
+      "source": ".agent-src.uncompressed/commands/video/stitch.md",
+      "target": ".agent-src.uncompressed/commands/video/scene.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
+    {
+      "source": ".agent-src.uncompressed/commands/video/stitch.md",
+      "target": ".agent-src.uncompressed/commands/video/stitch.md",
+      "type": "WRITE",
+      "via": "self",
+      "depth": 0
+    },
+    {
+      "source": ".agent-src.uncompressed/commands/video/storyboard.md",
+      "target": ".agent-src.uncompressed/commands/video/from-script.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
+    {
+      "source": ".agent-src.uncompressed/commands/video/storyboard.md",
+      "target": ".agent-src.uncompressed/commands/video/scene.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
+    {
+      "source": ".agent-src.uncompressed/commands/video/storyboard.md",
+      "target": ".agent-src.uncompressed/commands/video/stitch.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
+    {
+      "source": ".agent-src.uncompressed/commands/video/storyboard.md",
+      "target": ".agent-src.uncompressed/commands/video/storyboard.md",
+      "type": "WRITE",
+      "via": "self",
+      "depth": 0
+    },
     {
       "source": ".agent-src.uncompressed/commands/work.md",
       "target": ".agent-src.uncompressed/commands/commit.md",
@@ -5961,6 +6165,13 @@
       "via": "self",
       "depth": 0
     },
+    {
+      "source": ".agent-src.uncompressed/personas/ai-video-technical-director.md",
+      "target": ".agent-src.uncompressed/personas/ai-video-technical-director.md",
+      "type": "WRITE",
+      "via": "self",
+      "depth": 0
+    },
     {
       "source": ".agent-src.uncompressed/personas/backend-architect.md",
       "target": ".agent-src.uncompressed/personas/backend-architect.md",
@@ -6038,6 +6249,13 @@
       "via": "self",
       "depth": 0
     },
+    {
+      "source": ".agent-src.uncompressed/personas/hollywood-director.md",
+      "target": ".agent-src.uncompressed/personas/hollywood-director.md",
+      "type": "WRITE",
+      "via": "self",
+      "depth": 0
+    },
     {
       "source": ".agent-src.uncompressed/personas/people-strategist.md",
       "target": ".agent-src.uncompressed/personas/people-strategist.md",
@@ -6045,6 +6263,13 @@
       "via": "self",
       "depth": 0
     },
+    {
+      "source": ".agent-src.uncompressed/personas/pixar-storyboard-artist.md",
+      "target": ".agent-src.uncompressed/personas/pixar-storyboard-artist.md",
+      "type": "WRITE",
+      "via": "self",
+      "depth": 0
+    },
     {
       "source": ".agent-src.uncompressed/personas/product-owner.md",
       "target": ".agent-src.uncompressed/personas/product-owner.md",
@@ -7858,6 +8083,34 @@
       "via": "self",
       "depth": 0
     },
+    {
+      "source": ".agent-src.uncompressed/skills/character-consistency/SKILL.md",
+      "target": ".agent-src.uncompressed/skills/character-consistency/SKILL.md",
+      "type": "WRITE",
+      "via": "self",
+      "depth": 0
+    },
+    {
+      "source": ".agent-src.uncompressed/skills/character-consistency/SKILL.md",
+      "target": ".agent-src.uncompressed/skills/motion-choreographer/SKILL.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
+    {
+      "source": ".agent-src.uncompressed/skills/character-consistency/SKILL.md",
+      "target": ".agent-src.uncompressed/skills/pixar-storyteller/SKILL.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
+    {
+      "source": ".agent-src.uncompressed/skills/character-consistency/SKILL.md",
+      "target": ".agent-src.uncompressed/skills/video-director/SKILL.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
     {
       "source": ".agent-src.uncompressed/skills/check-refs/SKILL.md",
       "target": ".agent-src.uncompressed/skills/check-refs/SKILL.md",
@@ -9790,6 +10043,20 @@
       "via": "self",
       "depth": 0
     },
+    {
+      "source": ".agent-src.uncompressed/skills/motion-choreographer/SKILL.md",
+      "target": ".agent-src.uncompressed/skills/motion-choreographer/SKILL.md",
+      "type": "WRITE",
+      "via": "self",
+      "depth": 0
+    },
+    {
+      "source": ".agent-src.uncompressed/skills/motion-choreographer/SKILL.md",
+      "target": ".agent-src.uncompressed/skills/scene-expander/SKILL.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
     {
       "source": ".agent-src.uncompressed/skills/multi-tenancy/SKILL.md",
       "target": ".agent-src.uncompressed/skills/multi-tenancy/SKILL.md",
@@ -10133,6 +10400,34 @@
       "via": "self",
       "depth": 0
     },
+    {
+      "source": ".agent-src.uncompressed/skills/pixar-storyteller/SKILL.md",
+      "target": ".agent-src.uncompressed/skills/character-consistency/SKILL.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
+    {
+      "source": ".agent-src.uncompressed/skills/pixar-storyteller/SKILL.md",
+      "target": ".agent-src.uncompressed/skills/motion-choreographer/SKILL.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
+    {
+      "source": ".agent-src.uncompressed/skills/pixar-storyteller/SKILL.md",
+      "target": ".agent-src.uncompressed/skills/pixar-storyteller/SKILL.md",
+      "type": "WRITE",
+      "via": "self",
+      "depth": 0
+    },
+    {
+      "source": ".agent-src.uncompressed/skills/pixar-storyteller/SKILL.md",
+      "target": ".agent-src.uncompressed/skills/video-director/SKILL.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
     {
       "source": ".agent-src.uncompressed/skills/playwright-architect/SKILL.md",
       "target": ".agent-src.uncompressed/skills/mobile-e2e-strategy/SKILL.md",
@@ -11036,6 +11331,20 @@
       "via": "body_link",
       "depth": 1
     },
+    {
+      "source": ".agent-src.uncompressed/skills/scene-expander/SKILL.md",
+      "target": ".agent-src.uncompressed/skills/motion-choreographer/SKILL.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
+    {
+      "source": ".agent-src.uncompressed/skills/scene-expander/SKILL.md",
+      "target": ".agent-src.uncompressed/skills/scene-expander/SKILL.md",
+      "type": "WRITE",
+      "via": "self",
+      "depth": 0
+    },
     {
       "source": ".agent-src.uncompressed/skills/script-writing/SKILL.md",
       "target": ".agent-src.uncompressed/contexts/contracts/frugality-charter.md",
@@ -12037,6 +12346,34 @@
       "via": "self",
       "depth": 0
     },
+    {
+      "source": ".agent-src.uncompressed/skills/video-director/SKILL.md",
+      "target": ".agent-src.uncompressed/skills/character-consistency/SKILL.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
+    {
+      "source": ".agent-src.uncompressed/skills/video-director/SKILL.md",
+      "target": ".agent-src.uncompressed/skills/motion-choreographer/SKILL.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
+    {
+      "source": ".agent-src.uncompressed/skills/video-director/SKILL.md",
+      "target": ".agent-src.uncompressed/skills/pixar-storyteller/SKILL.md",
+      "type": "READ_ONLY",
+      "via": "body_link",
+      "depth": 1
+    },
+    {
+      "source": ".agent-src.uncompressed/skills/video-director/SKILL.md",
+      "target": ".agent-src.uncompressed/skills/video-director/SKILL.md",
+      "type": "WRITE",
+      "via": "self",
+      "depth": 0
+    },
     {
       "source": ".agent-src.uncompressed/skills/vision-articulation/SKILL.md",
       "target": ".agent-src.uncompressed/skills/competitive-moat-analysis/SKILL.md",

package/docs/getting-started.md

@@ -146,7 +146,7 @@ Your agent now understands slash commands:
 | `/quality-fix` | Run and fix all quality checks |
 | `/chat-history` | Inspect the persistent chat-history log (read-only `show`) |
 
-→ [Browse all 124 active commands](../.agent-src/commands/)
+→ [Browse all 129 active commands](../.agent-src/commands/)
 
 ---
 

package/docs/parity/ruflo.md

@@ -2,7 +2,7 @@
 
 > Per-row verdict against the eight Ruflo measurement-governance patterns
 > catalogued in
-> [`external-findings.md § 2`](../../agents/audit-2026-05-14-north-star/external-findings.md).
+> [`external-findings.md § 2`](../../agents/council-sessions/audit-2026-05-14-north-star/external-findings.md).
 > Owner roadmap: [`step-11-ruflo-parity.md`](../../agents/roadmaps/step-11-ruflo-parity.md)
 > (Phase 6 Step 1). Cross-index lives at
 > [`step-99-north-star-restructure.md`](../../agents/roadmaps/step-99-north-star-restructure.md)
@@ -10,7 +10,7 @@
 >
 > **Verdict legend:** `[x] covered by <file:line>` · `[~] superseded by <approach>` · `[!] gap`.
 > **Acceptance:** zero `[!]` rows. Closure flips the corresponding cell in the
-> [composite scorecard](../../agents/audit-2026-05-14-north-star/external-findings.md#5-composite-scorecard--agent-config-vs-the-field)
+> [composite scorecard](../../agents/council-sessions/audit-2026-05-14-north-star/external-findings.md#5-composite-scorecard--agent-config-vs-the-field)
 > `vs Ruflo` column from `–` to `=` or `+`.
 
 **Measured-vs-claimed disclaimer:** Each row cites the **mechanism** that
@@ -41,6 +41,6 @@ mechanisms remain claimed until [`bench.json`](bench.json) soak completes
 
 ## Cross-references
 
-- Composite scorecard refresh: owned by [`step-99-north-star-restructure.md`](../../agents/roadmaps/step-99-north-star-restructure.md) Phase 5 Step 4 (replaces [`external-findings.md § 5`](../../agents/audit-2026-05-14-north-star/external-findings.md)).
+- Composite scorecard refresh: owned by [`step-99-north-star-restructure.md`](../../agents/roadmaps/step-99-north-star-restructure.md) Phase 5 Step 4 (replaces [`external-findings.md § 5`](../../agents/council-sessions/audit-2026-05-14-north-star/external-findings.md)).
 - Bench-ruflo redundancy verdict: [`bench-ruflo.json`](bench-ruflo.json) (step-11 Phase 6 Step 2).
 - G5 redundancy gate cite: step-99 Acceptance Criteria row "G5 — external redundancy (Domination Mandate)".

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@event4u/agent-config",
-    "version": "2.23.0",
+    "version": "2.24.0",
     "description": "Shared agent configuration \u2014 skills, rules, commands, guidelines, and templates for AI coding tools",
     "license": "MIT",
     "private": false,

package/scripts/ai-video/adapters/gemini-veo.sh

@@ -0,0 +1,57 @@
+#!/usr/bin/env bash
+# gemini-veo.sh — Google Gemini Veo video generation adapter.
+#
+# Capability: audio=native. Veo accepts dialogue + ambient sound blocks
+# and returns a muxed MP4. Async API: submit → poll (predictLongRunning)
+# → fetch. The orchestrator drives all three subcommands; this script
+# never auto-retries.
+#
+# Contract: scripts/ai-video/lib/adapter-contract.md
+# Provider: top-level <provider id="gemini-veo" kind="video"> in
+# agents/.ai-video.xml.
+
+set -euo pipefail
+
+# shellcheck source=../lib/adapter-common.sh
+. "$(dirname "$0")/../lib/adapter-common.sh"
+
+ADAPTER_ID="gemini-veo"
+
+# Submit: read contract JSON from stdin, return {job_id, status:"queued"}.
+aiv_cmd_submit() {
+  aiv_assert_dryrun
+  aiv_require_cmd curl jq
+  aiv_load_provider "${ADAPTER_ID}"
+  [ "$(aiv_key_status)" = "present" ] \
+    || aiv_die 6 "${ADAPTER_ID}: api key missing in agents/.ai-video.xml"
+
+  local stdin_json
+  stdin_json="$(cat)"
+  # Validate required prompt blocks early so a bad blueprint fails
+  # before any network call would happen.
+  printf '%s' "${stdin_json}" | jq -e '.prompt.subject and .prompt.action' >/dev/null \
+    || aiv_die 3 "${ADAPTER_ID}: stdin JSON missing required prompt.subject / prompt.action"
+
+  aiv_die 9 "${ADAPTER_ID}: live submit not yet wired (predictLongRunning endpoint requires per-key wiring)"
+}
+
+# Poll: check long-running operation status. Stub returns "done" so the
+# stitcher path is exercisable end-to-end in dry-run; live mode is
+# wired by the orchestrator once a real job_id exists.
+aiv_cmd_poll() {
+  local job_id="${1:-}"
+  [ -n "${job_id}" ] || aiv_die 2 "${ADAPTER_ID}: poll <job_id> required"
+  aiv_assert_dryrun
+  aiv_die 9 "${ADAPTER_ID}: live poll not yet wired (job=${job_id})"
+}
+
+# Fetch: download the muxed MP4. Live mode is stubbed; dry-run returns
+# the fixture path with audio_embedded=true.
+aiv_cmd_fetch() {
+  local job_id="${1:-}"
+  [ -n "${job_id}" ] || aiv_die 2 "${ADAPTER_ID}: fetch <job_id> required"
+  aiv_assert_dryrun
+  aiv_die 9 "${ADAPTER_ID}: live fetch not yet wired (job=${job_id})"
+}
+
+aiv_dispatch "${ADAPTER_ID}" "native" "$@"

package/scripts/ai-video/adapters/higgsfield.sh

@@ -0,0 +1,82 @@
+#!/usr/bin/env bash
+# higgsfield.sh — Higgsfield motion-preset video adapter.
+#
+# Capability: per-model. The provider exposes named motion presets
+# (e.g. Mix, Burst, DVD) each with its own audio behaviour. Capability
+# discovery via `capability --preset <name>` so the orchestrator can
+# pick the right mux path.
+#
+# Contract: scripts/ai-video/lib/adapter-contract.md
+# Provider: top-level <provider id="higgsfield" kind="video"> in
+# agents/.ai-video.xml. Preset → motion-choreographer profile mapping
+# is documented in agents/ai-video/prompts/motion-choreography.md
+# (Phase 6).
+
+set -euo pipefail
+
+# shellcheck source=../lib/adapter-common.sh
+. "$(dirname "$0")/../lib/adapter-common.sh"
+
+ADAPTER_ID="higgsfield"
+
+# Map preset → audio capability. Conservative defaults; tuning table
+# lives alongside the prompt library so creators can extend without
+# touching this adapter.
+higgsfield_audio_for_preset() {
+  case "${1:-}" in
+    mix|burst|dvd) printf 'none' ;;
+    cinematic|talk) printf 'native' ;;
+    *) printf 'none' ;;
+  esac
+}
+
+# Override capability handling so `capability --preset <name>` answers
+# per-preset before falling through to the generic helper.
+aiv_higgsfield_capability() {
+  local preset=""
+  while [ "$#" -gt 0 ]; do
+    case "$1" in
+      --preset) preset="${2:-}"; shift 2 ;;
+      *) shift ;;
+    esac
+  done
+  if [ -n "${preset}" ]; then
+    printf '{"audio":"%s","preset":"%s"}\n' \
+      "$(higgsfield_audio_for_preset "${preset}")" "${preset}"
+    return 0
+  fi
+  printf '{"audio":"per-model","presets":["mix","burst","dvd","cinematic","talk"]}\n'
+}
+
+aiv_cmd_submit() {
+  aiv_assert_dryrun
+  aiv_require_cmd curl jq
+  aiv_load_provider "${ADAPTER_ID}"
+  [ "$(aiv_key_status)" = "present" ] \
+    || aiv_die 6 "${ADAPTER_ID}: api key missing in agents/.ai-video.xml"
+  aiv_die 9 "${ADAPTER_ID}: live submit not yet wired"
+}
+
+aiv_cmd_poll() {
+  local job_id="${1:-}"
+  [ -n "${job_id}" ] || aiv_die 2 "${ADAPTER_ID}: poll <job_id> required"
+  aiv_assert_dryrun
+  aiv_die 9 "${ADAPTER_ID}: live poll not yet wired (job=${job_id})"
+}
+
+aiv_cmd_fetch() {
+  local job_id="${1:-}"
+  [ -n "${job_id}" ] || aiv_die 2 "${ADAPTER_ID}: fetch <job_id> required"
+  aiv_assert_dryrun
+  aiv_die 9 "${ADAPTER_ID}: live fetch not yet wired (job=${job_id})"
+}
+
+# Custom dispatch with capability override; falls back to the common
+# router for every other subcommand.
+sub="${1:-}"
+if [ "${sub}" = "capability" ]; then
+  shift
+  aiv_higgsfield_capability "$@"
+  exit 0
+fi
+aiv_dispatch "${ADAPTER_ID}" "per-model" "$@"