// Generate Gradient News & Observer assets (banners, front pages, prompt experiments) by dispatching to the right newspaper script. Usage `/newspaper <asset-type> [args]` where asset-type is `banner`, `front-page`, or `prompt-experiment`.
| name | newspaper |
| description | Generate Gradient News & Observer assets (banners, front pages, prompt experiments) by dispatching to the right newspaper script. Usage `/newspaper <asset-type> [args]` where asset-type is `banner`, `front-page`, or `prompt-experiment`. |
Single entry point for all Gradient News & Observer image assets. Routes to the underlying script based on the asset type.
/newspaper <asset-type> [args]
Asset types:
banner — single wide masthead-style banner (e.g. CALL TO ARMS recruiting header). Handled below.front-page — full ten-section newspaper front page from real game events. Hands off to /news-front-page — invoke that skill directly instead.prompt-experiment — sweep prompt variants for front-page rendering. Calls news-front-page-prompt-experiment (see src/gradientbang/newspaper/scripts/prompt_experiment.py for flags).If the user passes an unrecognized asset type, list the three options above and stop — do not guess.
artifacts/artifacts/ is gitignored. Both copy markdown and rendered PNGs live there. Subdirectories per asset type:
artifacts/banners/artifacts/gradient-news-observer-regions/ (front-page composited)artifacts/gradient-news-observer-images/ (front-page one-shot)A banner is a single wide image with one dramatic headline + short body + call-to-action. Used for recruiting drives, special-edition broadsides, channel headers, etc.
Required inputs:
CALL TO ARMS)Pilots Wanted to Test the Combat Rework)Join the test → #gradient-bang)Optional:
THE GRADIENT NEWS & OBSERVER · SPECIAL EDITION)If the user's prompt only gives you a topic ("call to arms for combat rework"), draft kicker/headline/subhead/body/CTA yourself in the newspaper's voice and confirm with the user before rendering — image-edit calls take ~2 minutes and cost real money.
Write to artifacts/banners/<slug>.md using this exact structure (each line on its own line, blank lines between blocks). Every visible word in the file is rendered verbatim — no extra hidden formatting.
<KICKER>
<HEADLINE>
<Subhead>
<Body sentences.>
<Call to action>
Keep total visible word count under ~50 — banners get cramped fast. If body runs long, trim it.
set -a && source .env.bot && set +a
uv run news-banner --copy-file artifacts/banners/<slug>.md
.env.bot because that's where OPENAI_API_KEY lives in this repo (the script also auto-loads it from .env if present).2048x1024 (clean 2:1 banner). For wider Discord-banner shapes, append --size 2880x1024. Both dims must be multiples of 16; max edge 3840; max ratio 3:1.--reference src/gradientbang/newspaper/assets/references/full-page-style-fri-sat-pt.png.--force to overwrite an existing PNG with the same name.Read the generated PNG so the image is visible in chat, then summarize with the artifact path. The user reviews and either accepts, edits the markdown and re-renders, or asks for a fresh take (image-edit isn't deterministic — same input can produce a different layout).
Don't replicate the front-page logic here. Tell the user:
Front pages are a different animal — they pull real game events into a structured digest, then render a 2160×3840 ten-story page. Use
/news-front-page [duration](e.g./news-front-page 24h).
If they explicitly want to re-render an existing markdown front page without regenerating the digest, they can call news-front-page-image --front-page-md <path> directly.
This is a power-user tool for sweeping prompt variants. Run with --help first to surface the flags, then construct the right command for the user's question:
uv run news-front-page-prompt-experiment --help
artifacts/ for copy and outputs. Don't write under src/ for one-off banners.Deploy the BYOA wake-receiver Vercel Function from `deployment/vercel/`. Reads `.env.byoa`, pushes the operator's required env to the Vercel project, deploys via `npx vercel`, health-checks the URL, logs the operator in, and registers the resulting alias as the ship's `source_url` via `ship_byoa_configure`. Picks up from `/byoa-link` (which claims the ship and writes `.env.byoa`). Usage `/byoa-deploy-vercel [env]` (env defaults to `prod`; `live` is an accepted synonym for `prod`).
Onboard a Gradient Bang operator to run a Bring-Your-Own-Agent (BYOA) — logs in with email/password, claims a corp ship as BYOA, generates a per-ship wake secret, and writes `.env.byoa` for the `uv run byoa` CLI. Usage `/byoa-link [env]` (env defaults to `prod`; `live` is an accepted synonym for `prod`).
Release a Gradient Bang corp ship from BYOA — logs in with email/password (or reuses a JWT), nulls the ship's stored `source_url` and `wake_secret` via `ship_byoa_configure { action: "set" }`, then calls `{ action: "clear" }` to null `byoa_owner_character_id`. Frees the ship completely for someone else to claim. Inverse of `/byoa-link`. Usage `/byoa-unlink [env]`.
Create a new game character with optional custom ship, credits, onboarding skip, and bulk contract completion. Usage `/character-create [env] <name> <email> <password> [credits <N>] [ship <type>] [skip-onboarding] [complete-contracts]`.
Bump the project version (major/minor/patch), update CHANGELOG.md, and tag the release. Usage `/release <major|minor|patch>`.
Generate a Gradient News & Observer newspaper front page for a time window. Pulls game events into a structured digest, writes ten illustrated story ledes (7 straight news + 2 gossip + 1 market box) into a markdown file, then renders a 2160x3840 newspaper front-page PNG. Usage `/news-front-page [duration]` (default `24h`; e.g. `1h`, `6h`, `7d`).