# VibeProof — Provenance Signaling for Vibe-Coded Repos

> The independent, client-side signer for AI-generated code. SHA-256 header: who, what tool, when. Signaling, not prevention.

[![MIT License](https://img.shields.io/badge/license-MIT-blue.svg)](./LICENSE)
[![Static](https://img.shields.io/badge/static-100%25_client--side-brightgreen.svg)](./index.html)
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](./CONTRIBUTING.md)
[![Self-test](https://img.shields.io/badge/self--test-passing-green.svg)](./test.html)

**The independent standard for code priority.** Transparent hashing · Verifiable bundles · Zero upload.

---

🌐 **Live Demo** `./index.html` · 📚 **Methodology** [`proof.js`](./proof.js) · 💰 **Pricing** `$0 sign / $19 cert` · 🖼️ **Social card** [`og-1200x630.png`](./og-1200x630.png)

---

## 📈 Star History

> ⭐ **If VibeProof proves you had it first, star this repo.** Stars are how independent provenance tools survive.

---

## The Manifesto

The vibe-coding status quo is broken: theft spats, stripped watermarks, and platforms that want your repo uploaded before they believe you.

VibeProof sits outside that — no backend, no account, no upload. Our only product is the hash, computed in your browser, in the open, with code you can audit in 21 lines (`proof.js`).

We don't prevent theft. Watermarks strip on reformat; anyone honest says so. We prove *priority*: these exact bytes existed at this time, signed by this handle.

## See It Run (10-Second Demo)

```bash
python3 -m http.server 8080
# open http://localhost:8080
# 1. Paste code → Sign + download → header: sha256:… by:@you tool:cursor at:…
# 2. Paste signed file into Verify → PASS (exact bytes) / FAIL (edited)
```

No key. `test.html` self-test green.

---

## 🧮 How It Scores (PASS / FAIL, Nothing More)

| Result | Meaning |
|--------|---------|
| ✅ PASS | Body SHA-256 == header hash. Exact bytes existed at signing time |
| ❌ FAIL | Edited after signing, or no header found |

Header: `// VibeProof provenance: sha256:<64hex> | by:<handle> | tool:<cursor/copilot/hand> | at:<ISO8601>`. Bundle: `vibeproof-bundle.json`. Informational — not legal IP advice. Keep originals + timestamps for disputes.

### Why No Paid Scores

> You cannot buy a PASS. Pro ($19/repo certificate) pays for timestamped PDF + registry entry, never for a forged hash.

## ⚔️ How We Compare

| Feature | VibeProof | Watermarks | Git commits | Notary |
|---------|-----------|------------|-------------|--------|
| Free client-side sign | ✅ | partial | ✅ | ❌ |
| Survives reformat | ❌ (says so) | ❌ | ✅ | ✅ |
| No upload | ✅ | ✅ | ❌ | ❌ |
| 1-click verify | ✅ | ❌ | ❌ | partial |
| Open 21-line impl (MIT) | ✅ | ❌ | ✅ | ❌ |

## ❓ FAQ — Pre-emptive Troll Disarmament

**Q: Strips on reformat, so useless.**

> A: For prevention, yes — we print that. For *priority signaling* (I had it first, here's the hash + date), it's exactly enough. Different job.

**Q: Why not just git commit?**

> A: Do both. Git proves it to GitHub; VibeProof proves it in the file itself, portable across gists, zips, DMs.

**Q: Legal IP?**

> A: No. Signaling only. Not legal advice. Consult counsel for filings.

## 🤝 Contributing

Read [CONTRIBUTING.md](./CONTRIBUTING.md). Hash agility, language headers (`#`, `<!-- -->`), bundle registry welcome.

## 📄 License

[MIT](./LICENSE). No affiliation with any AI lab or forge.
