@yaag/cli 0.1.2 → 0.2.0

package/src/interactive-run.ts

@@ -15,6 +15,7 @@ import type { RunViewResult, TreeState } from "@yaag/tui";
 import { createAltScreen } from "./alt-screen.ts";
 import { createFatalSignal, type FatalExit, type FatalSignal } from "./fatal-signal.ts";
 import { finalFrame } from "./final-frame.ts";
+import { writeChannel } from "./output-channel.ts";
 import { createPlainPresenter } from "./presenter.ts";
 import { errorText, executeOptions, formatResult, type RunFlags } from "./run-invocation.ts";
 import { type FinalOutput, startTreeApp, type TreeApp } from "./tree-app.ts";
@@ -146,8 +147,8 @@ export async function runInteractive(options: InteractiveRunOptions): Promise<nu
         startTreeApp({
           tui: createAltScreen(),
           stop,
-          writeStdout: (text) => process.stdout.write(text),
-          writeStderr: (text) => process.stderr.write(text),
+          writeStdout: (text) => writeChannel(process.stdout, text),
+          writeStderr: (text) => writeChannel(process.stderr, text),
         }),
       startRun: (events, signal) =>
         executeRun(options.program, executeOptions(options.flags, options.events(events), signal)),

package/src/output-channel.ts

@@ -0,0 +1,35 @@
+/**
+ * Best-effort writes to the Run's output channels (architecture §9, ADR-0031).
+ *
+ * The Orchestrator is detached from its Host Session. When that session dies,
+ * stdout, stderr, and the events descriptor become broken pipes. A write to a
+ * broken pipe must not end the Run: it becomes a no-op, the Run keeps going as
+ * an Orphaned Run, and `yaag_stop` remains the way to end one.
+ */
+import { writeSync } from "node:fs";
+
+const silenced = new WeakSet<NodeJS.WriteStream>();
+
+/** Writes one chunk to a stream; a broken or failed pipe is ignored. */
+export function writeChannel(stream: NodeJS.WriteStream, text: string): void {
+  // A stream reports a broken pipe asynchronously, and an unheard `error`
+  // event ends the process. One no-op listener per stream absorbs it.
+  if (!silenced.has(stream)) {
+    silenced.add(stream);
+    stream.on("error", () => {});
+  }
+  try {
+    stream.write(text);
+  } catch {
+    // The Host Session closed the pipe; the Run continues without an observer.
+  }
+}
+
+/** Writes one whole line to a descriptor; a broken or failed pipe is ignored. */
+export function writeChannelFd(fd: number, text: string): void {
+  try {
+    writeSync(fd, text);
+  } catch {
+    // The Host Session closed the descriptor; the Run continues without an observer.
+  }
+}

package/src/presenter.ts

@@ -5,6 +5,7 @@
  * gets the interactive alt-screen tree instead (`tree-app.ts`).
  */
 import type { StampedEventSink } from "@yaag/runtime";
+import { writeChannel } from "./output-channel.ts";
 import { type PlainRenderMode, renderEvent } from "./render.ts";
 
 /**
@@ -24,7 +25,7 @@ export function createPlainPresenter(quiet: boolean): EventPresenter {
   return {
     present: (event) => {
       const rendered = renderEvent(event, mode);
-      if (rendered !== null) process.stderr.write(`${rendered}\n`);
+      if (rendered !== null) writeChannel(process.stderr, `${rendered}\n`);
     },
     dispose: () => {},
   };

package/src/runtime-alias.ts

@@ -1,11 +1,3 @@
-import { fileURLToPath } from "node:url";
-
-const runtimeEntry = fileURLToPath(
-  new URL("../../../packages/runtime/src/index.ts", import.meta.url),
-);
-const typeboxEntry = fileURLToPath(
-  new URL("../node_modules/typebox/build/index.mjs", import.meta.url),
-);
 const runtimeValues = [
   "CASSETTE_VERSION",
   "loadCassette",
@@ -39,6 +31,12 @@ let registered = false;
  */
 export function registerRuntimeAlias(): void {
   if (registered) return;
+  // Resolved from this CLI package (ADR-0018), so each entry is the same copy
+  // the CLI itself imports in the monorepo layout and in the published npm
+  // layout, where typebox is hoisted and no packages/ sibling exists. A
+  // failure here means a corrupt CLI install, so Bun's ResolveMessage stands.
+  const runtimeEntry = Bun.resolveSync("@yaag/runtime", import.meta.dir);
+  const typeboxEntry = Bun.resolveSync("typebox", import.meta.dir);
   Bun.plugin({
     name: "yaag-runtime-entry-alias",
     setup(build) {