Merge nucleic/rustic-meadow-koala-wtwq into dev

2026-07-27 02:26:30 -07:00
parent 684858ae26
commit ea257181dd
3 changed files with 38 additions and 3 deletions
@@ -0,0 +1,23 @@
+# nash operator policy (docs/NASH.md §4.3) — baked into the narOS image.
+#
+# nash reads its levers ONLY from this file. They used to live in the environment
+# (NUCLEIC_NASH_DISABLE, NUCLEIC_REAL_BASH), which meant the process nash exists to
+# observe could turn that observation off in one word, silently. This file is root-owned
+# and not group/other-writable; nash checks that ownership before honoring a single line,
+# so an agent-created copy is ignored.
+#
+# Nucleic rewrites this file when it starts a container, carrying the `legacyShell`
+# rollback lever into `disable`. Editing it by hand is an operator action.
+
+# Observation may not be switched off by the observed process: a shell whose transport
+# env has been stripped, or which was handed NUCLEIC_SHELL_CAPTURE=off, still records and
+# spools to /var/spool/nucleic-nash for the drain.
+require_observation=1
+
+# Exec target for the parse-failure fallback and the break-glass below.
+real_bash=/usr/bin/bash.real
+
+# Break-glass (NASH.md §4.1): 1 makes nash re-exec the real bash with identical argv.
+# The one lever that turns the agent shell off, and it lives here precisely so that an
+# agent cannot reach it.
+disable=0
@@ -1,4 +1,8 @@
-# narOS shell environment (nash-default-shell). NUCLEIC_REAL_BASH is nash's
-# parse-failure fallback + NUCLEIC_NASH_DISABLE target (NASH.md §4.1).
-export NUCLEIC_REAL_BASH=/usr/bin/bash.real
+# narOS shell environment (nash-default-shell).
+#
+# Deliberately does NOT export NUCLEIC_REAL_BASH: nash's fallback target is an operator
+# lever, and operator levers now come from the trusted policy file (/etc/nucleic/nash.conf,
+# NASH.md §4.3), never from the environment — which is the agent's to write. nash carries
+# /usr/bin/bash.real as its compiled-in default anyway, so the export bought nothing but a
+# published bypass.
 [ -n "${SHELL:-}" ] || export SHELL=/usr/local/bin/nash