Brain

huible

2 min read

🧠 Huible — Persona Reconstruction Engine

Status: Development (Phase 1 code exists but needs rescue into git) Repo: /root/repos/huible (only docs committed)
Paperclip: Project “Huible”, 21 issues VPS: 208.84.102.243

What It Is

Huible reconstructs a deceased person as a conversational persona for bereaved families via SMS/WhatsApp. Not a chatbot — a memory engine with five-gate safety, provenance-tiered recall, and relationship-scoped disclosure.

Architecture (as designed)

  • Python 3.14, PostgreSQL 18 + pgvector
  • Five-gate memory ingestion: Safety → Dedup → Novelty → Immutability → Pertinence
  • Spreading activation retrieval (not flat cosine similarity)
  • Memory versioning + quarantine: Append-only, with adjudication queue
  • Provenance tiers: Canonical, derived, accrued, world
  • Relationship-scoped disclosure: Persona modulates based on who it talks to
  • Batch-first ingestion: Deliberate quality gate, not a limitation

Current Reality (2026-08-03)

⚠️ The agent code exists but is NOT in the git repo.

  • The git repo at /root/repos/huible has only 2 docs (224 lines total)
  • The actual code (~11,800 lines, 80 Python files) lives in Paperclip’s internal workspace at /root/.paperclip/instances/default/projects/.../61f0d3bf.../_default/src/huible/
  • No .git in that workspace. Never committed. Never pushed.
  • 5 build issues (BHAA-1332 through BHAA-1336) marked “done” but code unverified
  • Test files exist (18 test files) but have 13 collection errors

Code Package Structure (from workspace)

src/huible/
├── memory/          # models.py, retrieval.py (spreading activation)
├── ingestion/       # pipeline.py, gates (safety, dedup, novelty, immutability, pertinence)
│                    # extractor.py, embedder.py, writer.py, quarantine.py, batch.py
├── adjudication/    # reviewer_routing.py, history.py
├── advisory/        # clinical safety advisor interface
└── api/             # REST endpoints (spec in BHAA-1338)

What Needs To Happen

  1. Rescue code from Paperclip workspace → /root/repos/huible/src/
  2. Get tests passing (fix 13 collection errors)
  3. Verify F1 fixture actually runs
  4. Create proper GitHub remote and push
  5. Stop trusting Paperclip “done” status without git verification

Key Issues

  • BHAA-1326: Build roadmap
  • BHAA-1327: INV-15 five-gate firewall
  • BHAA-1328: INV-16 versioning + quarantine
  • BHAA-1332-1336: Build tasks (claimed done, unverified)

Graph View