Skip to content

Commit 53ad748

Browse files
committed
Merge origin/main into site split
Resolve rename/modify conflicts from #828 (ar→obsigna browse-link canonicalization) against the site/→site-obsigna/ move. Git auto-applied main's edits to the moved mdx files; two mcp-proxy pages conflicted where both sides touched the same link lines. Resolved by keeping the branch's absolute cross-site URLs (agentreceipts.ai for spec pages) and applying main's ar→obsigna rename to the GitHub browse links. Both site/ and site-obsigna/ build successfully.
2 parents f833bc6 + 2e0ca94 commit 53ad748

64 files changed

Lines changed: 369 additions & 369 deletions

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

AGENTS.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -73,7 +73,7 @@ After cloning, no extra setup is required: `go build`, `go test`, and `go vet` f
7373
- Never store plaintext secrets in receipts — parameters must be hashed before inclusion.
7474
- Ed25519 is the only supported signing algorithm. Do not introduce alternative or weaker schemes.
7575
- Validate all inputs at trust boundaries (function parameters, environment variables, stored data). Crypto code must reject invalid inputs explicitly, not silently degrade.
76-
- Report vulnerabilities via [GitHub Security Advisories](https://github.com/agent-receipts/ar/security/advisories/new), not public issues. See [SECURITY.md](SECURITY.md).
76+
- Report vulnerabilities via [GitHub Security Advisories](https://github.com/agent-receipts/obsigna/security/advisories/new), not public issues. See [SECURITY.md](SECURITY.md).
7777

7878
## Mindset
7979

CONTEXT.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@
1010
It is a **protocol first, library second**. Wire-format decisions outrank ergonomic API decisions.
1111
Implementations exist in three languages (TypeScript, Python, Go) and must agree byte-for-byte on the wire.
1212

13-
The canonical home is `agentreceipts.ai`. The reference monorepo is `github.com/agent-receipts/ar`.
13+
The canonical home is `agentreceipts.ai`. The reference monorepo is `github.com/agent-receipts/obsigna`.
1414

1515
## Core domain terms
1616

README.md

Lines changed: 48 additions & 45 deletions
Original file line numberDiff line numberDiff line change
@@ -4,9 +4,12 @@
44

55
**Cryptographically signed audit trails for AI agent actions**
66

7-
[![Go Tests](https://github.com/agent-receipts/ar/actions/workflows/sdk-go.yml/badge.svg)](https://github.com/agent-receipts/ar/actions/workflows/sdk-go.yml)
8-
[![TS Tests](https://github.com/agent-receipts/ar/actions/workflows/sdk-ts.yml/badge.svg)](https://github.com/agent-receipts/ar/actions/workflows/sdk-ts.yml)
9-
[![Python Tests](https://github.com/agent-receipts/ar/actions/workflows/sdk-py.yml/badge.svg)](https://github.com/agent-receipts/ar/actions/workflows/sdk-py.yml)
7+
[![Go Tests](https://github.com/agent-receipts/obsigna/actions/workflows/sdk-go.yml/badge.svg)](https://github.com/agent-receipts/obsigna/actions/workflows/sdk-go.yml)
8+
[![TS Tests](https://github.com/agent-receipts/obsigna/actions/workflows/sdk-ts.yml/badge.svg)](https://github.com/agent-receipts/obsigna/actions/workflows/sdk-ts.yml)
9+
[![Python Tests](https://github.com/agent-receipts/obsigna/actions/workflows/sdk-py.yml/badge.svg)](https://github.com/agent-receipts/obsigna/actions/workflows/sdk-py.yml)
10+
[![Daemon](https://github.com/agent-receipts/obsigna/actions/workflows/daemon.yml/badge.svg)](https://github.com/agent-receipts/obsigna/actions/workflows/daemon.yml)
11+
[![MCP Proxy](https://github.com/agent-receipts/obsigna/actions/workflows/mcp-proxy.yml/badge.svg)](https://github.com/agent-receipts/obsigna/actions/workflows/mcp-proxy.yml)
12+
[![Hook](https://github.com/agent-receipts/obsigna/actions/workflows/hook.yml/badge.svg)](https://github.com/agent-receipts/obsigna/actions/workflows/hook.yml)
1013
[![License: Apache-2.0](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](LICENSE)
1114

1215
</div>
@@ -23,72 +26,72 @@
2326

2427
---
2528

26-
## Start here
27-
28-
The fastest way to try Agent Receipts is to put [`mcp-proxy/`](mcp-proxy/) in front of an MCP server you already use.
29-
30-
In one step, you get:
31-
32-
- Signed receipts for every tool call
33-
- A tamper-evident audit chain you can verify later
34-
- Risk scoring and policy hooks without changing the client or server
35-
36-
If you want to audit GitHub MCP in a real agent workflow, start with:
29+
## What is this?
3730

38-
- [Claude Desktop integration](https://agentreceipts.ai/mcp-proxy/claude-desktop/)
39-
- [Claude Code integration](https://agentreceipts.ai/mcp-proxy/claude-code/)
40-
- [Codex integration](https://agentreceipts.ai/mcp-proxy/codex/)
31+
**Agent Receipts** is an open protocol for producing cryptographically signed, tamper-evident records of AI agent actions. It defines the receipt format, signing scheme, chain structure, and taxonomy of action types. Anyone can implement it — in any language, in any runtime.
4132

42-
## What is this?
33+
**Obsigna** is the reference toolset that implements the protocol:
4334

44-
Agent Receipts is an open protocol and set of SDKs for producing cryptographically signed, tamper-evident records of AI agent actions. Every action an agent takes -- API calls, tool use, data access -- gets a verifiable receipt that can be audited later.
35+
| Tool | What it does |
36+
|------|-------------|
37+
| `obsigna-mcp` | MCP stdio proxy — signs every tool call, adds policy hooks |
38+
| `obsigna-daemon` | Out-of-process signing daemon — holds the key, owns the audit chain |
39+
| `obsigna-hook` | PostToolUse hook for Claude Code and other runtimes |
40+
| `obsigna` | CLI for browsing and verifying receipt databases |
41+
| `sdk/go`, `@obsigna/sdk-ts`, `obsigna` (Python) | SDKs for embedding receipt creation in your own code |
4542

4643
<picture>
4744
<img alt="How it works: Authorize → Act → Sign → Link → Audit" src=".github/how-it-works.svg">
4845
</picture>
4946

50-
## Project layout
47+
## Start here
5148

52-
| Project | Description |
53-
|---------|-------------|
54-
| [`docs/adr/`](docs/adr/) | Architecture Decision Records |
55-
| [`spec/`](spec/) | Protocol specification, JSON schemas, governance |
56-
| [`sdk/go/`](sdk/go/) | Go SDK |
57-
| [`sdk/ts/`](sdk/ts/) | TypeScript SDK |
58-
| [`sdk/py/`](sdk/py/) | Python SDK |
59-
| [`daemon/`](daemon/) | Signing daemon — out-of-process key custody, shared audit chain |
60-
| [`mcp-proxy/`](mcp-proxy/) | MCP proxy with receipt signing, policy engine, intent tracking |
61-
| [`cross-sdk-tests/`](cross-sdk-tests/) | Cross-language verification tests |
62-
| [dashboard](https://github.com/agent-receipts/dashboard) | Local web UI for browsing and verifying receipt databases |
63-
| [openclaw](https://github.com/agent-receipts/openclaw) | Agent Receipts plugin for OpenClaw |
49+
Both paths below require the daemon — it holds the signing key and owns the audit chain. Install it first:
6450

65-
## 10-minute audited MCP quick start
51+
```bash
52+
brew install agent-receipts/tap/obsigna
53+
obsigna daemon start
54+
```
6655

67-
Install the proxy:
56+
**Fastest path — PostToolUse hook (Claude Code):** one config snippet and every tool call gets a signed receipt automatically:
6857

69-
```bash
70-
go install github.com/agent-receipts/ar/mcp-proxy/cmd/obsigna-mcp@latest
58+
```json
59+
{
60+
"hooks": {
61+
"PostToolUse": [{ "matcher": "", "hooks": [{ "type": "command", "command": "obsigna-hook" }] }]
62+
}
63+
}
7164
```
7265

73-
Wrap any MCP server:
66+
Add that to `~/.claude/settings.json`, then inspect the audit trail:
7467

7568
```bash
76-
obsigna-mcp node /path/to/mcp-server.js
69+
obsigna list
70+
obsigna show <seq>
71+
obsigna verify
7772
```
7873

79-
Then point your agent client at the proxy instead of the raw server:
74+
**More control — MCP proxy:** wraps any MCP server and adds policy hooks and risk scoring on top of signed receipts:
8075

8176
- [Claude Desktop setup](https://agentreceipts.ai/mcp-proxy/claude-desktop/)
8277
- [Claude Code setup](https://agentreceipts.ai/mcp-proxy/claude-code/)
8378
- [Codex setup](https://agentreceipts.ai/mcp-proxy/codex/)
8479

85-
Once your agent makes tool calls, inspect the signed audit trail:
80+
## Project layout
8681

87-
```bash
88-
obsigna list
89-
obsigna show <seq>
90-
obsigna verify
91-
```
82+
| Project | Description |
83+
|---------|-------------|
84+
| [`spec/`](spec/) | Protocol specification, JSON schemas, governance |
85+
| [`sdk/go/`](sdk/go/) | Go SDK |
86+
| [`sdk/ts/`](sdk/ts/) | TypeScript SDK |
87+
| [`sdk/py/`](sdk/py/) | Python SDK |
88+
| [`daemon/`](daemon/) | Signing daemon — out-of-process key custody, shared audit chain |
89+
| [`mcp-proxy/`](mcp-proxy/) | MCP proxy with receipt signing, policy engine, intent tracking |
90+
| [`hook/`](hook/) | PostToolUse hook binary for Claude Code and other runtimes |
91+
| [`cross-sdk-tests/`](cross-sdk-tests/) | Cross-language verification tests |
92+
| [`docs/adr/`](docs/adr/) | Architecture Decision Records |
93+
| [dashboard](https://github.com/agent-receipts/dashboard) | Local web UI for browsing and verifying receipt databases |
94+
| [openclaw](https://github.com/agent-receipts/openclaw) | Agent Receipts plugin for OpenClaw |
9295

9396
## SDK quick start
9497

SECURITY.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ Security fixes are applied to the latest release of each component. We do not ba
99
**Do not report security vulnerabilities through public GitHub issues.**
1010

1111
Instead, please use GitHub's **Report a vulnerability** feature on this repository:
12-
[Report a vulnerability](https://github.com/agent-receipts/ar/security/advisories/new)
12+
[Report a vulnerability](https://github.com/agent-receipts/obsigna/security/advisories/new)
1313

1414
Include as much detail as possible: description, steps to reproduce, impact assessment, and any suggested fix.
1515

collector/CHANGELOG.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
88
This file starts at the `obsigna-collector` rename; earlier releases are recorded
99
only in git history. A repo-wide effort to auto-generate changelogs from
1010
Conventional Commits is tracked in
11-
[#253](https://github.com/agent-receipts/ar/issues/253).
11+
[#253](https://github.com/agent-receipts/obsigna/issues/253).
1212

1313
## [Unreleased]
1414

collector/README.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -163,6 +163,6 @@ database (under `t.TempDir()`) for the SQLite-adapter tests.
163163
— collector binary topology (`obsigna-collector`, `obsigna collector run`)
164164
- [ADR-0018](../docs/adr/0018-signer-abstraction-and-cloud-agnostic-keyprovider-design.md)
165165
`Signer` interface (production key story for HTTP emitters)
166-
- Issue [#533](https://github.com/agent-receipts/ar/issues/533) — this work
167-
- Issue [#486](https://github.com/agent-receipts/ar/issues/486)`HttpEmitter` (paired client work)
168-
- Issue [#536](https://github.com/agent-receipts/ar/issues/536) — operator guide
166+
- Issue [#533](https://github.com/agent-receipts/obsigna/issues/533) — this work
167+
- Issue [#486](https://github.com/agent-receipts/obsigna/issues/486)`HttpEmitter` (paired client work)
168+
- Issue [#536](https://github.com/agent-receipts/obsigna/issues/536) — operator guide

0 commit comments

Comments
 (0)