adb-toolkit/proprietary/README.md

Proprietary — DO NOT publish to GitHub

These are the closed-source parts of ATK (the Logcat visual map / live system telemetry engine). They build into the shipped binary (obfuscated JS + native Go), but their source is never committed/pushed to the public repo. .gitignore keeps them untracked.

Live files that are PROPRIETARY (kept in their build locations, gitignored)

• frontend/src/lib/logcatgraph.ts — the data engine (graph model, layout, particles, decay, tree/geometry placement)
• frontend/src/components/views/LogcatMap.tsx — the Canvas / Neon / 3D renderers + UI
• backend_logcatpatterns.go — the relationship-mining heuristics (ported from TS to native Go)

Shared files that contain map hooks (these DO ship publicly)

• backend_logcat.go — calls lcpExtractRefs/lcpExtractMentions, LogRef struct
• frontend/src/lib/types.ts — LogRef / RefKind + LogcatLine.refs/mentions
• frontend/src/components/views/ViewLogcat.tsx — Text/Map toggle + mounts <LogcatMap>
• frontend/vite.config.ts — obfuscation config (lists the map files)
• frontend/package.json — pixi.js, three deps
• main.go — ensureWebGLEnv

A public clone without these files will not compile (backend_logcat.go calls lcpExtractRefs/LogRef; ViewLogcat.tsx imports <LogcatMap>). Graceful map-less degradation is still a future task.

How releases are built

Locally, by hand. There is no GitHub Actions auto-build — a public-repo CI can't compile the map (these files aren't in the repo) and we don't want a private repo / token setup. Build the .deb on your own machine (where the full source lives) and upload it to the GitHub Release manually. Linux only.

backups/

Original source of anything ported to another language, kept for future work.

• backups/logcatpatterns.ts — the pre-Go-port TS of the relationship miner. Convention: whenever we port TS → Go, drop the original TS here so we never lose the readable version. If you change the Go, mirror the logic back here.