feat(orchestrator): firewall view with signed settings changes (001 S6)

Requirement 001 S6: the hub gets a Firewall view of the Claude Code permission and sandbox settings. The operator signs each change with the passkey; a host settings writer (systemd path unit) applies only exact, signed changes to allowlisted settings files through O_NOFOLLOW directory and file descriptors, and a timer refreshes the view. Every signed text and every page sink refuses or marks hidden characters: Cc, Cf, Zl, Zp, every space but U+0020 and the Default_Ignorable set, with U+FE0E/U+FE0F allowed only after one of the 359 non-ASCII emoji bases of Unicode 16 (shared table, validated at import, the same pair rule on the page). Removal of a deny, ask or denyRead entry is exempt only as an exact single remove. The permission hook prints the hub's refusal reason, cleaned of hidden characters. Accepted MEDUSA false positives (independent review, operator pick): 38 this round, mainly the Unicode defence tables read as attack patterns, generic MM-SCAN-058 heuristics, WEB-FLASK-004 at view.py:213 (ints from the validated table via tojson), EXF26-TOOL-004 on the non-secret WebAuthn challenge, PRIV-SCAN-060 on the office-action shape check and PQC007 on a picker key.

🎯 Fix: 95 %
💥 Break: 3 %
💸 Cost: –
⏱️ Time: –
🛡️ Security: 100 %
🏆 Score: 92
🚦 Gate: ✅ 90/5, cost and time <= 100, security 100 %

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
Kevin Veen-BirkenbachandClaude Opus 5.5 committed 2026-11-13 18:14:17 +00:00
1 parent 3418738993
commit 9742884308
54 files changed
+3920 -168

No files matched your search

+15 -3
View File
@@ -734,14 +734,26 @@ flowchart TD
### Phase 6: Firewall (S6)
- [ ] The tab is called Firewall and lists hub rules, allow and deny
- [x] The tab is called Firewall and lists hub rules, allow and deny
patterns and the settings permissions, grouped by tool and prefix as
read from the settings files.
- [ ] A rule or rule set applies to one agent, a named group or all agents.
- [ ] A settings change is written only by the host executor after the
- [x] A rule or rule set applies to one agent, a named group or all agents.
- [x] A settings change is written only by the host executor after the
passkey check, only to a listed file, with a backup beside it; a forged,
replayed or unlisted-file job changes nothing (unit tests).
Limit: a session id is not an authenticated identity; an agent that can run
`claude --resume <other id>` inherits every rule aimed at that session. A
decision names its agent in a free MCP argument: a rule aimed at sessions
decides it only for the one session holding that name now, never through a
name a session held before, and for none when several hold it.
Widening needs a fresh passkey signature over exactly what takes effect:
signing a rule shows its pattern, directory, end and every session id of its
target, a group's or rule set's resolution at that moment, and turning a rule
on again needs its own signature; groups, rule sets and turning off stay
free, since they grant nothing by themselves.
### Phase 6: Resources (S7)
Replaced by [003 W4 Resources](003-operator-workbench.md#w4-resources).