# VaultMesh Quick Reference

## Eternal Pattern

```
Intent → Engine → Receipt → Scroll → Anchor
```

## Three Layers

| Layer | Components | Artifacts |
|-------|------------|-----------|
| L1 Experience | CLI, UI, MCP | Commands, requests |
| L2 Engine | Domain logic | contract.json, state.json |
| L3 Ledger | Receipts, anchors | JSONL, ROOT.*.txt |

## Scrolls

| Scroll | Path | Root File |
|--------|------|-----------|
| Drills | `receipts/drills/` | `ROOT.drills.txt` |
| Compliance | `receipts/compliance/` | `ROOT.compliance.txt` |
| Guardian | `receipts/guardian/` | `ROOT.guardian.txt` |
| Treasury | `receipts/treasury/` | `ROOT.treasury.txt` |
| Mesh | `receipts/mesh/` | `ROOT.mesh.txt` |
| OffSec | `receipts/offsec/` | `ROOT.offsec.txt` |
| Identity | `receipts/identity/` | `ROOT.identity.txt` |
| Observability | `receipts/observability/` | `ROOT.observability.txt` |
| Automation | `receipts/automation/` | `ROOT.automation.txt` |
| PsiField | `receipts/psi/` | `ROOT.psi.txt` |
| Federation | `receipts/federation/` | `ROOT.federation.txt` |
| Governance | `receipts/governance/` | `ROOT.governance.txt` |

## DIDs

```
did:vm:<type>:<identifier>

node   → did:vm:node:brick-01
human  → did:vm:human:sovereign
agent  → did:vm:agent:copilot-01
service → did:vm:service:oracle
mesh   → did:vm:mesh:vaultmesh-dublin
```

## Phases

| Symbol | Phase | State |
|--------|-------|-------|
| 🜁 | Nigredo | Crisis |
| 🜄 | Albedo | Recovery |
| 🜆 | Citrinitas | Optimization |
| 🜂 | Rubedo | Integration |

## Axioms

1. Receipts are append-only
2. Hashes are cryptographic
3. All changes produce receipts
4. Constitution is supreme
5. Axioms are immutable

## CLI Cheatsheet

```bash
# Guardian
vm-guardian anchor-status
vm-guardian anchor-now --wait
vm-guardian verify-receipt <hash> --scroll <scroll>

# Identity
vm-identity did create --type node --id <id>
vm-identity capability grant --subject <did> --capability <cap>
vm-identity whoami

# Mesh
vm-mesh node list
vm-mesh node status <id>
vm-mesh topology

# Oracle
vm-oracle query "What are the GDPR requirements?"
vm-oracle corpus status

# Drills
vm-drills create --prompt "<scenario>"
vm-drills status <drill-id>

# Psi
vm-psi phase current
vm-psi transmute start --input <ref>
vm-psi opus status

# Treasury
vm-treasury balance
vm-treasury debit --from <acct> --amount <amt>

# Governance
vm-gov constitution version
vm-gov violations list
vm-gov emergency status

# Federation
vm-federation status
vm-federation verify --mesh <peer>

# System
vm-cli system health
vm-cli receipts count --by-scroll
```

## Receipt Structure

```json
{
  "schema_version": "2.0.0",
  "type": "<scroll>_<operation>",
  "timestamp": "ISO8601",
  "header": {
    "root_hash": "blake3:...",
    "tags": [],
    "previous_hash": "blake3:..."
  },
  "meta": {
    "scroll": "ScrollName",
    "sequence": 0,
    "anchor_epoch": null,
    "proof_path": null
  },
  "body": {}
}
```

## Capabilities

| Capability | Description |
|------------|-------------|
| `anchor` | Submit to anchor backends |
| `storage` | Store receipts/artifacts |
| `compute` | Execute drills/agents |
| `oracle` | Issue compliance answers |
| `admin` | Grant/revoke capabilities |
| `federate` | Establish cross-mesh trust |

## Trust Levels

| Level | Name | Access |
|-------|------|--------|
| 0 | isolated | None |
| 1 | observe | Read-only |
| 2 | verify | Mutual verification |
| 3 | attest | Cross-attestation |
| 4 | integrate | Shared scrolls |

## Severity Levels

| Level | Description |
|-------|-------------|
| critical | Active breach |
| high | Confirmed attack |
| medium | Suspicious activity |
| low | Anomaly/info |

## Key Ports

| Service | HTTP | Metrics |
|---------|------|---------|
| Portal | 8080 | 9090 |
| Guardian | 8081 | 9090 |
| Oracle | 8082 | 9090 |
| MCP | 8083 | - |

## Health Endpoints

```
GET /health/live   → Liveness
GET /health/ready  → Readiness
GET /metrics       → Prometheus
```

## Transmutation Steps

```
Extract → Dissolve → Purify → Coagulate → Seal
```

## Design Gate

- [ ] Clear entrypoint?
- [ ] Contract produced?
- [ ] State object?
- [ ] Receipts emitted?
- [ ] Append-only JSONL?
- [ ] Merkle root?
- [ ] Guardian anchor path?
- [ ] Query tool?