harnessed 3.2.0 → 3.3.0

package/README.md

@@ -344,6 +344,42 @@ planning-with-files /plan (cross-cutting tool) → write artifacts to .planning/
 
 ---
 
+## 🛠️ 维护命令 (Operational)
+
+> 这些是 harnessed 自身维护命令(setup / 健康检查 / 备份回滚 / 状态恢复等),日常 feature 开发用上面的 slash command 即可,这块通常不需要。
+
+### CLI 命令
+
+| 命令 | 说明 |
+| ---- | ---- |
+| `harnessed setup` | 一次性 setup,装 workflow skills 到 `~/.claude/skills/` + MCP 到 `~/.claude.json` |
+| `harnessed resume` | session 中断后恢复至最近 checkpoint |
+| `harnessed status` | 当前 phase + lock holder |
+| `harnessed doctor` | 8-check 健康检查 (Node / MCP / jq / Win bash / 路由 / token budget 等) |
+| `harnessed install <name>` | 装上游 manifest |
+| `harnessed uninstall <name>` | 反向卸载 |
+| `harnessed backup` | snapshot 备份管理 |
+| `harnessed rollback <timestamp>` | 一行回滚 (EOL preserve + sha1 verify) |
+| `harnessed gc` | 清理过期 backups |
+| `harnessed audit-log` | 路由透明日志 query (支持 `--filter` jq 表达式) |
+
+### 参数 (Flags)
+
+> 所有命令默认 **apply (immediate write)**,无需加 flag。高级用户可加 `--dry-run` 预览。
+
+| Flag | 说明 |
+| ---- | ---- |
+| `--dry-run` | 预览不写盘 (高级用户 opt-in) |
+| `--non-interactive` | CI / 脚本场景 |
+| `--system` | L4 全局装允许 (否则降级 L1 npx ephemeral) |
+| `--yes` | uninstall 跳过交互 confirm |
+| `--full-diff` | 展开 > 200 行的 diff 折叠 |
+| `--no-color` | 强制 nocolor (即使 TTY) |
+
+> `--apply` flag 仍保留为向后兼容 alias (no-op, 旧脚本不破)。
+
+---
+
 ## ❓ FAQ
 
 <details>
@@ -423,41 +459,6 @@ harnessed setup --apply  # 自动装齐 gstack + GSD + superpowers + planning-wi
 
 ---
 
-## 🛠️ 维护命令 (Operational)
-
-> 这些是 harnessed 自身维护命令(setup / 健康检查 / 备份回滚 / 状态恢复等),日常 feature 开发用上面的 slash command 即可,这块通常不需要。
-
-### CLI 命令
-
-| 命令 | 说明 |
-| ---- | ---- |
-| `harnessed setup` | 一次性 setup,装 workflow skills 到 `~/.claude/skills/` + MCP 到 `~/.claude.json` |
-| `harnessed resume` | session 中断后恢复至最近 checkpoint |
-| `harnessed status` | 当前 phase + lock holder |
-| `harnessed doctor` | 8-check 健康检查 (Node / MCP / jq / Win bash / 路由 / token budget 等) |
-| `harnessed install <name>` | 装上游 manifest |
-| `harnessed uninstall <name>` | 反向卸载 |
-| `harnessed backup` | snapshot 备份管理 |
-| `harnessed rollback <timestamp>` | 一行回滚 (EOL preserve + sha1 verify) |
-| `harnessed gc` | 清理过期 backups |
-| `harnessed audit-log` | 路由透明日志 query (支持 `--filter` jq 表达式) |
-
-### 参数 (Flags)
-
-> 所有命令默认 **apply (immediate write)**,无需加 flag。高级用户可加 `--dry-run` 预览。
-
-| Flag | 说明 |
-| ---- | ---- |
-| `--dry-run` | 预览不写盘 (高级用户 opt-in) |
-| `--non-interactive` | CI / 脚本场景 |
-| `--system` | L4 全局装允许 (否则降级 L1 npx ephemeral) |
-| `--yes` | uninstall 跳过交互 confirm |
-| `--full-diff` | 展开 > 200 行的 diff 折叠 |
-| `--no-color` | 强制 nocolor (即使 TTY) |
-
-> `--apply` flag 仍保留为向后兼容 alias (no-op, 旧脚本不破)。
-
----
 
 ## License
 

package/dist/cli.mjs

@@ -847,7 +847,7 @@ var init_resume = __esm({
 
 // package.json
 var package_default = {
-  version: "3.2.0"};
+  version: "3.3.0"};
 
 // src/manifest/errors.ts
 function instancePathToKeyPath(instancePath) {
@@ -2999,26 +2999,11 @@ function loadPhases(yamlPath, vars) {
   return validated;
 }
 
-// src/cli/lib/validateFlags.ts
-function validateNonInteractiveFlags(raw, cmdName) {
-  if (raw.nonInteractive && !raw.apply && !raw.dryRun) {
-    console.error(
-      `error: --non-interactive requires --apply or --dry-run
-  fix:  'harnessed ${cmdName} --non-interactive --dry-run' or '--apply'`
-    );
-    process.exit(2);
-  }
-}
-
 // src/cli/execute-task.ts
 function registerExecuteTask(program2) {
   program2.command("execute-task").description(
     "Run execute-task workflow (4-phase chain \u2192 ralph-loop COMPLETE; immediate by default \u2014 use --dry-run for preview)"
-  ).requiredOption("--task <text>", "task description (required)").option("--workflow <name>", "workflow name", "execute-task").option(
-    "--apply",
-    "(deprecated; kept for backward compat \u2014 execute-task spawns immediately by default)"
-  ).option("--dry-run", "preview only \u2014 do not spawn subagent (opt-in for advanced users)").option("--non-interactive", "CI / scripts \u2014 requires --apply or --dry-run").option("--model <model>", "subagent model: 'haiku' | 'sonnet' | 'opus'").option("--model-tier <tier>", "override: 'inherit' bypasses per-phase phase.model (B-10)").option("--max-iterations <n>", "ralph-loop max iter (default 20)", (v) => parseInt(v, 10)).action(async (raw) => {
-    validateNonInteractiveFlags(raw, "execute-task --task <text>");
+  ).requiredOption("--task <text>", "task description (required)").option("--workflow <name>", "workflow name", "execute-task").option("--dry-run", "preview only \u2014 do not spawn subagent (opt-in for advanced users)").option("--non-interactive", "CI / scripts").option("--model <model>", "subagent model: 'haiku' | 'sonnet' | 'opus'").option("--model-tier <tier>", "override: 'inherit' bypasses per-phase phase.model (B-10)").option("--max-iterations <n>", "ralph-loop max iter (default 20)", (v) => parseInt(v, 10)).action(async (raw) => {
     if (!raw.task) {
       console.error("error: --task <text> is required");
       process.exit(2);
@@ -3065,7 +3050,7 @@ function registerExecuteTask(program2) {
         packageRoot: process.cwd(),
         cmdType: "git-commit",
         hasUserApproval: true
-        // --apply explicit
+        // apply-immediate default
       });
     } catch (err2) {
       console.warn(
@@ -3120,7 +3105,7 @@ async function dirSizeKb(dir) {
 function registerGc(program2) {
   program2.command("gc").description(
     "Garbage-collect old backup snapshots (immediate by default \u2014 use --dry-run for preview)"
-  ).option("--older-than <duration>", "delete snapshots older than (e.g. 30d / 24h / 4w)", "30d").option("--keep-last <N>", "always keep the most recent N snapshots", "0").option("--apply", "(deprecated; kept for backward compat \u2014 gc deletes immediately by default)").option("--dry-run", "preview only \u2014 do not delete (opt-in for advanced users)").action(async (opts) => {
+  ).option("--older-than <duration>", "delete snapshots older than (e.g. 30d / 24h / 4w)", "30d").option("--keep-last <N>", "always keep the most recent N snapshots", "0").option("--dry-run", "preview only \u2014 do not delete (opt-in for advanced users)").action(async (opts) => {
     const dryRun = opts.dryRun === true;
     const olderMs = parseDuration(opts.olderThan ?? "30d");
     if (olderMs == null) {
@@ -4475,11 +4460,10 @@ function formatError(e) {
   return `${head}${where}${tip}`;
 }
 function registerInstall(program2) {
-  program2.command("install <name>").description("Install an upstream (immediate by default \u2014 use --dry-run for preview)").option("--apply", "(deprecated; kept for backward compat \u2014 install is immediate by default)").option("--dry-run", "preview only \u2014 do not write to disk (opt-in for advanced users)").option("--system", "allow L4 system-wide install (e.g. global npm install)").option("--non-interactive", "skip all prompts (CI / scripts) \u2014 requires --apply or --dry-run").option("--full-diff", "expand diffs longer than 200 lines").option("--no-color", "disable ANSI colors (auto-detected when piped)").option(
+  program2.command("install <name>").description("Install an upstream (immediate by default \u2014 use --dry-run for preview)").option("--dry-run", "preview only \u2014 do not write to disk (opt-in for advanced users)").option("--system", "allow L4 system-wide install (e.g. global npm install)").option("--non-interactive", "skip all prompts (CI / scripts)").option("--full-diff", "expand diffs longer than 200 lines").option("--no-color", "disable ANSI colors (auto-detected when piped)").option(
     "--known-good",
     "use known-good version lock from versions/<harnessed-ver>-known-good.yaml"
   ).action(async (name, raw) => {
-    validateNonInteractiveFlags(raw, "install <name>");
     const { resolveAlias: resolveAlias2 } = await Promise.resolve().then(() => (init_aliases(), aliases_exports));
     const resolvedName = resolveAlias2(name) ?? name;
     checkPathSafe(resolvedName);
@@ -4558,11 +4542,7 @@ async function listBaseManifests(cwd) {
 function registerInstallBase(program2) {
   program2.command("install-base").description(
     "Install the phase 1.3 base profile (immediate by default \u2014 use --dry-run for preview)"
-  ).option(
-    "--apply",
-    "(deprecated; kept for backward compat \u2014 install-base is immediate by default)"
-  ).option("--dry-run", "preview only \u2014 do not write to disk (opt-in for advanced users)").option("--non-interactive", "skip all prompts (CI / scripts) \u2014 requires --apply or --dry-run").action(async (raw) => {
-    validateNonInteractiveFlags(raw, "install-base");
+  ).option("--dry-run", "preview only \u2014 do not write to disk (opt-in for advanced users)").option("--non-interactive", "skip all prompts (CI / scripts)").action(async (raw) => {
     const dryRun = raw.dryRun === true;
     const opts = {
       apply: !dryRun,
@@ -4628,11 +4608,7 @@ function basename(upstream) {
 function registerManifestAdd(program2) {
   program2.command("manifest-add <upstream>").description(
     "Add a new upstream adapter (EE-5 5-question merge gate; immediate by default \u2014 use --dry-run for preview)"
-  ).option("--category <cat>", "manifest category (skill-packs | tools)", "skill-packs").option("--name <name>", "short adapter name (defaults to <upstream> basename)").option(
-    "--apply",
-    "(deprecated; kept for backward compat \u2014 manifest-add persists immediately by default)"
-  ).option("--dry-run", "preview only \u2014 do not write JSON (opt-in for advanced users)").option("--non-interactive", "CI/scripts \u2014 requires --apply or --dry-run; WARN-only dry-run").action(async (upstream, raw) => {
-    validateNonInteractiveFlags(raw, "manifest-add <upstream>");
+  ).option("--category <cat>", "manifest category (skill-packs | tools)", "skill-packs").option("--name <name>", "short adapter name (defaults to <upstream> basename)").option("--dry-run", "preview only \u2014 do not write JSON (opt-in for advanced users)").option("--non-interactive", "CI/scripts \u2014 WARN-only dry-run").action(async (upstream, raw) => {
     const name = raw.name ?? basename(upstream);
     const category = raw.category ?? "skill-packs";
     const outPath = `manifests/${category}/${name}.ee5-answers.json`;
@@ -4677,11 +4653,7 @@ function registerManifestAdd(program2) {
 function registerResearch(program2) {
   program2.command("research").description(
     "Run research workflow (search category sub-routing \u2192 spawn \u2192 verbatim COMPLETE; immediate by default \u2014 use --dry-run for preview)"
-  ).requiredOption("--query <text>", "research prompt (required)").option(
-    "--apply",
-    "(deprecated; kept for backward compat \u2014 research spawns immediately by default)"
-  ).option("--dry-run", "preview only \u2014 do not spawn subagent (opt-in for advanced users)").option("--non-interactive", "skip all prompts (CI / scripts) \u2014 requires --apply or --dry-run").option("--model <model>", "subagent model: 'haiku' | 'sonnet' | 'opus'").action(async (raw) => {
-    validateNonInteractiveFlags(raw, "research --query <text>");
+  ).requiredOption("--query <text>", "research prompt (required)").option("--dry-run", "preview only \u2014 do not spawn subagent (opt-in for advanced users)").option("--non-interactive", "skip all prompts (CI / scripts)").option("--model <model>", "subagent model: 'haiku' | 'sonnet' | 'opus'").action(async (raw) => {
     if (!raw.query) {
       console.error("error: --query <text> is required");
       process.exit(2);
@@ -4720,7 +4692,7 @@ function registerResearch(program2) {
     if ("ok" in result && result.ok === false) {
       console.error(`error: ${result.phase} \u2014 ${result.error.message}`);
       if (result.phase === "install") {
-        console.error(`  fix:  'harnessed install <skill> --apply' (see error above)`);
+        console.error(`  fix:  'harnessed install <skill>' (see error above)`);
       }
       process.exit(1);
     }
@@ -5355,7 +5327,7 @@ async function runUninstall(manifest, opts) {
 
 // src/cli/uninstall.ts
 function registerUninstall(program2) {
-  program2.command("uninstall <name>").description("Uninstall an upstream (immediate by default \u2014 use --dry-run for preview)").option("--apply", "(deprecated; kept for backward compat \u2014 uninstall is immediate by default)").option("--dry-run", "preview only \u2014 do not delete files (opt-in for advanced users)").option("--yes", "skip interactive confirm (CI / scripts) \u2014 fatal with --dry-run").option("--non-interactive", "alias for --yes (CI compat)").action(async (name, raw) => {
+  program2.command("uninstall <name>").description("Uninstall an upstream (immediate by default \u2014 use --dry-run for preview)").option("--dry-run", "preview only \u2014 do not delete files (opt-in for advanced users)").option("--yes", "skip interactive confirm (CI / scripts) \u2014 fatal with --dry-run").option("--non-interactive", "alias for --yes (CI compat)").action(async (name, raw) => {
     const yes = raw.yes === true || raw.nonInteractive === true;
     if (yes && raw.dryRun) {
       console.error(