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.
yen has four words: kinds, scopes, aspects, sinks. Each row links to the line in vix that uses a construct.
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 |
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 stdioGenerated 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
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
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
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
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
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
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
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
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
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
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 |
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 |
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
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
| 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 |
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=mcpAdd 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"; } ];
};Each one changes a setting, a structure or an output, so it waits for vic.
- secret rotation dates:
validToandreviewDateon 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
- yen (current): Ren rewritten in yen; Ren classes and channels are sinks
- Ren
- Den without flakes
- Den with flakes + flake-parts
- Dendritic flake-parts only
- blueprint
- flake-parts
- old m1 flake with mk-darwin-system
- other with snowfall-lib lost