Skip to content

Latest commit

 

History

History

README.md

Technical Reference

Flat technical reference pages for the public Ardur surface. These describe what a surface accepts and emits, not how to use it day-to-day. For task walkthroughs see ../guides/; for protocol semantics see ../specs/.

Pages

  • CLI Reference — every ardur subcommand, its flags, and what it emits
  • Personal Hub HTTP API — endpoints exposed by ardur hub, auth model, request and response shapes, error codes
  • ARDUR.md Profile Format — the plain-Markdown guardrail format that compiles into a Mission Passport
  • Proxy OCI Image Contract — canonical image name, immutable release gates, runtime hardening, state, TLS, auth, scan, and cost boundaries without claiming current registry availability
  • Kernel Capture Daemon Operations — control-plane-only mode, capture-loss semantics, and malformed-record response
  • Advisory AI Controls — semantic-judge and behavioral-fingerprint defaults, non-authoritative status, failure policy, cost, and integration requirements
  • Typed Dangerous-Action Risk Budgets — authenticated tool contracts, signed impact caps, atomic session/agent/lineage accounting, executor outcomes, receipts, and crash recovery
  • Agent Recognition Evaluation — versioned maintained corpus, deterministic metrics, Wilson intervals, CI thresholds, and claim boundaries

When To Update These Pages

These pages mirror the public source. When the underlying surface changes (python/vibap/cli.py, python/vibap/personal_hub.py, python/vibap/ardur_profile.py, go/cmd/ardur-kernelcaptured, go/cmd/ardur-agent-recognition-eval, go/pkg/kernelcapture/agent_recognition.go, go/pkg/kernelcapture/agent_recognition_evaluation.go, go/pkg/kernelcapture/testdata/agent_recognition_corpus.json, go/pkg/kernelcapture/testdata/agent_recognition_thresholds.json, python/vibap/semantic_judge.py, python/vibap/behavioral_fingerprint.py, python/vibap/risk_budget.py, Dockerfile.proxy, or its release workflow), update the matching page in the same change. They are deliberately mechanical so the diff is easy to review.