@bunshin-cc/bunshin 0.3.0 → 0.3.2

package/dist/bin.js

@@ -2489,19 +2489,49 @@ import { createHash } from "node:crypto";
 import fs5 from "node:fs";
 import os from "node:os";
 import path4 from "node:path";
+function deployWorkspace(env = process.env) {
+  if (env.BUNSHIN_DEPLOY_WORKSPACE) return path4.resolve(env.BUNSHIN_DEPLOY_WORKSPACE);
+  try {
+    const ws = JSON.parse(fs5.readFileSync(settingsFile(env.BUNSHIN_DEPLOY_HOME || os.homedir()), "utf8")).workspace;
+    return typeof ws === "string" && ws ? ws : null;
+  } catch {
+    return null;
+  }
+}
 function deployPaths(env = process.env) {
   const home = env.BUNSHIN_DEPLOY_HOME || os.homedir();
+  const ws = deployWorkspace(env);
   return {
     home,
-    claudeSkills: path4.join(home, ".claude", "skills"),
-    codexSkills: path4.join(home, ".codex", "skills"),
-    claudeMd: path4.join(home, ".claude", "CLAUDE.md"),
-    agentsMd: path4.join(home, ".codex", "AGENTS.md"),
+    claudeSkills: path4.join(ws ?? home, ".claude", "skills"),
+    codexSkills: path4.join(ws ?? home, ".codex", "skills"),
+    claudeMd: ws ? path4.join(ws, "CLAUDE.md") : path4.join(home, ".claude", "CLAUDE.md"),
+    agentsMd: ws ? path4.join(ws, "AGENTS.md") : path4.join(home, ".codex", "AGENTS.md"),
     library: path4.join(home, ".bunshin", "library"),
     bin: path4.join(home, ".bunshin", "bin"),
     state: path4.join(home, ".bunshin", "deploy")
   };
 }
+function setDeployWorkspace(dir, env = process.env) {
+  const home = env.BUNSHIN_DEPLOY_HOME || os.homedir();
+  const ws = dir ? path4.resolve(dir.replace(/^~(?=$|\/)/, home)) : null;
+  if (ws && !fs5.statSync(ws, { throwIfNoEntry: false })?.isDirectory()) throw new Error(`${ws} is not a folder`);
+  const stateDir = path4.join(home, ".bunshin", "deploy");
+  const deployed = fs5.existsSync(stateDir) && fs5.readdirSync(stateDir).some((f) => {
+    if (f === "settings.json" || !f.endsWith(".json")) return false;
+    try {
+      return Object.keys(JSON.parse(fs5.readFileSync(path4.join(stateDir, f), "utf8")).docs ?? {}).length > 0;
+    } catch {
+      return false;
+    }
+  });
+  if (deployed && ws !== deployWorkspace({ ...env, BUNSHIN_DEPLOY_WORKSPACE: "" })) {
+    throw new Error("The library is already deployed to the current location. Set the workspace before the first sync on this machine.");
+  }
+  fs5.mkdirSync(path4.dirname(settingsFile(home)), { recursive: true });
+  fs5.writeFileSync(settingsFile(home), JSON.stringify(ws ? { workspace: ws } : {}, null, 2) + "\n");
+  return ws;
+}
 function statePath(p, orgId) {
   return path4.join(p.state, `${orgId.replace(/[^A-Za-z0-9._-]/g, "_") || "org"}.json`);
 }
@@ -3037,13 +3067,14 @@ function materialize(sections, dir) {
   }
   return { files };
 }
-var sha, BLOCK_BEGIN, BLOCK_END, MANIFEST, MAX_FILE, isExecutable, LAYER_RANK, docMarker;
+var settingsFile, sha, BLOCK_BEGIN, BLOCK_END, MANIFEST, MAX_FILE, isExecutable, LAYER_RANK, docMarker;
 var init_deploy = __esm({
   "src/v2/deploy.ts"() {
     "use strict";
     init_v22();
     init_util();
     init_store2();
+    settingsFile = (home) => path4.join(home, ".bunshin", "deploy", "settings.json");
     sha = (text2) => createHash("sha256").update(text2).digest("hex");
     BLOCK_BEGIN = "<!-- bunshin:begin -->";
     BLOCK_END = "<!-- bunshin:end -->";
@@ -4144,11 +4175,13 @@ var init_exports = {};
 __export(init_exports, {
   CODEX_HOOK_EVENTS: () => CODEX_HOOK_EVENTS,
   HOOK_EVENTS: () => HOOK_EVENTS,
+  LEARN_COMMAND: () => LEARN_COMMAND,
   PRE_TOOL_MATCHER: () => PRE_TOOL_MATCHER,
   bunshinHookEntry: () => bunshinHookEntry,
   claudeSettingsPath: () => claudeSettingsPath,
   countBunshinHooks: () => countBunshinHooks,
   installClaudeHooks: () => installClaudeHooks,
+  installLearnCommand: () => installLearnCommand,
   installMcpConfig: () => installMcpConfig,
   installPiExtension: () => installPiExtension,
   isBunshinEntry: () => isBunshinEntry,
@@ -4259,6 +4292,24 @@ function mcpLauncher(bin) {
   }
   return { command: process.execPath, args: [script, "mcp"] };
 }
+function installLearnCommand({ file, remove = false }) {
+  try {
+    const current = fileExists(file) ? fs13.readFileSync(file, "utf8") : null;
+    const ours = current === null || current === LEARN_COMMAND;
+    if (remove) {
+      if (current !== null && ours) fs13.unlinkSync(file);
+      return { file, installed: 0, changed: current !== null && ours };
+    }
+    if (!ours) return { file, installed: 0, changed: false, error: "a different learn.md is already there; left as it is" };
+    if (current === null) {
+      fs13.mkdirSync(path10.dirname(file), { recursive: true });
+      fs13.writeFileSync(file, LEARN_COMMAND);
+    }
+    return { file, installed: 1, changed: current === null };
+  } catch (err) {
+    return { file, installed: 0, changed: false, error: err instanceof Error ? err.message : String(err) };
+  }
+}
 function installMcpConfig({ file, launcher, remove = false }) {
   try {
     const before = fileExists(file) ? JSON.parse(fs13.readFileSync(file, "utf8")) : {};
@@ -4331,15 +4382,18 @@ function runInit(opts = {}) {
     if (hooks.error) warnings.push(`could not update ${hooks.file}: ${hooks.error}`);
   }
   let mcp;
+  let learnCommand;
   if ((opts.removeHooks || !opts.noHooks) && config.harness === "claude-code" && scope === "repo") {
     mcp = installMcpConfig({ file: path10.join(cwd, ".mcp.json"), launcher: opts.mcp ?? mcpLauncher(opts.bin), remove: opts.removeHooks });
     if (mcp.error) warnings.push(`could not update ${mcp.file}: ${mcp.error}`);
+    learnCommand = installLearnCommand({ file: path10.join(cwd, ".claude", "commands", "learn.md"), remove: opts.removeHooks });
+    if (learnCommand.error) warnings.push(`/learn not installed at ${learnCommand.file}: ${learnCommand.error}`);
   }
   if (!resolveBackend(config)) {
     warnings.push("No model backend found. Install and sign in to Codex or Claude Code before using automatic learning.");
   }
   store.log("init", { root, scope, role: config.role, orgUnit: config.orgUnit, hooks: hooks?.installed ?? 0 });
-  return { root, config, created: !existed, hooks, ...mcp ? { mcp } : {}, warnings };
+  return { root, config, created: !existed, hooks, ...mcp ? { mcp } : {}, ...learnCommand ? { learnCommand } : {}, warnings };
 }
 function otherHarnessInstructions() {
   return [
@@ -4355,7 +4409,7 @@ function otherHarnessInstructions() {
     "  Claude Code plugin users need no settings.json wiring \u2014 the plugin ships hooks/hooks.json."
   ].join("\n");
 }
-var PRE_TOOL_MATCHER, HOOK_EVENTS, CODEX_HOOK_EVENTS;
+var PRE_TOOL_MATCHER, HOOK_EVENTS, CODEX_HOOK_EVENTS, LEARN_COMMAND;
 var init_init = __esm({
   "src/init.ts"() {
     "use strict";
@@ -4379,6 +4433,7 @@ var init_init = __esm({
       { event: "PreCompact", arg: "pre-compact", timeout: 10 },
       { event: "SessionEnd", arg: "session-end", timeout: 3 }
     ];
+    LEARN_COMMAND = '---\ndescription: Capture what this session learned into the Bunshin library now (applied locally as a trial, submitted for the nightly review)\nargument-hint: "[what to capture, e.g. \\"the ledger must be reconciled before closing\\"]"\nallowed-tools: Bash(bunshin learn:*)\n---\n\nCapture knowledge from this session into Bunshin.\n\nRun exactly this with the Bash tool (it takes up to two minutes; use a timeout of 180000 ms):\n\n```bash\nbunshin learn "$ARGUMENTS"\n```\n\n`bunshin learn` forks this conversation (`claude -p --resume <this session> --fork-session`),\nso the reflection sees everything you saw without re-sending the transcript. It applies what it\nfinds locally as a trial and queues it for the nightly review:\n\n- edits to this repo\'s SPEC.md / TESTING.md / SKILL.md land in the working tree (they show up\n  in `git diff`);\n- knowledge with no repo home becomes a local overlay on the Bunshin library;\n- per-machine values stay private.\n\nRelay its output to the user as it is. Each line reads\n`captured: <summary> \u2192 <section or file#anchor>`. If it prints `nothing new to capture.`, say so\nin one line; that is the normal outcome. If it reports an error, show it and stop; do not retry\nin a loop, and do not edit the library files by hand.\n\nIf the user named nothing specific, run it without arguments. Do not continue with other work in\nthe same reply unless the user asked you to.\n';
   }
 });
 
@@ -7270,6 +7325,19 @@ async function cmdLibrary(store, args, cwd, out, err) {
   files:         ${p.library}
 `);
       for (const x of pending) out(`  edited here, awaiting the nightly: ${x.name}
+`);
+      return 0;
+    }
+    case "workspace": {
+      const target = args._[2];
+      if (bool3(args.flags.clear)) setDeployWorkspace(null);
+      else if (target) setDeployWorkspace(target);
+      const ws = deployWorkspace();
+      const p = deployPaths();
+      out(ws ? `workspace: ${ws}
+` : "workspace: none (skills and instructions are user-wide)\n");
+      out(`  skills:        ${p.claudeSkills}, ${p.codexSkills}
+  instructions:  ${p.claudeMd}, ${p.agentsMd}
 `);
       return 0;
     }
@@ -8202,7 +8270,7 @@ init_util();
 init_project_hooks();
 function parseArgs(argv) {
   const out = { _: [], flags: {} };
-  const valueless = /* @__PURE__ */ new Set(["json", "quiet", "force", "sync", "global", "help", "version", "dry-run", "offline", "apply", "no-hooks", "remove-hooks", "key-stdin", "debug", "verbose", "robot", "fork", "upload", "index", "all", "legacy", "depth", "local", "skip-github", "propose-rewrites"]);
+  const valueless = /* @__PURE__ */ new Set(["json", "quiet", "force", "sync", "global", "help", "version", "dry-run", "offline", "apply", "no-hooks", "remove-hooks", "key-stdin", "debug", "verbose", "robot", "fork", "upload", "index", "all", "legacy", "depth", "local", "skip-github", "propose-rewrites", "clear"]);
   for (let i = 0; i < argv.length; i++) {
     const a = argv[i];
     if (a === "--") {
@@ -8290,6 +8358,9 @@ Usage: bunshin <command> [options]
                                 the deployed skills; push proposes local edits / a new skill now
   library version|log|status|pin [--write [file]]|checkout <lib@N> --to <dir> [--git <sha>] [--pin <file>]
                                 library versions (lib@N), history, and exact reproductions
+  library workspace [<dir>|--clear]
+                                deploy skills and instructions into a workspace folder (e.g.
+                                ~/Documents/dev) instead of ~/.claude and ~/.codex; set it before the first sync
   questions [list|answer <id> "<choice>"]   open questions for your team
   suggest --code <harness path> [--file <local file>] [--rationale "<text>"]
                                 queue a robot harness code change (save_skill) for the release pipeline
@@ -8393,6 +8464,10 @@ Key saved privately outside the project.
 `);
       if (result.hooks?.error) throw new Error(`Connected, but hooks could not be configured: ${result.hooks.error}. Fix the file and run setup again.`);
       if (result.hooks) out(`${result.hooks.installed} ${harness === "pi" ? "extension" : "hooks"} configured in ${result.hooks.file}
+`);
+      if (result.learnCommand?.installed) out(`/learn installed in ${result.learnCommand.file}
+`);
+      else if (result.learnCommand?.error) out(`/learn not installed: ${result.learnCommand.error} (${result.learnCommand.file})
 `);
       if (result.hooks?.sharedWithWorktrees) out("Codex shares these hooks with the repository\u2019s linked worktrees. Each connected worktree keeps its own Bunshin store.\n");
       if (harness === "codex" && result.hooks) out("Run codex interactively in this project. Review and accept project trust, then run /hooks and review and trust the five Bunshin hooks.\n");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bunshin-cc/bunshin",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "Shared memory for company AI agents. Connect Codex, Claude Code, or Pi to Bunshin.",
   "type": "module",
   "bin": {