lanekeeper 0.1.7 → 0.1.8

package/dist/bin/lanekeeper.js

@@ -34,10 +34,15 @@ async function init() {
     }
     const { writeFileSync, readFileSync: read, existsSync, appendFileSync } = await import("node:fs");
     const { join } = await import("node:path");
+    // What actually got newly written or modified this run — only these need
+    // committing. If everything below was already wired from a previous run,
+    // there's nothing new to tell you to commit.
+    const writtenFiles = [];
     if (hasConfig(root)) {
         console.log("lanekeeper init: lanekeeper.config.mjs already exists — leaving it alone.");
     }
     else {
+        writtenFiles.push("lanekeeper.config.mjs");
         const detectedBranch = detectCurrentBranch(root);
         const detectedCheck = detectCheckCommand(root);
         const generated = {
@@ -80,10 +85,12 @@ export default ${JSON.stringify(generated, null, 2)};
     if (!existsSync(claudeMdPath)) {
         writeFileSync(claudeMdPath, `# Project instructions for Claude Code\n\n${snippet}`);
         console.log(`lanekeeper init: wrote ${claudeMdPath}`);
+        writtenFiles.push("CLAUDE.md");
     }
     else if (!read(claudeMdPath, "utf8").includes(MARKER)) {
         appendFileSync(claudeMdPath, `\n${snippet}`);
         console.log(`lanekeeper init: appended the LaneKeeper workflow section to ${claudeMdPath}`);
+        writtenFiles.push("CLAUDE.md");
     }
     else {
         console.log(`lanekeeper init: ${claudeMdPath} already has the LaneKeeper workflow section — leaving it alone.`);
@@ -92,9 +99,11 @@ export default ${JSON.stringify(generated, null, 2)};
     switch (claudeSettingsResult) {
         case "created":
             console.log(`lanekeeper init: wrote ${join(root, ".claude", "settings.json")} with the WorktreeCreate hook.`);
+            writtenFiles.push(".claude/settings.json");
             break;
         case "merged":
             console.log(`lanekeeper init: added the WorktreeCreate hook to your existing ${join(root, ".claude", "settings.json")}.`);
+            writtenFiles.push(".claude/settings.json");
             break;
         case "already-wired":
             console.log("lanekeeper init: .claude/settings.json already has the WorktreeCreate hook — leaving it alone.");
@@ -108,9 +117,11 @@ export default ${JSON.stringify(generated, null, 2)};
     switch (prePushResult) {
         case "created":
             console.log("lanekeeper init: wrote .husky/pre-push.");
+            writtenFiles.push(".husky/pre-push");
             break;
         case "merged":
             console.log("lanekeeper init: appended LaneKeeper's checks to your existing .husky/pre-push.");
+            writtenFiles.push(".husky/pre-push");
             break;
         case "already-wired":
             console.log("lanekeeper init: .husky/pre-push already wired — leaving it alone.");
@@ -143,6 +154,7 @@ export default ${JSON.stringify(generated, null, 2)};
     switch (scriptsResult.result) {
         case "added":
             console.log(`lanekeeper init: added "${scriptsResult.added.join('", "')}" to package.json scripts.`);
+            writtenFiles.push("package.json");
             break;
         case "already-wired":
             console.log("lanekeeper init: package.json already has all five scripts — leaving them alone.");
@@ -157,9 +169,14 @@ export default ${JSON.stringify(generated, null, 2)};
     }
     console.log("");
     console.log("Next steps:");
-    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.");
+    if (writtenFiles.length > 0) {
+        console.log(`  1. Commit what it wrote — ${writtenFiles.join(", ")}.`);
+        console.log("  2. claude --worktree <name> — the agent takes it from there.");
+    }
+    else {
+        console.log("  1. claude --worktree <name> — the agent takes it from there.");
+        console.log("     (everything was already wired — nothing new to commit)");
+    }
 }
 async function main() {
     switch (command) {

package/dist/hooks/worktree-create.d.ts

@@ -11,4 +11,5 @@ export declare function createLane(mainTop: string, cfg: LaneKeeperConfig): {
     lane: number;
 };
 export declare function isEphemeralNpxCopy(selfPath: string): boolean;
+export declare function expectsLocalInstall(mainTop: string): boolean;
 export declare function runWorktreeCreateHook(): Promise<void>;

package/dist/hooks/worktree-create.js

@@ -24,7 +24,7 @@
  * automatically — nothing to release by hand.
  */
 import { execFileSync } from "node:child_process";
-import { existsSync, mkdirSync, symlinkSync } from "node:fs";
+import { existsSync, mkdirSync, readFileSync, symlinkSync } from "node:fs";
 import { dirname, join, basename, sep } from "node:path";
 import { fileURLToPath } from "node:url";
 import { loadConfig, hasConfig, DEFAULTS } from "../lib/config.js";
@@ -140,6 +140,25 @@ export function createLane(mainTop, cfg) {
 export function isEphemeralNpxCopy(selfPath) {
     return selfPath.includes(`${sep}_npx${sep}`);
 }
+// The guard above only makes sense for a host project that's an npm project
+// with lanekeeper as a real dependency — hola, say. A non-Node host repo
+// (a Haskell/Lua/Rust/whatever project with no package.json at all) has
+// nowhere to install lanekeeper INTO; npx's ephemeral cache is the only way
+// it can ever run lanekeeper commands, not a fallback masking a broken
+// local install. Only expect a local install — and therefore only treat
+// ephemeral execution as suspicious — when the host's own package.json
+// actually lists lanekeeper as a dependency. No package.json, or one that
+// doesn't mention lanekeeper: ephemeral execution is completely normal.
+export function expectsLocalInstall(mainTop) {
+    let pkg;
+    try {
+        pkg = JSON.parse(readFileSync(join(mainTop, "package.json"), "utf8"));
+    }
+    catch {
+        return false; // no package.json, or unreadable/invalid — nothing "expected" to be there
+    }
+    return Boolean(pkg.dependencies?.lanekeeper || pkg.devDependencies?.lanekeeper);
+}
 async function readStdin() {
     const chunks = [];
     for await (const chunk of process.stdin)
@@ -156,11 +175,11 @@ export async function runWorktreeCreateHook() {
     }
     const fromCwd = input.cwd ?? process.cwd();
     try {
-        if (isEphemeralNpxCopy(fileURLToPath(import.meta.url))) {
+        const mainTop = resolveMainCheckout(fromCwd);
+        if (expectsLocalInstall(mainTop) && isEphemeralNpxCopy(fileURLToPath(import.meta.url))) {
             throw new Error("running from npx's ephemeral cache, not this project's own installed dependency — " +
                 "node_modules is missing or broken. Run `npm install` in the main checkout and try again.");
         }
-        const mainTop = resolveMainCheckout(fromCwd);
         const cfg = hasConfig(mainTop) ? await loadConfig(mainTop) : { ...DEFAULTS };
         const { wt } = createLane(mainTop, cfg);
         process.stdout.write(wt + "\n");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lanekeeper",
-  "version": "0.1.7",
+  "version": "0.1.8",
   "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",