◆PURYSHO

SYSTEM STUDY / COLLECTION 01

UNDERSTAND

Open the machine. Read the layers. See what is actually there.

Four local-first tools for turning opaque systems into readable ones: repository structure, personal files, database internals, and evidence-backed retrieval.

A / STRUCTUREB / INDEXC / STORAGED / EVIDENCE
FIELD NOTE 001
Understanding starts by exposing structure.These tools do not hide complexity behind magic. They make the important parts legible enough to inspect, question, and use.
04INSTRUMENTS
01REPOSITORY FORENSICSCYAN CHANNEL
BLACKBOX icon

BLACKBOX

See what a codebase is really made of.

BLACKBOX scans a local repository and surfaces structure, language mix, hotspots, dependencies, TODO/FIXME signals, suspicious patterns, and exportable JSON.

  • Repository structure and language mix
  • Hotspots, large files and suspicious patterns
  • Dependency and Git signals
  • Local-only scanning
Open BLACKBOX on GitHub ↗
repo/src/scanner.pyui/assets/tests/
HOTSPOT 84%
RISK SIGNAL
12 TODO
02LOCAL SEARCHGREEN CHANNEL
Needle icon

Needle

Find what already exists on your machine.

Needle builds a lightweight local index over folders you choose, then lets you search, browse, open, and reveal files without sending filenames or content to a hosted search service.

  • Build and update local indexes
  • Fast filename and path retrieval
  • Browse by extension
  • Open or reveal results directly
Open Needle on GitHub ↗
needle
notes.txtC:\work\notes.txt
needle_index.jsonC:\data\needle_index.json
research.mdC:\docs\research.md
03DATABASE INTERNALSAMBER CHANNEL
PalisadeDB icon

PalisadeDB

A database from first principles.

PalisadeDB exposes the mechanics normally hidden behind a database API: pages, B+ trees, transactions, SQL parsing, persistence, and recovery.

  • Custom .pdb storage format
  • Pager and B+ tree implementation
  • SQL parsing and execution
  • Recovery and integrity inspection
Open PalisadeDB on GitHub ↗
PAGE 0042
ROOT
PAGE 0130
LEAF
PAGE 0131
LEAF
04EVIDENCE SYSTEMSVIOLET CHANNEL
Witness icon

Witness

Answers you can inspect, challenge, and reproduce.

Witness is a local-first evidence and retrieval workbench that makes the hidden parts of RAG visible: what was retrieved, what supports an answer, what contradicts it, and whether the available evidence is actually sufficient.

  • Sentence-level provenance and exact evidence spans
  • Inspectable retrieval routes, ranking and sufficiency
  • Contradiction and source-version awareness
  • Repeatable RAG Lab and adversarial Attack evaluation
Open Witness on GitHub ↗
QUESTION / TRACE
E1SOURCE SPAN
E2CORROBORATES
E3CONTRADICTS
ANSWER
SUPPORTED

WHAT BINDS THESE TOOLS

LOCAL FIRSTYour data stays yours.
INSPECTABLETransparent by design.
LOW-NOISEFocused and purposeful.
BUILT FOR CLARITYComplexity made legible.