asdf

Squash the current repository state back into one baseline commit while
preserving the README reframing and repository contents.

Constraint: User explicitly requested a single squashed commit with subject "asdf"
Confidence: high
Scope-risk: broad
Reversibility: clean
Directive: This commit intentionally rewrites published history; coordinate before future force-pushes
Tested: git status clean; local history rewritten to one commit; force-pushed main to origin and instructkr
Not-tested: Fresh clone verification after push

src/utils/bundledMode.ts

@@ -0,0 +1,22 @@
+/**
+ * Detects if the current runtime is Bun.
+ * Returns true when:
+ * - Running a JS file via the `bun` command
+ * - Running a Bun-compiled standalone executable
+ */
+export function isRunningWithBun(): boolean {
+  // https://bun.com/guides/util/detect-bun
+  return process.versions.bun !== undefined
+}
+
+/**
+ * Detects if running as a Bun-compiled standalone executable.
+ * This checks for embedded files which are present in compiled binaries.
+ */
+export function isInBundledMode(): boolean {
+  return (
+    typeof Bun !== 'undefined' &&
+    Array.isArray(Bun.embeddedFiles) &&
+    Bun.embeddedFiles.length > 0
+  )
+}