DBYTE HOLYC TOOLS

Windows-native read-only source navigator, archaeology reporter, and oracle/random text lab for HolyC, LoseThos, SparrowOS, and TempleOS-style research.

Current line: v1.9.1 LOSETHOS CODEGEN MILESTONE

Architecture

Source trees go in. Evidence reports come out. The target source trees stay read-only.

flowchart LR
    A[Source trees] --> B[Lexer]
    B --> C[Index]
    C --> D[CLI]
    D --> E[Report scripts]
    E --> F[Evidence reports]

    A1[TempleOS] --> A
    A2[LoseThos] --> A
    A3[SparrowOS] --> A

    F --> F1[Source map]
    F --> F2[Include resolve]
    F --> F3[Reverse map]
    F --> F4[Contract reports]

    G[Trust boundary]
    G --> G1[No rewrite]
    G --> G2[No VM]
    G --> G3[No source-tree mutation]

Loading

source trees
  -> lexer
  -> index
  -> cli
  -> report scripts
  -> evidence reports

Rule

No source rewrite.
No formatter.
No VM.
No fake C parser.
No source-tree mutation.
Oracle output is random text lab output, not an authority claim.

What it does

It scans HolyC-style source, indexes symbols/includes, checks include resolution, finds likely entry files, emits deterministic text/JSON reports, builds read-only source archaeology maps, and provides a Windows-friendly random text lab.

Commands

holytools version
holytools scan <path> [--json]
holytools stats <path> [--json]
holytools source-map <path> [--json]
holytools missing-includes <path> [--json]
holytools entrypoints <path> [--json]
holytools tokens <file>
holytools outline <file> [--json]
holytools symbols <path> [--json]
holytools find-symbol <path> <name> [--json]
holytools includes <path> [--json]
holytools include-graph <path> [--json]
holytools resolve-includes <path> [--json]
holytools dependency-order <path> [--json]
holytools reverse-includes <path> [--json]
holytools oracle [--preset core|after-egypt] [--voice plain|uncle] [--count N] [--seed N] [--corpus file.txt] [--json]
holytools oracle-keymap

Oracle Lab

holytools oracle
holytools oracle --seed 777 --count 3
holytools oracle --preset after-egypt --seed 777
holytools oracle --preset after-egypt --voice uncle --count 3
holytools oracle --corpus my-lines.txt --voice uncle --count 5
holytools oracle --json
holytools oracle-keymap

The oracle command is a TempleOS-inspired random text research tool. Voice mode is a display skin over random text, not an authority claim.

Build

cargo build --release -p holytools

Binary:

target/release/holytools.exe

Fast path

holytools source-map tests/fixtures/tiny
holytools missing-includes tests/fixtures/tiny
holytools entrypoints tests/fixtures/tiny
holytools oracle --preset after-egypt --voice uncle --seed 7 --count 2

Report pack

./scripts/report.ps1 tests/fixtures/tiny reports/tiny

version.txt

source-map.txt

source-map.json

missing-includes.txt

missing-includes.json

entrypoints.txt

entrypoints.json

dependency-order.txt

dependency-order.json

reverse-includes.txt

reverse-includes.json

Source archaeology

./scripts/run-archaeology.ps1 -TempleOS D:/src/TempleOS
./scripts/run-archaeology.ps1 -TempleOS D:/src/TempleOS -LoseThos D:/src/LoseThos -SparrowOS D:/src/SparrowOS
./scripts/run-archaeology.ps1 -LoseThos D:/src/LoseThos -DeepLoseThos

Output:

reports/archaeology/SUMMARY.md
reports/archaeology/templeos/
reports/archaeology/losethos/
reports/archaeology/sparrowos/

TempleOS archaeology evidence

include-resolve.md	include resolver proof
REVERSE.md	reverse include pressure
BOOT-CHAIN.md	StartOS source load chain
SPINE.md	root outline checkpoints
KERNEL-CONTRACT.md	KernelA public contract map
COMPILER-CONTRACT.md	CompilerA/B contract map
ADAM-MANIFEST.md	Adam top-level manifest
DESKTOP-SURFACE.md	Adam desktop and UI surface
ADAM-SUBSYSTEMS.md	second-level Adam subsystem manifests
ARCHAEOLOGY-FINDINGS.md	single-page findings summary

LoseThos archaeology evidence

include-resolve.md	legacy include alias resolver proof
REVERSE.md	reverse include pressure and gate hotspots
BOOT-CHAIN.md	load-chain checkpoints without TempleOS StartOS assumption
SPINE.md	root outline checkpoints
LOSETHOS-CONTRACT.md	OSMain, compiler, Adam, and boot-media source-contract map
LOSETHOS-CODEGEN-STATE.md	deep compiler codegen and fix-up grammar rollup
docs/LOSETHOS-CODEGEN-MILESTONE.md	sealed codegen archaeology milestone note
ARCHAEOLOGY-FINDINGS.md	single-page findings summary

Known TempleOS proof line

includes: 229
resolved-includes: 229
missing-includes: 0
pipeline: ok