T-OQAT-dev-shim-says-run-bun-install
State: planning/draft · Impact: medium · Complexity: small
The ~/.local/bin/sdlc shim runs the source of whichever checkout you are in. After a
fast-forward that adds a dependency, every command crashes with Cannot find package 'smol-toml' until someone runs bun install. The fix is a clear message, not a crash.
The shim (solutions/ontological/cli/sdlc, dev-checkout layer) execs the checkout’s source
directly. A missing package surfaces as a raw module-resolution stack trace.
Proposed
Section titled “Proposed”When the dev-checkout source fails because a package is missing, sdlc prints one line naming the
checkout and saying to run bun install there, then exits non-zero.
Approach
Section titled “Approach”- Find where the dev-checkout layer starts the source entry.
- Catch module-not-found for a package (not a relative import) at startup and print the hint.
- Test with a temp checkout missing one dependency.
| Area | Note |
|---|---|
solutions/ontological/cli/ | Launcher and node/bun entry |
Acceptance criteria
Section titled “Acceptance criteria”- AC-1: With a dependency removed from
node_modules,sdlc --versionfrom that checkout prints thebun installhint instead of a stack trace. - AC-2: The installed (non-dev) copy is unaffected.
Out of scope
Section titled “Out of scope”- Running
bun installautomatically.