From c037fcc29147a0ea175f10e88a35da72093195e5 Mon Sep 17 00:00:00 2001
From: hyperpolymath <6759885+hyperpolymath@users.noreply.github.com>
Date: Tue, 19 May 2026 22:28:25 +0100
Subject: [PATCH] docs(flake): annotate KEEP+DEP rationale per standards#102
 rule 3
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Per the campaign gate, this flake is LOAD-BEARING — sole source of
the Rust+WASM toolchain (rustToolchain with wasm32-unknown-unknown,
wasm-pack, wasm-bindgen-cli, binaryen) and the ReScript build chain
(rescript, nodejs, just, cargo-watch). guix.scm uses node-build-system
with no inputs; the Containerfile is Deno-only — neither covers the
Rust/WASM/ReScript surface.

Top-comment now states the dep so the flake's retention is
self-documenting and a future sweep can verify cheaply.

Refs standards#101 standards#102.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---
 flake.nix | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/flake.nix b/flake.nix
index 7d82fc9..3f60c54 100644
--- a/flake.nix
+++ b/flake.nix
@@ -1,3 +1,11 @@
+# Retained per standards#102 rule 3 (KEEP+DEP). guix.scm is a
+# node-build-system shell with no declared inputs; the sealed
+# Containerfile is Deno-only. This flake's devShell is the SOLE source
+# of the Rust + WASM toolchain (rust-overlay rustToolchain with the
+# wasm32-unknown-unknown target, wasm-pack, wasm-bindgen-cli,
+# binaryen/wasm-opt) and the ReScript build chain (rescript, nodejs,
+# just, cargo-watch). Remove only once a Guix-side Rust/WASM/ReScript
+# story exists.
 {
   description = "UbiCity - Learning Capture System (RSR-Compliant)";