@mcptoolshop/style-dataset-lab 3.0.1 → 3.2.0

package/lib/canon-build/emitters/character.js

@@ -0,0 +1,167 @@
+/**
+ * Character emitter (D5: character.schema.json).
+ *
+ * Caption: trigger + " style, a " + kind + " wearing " + visual.attire + ", " + visual.silhouette_cue + ". " + visual.build + " build, " + visual.hair
+ * Prompt positive: visual.* (silhouette_cue, signature_prop, distinguishing_marks, build, hair, eyes, age_band, attire, palette) + signature_features + pose hint from narrative.voice
+ * Prompt negative: forbidden_inputs + divine-radiance suppression when kind="mortal"
+ * Context sections: Identity, Role & Voice, Relationships, Canonical Events, Mechanical (optional), Forbidden, Sources
+ */
+
+import { contextFrontmatter, renderKeyValueSection, renderSection } from './base.js';
+
+const SCHEMA_KIND = 'character';
+
+export function emitCharacter(entry, ctx) {
+  const fm = entry.frontmatter;
+  return {
+    schemaKind: SCHEMA_KIND,
+    caption: buildCaption(fm, ctx),
+    prompt: buildPromptTemplate(fm),
+    context: buildContext(entry, ctx),
+  };
+}
+
+function buildCaption(fm, ctx) {
+  const v = fm.visual || {};
+  const segments = [];
+  if (ctx.trigger) segments.push(`${ctx.trigger} style`);
+
+  const kind = fm.kind || fm.role_class || 'figure';
+  const attire = v.attire || '';
+  const silhouette = v.silhouette_cue || '';
+  const subjectClause = attire ? `a ${kind} wearing ${attire}` : `a ${kind}`;
+  segments.push(silhouette ? `${subjectClause}, ${silhouette}` : subjectClause);
+
+  const buildAndHair = [];
+  if (v.build) buildAndHair.push(`${v.build} build`);
+  if (v.hair) buildAndHair.push(v.hair);
+  if (buildAndHair.length) segments.push(buildAndHair.join(', '));
+
+  return segments.join(', ');
+}
+
+function buildPromptTemplate(fm) {
+  const v = fm.visual || {};
+  const lines = [];
+  lines.push(`{# auto-generated canon-build prompt template — do not hand-edit #}`);
+  lines.push(`{{ trigger }} style{% if character_trigger %}, {{ character_trigger }}{% endif %}, a ${fm.kind || fm.role_class || 'figure'}, ${v.silhouette_cue || ''}.`);
+
+  const identity = [];
+  if (v.signature_prop) identity.push(`signature prop: ${v.signature_prop}`);
+  if (Array.isArray(v.distinguishing_marks) && v.distinguishing_marks.length) {
+    identity.push(`marks: ${v.distinguishing_marks.join(', ')}`);
+  }
+  if (identity.length) lines.push(`{# identity #} ${identity.join('; ')}`);
+
+  const body = [];
+  if (v.build) body.push(`${v.build} build`);
+  if (v.hair) body.push(v.hair);
+  if (v.eyes) body.push(`${v.eyes} eyes`);
+  if (v.age_band) body.push(`${v.age_band} age`);
+  else if (v.age_description) body.push(v.age_description);
+  if (body.length) lines.push(`{# body #} ${body.join(', ')}`);
+
+  if (v.attire) lines.push(`{# attire #} ${v.attire}`);
+  if (Array.isArray(v.palette) && v.palette.length) {
+    lines.push(`{# palette #} ${v.palette.join(' ')}`);
+  }
+  if (Array.isArray(fm.signature_features) && fm.signature_features.length) {
+    lines.push(`{# signature #} ${fm.signature_features.join(', ')}`);
+  }
+  if (v.posture_default) {
+    lines.push(`{# pose #} ${v.posture_default}`);
+  }
+
+  lines.push('---');
+  lines.push(`{{ negative_base }}`);
+  if (fm.kind === 'mortal') {
+    lines.push(', divine radiance, aureole, supernatural glow');
+  }
+  if (fm.canon_refs && !fm.sources) {
+    // Canon-internal attestation (Star Freight path): callers still expect
+    // `{{ negative_base }}` to land on its own line; no extra addition needed.
+  }
+  return lines.join('\n') + '\n';
+}
+
+function buildContext(entry, ctx) {
+  const fm = entry.frontmatter;
+  const n = fm.narrative || {};
+  const m = fm.mechanical;
+  const out = [];
+
+  out.push(contextFrontmatter({
+    entityId: fm.id,
+    schemaKind: SCHEMA_KIND,
+    generatedFrom: ctx.generatedFrom,
+    entryHash: ctx.entryHash,
+  }));
+  out.push(`# ${titleFromId(fm.id)}\n`);
+
+  out.push(renderKeyValueSection('Identity', [
+    ['kind', fm.kind],
+    ['role_class', fm.role_class],
+    ['species', fm.species],
+    ['faction_primary', fm.faction_primary],
+    ['faction_cover', fm.faction_cover],
+    ['tech_literacy', fm.tech_literacy],
+    ['combat_training', fm.combat_training],
+    ['mortal_status', fm.mortal_status],
+    ['age_band', fm.visual?.age_band],
+    ['age_description', fm.visual?.age_description],
+  ]));
+
+  out.push(renderKeyValueSection('Role & Voice', [
+    ['role', n.role],
+    ['voice', n.voice],
+    ['motivation', n.motivation],
+    ['speech_register', n.speech_register],
+    ['vocabulary_forbidden', n.vocabulary_forbidden],
+  ]));
+
+  if (fm.turncoat_arc && fm.turncoat_arc.status && fm.turncoat_arc.status !== 'none') {
+    out.push(renderKeyValueSection('Turncoat arc', [
+      ['status', fm.turncoat_arc.status],
+      ['reveal_trigger', fm.turncoat_arc.reveal_trigger],
+      ['defection_threshold', fm.turncoat_arc.defection_threshold],
+      ['handler_faction', fm.turncoat_arc.handler_faction],
+      ['canon_true_voice', fm.turncoat_arc.canon_true_voice],
+      ['seeds', fm.turncoat_arc.seeds],
+    ]));
+  }
+
+  if (Array.isArray(n.relationships) && n.relationships.length) {
+    const relBullets = n.relationships.map((r) => {
+      const note = r.note ? ` — ${r.note}` : '';
+      return `${r.edge_type} ${r.target_id}${note}`;
+    });
+    out.push(renderSection('Relationships', relBullets));
+  }
+
+  out.push(renderSection('Canonical Events', n.arc_beats || null));
+
+  if (m && typeof m === 'object' && Object.values(m).some((v) => v != null)) {
+    out.push(renderKeyValueSection('Mechanical', [
+      ['combat_role', m.combat_role],
+      ['signature_abilities', m.signature_abilities],
+      ['traits', m.traits],
+    ]));
+  }
+
+  out.push(renderSection('Forbidden', fm.forbidden_inputs || null));
+  out.push(renderSection('Sources', fm.sources || null));
+  out.push(renderSection('Canon refs', fm.canon_refs || null));
+
+  if (entry.body && entry.body.trim()) {
+    out.push(`## Notes\n${entry.body.trim()}\n`);
+  }
+
+  return out.join('');
+}
+
+function titleFromId(id) {
+  if (!id) return 'Untitled';
+  return id.split('-').map((w) => w.charAt(0).toUpperCase() + w.slice(1)).join(' ');
+}
+
+export { buildCaption as _buildCaption, buildPromptTemplate as _buildPromptTemplate, buildContext as _buildContext };

package/lib/canon-build/emitters/deity.js

@@ -0,0 +1,165 @@
+/**
+ * Deity emitter (D5: deity.schema.json).
+ *
+ * Caption: trigger + " style, " + generation + " deity, " + silhouette_cue + ", holding " + signature_attribute
+ * Prompt positive: silhouette_cue + signature_attribute + epithets + divine_radiance rendered as adjective + body + attire + palette + signature_features + behavior hint
+ * Prompt negative: forbidden_inputs + generation-specific guards + radiance=none-on-earth suppression
+ * Context sections: Identity, Epithets, Role & Voice, Relationships, Cult, Mechanical (optional), Forbidden, Sources
+ */
+
+import { contextFrontmatter, renderKeyValueSection, renderSection } from './base.js';
+
+const SCHEMA_KIND = 'deity';
+
+const RADIANCE_ADJECTIVES = {
+  'subtle': 'with a subtle aura',
+  'aureole': 'with a subtle golden halo',
+  'golden-aura': 'bathed in golden aura',
+  'stormlight': 'crackling with stormlight',
+  'underworld-pallor': 'lit by cold underworld pallor',
+  'blinding': 'radiant with blinding light',
+  'none-on-earth': '',
+};
+
+export function emitDeity(entry, ctx) {
+  const fm = entry.frontmatter;
+  return {
+    schemaKind: SCHEMA_KIND,
+    caption: buildCaption(fm, ctx),
+    prompt: buildPromptTemplate(fm),
+    context: buildContext(entry, ctx),
+  };
+}
+
+function buildCaption(fm, ctx) {
+  const v = fm.visual || {};
+  const segments = [];
+  if (ctx.trigger) segments.push(`${ctx.trigger} style`);
+
+  const generation = fm.generation || 'greek';
+  const radiance = v.divine_radiance && v.divine_radiance !== 'none-on-earth'
+    ? `${v.divine_radiance} `
+    : '';
+  segments.push(`${generation} ${radiance}deity`);
+
+  if (v.silhouette_cue) segments.push(v.silhouette_cue);
+  if (v.signature_attribute) segments.push(`holding ${v.signature_attribute}`);
+
+  return segments.join(', ');
+}
+
+function buildPromptTemplate(fm) {
+  const v = fm.visual || {};
+  const n = fm.narrative || {};
+  const lines = [];
+  lines.push(`{# auto-generated canon-build prompt template — do not hand-edit #}`);
+  lines.push(`{{ trigger }} style{% if character_trigger %}, {{ character_trigger }}{% endif %}, a ${fm.generation || 'greek'} deity, ${v.silhouette_cue || ''}.`);
+
+  if (v.signature_attribute) lines.push(`{# attribute #} holding ${v.signature_attribute}`);
+  if (Array.isArray(fm.epithets) && fm.epithets.length) {
+    lines.push(`{# epithet #} ${fm.epithets.slice(0, 2).join(', ')}`);
+  }
+  const radiance = RADIANCE_ADJECTIVES[v.divine_radiance] || '';
+  if (radiance) lines.push(`{# radiance #} ${radiance}`);
+
+  const body = [];
+  if (v.build) body.push(`${v.build} build`);
+  if (v.hair) body.push(v.hair);
+  if (v.age_band) body.push(`${v.age_band} age`);
+  if (body.length) lines.push(`{# body #} ${body.join(', ')}`);
+
+  if (v.attire) lines.push(`{# attire #} ${v.attire}`);
+  if (Array.isArray(v.palette) && v.palette.length) {
+    lines.push(`{# palette #} ${v.palette.join(' ')}`);
+  }
+  if (Array.isArray(fm.signature_features) && fm.signature_features.length) {
+    lines.push(`{# signature #} ${fm.signature_features.join(', ')}`);
+  }
+  if (n.core_behavior) {
+    lines.push(`{# behavior #} ${firstClause(n.core_behavior)}`);
+  }
+
+  lines.push('---');
+  lines.push(`{{ negative_base }}`);
+  if (fm.generation === 'olympian') {
+    lines.push(', monstrous features, chthonic pallor');
+  }
+  if (v.divine_radiance === 'none-on-earth') {
+    lines.push(', any visible radiance, aureole, glow');
+  }
+  return lines.join('\n') + '\n';
+}
+
+function buildContext(entry, ctx) {
+  const fm = entry.frontmatter;
+  const n = fm.narrative || {};
+  const m = fm.mechanical;
+  const out = [];
+
+  out.push(contextFrontmatter({
+    entityId: fm.id,
+    schemaKind: SCHEMA_KIND,
+    generatedFrom: ctx.generatedFrom,
+    entryHash: ctx.entryHash,
+  }));
+  out.push(`# ${titleFromId(fm.id)}\n`);
+
+  out.push(renderKeyValueSection('Identity', [
+    ['generation', fm.generation],
+    ['domains', fm.domains],
+  ]));
+
+  out.push(renderSection('Epithets', fm.epithets || null));
+
+  out.push(renderKeyValueSection('Role & Voice', [
+    ['role', n.role],
+    ['voice', n.voice],
+    ['core_behavior', n.core_behavior],
+    ['alignment_to_hero', n.alignment_to_hero],
+    ['speech_register', n.speech_register],
+    ['vocabulary_forbidden', n.vocabulary_forbidden],
+  ]));
+
+  out.push(renderKeyValueSection('Relationships', [
+    ['children', n.children],
+    ['rivalries', n.rivalries],
+    ['consorts', n.consorts],
+    ['parents', fm.parentage?.parents],
+  ]));
+
+  out.push(renderKeyValueSection('Cult', [
+    ['cult_sites', fm.cult_sites],
+    ['sacred_animals', fm.sacred_animals],
+    ['sacred_plants', fm.sacred_plants],
+  ]));
+
+  if (m && typeof m === 'object' && Object.values(m).some((v) => v != null)) {
+    out.push(renderKeyValueSection('Mechanical', [
+      ['favor_grants', m.favor_grants],
+      ['wrath_triggers', m.wrath_triggers],
+      ['encounter_class', m.encounter_class],
+    ]));
+  }
+
+  out.push(renderSection('Forbidden', fm.forbidden_inputs || null));
+  out.push(renderSection('Sources', fm.sources || null));
+
+  if (entry.body && entry.body.trim()) {
+    out.push(`## Notes\n${entry.body.trim()}\n`);
+  }
+
+  return out.join('');
+}
+
+function firstClause(s) {
+  if (!s) return '';
+  const idx = s.search(/[,;.]/);
+  return idx < 0 ? s.trim() : s.slice(0, idx).trim();
+}
+
+function titleFromId(id) {
+  if (!id) return 'Untitled';
+  return id.split('-').map((w) => w.charAt(0).toUpperCase() + w.slice(1)).join(' ');
+}
+
+export { buildCaption as _buildCaption, buildPromptTemplate as _buildPromptTemplate, buildContext as _buildContext };

package/lib/canon-build/emitters/faction.js

@@ -0,0 +1,161 @@
+/**
+ * Faction emitter (Star Freight D4).
+ *
+ * Faction captions + prompts serve the World LoRA's faction-aesthetic signal.
+ * The emitter lane for factions is constant "faction-aesthetic" (see
+ * canon-build/config.json schema_to_lane).
+ *
+ * Caption: trigger + " style, " + faction_class + " faction aesthetic, " +
+ *          architectural_style + ", " + aesthetic_markers[0..2]
+ * Prompt positive: architectural_style + aesthetic_markers + palette +
+ *                  uniform_or_attire_description + faction_prop_signatures +
+ *                  typography_style + signature_features
+ * Prompt negative: forbidden_inputs
+ * Context sections: Identity, Visual, Narrative, Stance, Faction edges,
+ *                   Mechanical (optional), Forbidden, Sources, Canon refs
+ */
+
+import { contextFrontmatter, renderKeyValueSection, renderSection } from './base.js';
+
+const SCHEMA_KIND = 'faction';
+
+export function emitFaction(entry, ctx) {
+  const fm = entry.frontmatter;
+  return {
+    schemaKind: SCHEMA_KIND,
+    caption: buildCaption(fm, ctx),
+    prompt: buildPromptTemplate(fm),
+    context: buildContext(entry, ctx),
+  };
+}
+
+function buildCaption(fm, ctx) {
+  const v = fm.visual || {};
+  const segments = [];
+  if (ctx.trigger) segments.push(`${ctx.trigger} style`);
+
+  const cls = fm.faction_class || 'faction';
+  segments.push(`${cls} faction aesthetic`);
+
+  if (v.architectural_style) segments.push(v.architectural_style);
+
+  if (Array.isArray(v.aesthetic_markers) && v.aesthetic_markers.length) {
+    segments.push(v.aesthetic_markers.slice(0, 2).join(', '));
+  }
+
+  return segments.join(', ');
+}
+
+function buildPromptTemplate(fm) {
+  const v = fm.visual || {};
+  const lines = [];
+  lines.push(`{# auto-generated canon-build prompt template — do not hand-edit #}`);
+  lines.push(`{{ trigger }} style, ${fm.faction_class || 'faction'} faction aesthetic, ${v.architectural_style || ''}.`);
+
+  if (Array.isArray(v.aesthetic_markers) && v.aesthetic_markers.length) {
+    lines.push(`{# aesthetic #} ${v.aesthetic_markers.join(', ')}`);
+  }
+  if (v.uniform_or_attire_description) {
+    lines.push(`{# uniform #} ${v.uniform_or_attire_description}`);
+  }
+  if (v.silhouette_convention) {
+    lines.push(`{# silhouette #} ${v.silhouette_convention}`);
+  }
+  if (v.typography_style) {
+    lines.push(`{# typography #} ${v.typography_style}`);
+  }
+  if (Array.isArray(v.faction_prop_signatures) && v.faction_prop_signatures.length) {
+    lines.push(`{# props #} ${v.faction_prop_signatures.join(', ')}`);
+  }
+  if (Array.isArray(v.palette) && v.palette.length) {
+    lines.push(`{# palette #} ${v.palette.join(' ')}`);
+  }
+  if (Array.isArray(fm.signature_features) && fm.signature_features.length) {
+    lines.push(`{# signature #} ${fm.signature_features.join(', ')}`);
+  }
+
+  lines.push('---');
+  lines.push(`{{ negative_base }}`);
+  return lines.join('\n') + '\n';
+}
+
+function buildContext(entry, ctx) {
+  const fm = entry.frontmatter;
+  const n = fm.narrative || {};
+  const s = fm.stance || {};
+  const m = fm.mechanical;
+  const v = fm.visual || {};
+  const out = [];
+
+  out.push(contextFrontmatter({
+    entityId: fm.id,
+    schemaKind: SCHEMA_KIND,
+    generatedFrom: ctx.generatedFrom,
+    entryHash: ctx.entryHash,
+  }));
+  out.push(`# ${titleFromId(fm.id)}\n`);
+
+  out.push(renderKeyValueSection('Identity', [
+    ['faction_class', fm.faction_class],
+  ]));
+
+  out.push(renderKeyValueSection('Visual', [
+    ['palette', v.palette],
+    ['aesthetic_markers', v.aesthetic_markers],
+    ['silhouette_convention', v.silhouette_convention],
+    ['typography_style', v.typography_style],
+    ['uniform_or_attire_description', v.uniform_or_attire_description],
+    ['architectural_style', v.architectural_style],
+    ['faction_prop_signatures', v.faction_prop_signatures],
+  ]));
+
+  out.push(renderKeyValueSection('Narrative', [
+    ['voice', n.voice],
+    ['values', n.values],
+    ['taboos', n.taboos],
+    ['speech_register', n.speech_register],
+    ['vocabulary_forbidden', n.vocabulary_forbidden],
+    ['internal_tensions', n.internal_tensions],
+  ]));
+
+  out.push(renderKeyValueSection('Stance', [
+    ['toward_player_at_start', s.toward_player_at_start],
+    ['toward_player_trajectory', s.toward_player_trajectory],
+  ]));
+
+  if (Array.isArray(s.faction_edges) && s.faction_edges.length) {
+    const bullets = s.faction_edges.map((r) => {
+      const note = r.note ? ` — ${r.note}` : '';
+      return `${r.edge_type} ${r.target_id}${note}`;
+    });
+    out.push(renderSection('Faction edges', bullets));
+  }
+
+  if (m && typeof m === 'object' && Object.values(m).some((vv) => vv != null)) {
+    out.push(renderKeyValueSection('Mechanical', [
+      ['reputation_starting_value', m.reputation_starting_value],
+      ['skill_bonuses_for_member', m.skill_bonuses_for_member],
+    ]));
+    if (Array.isArray(m.standing_deltas_by_action) && m.standing_deltas_by_action.length) {
+      const bullets = m.standing_deltas_by_action.map((d) => `${d.action}: ${d.delta >= 0 ? '+' : ''}${d.delta}`);
+      out.push(renderSection('Standing deltas', bullets));
+    }
+  }
+
+  out.push(renderSection('Forbidden', fm.forbidden_inputs || null));
+  out.push(renderSection('Sources', fm.sources || null));
+  out.push(renderSection('Canon refs', fm.canon_refs || null));
+
+  if (entry.body && entry.body.trim()) {
+    out.push(`## Notes\n${entry.body.trim()}\n`);
+  }
+
+  return out.join('');
+}
+
+function titleFromId(id) {
+  if (!id) return 'Untitled';
+  return id.split('-').map((w) => w.charAt(0).toUpperCase() + w.slice(1)).join(' ');
+}
+
+export { buildCaption as _buildCaption, buildPromptTemplate as _buildPromptTemplate, buildContext as _buildContext };

package/lib/canon-build/emitters/index.js

@@ -0,0 +1,38 @@
+/**
+ * Emitter dispatch — schema filename → per-schema emit function.
+ *
+ * The build orchestrator consults this map to pick the right emitter for an
+ * entry. Adding a new canon schema means adding its emitter here; the rest
+ * of the build step is schema-agnostic.
+ */
+
+import { emitMonster } from './monster.js';
+import { emitCharacter } from './character.js';
+import { emitDeity } from './deity.js';
+import { emitLocation } from './location.js';
+import { emitRelic } from './relic.js';
+import { emitFaction } from './faction.js';
+import { emitShip } from './ship.js';
+import { emitSpecies } from './species.js';
+
+export const EMITTERS = {
+  'monster.schema.json': emitMonster,
+  'character.schema.json': emitCharacter,
+  'deity.schema.json': emitDeity,
+  'location.schema.json': emitLocation,
+  'relic.schema.json': emitRelic,
+  'faction.schema.json': emitFaction,
+  'ship.schema.json': emitShip,
+  'species.schema.json': emitSpecies,
+};
+
+/**
+ * Get the emitter for a given schema filename.
+ * Returns null when no emitter is registered — orchestrator uses this to
+ * surface a structured error rather than silently dropping entries.
+ */
+export function getEmitter(schemaName) {
+  return EMITTERS[schemaName] || null;
+}
+
+export { emitMonster, emitCharacter, emitDeity, emitLocation, emitRelic, emitFaction, emitShip, emitSpecies };

package/lib/canon-build/emitters/location.js

@@ -0,0 +1,153 @@
+/**
+ * Location emitter (D5: location.schema.json).
+ *
+ * Caption: trigger + " style, a " + location_type + " in " + region + ", " + silhouette_cue + ", " + lighting_mood
+ * Prompt positive: silhouette_cue + signature_props + lighting_mood + scale_logic + material_language + era_markers + flora_fauna + palette + signature_features
+ * Prompt negative: forbidden_inputs (era-anachronism-heavy)
+ * Context sections: Identity, Role & Significance, Mythic Events, Associations, Ritual, Forbidden, Sources
+ */
+
+import { contextFrontmatter, renderKeyValueSection, renderSection } from './base.js';
+
+const SCHEMA_KIND = 'location';
+
+export function emitLocation(entry, ctx) {
+  const fm = entry.frontmatter;
+  return {
+    schemaKind: SCHEMA_KIND,
+    caption: buildCaption(fm, ctx),
+    prompt: buildPromptTemplate(fm),
+    context: buildContext(entry, ctx),
+  };
+}
+
+function buildCaption(fm, ctx) {
+  const v = fm.visual || {};
+  const segments = [];
+  if (ctx.trigger) segments.push(`${ctx.trigger} style`);
+
+  const typeClause = [];
+  if (fm.location_type) typeClause.push(`a ${fm.location_type}`);
+  const contextTag = fm.region || fm.scale_context?.parent_sector;
+  if (contextTag) typeClause.push(`in ${contextTag}`);
+  if (typeClause.length) segments.push(typeClause.join(' '));
+
+  if (v.silhouette_cue) segments.push(v.silhouette_cue);
+  if (v.lighting_mood) segments.push(v.lighting_mood);
+
+  return segments.join(', ');
+}
+
+function buildPromptTemplate(fm) {
+  const v = fm.visual || {};
+  const lines = [];
+  lines.push(`{# auto-generated canon-build prompt template — do not hand-edit #}`);
+  const regionTag = fm.region || fm.scale_context?.parent_sector || 'greek lands';
+  lines.push(`{{ trigger }} style, a ${fm.location_type || 'place'} in ${regionTag}, ${v.silhouette_cue || ''}.`);
+
+  if (Array.isArray(v.signature_props) && v.signature_props.length) {
+    lines.push(`{# props #} ${v.signature_props.join(', ')}`);
+  }
+  if (v.lighting_mood) lines.push(`{# light #} ${v.lighting_mood}`);
+  if (v.scale_logic) lines.push(`{# scale #} ${v.scale_logic}`);
+  if (v.material_language) lines.push(`{# materials #} ${v.material_language}`);
+  if (Array.isArray(v.era_markers) && v.era_markers.length) {
+    lines.push(`{# era markers #} ${v.era_markers.join(', ')}`);
+  }
+  if (Array.isArray(v.flora_fauna) && v.flora_fauna.length) {
+    lines.push(`{# flora/fauna #} ${v.flora_fauna.join(', ')}`);
+  }
+  if (Array.isArray(v.palette) && v.palette.length) {
+    lines.push(`{# palette #} ${v.palette.join(' ')}`);
+  }
+  if (Array.isArray(fm.signature_features) && fm.signature_features.length) {
+    lines.push(`{# signature #} ${fm.signature_features.join(', ')}`);
+  }
+
+  lines.push('---');
+  lines.push(`{{ negative_base }}`);
+  return lines.join('\n') + '\n';
+}
+
+function buildContext(entry, ctx) {
+  const fm = entry.frontmatter;
+  const n = fm.narrative || {};
+  const out = [];
+
+  out.push(contextFrontmatter({
+    entityId: fm.id,
+    schemaKind: SCHEMA_KIND,
+    generatedFrom: ctx.generatedFrom,
+    entryHash: ctx.entryHash,
+  }));
+  out.push(`# ${titleFromId(fm.id)}\n`);
+
+  out.push(renderKeyValueSection('Identity', [
+    ['location_type', fm.location_type],
+    ['region', fm.region],
+    ['era_logic', fm.era_logic],
+    ['parent_ship', fm.scale_context?.parent_ship],
+    ['parent_station', fm.scale_context?.parent_station],
+    ['parent_sector', fm.scale_context?.parent_sector],
+    ['parent_system', fm.scale_context?.parent_system],
+    ['controlled_by_faction', fm.controlled_by_faction],
+    ['controlling_species', fm.controlling_species],
+    ['environment_class', fm.environment_class],
+    ['access_class', fm.access_class],
+    ['architectural_style', fm.architectural_style],
+  ]));
+
+  out.push(renderKeyValueSection('Role & Significance', [
+    ['role', n.role],
+    ['cultural_weight', n.cultural_weight],
+    ['mortal_access', n.mortal_access],
+  ]));
+
+  const events = fm.mythic_events || n.notable_events;
+  if (Array.isArray(events) && events.length) {
+    const bullets = events.map((ev) => {
+      const participants = Array.isArray(ev.participants) && ev.participants.length
+        ? `, participants: ${ev.participants.join(', ')}`
+        : '';
+      const cite = ev.source || ev.canon_ref || '';
+      return `${ev.event} (${ev.era || ''}${cite ? `, ${cite}` : ''}${participants})`;
+    });
+    // Preserve the Greek heading when the Greek field is present — tests pin
+    // it. SF entries carry `notable_events` (a field Greek doesn't have) and
+    // get the new heading.
+    const heading = Array.isArray(fm.mythic_events) ? 'Mythic Events' : 'Notable Events';
+    out.push(renderSection(heading, bullets));
+  }
+
+  out.push(renderKeyValueSection('Associations', [
+    ['associated_deities', fm.associated_deities],
+    ['associated_monsters', fm.associated_monsters],
+  ]));
+
+  if (Array.isArray(n.relationships) && n.relationships.length) {
+    const relBullets = n.relationships.map((r) => {
+      const note = r.note ? ` — ${r.note}` : '';
+      return `${r.edge_type} ${r.target_id}${note}`;
+    });
+    out.push(renderSection('Relationships', relBullets));
+  }
+
+  out.push(renderSection('Ritual', n.forbidden_acts || null));
+
+  out.push(renderSection('Forbidden', fm.forbidden_inputs || null));
+  out.push(renderSection('Sources', fm.sources || null));
+  out.push(renderSection('Canon refs', fm.canon_refs || null));
+
+  if (entry.body && entry.body.trim()) {
+    out.push(`## Notes\n${entry.body.trim()}\n`);
+  }
+
+  return out.join('');
+}
+
+function titleFromId(id) {
+  if (!id) return 'Untitled';
+  return id.split('-').map((w) => w.charAt(0).toUpperCase() + w.slice(1)).join(' ');
+}
+
+export { buildCaption as _buildCaption, buildPromptTemplate as _buildPromptTemplate, buildContext as _buildContext };