[julian-goldstein]

Summary

dist/ is the whole output. The linked BPF object now lands at dist/bin/probe.bpf.o beside the bundle; bin/ at the project root is gone. A copied dist/ (index.js + bin/) runs on its own, and a final tarball step packs it into pkg/<name>-<version>-<arch>.tar.gz (name and version from package.json, arch from the toolchain). pkg/ is gitignored, removed by make clean, and holds one package per version and arch built.

✔ link       dist/bin/probe.bpf.o
✔ bundle     dist/index.js
✔ tarball    pkg/myproject-0.1.0-x86_64.tar.gz
✔ done       myproject (0.72s)

==> dist/bin/probe.bpf.o (7.9kb)
==> dist/index.js (15.4kb)
==> pkg/myproject-0.1.0-x86_64.tar.gz (7.7kb)

#/ is the one import root, replacing @/. It means src/: tsconfig maps it there for esbuild, package.json imports maps it there for the runtime, so every module also runs standalone with yeet run src/probes/x.js (the old @/ was bundle-time only, and the docs carried a caveat for it). The one exception is the #/bin/ prefix, the built-object dir, which package.json maps to dist/bin/. Nothing needs the bundle to run: make bpf then yeet run . runs the sources directly.

The object is imported, not located. import probe from "#/bin/probe.bpf.o" evaluates to a ready BpfObject (the daemon's BpfObjectRule wraps the file in new BpfObject({ exe })). In the bundle the import stays external and one esbuild alias rewrites the #/bin prefix to ./bin, so it points beside the bundle; any further object is just another #/bin/<name>.bpf.o import. This replaces the old exe: "../bin/probe.bpf.o", base: import.meta.dirname path, which only resolved from the bundle's location.

Kernel matrix stages veristat in .kmatrix/ (its own workspace) instead of bin/, locally and in CI, and the object path follows. README and AGENTS.md examples and alias notes updated throughout; clean prints one row per path; the step macro treats an empty exit status as failure (it previously let a broken command through).

Test plan

• Fresh scaffold: build, bundle contains ./bin/probe.bpf.o and no #/ reference, sources inlined.
• yeet run . in the tree; a copy of dist/ alone; the package unpacked into an empty dir — all start the TUI.
• make bpf alone, then yeet run . and yeet run src/main.jsx unbundled.
• yeet run src/probes/probe.js and src/probes/runqlat.js standalone (#/bin/* beats #/* at runtime, #/probes/… resolves).
• Bogus object path fails loudly with the resolved absolute path.
• Version bump in package.json yields a second package beside the first.
• make clean leaves no dist/, .build/ or pkg/; clean git status after build + clean; make -j4 from clean.
• esbuild prefix alias checked with two objects plus a #/lib source import.
• make veristat-matrix / CI kernel-matrix (boot VMs; not run).