docs: align color contract with merged pty

agent-session-id: ed878dac-3735-4276-b3e0-ea1b1cd65291
agent-tool: Codex CLI
agent-tool-version: 0.145.0
agent-model: unknown
agent-runtime-profile: /nix/store/mnx8agbdq3wiyb6vz63lhgscgazkrn98-coding-agent-runtime-profile/share/coding-agents/profile.json
agent-skills-manifest: /nix/store/5r69m9k2llmri3na81518zx0a7y0d3cn-agent-skills-corpus/share/agent-skills/manifest.json
tooling-profile: dotfiles@0fb7e03

Author: schickling-assistant

docs/vrs/spec.md

@@ -136,6 +136,15 @@ validate ──► materialize ──► host-local st2 scheduler/reconciler
   before launch: the command may select an account-specific `CODEX_HOME` only
   after st2 starts it. `st2 pretrust` remains an explicit operator utility for
   commands that intentionally use the ambient Claude and Codex configs.
+
+  The canonical `agent` task treats a reconciler's ambient `NO_COLOR` as a
+  launcher preference rather than agent policy. Unless the Agent Spec declares
+  `NO_COLOR`, st2 removes it from the launch environment and records the removal
+  in the PTY launch definition. An explicit Agent Spec assignment takes
+  precedence. Isolation wrappers preserve both assignments and removals, so a
+  manual PTY restart under a different ambient environment reconstructs the
+  same effective color policy. Adoption of an already-live task remains
+  non-mutating: this policy is applied only when st2 creates a generation.
 - **R07:** Hook bundles are explicit, content-addressed, installed separately,
   and verified before materialization references them. Their receipts use the
   same resolved build identity as the binary's version surfaces for both

flake.lock

@@ -6,7 +6,7 @@
     flake-utils.url = "github:numtide/flake-utils";
     # Packaged PTY contract: the exact fleet-observation producer revision, including persisted
     # environment removals used by managed agent restarts.
-    pty.url = "github:compoundingtech/pty/c0a1e636aea2ba3ce71dc0e72942394fb7f4fe25";
+    pty.url = "github:compoundingtech/pty/d5fabc3917407aeb937a012bd97679c303e18033";
     pty.inputs.nixpkgs.follows = "nixpkgs";
   };