media-asset-pack

1# SPDX-License-Identifier: Apache-2.02# yaml-language-server: $schema=https://nika.sh/spec/v1/workflow.schema.json3#4# TEMPLATE · media-asset-pack · brief → generate assets → manifest.5#6#   [brief]──▶[render]────────────▶[manifest]──▶[persist]7#   infer      nika:image_generate  nika:jq       nika:write8#9# Turning a sentence into shippable art plus the paperwork that makes it10# usable: a model writes the image prompt, the generator renders it, and a11# manifest records WHAT was made from WHICH brief — so the pack can be12# regenerated, audited, or handed to someone else.13#14# Demonstrates ·15#   - `nika:image_generate` with `provider: mock` · byte-real assets, zero key16#   - the directory-AND-children permit · the one shape that passes `check` and17#     survives the run (see `permits.fs.write`)18#   - a JSON artifact built as a VALUE by `nika:jq`, never typed by hand19#20# Needs · nothing. Scaffolds and runs green in an empty directory.21#22# Run · nika run <file> --model mock/echo    # offline rehearsal · assets land in ./out/assets23nika: v124workflow:25  id: media-asset-pack-template # SLOT: kebab-case workflow id26  # SLOT: one honest sentence — `nika new` matches intents against these words27  description: "brief → generate image assets → manifest"28​29# SLOT: provider/model · local · zero key. Measured seat — `ollama/qwen2.5:14b`30# holds the small schema below. `--model mock/echo` needs no seat at all.31model: ollama/qwen2.5:14b32​33const:34  subject: "a calm cosmic landing hero"   # SLOT: what the asset is about35  out_dir: "./out/assets"           # SLOT: where assets land36​37⛨permits:                            # the blast radius · default-deny once present38  ⛨tools: ["nika:image_generate", "nika:jq", "nika:write"]39  ⛨fs:40    ⛨write:41      # Two entries, and both earn their place: `check` judges the `output_dir:`42      # ARGUMENT (`./out/assets`), while the RUN gates every FINAL file path under43      # it — the asset, its provenance manifest, and manifest.json. Grant only the44      # directory and the file sails through check, then dies at run on the first45      # asset. `*` is one segment and never crosses `/`, which is all this needs:46      # image_generate lands its files flat, so no subtree grant is warranted.47      - "./out/assets"              # SLOT: keep in step with const.out_dir48      - "./out/assets/*"            # SLOT: idem · the files that land inside it49​50tasks:51  brief:52    ◇infer:53      max_tokens: 60054      # SLOT: the creative direction · style · constraints. Keep slot markers55      # out of the block below — it is prompt TEXT, not YAML, so a stray56      # comment line is sent to the model verbatim.57      prompt: |58        Write one vivid, concrete image prompt for: ${{ const.subject }}.59        No text in the image · no watermark · a calm central zone.60      schema:61        type: object62        additionalProperties: false63        properties:64          image_prompt: { type: string }65        required: [image_prompt]66​67  render:68    with:69      brief_image_prompt: ${{ tasks.brief.output.image_prompt }}70    ◆invoke:71      tool: "nika:image_generate"72      args:73        provider: mock              # SLOT: local | openai | gemini | xai (local/mock first)74        prompt: "${{ with.brief_image_prompt }}"75        output_dir: "${{ const.out_dir }}"76        filename_prefix: "asset"    # SLOT: filename stem77​78  manifest:79    with:80      brief: ${{ tasks.brief.output }}81      render: ${{ tasks.render.output }}82    ◆invoke:83      tool: "nika:jq"84      args:85        expression: "{ brief: .[0], images: .[1].images }"86        input:87          - "${{ with.brief }}"88          - "${{ with.render }}"89​90  persist:91    with:92      manifest: ${{ tasks.manifest.output }}93    ◆invoke:94      tool: "nika:write"95      args:96        path: "${{ const.out_dir }}/manifest.json"97        create_dirs: true98        # `.json` path → `content:` is ONE interpolation of a value the engine99        # serializes. `nika:jq` above BUILT that value; hand-typing braces100        # around an interpolation emits unquoted fields and breaks the artifact.101        content: "${{ with.manifest }}"102​103outputs:104  manifest: ${{ tasks.manifest.output }}  # SLOT: the callable contract105​