harnessed 3.3.0 → 3.3.1

package/README.md

@@ -36,7 +36,15 @@ npm install -g harnessed && harnessed setup
 
 > Windows PowerShell 5.x 不支持 `&&` 链接,需改 `;` 或分两行 (`npm install -g harnessed; harnessed setup`)。bash / zsh / PowerShell 7+ / cmd.exe 都正常。
 
-🤖 **或让 AI 帮你装** — 复制 [INSTALL-WITH-AI.md](./INSTALL-WITH-AI.md) 整段粘贴进 Claude Code (或任何 AI 助手),AI 自动处理 OS / 权限 / PATH / corepack 等 edge case。
+🤖 **或让 AI 帮你装** — 把下面这句话发给 Claude Code (或任何 AI 助手):
+
+> 按 `https://github.com/easyinplay/harnessed/blob/main/INSTALL-WITH-AI.md` 的指导帮我装 harnessed
+
+AI 会自动 fetch 文档 + 跑安装,处理 OS / 权限 / PATH / corepack 等 edge case,无需复制大段文字。
+
+> [!TIP]
+> 🚀 **很多人关心的 Agent Teams 和 Subagent 功能,在 harnessed 中会根据任务自动启用!**
+> 无需手动配置 `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS`,`harnessed setup` v3.3.1+ 会自动写入 `~/.claude/settings.json`;Pattern A 全栈三路 / Pattern C 4-specialist 等 multi-agent workflow 即开即用。
 
 ---
 

package/dist/cli.mjs

@@ -847,7 +847,7 @@ var init_resume = __esm({
 
 // package.json
 var package_default = {
-  version: "3.3.0"};
+  version: "3.3.1"};
 
 // src/manifest/errors.ts
 function instancePathToKeyPath(instancePath) {
@@ -1633,7 +1633,7 @@ function renderHumanTable(records) {
   }
 }
 function pipeToJq(filterExpr, lines) {
-  return new Promise((resolve9, reject) => {
+  return new Promise((resolve10, reject) => {
     const child = spawn("jq", [filterExpr], {
       stdio: ["pipe", "inherit", "inherit"],
       windowsHide: true
@@ -1642,12 +1642,12 @@ function pipeToJq(filterExpr, lines) {
       const e = err2;
       if (e.code === "ENOENT") {
         console.error("\u2717 jq not found in PATH \u2014 run: harnessed doctor");
-        resolve9(1);
+        resolve10(1);
       } else {
         reject(err2);
       }
     });
-    child.on("close", (code) => resolve9(code ?? 0));
+    child.on("close", (code) => resolve10(code ?? 0));
     child.stdin.write(lines.join("\n"));
     child.stdin.end();
   });
@@ -3364,10 +3364,10 @@ var installCcHookAdd = async (ctx) => {
     const e = pre.errors[0] ?? err(ctx, "/", "preflight failed", "preflight");
     return { ok: false, phase: "preflight", error: e };
   }
-  const settingsPath = join(homedir(), ".claude", "settings.json");
+  const settingsPath2 = join(homedir(), ".claude", "settings.json");
   let existing;
   try {
-    existing = await readFile(settingsPath, "utf8");
+    existing = await readFile(settingsPath2, "utf8");
   } catch {
     existing = null;
   }
@@ -3398,7 +3398,7 @@ var installCcHookAdd = async (ctx) => {
   const newText = `${JSON.stringify(settings, null, 2)}
 `;
   const plan = {
-    files: [{ target: settingsPath, scope: "HOME", oldText: existing ?? "", newText }]
+    files: [{ target: settingsPath2, scope: "HOME", oldText: existing ?? "", newText }]
   };
   process.stdout.write(renderDiff(plan, ctx));
   const conf = await confirmAt("L3", { ...ctx});
@@ -3409,10 +3409,10 @@ var installCcHookAdd = async (ctx) => {
   if (ctx.opts.dryRun) return { aborted: true, reason: "user-cancel" };
   const bk = await backup(plan, ctx);
   if (!bk.ok) return { ok: false, phase: "preflight", error: bk.error };
-  await writeFile(settingsPath, newText);
+  await writeFile(settingsPath2, newText);
   let verify;
   try {
-    verify = JSON.parse(await readFile(settingsPath, "utf8"));
+    verify = JSON.parse(await readFile(settingsPath2, "utf8"));
   } catch (e) {
     return {
       ok: false,
@@ -3440,7 +3440,7 @@ var installCcHookAdd = async (ctx) => {
     };
   }
   await updateInstalled(ctx.cwd, ctx.manifest.metadata.name, "", "");
-  return { ok: true, backupId: bk.backupId, appliedFiles: [settingsPath] };
+  return { ok: true, backupId: bk.backupId, appliedFiles: [settingsPath2] };
 };
 function getUserClaudeJsonPath() {
   return join(homedir(), ".claude.json");
@@ -3476,7 +3476,7 @@ async function isPluginRegistered(pluginName) {
   return Object.keys(plugins).some((k) => k.split("@")[0] === pluginName);
 }
 function runArgs(claudeArgs, cwd, timeoutMs = 15e3) {
-  return new Promise((resolve9) => {
+  return new Promise((resolve10) => {
     const isWin = process.platform === "win32";
     const child = isWin ? spawn("cmd.exe", ["/c", "claude", ...claudeArgs], { cwd, windowsHide: true }) : spawn("claude", claudeArgs, { cwd, shell: false });
     let stderr = "";
@@ -3485,15 +3485,15 @@ function runArgs(claudeArgs, cwd, timeoutMs = 15e3) {
     });
     const timer = setTimeout(() => {
       child.kill("SIGKILL");
-      resolve9({ exitCode: -1, stderr: `${stderr}[timeout after ${timeoutMs}ms]` });
+      resolve10({ exitCode: -1, stderr: `${stderr}[timeout after ${timeoutMs}ms]` });
     }, timeoutMs);
     child.on("error", (e) => {
       clearTimeout(timer);
-      resolve9({ exitCode: -1, stderr: `${stderr}${e.message}` });
+      resolve10({ exitCode: -1, stderr: `${stderr}${e.message}` });
     });
     child.on("close", (code) => {
       clearTimeout(timer);
-      resolve9({ exitCode: code ?? -1, stderr });
+      resolve10({ exitCode: code ?? -1, stderr });
     });
   });
 }
@@ -3672,10 +3672,10 @@ async function spawnCmd(ctx, cmd, args, timeoutMs) {
   child.stderr?.setEncoding("utf8").on("data", (chunk) => {
     stderr += chunk;
   });
-  return await new Promise((resolve9) => {
+  return await new Promise((resolve10) => {
     const timer = setTimeout(() => {
       child.kill("SIGKILL");
-      resolve9({
+      resolve10({
         ok: false,
         phase: "spawn",
         error: {
@@ -3690,7 +3690,7 @@ async function spawnCmd(ctx, cmd, args, timeoutMs) {
     }, effectiveTimeoutMs);
     child.on("error", (err2) => {
       clearTimeout(timer);
-      resolve9({
+      resolve10({
         ok: false,
         phase: "spawn",
         error: {
@@ -3705,14 +3705,14 @@ async function spawnCmd(ctx, cmd, args, timeoutMs) {
     });
     child.on("close", (code) => {
       clearTimeout(timer);
-      resolve9({ ok: true, exitCode: code ?? -1, stdout: stdout2, stderr });
+      resolve10({ ok: true, exitCode: code ?? -1, stdout: stdout2, stderr });
     });
   });
 }
 
 // src/installers/gitCloneWithSetup.ts
 function gitRevParseHead(cwd, timeoutMs = 1e4) {
-  return new Promise((resolve9) => {
+  return new Promise((resolve10) => {
     const isWin = process.platform === "win32";
     const child = isWin ? spawn("cmd.exe", ["/c", "git", "rev-parse", "HEAD"], { cwd, windowsHide: true }) : spawn("git", ["rev-parse", "HEAD"], { cwd, shell: false });
     let stdout2 = "";
@@ -3721,15 +3721,15 @@ function gitRevParseHead(cwd, timeoutMs = 1e4) {
     });
     const timer = setTimeout(() => {
       child.kill("SIGKILL");
-      resolve9({ sha: "", exit: -1 });
+      resolve10({ sha: "", exit: -1 });
     }, timeoutMs);
     child.on("error", () => {
       clearTimeout(timer);
-      resolve9({ sha: "", exit: -1 });
+      resolve10({ sha: "", exit: -1 });
     });
     child.on("close", (code) => {
       clearTimeout(timer);
-      resolve9({ sha: stdout2.trim(), exit: code ?? -1 });
+      resolve10({ sha: stdout2.trim(), exit: code ?? -1 });
     });
   });
 }
@@ -4782,6 +4782,80 @@ function registerRollback(program2) {
     console.log(`restored ${meta.files.length} file(s) from ${timestamp}`);
   });
 }
+
+// src/cli/lib/enableAgentTeamsInSettings.ts
+init_harnessedRoot();
+function settingsPath() {
+  return resolve(homedir(), ".claude", "settings.json");
+}
+async function enableAgentTeamsInSettings() {
+  const path = settingsPath();
+  let raw;
+  try {
+    raw = await readFile(path, "utf8");
+  } catch (err2) {
+    const code = err2.code;
+    if (code !== "ENOENT") {
+      return { status: "warn", message: `read ${path} failed: ${err2.message}` };
+    }
+    return createFreshSettings(path);
+  }
+  let data;
+  try {
+    const parsed = JSON.parse(raw);
+    if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
+      return { status: "warn", message: `${path} is not a JSON object` };
+    }
+    data = parsed;
+  } catch (err2) {
+    return { status: "warn", message: `${path} malformed JSON: ${err2.message}` };
+  }
+  const env = data.env ?? {};
+  if (env.CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS === "1") {
+    return { status: "already-enabled", path };
+  }
+  const backupPath = await backupOriginal(raw);
+  if (backupPath.status === "warn") return backupPath;
+  data.env = { ...env, CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS: "1" };
+  const writeErr = await atomicWrite(path, `${JSON.stringify(data, null, 2)}
+`);
+  if (writeErr) return { status: "warn", message: writeErr };
+  return { status: "enabled", path, backupPath: backupPath.path };
+}
+async function createFreshSettings(path) {
+  const data = { env: { CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS: "1" } };
+  try {
+    await mkdir(join(homedir(), ".claude"), { recursive: true });
+  } catch (err2) {
+    return { status: "warn", message: `mkdir ~/.claude failed: ${err2.message}` };
+  }
+  const writeErr = await atomicWrite(path, `${JSON.stringify(data, null, 2)}
+`);
+  if (writeErr) return { status: "warn", message: writeErr };
+  return { status: "created", path };
+}
+async function backupOriginal(raw) {
+  const backupRoot = harnessedSubdir("backups");
+  const ts = (/* @__PURE__ */ new Date()).toISOString().replace(/:/g, "-");
+  const backupPath = join(backupRoot, `settings.json.${ts}.bak`);
+  try {
+    await mkdir(backupRoot, { recursive: true });
+    await writeFile(backupPath, raw, "utf8");
+    return { status: "ok", path: backupPath };
+  } catch (err2) {
+    return { status: "warn", message: `backup ${backupPath} failed: ${err2.message}` };
+  }
+}
+async function atomicWrite(path, content) {
+  const tmpPath = `${path}.tmp-${process.pid}-${Date.now()}`;
+  try {
+    await writeFile(tmpPath, content, "utf8");
+    await rename(tmpPath, path);
+    return void 0;
+  } catch (err2) {
+    return `write ${path} failed: ${err2.message}`;
+  }
+}
 init_checkAgentTeams();
 var FLAT_LEGACY_DEPRECATED = /* @__PURE__ */ new Set(["plan-feature", "execute-task", "verify-work"]);
 var FLAT_LEGACY_KEEP = /* @__PURE__ */ new Set(["research", "retro", "auto"]);
@@ -5004,6 +5078,18 @@ function registerSetup(program2) {
       `
 Step A complete: ${skillsInstalled} workflow skill(s) installed to ${skillsBase}`
     );
+    const cResult = await enableAgentTeamsInSettings();
+    if (cResult.status === "created") {
+      console.log(`  [C] created ${cResult.path} + enabled Agent Teams`);
+    } else if (cResult.status === "already-enabled") {
+      console.log(`  [C] Agent Teams already enabled (${cResult.path})`);
+    } else if (cResult.status === "enabled") {
+      console.log(
+        `  [C] enabled Agent Teams in ${cResult.path} (backup saved \u2192 ${cResult.backupPath})`
+      );
+    } else {
+      console.warn(`  [C] Agent Teams enable skipped: ${cResult.message}`);
+    }
     const manifestPaths = await listBaseManifests2(pkgRoot);
     const b = await runStepBInstall(manifestPaths);
     const stepBMs = (b.elapsedMs / 1e3).toFixed(1);
@@ -5092,10 +5178,10 @@ var uninstallCcHookAdd = async (ctx) => {
   }
   const abort = dryRunGate(ctx);
   if (abort) return abort;
-  const settingsPath = join(homedir(), ".claude", "settings.json");
+  const settingsPath2 = join(homedir(), ".claude", "settings.json");
   let existing;
   try {
-    existing = await readFile(settingsPath, "utf8");
+    existing = await readFile(settingsPath2, "utf8");
   } catch {
     return { ok: true, removedPaths: [] };
   }
@@ -5124,8 +5210,8 @@ var uninstallCcHookAdd = async (ctx) => {
   if (settings.hooks?.[ev]?.length === before || before === settings.hooks?.[ev]?.length) ;
   const newText = `${JSON.stringify(settings, null, 2)}
 `;
-  await writeFile(settingsPath, newText);
-  return { ok: true, removedPaths: [settingsPath] };
+  await writeFile(settingsPath2, newText);
+  return { ok: true, removedPaths: [settingsPath2] };
 };
 
 // src/uninstallers/ccPluginMarketplace.ts
@@ -5261,7 +5347,7 @@ var uninstallNpmCli = async (ctx) => {
   const m = install.cmd.match(/npm\s+(?:install|i)\s+(?:-g\s+)?(\S+)/);
   const pkg = m?.[1] ?? ctx.manifest.metadata.upstream.source;
   const isWin = process.platform === "win32";
-  const result = await new Promise((resolve9) => {
+  const result = await new Promise((resolve10) => {
     const child = isWin ? spawn("cmd.exe", ["/c", "npm", "uninstall", "-g", pkg], { windowsHide: true }) : spawn("npm", ["uninstall", "-g", pkg], { shell: false });
     let stderr = "";
     child.stderr?.setEncoding("utf8").on("data", (c) => {
@@ -5269,15 +5355,15 @@ var uninstallNpmCli = async (ctx) => {
     });
     const timer = setTimeout(() => {
       child.kill("SIGKILL");
-      resolve9({ exitCode: -1, stderr: `${stderr}[timeout]` });
+      resolve10({ exitCode: -1, stderr: `${stderr}[timeout]` });
     }, 3e4);
     child.on("error", (e) => {
       clearTimeout(timer);
-      resolve9({ exitCode: -1, stderr: e.message });
+      resolve10({ exitCode: -1, stderr: e.message });
     });
     child.on("close", (code) => {
       clearTimeout(timer);
-      resolve9({ exitCode: code ?? -1, stderr });
+      resolve10({ exitCode: code ?? -1, stderr });
     });
   });
   if (result.exitCode !== 0) {