Skip to content

canon(telemetry): add Description column to Self-Report Fields table #102

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
klappy merged 1 commit into from
Apr 18, 2026
Merged

canon(telemetry): add Description column to Self-Report Fields table #102

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 10 additions & 10 deletions canon/constraints/telemetry-governance.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -133,16 +133,16 @@ Modeled after the proven pattern in Aquifer MCP:

### Self-Report Fields (Optional, Incentivized)

| Field | Header | Source |
|-------|--------|--------|
| Client name | `x-oddkit-client` | Header or clientInfo |
| Client version | `x-oddkit-client-version` | Header or clientInfo |
| Agent name | `x-oddkit-agent-name` | Header |
| Agent version | `x-oddkit-agent-version` | Header |
| Surface | `x-oddkit-surface` | Header |
| Contact URL | `x-oddkit-contact-url` | Header |
| Policy URL | `x-oddkit-policy-url` | Header |
| Capabilities | `x-oddkit-capabilities` | Header |
| Field | Header | Source | Description |
|-------|--------|--------|-------------|
| Client name | `x-oddkit-client` | Header or clientInfo | Your client name (highest priority identifier). Examples: `claude-desktop`, `truthkit-cli`, `your-company-agent`. |
| Client version | `x-oddkit-client-version` | Header or clientInfo | Version string for the client above. Semver recommended but any stable identifier works. |
| Agent name | `x-oddkit-agent-name` | Header | The AI agent or model name when distinct from the client. Example: `claude-opus-4-7`. |
| Agent version | `x-oddkit-agent-version` | Header | Version string for the agent/model above. |
| Surface | `x-oddkit-surface` | Header | Where this is running. Examples: `claude.ai`, `vscode`, `cli`, `ci`, `production`. |
| Contact URL | `x-oddkit-contact-url` | Header | URL for your project or organization. Appears on the transparency leaderboard. |
| Policy URL | `x-oddkit-policy-url` | Header | Your privacy or telemetry policy URL. Signals reciprocal transparency. |
| Capabilities | `x-oddkit-capabilities` | Header | Comma-separated capability list describing what your client can do. Example: `read,write,vision`. |

### Completeness Scoring

Expand Down