lshed 0.7.0 → 0.7.2

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # Changelog
 
+## 0.7.2 — 2026-09-03
+
+Joining a machine that already has a harness, found while preparing the Windows check.
+
+- `restore` warns before removing parts that a **different** shed had claimed. Running `init` against a scratch shed to look around marks that machine's own parts as managed, so a later restore from the real shed would remove them. They were always backed up, but nothing said why. `lshed scan` is the read-only way to look.
+- No longer crashes with an `EPIPE` stack trace when output is piped into something that exits early (`lshed status | head`).
+- The smoke script now models a machine that already runs the agent: a skill whose name collides with the shed, a skill only that machine has, and its own MCP and settings. It checks that a collision is backed up and replaced, that machine-only parts survive, that nothing is removed, and that `add` pushes them into the shed.
+- README: how to join a machine that already has a setup, and why not to `init` there.
+
+## 0.7.1 — 2026-09-03
+
+Groundwork for running on Windows and macOS. Not yet verified on a real machine.
+
+- Package `install:` commands run through the platform shell (`sh` or `cmd.exe`) instead of a hard-coded `sh -c`.
+- On Windows, `claude` and other wrappers installed as `.cmd` are found by spawning through the shell.
+- Home-directory paths with backslashes are also rewritten to `${HOME}`.
+- `sync` explains what to do when git has no user identity.
+- `npm run smoke` drives the built CLI through init, restore, add, diff, save, profile switch, list and sync in a temporary directory without touching the real `~/.claude`. Use it on a new OS before trusting a real restore.
+- GitHub Actions matrix: ubuntu, macOS, Windows × Node 20, 22. Tests use directory junctions on Windows so no elevated privileges are needed.
+
 ## 0.7.0 — 2026-09-03
 
 `settings.json` travels, without merging.

package/README.md

@@ -89,6 +89,31 @@ lshed sync            # commit the shed, pull, push
 
 `save` is the only path from `~/.claude` to the shed, and it only works for parts the shed owns (`file:` sources). `sync` warns if you have unsaved edits so you do not push a shed that is behind your machine.
 
+### A machine that already has a setup
+
+The common case is not an empty machine: it already runs the agent and has skills, settings and MCP servers of its own. `restore` is built for that. With no prior lshed state it **removes nothing** — it places what the profile lists, and anything it overwrites goes to `~/.claude/lshed/backups/<timestamp>/` first. Parts that exist only on that machine are untouched.
+
+```
+$ lshed restore default --shed ~/lshed --dry-run
+  + skills/mine
+  ~ skills/shared            # same name, different content → backed up, then replaced
+  + mcp:exa  (${EXA_API_KEY})
+  ~ settings:model
+(dry-run) 변경 없음. 배치 5, 제거 0, 백업 예정 3
+```
+
+Always run `--dry-run` first. `+` is new, `~` replaces with a backup, `-` removes with a backup. If the plan looks right, drop the flag.
+
+Then push that machine's own parts up into the shed and both machines have everything:
+
+```
+lshed add                    # lists what this machine has that the shed does not
+lshed add windows-only mcp/my-local-server
+lshed sync
+```
+
+Do not run `init` on such a machine just to look around. `init` claims what it finds as lshed-managed, so a later `restore` from your real shed would treat those parts as removable (backed up, but removed). Use `lshed scan`, which only prints. If you do it anyway, `restore` warns you before removing anything and `lshed add` is the way out.
+
 ### A new machine
 
 ```

package/dist/cli.js

@@ -448,7 +448,7 @@ var resetHard = (dir, sha) => git(["reset", "--hard", "--quiet", sha], dir);
 var pullFf = (dir) => git(["pull", "--ff-only", "--quiet"], dir);
 function runShell(cmd, cwd) {
   return new Promise((resolve, reject) => {
-    const p = spawn("sh", ["-c", cmd], { cwd, stdio: "inherit" });
+    const p = spawn(cmd, { cwd, stdio: "inherit", shell: true });
     p.on("error", reject);
     p.on("close", (code) => code === 0 ? resolve() : reject(new Error(`\uBA85\uB839\uC774 ${code} \uB85C \uB05D\uB0AC\uC2B5\uB2C8\uB2E4: ${cmd}`)));
   });
@@ -644,7 +644,7 @@ async function writeState(adapter, state) {
 // src/core/context.ts
 function spawnExec(cmd, args, cwd) {
   return new Promise((resolve, reject) => {
-    const p = spawn2(cmd, args, { cwd, stdio: "inherit" });
+    const p = spawn2(cmd, args, { cwd, stdio: "inherit", shell: process.platform === "win32" });
     p.on("error", reject);
     p.on("close", (code) => code === 0 ? resolve() : reject(new Error(`${cmd} ${args.join(" ")} \uAC00 ${code} \uB85C \uB05D\uB0AC\uC2B5\uB2C8\uB2E4`)));
   });
@@ -1015,7 +1015,7 @@ function mask(id, entry, cat, home = os2.homedir()) {
 }
 function portable(entry, home = os2.homedir()) {
   if (!home || home === "/") return entry;
-  return walk(entry, (s) => s === home || s.startsWith(home + "/") ? "${HOME}" + s.slice(home.length) : s);
+  return walk(entry, (s) => s === home || s.startsWith(home + "/") || s.startsWith(home + "\\") ? "${HOME}" + s.slice(home.length) : s);
 }
 function envWithHome(env = process.env) {
   return { HOME: os2.homedir(), ...env };
@@ -1227,6 +1227,10 @@ async function restore(ctx, profileArg, opts = {}) {
   if (fragments.length) newManaged.add(instrRel);
   const oldManaged = new Set(state?.managed ?? []);
   const toRemove = [...oldManaged].filter((r) => !newManaged.has(r)).sort();
+  if (state && state.shed !== ctx.shed && toRemove.length) {
+    ctx.log(`! \uB9C8\uC9C0\uB9C9\uC73C\uB85C \uC801\uC6A9\uD55C \uCC3D\uACE0\uAC00 \uB2E4\uB985\uB2C8\uB2E4: ${state.shed}`);
+    ctx.log(`  \uC544\uB798 ${toRemove.length}\uAC1C\uB294 \uADF8 \uCC3D\uACE0\uC758 \uAD00\uB9AC \uBAA9\uB85D\uC5D0 \uC788\uC5B4 \uC81C\uAC70 \uB300\uC0C1\uC785\uB2C8\uB2E4 (\uBC31\uC5C5\uB428). \uC774 \uAE30\uAE30\uC758 \uAC83\uC744 \uC9C0\uD0A4\uB824\uBA74 \uBA3C\uC800 'lshed add' \uB85C \uCC3D\uACE0\uC5D0 \uB123\uC73C\uC138\uC694.`);
+  }
   const stamp = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
   const backupDir = path17.join(ctx.adapter.root, LSHED_DIR, "backups", stamp);
   const backedUp = [];
@@ -1630,7 +1634,16 @@ async function sync(ctx, opts = {}) {
     ctx.log(`  ${opts.dryRun ? "(dry-run) " : ""}commit ${dirty.length}\uAC1C: ${dirty.slice(0, 5).join(", ")}${dirty.length > 5 ? ` \uC678 ${dirty.length - 5}` : ""}`);
     if (!opts.dryRun) {
       await git(["add", "-A"], shed);
-      await git(["commit", "--quiet", "-m", msg], shed);
+      try {
+        await git(["commit", "--quiet", "-m", msg], shed);
+      } catch (e) {
+        if (/Author identity unknown|Please tell me who you are/.test(e.message)) {
+          throw new Error(`git \uC0AC\uC6A9\uC790 \uC815\uBCF4\uAC00 \uC5C6\uC5B4 \uCEE4\uBC0B\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4. \uD55C \uBC88\uB9CC \uC124\uC815\uD558\uC138\uC694:
+  git config --global user.name "\uC774\uB984"
+  git config --global user.email "\uBA54\uC77C"`);
+        }
+        throw e;
+      }
     }
     res.committed = dirty;
   } else {
@@ -1692,6 +1705,11 @@ var firstLine = (s) => s.split("\n").find((l) => l.trim() && !l.startsWith("Comm
 
 // src/cli.ts
 var { version } = createRequire(import.meta.url)("../package.json");
+for (const s of [process.stdout, process.stderr]) {
+  s.on("error", (e) => {
+    if (e.code === "EPIPE") process.exit(0);
+  });
+}
 var program = new Command().name("lshed").description("Keep your coding-agent harness (skills, agents, commands, instructions) in a shed and restore it anywhere by profile.").version(version).option("--shed <dir>", "shed directory (default: $LSHED_HOME, then the shed recorded by the last restore)").option("--root <dir>", "agent config root (default: ~/.claude)");
 function adapterFromOpts() {
   const { root } = program.opts();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lshed",
-  "version": "0.7.0",
+  "version": "0.7.2",
   "description": "Portable harness environment manager for coding agents",
   "license": "MIT",
   "author": "leesongheon <leesongheon1209@gmail.com>",
@@ -22,6 +22,7 @@
     "dev": "tsx src/cli.ts",
     "test": "vitest run",
     "typecheck": "tsc --noEmit",
+    "smoke": "node scripts/smoke.mjs",
     "prepublishOnly": "npm run typecheck && npm test && npm run build"
   },
   "keywords": [