tobogganSe connecter

packages

The Louise packages, each released on its own

Clone avec HTTPS, un jeton personnel en mot de passe, ou avec SSH, une clé ajoutée dans vos paramètres.

25 lignes · 1690 octetsBrut · Historique

AGENTS.md

How an agent (opencode, Claude Code, …) works on the Louise packages.

Branches and pull requests

  • Work on a branch, in a worktree of your own (.worktrees/<name>), and never push to main.
  • Open a pull request (tob pr create; a draft while it still moves, tob pr draft), and merge it when its run is green. A pull request checks the packages it touches and those depending on them (scripts/affected.sh); main and the nightly check them all.

Check locally first

  • While editing: louise check --deny-warnings and louise test (and louise test --native) in the package's directory.
  • Before pushing: scripts/ci.sh, which runs what the pull request will.
  • LOUISE_PG_URL (a PostgreSQL) runs the live tests of postgres, eventsourcing and throttle, which skip without it.

Versions and releases

Each package is released on its own (ADR 0088 of louise-lang/louise): docs/releasing.md.

  • A change that will be released bumps the package's version and adds its entry to the package's CHANGELOG.md, in the same pull request.
  • A package raises a dependency's minimum only when it needs something from that newer version, so apps are not forced up for nothing.
  • A breaking change starts a new line: the minor version while in 0.x (0.21 → 0.22), the major from 1.0.
  • Requirements are written ~> 0.Y.Z while in 0.x.
  • Every path dependency under [dependencies] has a version (scripts/check-manifests.sh checks it); [dev-dependencies] count only for the package's own tests.
  • The toolchain CI uses (.toboggan/actions/toolchain) is bumped after louise-lang/louise's compatibility run passes on the new compiler.