Skip to content

Polish README: badges, ToC, example agents, fix stale claims#67

Merged
johnnyclem merged 2 commits into
mainfrom
claude/readme-review-update-9pdwkr
Jul 21, 2026
Merged

Polish README: badges, ToC, example agents, fix stale claims#67
johnnyclem merged 2 commits into
mainfrom
claude/readme-review-update-9pdwkr

Conversation

@johnnyclem

Copy link
Copy Markdown
Owner

Summary

Reviewed the README against the actual repo state and gave it a polish pass:

  • Added a header with the existing project logo (site/static/img/logo.svg) and npm version / CI / license / node-engine badges (all backed by real, verified sources — package.json, .github/workflows/test.yml, .github/workflows/release.yml).
  • Added a Table of Contents for easier navigation given the README's length.
  • Added an Example Agents section documenting the five agents under examples/ that weren't previously called out.
  • Fixed a stale claim: "508 tests" → verified 1,500+ test cases across 88 test files (grepped it(/test( declarations under tests/).
  • Added the hypervault and merge CLI commands to the command tables — both are real, registered commands (cli/index.ts) that were missing from the tables.
  • Expanded the Documentation section with links to docs/getting-started/*, docs/cli/reference.md, docs/architecture/overview.md, and docs/security/*, which existed but weren't linked.
  • Linked the existing docs/development/contributing.md guide from the Contributing section.
  • Noted macos-wallet-app/ (the native Xcode wallet companion app) in the project structure tree.
  • Minor prose/formatting cleanup (em dashes, dfx install link).

No functional/code changes — README only.

Test plan

  • Verified all newly linked doc paths exist (docs/getting-started/*, docs/cli/reference.md, docs/architecture/overview.md, docs/security/*, docs/development/contributing.md)
  • Verified hypervault and merge are real commands registered in cli/index.ts
  • Verified test-count claim via grep over tests/**/*.test.ts (88 files, 1,549 it/test declarations)
  • Verified badge sources are truthful (npm package publishes via release.yml, CI runs via test.yml, LICENSE is MIT)
  • Rendered the diff to check markdown table/heading formatting

Generated by Claude Code

Adds npm/build/license/node badges and a logo header, a table of
contents, and an Example Agents section covering examples/. Corrects
the stale "508 tests" figure (now 1,500+ across 88 files), adds the
missing hypervault and merge CLI command rows, and links the richer
docs (getting-started, CLI reference, architecture, security) and the
contributing guide that already existed under docs/ but weren't
surfaced.
@vercel

vercel Bot commented Jul 21, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
agent-vault Ready Ready Preview, Comment Jul 21, 2026 11:53pm
agentvault Ready Ready Preview, Comment Jul 21, 2026 11:53pm

tests/project-files.test.ts asserts README.md contains a literal
"# AgentVault" markdown heading. Swapping it for a centered HTML <h1>
broke that check. Keep the centered logo but use a plain markdown H1
for the title.
@johnnyclem
johnnyclem merged commit f43d1a3 into main Jul 21, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants