@nodaro/prompts 1.13.0 → 1.15.0

package/src/picker-analyzer-registry.ts

@@ -1,4 +1,5 @@
 import { z } from "zod"
+import { isMinorAge, getAdultOnlyIds } from "./age-floor.js"
 import {
   PEOPLE,
   PERSON_DIMENSION_ORDER,
@@ -104,6 +105,14 @@ const personCleanup: ApplyCleanup = (patch, mode) => {
   } else if ("age" in patch && patch.age !== "age-custom") {
     patch.customAge = undefined
   }
+  // W1-a: an analysis that returned a minor age never carries a flagged id.
+  if (isMinorAge(patch as { age?: string; customAge?: number; type?: string })) {
+    const drop = getAdultOnlyIds()
+    for (const [k, v] of Object.entries(patch)) {
+      if (typeof v === "string" && drop.has(v)) (patch as Record<string, unknown>)[k] = undefined
+      else if (Array.isArray(v)) (patch as Record<string, unknown>)[k] = v.filter((x) => !(typeof x === "string" && drop.has(x)))
+    }
+  }
 }
 
 export const PICKER_ANALYZER_REGISTRY = {
@@ -454,10 +463,46 @@ export interface MultiPickerAnalyzerSpec {
   readonly schema: z.ZodType<Record<string, unknown>, unknown>
   readonly toolName: string
   readonly legend: string
+  /** Compact bullet list of the pickers NOT wired into this spec (PICKER_TYPES
+   *  minus `types`), keyed by picker-type key so the LLM can ATTRIBUTE a gap to
+   *  the right picker even when it was not wired. Names + dimension labels only,
+   *  never catalog ids. Empty string when every picker is already wired. */
+  readonly otherPickersLegend: string
 }
 
 const MULTI_CACHE = new Map<string, MultiPickerAnalyzerSpec>()
 
+/** Title-case a picker-type key for display, e.g. "person" → "Person",
+ *  "exposure-settings" → "Exposure Settings". */
+function pickerDisplayName(type: string): string {
+  return type
+    .split("-")
+    .map((w) => (w.length > 0 ? w[0].toUpperCase() + w.slice(1) : w))
+    .join(" ")
+}
+
+/** One compact bullet per non-wired picker so the LLM can attribute a gap to a
+ *  picker it wasn't handed. Flat pickers show their registry `label` (one axis);
+ *  discriminated pickers show a title-cased name plus their dimension labels.
+ *  Never lists catalog ids. Empty string when every PICKER_TYPES member is
+ *  wired. */
+function buildOtherPickersLegend(sorted: ReadonlyArray<PickerType>): string {
+  const otherTypes = PICKER_TYPES.filter((t) => !sorted.includes(t))
+  if (otherTypes.length === 0) return ""
+  const lines = otherTypes.map((type) => {
+    const descriptor = PICKER_ANALYZER_REGISTRY[type as PickerType] as PickerAnalyzerDescriptor
+    if (descriptor.kind === "flat") {
+      return `- ${type}: ${descriptor.label}`
+    }
+    const dims = descriptor.order
+      .map((k) => descriptor.labels[k])
+      .filter(Boolean)
+      .join(", ")
+    return `- ${type}: ${pickerDisplayName(type)}${dims ? ` — ${dims}` : ""}`
+  })
+  return `Non-wired pickers — use one of these keys in a gap's \`picker\` when an attribute belongs to it:\n${lines.join("\n")}`
+}
+
 /** Build ONE forced-tool schema spanning the given pickers (each section
  *  optional so an omitted picker doesn't trigger a validation retry) plus the
  *  capped `gaps` sidecar. Memoized by the sorted picker-set key. */
@@ -479,6 +524,7 @@ export function buildMultiPickerAnalyzerSpec(types: ReadonlyArray<PickerType>):
     schema: z.object(shape).strict() as unknown as MultiPickerAnalyzerSpec["schema"],
     toolName: "emit_pickers",
     legend: legendParts.join("\n\n"),
+    otherPickersLegend: buildOtherPickersLegend(sorted),
   }
   MULTI_CACHE.set(key, result)
   return result

package/src/picker-catalogs.ts

@@ -87,6 +87,7 @@ import { INSTRUMENTS, PRODUCTION_STYLES, VOCAL_PRESENCE, SINGING_STYLES } from "
 import { VOICE_AGES, VOICE_GENDERS, VOICE_LANGUAGES, VOICE_ACCENTS, VOICE_TIMBRES } from "./voice-character.js"
 import { VOICE_PACES, VOICE_EMOTIONS, VOICE_ARCHETYPES } from "./voice-delivery.js"
 import { composePickerCatalogs, getRegisteredCatalogPacks, catalogPacksVersion } from "./catalog-packs.js"
+import { setComposedCatalogResolver } from "./catalog-overlay.js"
 import { deriveTerm, resolveTerm } from "./term.js"
 
 export interface PickerOption {
@@ -96,6 +97,8 @@ export interface PickerOption {
   /** The group id (matches `categoryOrder` / `categoryLabels`). */
   readonly category?: string
   readonly promptHint: string
+  /** W1-a: see Person.adultOnly. Carried verbatim through packs. */
+  readonly adultOnly?: true
   /**
    * The short professional term this id injects in COMPACT hint mode ("whip
    * pan left" where `promptHint` is the full mechanism sentence). Always
@@ -156,6 +159,8 @@ interface BaseCatalogEntry {
   readonly promptHint: string
   /** Optional authored compact term (see `term.ts` for the convention). */
   readonly term?: string
+  /** W1-a: see Person.adultOnly. Propagated verbatim into the flattened option. */
+  readonly adultOnly?: true
 }
 
 /**
@@ -183,6 +188,7 @@ function toOptions<T extends BaseCatalogEntry>(
     }
     if (e.description) opt.description = e.description
     if (categoryField) opt.category = e[categoryField] as unknown as string
+    if (e.adultOnly) opt.adultOnly = true
     return opt as PickerOption
   })
 }
@@ -836,6 +842,11 @@ export function getPickerCatalog(nodeTypeOrCatalogId: string): PickerCatalog | u
   )
 }
 
+// Install the composed view into the per-catalog getters (catalog-overlay.ts).
+// Done here, at the one module that already imports every catalog, so the
+// catalog modules themselves never import upward.
+setComposedCatalogResolver(getPickerCatalog)
+
 export function listPickerCatalogs(): readonly PickerCatalog[] {
   return getRegisteredPickerCatalogs()
 }

package/src/pose.ts

@@ -21,6 +21,7 @@
  */
 
 import { resolveTerm, type PickerHintMode } from "./term.js"
+import { overlayEntry } from "./catalog-overlay.js"
 
 export type PoseCategory =
   | "standing"
@@ -39,6 +40,16 @@ export interface Pose {
   readonly category: PoseCategory
   readonly description: string
   readonly promptHint: string
+  /**
+   * W1-a minor-age floor (spec 2026-09-01 §3.3). `true` marks an entry whose
+   * hint describes body exposure, sheer/wet clothing, swimwear/lingerie, a
+   * seductive expression or gaze, or a body-placed tattoo. The fragment
+   * collectors DROP flagged entries for a minor subject (`isMinorAge`), the
+   * picker hides their tiles, the analyzer never emits them, and the backend
+   * policy strips their wording from free text. Hand-curated; the
+   * `adult-only-ratchet` test only ratchets. Never set on neutral defaults.
+   */
+  readonly adultOnly?: true
   /**
    * Compact professional term injected instead of `promptHint` in compact hint
    * mode. Authored only where the lowercased label is not what a photographer
@@ -68,8 +79,8 @@ export const POSES: ReadonlyArray<Pose> = [
   { id: "cross-legged",       label: "Cross-legged",       category: "seated",   description: "Seated cross-legged on floor", promptHint: "sitting cross-legged on the ground", term: "sitting cross-legged" },
   { id: "kneeling",           label: "Kneeling",           category: "seated",   description: "Kneeling on the ground",      promptHint: "kneeling on one or both knees" },
   { id: "crouching",          label: "Crouching",          category: "seated",   description: "Crouched low",                promptHint: "crouched low with knees bent" },
-  { id: "lounging",           label: "Lounging",           category: "seated",   description: "Reclined, relaxed sitting",   promptHint: "lounging in a relaxed, reclined position" },
-  { id: "sitting-edge-of-bed", label: "Sitting on Edge of Bed", category: "seated", description: "Perched on the edge of a bed", promptHint: "perched on the edge of a bed, hands resting on the mattress", term: "sitting on the edge of a bed" },
+  { id: "lounging",           label: "Lounging",           category: "seated",   description: "Reclined, relaxed sitting",   promptHint: "lounging in a relaxed, reclined position" , adultOnly: true },
+  { id: "sitting-edge-of-bed", label: "Sitting on Edge of Bed", category: "seated", description: "Perched on the edge of a bed", promptHint: "perched on the edge of a bed, hands resting on the mattress", term: "sitting on the edge of a bed" , adultOnly: true },
   { id: "chair-arm-drape",    label: "Legs Draped Over Chair", category: "seated", description: "Legs draped over chair arm", promptHint: "sitting sideways in a chair with legs draped casually over one arm", term: "legs draped over the chair arm" },
   { id: "elbow-propped",      label: "Cheek on Propped Elbow", category: "seated", description: "Cheek resting on a propped elbow", promptHint: "seated with cheek resting against a propped-up elbow, contemplative", term: "cheek resting on a propped elbow" },
   { id: "lying-on-stomach-reading", label: "Lying Prone Reading", category: "seated", description: "Lying prone, propped on elbows reading", promptHint: "lying on the stomach, propped up on elbows while reading", term: "lying prone propped on elbows, reading" },
@@ -94,14 +105,14 @@ export const POSES: ReadonlyArray<Pose> = [
   { id: "throwing",           label: "Throwing",           category: "action",   description: "Mid-throw motion",            promptHint: "caught mid-throw, body coiled and releasing", term: "caught mid-throw" },
   { id: "leaping",            label: "Leaping",            category: "action",   description: "Leaping forward dynamically", promptHint: "leaping forward dynamically with body extended" },
   { id: "dramatic-action",    label: "Dramatic Action",    category: "action",   description: "Exaggerated action pose",     promptHint: "in a dramatic, exaggerated action pose full of motion", term: "dramatic exaggerated action pose" },
-  { id: "biting-lip",         label: "Biting Lip",         category: "action",   description: "Slight playful lip-bite",     promptHint: "biting the lower lip with a subtle playful expression", term: "biting the lower lip" },
+  { id: "biting-lip",         label: "Biting Lip",         category: "action",   description: "Slight playful lip-bite",     promptHint: "biting the lower lip with a subtle playful expression", term: "biting the lower lip" , adultOnly: true },
   { id: "mid-laugh",          label: "Mid-Laugh",          category: "action",   description: "Caught mid-laugh, head back", promptHint: "caught mid-laugh with head tipped back, eyes crinkled" },
   { id: "pointing-at-camera", label: "Pointing at Camera", category: "action",   description: "Pointing directly at camera", promptHint: "pointing one finger directly at the camera, arm extended", term: "pointing directly at the camera" },
   { id: "tongue-out",         label: "Sticking Tongue Out", category: "action",  description: "Playful tongue-out expression", promptHint: "sticking the tongue out playfully" },
   { id: "thinking",           label: "Thinking",           category: "action",   description: "Hand on chin, contemplative", promptHint: "in a thinking pose with hand on chin, gaze contemplative", term: "thinking pose, hand on chin" },
 
   // -------------------- Resting --------------------
-  { id: "lying-down",         label: "Lying Down",         category: "resting",  description: "Lying flat",                  promptHint: "lying down flat, relaxed" },
+  { id: "lying-down",         label: "Lying Down",         category: "resting",  description: "Lying flat",                  promptHint: "lying down flat, relaxed" , adultOnly: true },
   { id: "sleeping",           label: "Sleeping",           category: "resting",  description: "Eyes closed, sleeping",       promptHint: "sleeping peacefully with eyes closed" },
   { id: "hugging",            label: "Hugging",            category: "resting",  description: "Embracing another",           promptHint: "hugging or embracing another person" },
   { id: "looking-away",       label: "Looking Away",       category: "resting",  description: "Head turned, looking away",   promptHint: "head turned, looking off away from the camera" },
@@ -125,7 +136,7 @@ export const POSES: ReadonlyArray<Pose> = [
   { id: "leaning-back",            label: "Leaning Back",            category: "body-lean",     description: "Torso leaning back slightly",         promptHint: "with the torso leaning back at a slight backward angle", term: "torso leaning slightly back" },
   { id: "leaning-forward",         label: "Leaning Forward",         category: "body-lean",     description: "Torso leaning toward camera",         promptHint: "with the torso leaning forward toward the camera", term: "torso leaning forward" },
   { id: "body-lean-contrapposto",  label: "Contrapposto",            category: "body-lean",     description: "Weight on one leg, hip pushed out",   promptHint: "with the weight on one leg and one hip pushed out, classical contrapposto", term: "contrapposto, hip pushed out" },
-  { id: "arched-back",             label: "Arched Back",             category: "body-lean",     description: "Back gently arched, chest forward",   promptHint: "with the back gently arched, chest forward" },
+  { id: "arched-back",             label: "Arched Back",             category: "body-lean",     description: "Back gently arched, chest forward",   promptHint: "with the back gently arched, chest forward" , adultOnly: true },
   { id: "shoulder-rolled-forward", label: "Shoulder Rolled Forward", category: "body-lean",     description: "One shoulder rolled forward",         promptHint: "with one shoulder rolled forward, asymmetric stance", term: "one shoulder rolled forward" },
 
   // -------------------- Head Tilt --------------------
@@ -155,7 +166,7 @@ const poseById = new Map<string, Pose>(POSES.map((p) => [p.id, p]))
 
 export function getPose(id: string | undefined | null): Pose | undefined {
   if (!id) return undefined
-  return poseById.get(id)
+  return overlayEntry("pose", id, poseById.get(id))
 }
 
 export function getPoseLabel(id: string | undefined | null, fallback?: string): string {

package/src/post-process-effects.ts

@@ -22,6 +22,7 @@
  */
 
 import { resolveTerm, type PickerHintMode } from "./term.js"
+import { overlayEntry } from "./catalog-overlay.js"
 
 export interface PostProcessEffect {
   readonly id: string
@@ -65,7 +66,7 @@ const postProcessById = new Map<string, PostProcessEffect>(
 
 export function getPostProcessEffect(id: string | undefined | null): PostProcessEffect | undefined {
   if (!id) return undefined
-  return postProcessById.get(id)
+  return overlayEntry("post-process-effects", id, postProcessById.get(id))
 }
 
 export function getPostProcessEffectLabel(id: string | undefined | null, fallback?: string): string {

package/src/prompt-builder.ts

@@ -6,7 +6,7 @@
 
 import { resolveTemplate, applyTemplate } from "./prompt-templates.js"
 import { NATIVE_NEGATIVE_PROMPT_MODELS, MODELS_WITH_REFERENCE_IMAGE_SUPPORT, imageReferenceLimit, getMaxImagePromptChars, getMaxNegativePromptChars } from "@nodaro/shared"
-import { getStylePromptHint } from "./style.js"
+import { getStylePromptHint, isDeniedStyleId } from "./style.js"
 import {
   STYLE_SECTION_GAP,
   STYLE_SECTION_HEADER,
@@ -2812,7 +2812,7 @@ function buildImagePromptInternal(config: BuildImagePromptConfig, marks?: Assemb
     }
 
     const styleText = style?.trim()
-    const styleLine = styleText ? `Style: ${getStylePromptHint(styleText) || styleText}` : ""
+    const styleLine = styleText && !isDeniedStyleId(styleText) ? `Style: ${getStylePromptHint(styleText) || styleText}` : ""
 
     const negPrompt = negativePrompt?.trim()
     let nativeNegativePrompt: string | undefined
@@ -2937,7 +2937,7 @@ function buildImagePromptInternal(config: BuildImagePromptConfig, marks?: Assemb
   // the richer promptHint; otherwise fall back to the raw text (covers custom
   // free-text styles that don't match a preset).
   const styleText = style?.trim()
-  const styleLine = styleText ? `Style: ${getStylePromptHint(styleText) || styleText}` : ""
+  const styleLine = styleText && !isDeniedStyleId(styleText) ? `Style: ${getStylePromptHint(styleText) || styleText}` : ""
 
   // Handle negative prompt: native support vs prompt-appended
   const negPrompt = negativePrompt?.trim()

package/src/prompt-wizard-categories.ts

@@ -256,6 +256,9 @@ export const PROVIDER_CAPABILITIES: Record<string, Record<string, string>> = {
     "ltx-2.3-pro":  "Lightricks LTX 2.3 Pro — text/image/audio→video, 6–10s, up to 4K",
     "ltx-2.3-fast": "Lightricks LTX 2.3 Fast — text/image→video, 6–20s, up to 4K",
     "gemini-omni-video": "Google Gemini Omni — multimodal video with native audio, 4–10s, up to 4K.",
+    "gemini-omni-flash": "Google Gemini Omni Flash — faster, cheaper Omni tier; multimodal video with native audio, 4–10s, up to 4K.",
+    "wan-3": "Wan 3.0 — multimodal refs (10 images / 5 videos / 5 audio) or first+last frame, native audio, 2–30s, 480p/720p/1080p",
+    "wan-3-prime": "Wan 3.0 Prime — high-speed Wan 3.0 tier; same surface, faster turnaround at a higher rate",
     "grok-imagine-video-1.5": "Grok Imagine 1.5 — image-to-video only; requires an input image",
   },
   "image-to-video": {
@@ -289,6 +292,9 @@ export const PROVIDER_CAPABILITIES: Record<string, Record<string, string>> = {
     "ltx-2.3-pro":  "Lightricks LTX 2.3 Pro — start/end frame i2v + audio→video, 6–10s, up to 4K",
     "ltx-2.3-fast": "Lightricks LTX 2.3 Fast — start/end frame i2v, 6–20s, up to 4K",
     "gemini-omni-video": "Google Gemini Omni — multimodal video with native audio, 4–10s, up to 4K.",
+    "gemini-omni-flash": "Google Gemini Omni Flash — faster, cheaper Omni tier; multimodal video with native audio, 4–10s, up to 4K.",
+    "wan-3": "Wan 3.0 — multimodal refs (10 images / 5 videos / 5 audio) or first+last frame, native audio, 2–30s, 480p/720p/1080p",
+    "wan-3-prime": "Wan 3.0 Prime — high-speed Wan 3.0 tier; same surface, faster turnaround at a higher rate",
     "grok-imagine-video-1.5": "Grok Imagine 1.5 — stylized animation, 1–15s, 480p/720p (image required)",
   },
   "video-to-video": {

package/src/provider-prompt-doctrine.ts

@@ -239,8 +239,8 @@ KIE VEO API docs (docs.kie.ai/veo3-api/generate-veo-3-video). Captured 2026-08-0
 }
 
 const GEMINI_OMNI_DOCTRINE: ProviderPromptDoctrine = {
-  providers: ["gemini-omni-video"],
-  heading: "Gemini Omni Video (gemini-omni-video)",
+  providers: ["gemini-omni-video", "gemini-omni-flash"],
+  heading: "Gemini Omni (gemini-omni-video, gemini-omni-flash)",
   tips: [
     "Multimodal Google video with native audio: text-to-video, image-to-video, and video-edit through the same prompt surface. 4/6/8/10s; 720p/1080p or 4K tier.",
     "Structure like the platform default: subject → action → scene → lighting → camera → style. Quote dialogue lines to have them spoken; describe SFX/ambience plainly in the prompt.",
@@ -262,6 +262,7 @@ subject → action → scene/environment → lighting → camera movement → st
 
 **Duration & tiers**
 - 4 / 6 / 8 / 10 seconds. 720p/1080p tier or the pricier 4K tier — pick 4K only when the deliverable needs it (nearly 2× the credits).
+- gemini-omni-flash is the faster/cheaper tier with the identical request surface — same 4/6/8/10s, same 720p/1080p and 4K tiers, same video-edit path. Everything above applies verbatim.
 
 Source: KIE gemini-omni-video market contract (parameters + live behavior probed for the
 aspect-ratio hard-reject, see providers/kie/video.ts). Captured 2026-08-09.`,
@@ -334,6 +335,53 @@ Source: Alibaba Cloud Model Studio — "Text-to-video / image-to-video prompt gu
 (alibabacloud.com/help/en/model-studio/text-to-video-prompt). Captured 2026-08-09.`,
 }
 
+// Wan 3.0 is a SEPARATE doctrine from WAN_DOCTRINE on purpose: Wan 2.x binds
+// references as "Image 1" / "Video 1" (capitalised, WITH a space) while the Wan
+// 3.0 contract uses "Image1" / "Video1" / "Audio1" (no space), and 3.0's surface
+// (adaptive aspect, boolean audio, 30s, mutually-exclusive frame vs reference
+// modes) is different. Folding them together would ship a token format the model
+// does not use. There is no published Wan 3.0 prompt guide, so the body below is
+// KIE contract facts only — no invented vendor style claims.
+const WAN_3_DOCTRINE: ProviderPromptDoctrine = {
+  providers: ["wan-3", "wan-3-prime"],
+  heading: "Wan 3.0 (wan-3, wan-3-prime)",
+  tips: [
+    "Two INPUT MODES, exclusive on the wire: first/last frame, OR reference mode (images + videos + audio). With any reference wired the platform folds the frame into the references and names it in the prompt.",
+    "References bind by ordinal token in array order: Image1, Image2, Video1, Audio1 — no space, unlike Wan 2.x's \"Image 1\". Name every wired asset or it may be ignored.",
+    "Reference caps: 10 images / 5 videos / 5 audio clips; each video and each audio clip 1-15s, with ≤15s combined per array. With reference videos, input seconds + output duration ≤ 30.",
+    "2-30 seconds (default 5); 480p/720p/1080p; aspect adaptive (default, matches the input media) or 16:9 / 4:3 / 1:1 / 3:4 / 9:16. Prompt cap 20,000 chars — excess is truncated silently.",
+    "`audio` is a boolean, ON by default: the clip comes back with an ambient/SFX track. Cue the sound you want in the prompt, or state the exclusion (\"no music\") — it is not a dialogue guarantee.",
+    "wan-3-prime is the HIGH-SPEED tier: identical surface and limits, faster turnaround at a higher per-second rate. It is not a quality upgrade — choose it for latency, not for looks.",
+  ],
+  doctrine: `Prompt structure (no public Wan 3.0 prompt guide exists — the KIE API contract is the
+doctrine source, like MiniMax H3 and HappyHorse; platform-standard structure applies):
+subject → action → scene/environment → lighting → camera movement → style → constraints.
+
+**Modes (mutually exclusive at the provider)**
+- Frame mode: first_frame_url, optionally with last_frame_url, and NO references — the frames anchor the shot exactly, so describe MOTION and camera, not the still.
+- Reference mode: image / video / audio reference arrays. The provider CANNOT take these together with the first/last frame parameters, so when both are wired the platform folds — the frame is appended to the reference images (after the caller's own, ordinals unchanged) and bound in the prompt as the opening/closing frame. Write for reference mode whenever a reference is attached.
+- Text-only runs are supported and are the model's default mode.
+
+**Reference binding**
+- Assets bind by ORDINAL TOKEN in array order: Image1, Image2, …, Video1, …, Audio1, …. Note the format has NO space — Wan 2.x's "Image 1" is a different generation and does not apply here.
+- Write the binding into the prompt explicitly ("Image1 walks into the room described in Image2"); an unnamed reference may simply be ignored.
+- Caps: up to 10 images, 5 videos, 5 audio clips. Each video and each audio clip must be 1-15s with ≤15s combined per array. Audio should not be the only media input — pair it with an image or a video.
+
+**Duration, resolution, aspect**
+- 2-30 seconds (provider default 5). With reference videos there is an extra ceiling: input video duration + output duration ≤ 30 seconds.
+- 480p / 720p / 1080p. Aspect "adaptive" (the default — the model selects the ratio from the input media and intent) or 16:9 / 4:3 / 1:1 / 3:4 / 9:16. There is no 21:9.
+- Prompts accept Chinese and English, up to 20,000 characters; anything beyond is truncated silently, so front-load the load-bearing content.
+
+**Audio**
+- The "audio" boolean defaults ON and produces an ambient/SFX track with the clip. Describe the soundscape you want plainly ("rain on glass, distant traffic"), or state the exclusion, or turn the toggle off. The contract documents no lip-synced dialogue guarantee — plan spoken lines as a separate TTS + lip-sync pass.
+
+**Tiers**
+- wan-3 and wan-3-prime take identical inputs. Prime trades a higher per-second rate for faster turnaround; it is not documented as a quality tier.
+
+Source: KIE Wan 3.0 market contract (docs.kie.ai/market/wan/3-0-video,
+docs.kie.ai/market/wan/3-0-video-prime). Captured 2026-09-01.`,
+}
+
 const HAPPYHORSE_DOCTRINE: ProviderPromptDoctrine = {
   providers: ["happyhorse", "happyhorse-i2v", "happyhorse-ref2v", "happyhorse-edit"],
   heading: "HappyHorse 1.1 (happyhorse, happyhorse-i2v, happyhorse-ref2v)",
@@ -391,6 +439,7 @@ export const PROVIDER_PROMPT_DOCTRINES: readonly ProviderPromptDoctrine[] = [
   GEMINI_OMNI_DOCTRINE,
   GROK_IMAGINE_DOCTRINE,
   WAN_DOCTRINE,
+  WAN_3_DOCTRINE,
   HAPPYHORSE_DOCTRINE,
   RUNWAY_KIE_DOCTRINE,
 ]

package/src/render-quality.ts

@@ -24,6 +24,7 @@
  */
 
 import { resolveTerm } from "./term.js"
+import { overlayEntry } from "./catalog-overlay.js"
 
 export interface RenderQuality {
   readonly id: string
@@ -85,7 +86,7 @@ const renderQualityById = new Map<string, RenderQuality>(
 
 export function getRenderQuality(id: string | undefined | null): RenderQuality | undefined {
   if (!id) return undefined
-  return renderQualityById.get(id)
+  return overlayEntry("render-quality", id, renderQualityById.get(id))
 }
 
 export function getRenderQualityLabel(id: string | undefined | null, fallback?: string): string {

package/src/setting.ts

@@ -20,6 +20,7 @@
  */
 
 import { resolveTerm } from "./term.js"
+import { overlayEntry } from "./catalog-overlay.js"
 
 export type SettingCategory = "indoor" | "urban" | "nature" | "fantastical"
 
@@ -85,6 +86,7 @@ export const SETTINGS: ReadonlyArray<Setting> = [
   { id: "parking-lot",     label: "Parking Lot",          category: "urban",       description: "Suburban parking lot at dusk",           promptHint: "set in an empty suburban parking lot at dusk with sodium-vapor lamps casting orange pools, scattered shopping carts and painted lane lines" },
   { id: "penthouse",       label: "Penthouse",            category: "urban",       description: "Luxury penthouse with skyline view",     promptHint: "set in a luxury penthouse interior with panoramic skyline views, marble floors, modernist furniture and low warm ambient light" },
   { id: "gas-station",     label: "Gas Station",          category: "urban",       description: "Lonely highway gas station at night",    promptHint: "set at a lonely highway gas station at night with a fluorescent canopy, bug-swarmed sodium lamps and cracked asphalt" },
+  { id: "open-air-market", label: "Open-Air Market",      category: "urban",       description: "Bustling market of vendor stalls under canopies", term: "open-air market", promptHint: "set in a bustling open-air market — rows of vendor stalls under thatched and canvas canopies, produce piled high, warm dusty light and crowds moving between the stalls" },
 
   // -------------------- Nature --------------------
   { id: "forest",          label: "Forest Clearing",      category: "nature",      description: "Sunlit mossy clearing",                  promptHint: "set in a sunlit forest clearing with moss-covered stones, dappled light through tall trees and a soft carpet of fallen leaves" },
@@ -117,7 +119,7 @@ const settingById = new Map<string, Setting>(SETTINGS.map((s) => [s.id, s]))
 
 export function getSetting(id: string | undefined | null): Setting | undefined {
   if (!id) return undefined
-  return settingById.get(id)
+  return overlayEntry("setting", id, settingById.get(id))
 }
 
 export function getSettingLabel(id: string | undefined | null, fallback?: string): string {

package/src/shared-catalog-overlay.ts

@@ -0,0 +1,83 @@
+import { getAnimalPromptHint, getAnimalTerm, getVehicle, getWeapon, getFurniture } from "@nodaro/shared"
+import { composedHas, composedOption } from "./catalog-overlay.js"
+import { deriveTerm } from "./term.js"
+
+/**
+ * The four object-entity catalogs — animals, vehicles, weapons, furniture —
+ * are OWNED by `@nodaro/shared`, which cannot depend on this package, so
+ * their getters cannot carry the `overlayEntry` the other 34 catalogs do.
+ * These wrappers are the overlay for them, and EVERY prompt-text read of
+ * those catalogs goes through here: the parameter-node dispatcher and the
+ * subject fold both. Two call sites resolving the same id to different text
+ * — one curated, one stock — is exactly what a second, un-overlaid path
+ * produced during review.
+ *
+ * Precedence per id, same four outcomes as catalog-overlay.ts:
+ *   - no pack on the catalog       → the stock getter, untouched
+ *   - denied / not in the pack     → ""  (nothing reaches the prompt)
+ *   - composed option present      → ITS promptHint / term. A pack author
+ *     who rewrote an entry wrote the hint they want injected; rebuilding it
+ *     from label + description would discard that
+ *   - pack-added id (no stock row) → the composed option (covered by the
+ *     branch above — the stock getter is never consulted when a pack exists)
+ */
+
+export function curatedAnimalPromptHint(id: string): string {
+  if (!id) return ""
+  if (!composedHas("animals", id)) return ""
+  return composedOption("animals", id)?.promptHint ?? getAnimalPromptHint(id)
+}
+export function curatedAnimalTerm(id: string): string {
+  if (!id) return ""
+  if (!composedHas("animals", id)) return ""
+  return composedOption("animals", id)?.term ?? getAnimalTerm(id)
+}
+
+type ObjectEntity = { readonly label: string; readonly description: string }
+
+function objectEntityText(
+  catalogId: string,
+  id: string,
+  stock: ObjectEntity | undefined,
+  stockHint: (e: ObjectEntity) => string,
+  stockTerm: (e: ObjectEntity) => string,
+): { readonly hint: string; readonly term: string } {
+  if (!id || !composedHas(catalogId, id)) return { hint: "", term: "" }
+  const composed = composedOption(catalogId, id)
+  if (composed) return { hint: composed.promptHint, term: composed.term }
+  if (!stock) return { hint: "", term: "" }
+  return { hint: stockHint(stock), term: stockTerm(stock) }
+}
+
+/**
+ * The compact fragment for an OBJECT-entity entry (animal / vehicle / weapon /
+ * furniture). Those catalogs carry no `promptHint` of their own — the full
+ * fragment is synthesized as "featuring a {label}, {description}" — so the
+ * compact form is the authored `term` when there is one and the derived label
+ * otherwise (a concrete object's label IS its trade term). The framing verb
+ * ("featuring a", "with a") belongs to the HINT; a term drops bare into
+ * whatever sentence the consumer is building, and "the object is in the scene"
+ * is precisely what these four nodes mean.
+ *
+ * The fallback MUST be `deriveTerm` and not a bare `toLowerCase()`: it is the
+ * same fallback `objectOptions` uses to build the `/v1/catalogs` projection,
+ * so a parenthetical label ("Rifle (bolt-action)") must strip identically here
+ * or the injected fragment and the projected term would disagree.
+ *
+ * `term` is read structurally because it is being added to the shared entity
+ * interfaces separately; this stays correct before and after that lands.
+ */
+
+function objectEntityTerm(entry: { readonly label: string }): string {
+  return (entry as { term?: string }).term ?? deriveTerm(entry.label)
+}
+
+export function curatedVehicleText(id: string) {
+  return objectEntityText("vehicles", id, getVehicle(id), (e) => `featuring a ${e.label.toLowerCase()}, ${e.description}`, objectEntityTerm)
+}
+export function curatedWeaponText(id: string) {
+  return objectEntityText("weapons", id, getWeapon(id), (e) => `with a ${e.label.toLowerCase()}, ${e.description}`, objectEntityTerm)
+}
+export function curatedFurnitureText(id: string) {
+  return objectEntityText("furniture", id, getFurniture(id), (e) => `including a ${e.label.toLowerCase()}, ${e.description}`, objectEntityTerm)
+}

package/src/style.ts

@@ -21,6 +21,7 @@
  */
 
 import { resolveTerm } from "./term.js"
+import { overlayEntry } from "./catalog-overlay.js"
 
 export interface Style {
   readonly id: string
@@ -89,13 +90,28 @@ export const STYLES: ReadonlyArray<Style> = [
   { id: "acrylic-paint",   label: "Acrylic Paint",    description: "Fast-drying opaque acrylic on canvas",     promptHint: "rendered as an acrylic painting on canvas, fast-drying opaque pigment with crisp sharp edges, confident quick brush strokes, high-key saturated color and a flatter more graphic finish than traditional oil paint", term: "acrylic painting" },
   { id: "mixed-media",     label: "Mixed Media",      description: "Collage + paint + ink hybrid",            promptHint: "rendered as a mixed-media artwork combining torn paper collage, acrylic paint, ink and graphite on a layered substrate, heterogeneous textures, visible tape and stitching, and an exuberant hand-assembled studio-art quality" },
   { id: "manga",           label: "Manga",            description: "Inked B&W Japanese comic panel",          promptHint: "rendered as inked manga panel art, crisp black ink on white with confident line weight variation, screen-tone dot patterns for shading, dramatic speed lines and the distinctly Japanese black-and-white comic aesthetic — separate from full-color anime" },
+  { id: "early-color-photo", label: "Early Color Photo", description: "Prokudin-Gorsky / autochrome early-1900s color", promptHint: "rendered as an early-1900s color photograph in the Prokudin-Gorsky / autochrome tradition — soft three-colour-separation registration, muted dye-toned palette, fine grain and a gentle antique warmth", term: "early autochrome color photograph" },
 ] as const
 
 const styleById = new Map<string, Style>(STYLES.map((s) => [s.id, s]))
 
 export function getStyle(id: string | undefined | null): Style | undefined {
   if (!id) return undefined
-  return styleById.get(id)
+  return overlayEntry("style", id, styleById.get(id))
+}
+
+/**
+ * The inline `style` field on an image node is id-OR-free-text: a catalog id
+ * resolves to its hint, anything else is the user's own words and is folded
+ * verbatim. That fallback has a hole on a curated deployment — a style id the
+ * pack REMOVED resolves to nothing, so the fold would treat it as prose and
+ * ship the raw id. This tells the fold apart: true for an id the stock
+ * catalog knows but this deployment does not offer. Such a value is neither
+ * a hint nor prose; it is dropped.
+ */
+export function isDeniedStyleId(value: string | undefined | null): boolean {
+  if (!value) return false
+  return styleById.has(value) && getStyle(value) === undefined
 }
 
 export function getStyleLabel(id: string | undefined | null, fallback?: string): string {