lanekeeper 0.1.5 → 0.1.7

package/README.md

@@ -49,30 +49,6 @@ GitHub already ships a merge queue. Two things it costs you that this doesn't:
 Same idea — serialize landings, test before merge, keep history clean — run
 locally instead of in someone else's billed cloud. 💸
 
-## 🧭 Prior art (so you don't have to wonder)
-
-Nothing here was invented in isolation — worth naming what already existed
-before you find it yourself:
-
-- **[block/agent-task-queue](https://github.com/block/agent-task-queue)**
-  already solves "concurrent agents thrash your machine running simultaneous
-  builds," standalone, with no git or worktree awareness at all.
-  `build-lock` here does the same narrow job, just wired into `land` and
-  lanes instead of running on its own.
-- **[Overstory](https://github.com/jayminwest/overstory)** (now archived)
-  built a FIFO merge queue plus a liveness-based watchdog for a fleet of
-  coding agents — the closest prior match to the landing queue and `prune`
-  here. It's a bigger, multi-runtime orchestration framework with its own
-  agent/worktree layer, not something that plugs into Claude Code's *native*
-  `--worktree`/hook system the way this does; its stated successor moved to
-  a hosted, cloud control-plane model.
-
-What I couldn't find shipped anywhere else, as of this writing: this
-specific combination — sitting on top of Claude Code's own worktree hook
-instead of reimplementing it, a landing queue enforced at the git pre-push
-hook layer, and liveness-aware auto-pruning — as one small, zero-cost, local
-package. If you know of one, open an issue.
-
 ## 🧰 What's in the box
 
 | Command | What it does |
@@ -126,17 +102,11 @@ This does the whole setup, not just the config file:
 - **`.husky/pre-push`** — created or appended to, *if* you already have
   Husky. If you don't, `init` tells you so instead of silently writing to
   the untracked, not-shared-with-your-team `.git/hooks/pre-push`.
+- **`package.json` scripts** — `land`, `sync`, `promote`, `preview`, and
+  `preview:restore` added, skipping any you've already defined yourself.
 
-**Commit everything it wrote.** Then add to `package.json`:
-```json
-"scripts": {
-  "land": "lanekeeper land",
-  "sync": "lanekeeper sync",
-  "promote": "lanekeeper promote",
-  "preview": "lanekeeper preview",
-  "preview:restore": "lanekeeper preview --restore"
-}
-```
+**Commit everything it wrote**, then you're running. Two steps, not a setup
+guide.
 
 If `init` couldn't detect a `checkCommand` (no matching script in
 package.json), every push is **blocked** until you set one — see 🧰 What's

package/dist/bin/lanekeeper.js

@@ -16,7 +16,7 @@ import { runWorktreeCreateHook } from "../hooks/worktree-create.js";
 import { lanePort } from "../lib/lane-port.js";
 import { claudeMdSnippet, MARKER } from "../lib/claude-md-snippet.js";
 import { detectCheckCommand, runCheckCommand } from "../lib/check-command.js";
-import { wireClaudeSettings, wireHuskyPrePush, ensureHooksPath } from "../lib/wire-hooks.js";
+import { wireClaudeSettings, wireHuskyPrePush, ensureHooksPath, wirePackageJsonScripts } from "../lib/wire-hooks.js";
 import { resolveMainCheckout } from "../lib/main-checkout.js";
 import { pruneLandedLanes } from "../lib/prune-lanes.js";
 const [, , command, ...rest] = process.argv;
@@ -139,13 +139,27 @@ export default ${JSON.stringify(generated, null, 2)};
                 break;
         }
     }
+    const scriptsResult = wirePackageJsonScripts(root);
+    switch (scriptsResult.result) {
+        case "added":
+            console.log(`lanekeeper init: added "${scriptsResult.added.join('", "')}" to package.json scripts.`);
+            break;
+        case "already-wired":
+            console.log("lanekeeper init: package.json already has all five scripts — leaving them alone.");
+            break;
+        case "no-package-json":
+            console.log("lanekeeper init: no package.json found — scripts NOT wired automatically.");
+            console.log('  Add "land"/"sync"/"promote"/"preview"/"preview:restore" -> "lanekeeper <name>" yourself.');
+            break;
+        case "unparseable":
+            console.log("lanekeeper init: package.json exists but isn't valid JSON — left untouched. Wire the scripts manually.");
+            break;
+    }
     console.log("");
     console.log("Next steps:");
-    console.log("  1. Check lanekeeper.config.mjs — integrationBranch/checkCommand were auto-detected;");
-    console.log("     set productionBranch too if you run a two-stage model.");
-    console.log('  2. Add to package.json "scripts": land, sync, promote, preview -> "lanekeeper <name>".');
-    console.log("  3. Commit lanekeeper.config.mjs, CLAUDE.md, .claude/settings.json, and .husky/pre-push.");
-    console.log("  4. claude --worktree <name> — the agent takes it from there.");
+    console.log("  1. Commit everything it wrote — lanekeeper.config.mjs, CLAUDE.md, .claude/settings.json,");
+    console.log("     .husky/pre-push, and package.json.");
+    console.log("  2. claude --worktree <name> — the agent takes it from there.");
 }
 async function main() {
     switch (command) {

package/dist/lib/wire-hooks.d.ts

@@ -24,3 +24,16 @@ export type HooksPathResult = "set" | "already-set" | "custom-path";
  * husky's own next real install corrects it to `.husky/_`.
  */
 export declare function ensureHooksPath(root: string): HooksPathResult;
+export type ScriptsWireResult = "added" | "already-wired" | "unparseable" | "no-package-json";
+/**
+ * The last "copy this yourself" step `init` used to leave on the table:
+ * Quickstart told you to hand-add five scripts to package.json instead of
+ * just adding them. Same additive/idempotent contract as the rest of this
+ * file — only ever fills in scripts that don't exist yet, never overwrites
+ * one you've customized (e.g. if `land` already runs something of yours
+ * first), and does nothing if all five are already there.
+ */
+export declare function wirePackageJsonScripts(root: string): {
+    result: ScriptsWireResult;
+    added: string[];
+};

package/dist/lib/wire-hooks.js

@@ -15,6 +15,13 @@ import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
 const HOOK_COMMAND = "npx lanekeeper hook worktree-create";
 const PRE_PUSH_MARKER = "lanekeeper check-push";
+const PACKAGE_SCRIPTS = {
+    land: "lanekeeper land",
+    sync: "lanekeeper sync",
+    promote: "lanekeeper promote",
+    preview: "lanekeeper preview",
+    "preview:restore": "lanekeeper preview --restore",
+};
 export function wireClaudeSettings(root) {
     const dir = join(root, ".claude");
     const path = join(dir, "settings.json");
@@ -121,3 +128,35 @@ export function ensureHooksPath(root) {
     execFileSync("git", ["config", "core.hooksPath", ".husky"], { cwd: root });
     return "set";
 }
+/**
+ * The last "copy this yourself" step `init` used to leave on the table:
+ * Quickstart told you to hand-add five scripts to package.json instead of
+ * just adding them. Same additive/idempotent contract as the rest of this
+ * file — only ever fills in scripts that don't exist yet, never overwrites
+ * one you've customized (e.g. if `land` already runs something of yours
+ * first), and does nothing if all five are already there.
+ */
+export function wirePackageJsonScripts(root) {
+    const path = join(root, "package.json");
+    if (!existsSync(path))
+        return { result: "no-package-json", added: [] };
+    let pkg;
+    try {
+        pkg = JSON.parse(readFileSync(path, "utf8"));
+    }
+    catch {
+        return { result: "unparseable", added: [] };
+    }
+    pkg.scripts ??= {};
+    const added = [];
+    for (const [name, command] of Object.entries(PACKAGE_SCRIPTS)) {
+        if (!(name in pkg.scripts)) {
+            pkg.scripts[name] = command;
+            added.push(name);
+        }
+    }
+    if (added.length === 0)
+        return { result: "already-wired", added: [] };
+    writeFileSync(path, JSON.stringify(pkg, null, 2) + "\n");
+    return { result: "added", added };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lanekeeper",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "description": "The local, zero-cost merge queue for parallel Claude Code agents. Plugs into Claude Code's native worktree isolation; one build at a time, one landing at a time, zero races.",
   "type": "module",
   "license": "MIT",