Skip to content
Theme

Release train 0.3

The first release train of Skribly: @skribly/core 0.3.0 and agent-skills 0.3.0, with @skribly/ui following in a later train, what each brings and how to upgrade.

The shared packages of Skribly now ship as a release train: one train per minor version, so the packages of the same train are known to work together. Train 0.3 is the first one. A fix inside a train moves only the package it fixes, as 0.3.1, 0.3.2 and so on.

Package Version Before
@skribly/core 0.3.0 0.2.0
agent-skills 0.3.0 0.2.14
@skribly/ui follows a later train (stays 0.1.0) 0.1.0

@skribly/ui is not part of this train: its next version waits for work on the design direction and the admin components, and it joins a later train. Until then ui 0.1.0 is the version that goes with core 0.3.0, and the sites keep the copy of the site kit they have.

Which versions belong to which train is written in compat.json in the core repository: the versions of the train, the packages that follow a later one, the ui commit each site uses, the oldest Skribly Agent and Skribly Tracker that work with the train, and the Node.js, Astro, React and Next.js versions it was tested on.

  1. @skribly/core 0.3.0 is not on GitHub Packages yet: the publish runs in the release workflow, which comes later. Until then apps keep installing core from a packed tarball in their vendor/ folder; repack it from the v0.3.0 tag with node .tools/pack-libs.mjs <app> in core. @skribly/ui stays at its 0.1.0 tarball.
  2. Once core is published, an app copies the .npmrc template of the core repository (.tools/npmrc.template), sets a token that can read packages as NODE_AUTH_TOKEN, pins "@skribly/core": "0.3.0" exactly, and uses the shared Prettier config with "prettier": "@skribly/core/prettier" in package.json instead of its own .prettierrc.json.
  3. Before migrating a database, run the database setup of the server kit again: it adds a role the new migrations need.
  4. Code that opened a transaction for work outside any organisation, such as a sign-in, moves to db.identity. Access checks pass the organisation.
  5. Run agent-skills install again, then agent-skills agent-files --prune once in each repository.

Search this site

Arrows move through the results, Enter opens one, Esc closes. Ctrl K /