auriga-cli 1.25.0 → 1.26.0

package/dist/cli.js

@@ -6,7 +6,7 @@ import { exec, fetchContentRoot, getPackageRoot, isNonInteractive, LANGUAGES, lo
 import { installWorkflow } from "./workflow.js";
 import { installSkills, installRecommendedSkills } from "./skills.js";
 import { installPlugins } from "./plugins.js";
-import { installHooks } from "./hooks.js";
+import { installPreset } from "./preset.js";
 import { loadCatalog } from "./catalog.js";
 import { renderHelp, renderTypeHelp } from "./help.js";
 import { renderGuide } from "./guide.js";
@@ -17,7 +17,6 @@ const TYPE_FOR_FILTER = {
     "--skill": "skills",
     "--recommended-skill": "recommended",
     "--plugin": "plugins",
-    "--hook": "hooks",
 };
 function parseErr(msg) {
     throw new Error(msg);
@@ -179,6 +178,18 @@ function parseInstall(argv) {
             i += 1;
             continue;
         }
+        // `--preset` is a boolean flag — it takes no value. Reject the
+        // `--preset=...` equals form explicitly rather than letting it fall
+        // through to the generic "unknown argument" branch, so the user gets
+        // a message that names the actual mistake.
+        if (t === "--preset") {
+            out.preset = true;
+            i += 1;
+            continue;
+        }
+        if (t.startsWith("--preset=")) {
+            parseErr("--preset takes no value.");
+        }
         // Accept both `--lang en` and `--lang=en` (and same for --cwd, --scope).
         // The equals form is a common CLI affordance; rejecting it confuses
         // users with any prior gnu-style / node util.parseArgs experience.
@@ -244,6 +255,37 @@ function parseInstall(argv) {
     return out;
 }
 function validateInstall(out, filterFlag) {
+    // Rule 1: --preset is atomic. It installs the curated default set
+    // (workflow doc + workflow skills + auriga-workflow plugin) and cannot
+    // combine with a <type>, a sub-item filter, or --all. Unlike a category
+    // install it DOES accept --scope / --agent / --lang as preset modifiers
+    // (the preset defaults differ: user / both / en). --cwd is not a preset
+    // modifier — the workflow doc always lands in the current directory.
+    if (out.preset) {
+        if (out.all) {
+            parseErr("--preset and --all are both atomic; pass only one.");
+        }
+        if (out.type) {
+            parseErr(`--preset is atomic; it cannot combine with the '${out.type}' type.`);
+        }
+        if (out.filter) {
+            parseErr("--preset is atomic; it cannot combine with --skill/--recommended-skill/--plugin.");
+        }
+        if (out.cwd !== undefined) {
+            parseErr("--cwd does not apply to --preset.");
+        }
+        if (out.scope !== undefined)
+            validateScopeValue(out.scope);
+        if (out.agent !== undefined)
+            validateAgentValue(out.agent);
+        if (out.lang !== undefined) {
+            const valid = LANGUAGES.map((l) => l.value);
+            if (!valid.includes(out.lang)) {
+                parseErr(`unknown language '${out.lang}'; available: ${valid.join(", ")}`);
+            }
+        }
+        return;
+    }
     // Rule 2: --all is atomic.
     if (out.all) {
         if (out.type || out.filter || out.lang !== undefined || out.cwd !== undefined) {
@@ -267,7 +309,7 @@ function validateInstall(out, filterFlag) {
     if ((out.lang !== undefined || out.cwd !== undefined) && out.type !== "workflow") {
         parseErr("--lang/--cwd only apply to workflow.");
     }
-    // Rule 6: --scope only for skills / recommended / plugins / hooks.
+    // Rule 6: --scope only for skills / recommended / plugins.
     // workflow (single file + symlink) has no scope concept.
     if (out.scope !== undefined) {
         if (out.type === "workflow") {
@@ -308,8 +350,7 @@ function validateFilterAgainstCatalog(type, filter) {
     const bucket = type === "skills" ? catalog.workflowSkills
         : type === "recommended" ? catalog.recommendedSkills
             : type === "plugins" ? catalog.plugins
-                : type === "hooks" ? catalog.hooks
-                    : null;
+                : null;
     if (!bucket)
         return;
     const available = bucket.map((e) => e.name);
@@ -327,9 +368,6 @@ function migratedPluginHint(type, name) {
         ["incremental-impl", "test-designer", "session-compound"].includes(name)) {
         return "This skill moved to the auriga-workflow plugin; install it with `install plugins --plugin auriga-workflow`.";
     }
-    if (type === "hooks" && name === "notify") {
-        return "The notify hook moved to the auriga-notify plugin; install it with `install plugins --plugin auriga-notify`.";
-    }
     return undefined;
 }
 function categorySingular(type) {
@@ -350,8 +388,16 @@ function validateAgentValue(agent) {
 // ---------------------------------------------------------------------------
 // main — returns exit code (spec §5.3.1 / §7)
 // ---------------------------------------------------------------------------
-// --all excludes `recommended` (per spec §3.2) — they're opt-in utilities.
-const ALL_CATEGORIES = ["workflow", "skills", "plugins", "hooks"];
+// --all is "install everything": every category, including the opt-in
+// recommended skills. Order matches the menu / execution order
+// (workflow → skills → recommended → plugins). The curated subset lives
+// behind --preset (workflow doc + workflow skills + auriga-workflow).
+const ALL_CATEGORIES = [
+    "workflow",
+    "skills",
+    "recommended",
+    "plugins",
+];
 export async function main(argv) {
     let parsed;
     try {
@@ -403,14 +449,19 @@ export async function main(argv) {
     return runInstall(parsed.install);
 }
 async function runInstall(p) {
-    // Bare `install` (no type, no --all, no filter): TTY → menu, non-TTY → exit 1.
-    if (!p.all && !p.type) {
+    // Bare `install` (no type, no --all, no --preset, no filter):
+    // TTY → menu, non-TTY → exit 1.
+    if (!p.all && !p.preset && !p.type) {
         if (isNonInteractive()) {
             log.error("Interactive mode requires a TTY. Run 'npx auriga-cli --help' for non-interactive options.");
             return 1;
         }
         return runLegacyMenu();
     }
+    // --preset: curated default-set install (precheck + ordered fan-out).
+    if (p.preset) {
+        return runPreset(p);
+    }
     // --all: precheck + fan-out.
     if (p.all) {
         return runAll(p);
@@ -418,6 +469,50 @@ async function runInstall(p) {
     // Single-category install.
     return runSingle(p);
 }
+/**
+ * `install --preset` — installs the curated default set via the shared
+ * `installPreset` orchestrator. Graded exit mirrors `runAll`: all steps
+ * succeed → 0; any step fails → 2 with per-step status on stderr.
+ *
+ * The preset defaults differ from a category install — scope=user,
+ * agent=both, lang=en — and are resolved here before handing off, so
+ * `installPreset` itself stays default-free (the TUI / Web UI callers
+ * resolve their own defaults the same way).
+ */
+async function runPreset(p) {
+    const agent = p.agent ?? "both";
+    const prep = await prepareInstall(["plugins"], agent);
+    if ("exit" in prep)
+        return prep.exit;
+    const { packageRoot } = prep;
+    const results = await installPreset(packageRoot, {
+        interactive: false,
+        scope: p.scope ?? "user",
+        agent,
+        lang: p.lang ?? "en",
+    });
+    for (const r of results) {
+        if (r.ok) {
+            process.stderr.write(`[OK]   ${r.category}\n`);
+        }
+        else {
+            process.stderr.write(`[FAIL] ${r.category} — ${r.err}\n`);
+        }
+    }
+    const failed = results.filter((r) => !r.ok);
+    if (failed.length === 0) {
+        process.stderr.write(RELOAD_REMINDER);
+        return 0;
+    }
+    // The preset is one atomic "install the right defaults" action — the
+    // retry is the whole command again, not a per-category fan-out like
+    // runAll's hint.
+    process.stderr.write("\nRetry:\n  npx -y auriga-cli install --preset\n");
+    if (failed.length < results.length) {
+        process.stderr.write(RELOAD_REMINDER);
+    }
+    return 2;
+}
 /**
  * Precheck external prerequisites before touching any files.
  * Returns null if OK, or an error message.
@@ -481,7 +576,7 @@ async function runAll(p) {
     for (const category of ALL_CATEGORIES) {
         // Forward `scope` only when the user actually passed one. Each
         // installer picks its own default for undefined so category-specific
-        // defaults (skills/recommended/plugins/hooks all map undefined → project)
+        // defaults (skills/recommended/plugins all map undefined → project)
         // aren't flattened by a one-size-fits-all fallback here.
         const opts = {
             interactive: false,
@@ -566,7 +661,6 @@ async function dispatchInstaller(category, packageRoot, opts) {
         case "skills": return installSkills(packageRoot, opts);
         case "recommended": return installRecommendedSkills(packageRoot, opts);
         case "plugins": return installPlugins(packageRoot, opts);
-        case "hooks": return installHooks(packageRoot, opts);
     }
 }
 // ---------------------------------------------------------------------------
@@ -664,7 +758,9 @@ async function runUi(p, version) {
         skill: new Set(Object.keys(scanCatalog.skills)),
         "recommended-skill": new Set(Object.keys(scanCatalog.recommendedSkills)),
         plugin: new Set(Object.keys(scanCatalog.plugins)),
-        hook: new Set(Object.keys(scanCatalog.hooks)),
+        // Preset is a singleton apply target — the sentinel name "preset"
+        // matches what the Dashboard's preset button sends.
+        preset: new Set(["preset"]),
     };
     const pluginAgentsByName = new Map();
     for (const [name, def] of Object.entries(scanCatalog.plugins)) {
@@ -775,10 +871,33 @@ function highlight(text) {
         return text;
     return `\x1b[1;36m${text}\x1b[0m`;
 }
-// ---------------------------------------------------------------------------
-// Legacy checkbox menu — preserved for `npx auriga-cli install` in TTY
-// and `npx auriga-cli` with no args.
-// ---------------------------------------------------------------------------
+/**
+ * The TUI's three menu items, in fixed order. Lifted to a module-level
+ * constant so VAL-TUI-001 / VAL-TUI-002 can assert the "exactly 3 items /
+ * order / default-checked" contract without driving inquirer.
+ *
+ * Workflow + Skills are absorbed by the「推荐预设」item.
+ * The preset label spells out the silent defaults (scope user / agent
+ * both / lang en) so a TTY user knows what they're getting — fine-tuning
+ * those goes through the non-interactive `install --preset` flags.
+ */
+export const LEGACY_MENU_CHOICES = [
+    {
+        value: "preset",
+        name: "Recommended preset — CLAUDE.md/AGENTS.md + workflow skills + auriga-workflow plugin (scope user · agent both · lang en)",
+        checked: true,
+    },
+    {
+        value: "recommended",
+        name: "Optional skills — opt-in utility skills (claude-code-agent, codex-agent...)",
+        checked: false,
+    },
+    {
+        value: "plugins",
+        name: "Other plugins — everything except auriga-workflow (auriga-notify, skill-creator, codex...)",
+        checked: false,
+    },
+];
 async function runLegacyMenu() {
     // Lazy-load TTY-only deps so the non-interactive code path doesn't
     // force inquirer / printBanner / withEsc into the module graph.
@@ -796,40 +915,42 @@ async function runLegacyMenu() {
     const packageRoot = await fetchContentRoot();
     if (process.env.DEV !== "1")
         console.log("");
-    const moduleTypes = await withEsc(checkbox({
-        message: "Select module types to install:",
-        choices: [
-            { name: "Workflow — CLAUDE.md + AGENTS.md", value: "workflow", checked: true },
-            { name: "Skills — Development process skills (TDD, debugging, verification, planning...)", value: "skills", checked: true },
-            { name: "Recommended Skills — Extra utility skills (claude-code-agent, codex-agent...)", value: "recommended", checked: true },
-            { name: "Plugins — Claude Code / Codex plugins (skill-creator, codex, auriga-workflow...)", value: "plugins", checked: true },
-            { name: "Hooks — Claude Code hooks (notifications, etc.)", value: "hooks", checked: true },
-        ],
+    const picks = await withEsc(checkbox({
+        message: "Select what to install:",
+        choices: LEGACY_MENU_CHOICES.map((c) => ({
+            name: c.name,
+            value: c.value,
+            checked: c.checked,
+        })),
     }));
-    if (moduleTypes.length === 0) {
+    if (picks.length === 0) {
         console.log("Nothing selected. Bye!");
         return 0;
     }
-    const interactiveOpts = { interactive: true };
-    if (moduleTypes.includes("workflow")) {
-        console.log("\n--- Workflow ---\n");
-        await installWorkflow(packageRoot, interactiveOpts);
-    }
-    if (moduleTypes.includes("skills")) {
-        console.log("\n--- Skills ---\n");
-        await installSkills(packageRoot, interactiveOpts);
-    }
-    if (moduleTypes.includes("recommended")) {
-        console.log("\n--- Recommended Skills ---\n");
-        await installRecommendedSkills(packageRoot, interactiveOpts);
-    }
-    if (moduleTypes.includes("plugins")) {
-        console.log("\n--- Plugins ---\n");
-        await installPlugins(packageRoot, interactiveOpts);
+    // 「推荐预设」silently uses the preset defaults (scope user / agent
+    // both / lang en) — it does not prompt for them. The other two items
+    // drill down into their category's per-item sub-selection as before.
+    if (picks.includes("preset")) {
+        console.log("\n--- Recommended preset ---\n");
+        await installPreset(packageRoot, {
+            interactive: true,
+            scope: "user",
+            agent: "both",
+            lang: "en",
+        });
     }
-    if (moduleTypes.includes("hooks")) {
-        console.log("\n--- Hooks ---\n");
-        await installHooks(packageRoot, interactiveOpts);
+    if (picks.includes("recommended")) {
+        console.log("\n--- Optional skills ---\n");
+        await installRecommendedSkills(packageRoot, { interactive: true });
+    }
+    if (picks.includes("plugins")) {
+        console.log("\n--- Other plugins ---\n");
+        await installPlugins(packageRoot, {
+            interactive: true,
+            // auriga-workflow is already covered by the preset — keep it out
+            // of this sub-selection (VAL-TUI-005).
+            excludePlugins: ["auriga-workflow"],
+        });
     }
     console.log("\n✨ Installation complete!\n");
     return 0;

package/dist/guide.js

@@ -20,7 +20,7 @@ export function renderGuide(opts) {
     return `${h(`# auriga-cli bootstrap SOP (v${opts.version})`)}
 
 This guide walks an Agent through installing the auriga harness
-(CLAUDE.md + skills + plugins, plus any legacy hooks) into the current repository.
+(CLAUDE.md + skills + plugins) into the current repository.
 
 Run each step in order. If any step fails with exit 1, stop and report.
 If exit 2, see stderr for per-category status and follow the "Retry"
@@ -44,13 +44,13 @@ If you plan to install Codex plugins, also verify \`codex --version\`.
 
 ${h("## Step 2 — Read --help BEFORE installing (do not skip)")}
 
-${warn("⚠")} Always inspect the catalog first so you know which skills,
-plugins, and hooks are actually relevant for this project. Blindly
-running \`install --all\` works as a turnkey preset, but for anything
-beyond a greenfield bootstrap you should narrow scope.
+${warn("⚠")} Always inspect the catalog first so you know which skills
+and plugins are actually relevant for this project. Blindly
+running \`install --preset\` works as a turnkey bootstrap, but for
+anything beyond a greenfield setup you should narrow scope.
 
-Top-level catalog (every workflow skill / recommended skill / plugin /
-hook with a short description):
+Top-level catalog (every workflow skill / recommended skill / plugin
+with a short description):
   ${cmd("npx -y auriga-cli --help")}
 
 Per-type detail (flags + only that category's catalog slice):
@@ -58,12 +58,15 @@ Per-type detail (flags + only that category's catalog slice):
   ${cmd("npx -y auriga-cli install skills --help")}
   ${cmd("npx -y auriga-cli install recommended --help")}
   ${cmd("npx -y auriga-cli install plugins --help")}
-  ${cmd("npx -y auriga-cli install hooks --help")}
 
 ${h("## Step 3 — Install")}
 
-Preset — the full default-on set (workflow + skills + default plugins;
-the legacy hooks category is currently empty; recommended skills are NOT included):
+Recommended — the curated workflow preset (CLAUDE.md/AGENTS.md +
+workflow skills + the auriga-workflow plugin). Defaults: scope user,
+agent both (Claude Code + Codex), lang en:
+  ${cmd("npx -y auriga-cli install --preset")}
+
+Everything — workflow + skills + recommended skills + default plugins:
   ${cmd("npx -y auriga-cli install --all")}
 
 Targeted — single category, picking from the catalog surfaced in Step 2:
@@ -93,7 +96,7 @@ Exit codes:
 
 ${h("## Step 4 — Reload session (REQUIRED when installed non-interactively)")}
 
-${warn("⚠")} CLAUDE.md, .agents/skills/, plugin enablement, and hook/plugin
+${warn("⚠")} CLAUDE.md, .agents/skills/, and plugin enablement /
 registrations are loaded at session startup. If you ran
 \`npx -y auriga-cli install\` inside an existing Claude Code or Codex session
 (e.g., \`claude -p\` / \`claude -p --worktree\` / \`codex exec\`), the current session
@@ -112,7 +115,7 @@ Expected artifacts/checks:
   - .agents/skills/<name>/    (one per installed skill)
   - claude plugins list       (shows Claude plugins, if Claude plugins selected)
   - ~/.codex/config.toml      (Codex plugin enablement, if Codex plugins selected)
-  - .claude/settings.json     (updated hook/plugin registrations, if selected)
+  - .claude/settings.json     (updated plugin registrations, if selected)
   - .claude/auriga-notify/    (project notify config, if auriga-notify selected)
 
 ${h("## Troubleshooting")}

package/dist/help.js

@@ -10,9 +10,13 @@ export function renderHelp(catalog, version) {
 USAGE
   npx auriga-cli guide                                   Agent bootstrap SOP (start here)
   npx auriga-cli install                                 (TTY only) checkbox menu
+  npx auriga-cli install --preset [--scope <s>] [--agent <a>] [--lang <code>]
+                                                         curated default set: workflow doc
+                                                         + workflow skills + auriga-workflow plugin
+                                                         (defaults: scope user, agent both, lang en)
   npx auriga-cli install --all [--scope <s>] [--agent <a>]
-                                                         workflow + skills + plugins + hooks
-                                                         (excludes recommended — install separately)
+                                                         everything: workflow + skills
+                                                         + recommended + plugins
   npx auriga-cli install <type> [type-specific flags]    single category
   npx auriga-cli install <type> --help                   per-category help + catalog subset
   npx auriga-cli web-ui [--port <n>] [--ui-dir <path>] [--no-open]
@@ -21,14 +25,13 @@ USAGE
 
   For non-interactive (Agent) use, prepend npx's own -y flag:
     npx -y auriga-cli guide
-    npx -y auriga-cli install --all
+    npx -y auriga-cli install --preset
 
 TYPES (exactly one with <type> form)
   workflow       CLAUDE.md + AGENTS.md (workflow manifesto)
   skills         Default-on workflow skills (listed below)
   recommended    Opt-in utility skills (listed below)
   plugins        Claude Code and Codex plugins (listed below)
-  hooks          Project-level hooks for Claude Code (listed below)
 
 TYPE-SPECIFIC FLAGS
   workflow:       --lang <code>                  default en; available: en, zh-CN
@@ -40,9 +43,6 @@ TYPE-SPECIFIC FLAGS
   plugins:        --plugin <names...>
                   --agent <claude|codex|both>   default claude
                   --scope <project|user>         default project
-  hooks:          --hook <names...>              non-interactive default installs every
-                                                 hook with defaultOn != false
-                  --scope <project|user>         default project
 
 TOP-LEVEL OPTIONS
   -h, --help                     show this help
@@ -52,18 +52,15 @@ TOP-LEVEL OPTIONS
 CATALOG (what each category contains)
 ──────────────────────────────────────────────────────
 
-Workflow skills (category: skills)  ← installed by --all
+Workflow skills (category: skills)  ← installed by --all and --preset
 ${col(catalog.workflowSkills)}
 
-Recommended skills (category: recommended)  ← NOT installed by --all
+Recommended skills (category: recommended)  ← installed by --all, NOT by --preset
 ${col(catalog.recommendedSkills)}
 
 Plugins (category: plugins)
 ${col(catalog.plugins)}
 
-Hooks (category: hooks)
-${col(catalog.hooks)}
-
 More: https://github.com/Ben2pc/auriga-cli
 `;
 }
@@ -114,7 +111,7 @@ FLAGS
                                    omit → install every recommended skill listed below
   --scope <project|user>           default project
 
-CATALOG (recommended skills — opt-in, NOT installed by --all)
+CATALOG (recommended skills — opt-in; installed by --all, not by --preset)
 ${col(catalog.recommendedSkills)}
 `;
         case "plugins":
@@ -133,21 +130,6 @@ FLAGS
 
 CATALOG (plugins)
 ${col(catalog.plugins)}
-`;
-        case "hooks":
-            return `${header}
-
-USAGE
-  npx auriga-cli install hooks [--hook <names...>] [--scope <project|user>]
-
-FLAGS
-  --hook <names...>        space-separated; '*' = every compatible hook
-                           omit → install every hook with defaultOn != false
-  --scope <project|user>   default project
-                           (project-local is only reachable via the TTY menu)
-
-CATALOG (hooks — entries flagged "(opt-in)" require explicit --hook)
-${col(catalog.hooks)}
 `;
     }
 }

package/dist/plugins.d.ts

@@ -27,6 +27,15 @@ export interface ExtraPluginConfigs {
     plugins: ExtraPluginConfig[];
 }
 export declare function validateExtraPluginConfigs(raw: unknown): asserts raw is ExtraPluginConfigs;
+/**
+ * Drops `exclude`-named plugins from a candidate list. The TUI's
+ *「其他插件」menu item passes `["auriga-workflow"]` so the plugin already
+ * installed by the preset isn't offered again (VAL-TUI-005). A pure,
+ * order-preserving filter — `undefined` / empty `exclude` is a no-op.
+ */
+export declare function excludeByName<T extends {
+    name: string;
+}>(plugins: T[], exclude: readonly string[] | undefined): T[];
 export declare function loadExtraPluginConfigs(packageRoot: string): ExtraPluginConfigs;
 export declare function extraAppliesTo(extra: ExtraPluginConfig, runtime: PluginRuntime): boolean;
 export declare function extraByNameForRuntime(extras: ExtraPluginConfigs, runtime: PluginRuntime): Map<string, ExtraPluginConfig>;

package/dist/plugins.js

@@ -114,6 +114,18 @@ function getInstalledPlugins(cwd = process.cwd()) {
         return new Map();
     }
 }
+/**
+ * Drops `exclude`-named plugins from a candidate list. The TUI's
+ *「其他插件」menu item passes `["auriga-workflow"]` so the plugin already
+ * installed by the preset isn't offered again (VAL-TUI-005). A pure,
+ * order-preserving filter — `undefined` / empty `exclude` is a no-op.
+ */
+export function excludeByName(plugins, exclude) {
+    if (!exclude || exclude.length === 0)
+        return plugins;
+    const drop = new Set(exclude);
+    return plugins.filter((p) => !drop.has(p.name));
+}
 /**
  * Non-interactive selection resolver for plugins.
  * `undefined` = default-on set; `["*"]` = full set; explicit names =
@@ -727,16 +739,19 @@ async function installCodexPlugins(packageRoot, opts) {
         log.warn(msg);
         return;
     }
+    // `excludePlugins` (set by the TUI's「其他插件」item) keeps preset-owned
+    // plugins out of the offered set.
+    const offered = excludeByName(installConfig.plugins, opts.excludePlugins);
     const selected = opts.interactive
         ? await withEsc(checkbox({
             message: "Select Codex plugins to install:",
-            choices: installConfig.plugins.map((p) => ({
+            choices: offered.map((p) => ({
                 name: p.description ? `${p.name} — ${p.description}` : p.name,
                 value: p,
                 checked: p.defaultOn !== false,
             })),
         }))
-        : resolveCodexPluginSelection(installConfig.plugins, opts.selected);
+        : resolveCodexPluginSelection(offered, opts.selected);
     if (selected.length === 0) {
         log.skip("No Codex plugins selected");
         return;
@@ -878,6 +893,9 @@ export async function installPlugins(packageRoot, opts) {
         }))
         : opts.scope ?? "project";
     if (config) {
+        // `excludePlugins` (set by the TUI's「其他插件」item) keeps
+        // preset-owned plugins out of the offered set.
+        config = { ...config, plugins: excludeByName(config.plugins, opts.excludePlugins) };
         const targetCwd = installTargetCwd(opts);
         const installed = getInstalledPlugins(targetCwd);
         let selected;

package/dist/preset.d.ts

@@ -0,0 +1,38 @@
+import type { PluginAgent } from "./utils.js";
+/**
+ * 预设安装的插件成员 —— 固定只装 auriga-workflow。
+ * installPlugins 的 `selected` 过滤把安装面收敛到这一个插件。
+ * `as const` 冻结这个「单一真相」常量,调用方无法 .push() 篡改它。
+ */
+export declare const PRESET_PLUGINS: readonly ["auriga-workflow"];
+/**
+ * installPreset 的输入。三个默认值(scope=user / agent=both / lang=en)
+ * 与分类安装不同,由调用方负责落定后再传入 —— 预设的默认不在本函数内
+ * 兜底,使「默认值是什么」对每个调用端都显式可见。
+ */
+export interface PresetOpts {
+    scope: "project" | "user";
+    agent: PluginAgent;
+    lang: string;
+    /** workflow 文档的安装目标目录;缺省即 installer 自身的 cwd 默认。 */
+    cwd?: string;
+    /** false = 非交互(CLI / Web UI),installer 在失败处抛错;
+     *  true  = 交互(TUI),installer log-and-continue。 */
+    interactive: boolean;
+    /** 逐行进度回调 —— Web UI 的 SSE 流式输出用。 */
+    onLog?: (line: string, stream: "stdout" | "stderr") => void;
+}
+/** 预设安装中单个步骤的成败。 */
+export interface PresetStepResult {
+    category: "workflow" | "skills" | "plugins";
+    ok: boolean;
+    /** ok === false 时携带失败原因。 */
+    err?: string;
+}
+/**
+ * 按 workflow → skills → plugins 顺序执行预设安装。
+ *
+ * 每一步独立 try/catch:一步失败不阻断后续步骤(与 runAll 的
+ * log-and-continue 一致),逐步成败汇总后返回给调用方。
+ */
+export declare function installPreset(packageRoot: string, opts: PresetOpts): Promise<PresetStepResult[]>;