tourdiff 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Almas Akchabayev
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,64 @@
+# tour
+
+Local code review tool with AI annotations: a TUI and a webapp over a pinned git diff. Agents author annotations through a CLI; humans read them.
+
+## Install
+
+```sh
+npm i -g tourdiff
+# or
+bun add -g tourdiff
+```
+
+Verify:
+
+```sh
+tour --version
+```
+
+## Quickstart
+
+```sh
+cd your-repo
+tour create --head HEAD              # tour the latest commit
+tour                                  # open the TUI
+tour serve --open                     # or open the webapp at http://127.0.0.1:7777
+```
+
+Tours live in `.tour/<id>/` (auto-gitignored on first create). Each holds a `tour.toml` and an append-only `annotations.jsonl`.
+
+## For agents
+
+No global install needed in foreign repos:
+
+```sh
+bunx tourdiff create --head HEAD --json
+bunx tourdiff annotate <id> --file src/foo.ts --side additions --line 12 --body "..."
+```
+
+Or via npm:
+
+```sh
+npx -y tourdiff create --head HEAD --json
+```
+
+## Commands
+
+```
+tour create --head <ref> [--base <ref>] [--title <s>] [--json]
+tour annotate <id> --file <f> --side additions|deletions --line <n[-m]> --body <b> [--author <a>] [--json]
+tour annotate <id> --batch -                         # read JSONL annotations from stdin
+tour list [--status open|closed|all] [--json]
+tour show <id> [--json]
+tour close <id>                                       # mark closed; keeps files
+tour delete <id>                                      # remove the tour
+tour prune --older-than 30d                           # bulk-delete by age
+tour tui [<id>]                                       # explicit TUI launch
+tour serve [--port 7777] [--open] [<id>]              # webapp
+```
+
+`--head WIP` snapshots uncommitted work to a synthetic commit so the diff stays pinned.
+
+## License
+
+MIT — see [LICENSE](./LICENSE).

package/package.json

@@ -0,0 +1,75 @@
+{
+  "name": "tourdiff",
+  "version": "0.1.0",
+  "description": "Local code review tool with AI annotations: TUI + webapp over a pinned git diff.",
+  "type": "module",
+  "license": "MIT",
+  "author": "Almas Akchabayev",
+  "homepage": "https://github.com/a9a4k/tour#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/a9a4k/tour.git"
+  },
+  "bugs": {
+    "url": "https://github.com/a9a4k/tour/issues"
+  },
+  "keywords": [
+    "code-review",
+    "diff",
+    "git",
+    "annotations",
+    "ai",
+    "agents",
+    "tui",
+    "cli"
+  ],
+  "bin": {
+    "tour": "scripts/cli.cjs"
+  },
+  "files": [
+    "scripts/cli.cjs",
+    "scripts/resolveBinary.cjs",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "cli": "bun src/main.ts",
+    "build:darwin-arm64": "bun scripts/build-binary.ts bun-darwin-arm64 dist/binaries/darwin-arm64/tour",
+    "build:darwin-x64":   "bun scripts/build-binary.ts bun-darwin-x64   dist/binaries/darwin-x64/tour",
+    "build:linux-arm64":  "bun scripts/build-binary.ts bun-linux-arm64  dist/binaries/linux-arm64/tour",
+    "build:linux-x64":    "bun scripts/build-binary.ts bun-linux-x64    dist/binaries/linux-x64/tour",
+    "build:windows-x64":  "bun scripts/build-binary.ts bun-windows-x64  dist/binaries/windows-x64/tour.exe",
+    "build:all": "bun run build:darwin-arm64 && bun run build:darwin-x64 && bun run build:linux-arm64 && bun run build:linux-x64 && bun run build:windows-x64",
+    "assemble": "bun scripts/assemble-packages.ts"
+  },
+  "optionalDependencies": {
+    "tourdiff-darwin-arm64": "0.1.0",
+    "tourdiff-darwin-x64": "0.1.0",
+    "tourdiff-linux-arm64": "0.1.0",
+    "tourdiff-linux-x64": "0.1.0",
+    "tourdiff-windows-x64": "0.1.0"
+  },
+  "devDependencies": {
+    "@ai-hero/sandcastle": "^0.5.10",
+    "@opentui/react": "^0.2.5",
+    "@pierre/diffs": "^1.1.21",
+    "@types/node": "^22.0.0",
+    "@types/react": "^19.2.0",
+    "@types/react-dom": "^19.0.0",
+    "@types/react-reconciler": "^0.33.0",
+    "hunkdiff": "^0.10.0",
+    "mermaid": "^11.14.0",
+    "react": "^19.2.0",
+    "react-dom": "^19.0.0",
+    "react-markdown": "^10.1.0",
+    "react-reconciler": "^0.33.0",
+    "remark-gfm": "^4.0.1",
+    "smol-toml": "^1.6.1",
+    "tsx": "^4.19.0",
+    "typescript": "^5.8.0",
+    "vitest": "^3.2.1"
+  }
+}

package/scripts/cli.cjs

@@ -0,0 +1,43 @@
+#!/usr/bin/env node
+
+const { spawn } = require("node:child_process");
+const { resolveBinaryPath } = require("./resolveBinary.cjs");
+
+let binaryPath;
+try {
+  binaryPath = resolveBinaryPath();
+} catch {
+  console.error(`tour: no prebuilt binary for ${process.platform}-${process.arch}.`);
+  console.error(`Supported: darwin-arm64, darwin-x64, linux-arm64, linux-x64, windows-x64.`);
+  process.exit(1);
+}
+
+const rawArgs = process.argv.slice(2);
+const cleanedArgs = rawArgs.filter((arg) => {
+  if (arg === binaryPath) return false;
+  try {
+    const pattern = /node_modules[/\\]tourdiff-(darwin|linux|windows)-[^/\\]+[/\\]tour(\.exe)?$/i;
+    return !pattern.test(arg);
+  } catch {
+    return true;
+  }
+});
+
+const child = spawn(binaryPath, cleanedArgs, {
+  stdio: "inherit",
+  windowsHide: true,
+});
+
+child.on("exit", (code) => {
+  process.exit(code || 0);
+});
+
+child.on("error", (err) => {
+  if (err.code === "ENOENT") {
+    console.error(`tour: binary not found at ${binaryPath}`);
+    console.error(`Re-install for your platform (${process.platform}-${process.arch}).`);
+  } else {
+    console.error("tour: failed to start:", err);
+  }
+  process.exit(1);
+});

package/scripts/resolveBinary.cjs

@@ -0,0 +1,33 @@
+function mapPlatform(platform = process.platform) {
+  switch (platform) {
+    case "win32":
+      return "windows";
+    case "darwin":
+    case "linux":
+      return platform;
+    default:
+      return platform;
+  }
+}
+
+function mapArch(arch = process.arch) {
+  switch (arch) {
+    case "x64":
+    case "arm64":
+      return arch;
+    default:
+      return arch;
+  }
+}
+
+function getPackageName(platform = process.platform, arch = process.arch) {
+  return `tourdiff-${mapPlatform(platform)}-${mapArch(arch)}`;
+}
+
+function resolveBinaryPath(platform = process.platform, arch = process.arch) {
+  const packageName = getPackageName(platform, arch);
+  const binary = `tour${platform === "win32" ? ".exe" : ""}`;
+  return require.resolve(`${packageName}/${binary}`);
+}
+
+module.exports = { getPackageName, resolveBinaryPath };