{"id":50821275,"url":"https://github.com/vantage-ola/verity","last_synced_at":"2026-06-13T14:01:15.431Z","repository":{"id":359820796,"uuid":"1247459845","full_name":"vantage-ola/verity","owner":"vantage-ola","description":"Link features, claims, tests, and evidence into verifiable releases stored on Walrus.","archived":false,"fork":false,"pushed_at":"2026-06-10T17:49:57.000Z","size":721,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-10T18:05:39.771Z","etag":null,"topics":["ai-agents","cli","decentralized-storage","memwal","proof-chain","python","python-cli","release-tracking","single-source-of-truth","ssot","sui","verification","walrus"],"latest_commit_sha":null,"homepage":"https://verity-web-one.vercel.app","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/vantage-ola.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-23T10:50:55.000Z","updated_at":"2026-06-10T17:50:34.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/vantage-ola/verity","commit_stats":null,"previous_names":["vantage-ola/verity"],"tags_count":25,"template":false,"template_full_name":null,"purl":"pkg:github/vantage-ola/verity","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vantage-ola%2Fverity","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vantage-ola%2Fverity/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vantage-ola%2Fverity/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vantage-ola%2Fverity/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vantage-ola","download_url":"https://codeload.github.com/vantage-ola/verity/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vantage-ola%2Fverity/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34286976,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-13T02:00:06.617Z","response_time":62,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-agents","cli","decentralized-storage","memwal","proof-chain","python","python-cli","release-tracking","single-source-of-truth","ssot","sui","verification","walrus"],"created_at":"2026-06-13T14:00:56.492Z","updated_at":"2026-06-13T14:01:15.394Z","avatar_url":"https://github.com/vantage-ola.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# verity\n\n**How do you trust what an AI agent built?**\n\nverity is a proof-chain registry for AI agents — record what was built, what was claimed, what tests ran, and what they proved. Every chain is published to [Walrus](https://docs.walrus.site) as an immutable blob. Any agent, on any machine, can pull it back and verify it.\n\n[![CI](https://github.com/vantage-ola/verity/actions/workflows/ci.yml/badge.svg)](https://github.com/vantage-ola/verity/actions/workflows/ci.yml)\n[![Coverage](https://codecov.io/gh/vantage-ola/verity/branch/main/graph/badge.svg)](https://codecov.io/gh/vantage-ola/verity)\n[![PyPI version](https://badge.fury.io/py/walrus-verity.svg)](https://badge.fury.io/py/walrus-verity)\n[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)\n[![PyPI Downloads](https://static.pepy.tech/personalized-badge/walrus-verity?period=total\u0026units=INTERNATIONAL_SYSTEM\u0026left_color=GREY\u0026right_color=GREEN\u0026left_text=downloads)](https://pepy.tech/projects/walrus-verity)\n\n---\n\n## The model\n\n```\nfeature → claim → test → evidence → release\n                                       │\n                              verity push ──► Walrus blob ID (immutable)\n                              verity pull ◄── restore anywhere, any agent\n```\n\n- **feature** — a capability being shipped\n- **claim** — a testable statement about the feature\n- **test** — the mechanism that exercises the claim\n- **evidence** — the pass/fail signal the test produced\n- **release** — a named snapshot; `push()` publishes it to Walrus\n\nBuilt for the **Sui Overflow hackathon, Walrus track**.\n\n---\n\n## Install\n\n```bash\n# Full install — everything included\nuv tool install \"walrus-verity[all]\"\n\n# Or with pip\npip install \"walrus-verity[all]\"\n\n# Individual extras\npip install \"walrus-verity[memwal]\"   # MemWal semantic recall\npip install \"walrus-verity[sign]\"     # Ed25519 signing\npip install \"walrus-verity[mcp]\"      # MCP server\n```\n\n---\n\n## Quick start\n\nThe fastest path — one command records the full claim/test/evidence chain:\n\n```bash\nverity init --repo-id repo:my-project\nverity track feat:auth tests/test_auth.py --title \"Login succeeds\"\nverity validate\nverity release 1.0.0\nverity push                    # → blob: AbCdEfGh…\nverity push --upload-artifacts # upload artifact files to Walrus first, then push registry\n```\n\nOr build the chain manually for full control:\n\n```bash\n# Phase 1 — add entities with neutral statuses\nverity add feature  feat:auth \"User authentication\"\nverity add claim    clm:auth.t1 \"Login succeeds\"  --feature feat:auth\nverity add test     tst:auth.unit \"Unit test\"      --claim clm:auth.t1 --path tests/test_auth.py\nverity add evidence evd:auth.ci \"CI run\"           --test tst:auth.unit --artifact artifacts/ci.json\n\n# Phase 2 — promote statuses once the chain is fully linked\nverity add evidence evd:auth.ci \"CI run\" --test tst:auth.unit --artifact artifacts/ci.json --status passed\nverity validate      # → OK\nverity release 1.0.0\nverity push          # → blob: AbCdEfGh…\n\n# Any agent, any machine, any future session:\nverity pull AbCdEfGh…\n```\n\n\u003e **Why neutral statuses first?** verity validates after every `add`. Setting `--status verified` on a claim before its test exists will fail. Build the full chain first, then promote statuses.\n\n---\n\n## Multi-agent trust\n\nAgent A builds and signs. Agent B verifies before building on top.\n\n```bash\n# Agent A\nverity push                                          # → blob_a\nverity keygen --key ~/.verity/signing.key            # generate keypair once\nverity sign --key ~/.verity/signing.key              # attest blob_a\nverity push                                          # → blob_b (carries the attestation)\n\n# Agent B — receives blob_b + pubkey\nverity verify blob_b --pubkey-b64 \u003cpubkey\u003e\n# blob: blob_b   repo: repo:my-project\n# features 4  claims 5 (5 verified)\n# chain valid ✓\n# signature valid ✓   attests: blob_a…  signer: \u003cpubkey\u003e…\n```\n\n---\n\n## AI coding assistant integration\n\n**Skill installer** — teaches your AI assistant the verity model, CLI, and API:\n\n```bash\nverity install-skill                    # Claude Code (global CLAUDE.md)\nverity install-skill --tool cursor      # Cursor → .cursorrules\nverity install-skill --tool windsurf    # Windsurf → .windsurfrules\nverity install-skill --tool codex       # OpenAI Codex → AGENTS.md\nverity install-skill --tool aider       # Aider → CONVENTIONS.md\n```\n\n**MCP server** — expose all verity tools natively to any MCP-compatible editor:\n\n```bash\npip install \"walrus-verity[mcp]\"\n```\n\nAdd to your `claude_mcp_config.json` (or equivalent):\n\n```json\n{\n  \"mcpServers\": {\n    \"verity\": {\n      \"command\": \"verity-mcp\",\n      \"env\": {\n        \"WALRUS_PUBLISHER_URL\": \"https://publisher.walrus-testnet.walrus.space\",\n        \"WALRUS_AGGREGATOR_URL\": \"https://aggregator.walrus-testnet.walrus.space\"\n      }\n    }\n  }\n}\n```\n\n| MCP tool | Description |\n|---|---|\n| `verity_init` | Create `.verity/registry.json` |\n| `verity_add_feature / claim / test / evidence` | Add chain entities |\n| `verity_set_status` | Promote status after chain is wired |\n| `verity_set_status_batch` | Promote multiple entities atomically in one call |\n| `verity_validate` | Validate the full chain |\n| `verity_release` | Fail-closed release |\n| `verity_push` | Push to Walrus; `upload_artifacts=True` uploads local artifact files first |\n| `verity_pull` | Fetch blob from Walrus; `force=True` to overwrite existing registry |\n| `verity_log` | Push history |\n| `verity_status` | Entity counts + validation summary |\n| `verity_diff` | Diff two Walrus blob snapshots |\n| `verity_export` | Export to SARIF, JUnit, or SPDX |\n| `verity_sign` | Sign the latest push with an Ed25519 key |\n| `verity_verify` | Fetch blob, validate chain, check signature |\n| `verity_recall` | Natural language query against MemWal |\n\n---\n\n## Export and interop\n\n```bash\nverity export --format sarif    # SARIF 2.1.0 — security findings dashboards\nverity export --format junit    # JUnit XML  — CI test result viewers\nverity export --format spdx     # SPDX 2.3   — software bill of materials\n```\n\n---\n\n## Recall\n\nPush with MemWal to register semantic memories alongside the Walrus blob:\n\n```bash\nverity push --backend memwal\n\nverity recall \"what features have we built\"\nverity recall \"what claims are verified\"\nverity recall \"what was the latest release\"\n```\n\n---\n\n## Watch mode\n\n`verity watch` polls the registry file and validates (and optionally auto-pushes) on every change:\n\n```bash\nverity watch                       # poll every 5s, validate on change\nverity watch --interval 30         # custom poll interval (seconds)\nverity watch --auto-push           # push to Walrus on each valid change\nverity watch --auto-push --backend memwal\n```\n\n---\n\n## Documentation\n\nFull documentation is available at the [verity web app](https://vantage-ola.github.io/verity/) — CLI reference, MCP server, Python API, schema, Walrus/MemWal setup, and multi-agent patterns.\n\n---\n\n## Acknowledgements\n\nThe proof-chain model (`feature → claim → test → evidence → release`) is directly inspired by the [ssot-registry](https://github.com/groupsum/ssot-registry) project, licensed under [Apache 2.0](https://www.apache.org/licenses/LICENSE-2.0). verity adapts that model for AI agents and Walrus-backed persistence.\n\n---\n\n## Contributing\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md).\n\n## License\n\nMIT. See [LICENSE](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvantage-ola%2Fverity","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvantage-ola%2Fverity","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvantage-ola%2Fverity/lists"}