guidiff 0.2.2

package/README.md

@@ -0,0 +1,71 @@
+# guidiff
+
+**Guided local code review.** A GitHub-like diff UI that runs on your machine,
+with a reading guide that tells you where to start — and a blocking CLI that
+returns your review straight to the AI session that launched it.
+
+> guidiff = guide + diff
+
+## Why
+
+- Review AI-written code *before* it becomes a PR, in a UI your eyes already know.
+- A reading guide orders the diff by importance: core changes first,
+  lockfile churn last.
+- Launched from a Claude Code session, the review result (verdict + line comments)
+  lands back in that exact session — no copy-paste, no wrong-window mistakes.
+
+## Install
+
+```bash
+npm install -g guidiff   # or: npx guidiff / bunx guidiff
+```
+
+Prebuilt binaries for macOS (arm64/x64) and Linux (x64/arm64). No Bun required.
+
+Or build from source:
+
+```bash
+git clone https://github.com/hatappi/guidiff && cd guidiff
+bun install && bun run build:binary
+mv guidiff ~/.local/bin/   # or anywhere on your PATH
+```
+
+A Homebrew package is planned.
+
+## Usage
+
+```bash
+guidiff                  # review uncommitted changes (working tree vs HEAD)
+guidiff main feature     # review a ref range
+guidiff main..HEAD       # range syntax works too
+guidiff --guide g.json   # attach a reading guide
+```
+
+Exit codes: `0` submitted (result JSON on stdout) / `1` error / `2` cancelled.
+stdout carries **only** the result JSON; all logs go to stderr.
+
+## Claude Code plugin
+
+```
+/plugin marketplace add hatappi/guidiff
+/plugin install guidiff@guidiff
+```
+
+Then ask Claude: *"guidiff でレビューして"* / *"review this with guidiff"*.
+The session generates a guide for its own changes, opens the UI, and acts on
+your verdict and comments when you submit.
+
+## Development
+
+```bash
+bun install
+bun test packages/schema packages/cli && bun test --cwd packages/ui
+bun packages/cli/src/index.ts . --no-open   # run from source
+bun run build:binary                         # single binary ./guidiff
+```
+
+## Release (maintainers)
+
+1. Bump `version` in the root `package.json` and commit.
+2. `npm login` (once) — publishing needs the npmjs.com `guidiff` org.
+3. `bun run release --dry-run` to inspect the packages, then `bun run release`.

package/bin/guidiff.js

@@ -0,0 +1,40 @@
+#!/usr/bin/env node
+'use strict';
+const { spawnSync } = require('node:child_process');
+
+const PACKAGES = {
+  "darwin-arm64": "@guidiff/cli-darwin-arm64",
+  "darwin-x64": "@guidiff/cli-darwin-x64",
+  "linux-x64": "@guidiff/cli-linux-x64",
+  "linux-arm64": "@guidiff/cli-linux-arm64"
+};
+
+const key = process.platform + '-' + process.arch;
+const pkg = PACKAGES[key];
+if (!pkg) {
+  console.error('guidiff: unsupported platform: ' + key);
+  console.error('Supported platforms: ' + Object.keys(PACKAGES).join(', '));
+  process.exit(1);
+}
+
+let bin;
+try {
+  bin = require.resolve(pkg + '/bin/guidiff');
+} catch {
+  console.error('guidiff: binary package ' + pkg + ' is not installed.');
+  console.error('Reinstall guidiff without disabling optional dependencies.');
+  process.exit(1);
+}
+
+const result = spawnSync(bin, process.argv.slice(2), { stdio: 'inherit' });
+if (result.error) {
+  console.error('guidiff: failed to run binary: ' + result.error.message);
+  process.exit(1);
+}
+if (result.signal) {
+  // Re-raise the child's fatal signal so callers see 128+n. On the POSIX
+  // platforms we ship, the self-directed signal is delivered before
+  // process.kill returns, so the exit below is never reached in this case.
+  process.kill(process.pid, result.signal);
+}
+process.exit(result.status === null ? 1 : result.status);

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "guidiff",
+  "version": "0.2.2",
+  "description": "Guided local code review — a GitHub-like diff UI with an AI reading guide",
+  "keywords": [
+    "code-review",
+    "diff",
+    "git",
+    "cli",
+    "ai"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/hatappi/guidiff.git"
+  },
+  "homepage": "https://github.com/hatappi/guidiff#readme",
+  "license": "MIT",
+  "bin": {
+    "guidiff": "bin/guidiff.js"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "optionalDependencies": {
+    "@guidiff/cli-darwin-arm64": "0.2.2",
+    "@guidiff/cli-darwin-x64": "0.2.2",
+    "@guidiff/cli-linux-x64": "0.2.2",
+    "@guidiff/cli-linux-arm64": "0.2.2"
+  }
+}