Skip to content

readme: truth-sayer purge — honest v0.1.0 documentation#4

Merged
SuperInstance merged 1 commit into
mainfrom
readme-truth-sayer
Jun 5, 2026
Merged

readme: truth-sayer purge — honest v0.1.0 documentation#4
SuperInstance merged 1 commit into
mainfrom
readme-truth-sayer

Conversation

@SuperInstance
Copy link
Copy Markdown
Owner

Summary

This PR rewrites README.md to reflect what Pincher actually is at v0.1.0, rather than what earlier docs dreamed it would become.

What Was Removed

  • Five Deployment Modes (Lighthouse, Codespaces, Tender, Container, Bare Metal) — none exist. No boot.sh, no mode flags, no Docker image on Docker Hub.
  • Holodeck MUD — no implementation exists anywhere in the codebase.
  • Baton Protocol tooling tablebaton-create.sh, baton-read.sh, etc. don't exist in tools/.
  • Dead image link to pincher-icon.jpg — assets are hermit-crab.jpg and logo.jpg.
  • Aspirational file structureboot.sh, CHARTER.md, ABSTRACTION.md, STATE.md, splines/, reflexes/ don't exist.
  • Instant-boot claims without published benchmarks.

What Was Added

  • Honest project description: a reflex runtime with CLI, vector store, sandbox.
  • CLI command table matching pincher-cli/src/main.rs exactly.
  • Architecture section with per-module implementation status (all 12+ modules verified).
  • Feature flags documentation (onnx, landlock, wasmtime).
  • "What This Is Not" section — explicit disavowal of fictional features.
  • Near-term roadmap from real project docs (docs/ROADMAP.md, docs/MVP_CHECKLIST.md).
  • Accurate file tree based on git ls-tree -r inventory.
  • Every code reference (module names, CLI commands, SQL schema, file paths) verified against actual source.

What Was Preserved

  • The Reflex Engine architecture (Teach → Match → Execute)
  • The SQLite vector store with sqlite-vec
  • The Bubblewrap sandbox with veto engine
  • The .nail portable rig format
  • The ONNX embedding engine with hash fallback
  • The resource controller, capability tokens, RPC server
  • The CLI as primary interface

A full audit report is at workspace/readme-truth-report.md in the agent workspace.

…al v0.1.0 state

What was removed:
- Five non-existent deployment modes (Lighthouse, Tender, Codespaces, Container, Bare Metal)
- Holodeck MUD references (no implementation exists)
- Baton protocol tooling table (tools don't exist yet)
- Dead image link to pincher-icon.jpg
- Non-existent file structure (boot.sh, CHARTER.md, ABSTRACTION.md, etc.)
- Instant-boot/performance claims without published benchmarks

What was added:
- Accurate project description: reflex runtime with CLI, vector store, sandbox
- Real CLI command table matching pincher-cli/src/main.rs
- Honest architecture section with per-module implementation status
- Verified module descriptions for all 12+ pincher-core modules
- Feature flags documentation (onnx, landlock, wasmtime)
- 'What This Is Not' section — explicit disavowal of fictional features
- Near-term roadmap from real project docs
- Accurate file tree based on repo inventory
@SuperInstance SuperInstance merged commit f58cf92 into main Jun 5, 2026
2 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.

1 participant