Codebase map · Handbook

Answer

This is every module on brew origin/main (commit b91e364, 26 Oct 2026, 862 commits) with what it owns, the tests that load it and its size, so anyone can find the file that owns a behaviour before changing it.

Today

How to read the tables:

Tests lists the files in test/ that import the module directly. "none" means no test imports it; it may still be covered through another module. Test files are named without .test.js. Paid probes (*-probe.mjs) are marked and never run in the suite. brew/test/
Size is the file size on origin/main. git ls-tree -l origin/main
The repo has 1,027 tracked files: 153 top-level modules, 9 folders of code and 4 of data. git ls-tree -r origin/main
The suite has 215 test files and about 1,355 test() calls on d6154b3, run free with AI_MOCK=1, and on GitHub Actions on every push and pull request. brew/test/ brew/.github/workflows/test.yml:1-37 Counted from source, not from a run.
Rows for db/, public/, test/, tools/, .github/ and the files the 26 Oct merge added are counted on d6154b3; the rest stay as counted on b91e364. git ls-tree -l origin/main

Folders

Folder	What it holds	Files	Size	Source
`reader/`	The read: orchestrator, stages, Ad Library fallback, product reader	17	301 KB	brew/reader/index.js:1-6
`connectors/`	Read-only accounts: Shopify, Meta, Google Ads and GA4, Klaviyo, Judge.me, Slack, marketplaces (off), the demo simulator	11	193 KB	brew/connectors/index.js:1-8
`jam2/`	Brew Studio engine (kept after the v2 screen retired): Brand Book store, rules, makers, engines, context, routes	18	381 KB	brew/jam2/studio.js:1-5 memory brew-one-stage
`db/`	Postgres pool, migrations 001 to 010, ops jobs (status, parity, import, partner copy, clean gate, reset jams, reset brand, delete brand, connector ping)	24	91 KB	brew/db/index.js:1-4 brew/db/brand-wipe.js:1-9
`pdf/`	Play PDF template, art and Chromium render	12	2.9 MB (mostly fonts)	brew/pdf/render.js
`public/`	The client: plain JS and CSS, no framework	164	4.2 MB	brew/README.md
`test/`	The suite, fixtures, paid probes	228	1.9 MB	brew/test/
`tools/`	Deploy, promote, audits, probes, resets, Slack app, sound build	28	121 KB	brew/tools/
`.github/`	One workflow, `test`: the deploy test gate on every push and pull request	1	1.6 KB	brew/.github/workflows/test.yml:1-9
`docs/`	Handover (15 Oct), production runbook, app review notes, Slack manifest, Shopify listing	52	1.9 MB	brew/docs/
`skills/`	Discipline skill files each Play is written with	258 files in 52 folders	2.4 MB	brew/moves-engine.js:1-7
`sources/moves/`	51 hand-made Arata Plays used as depth exemplars	51	part of 2.5 MB	brew/moves-engine.js:1-7
`data/`	Play specs (66), studio styles, engines, catalog, families, Sloosh tool schemas	11	506 KB	brew/moves-engine.js:28
`prompts/`	`move-house.md`, the house prompt for Plays	1	13 KB	brew/moves-engine.js:29

The biggest client files

File	Size	Lines	Source
`public/app.js`	877 KB	5,997	brew/public/app.js
`public/brew.css`	267 KB		brew/public/brew.css
`public/jam-room.js`	81 KB		brew/public/jam-room.js
`public/live.js`	61 KB		brew/public/live.js
`public/creative-stage.js`	48 KB		brew/public/creative-stage.js

No client file has a test of its own. brew/test/

Top-level modules

Module	What it owns	Tests	Size
`ai-gap.js`	One specific fix per AI-answers gap card, from what Brew already holds	ai-gap, final-ff	2.8 KB
`ai-questions.js`	The shopper questions Brew asks the AI tools, each backed by search, listening or sales evidence	ai-questions	14.7 KB
`ai-standing.js`	Where the brand and its rivals stand in AI answers (the AI answers ring and column)	ai-standing, ai-questions	8.0 KB
`ai.js`	The shared AI client: one call shape for Claude or Gemini, streaming, schemas, spend metering	cadence-probe (paid probe), build-honesty, cadence-refresh, claims, ideas-probe (paid probe), memory-probe (paid probe), moves-evidence, listen-probe (paid probe)	8.7 KB
`alerts.js`	Ops alert emails (Vertex billing and quota, AI pause, treg balance, 5xx rate, Sloosh, worker down, stuck queue), once a day each	ops-guards	8.3 KB
`apify.js`	Apify client: run one actor, read its dataset, meter spend	listen-ideas-wiring	4.3 KB
`assortment.js`	Whose products a store sells: own label, other brands or both	assortment	8.3 KB
`auth.js`	Google sign-in, brand claiming, teams, invites, views, admins and team email	claim-rules, ga4-property-guard, ops-auth-connectors, phase3-pg, security-fixes, team-seats	34.5 KB
`brand-book-read.js`	The Brand Book as the read finds it: chapters from public evidence plus one vision call	brand-book, brand-book-guards	36.8 KB
`brand-book-routes.js`	Brand Book API: view, team edits, import, refresh, ask	brand-book, brand-book-guards	31.3 KB
`brand-ctx.js`	Which brand a request, tick or job runs for (AsyncLocalStorage)	another-take, cta-make, film-board, honesty, jam-chips, jam-product-match, jam-story, job-status, landing-draft, jam-team, ops-rows, options, round2-budget, v1-studio	2.9 KB
`brand-enrich.js`	Fresh Instagram, TikTok and YouTube reads for the Brand Book, capped and saved once	brand-book	7.0 KB
`brand-kit.js`	The shared Brand Book link and kit download (brand.md, brand.json, llms.txt, kit.zip, PDF)	brand-fonts, brand-book, brand-book-guards	15.4 KB
`brand-learnings.js`	Learnings from pasted or dropped context: extract, review, then update brief, memory, cards and Plays	brand-learnings, drop-read, evidence-pulse, learned-rank, honesty, stock-and-tried	65.0 KB
`brand-memory.js`	Brand memory: a versioned markdown repo per brand with search and a consolidate pass	brand-learnings, cadence-probe (paid probe), brand-memory, channel-fit, memory-probe (paid probe), voice-pick	54.9 KB
`brand-pack.js`	Loading, caching and healing a brand pack; the viewer-specific pack	access, audit-fixes, brand-book, brand-learnings, build-honesty, cadence-probe (paid probe), community-gate, demo-mode, drafts-engagement, fact-truth, feed-gate, first-drafts, facts-desk, health, ideas-probe (paid probe), honesty, image-fallback, listen-probe (paid probe), listen-ideas-wiring, market-money, listen-wider, market, memory-probe (paid probe), lean-cadence, objects-pg, one-count, phase3-pg, live-weekly, product-match, qa-final-access, qv2-cache, qv1-storage, moves-cadence, retention-loops, read-picks, on-connect, rewrite-pot, qa-access, qv1-roles-security, stock-and-tried, stale-sweep, team-views, shopify-catalog	62.8 KB
`brew-name.js`	Heals old wording in saved data on read (the product's old name becomes Brew, soft role names)	brew-roles-soft, brew-name-address, honesty, no-skill-talk	9.3 KB
`brief-status.js`	Status of a brief sent to our team: sent, received, in progress, needs info, delivered	brief-reference, brief-staff, brief-tune-drop, jam-team, sent-time-wa	7.9 KB
`brief.js`	The brand brief every Play is written from, with quote and number checks	audit-fixes, build-honesty, on-connect	14.2 KB
`budget-match.js`	Checks a Meta budget draft against its card and the connected account	ops-rows, round2-budget	2.6 KB
`budget.js`	The day AI budget by kind, with a share per brand	finals, jobs-pg, ops-guards	6.6 KB
`build-events.js`	Build progress lines on Postgres so any instance can stream a build	jobs-pg, qv1-roles-security	2.5 KB
`build.js`	The per-brand pipeline: read, check, brief, Plays, cards, PDFs, rewrites, connect runs, resume	audit-fixes, brand-learnings, build-honesty, facts-desk, feed-gate, honesty, market, live-weekly, one-count, on-connect, qa-final-access, qa-access, qv1-roles-security, read-picks, retention-loops, qv2-cache, rewrite-pot, shopify-catalog, stale-sweep, stock-and-tried	211.3 KB
`bus.js`	Messages between instances (Postgres table plus NOTIFY)	phase3-pg	1.3 KB
`calendar.js`	Holidays and commerce dates per market, with weekly confirmation	calendar-confirmed, honesty, pulse-calendar-video	16.5 KB
`card-from.js`	The plain "From" line at the top of every card	card-from	7.0 KB
`card-nums.js`	Card counts that follow today's fact sheet	card-rules-nums, fact-truth, round2-truth	11.1 KB
`card-page.js`	The card page laid out as a decision, kept in the pack	none	10.4 KB
`card-plan.js`	A card's ground-work plan, the input to its jam	card-plan, code-blocks, jam2, plain-plumbing	20.8 KB
`cards-gen.js`	Feed cards from a finished Play: words, button, asset, fact gate	audit-server-fixes, audit-fixes, cadence-probe (paid probe), build-honesty, card-medium, card-rules-nums, cta-names, card-asset, claim-kinds, final-ff, first-drafts, creative-catalog, non-shopify, rival-ad	49.5 KB
`catalog-rank.js`	Order of products on a catalog card, best sellers first	catalog-cards	2.0 KB
`channel-fit.js`	How a card fits the channels the viewer said they run	channel-fit	8.7 KB
`claims.js`	Claims Brew cannot back: flags, copy checks, draft cleaning, the writers' claims rule	claims, fact-truth, move-load-fixes, one-stage, qa-checks, round2-claims, writer-slips	29.8 KB
`closed-gate.js`	Team-only access to a store still behind Shopify's password page	closed-store	6.9 KB
`code-md.js`	Code inside written words is kept as code	code-blocks	2.2 KB
`color-cast.js`	Removes the warm cast image models add	claims	3.6 KB
`community-gate.js`	Which public threads and communities Brew may point a brand at	community-gate, listen-wider	20.6 KB
`confirm-remind.js`	Reminders when nobody checks the read or opens the feed (3 h, then a day)	confirm-remind	11.9 KB
`counters.js`	Day counters shared by every instance (Postgres)	jobs-pg	3.7 KB
`creative-catalog.js`	What Brew can have made: formats, families, the prompt block	creative-catalog	7.3 KB
`demo-data.js`	Simulated connected-account numbers for the demo, built from the real read (Dummy)	audit-server-fixes, round2-budget	22.4 KB
`demo-mode.js`	Demo sandbox per visitor, send guard (Dummy)	demo-mode	4.1 KB
`demo-routes.js`	Demo picker, presenter controls, simulated onboarding (Dummy)	counts-one-source, final-ff, one-count	13.5 KB
`derive.js`	facts.json and config.json from the read	build-honesty, market-money, market, qa-final-access, qa-checks, sellable	10.9 KB
`digest.js`	The weekly Monday digest email and Slack post, no AI	retention-loops	20.8 KB
`draft-mocks.js`	A first draft shown where it will live (inbox, WhatsApp, page)	code-blocks, first-drafts	12.6 KB
`draft-quality.js`	The free pixel check and look judge on first drafts	draft-quality, statics-layout	10.3 KB
`drafts-bg.js`	First drafts on cards before anyone opens a jam, plus healing saved drafts	cadence-probe (paid probe), baked-words, draft-same-card, code-blocks, first-drafts, drafts-engagement, image-fallback, moves-cadence, one-stage	61.4 KB
`drafts.js`	One-tap first drafts inside a jam (image, video, voice, text)	first-drafts	39.4 KB
`drop-read.js`	Reads a dropped file (text, office, PDF, image) into text	brand-book-guards, brand-book, brand-fonts, drop-read	9.4 KB
`drop.js`	Drop anything: memory, preferences, once, references	brief-tune-drop, references	1.9 KB
`evidence.js`	The proof sheet behind every card, no AI	evidence-plain, evidence-pulse, evidence-team, watch-shelf	23.6 KB
`fact-gate.js`	Every money amount and percent on a card must be in the fact sheet	audit-fixes, facts-desk	5.8 KB
`facts-desk.js`	The fact sheet: corrections, the daily price check, one truth per viewer	connector-robust, fact-truth, facts-desk, non-shopify, one-count, round2-truth, team-views	42.5 KB
`feed-service.js`	Workspaces, card store, ranker, seats, stories, watchers, the jam and brief routes, Slack in	audit-server-fixes, cadence-refresh, brand-learnings, brief-tune-drop, festival-past, feed-engagement, jam-chips, qa-access, qv3-guards, one-count, storefront-v1, read-picks, team-views	340.3 KB
`festival-past.js`	Marks festival Plays as ended after the date	festival-past	2.3 KB
`film-board.js`	The founder storyboard for a film brief	film-board	4.8 KB
`finals-routes.js`	Make the final routes: sheet, quote, make, revise	finals-routes	35.0 KB
`finals.js`	Finals on Sloosh with a Gemini fallback; quote first, never paid twice	finals	42.7 KB
`font-meta.js`	Reads family, weight and style from a font file	brand-fonts	5.1 KB
`for-us.js`	The "For us" line ending every rival and news story	final-ff, stories-for-us	2.8 KB
`fx.js`	Converts USD figures into the brand's currency	market-money	2.6 KB
`gemini-client.js`	Gemini on Vertex behind the Anthropic client shape; price table	gemini-client	8.6 KB
`gen-store.js`	Generated media copied to the bucket and served from /gen/	another-take, cadence-probe (paid probe), cta-make, job-status, landing-draft, make-claim, image-fallback, v1-studio-sets, v1-studio, video-finish	4.4 KB
`handoff.js`	The jam hand-off text and the signed read-only /h/ page	access, honesty	25.2 KB
`health.js`	Store health rings scored from public data	ai-ring-one-check, build-honesty, health-speed, health, one-count, shopify-catalog	18.3 KB
`http-zip.js`	Brotli or gzip on text answers over 1 KB, off the main thread	qv2-http	3.4 KB
`ideas.js`	The ideas stream: ready-to-post social ideas with real places to post	community-gate, listen-wider, ideas-probe (paid probe), team-views	66.3 KB
`image-guard.js`	Checks every generated picture shows the right product; look judge wiring	draft-quality, drafts-engagement, image-fallback, img-norm, image-guard	15.0 KB
`img-norm.js`	Normalises pictures for models (format, flattening on white)	draft-quality, img-norm	6.9 KB
`impact.js`	Projected impact range for a change version, never a promise	jam-chips	9.2 KB
`instance.js`	One random id per process	qv1-roles-security	0.3 KB
`jam-answer.js`	Jam chat answers that never make a version by accident	jam-answer, round2-claims	7.9 KB
`jam-brief.js`	The jam brief document, its edits, ship and freeze (BR-n)	brand-learnings, card-plan, brief-tune-drop, final-ff, jam-answer, jam-team, jam-brief-leak	49.3 KB
`jam-mail.js`	Jam emails to the team: tags, asks, batched replies, mute links	brief-tune-drop, jam-mail	17.0 KB
`jams.js`	Team jams shared by the brand's team	jam-team, jams, qv1-storage, phase3-pg	12.5 KB
`jobs.js`	The Postgres job queue	jobs-pg, qv1-roles-security	8.6 KB
`learn.js`	Version graph and taste learning for the jam loop	another-take, brand-memory, cta-make, jam-team, landing-draft, options, v1-studio	18.3 KB
`legal-pages.js`	Privacy, Terms and the 404 page	qa-access	6.2 KB
`listen-watch.js`	Listening: what people say about the brand, rivals and category across sources	listen-ideas-wiring, listen-probe (paid probe), listen-namesake, listen-signals, watch-shelf	111.1 KB
`live-watch.js`	Catalog watcher (3 h) and the weekly AI-answers check	cadence-refresh	25.1 KB
`mail-layout.js`	One layout for every Brew email	brief-tune-drop	6.7 KB
`market-pulse.js`	Weekly market numbers: shelves, marketplaces, traffic, trends	pulse-calendar-video, watch-shelf	45.6 KB
`market.js`	Where a brand sells, apart from where it is registered	market, non-shopify, qa-access	17.9 KB
`measure-families.js`	Action families and how each is judged (measurement is cut; used for impact and copy)	jam-coverage, measure-families, moves-evidence	23.0 KB
`measure-spec.js`	How we measure it, from the brief (cut feature, kept code)	none	9.6 KB
`measure-stats.js`	Result maths for launches (cut feature, kept code)	measure-stats	10.8 KB
`media.js`	Draft media chains: image, video, voice, with fallbacks	media-chain	5.8 KB
`member-ctx.js`	Who acts on a workspace, per request	private-leaks, security-fixes, team-seats	4.3 KB
`member-tuning.js`	Your feed: per-member weights, topics, notes, ignored signals	drop-read, feed-engagement, brief-tune-drop, setup-answers	14.0 KB
`memory-routes.js`	Brand memory routes	access, brand-memory	3.4 KB
`model-ctx.js`	The composer's model pick for one request	none	1.1 KB
`move-index.js`	Rebuilds the Play index (Move 00) at load	move-load-fixes	3.2 KB
`move-label.js`	How a Play number is said to a person	final-ff, move-label, pdf-cover	2.9 KB
`move-tidy.js`	Tidies saved Plays at load, nothing written back	move-tidy	4.7 KB
`moved.js`	Which site is a brand's home (MOVED_TO_PROD, STAGING_HOME)	moved	4.7 KB
`moves-cadence.js`	Weekly listening and automation Plays (1001 and up)	audit-fixes, cadence-probe (paid probe), brand-learnings, moves-cadence, shopify-catalog, team-views	71.6 KB
`moves-engine.js`	Writes, verifies and fixes each Play; the index; the scheduler	audit-fixes, build-honesty, move-cites, moves-evidence	77.9 KB
`moves.js`	A brand's Play documents and passages	honesty	3.9 KB
`notes.js`	Margin notes on cards	final-ff, notes	6.4 KB
`objects.js`	Stored objects: Postgres rows, parted documents, bucket mirror and read-through	objects-pg, qv2-cache, qv1-storage, qv1-roles-security, retired-pg, partner-copy-pg, phase3-pg	19.5 KB
`on-connect.js`	What a connected account changes: team view, baselines, health readings	on-connect, ops-guards	8.0 KB
`ops-rows.js`	Ad account change rows name real campaigns	ops-rows	7.1 KB
`pack-numbers.js`	One number, one source for headline counts	build-honesty, honest-copy, move-cites, non-shopify, one-count, qa-access	19.9 KB
`plain.js`	Plain-word rewrite of every card, numbers checked in code	claim-kinds, final-ff, evidence-plain, move-label, plain-plumbing, private-leaks, plain	20.7 KB
`presence.js`	Who is in a jam right now	none	2.7 KB
`product-name.js`	The product's public name in one constant, `PRODUCT_NAME`, still "Brew", and the head script that hands it to the browser; a rename is one line	product-name, and imported by the email, page and Slack modules	0.8 KB
`product-match.js`	Which product a piece of copy is about	card-asset, draft-quality, drafts-engagement, film-board, jam-product-match, jam2, jam-story, product-match, sellable	12.4 KB
`proof-logic.js`	Whether the proof proves the claim	claim-kinds, evidence-pulse, evidence-team, plain-plumbing, proof-logic	22.1 KB
`publish-pack.js`	The publish pack zip per change version	code-blocks, film-board, jam-chips, jam-closeout, v1-studio	31.0 KB
`publish-ready.js`	Ready to publish: parts, limits and the final check	jam-closeout, v1-studio, video-finish, v1-studio-sets	17.0 KB
`recap.js`	The Recap ring: what happened since your last visit	recap	9.0 KB
`references.js`	Brand references uploaded for the generators	jam2, references	7.9 KB
`refresh.js`	Keeping Plays current: material changes, triage, rewrite	audit-fixes, live-weekly, stock-and-tried	11.8 KB
`remix.js`	The studio and jam engine: changes, versions, makes, packs, CTA makes	another-take, card-medium, card-action-map, card-plan, cta-names, cta-make, listen-ideas-wiring, jam-product-match, jam-story, job-status, jam-team, landing-draft, one-stage, options, plain-plumbing, ops-rows, recipe-keys, v1-studio	305.1 KB
`research.js`	Story rings and watcher research (ads, trends, news, how-to, viral)	cadence-refresh, stories-fallback, stories-life	62.4 KB
`retire.js`	One live revision on bucket deploys; brand wipe markers	retired-pg, retire	4.8 KB
`rewrite-pot.js`	The weekly rewrite budget per brand and its order	market, rewrite-pot, stale-sweep	5.5 KB
`rival-ad.js`	Make our version of a rival ad: read how it is made, then remake	rival-ad	15.5 KB
`roles.js`	ROLE, the background lease, leaderOnly	lease-child (paid probe)	3.0 KB
`safe-path.js`	Keeps file paths inside public/ or a pack	safe-path	0.6 KB
`same-ask.js`	One card per ask across Plays	round2-truth, same-ask	12.0 KB
`seed-template.js`	The seed for a generated brand; CTA names; connectors per platform	card-action-map, card-plan, cta-names, font-name, honesty, qa-final-access, non-shopify	22.3 KB
`server.js`	Boot, env, timers, the request chain, builder proxy, shutdown	none	142.2 KB
`sessions.js`	Revocable sign-in sessions (Postgres)	phase3-pg, qv1-roles-security	4.0 KB
`shared-doc.js`	Merging a document several instances change at once	shared-doc-merge	7.0 KB
`shelf.js`	Quick-commerce shelves and marketplace listings, read from outside	watch-shelf	15.0 KB
`shopify-app.js`	The public Shopify app: install, embedded pages, webhooks	closed-store, shopify-embed-pdf, shopify-catalog, shopify-app	29.2 KB
`slack-routes.js`	Slack events and buttons, signed	slack-relay, slack	8.5 KB
`sloosh-auth.js`	Brew's Sloosh workspace connection (OAuth 2.1, PKCE)	sloosh-mcp	9.4 KB
`sloosh-mcp.js`	Sloosh MCP client over HTTP	sloosh-mcp	19.2 KB
`sloosh-prompt.js`	One brief for every picture and clip, drafts and finals	finals-routes, rival-ad, sloosh-prompt, statics-layout, veo-reel-clean	27.9 KB
`sloosh-spaces.js`	Which Sloosh Space fits a creative family	finals	13.2 KB
`small-page.js`	Small server pages (invite, access, email settings)	none	2.0 KB
`social-feed.js`	Listening and ideas as cards; their background scheduler	community-gate, listen-ideas-wiring, listen-wider, listen-signals, non-shopify, qv1-roles-security, team-views	47.9 KB
`source-health.js`	Success rate of every treg and Apify source	watch-shelf	4.1 KB
`stat-check.js`	A Play cover number must mean what its label says	stat-check	6.1 KB
`statics.js`	Static Meta ads from Play 21, words set in real type	claims, ops-guards, statics-layout, team-views	13.9 KB
`store-facts.js`	What a store is on any platform	none	2.3 KB
`store.js`	Workspace persistence (tagged Maps and Sets)	objects-pg, phase3-pg, qv1-storage, store-flush	7.9 KB
`studio.js`	Families, fields and knobs for every kind of change	audit-server-fixes, card-action-map, card-plan, jam-closeout, jam-story, jam-chips, jam-product-match, film-board, listen-ideas-wiring, one-stage, ops-rows, round2-budget, ui-audit-r3, writer-slips	89.9 KB
`team-brief.js`	The team brief per deliverable, its recipients, PDF and AI edits	team-brief	29.6 KB
`text-check.js`	Spelling check of on-screen words in video finals	text-check	5.4 KB
`text-fit.js`	Shared wording rules: sentence case, one-take wording	audit-server-fixes, plain-plumbing, title-case, ui-audit-r3	11.7 KB
`treg-map.js`	Every outside capability declared once; health-first routing	treg-map, watch-shelf	22.4 KB
`treg.js`	The shared treg client: cache by signal, metering, day cap	ideas-probe (paid probe), listen-probe (paid probe), pulse-calendar-video, treg-cache	11.3 KB
`value.js`	Play grades (impact, confidence, effort) and card value	feed-engagement, same-ask, value	6.8 KB
`vault.js`	Encrypted connector secrets, refresh, protected-connection guard	connector-robust, ops-auth-connectors, phase3-pg, partner-copy-pg, private-leaks, qv1-roles-security	5.3 KB
`vertex-media.js`	Veo video and Gemini voice on Vertex	veo-reel-clean	7.9 KB
`video-finish.js`	Captions, burn-in, cover and GIF for a finished video	video-finish	12.7 KB
`video-read.js`	Scene-by-scene read of a short video	pulse-calendar-video, video-read-youtube	18.5 KB
`viral-gate.js`	Which viral videos may be remade	viral-gate	5.6 KB
`viral.js`	Weekly viral video finder	viral-gate	9.1 KB
`watch-view.js`	The What Brew watches page	watch-shelf	12.4 KB

reader/

Module	What it owns	Tests	Size
`reader/index.js`	The read orchestrator: stages, deadlines, one retry, heal of saved reads	assortment, audit-fixes, build-honesty, qa-access, reader-retry, site-walk, shopify-catalog	32.7 KB
`reader/products.js`	Product URLs and product data on any platform	assortment, non-shopify	18.4 KB
`reader/util.js`	Fetcher, safeFetch, ledger, slug, helpers	honesty, non-shopify, shopify-catalog	15.5 KB
`reader/adlib.js`	Free headless Ad Library fallback (`adCall`)	adlib-fallback	6.1 KB
`reader/closed.js`	"Not checked: behind Shopify's password page"	shopify-catalog	0.8 KB
`reader/svg-logo.js`	Inline SVG logos	svg-logo	1.3 KB
`reader/stages/open.js`	Open the store: platform, market, pages, headless Shopify	market, non-shopify	23.9 KB
`reader/stages/brand.js`	Logo, colours, fonts, one-liner	font-name, non-shopify, read-picks, svg-logo	13.6 KB
`reader/stages/catalog.js`	The catalog (`CATALOG_V` 2)	non-shopify, read-picks	20.5 KB
`reader/stages/reviews.js`	Reviews on site and marketplaces (`REVIEWS_V` 2)	non-shopify	36.0 KB
`reader/stages/ads.js`	Own and rival Meta ads, rivals (`ADS_V` 5)	build-honesty, read-picks, shopify-catalog, reader-retry	32.1 KB
`reader/stages/site.js`	Checkout walk, tags, PageSpeed (`SITE_V` 4)	site-walk	42.3 KB
`reader/stages/answers.js`	AI answers, category, the one-liner	build-honesty, non-shopify, reader-retry	21.3 KB
`reader/stages/socials.js`	Instagram, YouTube, the Films card (`SOCIALS_V` 2)	socials-search	13.0 KB
`reader/stages/company.js`	Founders, founding, funding, press (`COMPANY_V` 3)	none	6.6 KB
`reader/stages/named.js`	Whether AI answers name the brand	named-stage	3.9 KB
`reader/stages/admin.js`	A closed store read from the Shopify Admin API	closed-store, shopify-catalog	12.8 KB

connectors/

Module	What it owns	Tests	Size
`connectors/index.js`	Connect, sync cadence, backoff, stale rules, protected guard, routes	connector-robust, ga4-property-guard, honesty, ops-auth-connectors, phase3-pg, private-leaks, qv1-roles-security, security-fixes, team-views	59.6 KB
`connectors/common.js`	Card and ledger shapes, `realRows`, backoff	connector-robust, jam-chips, honesty, meta-connector	8.9 KB
`connectors/shopify.js`	Shopify Admin API 2026-04, read only	shopify-own-app, shopify-sync	33.2 KB
`connectors/meta.js`	Meta Marketing API, Graph v26.0, read only	connector-robust, meta-connector, ops-auth-connectors, round2-budget	36.8 KB
`connectors/google.js`	Google Ads and GA4 (OAuth or service account)	honesty, ops-auth-connectors	24.8 KB
`connectors/klaviyo.js`	Klaviyo by read-only key	security-fixes	5.4 KB
`connectors/reviews.js`	Judge.me by OAuth or token	honesty	6.9 KB
`connectors/slack.js`	Slack posting and channel join; never evidence	slack	5.3 KB
`connectors/market.js`	Marketplaces (switched off)	none	7.0 KB
`connectors/sim.js`	Simulated accounts for the demo (Dummy)	demo-mode	5.1 KB
`connectors/protected.js`	`PROTECTED_CONNECTIONS`, default `arata-in`	none	0.4 KB

jam2/

Module	What it owns	Tests	Size
`jam2/routes.js`	`/api/jam2` routes: Studio make, ask, slide, sketch; v2-only routes still mounted	jam2, make-claim, one-stage, v1-studio-sets	73.1 KB
`jam2/make.js`	The make layer: writer, cut-out, scene, type, priced edits	draft-quality, jam2	72.8 KB
`jam2/studio.js`	Brew Studio: style library, defaults, plan, make, price gate	first-look, jam2, one-stage, setup-tab, v1-studio, v1-studio-sets	53.6 KB
`jam2/brandbook.js`	The Brand Book store and its views by scope	brand-fonts, brand-book, brand-book-guards, rules	38.0 KB
`jam2/creative.js`	Art direction, product-locked shoot, critic, layout, extend	jam2	33.5 KB
`jam2/engines.js`	Partner adapters: Vertex, Sloosh, Higgsfield, local	none	19.7 KB
`jam2/catalogue.js`	Recipes and sizes; the button-to-board map	jam2, v1-studio-sets	19.1 KB
`jam2/ready.js`	Ready-to-post links, signed	none	11.3 KB
`jam2/core.js`	The v2 jam model and `publicView`	jam2, meta-connector	10.9 KB
`jam2/rules.js`	The Brand Book rules chapter	rules	9.8 KB
`jam2/context.js`	What the Studio composer arrives with, and why	setup-tab, v1-studio	9.6 KB
`jam2/higgsfield.js`	Higgsfield API client	jam2	8.7 KB
`jam2/profiles.js`	Cast and place profiles	none	6.3 KB
`jam2/store.js`	Studio jam storage (`jams-v2.json`)	jam2	5.1 KB
`jam2/make-claim.js`	One paid make per board across instances	make-claim	3.5 KB
`jam2/slots.js`	Posting time slots	jam2	2.6 KB
`jam2/ingredients.js`	Product ingredients helper	none	2.2 KB
`jam2/cutout-worker.js`	Background removal in a worker thread	none	1.0 KB

db/

Module	What it owns	Tests	Size
`db/index.js`	Pool, LISTEN connection, `q`, `tx`, statement timeout	jobs-pg, make-claim, objects-pg, phase3-pg, qv2-cache, qv1-roles-security, qv1-storage, retired-pg	3.9 KB
`db/migrate.js`	Runs `db/migrations/*.sql` in order	same as above	1.9 KB
`db/prod-clean.mjs`	The production clean gate	none	9.9 KB
`db/partner-copy.js`	Copy a partner from staging to production	partner-copy-pg	14.7 KB
`db/migrate-to-prod.mjs`	Entry for the partner copy job	none	4.0 KB
`db/import-bucket.mjs`	Import bucket objects newer than their row	none	5.2 KB
`db/parity.mjs`	Bucket and database parity check	none	3.0 KB
`db/reset-jams.mjs`	Jam-only reset on Postgres	none	6.0 KB
`db/brand-wipe.js`	What a brand reset or a data request deletion removes, the partner and protected guards, the dry run, the sweep, the audit row	brand-wipe-pg	23.3 KB
`db/wipe-cli.js`	Shared start of the two brand tools: arguments, database, bucket, stop marker	brand-wipe-pg	2.3 KB
`db/reset-brand.mjs`	One brand back to a fresh first run, connections kept	brand-wipe-pg	1.1 KB
`db/delete-brand.mjs`	A data request: all of a brand's data, one `data_deletions` row kept	brand-wipe-pg	1.2 KB
`db/status.mjs`	Connection states and table sizes	none	2.9 KB
`db/connector-ping.mjs`	Read-only check that connectors still read	none	2.6 KB

pdf/

Module	What it owns	Tests	Size
`pdf/template.js`	The Play PDF layout	brew-roles-soft, move-cites, pdf-cover	26.0 KB
`pdf/render.js`	Chromium render to PDF	first-drafts, move-tidy, video-finish	7.9 KB
`pdf/brand-art.js`	Cover art from the brand	none	5.3 KB

Tomorrow

Item	Version	Tag
This map, regenerated from origin/main by a script on every handbook update	v1	New
`measure-families.js`, `measure-spec.js`, `measure-stats.js` (measurement is cut)	v2	Changes: keep only what impact and copy use, delete the rest
`jam2/` v2-only routes (boards, concept, approve, `/p`, `/brief`)	v2	Goes, once no shared v2 links are in use
`feed-service.js` (348 KB), `remix.js` (312 KB), `build.js` (216 KB), `public/app.js` (875 KB)	v3	Changes: split by area
A test for every module marked "none" that holds logic (`company.js`, `engines.js`, `ready.js`, `prod-clean.mjs`)	v2	New

How we do it

Before changing a behaviour, find its owner here, then read the module's first comment on origin/main:

git -C /Users/param/Documents/ChatGPT/brew show origin/main:<path> | head -20

Find which tests load a module:

git -C /Users/param/Documents/ChatGPT/brew grep -l "<module>.js'" origin/main -- test/

A new top-level module is copied into the image by COPY *.js automatically; a new folder must be added to the Dockerfile and to the folder check in deploy.sh. brew/Dockerfile brew/deploy.sh:10
deploy.sh runs node --check on root, db/, reader/, connectors/, pdf/ and public/ files, but not jam2/. brew/deploy.sh:8

Numbers

Metric	Definition	Where measured
Modules with no direct test	Top-level and folder modules no test imports	This page; 13 such modules today (Proposed to track)
Largest file	Size of the largest server file	`git ls-tree -l`; `feed-service.js` 340 KB
Test files and tests	Files in `test/` and `test()` calls	209 files, about 1,314 calls

Open

Should the big four files be split before v2? Proposal: split feed-service.js first (feed, jam routes, Slack in), one area per week, each behind the existing tests.
Should jam2/ be renamed now that the v2 screen is gone? Proposal: rename to studio/ in v2 with the v2-only routes removed in the same change.

Source file content/engineering/codebase-map.md · For agents: Markdown · JSON