revspec 0.1.0 → 0.2.1

package/CLAUDE.md

@@ -0,0 +1,19 @@
+# Revspec
+
+- Tech: Bun + TypeScript + @opentui/core
+- npm: `revspec` | GitHub: icyrainz/revspec
+- Run: `bun run bin/revspec.ts <file.md>`
+- Test: `bun test`
+- Release: `./scripts/release.sh [patch|minor|major]`
+
+## OpenTUI Gotchas
+- Don't use StyledText for large content (BigInt FFI crash)
+- Don't use ANSI escape codes in TextRenderable content (renders as literal text)
+- MarkdownRenderable needs `syntaxStyle` + `conceal: true` for proper rendering
+- Use `visible: false` to hide renderables, not removal/re-addition
+
+## Conventions
+- Line mode is default, markdown mode via `m` toggle
+- Tab to submit in all text inputs (works through tmux)
+- Destructive actions need confirmation (dd double-tap, approve confirm dialog)
+- All review actions auto-switch to line mode

package/README.md

@@ -10,13 +10,17 @@ When an AI generates a spec, the human review step breaks the agentic loop. You
 
 Requires [Bun](https://bun.sh) (install: `curl -fsSL https://bun.sh/install | bash`).
 
+```bash
+bun install -g revspec
+```
+
+Or from source:
+
 ```bash
 git clone https://github.com/icyrainz/revspec.git
 cd revspec && bun install && bun link
 ```
 
-This adds `revspec` to your PATH.
-
 ## Usage
 
 ```bash

package/bin/revspec.ts

@@ -1,12 +1,36 @@
 #!/usr/bin/env bun
-import { existsSync, unlinkSync, readFileSync } from "fs";
+import { existsSync } from "fs";
 import { resolve, basename, extname, dirname, join } from "path";
-import { readReviewFile, readDraftFile } from "../src/protocol/read";
-import { writeReviewFile } from "../src/protocol/write";
-import { mergeDraftIntoReview } from "../src/protocol/merge";
+import { readReviewFile } from "../src/protocol/read";
 import { runTui } from "../src/tui/app";
+import { readEventsFromOffset } from "../src/protocol/live-events";
 
 const args = process.argv.slice(2);
+const subcommand = args[0];
+
+if (subcommand === "watch") {
+  const specFile = args[1];
+  if (!specFile) {
+    console.error("Usage: revspec watch <file.md>");
+    process.exit(1);
+  }
+  const { runWatch } = await import("../src/cli/watch");
+  await runWatch(specFile);
+  process.exit(0);
+}
+
+if (subcommand === "reply") {
+  const specFile = args[1];
+  const threadId = args[2];
+  const text = args[3];
+  if (!specFile || !threadId || !text) {
+    console.error('Usage: revspec reply <file.md> <threadId> "<text>"');
+    process.exit(1);
+  }
+  const { runReply } = await import("../src/cli/reply");
+  runReply(specFile, threadId, text);
+  process.exit(0);
+}
 
 if (args.length === 0 || args.includes("--help") || args.includes("-h")) {
   console.log("Usage: revspec <file.md> [--tui|--nvim|--web]");
@@ -14,7 +38,8 @@ if (args.length === 0 || args.includes("--help") || args.includes("-h")) {
 }
 
 if (args.includes("--version") || args.includes("-v")) {
-  console.log("revspec 0.1.0");
+  const pkg = await Bun.file(new URL("../package.json", import.meta.url)).json();
+  console.log(`revspec ${pkg.version}`);
   process.exit(0);
 }
 
@@ -31,70 +56,30 @@ if (!existsSync(specPath)) {
   process.exit(1);
 }
 
-// 2. Derive review/draft paths from spec filename
-//    e.g. spec.md -> spec.review.json, spec.review.draft.json
+// 2. Derive review/jsonl paths from spec filename
+//    e.g. spec.md -> spec.review.json, spec.review.live.jsonl
 const specDir = dirname(specPath);
 const specBase = basename(specPath, extname(specPath)); // e.g. "spec"
 const reviewPath = join(specDir, `${specBase}.review.json`);
+const jsonlPath = join(specDir, `${specBase}.review.live.jsonl`);
 const draftPath = join(specDir, `${specBase}.review.draft.json`);
 
-// 3. Check for corrupted draft — if exists but invalid JSON, warn and delete
-if (existsSync(draftPath)) {
-  let raw: string;
-  try {
-    raw = readFileSync(draftPath, "utf8");
-  } catch {
-    raw = "";
-  }
-  let parsedDraft: unknown = null;
-  let parseError = false;
-  try {
-    parsedDraft = JSON.parse(raw);
-    if (typeof parsedDraft !== "object" || parsedDraft === null) {
-      parseError = true;
-    }
-  } catch {
-    parseError = true;
-  }
-  if (parseError) {
-    process.stderr.write(
-      `Warning: Draft file is corrupted (invalid JSON), deleting: ${draftPath}\n`
-    );
-    unlinkSync(draftPath);
-  }
-}
-
-// 4. Launch TUI (skip if REVSPEC_SKIP_TUI=1)
+// 3. Launch TUI (skip if REVSPEC_SKIP_TUI=1)
 if (process.env.REVSPEC_SKIP_TUI !== "1") {
   await runTui(specPath, reviewPath, draftPath);
 }
 
-// 5. After TUI exits, read draft
-if (existsSync(draftPath)) {
-  const draft = readDraftFile(draftPath);
-
-  if (draft && draft.approved === true) {
-    // Approved — delete draft, print APPROVED, exit 0
-    unlinkSync(draftPath);
-    process.stdout.write(`APPROVED: ${reviewPath}\n`);
-    process.exit(0);
-  }
-
-  if (draft && draft.threads && draft.threads.length > 0) {
-    // Has threads — merge into review file, delete draft
-    const existingReview = readReviewFile(reviewPath);
-    const merged = mergeDraftIntoReview(existingReview, draft, specPath);
-    writeReviewFile(reviewPath, merged);
-    unlinkSync(draftPath);
-
-    // Output review path — draft had threads, so new comments were added
-    process.stdout.write(`${reviewPath}\n`);
+// 4. After TUI exits, check if approved via JSONL
+if (existsSync(jsonlPath)) {
+  const { events } = readEventsFromOffset(jsonlPath, 0);
+  const wasApproved = events.some(e => e.type === "approve");
+  if (wasApproved && existsSync(reviewPath)) {
+    console.log(`APPROVED: ${reviewPath}`);
     process.exit(0);
   }
 }
 
-// 6. No draft (or draft had no threads and wasn't approved)
-//    Check if existing review file has open/pending threads
+// 5. Check if review file exists with open/pending threads
 const existingReview = readReviewFile(reviewPath);
 if (existingReview) {
   const hasOpenOrPending = existingReview.threads.some(