Basic Memory Repo Images

Basic Memory Images

Generate repository visuals with evidence-grounded content and canonical output paths. The file and marker names still say "infographic" for compatibility, but PR generation is image-first: scene, poster, painting, photograph, cover, tableau, staged artifact, or another editorial visual moment that describes the intent of the PR. PR images are non-gating BM Bossbot artifacts; changelog and release-summary images are manual evidence-pack workflows.

Output Contract

• Base output directory: docs/assets/infographics/
• PR image: docs/assets/infographics/pr-<number>.webp
• Changelog image: docs/assets/infographics/changelog.webp
• Weekly image:
  • This is always a 2-Week Retro window: previous ISO week through current ISO week (start-week = current-week - 1, end-week = current-week).
  • Same year window: docs/assets/infographics/<year>-w<start-week>-w<end-week>.webp
  • Cross-year window: docs/assets/infographics/<start-year>-w<start-week>-<end-year>-w<end-week>.webp

PR Mode

PR mode uses the BM Bossbot summary block as source material. Do not hand-write claims that are not present in the PR body.

1. Fetch the PR body:

gh pr view <number> --json body --jq '.body // ""' > /tmp/bm-pr-body.md

2. Generate the canonical asset:

uv run --script scripts/generate_pr_infographic.py \
  --pr-number <number> \
  --pr-body-file /tmp/bm-pr-body.md \
  --theme "<optional visual theme>" \
  --provenance-output /tmp/bm-infographic-provenance.md \
  --output docs/assets/infographics/pr-<number>.webp

If the PR body contains a managed image theme block, the script reads it automatically:

<!-- BM_INFOGRAPHIC_THEME:start -->
<theme>
<!-- BM_INFOGRAPHIC_THEME:end -->

Before spending an image call, test the prompt path locally:

uv run --script scripts/generate_pr_infographic.py \
  --pr-number <number> \
  --pr-body-file /tmp/bm-pr-body.md \
  --theme "<optional visual theme>" \
  --output docs/assets/infographics/pr-<number>.webp \
  --print-prompt

--dry-run is an alias for --print-prompt; both print the final prompt and exit without calling OpenAI.

When no theme is supplied, the script selects a deterministic BM visual direction from the style pool below based on the PR number and Bossbot summary. This keeps repeated PR images from collapsing into the same generic visual.

When the image is generated, also write provenance with --provenance-output <path>. BM Bossbot publishes that managed block into the PR body with these markers:

<!-- BM_INFOGRAPHIC_PROVENANCE:start -->
...
<!-- BM_INFOGRAPHIC_PROVENANCE:end -->

The provenance block records the generated asset path, image model, size, quality, image mode, theme source, and selected visual direction. It intentionally does not dump the full generated prompt into the PR body. Treat this block as debugging and creative provenance only; it is not a merge gate.

The PR image is visual support only. The authoritative merge gate is the GitHub commit status named BM Bossbot Approval.

Changelog Mode

Build an evidence pack before writing a prompt:

• diff truth source: merged PR diffs, merge commits, or local reconstructed diffs
• changed-file orientation: git diff --stat plus key file reads
• impact ledger: before/after outcomes tied to actual changes
• discard list: misleading titles, reverted work, rename-only churn, speculative TODOs
• chosen image form: poster, scene, tableau, cover, painting, photograph, staged artifact, or another editorial visual moment
• chosen BM style category: exactly one category from the selection pool below

Read these references before drafting the prompt:

• references/prompt-blueprint.md
• references/style-balance.md

Read the current CHANGELOG.md entries and include the latest meaningful changes.

Style And Category Selection

Select exactly one BM style category per image based on semantic fit. The visual language should be recognizable and tasteful, while staying business-readable.

Create an image-first visual form that communicates the change: poster, scene, tableau, cover image, painting, photograph, staged artifact, or another editorial visual moment. Maps, diagrams, dossiers, charts, and labels can appear as props inside the scene, but do not make a text-heavy infographic.

BM category pool:

• computer science college textbooks: SICP-style diagrams, algorithms lectures, compiler pipelines, automata, database systems, type theory, operating systems
• classic literature subjects: sea voyages, gothic manors, Dickensian city maps, Austen social graphs, library marginalia, travel journals
• fantasy/D&D-inspired: quest maps, dungeon keys, guild ledgers, spellbooks, bestiaries, tavern notice boards; no copyrighted settings
• Music: Metal, Hard Rock, Punk, techno, soul, reggae bands; no pop music, no direct band logos, album covers, or musician likenesses
• sci-fi: Star Wars inspired knockoff, Spaceballs-adjacent space opera, fleet routes, mission consoles, contraband manifests; avoid copyrighted characters, logos, or named fictional universes
• Conan the barbarian-inspired sword-and-sorcery: ruined temples, desert routes, battle standards, ancient maps; no named character likenesses
• Comic books: issue covers, splash pages, action-panel maps, caption boxes, halftone energy, clean sound-effect typography
• French new wave movies: poster style, stark typography, city route maps, jump-cut sequencing, high-contrast editorial photography cues
• WWII propaganda posters: home-front public-information poster language, logistics arrows, ration charts, mobilization maps, bold simplified figures; no real-world party symbols, hate imagery, dehumanizing slogans, or false historical claims
• Italian movie posters: hand-painted drama, bold credits, expressive color, route-map collage, 1960s or 1970s cinema energy; no direct film titles or actor likenesses
• Shakespeare: stage maps, acts and scenes, dramatis personae, royal courts, backstage cue sheets
• Greek mythology: temple diagrams, constellation routes, hero's journey maps, oracle tablets, labyrinths, ship routes
• noir detective boards: case files, red-string maps, typed evidence labels, precinct wall charts
• NASA mission-control dashboards: launch timelines, telemetry maps, orbital routes, status boards
• space exploration and astronomy: celestial atlases, observatory charts, star-field maps, orbital mechanics diagrams, planetary survey routes, telescope annotations, mission trajectories, deep-space timelines
• paintings: abstract painting, classical landscape, Remington-inspired western action painting, Rembrandt-inspired chiaroscuro, historical mural, stormy seascape, allegorical editorial painting
• classic black-and-white photography: documentary field report, newsroom archive print, editorial photo essay, street photography, high-contrast darkroom print, contact sheet, civic infrastructure photograph
• 80's action movies: practical explosions, smoky backlit warehouses, neon city streets, helicopter searchlights, mission dossiers, heroic silhouettes, high-stakes countdowns, painted ensemble posters; no direct actor likenesses, real film titles, franchise marks, or catchphrases
• alchemy manuscripts: transformation diagrams, annotated symbols, recipe-like process maps, illuminated margins
• brutalist civic planning: transit maps, concrete signage, zoning blocks, infrastructure diagrams