Development setup

Windgram is one repository with Python 3.12+, a pnpm workspace, the npm package, generated scenarios, and an Astro/Starlight site. Read AGENTS.md before changing any layer.

Install from a clean clone

Terminal

corepack enable
pnpm install --frozen-lockfile
uv sync --project pipeline

The root packageManager pin selects pnpm; the root lockfile governs both site/ and toolkit/. pipeline/uv.lock governs Python. Do not hand-edit either lockfile.

Run the repository gates

The complete check gate — scenario check, Python suite, package tests and typecheck, site check and build — is maintained in the repository’s CONTRIBUTING.md. Use Tests by change for focused feedback first.

Edit the authority

Every change edits an authoritative input and regenerates its outputs with the owner command. The authority table and the list of generated files that are never hand-edited are maintained in CONTRIBUTING.md.

Keep working notes in gitignored notes/. Research records dated findings; reference records verified provider facts.