Skip to content
vicPublic

Latest commit

 

History

632 Commits

Folders and files

Repository files navigation

vix

Vic's machines, homes and dev envs in yen: a real-world yen fleet. 9 NixOS hosts, 2 macs, 2 standalone homes, 6 dev envs and 5 neovim profiles, from one tree of plain Nix files. Every table and diagram below is computed from the fleet when this file is written.

Generated file: edit modules/docs/, then run nix run .#write-files.

A tour of yen, in vix

yen has four words: kinds, scopes, aspects, sinks. Each row links to the line in vix that uses a construct.

yen in vix
yen.kinds.<k>: typed data host, guest, mac, home, user, env, vim
fields and types a ref field, opt (a default), maybe (null), listOf, enum, attrsOf: yen.lib types, is (any check), shared fields
derive: a default computed from the instance checkout: from kind and users, gpu: from the facter report
yen.<k>.<name>: an instance yen.host.frodo, yen.home.bitstream, yen.user.vic, yen.env.rustenv, yen.vim.neovim
data kinds: instances no spawns reaches channel, workspace, emacs
data as scopes: each instance gives its data to a fleet sink secret -> sops, a secret only tools read, ssh-host -> ssh-blocks
spawns: the scope tree fleet → system, host, mac, home, host → user, host → guest, system → vim, user → env
yen.aspects.<a>: one feature git, kvm-amd, hostname
at: where an aspect is active an instance, a kind, an aspect, a list: any, from many files: a union, nowhere
roles from data: a fact test, no host file names them ci-runner: a member of kit github-runner below, installer: form iso, wsl: form wsl, autoinclude: a hosts/<name>/_nixos dir
all, not, within, below, pointing, fact tests all [ vic-headless (not (within installer)) ], below guest, s: s.cpu == "amd", pointing "on" guest
sinks and their reduce merge, set, list (the default), one: one formatter per system, one: one admin per mac, elements: each value with its giver, flat: join list elements, nixos.persist: path union, hideMounts
typed sinks: of checks each element a list of secret refs, a dots path that exists, { port; what; }
forwards: a sink key names another sink os → nixos, guest nixos → host nixos, account → os, homeManager → os, persist → nixos, host secrets → nixos (sops-nix), env-packages → homeManager, nvf → packages, user unfree → machine unfree
out: flake outputs nixosConfigurations.<host>, ci.matrix, rdfPack, yen.flake
the out arg: an element reads the flake outputs, not inputs.self vic-edge wraps out.packages, ci.yml from out.checks and out.ci.matrix
a sink at: who may receive homeLinux on linux, account on machines
walls: a sink with no keys keeps elements at its scope git-ignores, nix-features, ports (to served)
args: a kind, a sink, scope { host, ... }, { env, env-packages, ... }, { scope, ... }, { primary-user, ... }
errors as data: an errors key gives error records, no throw a secret file no instance owns, a proxyJump cycle, 0 or 2+ runners on a system, frodo wipeRoot guards, ``one with two admins
yen.helpers: shared values helpers, place, sopsSecrets
flake-file: inputs per aspect vix-flake, env-rust
files: generated repo files the files sink, this README, ci.yml
graphs (yen.lib.graphs) sccs: ssh jumps, transpose, nodesOf: flake follows
invariants: Datalog over the facts invariants, runners-no-users, unique-port, follows-declared
stored queries and uKanren synthesis stored queries, portsOf, unfreeOn, freePort: a uKanren finite domain, a ports element
trust labels and the knowledge pack labels by path, rdf share (sha256), SHACL shapes
stage and change programs a change program
tests.nix: oracles over the eval result file order: reversed modules, same values, a broken mac is an error record: no outputs, negative controls, e2e: settings fingerprint vs vix

How vix uses yen

Each row is one yen capability: what it is, and the vix configuration it carries. The links point at the line.

Capability What it is How vix uses it Where
Typed fields Each field of a kind has a type. A wrong value is an error record with near. Machine facts are enums: cpu, gpu, form, desktops, layouts. Hardware aspects key on them. desktops
Derived fields (derive) A field default that the instance computes from itself. An explicit value wins. checkout for every machine with users. cpu and gpu from the facter report. checkout, cpu from facter, gpu from facter
Data kinds A kind that no kind spawns. Its instances have no scope; refs to them work. Workspaces, emacs distributions and channels are data that aspects read through refs and tree requests. workspace, emacs: a tree request
Data as scopes A data kind the fleet spawns: each instance is a scope that gives its data to a fleet sink. Each secret gives its sops data to sops, each ssh host its matchBlock to ssh-blocks. A reader takes the sink as an arg, so every read is an edge. secret -> sops, ssh-host -> ssh-blocks
Structure from data (spawns) A scope's children come from a function of the data. Each workspace becomes a microvm guest on frodo. Home nargun lives under host nargun. guests from workspaces, home on host
Walls A sink with no keys. Elements stop there and go no higher. A home under a host walls every host sink, so vic's home never changes nargun's NixOS. home walls
Aspects and predicates (at) An aspect is active where its at holds: kinds, instances, aspect refs, all, not, within, below. The tiers (vic-headless, vic-gui, vic-full, vic-secrets) gate every feature of vic. tiers
Roles from data An aspect whose at is a fact about the instance. A machine in form iso is an installer, a machine in form wsl runs NixOS-WSL: one aspect each, no host file names them. installer
Kits and assemblies A kit is data with roles and typed settings; an assembly puts machines in its roles with refs. Library kit facter gives every host its hardware report; vix kit github-runner makes bill, tom and bert bare CI runners: each host file writes one assembly. hardware, github-runner, ci-tom
Own reduce A sink reduce is any function of [ { from; value; } ]; flat is yen's. claude settings are ranked layers (rank 1 wins per key). List sinks keep first-seen order (yen.lib.reduce.flat). Permissions are sorted. layers, flat (yen.lib.reduce), sorted
one reduce Exactly one element, or an error record. The primary user of a mac and the WSL default user. Two admins are an error, not a silent pick. primary-user, wsl
entries reduce Each value comes with the scope that gave it. Ports go up to the fleet served sink with their scope. The vini tunnel forwards what runs on bitstream. served, tunnel forwards
Forwards A sink key feeds another sink, at the receiver. A user's ports feed the fleet. A guest's NixOS goes into its host's microvm.vms. ports to served, guest to host
The cycle form A component that asks the tree for data and gives 0 to n elements. The microvm host asks for its guest scopes and gives one network setup for them. vm-host
The out arg An element reads the flake outputs lazily. Release images and the CI workflow read built outputs, not inputs.self. release images
Errors as data An aspect key errors gives error records. Evaluation continues. frodo's wipeRoot guards, secret files that no instance owns, CI runner labels, sharedPkgs groups. secret-files, runner labels, shared pkgs
Autoinclude Files found by path become modules: no line in the host file. hosts/<name>/_nixos holds each machine's hardware, disko and facter report. autoinclude
Exports A scope outside any machine sends its content to a flake output. homeModules.vic: vic's headless home for other flakes. homeModules.vic
Flake inputs per aspect Each aspect declares the inputs it uses. flake.nix is generated. microvm, disko, impermanence, sops-nix and the skill inputs live with their users. microvm input
Generated files The files sink writes files and checks that they are current. README.md and the CI workflow. ci.yml
Invariants Datalog rules over the fleet's facts. A true bad atom is a violation. Guest addresses and service ports are unique, every follows names a declared input, runners have no users. unique-guest-addr, follows-declared
Stored queries and uKanren A named question with typed ref parameters on the eval result. uKanren synthesizes values that meet constraints. portsOf a machine, and freePort picks a port that no service of the host uses. portsOf, freePort
Graphs Reachability, cycles and layers over successor maps. The ssh proxyJump graph: a jump cycle is an error. ssh jumps
Trust labels Content gets the trust of the files that declare it. Files that agents write get a lower trust, so their routed elements are easy to list. labels
Knowledge pack The eval result as N-Triples with a sha256, and SHACL shapes. out.rdfPack for quipu, one snapshot per revision. rdfPack
Infra checks Facts from fleet data, compared with each built system. Hostname, keyd, nvidia, enthium and persisted directories, per host. infra
Eval cost levers Shared pkgs per channel and system; a trimmed NixOS module list. Ready for every host, off on all: enabling them needs the drvPath oracles on each host. sharedPkgs, docs off
MCP server Agents ask the fleet over stdio JSON-RPC. vic's claude sessions have the yen MCP server for this fleet. claude entry
CI gate One eval per PR: no error records, invariants ok, no undefined aspect. The yen-gate job of the generated workflow. yen-gate
Tests Checks over the eval result itself. File order changes no result; a broken varda never stops frodo. file order

Commands

nix build .#nixosConfigurations.annatar.config.system.build.toplevel
nix build '.#homeConfigurations."vic@bitstream".activationPackage'
nix run .#write-files                                # regenerate this README and ci.yml
nix build .#write-flake && ./result/bin/write-flake  # regenerate flake.nix from the flake-file sink
nix flake check                                      # includes checks.x86_64-linux."files/README.md" and yen-lean
nix eval --json .#ci.matrix                          # every CI build job: host, mac, home, devshell
nix eval --impure --json --file query.nix check.violations   # invariants: [ ] when all hold
nix eval --impure --json --file query.nix agent.counts       # scopes, edges, aspects, kinds
nix eval --impure --json --expr '(import ./query.nix).ask "aspectsOn" { place = { kind = "host"; name = "annatar"; }; }'
nix eval --impure --json --expr '(import ./query.nix).ask "freePort" { place = { kind = "host"; name = "annatar"; }; }'
nix eval --offline --impure --file tests.nix failed      # oracles: errors, check.ok, file order, laziness ([ ] when all hold)
nix run github:vic/yen#yen-mcp                       # yen's MCP server for agents, on stdio

Fleet map

Generated from yen.lib.graph: every scope under its parent. Machines and homes sit in the system they build for. [host] (mac) [[guest]] [/home/] ((user)). JSON of every view: nix build .#fleet-ir.

flowchart LR
  ne36f1c84dc["vix"]
  n6b4e7d8695["vic"]
  nd33606c1de(("vic"))
  n94d61d0980["hardware.default"]
  ndf9682bdae["ci-bill.runner"]
  na32fef99e4["hardware.default"]
  ne0ed39841a["hardware.default"]
  ncf6713c8a9["hardware.default"]
  n0dba866e60["hardware.default"]
  ne430d97d7b["hardware.default"]
  n16c80c4063["hardware.default"]
  nfd044d320d["hardware.default"]
  neffbcfab5b["ci-tom.runner"]
  n61d9a7f5cc["hardware.default"]
  n53462e9d5a["ci-bert.runner"]
  ne502837e53{{"alwaysdata-vic"}}
  nfc72728a7f{{"anthropic-api-key"}}
  nc12f227ca4{{"copilot-api-key"}}
  n388aae6f79{{"edge-token"}}
  n0d7dbf312e{{"gemini-eco-key"}}
  nb08933589a{{"gh-recover"}}
  n9f2e134521{{"groq-api-key"}}
  n371faf2a61{{"hello"}}
  n47e7a7fb73{{"nix-versions"}}
  nbb112b26aa{{"openrouter-api-key"}}
  n74b50b0a15{{"ssh-conf"}}
  nf268a123d5{{"ssh-id-ed25519"}}
  n48718be499{{"ssh-localhost-run"}}
  n0d8129898d{{"tangled"}}
  n87eb95e2d3{{"vix"}}
  n8b92c5fae0["edge"]
  nb6fc7348e9["sini"]
  nf574014018["uptermd.upterm.dev"]
  nddb99de1d4["vini"]
  ne644281c4d["vini-tunnel"]
  subgraph n06d87e0238 ["aarch64-darwin · 5 vim, 6 env"]
    n5d9e0bf5cd("bert")
    n8e6e1f9b07("varda")
    nec8f59f374(("vic"))
  end
  subgraph nf9ae36c71f ["aarch64-linux · 5 vim, 6 env"]
    n59fccb4cd2["bill"]
  end
  subgraph n20b0641acf ["x86_64-linux · 5 vim, 6 env"]
    n553af78083[/"bitstream"/]
    nda273604d9(("vic"))
    n1215b98ec2["annatar"]
    n405257fc13(("vic"))
    nc9f630977d["bombadil"]
    n837b46d83d(("vic"))
    ne8d834b0f9["frodo"]
    nfcf2d059ce[["dnx"]]
    n0e86b0ab44(("vic"))
    nafd4034eeb[["gen"]]
    n81f1fb0a63(("vic"))
    n7a151fee62(("vic"))
    n1bcd475538["mordor"]
    nbf37496081(("vic"))
    n1a4e8f29c9["nargun"]
    n51cd4b7649[/"nargun"/]
    nbc1297a7db(("vic"))
    n1e367d0fe0(("vic"))
    n0a070eccb1["nienna"]
    nad3e720351(("vic"))
    n82fefbe606["smaug"]
    n6cdabf95ce(("vic"))
    n42c29cbace["tom"]
  end
  ne36f1c84dc --> n6b4e7d8695
  n6b4e7d8695 --> nd33606c1de
  n553af78083 --> nda273604d9
  n1215b98ec2 --> n94d61d0980
  n1215b98ec2 --> n405257fc13
  n59fccb4cd2 --> ndf9682bdae
  n59fccb4cd2 --> na32fef99e4
  nc9f630977d --> ne0ed39841a
  nc9f630977d --> n837b46d83d
  ne8d834b0f9 --> nfcf2d059ce
  nfcf2d059ce --> n0e86b0ab44
  ne8d834b0f9 --> nafd4034eeb
  nafd4034eeb --> n81f1fb0a63
  ne8d834b0f9 --> ncf6713c8a9
  ne8d834b0f9 --> n7a151fee62
  n1bcd475538 --> n0dba866e60
  n1bcd475538 --> nbf37496081
  n51cd4b7649 --> nbc1297a7db
  n1a4e8f29c9 --> ne430d97d7b
  n1a4e8f29c9 --> n1e367d0fe0
  n0a070eccb1 --> n16c80c4063
  n0a070eccb1 --> nad3e720351
  n82fefbe606 --> nfd044d320d
  n82fefbe606 --> n6cdabf95ce
  n42c29cbace --> neffbcfab5b
  n42c29cbace --> n61d9a7f5cc
  n5d9e0bf5cd --> n53462e9d5a
  n8e6e1f9b07 --> nec8f59f374
  ne36f1c84dc --> ne502837e53
  ne36f1c84dc --> nfc72728a7f
  ne36f1c84dc --> nc12f227ca4
  ne36f1c84dc --> n388aae6f79
  ne36f1c84dc --> n0d7dbf312e
  ne36f1c84dc --> nb08933589a
  ne36f1c84dc --> n9f2e134521
  ne36f1c84dc --> n371faf2a61
  ne36f1c84dc --> n47e7a7fb73
  ne36f1c84dc --> nbb112b26aa
  ne36f1c84dc --> n74b50b0a15
  ne36f1c84dc --> nf268a123d5
  ne36f1c84dc --> n48718be499
  ne36f1c84dc --> n0d8129898d
  ne36f1c84dc --> n87eb95e2d3
  ne36f1c84dc --> n8b92c5fae0
  ne36f1c84dc --> nb6fc7348e9
  ne36f1c84dc --> nf574014018
  ne36f1c84dc --> nddb99de1d4
  ne36f1c84dc --> ne644281c4d
  ne36f1c84dc --> n06d87e0238
  ne36f1c84dc --> nf9ae36c71f
  ne36f1c84dc --> n20b0641acf
Loading

Kind tree: solid edges are spawns; dotted edges are fields that refer to another kind.

flowchart LR
  ne22ac4f8aa["assembly"]
  n827e34afc1["channel"]
  n9360acf13a["emacs"]
  nfffdcd721b["env"]
  ne09dd078b0["export"]
  n0d07ea97e1["fleet"]
  n8df93cc983["guest"]
  nd265c5f895["home"]
  n91a43a88c2["host"]
  n969fdcbc29["kit"]
  n25061baf77["mac"]
  n5e4f590e9f["machine"]
  nf384c24853["member"]
  n8c182f1484["secret"]
  nd392af8b39["ssh-host"]
  n0953dd6b11["system"]
  naf777705f2["user"]
  ne5b792c758["vim"]
  n188f8ca258["workspace"]
  ne22ac4f8aa -.->|"kit"| n969fdcbc29
  ne09dd078b0 --> naf777705f2
  ne09dd078b0 -.->|"user"| naf777705f2
  n0d07ea97e1 --> ne09dd078b0
  n0d07ea97e1 --> nd265c5f895
  n0d07ea97e1 --> n91a43a88c2
  n0d07ea97e1 --> n25061baf77
  n0d07ea97e1 --> n8c182f1484
  n0d07ea97e1 --> nd392af8b39
  n0d07ea97e1 --> n0953dd6b11
  n8df93cc983 --> naf777705f2
  n8df93cc983 -.->|"channel"| n827e34afc1
  n8df93cc983 -.->|"on"| n91a43a88c2
  n8df93cc983 -.->|"system"| n0953dd6b11
  n8df93cc983 -.->|"workspace"| n188f8ca258
  nd265c5f895 --> naf777705f2
  nd265c5f895 -.->|"channel"| n827e34afc1
  nd265c5f895 -.->|"on"| n91a43a88c2
  nd265c5f895 -.->|"system"| n0953dd6b11
  nd265c5f895 -.->|"user"| naf777705f2
  n91a43a88c2 --> n8df93cc983
  n91a43a88c2 --> nd265c5f895
  n91a43a88c2 --> nf384c24853
  n91a43a88c2 --> naf777705f2
  n91a43a88c2 -.->|"channel"| n827e34afc1
  n91a43a88c2 -.->|"system"| n0953dd6b11
  n25061baf77 --> nf384c24853
  n25061baf77 --> naf777705f2
  n25061baf77 -.->|"channel"| n827e34afc1
  n25061baf77 -.->|"system"| n0953dd6b11
  n5e4f590e9f -.->|"channel"| n827e34afc1
  n5e4f590e9f -.->|"system"| n0953dd6b11
  nd392af8b39 -.->|"forwardsServedBy"| nd265c5f895
  n0953dd6b11 --> nfffdcd721b
  n0953dd6b11 --> ne5b792c758
  naf777705f2 --> nfffdcd721b
  n188f8ca258 -.->|"on"| n91a43a88c2
Loading

Sink forwarding: a dashed edge is a sink key that feeds another sink (label: the kind that declares it). A solid edge is out, labelled with the receivers that build a flake output.

flowchart LR
  ncc24ba33bb("account")
  n136fe03a6b("caches")
  n427fbcd67e("checks")
  n485f073170("ci-jobs")
  ndf6c3caaba("claude")
  nb1c46c9de4("claude-allow")
  na4a7496f4e("darwin")
  n51a9bdc0dd("devshells")
  n13cb5a8d50("dots")
  nf4212291b1("env-packages")
  n58d5fbe670("exports")
  n5d2b151b79("files")
  n9bd084e3fc("fish-functions")
  n632ce41da4("flake-file")
  nf20579bf97("formatter")
  n7743c6b24d("git-ignores")
  n6c02586eb3("homeDarwin")
  nb4d870f4dd("homeLinux")
  n105bdfb4bb("homeManager")
  nb1ac840462("infra")
  n92ad230904("jobs")
  ne192466e57("login-shells")
  n782e55e2e1("nix-features")
  na788f0f454("nixos")
  n1cfcecf848("nvf")
  na38fcc0344("os")
  nc03228363e("out")
  n81a4f97a16("packages")
  n9608c364fa("persist")
  n6c86c940a2("ports")
  n0cdc5d522d("primary-user")
  n67492a2524("runners")
  n7bec19a8d7("secrets")
  n9a71542fa0("served")
  nf5ef27f7a4("shared-pkgs")
  nf647e575c9("sops")
  ncdb3959253("ssh-blocks")
  n2306021a40("unfree")
  n4218c12206[("flake outputs")]
  nf4212291b1 -.->|"env"| n105bdfb4bb
  n105bdfb4bb -->|"vic"| n4218c12206
  n136fe03a6b -.->|"fleet"| n632ce41da4
  n427fbcd67e -->|"vix"| n4218c12206
  n485f073170 -->|"vix"| n4218c12206
  n5d2b151b79 -->|"vix"| n4218c12206
  n632ce41da4 -->|"vix"| n4218c12206
  nb1ac840462 -->|"vix"| n4218c12206
  n92ad230904 -.->|"fleet"| n5d2b151b79
  n136fe03a6b -.->|"guest"| na38fcc0344
  na788f0f454 -.->|"guest"| na788f0f454
  na38fcc0344 -.->|"guest"| na788f0f454
  n9608c364fa -.->|"guest"| na788f0f454
  n136fe03a6b -.->|"host"| na38fcc0344
  na788f0f454 -->|"annatar, bill, bombadil, dnx, frodo, gen, +5"| n4218c12206
  na38fcc0344 -.->|"host"| na788f0f454
  n9608c364fa -.->|"host"| na788f0f454
  n7bec19a8d7 -.->|"host"| na788f0f454
  n136fe03a6b -.->|"mac"| na38fcc0344
  na4a7496f4e -->|"bert, varda"| n4218c12206
  na38fcc0344 -.->|"mac"| na4a7496f4e
  n51a9bdc0dd -->|"aarch64-darwin, aarch64-linux, x86_64-linux"| n4218c12206
  nf20579bf97 -->|"aarch64-darwin, aarch64-linux, x86_64-linux"| n4218c12206
  n81a4f97a16 -->|"aarch64-darwin, aarch64-linux, x86_64-linux"| n4218c12206
  ncc24ba33bb -.->|"user"| na38fcc0344
  ndf6c3caaba -.->|"user"| n105bdfb4bb
  n6c02586eb3 -.->|"user"| n105bdfb4bb
  nb4d870f4dd -.->|"user"| n105bdfb4bb
  n105bdfb4bb -.->|"user"| na38fcc0344
  n6c86c940a2 -.->|"user"| n9a71542fa0
  n2306021a40 -.->|"user"| n2306021a40
  n1cfcecf848 -.->|"vim"| n81a4f97a16
Loading

Gates: the aspects other aspects name in at (tiers and roles), and what each one's own at reads. A dashed edge is under a not. The count is the aspects that name the gate.

flowchart LR
  n377af21273["graphical · 2 gated"]
  n62d07aff29["installer · 1 gated"]
  n489f1a3a7d["installer-base · 1 gated"]
  n4acd136661["laptop · 2 gated"]
  n89bdb1eb07["on-graphical · 3 gated"]
  ne40bbc70fd["on-trusted · 1 gated"]
  nd00631bc9e["trusted · 2 gated"]
  nb8a30fbac2["vic-editors · 1 gated"]
  n2eac2f0a06["vic-full · 9 gated"]
  n67fc7dd90e["vic-gui · 8 gated"]
  n130a7d4796["vic-headless · 40 gated"]
  n5504f43c35["vic-secrets · 2 gated"]
  nfd885d7cc3["wsl · 1 gated"]
  n5bda577d20{{"home:nargun"}}
  n10ce26b672{{"host:annatar"}}
  nd742cd629a{{"host:bombadil"}}
  n7337c9f8ea{{"host:frodo"}}
  n1f78aba788{{"host:mordor"}}
  nb8b5780427{{"host:nargun"}}
  ndcd47d0930{{"host:nienna"}}
  n3b8bd95985{{"host:smaug"}}
  n596880b4b3{{"kind guest"}}
  n8605f65baa{{"kind host"}}
  n3035c9d5f5{{"kind mac"}}
  n2986fe4f7b{{"kind user"}}
  necdfc4a2eb{{"mac:varda"}}
  nc23988abcb{{"user:vic"}}
  ne34e0a57d0{{"fact test"}}
  ne8e4c026ed{{"fact test"}}
  nb3b6c0d23e{{"fact test"}}
  n3475f654b5{{"fact test"}}
  n5ed268c2e8{{"fact test"}}
  n5bda577d20 --> n377af21273
  n8605f65baa --> n377af21273
  n596880b4b3 --> n377af21273
  ne34e0a57d0 --> n377af21273
  n3035c9d5f5 --> n377af21273
  n8605f65baa --> n62d07aff29
  n596880b4b3 --> n62d07aff29
  ne8e4c026ed --> n62d07aff29
  n8605f65baa --> n489f1a3a7d
  n596880b4b3 --> n489f1a3a7d
  nb3b6c0d23e --> n489f1a3a7d
  n8605f65baa --> n4acd136661
  n596880b4b3 --> n4acd136661
  n3475f654b5 --> n4acd136661
  n2986fe4f7b --> n89bdb1eb07
  n377af21273 -->|"within"| n89bdb1eb07
  n596880b4b3 -.->|"not within"| n89bdb1eb07
  n377af21273 -.->|"not within not"| n89bdb1eb07
  n2986fe4f7b --> ne40bbc70fd
  nd00631bc9e -->|"within"| ne40bbc70fd
  n596880b4b3 -.->|"not within"| ne40bbc70fd
  nd00631bc9e -.->|"not within not"| ne40bbc70fd
  n10ce26b672 --> nd00631bc9e
  nd742cd629a --> nd00631bc9e
  n7337c9f8ea --> nd00631bc9e
  n5bda577d20 --> nd00631bc9e
  n1f78aba788 --> nd00631bc9e
  nb8b5780427 --> nd00631bc9e
  ndcd47d0930 --> nd00631bc9e
  n3b8bd95985 --> nd00631bc9e
  necdfc4a2eb --> nd00631bc9e
  n2eac2f0a06 --> nb8a30fbac2
  n67fc7dd90e --> nb8a30fbac2
  n130a7d4796 --> n2eac2f0a06
  n62d07aff29 -.->|"not within"| n2eac2f0a06
  n130a7d4796 --> n67fc7dd90e
  n89bdb1eb07 --> n67fc7dd90e
  nc23988abcb --> n130a7d4796
  n130a7d4796 --> n5504f43c35
  ne40bbc70fd --> n5504f43c35
  n8605f65baa --> nfd885d7cc3
  n596880b4b3 --> nfd885d7cc3
  n5ed268c2e8 --> nfd885d7cc3
Loading

Routing: where aspect elements go, per sink. "Given by" counts the aspects that give to the sink; "Received at" is the kind of the scope that reduces it (the nearest ancestor-or-self with the sink).

Sink Given by (aspects) Received at Elements
homeManager 51 export, user 601
flake-file 29 fleet 222
nvf 42 vim 186
nixos 34 guest, home, host 135
dots 10 user 108
claude-allow 7 user 91
homeLinux 9 user 89
os 8 guest, home, host, mac 86
git-ignores 5 user 65
account 6 user 37
env-packages 6 env 36
unfree 7 host, user, vim 35
claude 2 user 26
ports 2 user 26
devshells 2 system 21
fish-functions 2 user 21
packages 8 system 20
ci-jobs 4 fleet 19
secrets 2 user 18
sops 1 fleet 15
nix-features 1 guest, host, mac 13
checks 6 fleet 11
caches 2 fleet, host, mac 9
darwin 6 mac 9
infra 1 fleet 9
ssh-blocks 1 fleet 5
formatter 1 system 3
jobs 3 fleet 3
runners 1 fleet 3
homeDarwin 2 user 2
primary-user 2 host, mac 2
files 1 fleet 1
login-shells 1 mac 1
out 1 fleet 1
persist 1 host 1
Routing by kind: giving kind, sink, receiving kind (edge label: elements)
flowchart LR
  nfffdcd721b["env"]
  ne09dd078b0["export"]
  n0d07ea97e1["fleet"]
  n8df93cc983[["guest"]]
  nd265c5f895[/"home"/]
  n91a43a88c2["host"]
  n25061baf77("mac")
  nf384c24853["member"]
  n8c182f1484{{"secret"}}
  nd392af8b39["ssh-host"]
  n0953dd6b11["system"]
  naf777705f2(("user"))
  ne5b792c758["vim"]
  nfecafea4bf("account")
  n597869ba2d("caches")
  nfa311da127("checks")
  naaeec8610e("ci-jobs")
  n01da8a8a21("claude")
  n609b49e5e3("claude-allow")
  n9f31ba8689("darwin")
  nb6e3584ffe("devshells")
  n1e6965b2f9("dots")
  n48083e3642("env-packages")
  n4f878ac061("files")
  n17c1e4dd11("fish-functions")
  nd64b44e53d("flake-file")
  n39dd8b6d0b("formatter")
  n18666276f9("git-ignores")
  n560bb3f3fc("homeDarwin")
  n2136d398cb("homeLinux")
  ne21a86cbf3("homeManager")
  n2f24ae0bfb("infra")
  n049462e440("jobs")
  nba6d62a856("login-shells")
  n9a8813de3c("nix-features")
  n011dfa1a2c("nixos")
  n8f39acf8bc("nvf")
  n110eb86866("os")
  ndc260b07ca("out")
  nf50db05372("packages")
  n0a8627788a("persist")
  n5636a72f85("ports")
  n85d14325e8("primary-user")
  na2447959ef("runners")
  n9835d9a75a("secrets")
  nf574a992cc("sops")
  ne3496b40d3("ssh-blocks")
  n39bc59f1cc("unfree")
  nfffdcd721b -->|"6"| naaeec8610e
  nfffdcd721b -->|"18"| nb6e3584ffe
  nfffdcd721b -->|"36"| n48083e3642
  nfffdcd721b -->|"24"| nd64b44e53d
  n0d07ea97e1 -->|"1"| n597869ba2d
  n0d07ea97e1 -->|"5"| nd64b44e53d
  n0d07ea97e1 -->|"3"| n049462e440
  n0d07ea97e1 -->|"1"| ndc260b07ca
  n8df93cc983 -->|"2"| nd64b44e53d
  n8df93cc983 -->|"2"| n9a8813de3c
  n8df93cc983 -->|"12"| n011dfa1a2c
  n8df93cc983 -->|"10"| n110eb86866
  n91a43a88c2 -->|"7"| n597869ba2d
  n91a43a88c2 -->|"9"| naaeec8610e
  n91a43a88c2 -->|"8"| nd64b44e53d
  n91a43a88c2 -->|"9"| n2f24ae0bfb
  n91a43a88c2 -->|"9"| n9a8813de3c
  n91a43a88c2 -->|"90"| n011dfa1a2c
  n91a43a88c2 -->|"50"| n110eb86866
  n91a43a88c2 -->|"1"| n0a8627788a
  n91a43a88c2 -->|"5"| n39bc59f1cc
  n25061baf77 -->|"1"| n597869ba2d
  n25061baf77 -->|"2"| naaeec8610e
  n25061baf77 -->|"8"| n9f31ba8689
  n25061baf77 -->|"2"| n9a8813de3c
  n25061baf77 -->|"10"| n110eb86866
  nf384c24853 -->|"1"| n9f31ba8689
  nf384c24853 -->|"3"| n011dfa1a2c
  nf384c24853 -->|"3"| na2447959ef
  n8c182f1484 -->|"15"| nf574a992cc
  nd392af8b39 -->|"5"| ne3496b40d3
  n0953dd6b11 -->|"8"| nfa311da127
  n0953dd6b11 -->|"3"| nb6e3584ffe
  n0953dd6b11 -->|"1"| n4f878ac061
  n0953dd6b11 -->|"6"| nd64b44e53d
  n0953dd6b11 -->|"3"| n39dd8b6d0b
  n0953dd6b11 -->|"20"| nf50db05372
  naf777705f2 -->|"37"| nfecafea4bf
  naf777705f2 -->|"3"| nfa311da127
  naf777705f2 -->|"2"| naaeec8610e
  naf777705f2 -->|"26"| n01da8a8a21
  naf777705f2 -->|"91"| n609b49e5e3
  naf777705f2 -->|"108"| n1e6965b2f9
  naf777705f2 -->|"21"| n17c1e4dd11
  naf777705f2 -->|"177"| nd64b44e53d
  naf777705f2 -->|"65"| n18666276f9
  naf777705f2 -->|"2"| n560bb3f3fc
  naf777705f2 -->|"89"| n2136d398cb
  naf777705f2 -->|"601"| ne21a86cbf3
  naf777705f2 -->|"1"| nba6d62a856
  naf777705f2 -->|"30"| n011dfa1a2c
  naf777705f2 -->|"16"| n110eb86866
  naf777705f2 -->|"26"| n5636a72f85
  naf777705f2 -->|"2"| n85d14325e8
  naf777705f2 -->|"18"| n9835d9a75a
  naf777705f2 -->|"21"| n39bc59f1cc
  ne5b792c758 -->|"186"| n8f39acf8bc
  ne5b792c758 -->|"9"| n39bc59f1cc
  nfecafea4bf -->|"37"| naf777705f2
  n597869ba2d -->|"1"| n0d07ea97e1
  n597869ba2d -->|"7"| n91a43a88c2
  n597869ba2d -->|"1"| n25061baf77
  nfa311da127 -->|"11"| n0d07ea97e1
  naaeec8610e -->|"19"| n0d07ea97e1
  n609b49e5e3 -->|"91"| naf777705f2
  n01da8a8a21 -->|"26"| naf777705f2
  n9f31ba8689 -->|"9"| n25061baf77
  nb6e3584ffe -->|"21"| n0953dd6b11
  n1e6965b2f9 -->|"108"| naf777705f2
  n48083e3642 -->|"36"| nfffdcd721b
  n4f878ac061 -->|"1"| n0d07ea97e1
  n17c1e4dd11 -->|"21"| naf777705f2
  nd64b44e53d -->|"222"| n0d07ea97e1
  n39dd8b6d0b -->|"3"| n0953dd6b11
  n18666276f9 -->|"65"| naf777705f2
  n560bb3f3fc -->|"2"| naf777705f2
  n2136d398cb -->|"89"| naf777705f2
  ne21a86cbf3 -->|"40"| ne09dd078b0
  ne21a86cbf3 -->|"561"| naf777705f2
  n2f24ae0bfb -->|"9"| n0d07ea97e1
  n049462e440 -->|"3"| n0d07ea97e1
  nba6d62a856 -->|"1"| n25061baf77
  n9a8813de3c -->|"2"| n8df93cc983
  n9a8813de3c -->|"9"| n91a43a88c2
  n9a8813de3c -->|"2"| n25061baf77
  n011dfa1a2c -->|"18"| n8df93cc983
  n011dfa1a2c -->|"3"| nd265c5f895
  n011dfa1a2c -->|"114"| n91a43a88c2
  n8f39acf8bc -->|"186"| ne5b792c758
  n110eb86866 -->|"14"| n8df93cc983
  n110eb86866 -->|"2"| nd265c5f895
  n110eb86866 -->|"59"| n91a43a88c2
  n110eb86866 -->|"11"| n25061baf77
  ndc260b07ca -->|"1"| n0d07ea97e1
  nf50db05372 -->|"20"| n0953dd6b11
  n0a8627788a -->|"1"| n91a43a88c2
  n5636a72f85 -->|"26"| naf777705f2
  n85d14325e8 -->|"1"| n91a43a88c2
  n85d14325e8 -->|"1"| n25061baf77
  na2447959ef -->|"3"| n0d07ea97e1
  n9835d9a75a -->|"18"| naf777705f2
  nf574a992cc -->|"15"| n0d07ea97e1
  ne3496b40d3 -->|"5"| n0d07ea97e1
  n39bc59f1cc -->|"5"| n91a43a88c2
  n39bc59f1cc -->|"21"| naf777705f2
  n39bc59f1cc -->|"9"| ne5b792c758
Loading

Fleet data

Aspects by machine and home (an aspect that gave an element there or to a user below)
aspect bitstream annatar bill bombadil frodo dnx gen mordor nargun nargun nienna smaug tom bert varda
["kit","facter","aspects","default"] x
["kit","github-runner","aspects","runner"] x x x
account x x x x x x x x x x x x
admin x x x x x x x x x x
ai-agents x x x x x x x x x x x x
ai-ai x x x x x x x x x x x x
ai-browser-tools x x x x x x x x x
ai-claude x x x x x x x x x x x x
ai-claude-allow x x x x x x x x x x x x
ai-claude-scripts x x x x x x x x x x x x
ai-claude-session-tools x x x x x x x x x x x x
ai-headroom x x x x x x x x x x x x
ai-herdr x x x x x x x x x x x x
ai-ircc x x x x x x x x x x x x
ai-lightjj x x x x x x x x x x x x
ai-mcp x x x x x x x x x x x x
ai-plugins x x x x x x x x x x x x
ai-skills x x x x x x x x x x x x
ai-statusline x x x x x x x x x x x x
ai-tools x x x x x x x x x x x x
ai-vic-agents x x x x x x x x x x x x
ai-vic-hooks x x x x x x x x x x x x
ai-vic-settings x x x x x x x x x x x x
ai-vic-tools x x x x x x x x x x x x
ai-vic-upstream x x x x x x x x x x x x
all-firmware x x
annatar-distro x
autoinclude x x x x x
bitstream x
bootable x x x x x x
carapace x x x x x x x x x x x x
ci-home x x x
ci-host x x x x x x x x x
ci-mac x x
cli-tools x x x x x x x x x x x x
darwin-base x
darwin-shells x x
darwin-state x x
dev-tools x x x x x x x x x x x
direnv x x x x x x x x x x x x
direnv-host x x x x x x x x x x
enthium x
fish x x x x x x x x x x x x
frodo-apps x
frodo-base x
frodo-desktop x
frodo-impermanence x
frodo-user x x x
gh-dash x x x x x x x x x x x
git x x x x x x x x x x x x
gitleaks x x x x x x x x x x x
hk-clean x x x x x x x x x x x
hm-darwin x
hm-nixos x x x x x x x x x
home-state x x x x x x x x x x x x
hostname x x x x x x x x x x x x x
infra-facts x x x x x x x x x
installer-base x
installer-user x
jujutsu x x x x x x x x x x x x
jujutsu-aliases x x x x x x x x x x x x
jujutsu-revsets x x x x x x x x x x x x
jujutsu-ui x x x x x x x x x x x x
kde-desktop x
kvm-amd x x x
kvm-intel x x x
laptop x
laptop-power x
login-shell x x x x x x x x x x x x
login-shell-darwin x
login-shell-nixos x x x x x x x x x x
macos-keys x x x x x
niri-desktop x x
nix-daemon-containment x x x x x x x x x
nix-features x x x x x x x x x x x x x
nix-features-base x x x x x x x x x x x x x
nix-settings x x x x x x x x
nix-sweep x x x x x x x x x x x
nix-tools x x x x x x x x x x x x
nix-tuning x x x x x x x x x x x x x
nixos-account x x x x x x x x x x
nixos-state x x x x x x x x x x x
no-gui-guest x x x
no-gui-home x
nvidia x x
primary-user x
primary-user-darwin x x
sec-ops x x x x x x x x
sysctl x x x x x x x x x x x
terminals x x x x x x x x
unfree x x x x x x x x x x x x x x x
vic-browsers x x x x x x x x
vic-desktop-tools x x x x x x x x x
vic-dots x x x x x x x x x x x x
vic-editors x x x x x x x x
vic-emacs x x x x x x x x x
vic-fonts x x x x x x x x x x x
vic-hm-backup x x x x x x x x x
vic-niri x x x x x x x x x
vic-nix-index x x x x x x x x x x x x
vic-nix-registry x x x x x x x x x x x x
vic-nvim x x x x x x x x x x x x
vic-nvim-gui x x x x x x x x x
vic-secrets x x x x x x x x x
vic-ssh x x x x x x x x x
vic-system x x x x x x x x x x x
vic-vscode-server x x x x x x x x
vm x x x
vm-host x
wl-broadcom x x x
workspace-share x x x
wsl x
wsl-user x
xfce-desktop x x x x x x
yen-mcp-claude x x x x x x x x x x x x

Flake inputs by aspect (the flake-file sink writes flake.nix from them):

aspect inputs
ai-herdr bun2nix, flake-parts, llm-agents, nix-systems, nixpkgs-lib, systems
ai-ircc ircc
ai-lightjj lightjj
ai-plugins caveman, claude-plugins-official, diagram-design, mattpocock, ponytail, superpowers-extended-cc-marketplace, ui-ux-pro-max-skill
ai-skills genie-agent, gstack, one-skill-to-rule-them-all, quipu
ai-vic-tools flake-utils, notebooklm-pack, rust-overlay
ai-vic-upstream deepwiki-skill, vercel-skills
autoinclude disko
channel-inputs darwin, home-manager, nixpkgs
devshell devshell
edgevpn edgevpn
emacs-inputs doom-emacs
enthium enthium
env-rust rust-overlay
files-inputs files
formatter treefmt-nix
frodo-impermanence impermanence
git nix-wrapper-modules
jujutsu flake-parts, gojo, jjui, majjit, nix-wrapper-modules, nixpkgs-lib
nix-tools trix
vic-browsers flake-utils, helium, nixpkgs-darwin
vic-editors flake-parts, nixpkgs-lib, vscode-server
vic-emacs SPC, bats-assert, bats-support, blueprint, systems
vic-nix-index nix-index-database
vic-secrets sops-nix
vim-inputs mnw, nvf
vix-flake flake-file, import-tree, yen
vm microvm
wsl nixos-wsl

CI jobs by runner (nix eval --json .#ci.matrix; ci.yml also runs one job per checks.<sys>.<name>):

runner system jobs may fail
macos-latest aarch64-darwin bert, varda varda
ubuntu-24.04-arm aarch64-linux bill
ubuntu-latest x86_64-linux annatar, bombadil, devshell-fullenv-x86_64-linux, devshell-goenv-x86_64-linux, devshell-nixenv-x86_64-linux, devshell-nodeenv-x86_64-linux, devshell-pyenv-x86_64-linux, devshell-rustenv-x86_64-linux, frodo, mordor, nargun, nienna, smaug, tom, vic@bitstream, vic@nargun

ssh hosts and jumps (yen.ssh-host, by Host match name). Jump cycles: none.

flowchart LR
  ned5e5be045["edge · 192.168.192.168"]
  nb5fc90972f["sini · bitstream.ts.json64.dev"]
  n5c712a7033["uptermd.upterm.dev"]
  n1b8eeda9fa["vini · bitstream.ts.json64.dev"]
  nc1c80ead45["vini-tunnel · bitstream.ts.json64.dev"]
  n6ac4bd5f17[("vpn.json64.dev")]
  nb5fc90972f -->|"proxyJump"| n6ac4bd5f17
  n1b8eeda9fa -->|"proxyJump"| n6ac4bd5f17
  nc1c80ead45 -->|"proxyJump"| n6ac4bd5f17
Loading

Ports per scope (the ports sink; ask "portsOf", ask "freePort"). Declared, routed nowhere: vic-vini-dashboards, vix-rdesk.

flowchart LR
  nd33606c1de(("vic@vic"))
  nda273604d9(("vic@bitstream"))
  n405257fc13(("vic@annatar"))
  n837b46d83d(("vic@bombadil"))
  n0e86b0ab44(("vic@dnx"))
  n81f1fb0a63(("vic@gen"))
  n7a151fee62(("vic@frodo"))
  nbf37496081(("vic@mordor"))
  nbc1297a7db(("vic@nargun"))
  n1e367d0fe0(("vic@nargun"))
  nad3e720351(("vic@nienna"))
  n6cdabf95ce(("vic@smaug"))
  nec8f59f374(("vic@varda"))
  n1c0ac2bba5(":8787 headroom (ai-headroom)")
  n50a78dd561(":8765 lightjj (ai-lightjj)")
  nd33606c1de --> n1c0ac2bba5
  nd33606c1de --> n50a78dd561
  nda273604d9 --> n1c0ac2bba5
  nda273604d9 --> n50a78dd561
  n405257fc13 --> n1c0ac2bba5
  n405257fc13 --> n50a78dd561
  n837b46d83d --> n1c0ac2bba5
  n837b46d83d --> n50a78dd561
  n0e86b0ab44 --> n1c0ac2bba5
  n0e86b0ab44 --> n50a78dd561
  n81f1fb0a63 --> n1c0ac2bba5
  n81f1fb0a63 --> n50a78dd561
  n7a151fee62 --> n1c0ac2bba5
  n7a151fee62 --> n50a78dd561
  nbf37496081 --> n1c0ac2bba5
  nbf37496081 --> n50a78dd561
  nbc1297a7db --> n1c0ac2bba5
  nbc1297a7db --> n50a78dd561
  n1e367d0fe0 --> n1c0ac2bba5
  n1e367d0fe0 --> n50a78dd561
  nad3e720351 --> n1c0ac2bba5
  nad3e720351 --> n50a78dd561
  n6cdabf95ce --> n1c0ac2bba5
  n6cdabf95ce --> n50a78dd561
  nec8f59f374 --> n1c0ac2bba5
  nec8f59f374 --> n50a78dd561
Loading

CI runners per system: the runner label of a system comes from the one member of kit github-runner on it (0 or 2+ is an error record); a dashed edge is a machine whose job may fail (ciBroken).

flowchart LR
  n83e49c5b41["aarch64-darwin · runs-on macos-latest · 2 jobs"]
  nd3aabeac30["aarch64-linux · runs-on ubuntu-24.04-arm · 1 jobs"]
  n6ca31a50e5["x86_64-linux · runs-on ubuntu-latest · 16 jobs"]
  n255541fcfa["bill · runner ubuntu-24.04-arm"]
  ne443ac3067["tom · runner ubuntu-latest"]
  n547d16322b("bert · runner macos-latest")
  n37e2b269f8("varda · ciBroken openspec")
  n255541fcfa -->|"runner"| nd3aabeac30
  ne443ac3067 -->|"runner"| n6ca31a50e5
  n547d16322b -->|"runner"| n83e49c5b41
  n37e2b269f8 -.->|"may fail"| n83e49c5b41
Loading
Flake input follows (28 of 56 inputs follow another)

Follows targets flake.nix does not declare (the follows-declared invariant): none.

flowchart LR
  nceaf02de88["SPC"]
  n8538c41d8e["bats-assert · 1 follow"]
  n494cd3adde["bats-support · 1 follow"]
  n1c766b8530["blueprint · 1 follow"]
  n2e10ad8779["bun2nix · 1 follow"]
  n1fc9ef0e47["darwin"]
  n1161ece077["devshell"]
  n01ef5fa359["flake-parts · 4 follow"]
  nc84fd7ddd5["flake-utils · 2 follow"]
  nd15d13c0a8["gojo"]
  n620b6c2a6c["helium"]
  n806b9d82d0["home-manager · 1 follow"]
  n22d6f8566c["impermanence"]
  n4824e2d822["ircc"]
  n82a85e43a7["jjui"]
  nd9cb64d9f8["lightjj"]
  n56d13e8ca9["llm-agents"]
  n53dd74a4f5["majjit"]
  nb9d5327945["microvm"]
  ned26e59807["mnw · 1 follow"]
  nc629217bae["nix-index-database"]
  n8e95a6029c["nix-systems · 1 follow"]
  nd698d91bfb["nix-wrapper-modules"]
  n6085c65368["nixos-wsl"]
  n413353722a["nixpkgs · 26 follow"]
  n03e01a895f["nixpkgs-darwin · 1 follow"]
  n0c993f1146["nixpkgs-lib · 1 follow"]
  n5a5cfc2d7e["notebooklm-pack"]
  nf997975173["nvf"]
  n84d0d780b0["rust-overlay · 1 follow"]
  n8aa0f57228["sops-nix"]
  n834ba7a430["systems · 2 follow"]
  n8b19eb8204["treefmt-nix · 3 follow"]
  n0f92435829["trix"]
  nc1c71d9f2b["vscode-server"]
  nceaf02de88 --> n8538c41d8e
  nceaf02de88 --> n494cd3adde
  nceaf02de88 --> n1c766b8530
  nceaf02de88 --> n413353722a
  nceaf02de88 --> n8b19eb8204
  n1c766b8530 --> n413353722a
  n1c766b8530 --> n834ba7a430
  n2e10ad8779 --> n01ef5fa359
  n2e10ad8779 --> n413353722a
  n2e10ad8779 --> n8e95a6029c
  n2e10ad8779 --> n8b19eb8204
  n1fc9ef0e47 --> n413353722a
  n1161ece077 --> n413353722a
  n01ef5fa359 --> n0c993f1146
  nd15d13c0a8 --> n413353722a
  n620b6c2a6c --> n413353722a
  n620b6c2a6c --> n03e01a895f
  n620b6c2a6c --> nc84fd7ddd5
  n806b9d82d0 --> n413353722a
  n22d6f8566c --> n806b9d82d0
  n22d6f8566c --> n413353722a
  n4824e2d822 --> n413353722a
  n82a85e43a7 --> n01ef5fa359
  n82a85e43a7 --> n413353722a
  nd9cb64d9f8 --> n413353722a
  n56d13e8ca9 --> n2e10ad8779
  n56d13e8ca9 --> n01ef5fa359
  n56d13e8ca9 --> n413353722a
  n56d13e8ca9 --> n834ba7a430
  n56d13e8ca9 --> n8b19eb8204
  n53dd74a4f5 --> n413353722a
  nb9d5327945 --> n413353722a
  nc629217bae --> n413353722a
  nd698d91bfb --> n413353722a
  n6085c65368 --> n413353722a
  n03e01a895f --> n413353722a
  n0c993f1146 --> n413353722a
  n5a5cfc2d7e --> nc84fd7ddd5
  n5a5cfc2d7e --> n413353722a
  n5a5cfc2d7e --> n84d0d780b0
  nf997975173 --> ned26e59807
  nf997975173 --> n413353722a
  n84d0d780b0 --> n413353722a
  n8aa0f57228 --> n413353722a
  n8b19eb8204 --> n413353722a
  n0f92435829 --> n413353722a
  nc1c71d9f2b --> n01ef5fa359
Loading

Secrets plan: sops file (dotted), secret, the aspect that gives it, the machine or home it lands on. Declared and deployable, but given by no aspect: none.

flowchart LR
  subgraph n6aa8ebb915 ["deploy = false: vic-sops-get, vic-sops-rotate"]
    n2cd781d649{{"alwaysdata-vic"}}
    n1bcedb7b35{{"gh-recover"}}
    nb637244e18{{"nix-versions"}}
    n7a0416d632{{"tangled"}}
    n291c5a8e91{{"vix"}}
  end
  nd725df1fa2[("modules/vic/secrets.yaml")]
  nbca667af57[("modules/vic/secrets/alwaysdata-vic")]
  nff5d6b5472[("modules/vic/secrets/edge.token")]
  n93d5399e1f[("modules/vic/secrets/gh-recover")]
  ndedcdf3336[("modules/vic/secrets/localhost_run")]
  nea472d395a[("modules/vic/secrets/mordor")]
  n71d2ef8db8[("modules/vic/secrets/nix-versions")]
  n7483a6b8c0[("modules/vic/secrets/ssh-conf")]
  n039c137e87[("modules/vic/secrets/tangled")]
  n8f4bf1501d[("modules/vic/secrets/vix")]
  n897ce13a71{{"anthropic-api-key"}}
  n0f860af1bc{{"copilot-api-key"}}
  n2f20fb82a1{{"edge-token"}}
  n94e6481eaa{{"gemini-eco-key"}}
  n92def5b605{{"groq-api-key"}}
  nce086069bf{{"hello"}}
  nd615738ff0{{"openrouter-api-key"}}
  n85aca030fb{{"ssh-conf"}}
  n0f7d24b5c9{{"ssh-id-ed25519"}}
  n618a06a457{{"ssh-localhost-run"}}
  n5504f43c35["vic-secrets"]
  n39fa9fbaa4["vic-ssh"]
  n1215b98ec2["annatar"]
  nc9f630977d["bombadil"]
  ne8d834b0f9["frodo"]
  n1bcd475538["mordor"]
  n1a4e8f29c9["nargun"]
  n51cd4b7649[/"nargun"/]
  n0a070eccb1["nienna"]
  n82fefbe606["smaug"]
  n8e6e1f9b07("varda")
  nbca667af57 -.-> n2cd781d649
  nd725df1fa2 -.-> n897ce13a71
  nd725df1fa2 -.-> n0f860af1bc
  nff5d6b5472 -.-> n2f20fb82a1
  nd725df1fa2 -.-> n94e6481eaa
  n93d5399e1f -.-> n1bcedb7b35
  nd725df1fa2 -.-> n92def5b605
  nd725df1fa2 -.-> nce086069bf
  n71d2ef8db8 -.-> nb637244e18
  nd725df1fa2 -.-> nd615738ff0
  n7483a6b8c0 -.-> n85aca030fb
  nea472d395a -.-> n0f7d24b5c9
  ndedcdf3336 -.-> n618a06a457
  n039c137e87 -.-> n7a0416d632
  n8f4bf1501d -.-> n291c5a8e91
  nce086069bf --> n5504f43c35
  n92def5b605 --> n5504f43c35
  nd615738ff0 --> n5504f43c35
  n94e6481eaa --> n5504f43c35
  n0f860af1bc --> n5504f43c35
  n897ce13a71 --> n5504f43c35
  n2f20fb82a1 --> n5504f43c35
  n0f7d24b5c9 --> n39fa9fbaa4
  n85aca030fb --> n39fa9fbaa4
  n618a06a457 --> n39fa9fbaa4
  n5504f43c35 --> n1215b98ec2
  n39fa9fbaa4 --> n1215b98ec2
  n5504f43c35 --> nc9f630977d
  n39fa9fbaa4 --> nc9f630977d
  n5504f43c35 --> ne8d834b0f9
  n39fa9fbaa4 --> ne8d834b0f9
  n5504f43c35 --> n1bcd475538
  n39fa9fbaa4 --> n1bcd475538
  n5504f43c35 --> n51cd4b7649
  n39fa9fbaa4 --> n51cd4b7649
  n5504f43c35 --> n1a4e8f29c9
  n39fa9fbaa4 --> n1a4e8f29c9
  n5504f43c35 --> n0a070eccb1
  n39fa9fbaa4 --> n0a070eccb1
  n5504f43c35 --> n82fefbe606
  n39fa9fbaa4 --> n82fefbe606
  n5504f43c35 --> n8e6e1f9b07
  n39fa9fbaa4 --> n8e6e1f9b07
Loading
vim profiles by feature, envs by lang and package, dotfiles
feature astrovim lazyvim neovim nvim vscode-vim
theme astrodark tokyonight catppuccin-frappe base24-rebecca
gui, aliases gui gui gui gui vi vim
avante x
blink x x x
bufferline x
codecompanion x x
conform x
copilot x
copilot-chat x
dropbar x
flash x
globals x
go x
grug-far x
haunt x
hunk x
jj x x
lazy x
lsp x x x
lua x
lualine x
mini x
mini-essentials x
mini-files x
moonbit x
neo-tree x
noice x
nvim-lint x
persistence x
rust x x x
scope x
smartcolumn x
snacks x x
snacks-extras x
snacks-header x
snacks-keys x x
todo-comments x
toggleterm x
trouble x
tv x
tv-vim x
which-key x x x x
env langs aspects packages
fullenv c, go, nix, node, python, rust env-c, env-go, env-nix, env-node, env-python, env-rust bacon, bun, cachix, deadnix, gcc-wrapper, gnumake, go, gopls, just, nh, nil, nix-unit, nixd, nixfmt, nodejs, npins, pkg-config-wrapper, pnpm, python3, rust-default, statix, typescript, uv, wasm-bindgen-cli, wasm-pack, yarn
goenv go env-go go, gopls
nixenv nix env-nix cachix, deadnix, just, nh, nil, nix-unit, nixd, nixfmt, npins, statix
nodeenv node env-node bun, nodejs, pnpm, typescript, yarn
pyenv python env-python python3, uv
rustenv c, rust env-c, env-rust bacon, gcc-wrapper, gnumake, pkg-config-wrapper, rust-default, wasm-bindgen-cli, wasm-pack
home path modules/vic/dots/ aspect
.claude/skills/vic-lessons claude/skills/vic-lessons ai-vic-hooks
.config/bottom config/bottom cli-tools
.config/btop config/btop cli-tools
.config/gh/config.yml config/gh/config.yml git
.config/jjui config/jjui jujutsu
.config/ghostty config/ghostty terminals
.config/wezterm config/wezterm terminals
.config/autostart/lxqt-config-touchpad-autostart.desktop config/autostart/lxqt-config-touchpad-autostart.desktop vic-desktop-tools
.config/fontconfig config/fontconfig vic-desktop-tools
.config/rtk config/rtk vic-dots
.config/niri config/niri vic-niri
.config/noctalia config/noctalia vic-niri

Counts

98 scopes, 19 kinds, 216 aspects, 2082 routed elements. A kind with 0 scopes is data: nothing spawns it.

Kind Fields Spawns Sinks Scopes
assembly kit, roles 0
channel darwin, home-manager, nixpkgs 0
emacs bins, bootstrap, configDots, daemon, fish, initDir, wrapper 0
env langs env-packages 18
export user user homeManager 1
fleet export, home, host, mac, secret, ssh-host, system caches, checks, ci-jobs, exports, files, flake-file, infra, jobs, out, runners, served, shared-pkgs, sops, ssh-blocks 1
guest addr, channel, checkout, ciBroken, cpu, desktops, envs, firmware, form, gpu, impermanence, keyboard, layouts, macAddress, on, sharedPkgs, system, trimmedModules, users, wifi, workspace, workstation user caches, nix-features, nixos, os, persist, ports, unfree 2
home channel, checkout, ciBroken, envs, on, system, user user nix-features, nixos, os, persist, ports, primary-user, secrets, unfree 2
host channel, checkout, ciBroken, cpu, desktops, envs, firmware, form, gpu, impermanence, keyboard, layouts, sharedPkgs, system, trimmedModules, users, wifi, workstation guest, home, member, user caches, nix-features, nixos, os, persist, ports, primary-user, secrets, unfree 9
kit adds, constraints, exports, roles 0
mac channel, checkout, ciBroken, cpu, desktops, envs, firmware, form, gpu, impermanence, keyboard, layouts, sharedPkgs, system, trimmedModules, users, wifi, workstation member, user caches, darwin, login-shells, nix-features, os, ports, primary-user, unfree 2
machine channel, checkout, ciBroken, cpu, desktops, envs, firmware, form, gpu, impermanence, keyboard, layouts, sharedPkgs, system, trimmedModules, users, wifi, workstation 0
member 12
secret deploy, format, sopsFile, sopsKey, sopsPath 15
ssh-host controlPersist, extraOptions, forwardAgent, forwardsServedBy, host, hostname, localForwards, proxyJump, remoteForwards, serverAliveCountMax, serverAliveInterval, setEnv, user 5
system darwin, legacyPackages env, vim devshells, formatter, packages 3
user admin, email, fullName, shell env account, claude, claude-allow, dots, fish-functions, git-ignores, homeDarwin, homeLinux, homeManager, ports, secrets, unfree 13
vim aliases, features, gui, theme nvf, unfree 15
workspace on, repo 0
Sink Given at Received at Elements
account user user 37
caches fleet, host, mac fleet, host, mac 9
checks system, user fleet 11
ci-jobs env, host, mac, user fleet 19
claude user user 26
claude-allow user user 91
darwin mac, member mac 11
devshells env, system system 21
dots user user 108
env-packages env env 36
files fleet, system fleet 2
fish-functions user user 21
flake-file env, fleet, guest, host, system, user fleet 223
formatter system system 3
git-ignores user user 65
homeDarwin user user 2
homeLinux user user 89
homeManager user export, user 626
infra host fleet 9
jobs fleet fleet 3
login-shells user mac 1
nix-features guest, host, mac guest, host, mac 13
nixos guest, host, member, user guest, home, host 149
nvf vim vim 186
os guest, host, mac, user guest, home, host, mac 117
out export, fleet, host, mac, system, user fleet 39
packages system, vim system 35
persist host host 1
ports user user 26
primary-user user host, mac 2
runners member fleet 3
secrets user user 18
served user fleet 13
sops secret fleet 15
ssh-blocks ssh-host fleet 5
unfree host, user, vim guest, home, host, mac, user, vim 47

Capability index

Invariants (yen.invariants, Datalog over the fleet's facts). The result is a query on the eval result, not readable inside the fleet: nix eval --impure --json --file query.nix check.violations ([ ] when every one holds).

Invariant File
follows-declared modules/agent/invariants.nix
gui-needs-graphical modules/agent/invariants.nix
runners-no-users modules/agent/invariants.nix
secrets-need-trusted modules/agent/invariants.nix
unique-guest-addr modules/agent/invariants.nix
unique-local-forward modules/agent/invariants.nix
unique-port modules/agent/invariants.nix

Stored queries (r.ask name args, or the MCP tool yen_ask):

Query Required Optional File
aspectsOn place modules/agent/queries.nix
featuresOf vim modules/agent/queries.nix
freePort place modules/agent/synthesis.nix
inputsOf aspect modules/agent/queries.nix
portsOf place modules/agent/queries.nix
unfreeOn place modules/agent/queries.nix
whoInstalls pkg modules/agent/queries.nix

MCP tools (15, mcp/ of yen): yen_ask, yen_check, yen_context, yen_declared_in, yen_errors, yen_explain, yen_export, yen_impact, yen_labels, yen_program, yen_queries, yen_schema, yen_stage, yen_verify, yen_why_not.

flowchart LR
  n254d290cd5[("yen-mcp (nix run github:vic/yen#yen-mcp)")]
  nf3ef81de2f("yen_ask")
  nf54195a4ac("yen_check")
  n6a59d997e4("yen_context")
  n66ec653a2d("yen_declared_in")
  nffe30fe478("yen_errors")
  n6df3350afa("yen_explain")
  n724e51eaa4("yen_export")
  nec98de0ce9("yen_impact")
  na6be3937d8("yen_labels")
  n1b9c14e078("yen_program")
  ncc44a3e3ff("yen_queries")
  n7aa4e78a07("yen_schema")
  n07a598af03("yen_stage")
  n9574552e9e("yen_verify")
  n53cf4e0ffd("yen_why_not")
  n254d290cd5 --> nf3ef81de2f
  n254d290cd5 --> nf54195a4ac
  n254d290cd5 --> n6a59d997e4
  n254d290cd5 --> n66ec653a2d
  n254d290cd5 --> nffe30fe478
  n254d290cd5 --> n6df3350afa
  n254d290cd5 --> n724e51eaa4
  n254d290cd5 --> nec98de0ce9
  n254d290cd5 --> na6be3937d8
  n254d290cd5 --> n1b9c14e078
  n254d290cd5 --> ncc44a3e3ff
  n254d290cd5 --> n7aa4e78a07
  n254d290cd5 --> n07a598af03
  n254d290cd5 --> n9574552e9e
  n254d290cd5 --> n53cf4e0ffd
Loading

Trust labels (yen.labels, by file path prefix). An agent edits under a low-trust prefix; (import ./query.nix).floor 3 lists every element its aspects route.

Prefix Trust Aspects
agent/ 1 2: rdf-pack, yen-mcp-claude
modules/ 3 193
vic/ai/ 2 21

Knowledge pack (out.rdfPack, agent/rdf.nix): the sha256 and count of the routing graph as sorted N-Triples (the same in every file order), and SHACL shapes from the schema: nix eval --json .#rdfPack.sha256.

Queries on an eval result (r = import ./query.nix): active, ask, check, context, data, declaredIn, errors, explain, facts, flake, floor, graph, impact, labels, queries, reduced, root, schema, scopes, undefined.

Engine library (yen.lib): allowed, any, asOf, aspect, attrs, attrsOf, batteries, bool, derive, diffData, enum, eval, functionTo, grant, history, int, is, jsonSafe, kind, kits, listOf, maybe, mkFlake, narrow, oneOf, opt, path, port, secret, stage, str, validAt, without. Reduce strategies: elements, flat, list, merge, one, set. Change programs (yen.lib.program): dryRun, opErrors, toModule, validate. Graphs (yen.lib.graphs): cycles, fromEdges, layers, nodesOf, of, paths, reach, reachers, sccs, shortest, topo, transpose.

The cycle form (cycle = { tree, ... }: …): kits-contract, rdf-pack, readme, ssh-jumps, vic-emacs, vm-host.

Vocabulary: kinds, sinks, tiers, roles

Kinds: one scope per instance when some spawns reaches the kind

kind what it is instances (yen.<kind>.<name>)
assembly data: one use of a kit, each role's machines an at predicate ci-bert, ci-bill, ci-tom, hardware
channel data: the nixpkgs, home-manager and nix-darwin pins a machine builds with unstable
emacs data: an emacs distribution doom, spc
env a dev environment: langs become a devshell and user packages fullenv, goenv, nixenv, nodeenv, pyenv, rustenv
export a user outside any machine: its home content becomes homeModules.<name> vic
fleet root scope; it spawns every system, host, mac and home vix
guest a microvm on a host: its nixos goes into the host's microvm.vms dnx, gen
home a home-manager home of one user: standalone, or on a host (on) behind walls bitstream, nargun
host a NixOS machine: nixosConfigurations.<host> annatar, bill, bombadil, frodo, mordor, nargun, nienna, smaug, tom
kit data: roles, a typed interface per role, constraints and exports (yen.lib.kits.* are kits) facter, github-runner
mac a nix-darwin machine: darwinConfigurations.<mac> bert, varda
machine data: typed facts (cpu, form, desktops, users, envs) hosts, guests and macs copy - (abstract)
member one (assembly, role) a machine takes: spawned under the machine, its elements go up to it - (abstract)
secret data spawned by the fleet: a sops secret a feature asks for, its data given to sops alwaysdata-vic, anthropic-api-key, copilot-api-key, edge-token, gemini-eco-key, gh-recover, groq-api-key, hello, nix-versions, openrouter-api-key, ssh-conf, ssh-id-ed25519, ssh-localhost-run, tangled, vix
ssh-host data spawned by the fleet: one ssh client matchBlock, given to ssh-blocks edge, sini, uptermd.upterm.dev, vini, vini-tunnel
system a nix system; it spawns one scope per vim profile and per env aarch64-darwin, aarch64-linux, x86_64-linux
user a person: full name, email, login shell, admin vic
vim a neovim profile: a feature list built per system into one nvf package (+ a gui wrapper) astrovim, lazyvim, neovim, nvim, vscode-vim
workspace data: a project an isolated guest works on (repo path) dnx, gen

Sinks: where an aspect key sends its element

An element goes to the nearest ancestor-or-self scope that has the sink. A sink key that names another sink forwards the reduced value to it.

sink on reduce forwards to what
env-packages env list homeManager tools of an env's langs: its devshell, and the home of a user whose machine lists it
homeManager export, user list os, out a home-manager module: on a machine, or homeConfigurations."<user>@<place>"
caches fleet, guest, host, mac flat flake-file, os cachix caches: a machine's nix.settings substituters and keys, the fleet's flake.nix nixConfig
checks fleet merge out checks.<sys>.<name>: fmt, README, flake.nix, no-gui, config tests
ci-jobs fleet merge out one GitHub build job per buildable host, mac, home and linux devshell; its runner comes from runners
exports fleet custom fleet: what kit members export to each other, one element per member (kits.exports)
files fleet list out repo files (this README, ci.yml) built by sini/files
flake-file fleet merge out this flake.nix: the inputs each aspect uses
infra fleet merge out fleet: facts per host from its data; checks.x86_64-linux.infra-<host> compares them with the built system
jobs fleet merge files fleet: the jobs of ci.yml, merged; github.workflow writes the file
out fleet merge flake outputs
runners fleet custom fleet: { <system> = { system; machine; label; }; }, the GitHub runner of each system, claimed by the member of kit github-runner on it
served fleet elements fleet: every user's ports with the scope that serves them (elements); ssh tunnels forward from it
shared-pkgs fleet elements fleet: the hosts with sharedPkgs, each with its scope; a host finds its group leader in it
sops fleet merge fleet: every secret's sops data by secret name; a reader resolves a secret ref r with sops.<r.name>
ssh-blocks fleet merge fleet: one ssh matchBlock per ssh-host scope; vic's programs.ssh.settings reads it
nix-features guest, home, host, mac flat, list each machine's nix.settings.experimental-features
nixos guest, home, host list nixos, out a NixOS module
os guest, home, host, mac list darwin, nixos a module for either OS
persist guest, home, host list nixos paths impermanence keeps on the host
ports guest, home, host, mac, user elements, list served { port; what; } a machine's or a user's service listens on: for unique-port, portsOf and freePort; a user's go up to served
unfree guest, home, host, mac, user, vim flat, list unfree unfree package names the machine, home or vim profile allows
primary-user home, host, mac list, one the one admin user name a mac (system.primaryUser) or a wsl host (wsl.defaultUser) reads; two admins are an error record
secrets home, host, user flat, list nixos secret refs: on a user, vic-secrets gives them to sops-nix in home-manager; on a host, to sops-nix in NixOS
darwin mac list out a nix-darwin module
login-shells mac set mac: login shells of its users; the mac enables programs.<shell> and lists them in environment.shells
devshells system merge out devShells.<sys>: one per env, and the maintainer shell
formatter system one out formatter.<sys> (treefmt, nix fmt); reduce one: a second formatter is an error record
packages system merge out packages.<sys>: own packages, vim profiles, write-files
account user list os users.users.<user> on the user's machine
claude user layers homeManager Claude Code settings.json layers { rank; set; }: a higher rank wins per key, equal ranks must agree
claude-allow user sorted Claude Code permissions; ai-claude reads them
dots user merge { "<home path>" = "<dots path>"; }; vic-dots links them into $HOME
fish-functions user merge fish functions; fish writes them once
git-ignores user flat global git ignores; git reads them
homeDarwin user list homeManager homeManager on darwin only
homeLinux user list homeManager homeManager on linux only
nvf vim list packages an nvf module of a vim profile

vic profiles: tiers gate features (at = yen.aspects.vic-<tier>); roles come from facts or host files

name active
vic-full not on iso images (not within installer)
vic-gui on-graphical: every gui program lives here
vic-headless everywhere vic lives: terminal tools only (homes, guests, servers)
vic-secrets on-trusted; also the sops consumer
role ci-runner machines that hold a member of kit github-runner: bare GitHub runners, no users
role graphical hosts with desktops or wsl, workstation macs (from facts); a host file can add itself
role installer iso hosts (from facts)
role on-darwin a user on a mac or darwin home (homeDarwin)
role on-graphical a user within graphical, no non-graphical guest between
role on-linux a user on a linux machine or home (homeLinux)
role on-trusted a user within trusted, no untrusted guest between
role trusted a host file adds itself: holds vic's secrets

216 aspects live under modules/; yen.aspects.<name> each. Active nowhere (empty at, or a marker no scope matches): frodo-wipe-root, frodo-wipe-user, gnome-desktop, laptop-thermald, shared-pkgs, shared-pkgs-no-docs, vic-rdesk, vic-vini-dashboards, vix-rdesk.

Directory structure

import-tree loads every .nix file under modules/. Paths with /_ are skipped (data files, payload). Dir names are for humans only. yen does not read them.

dir purpose
modules/agent/ invariants, stored queries, uKanren synthesis, trust labels, the rdf pack and the MCP app for agents
modules/checks/ flake checks over the built configs: platform packages, no gui on headless homes
modules/desktops/ desktop sessions (gnome, kde, niri, xfce), remote desktop, darwin defaults
modules/docs/ this README: tour, graphs, vocabulary, recipes, open decisions
modules/editors/ the vim and emacs kinds
modules/envs/ the env kind, vic's envs, and one aspect per language
modules/flake/ flake plumbing: flake-file, files, outputs, ci, formatter, devshell
modules/forms/ aspects that key on the machine form: iso, wsl, laptop, laptop power
modules/hardware/ aspects that key on machine facts: cpu, gpu, wifi, keyboard, firmware
modules/hosts/ NixOS hosts, macs and standalone homes: facts, roles, own aspects; hosts//_nixos is autoincluded, hosts/_facter holds the facter reports
modules/kits/ kits and assemblies: the kinds and the contract, and the assemblies of the library kits (hardware)
modules/nix/ nix settings, daemon, experimental features, unfree, state version
modules/packages/ own packages and scripts
modules/platforms/ how hosts, guests, macs and homes build, and their sinks: accounts, impermanence, ports
modules/roles/ roles and vic's feature tiers
modules/topology/ the scope tree and its data: fleet, systems, channels, machines, users, workspaces, secrets, ssh hosts
modules/vic/ vic's own features, by area (below)

Inside modules/vic/:

dir purpose
modules/vic/ai/ claude, agents, mcp servers, skills
modules/vic/dev/ dev tools and security ops
modules/vic/dots/ dotfiles linked into $HOME
modules/vic/edit/ browsers, editors and terminals
modules/vic/nvf/ neovim features, one file each, and the vim profiles
modules/vic/secrets/ sops-encrypted files (opaque)
modules/vic/shell/ fish and shell tools
modules/vic/sys/ fonts, ssh, secrets and system bits
modules/vic/vcs/ git and jujutsu
Recipes: add a host, feature, env, ssh host, secret, port

Add a host: facts only; hardware and desktop aspects key on them (modules/hosts/<name>.nix). Hardware files in modules/hosts/<name>/_nixos/ load by autoinclude; an assembly of kit github-runner (roles.runner.settings.label) makes the host a bare CI runner.

yen.host.elrond = {
  system = yen.system.x86_64-linux;
  users = [ yen.user.vic ];
  workstation = true;
  cpu = "amd";
  desktops = [ "kde" "niri" ];
};
yen.aspects.trusted.at = yen.host.elrond;

The same host as a change program an agent can dry-run (errors, invariant violations, diff) before it writes a file. Users stay in the host file: a program value is not a list of refs.

echo '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"yen_program","arguments":{"program":[{"fields":{"cpu":"amd","system":{"ref":{"kind":"system","name":"x86_64-linux"}},"workstation":true},"kind":"host","name":"elrond","op":"new"},{"op":"set","path":["host","elrond","desktops"],"value":["kde","niri"]},{"aspect":"trusted","kind":"host","name":"elrond","op":"place"}]}}}' | nix run github:vic/yen?dir=mcp

Add a user feature: one aspect, gated by a tier (modules/vic/<area>/<name>.nix).

yen.aspects.dev-tools = {
  at = yen.aspects.vic-full;
  homeManager = { pkgs, ... }: { home.packages = [ pkgs.gh pkgs.jq ]; };
};

Add a dev env: an instance, then list it on a machine or home (envs = [ yen.env.goenv ];).

yen.env.goenv.langs = [ "go" ];
yen.aspects.env-go = {
  at = yen.helpers.envHas "go";
  env-packages = { env, ... }: [ env.system.legacyPackages.go ];
};

Add an ssh host: one instance becomes one programs.ssh matchBlock (modules/topology/ssh-hosts.nix).

yen.ssh-host.edge = {
  host = "edge";
  hostname = "192.168.192.168";
};

Add a secret: declare it, then give it from the feature that reads it (a user's or a host's secrets sink). A file in modules/vic/secrets/ that no instance owns is an error record; deploy = false keeps a file off every machine.

yen.secret.groq-api-key.sopsKey = "groq_api_key"; # modules/topology/secrets.nix
yen.aspects.my-feature.secrets = [ yen.secret.groq-api-key ];

Add a port: ask for a free one, then give it on the ports sink next to the setting that reads it. A second service on the same port of one machine is a unique-port violation.

# (import ./query.nix).ask "freePort" { name = "frodo"; }   =>   { port = 8000; used = [ ... ]; }
yen.aspects.my-service = {
  at = yen.aspects.vic-headless;
  ports = [ { port = 8000; what = "my-service"; } ];
};

Decisions open

Each one changes a setting, a structure or an output, so it waits for vic.

  • secret rotation dates: validTo and reviewDate on secrets give warnings when a date passes (vic sets the dates)
  • variants (one machine, two builds): no vix machine has a second build today; bombadil is an image, annatar is WSL only
  • shared pkgs and trimmed modules on: each host needs its drvPath oracle, and a module list for the current nixpkgs
History