ship-or-theater 1.0.0 → 1.0.1

package/CHANGELOG.md

@@ -5,6 +5,18 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.0.1] - 2026-11-07
+
+### Changed
+- Updated `package.json`, CLI `--help`, and MCP `evaluate_claim` descriptions to begin with the plain-English summary: *"Paste in an AI claim you saw online and get a straight answer, with evidence: real (SHIPS), half-true (MIXED) or hype (THEATER)."*
+- Landing page, README and social card now say who it's for and why; phone menu links to Principles.
+- Upgraded `@anthropic-ai/sdk` from `^0.39.0` to `^1.6.0`, removing the transitive `formdata-node` / `node-domexception@1.0.0` install deprecation warning.
+- `VERSION` is now read from `package.json` at runtime so CLI and MCP version metadata cannot drift from the package manifest.
+
+### Fixed
+- `npx ship-or-theater "<claim>" > file` from Git Bash on Windows could exit 0 with an empty file. The CLI now waits for `stdout` to finish writing (and drain) before it exits; verified with a real run through `npx` in Git Bash. `--out <file>` remains the most robust way to save a scorecard.
+- Output write errors (for example a closed pipe) are reported on `stderr` with exit code `1` instead of crashing.
+
 ## [1.0.0] - 2026-11-07
 
 ### Added

package/README.md

@@ -1,3 +1,13 @@
+<!-- sot:readme-pitch:start -->
+# Saw an AI claim that sounds too good to be true?
+
+Paste in an AI claim you saw online and get a straight answer, with evidence: real (SHIPS), half-true (MIXED) or hype (THEATER).
+
+- Reading a launch post? Find out what actually shipped.
+- Vetting a vendor demo? See what the evidence supports.
+- Checking a headline before you share it? Get the reasons first.
+<!-- sot:readme-pitch:end -->
+
 <div align="center">
 
 <img src="assets/logo.svg" alt="ship or theater" width="360">

package/dist/cli.d.ts

@@ -1,11 +1,13 @@
-import { L as LLM } from './llm-gKw2aSfQ.js';
+import { L as LLM } from './llm-BDKu9GhU.js';
 import '@anthropic-ai/sdk';
 import 'zod';
 
 interface CliStream {
     isTTY?: boolean;
     columns?: number;
-    write: (chunk: string) => boolean;
+    write: (chunk: string, callback?: (error?: Error | null) => void) => boolean;
+    once?: (event: string, listener: (...args: unknown[]) => void) => unknown;
+    off?: (event: string, listener: (...args: unknown[]) => void) => unknown;
 }
 interface CliIO {
     stdout?: CliStream;
@@ -13,6 +15,11 @@ interface CliIO {
     env?: NodeJS.ProcessEnv;
     llmOverride?: LLM;
 }
+/**
+ * Write a chunk to stdout and wait for both the write callback and stream
+ * drain when backpressure occurs on a pipe or redirected file descriptor.
+ */
+declare function writeStdout(stream: CliStream, chunk: string): Promise<void>;
 declare function runCli(argv: string[], io?: CliIO): Promise<number>;
 
-export { type CliIO, type CliStream, runCli };
+export { type CliIO, type CliStream, runCli, writeStdout };

package/dist/cli.js

@@ -5,9 +5,21 @@ import { writeFile } from "fs/promises";
 import { Command } from "commander";
 
 // src/llm.ts
+import { readFileSync } from "fs";
 import Anthropic from "@anthropic-ai/sdk";
 import "zod";
-var VERSION = "1.0.0";
+function readPackageVersion(pkgUrl = new URL("../package.json", import.meta.url)) {
+  try {
+    const raw = readFileSync(pkgUrl, "utf8");
+    const parsed = JSON.parse(raw);
+    if (typeof parsed.version === "string" && parsed.version.trim().length > 0) {
+      return parsed.version.trim();
+    }
+  } catch {
+  }
+  return "1.0.1";
+}
+var VERSION = readPackageVersion();
 var DEFAULT_MODEL = "claude-sonnet-5-5";
 function resolveModel() {
   const fromEnv = process.env.SOT_MODEL?.trim();
@@ -1226,6 +1238,68 @@ function createProgressReporter(stream = process.stderr, options = {}) {
 }
 
 // src/cli.ts
+async function writeStdout(stream, chunk) {
+  await new Promise((resolve, reject) => {
+    let settled = false;
+    let writeReturned = false;
+    let writeDone = false;
+    let drainDone = true;
+    const cleanup = (keepErrorListener = false) => {
+      if (typeof stream.off === "function") {
+        stream.off("drain", onDrain);
+        if (!keepErrorListener) stream.off("error", onError);
+      }
+    };
+    const finish = (err) => {
+      if (settled) return;
+      if (err) {
+        settled = true;
+        cleanup(true);
+        reject(err instanceof Error ? err : new Error(String(err)));
+        return;
+      }
+      if (writeReturned && writeDone && drainDone) {
+        settled = true;
+        cleanup();
+        resolve();
+      }
+    };
+    const onDrain = () => {
+      drainDone = true;
+      finish();
+    };
+    const onError = (err) => {
+      finish(err ?? new Error("stdout stream error"));
+    };
+    if (typeof stream.once === "function") {
+      stream.once("error", onError);
+    }
+    try {
+      const expectsCallback = stream.write.length >= 2;
+      const flushed = expectsCallback ? stream.write(chunk, (err) => {
+        if (err) {
+          finish(err);
+          return;
+        }
+        writeDone = true;
+        finish();
+      }) : stream.write(chunk);
+      if (!expectsCallback) {
+        writeDone = true;
+      }
+      if (!flushed && typeof stream.once === "function") {
+        drainDone = false;
+      }
+      writeReturned = true;
+      if (!drainDone && typeof stream.once === "function") {
+        stream.once("drain", onDrain);
+      }
+      finish();
+    } catch (err) {
+      finish(err);
+    }
+  });
+}
 async function runCli(argv, io = {}) {
   const stdout = io.stdout ?? process.stdout;
   const stderr = io.stderr ?? process.stderr;
@@ -1233,7 +1307,7 @@ async function runCli(argv, io = {}) {
   let exitCode = 0;
   const program = new Command();
   program.name("ship-or-theater").version(VERSION, "-V, --version", "print the package version").description(
-    "Evaluate an AI claim against a fixed reality rubric and render a scorecard."
+    "Paste in an AI claim you saw online and get a straight answer, with evidence: real (SHIPS), half-true (MIXED) or hype (THEATER)."
   ).argument(
     "[claim]",
     "the AI claim, announcement, or demo description to evaluate (or 'rubric' to print the fixed rubric)"
@@ -1280,12 +1354,19 @@ async function runCli(argv, io = {}) {
         color: useColor,
         width
       });
-      if (options.out) {
-        await writeFile(options.out, rubricText, "utf8");
-        stderr.write(`Rubric written to ${options.out}
+      try {
+        if (options.out) {
+          await writeFile(options.out, rubricText, "utf8");
+          stderr.write(`Rubric written to ${options.out}
 `);
-      } else {
-        stdout.write(rubricText + "\n");
+        } else {
+          await writeStdout(stdout, rubricText + "\n");
+        }
+      } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        stderr.write(`Failed to write output: ${message}
+`);
+        exitCode = 1;
       }
       return;
     }
@@ -1334,12 +1415,19 @@ async function runCli(argv, io = {}) {
       progress.clear();
     }
     const output = format === "json" ? toJSON(scorecard) : format === "pretty" ? renderTerminal(scorecard, { color: useColor, width }) : renderMarkdown(scorecard);
-    if (options.out) {
-      await writeFile(options.out, output, "utf8");
-      stderr.write(`Scorecard written to ${options.out}
+    try {
+      if (options.out) {
+        await writeFile(options.out, output, "utf8");
+        stderr.write(`Scorecard written to ${options.out}
 `);
-    } else {
-      stdout.write(output + "\n");
+      } else {
+        await writeStdout(stdout, output + "\n");
+      }
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      stderr.write(`Failed to write output: ${message}
+`);
+      exitCode = 1;
     }
   });
   try {
@@ -1367,6 +1455,7 @@ if (!process.env.VITEST) {
   });
 }
 export {
-  runCli
+  runCli,
+  writeStdout
 };
 //# sourceMappingURL=cli.js.map