ARG — Agent Resource Graph

ARG — Agent Resource Graph

Complete documentation set, written 2026-05-03 03:35 Beirut after overnight Phase 2.6 + Phase 5 items 3/4/7 landed.

This folder is the canonical reference for the ARG system. Source-of-truth code lives at /root/.claude/system/; this folder is the human-readable explanation.

Read order

1. 01_what_and_why.md — what ARG is, why it exists, what problem it solves
2. 02_architecture.md — file layout, JSON schema, the four states, the resolver
3. 03_cli_reference.md — every arg subcommand with examples
4. 04_probes.md — the probe contract, autofix matrix, flap detection, rate limiting
5. 05_policy_hook.md — runtime boundary enforcement, bypass hardening, what's caught vs deferred
6. 06_capabilities_resolver.md — composition, AND-vs-OR boundary semantics, decision states
7. 07_observability.md — event journal, probe_status, inbox, single-writer invariant
8. 08_cron_and_lifecycle.md — scheduled jobs, journal rotation, sanitizer
9. 09_operations.md — common tasks, troubleshooting, recovery
10. 10_roadmap.md — phase plan, what shipped, what's deferred

TL;DR

ARG is JSON-as-truth self-knowledge for Brian. It answers three questions:

• What do I have? (resources/ — accounts, keys, hosts, data stores, products, channels, subsystems, agents)
• Can I do X right now? (capabilities/ — composed actions resolved against live state)
• What must I never do? (policies/boundaries.json — hard rules enforced by a PreToolUse hook)

Probes verify atom liveness on a cron. Autofix repairs safe failure classes. The resolver returns one of five states (yes, yes-after-probe, yes-after-approval, no, blocked-by-policy). A single CLI (/usr/local/bin/arg) exposes everything.

Authoritative source pointers

• Code: /root/.claude/system/
• CLI binary: /root/.claude/system/bin/arg → /usr/local/bin/arg
• Policy hook: /opt/agent/scripts/arg_policy_hook.py
• Autofix: /opt/agent/scripts/arg_autofix.py
• Sanitizer: /opt/agent/scripts/arg_sanitize.py
• Bypass test corpus: /opt/agent/scripts/test_arg_policy_hook.py
• Probe scripts: /opt/agent/scripts/probes/*.sh
• Schemas: /root/.claude/system/schemas/
• Events journal: /root/.claude/system/observability/events/<YYYY-MM-DD>.ndjson

Status snapshot at doc-write time

verified-fresh: 71  |  verified-stale: 0  |  red: 13  |  unknown: 183

3 critical-red blocked: Zoho creds (refresh_token pending), Meta rate-limit cooldown, LinkedIn cooling after refresh probe storm. All recoverable.