You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Adds a "Runtime hardening (optional)" section to docs/skill-integrity.md. It documents eyebrow wrap as an operator side complement to the ci-skill-integrity gate, for the Aeon MCP server that bin/add-mcp registers with Claude Code.
Why
The CI gate protects the skills in the repo at PR time. It says nothing about the server once it runs on an operator machine. The new section explains the opt in local relay (per tool policy, redacted audit log, tool surface capture, OS sandbox) that covers that surface. Docs only. No change to install or CI paths, and eyebrowlock.json is untouched.
FYI, separate from this PR: eyebrow v0.4.2 is out and your gate pins v0.4.1. Bump when convenient. I left it as is here to keep this change focused.
Type of change
Core fix (dashboard / scripts / workflows / docs)
Core fix (dashboard / scripts / workflows / docs)
Change is focused — one concern, no unrelated refactor
Touched code follows the existing pattern in the file
Relevant CI gates pass locally (e.g. bash scripts/check-skill-categories.sh, bash scripts/check-capabilities-parity.sh)
Touched apps/**? That app typechecks, tests, and builds (dashboard: npm run typecheck && npm test && npm run build)
alexverify
changed the title
Document optional runtime hardening for the Aeon MCP server
docs: optional runtime hardening for the Aeon MCP server
Aug 31, 2026
Hold. The gap is real (CI fingerprints skills in the repo, not the live local MCP server), but this section as written will send operators down the wrong path.
Wrong config surface.bin/add-mcp is claude mcp add with default local scope, which writes ~/.claude.json under the project path. This repo has no root .mcp.json. Wrap will still see a default add-mcp install because it also reads that local store; the sentence that says "for an Aeon server declared in a project .mcp.json" points at a file this install path does not use. User-scope needs eyebrow wrap --global.
OS sandbox is sold as a win for this server.apps/mcp-server spawns a harness (claude by default) as a child. Default wrap enables Seatbelt/bwrap with writes limited to workspace+temp and, on macOS, network limited to the local proxy port. That child wants ~/.claude writes and API egress. eyebrow's own usage doc already warns some servers need --workspace / --no-sandbox. Following this page as written can break aeon-* skill runs.
Also drop "the same engine" (scan/verify vs wrap/shim are different components), stop claiming wrap detects a binary swapped outside the build, and link the actual wrap runbook (docs/usage.md) with eyebrow wrap / eyebrow wrap --status / eyebrow unwrap.
Docs-only, no CI to fail. Please rewrite the section to match how Aeon actually installs MCP, with the sandbox caveat, then this is mergeable.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Adds a "Runtime hardening (optional)" section to
docs/skill-integrity.md. It documents eyebrow wrap as an operator side complement to the ci-skill-integrity gate, for the Aeon MCP server thatbin/add-mcpregisters with Claude Code.Why
The CI gate protects the skills in the repo at PR time. It says nothing about the server once it runs on an operator machine. The new section explains the opt in local relay (per tool policy, redacted audit log, tool surface capture, OS sandbox) that covers that surface. Docs only. No change to install or CI paths, and
eyebrowlock.jsonis untouched.FYI, separate from this PR: eyebrow v0.4.2 is out and your gate pins v0.4.1. Bump when convenient. I left it as is here to keep this change focused.
Type of change
Core fix (dashboard / scripts / workflows / docs)
bash scripts/check-skill-categories.sh,bash scripts/check-capabilities-parity.sh)apps/**? That app typechecks, tests, and builds (dashboard:npm run typecheck && npm test && npm run build)