Skip to content

docs: full reflection of skill v0.6.0 + MCP companion in README + SECURITY - #485

Merged
szhygulin merged 1 commit into
mainfrom
docs/skill-v8-cosmetics
Apr 28, 2026
Merged

docs: full reflection of skill v0.6.0 + MCP companion in README + SECURITY#485
szhygulin merged 1 commit into
mainfrom
docs/skill-v8-cosmetics

Conversation

@szhygulin

Copy link
Copy Markdown
Collaborator

Summary

Pure docs PR — no behavior change. Brings README + SECURITY into line with skill v0.6.0 (vaultpilot-security-skill#19) and its MCP companion (#480).

SECURITY.md changes

6 new defenses-table rows:

7 new threat-mapping bullets covering the v0.6.0 attack classes.

Updated vaultpilot-preflight skill row to enumerate the full v0.6.0 invariant set + current sentinel _v8_4aac027a9df315a9.

3 new sections:

  • "Selection-layer attacks (validators, markets, LPs, multisig xpubs)" — explains the threat class Inv Add TRON Phase 1: read-only balances + portfolio integration #15 introduces
  • "Forward-looking invariants" — Inv #1b / #2b (typed-data, ships when MCP surface lands) + §16 (EIP-7702 refuse-all)
  • "Adversarial smoke-test (2026-04-28) — what changed in v0.6.0" — summary of 44-script corpus + 7-of-8 sub-issue closure + 3 follow-up tracking issues (#481, #482, #483)

Expanded existing sections:

README changes

  • "Agent-side hardening" list expanded from "bytes-decode + hash-recompute" to the full skill v0.6.0 invariant set (with #-tagged labels)
  • "Security model" paragraph expanded with the agent-side defense classes (dispatch target / chain-naming / bridge facet / set-level / durable-binding / message hardening / mandatory second-LLM)

Test plan

  • Markdown renders cleanly
  • All issue/PR cross-references resolve

🤖 Generated with Claude Code

…URITY

README:
- Broaden agent-side hardening list to include all skill v0.6.0
  invariants (#1.a outer dispatch-target / #2.5 chain-naming / #6b
  Tier-1 facet decoder / #11 approval-class / #12.5 hard-trigger /
  #14 set-level intent / #15 durable-binding / et al)
- Expand security-model paragraph with the new defense classes the
  skill enforces beyond the server-emitted block prose

SECURITY.md:
- Add 6 new defenses-table rows: Inv #1.a (outer dispatch-target
  allowlist), #2.5 (chain-must-be-explicit), #6b (Tier-1 facet
  decoder), #12.5 (mandatory second-LLM hard-trigger), #14 (set-level
  intent verification), #15 (durable-binding source-of-truth)
- Update preflight-skill row to enumerate the full v0.6.0 invariant
  set + current sentinel `_v8_4aac027a9df315a9`
- Update version refs (v0.4.1 → v0.6.0) in asymmetry section + add
  pointer to the new "Adversarial smoke-test 2026-04-28" subsection
- Add 7 new threat-mapping bullets covering the v0.6.0 attack classes:
  recipient substitution via stale approval, cross-chain ambiguity /
  CREATE2 sweeper, bridge facet recipient swap, reverse-revoke /
  set-level lie, durable-binding selection-layer, free-form drainer
  pattern, EIP-7702 setCode (forward-looking)
- Expand "Phishing approvals" with v0.6.0 broadening (Inv #1.a closes
  recipient redirection; Inv #14 closes reverse-revoke)
- Expand "Free-form message signing" with §8 hardening (byte
  fingerprint, drainer-template refusal, why marker-word-only is
  wrong)
- New "Selection-layer attacks" section explaining the threat class
  Inv #15 introduces (validators / SRs / Comets / marketIds / banks
  / ATAs / LP tokenIds / multisig xpubs)
- New "Forward-looking invariants" section for #1b/#2b (typed-data,
  ships when MCP surface lands) + §16 (EIP-7702 refuse-all)
- New "Adversarial smoke-test 2026-04-28" subsection summarizing the
  44-script corpus + 7-of-8 sub-issue closure + 3 follow-up tracking
  issues (#481 7702 builder + skill v9, #482 per-EVM-chain contact
  tag, #483 per-handler dispatch-target wiring)

Pure docs — no behavior change.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@szhygulin
szhygulin merged commit 8123e87 into main Apr 28, 2026
4 checks passed
@github-actions github-actions Bot locked and limited conversation to collaborators Apr 28, 2026
@szhygulin
szhygulin deleted the docs/skill-v8-cosmetics branch May 19, 2026 04:24
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant