docs

all articles

Fri, 25 Sep 2026

4185 words / 5 links / 0 images / 24 snippets

This is a cookbook. It is written to be unambiguous rather than elegant: copy the patterns below, adapt the names/fields, and you will produce a valid Op. If you want the conceptual model instead (why any of this exists), read [`salmon-co

Fri, 25 Sep 2026

Validating the GCP builtins against a real project

2297 words / 0 links / 0 images / 4 snippets

This is the playbook for running salmon’s Salmon.Builtin.Nodes.Gcp.* builtins against real GCP, in a sandbox you are willing to destroy. It exists because the GCP nodes’ automated tests are all Layer 0: they check the pure verdict funct

Fri, 25 Sep 2026

A Postgres pair whose primary is declared, not discovered

1211 words / 3 links / 0 images / 6 snippets

Two machines, one Postgres cluster, and a sentence that says which machine is the primary today. Changing that sentence moves the primary; nothing else does. This is SreBox.PostgresPair, the salmon-pgpair binary, and `salmon-toy-qemu-pg

Fri, 25 Sep 2026

`run serve`: convergence and supervision

8714 words / 1 links / 0 images / 31 snippets

This is a companion to howto-ops.md: where that doc covers how to write one Op, this one covers what happens to a whole graph of them once you run them through run serve instead of a one-shot run up. Read `howto-ops.

Fri, 25 Sep 2026

Salmon ops patterns

519 words / 1 links / 0 images / 1 snippets

This is a companion to howto-ops.md: where that doc is a per-primitive cookbook (how to write one node, one Op, one CLI binary), this one collects recurring shapes worth reusing across recipes — patterns that combine

Fri, 25 Sep 2026

The salmon model

1705 words / 5 links / 0 images / 5 snippets

This document describes the general, domain-independent model that lives in salmon-core — the algebraic graph, the OpGraph/Track abstractions, and the traversal semantics. Everything infra-specific (files, systemd, postgres, podman,

Fri, 25 Sep 2026

Guides

246 words / 9 links / 0 images / 0 snippets

The guides, mirrored from the repository’s resources/ directory: the model, the cookbook, run serve, the Postgres pair, the GCP playbook.

other topics