auriga-cli 1.24.0 → 1.26.0

package/README.md

@@ -14,7 +14,6 @@ This repo itself is a fully configured harness project. You can clone it to see
 | **Skills** | External development process skills — systematic-debugging, TDD, verification, planning, playwright (spec authoring and architecture design ship as the `spec-design` and `arch-design` skills inside the `auriga-workflow` plugin) |
 | **Recommended Skills** | Optional utility skills (e.g. `codex-agent`, `claude-code-agent`) you can add on top of the workflow skills |
 | **Plugins** | Recommended Claude Code and Codex plugins — skill-creator, claude-md-management, codex, auriga-workflow, auriga-notify, session-instructions-loader |
-| **Hooks** | Legacy Claude Code hook installer. No repo-owned hooks are currently exposed here; `notify` ships as the `auriga-notify` plugin. |
 
 ## Quick Start
 
@@ -34,20 +33,25 @@ Running inside `claude -p`, `claude -p --worktree`, or any non-interactive Agent
 npx -y auriga-cli guide
 ```
 
-This prints a 5-step SOP (prerequisite check → `install --all` → optional recommended skills → session reload → verify). Follow it top-to-bottom and the Agent can install the full harness without any human prompt.
+This prints a 5-step SOP (prerequisite check → `install --preset` → optional recommended skills → session reload → verify). Follow it top-to-bottom and the Agent can install the full harness without any human prompt.
 
 The leading `-y` belongs to `npx` (it auto-confirms package installation), **not** to `auriga-cli`.
 
 Non-interactive install commands:
 
 ```bash
-npx -y auriga-cli install --all              # workflow + skills + default plugins (atomic)
-npx -y auriga-cli install recommended        # opt-in utility skills (not in --all)
+npx -y auriga-cli install --preset           # curated workflow core: CLAUDE.md/AGENTS.md
+                                             #   + workflow skills + auriga-workflow plugin
+                                             #   (defaults: scope user, agent both, lang en)
+npx -y auriga-cli install --all              # everything: workflow + skills + recommended + plugins
+npx -y auriga-cli install recommended        # just the opt-in utility skills
 npx -y auriga-cli install plugins --agent codex --plugin session-instructions-loader
-npx -y auriga-cli install <type> [--flags]   # one of: workflow | skills | recommended | plugins | hooks
+npx -y auriga-cli install <type> [--flags]   # one of: workflow | skills | recommended | plugins
 npx -y auriga-cli --help                     # full catalog + flags
 ```
 
+`--preset` is atomic — it cannot be combined with a `<type>` or any filter flag, but it accepts `--scope`, `--agent`, and `--lang` (preset defaults: `user` / `both` / `en`, which differ from the per-category defaults).
+
 Exit codes: `0` success, `1` fatal (precheck / parse / fetch), `2` partial success — `stderr` lists per-category `[OK]/[FAIL]` and a `Retry:` hint. After install, reload the Claude Code or Codex session so the new `CLAUDE.md` / skills / plugins / hook-plugin registrations are picked up.
 
 ### Web UI (opt-in)
@@ -71,15 +75,13 @@ npx auriga-cli
 Interactive menu — select what to install:
 
 ```
-? Select module types to install:
-  ◉ Workflow — CLAUDE.md + AGENTS.md
-  ◉ Skills — Development process skills
-  ◉ Recommended Skills — Extra utility skills
-  ◉ Plugins — Claude Code / Codex plugins
-  ◉ Hooks — Claude Code hooks
+? Select what to install:
+  ◉ Recommended preset — CLAUDE.md/AGENTS.md + workflow skills + auriga-workflow plugin
+  ◯ Optional skills — opt-in utility skills (claude-code-agent, codex-agent...)
+  ◯ Other plugins — everything except auriga-workflow (auriga-notify, skill-creator, codex...)
 ```
 
-Each module supports scope selection where applicable (Skills: project/global, Claude Code Plugins: user/project, Hooks: project local / project / user). Plugin installation also asks which runtime to target: Claude Code, Codex, or both.
+The **Recommended preset** is checked by default and installs silently with the preset defaults (scope `user`, agent `both`, language `en`) — to fine-tune those, use the non-interactive `install --preset` flags. The other two items drill down into a per-item sub-selection. Plugin installation also asks which runtime to target: Claude Code, Codex, or both.
 
 ## Module Details
 
@@ -102,7 +104,7 @@ Installs selected skills via `npx skills add`, targeting both Claude Code and Co
 | planning-with-files | [OthmanAdi/planning-with-files](https://github.com/OthmanAdi/planning-with-files) | File-based task planning and progress tracking |
 | playwright-cli | [microsoft/playwright-cli](https://github.com/microsoft/playwright-cli) | Browser automation and testing |
 
-**Recommended Skills (opt-in, not installed by `--all`):**
+**Recommended Skills (opt-in utility skills — installed by `--all`, not by `--preset`):**
 
 | Skill | Source | Description |
 |---|---|---|
@@ -133,21 +135,14 @@ npx -y auriga-cli install plugins --agent codex --plugin session-instructions-lo
 | skill-creator | Claude Code | Create and manage custom skills |
 | claude-md-management | Claude Code | Audit and improve CLAUDE.md |
 | codex | Claude Code | Codex cross-model collaboration |
-| auriga-workflow | Claude Code / Codex | The auriga workflow plugin — workflow skills plus the git lifecycle hooks that enforce them. Skills: `incremental-impl`, `test-designer`, `spec-design`, `arch-design`, `code-simplify`, `session-compound`, `goalify` (plans an autonomous goal and dispatches it via Claude Code's built-in `/goal` command), `deep-review` (multi-dimensional PR review orchestrator — parallel per-dimension reviewers synthesized into an actionable punch list), `reviewer-creator` (scaffolds project-level custom reviewers under `docs/rules/review/`), and `git-workflow` (git lifecycle skill). Hooks: `commit-reminder` (PostToolUse on file edits — `Edit` / `Write` / `MultiEdit` in Claude Code, `apply_patch` in Codex — nudges to commit at the next semantic boundary when uncommitted diff vs `HEAD` exceeds 200 lines or 8 files), `pr-create-guard` (PostToolUse on `gh pr create` → injects a PR-body snapshot for five-element self-verification and flags non-Conventional-Commits titles), and `pr-ready-guard` (PreToolUse on `gh pr ready` and non-draft `gh pr create` → blocks on stray planning docs, unfinalized active specs under `docs/specs/`, or unpushed commits). The two PostToolUse hooks reach full Claude Code / Codex parity; Codex currently fails open on `pr-ready-guard`'s PreToolUse `additionalContext` informational path (block path identical). Installed by default through the plugin path. |
+| auriga-workflow | Claude Code / Codex | The auriga workflow plugin — workflow skills plus the git lifecycle hooks that enforce them. Skills: `incremental-impl`, `test-designer`, `spec-design`, `arch-design`, `code-simplify`, `session-compound`, `goalify` (plans an autonomous goal and dispatches it via the built-in `/goal` command), `deep-review` (multi-dimensional PR review orchestrator — parallel per-dimension reviewers synthesized into an actionable punch list), `reviewer-creator` (scaffolds project-level custom reviewers under `docs/rules/review/`), and `git-workflow` (git lifecycle skill). Hooks: `commit-reminder` (PostToolUse on file edits — `Edit` / `Write` / `MultiEdit` in Claude Code, `apply_patch` in Codex — nudges to commit at the next semantic boundary when uncommitted diff vs `HEAD` exceeds 200 lines or 8 files), `pr-create-guard` (PostToolUse on `gh pr create` → injects a PR-body snapshot for five-element self-verification and flags non-Conventional-Commits titles), and `pr-ready-guard` (PreToolUse on `gh pr ready` and non-draft `gh pr create` → blocks on stray planning docs, unfinalized active specs under `docs/specs/`, or unpushed commits). The two PostToolUse hooks reach full Claude Code / Codex parity; Codex currently fails open on `pr-ready-guard`'s PreToolUse `additionalContext` informational path (block path identical). Installed by default through the plugin path. |
 | auriga-notify *(opt-in)* | Claude Code | macOS native notification plugin for Claude Code `Notification` events. Focus-aware sound-only mode, click-to-activate, per-project notification grouping, and migrated `config.json` / `icon.png` support. Not installed by `install --all`; install explicitly with `install plugins --plugin auriga-notify`. |
 | session-instructions-loader | Codex | Codex-only SessionStart plugin that injects ancestor `AGENTS.md` files plus repo-configured extra instruction files. |
 
-### Hooks
-
-The traditional hook installer remains for compatibility, but this repo no
-longer exposes a repo-owned hook through `install hooks`. New repo-owned hooks
-should be shipped inside plugins. The former `notify` hook is now the
-`auriga-notify` plugin.
-
 ## Requirements
 
 - Node.js >= 18
-- [Claude Code](https://docs.anthropic.com/en/docs/claude-code) (required for Claude Code Plugins and Hooks modules)
+- [Claude Code](https://docs.anthropic.com/en/docs/claude-code) (required for the Plugins module)
 - Codex CLI (required only for `install plugins --agent codex|both`)
 - [Homebrew](https://brew.sh) (recommended for the `auriga-notify` plugin to use `alerter`)
 

package/README.zh-CN.md

@@ -14,7 +14,6 @@
 | **Skills** | 外部开发流程 skills —— systematic-debugging、TDD、verification、planning、playwright（spec 撰写与架构设计由 `auriga-workflow` 插件内的 `spec-design`、`arch-design` skill 提供）|
 | **Recommended Skills** | 可选的工具类 skills（如 `codex-agent`、`claude-code-agent`），在 workflow skills 之外按需追加 |
 | **Plugins** | 推荐的 Claude Code 和 Codex 插件 —— skill-creator、claude-md-management、codex、auriga-workflow、auriga-notify、session-instructions-loader |
-| **Hooks** | 传统 Claude Code hook 安装器。目前没有仓库自维护 hook 暴露在这里；`notify` 已迁移为 `auriga-notify` 插件。 |
 
 ## 快速开始
 
@@ -34,21 +33,26 @@
 npx -y auriga-cli guide
 ```
 
-会打印一份 5 步 SOP（前置检查 → `install --all` → 可选 recommended skills → 重启 session → 验证）。Agent 照着顺序往下跑就能装完整套 harness，全程不需要人按键。
+会打印一份 5 步 SOP（前置检查 → `install --preset` → 可选 recommended skills → 重启 session → 验证）。Agent 照着顺序往下跑就能装完整套 harness，全程不需要人按键。
 
 开头的 `-y` 是 **npx 自己的 flag**（用来跳过"是否要装这个包"的确认），**不是** auriga-cli 的参数。
 
 非交互安装命令：
 
 ```bash
-npx -y auriga-cli install --all              # workflow + skills + 默认 plugins（原子）
-npx -y auriga-cli install recommended        # 可选工具 skills（不在 --all 内）
+npx -y auriga-cli install --preset           # 工作流核心:CLAUDE.md/AGENTS.md
+                                             #   + 工作流 skill + auriga-workflow 插件
+                                             #   (默认:scope user、agent both、lang en)
+npx -y auriga-cli install --all              # 全装:workflow + skills + recommended + plugins
+npx -y auriga-cli install recommended        # 只装可选工具 skills
 npx -y auriga-cli install plugins --agent codex --plugin session-instructions-loader
-npx -y auriga-cli install <type> [--flags]   # 单类：workflow | skills | recommended | plugins | hooks
+npx -y auriga-cli install <type> [--flags]   # 单类:workflow | skills | recommended | plugins
 npx -y auriga-cli --help                     # 完整 catalog + flag 说明
 ```
 
-退出码：`0` 成功；`1` 致命错误（前置检查 / 解析 / 拉取失败）；`2` 部分成功——`stderr` 会列出逐类 `[OK]/[FAIL]` 和 `Retry:` 提示。装完后请重启 Claude Code 或 Codex 会话，让新的 `CLAUDE.md` / skills / plugins / hook 注册生效。
+`--preset` 是原子标志 —— 不能与 `<type>` 或任何过滤标志同时使用,但可带 `--scope`、`--agent`、`--lang`(预设默认 `user` / `both` / `en`,与分类安装的默认不同)。
+
+退出码：`0` 成功；`1` 致命错误（前置检查 / 解析 / 拉取失败）；`2` 部分成功——`stderr` 会列出逐类 `[OK]/[FAIL]` 和 `Retry:` 提示。装完后请重启 Claude Code 或 Codex 会话，让新的 `CLAUDE.md` / skills / plugins / hook 插件注册生效。
 
 ### Web UI（可选）
 
@@ -71,15 +75,13 @@ npx auriga-cli
 交互式菜单，按需选择安装：
 
 ```
-? 选择要安装的模块类型：
-  ◉ Workflow — CLAUDE.md + AGENTS.md
-  ◉ Skills — 开发流程 skills
-  ◉ Recommended Skills — 额外的工具 skills
-  ◉ Plugins — Claude Code / Codex 插件
-  ◉ Hooks — Claude Code hooks
+? Select what to install:
+  ◉ Recommended preset — CLAUDE.md/AGENTS.md + workflow skills + auriga-workflow plugin
+  ◯ Optional skills — opt-in utility skills (claude-code-agent, codex-agent...)
+  ◯ Other plugins — everything except auriga-workflow (auriga-notify, skill-creator, codex...)
 ```
 
-每个模块在适用时支持作用域选择（Skills: project/global，Claude Code Plugins: user/project，Hooks: project local / project / user）。安装插件时还会先选择目标运行时：Claude Code、Codex 或两者都装。
+**Recommended preset** 默认勾选,以预设默认值静默安装（scope `user`、agent `both`、语言 `en`）—— 要精调这些参数,改用非交互的 `install --preset` 标志。另两项会下钻到逐项子勾选。安装插件时还会先选择目标运行时：Claude Code、Codex 或两者都装。
 
 ## 模块详情
 
@@ -102,7 +104,7 @@ npx auriga-cli
 | planning-with-files | [OthmanAdi/planning-with-files](https://github.com/OthmanAdi/planning-with-files) | 文件化任务计划与进度跟踪 |
 | playwright-cli | [microsoft/playwright-cli](https://github.com/microsoft/playwright-cli) | 浏览器自动化与测试 |
 
-**Recommended Skills（可选，不在 `--all` 内）：**
+**Recommended Skills（可选工具类 skill —— `--all` 会装,`--preset` 不装）：**
 
 | Skill | 来源 | 说明 |
 |---|---|---|
@@ -133,20 +135,14 @@ npx -y auriga-cli install plugins --agent codex --plugin session-instructions-lo
 | skill-creator | Claude Code | 创建和管理自定义 skills |
 | claude-md-management | Claude Code | 审计和改进 CLAUDE.md |
 | codex | Claude Code | Codex 跨模型协作 |
-| auriga-workflow | Claude Code / Codex | auriga 工作流插件 —— 工作流 skill 加上强制执行工作流的 git 生命周期 hook。Skills：`incremental-impl`、`test-designer`、`spec-design`、`arch-design`、`code-simplify`、`session-compound`、`goalify`（plan 出自驱 goal 并通过 Claude Code 内置 `/goal` 命令分发执行）、`deep-review`（多维度 PR review 编排器——并行派发各维度 reviewer，汇总成可执行的 punch list）、`reviewer-creator`（在 `docs/rules/review/` 下生成项目级自定义 reviewer）、`git-workflow`（git 生命周期 skill）。Hooks：`commit-reminder`（文件编辑的 PostToolUse —— Claude Code 匹配 `Edit` / `Write` / `MultiEdit`，Codex 匹配 `apply_patch` —— 未提交 diff 对比 `HEAD` 超过 200 行或 8 个文件时，提醒在下一个语义边界 commit）、`pr-create-guard`（`gh pr create` 的 PostToolUse —— 注入 PR body 快照供五要素自检，并对不符合 Conventional Commits 的标题提示）、`pr-ready-guard`（`gh pr ready` 与非 draft `gh pr create` 的 PreToolUse —— 拦截游离规划文档、`docs/specs/` 内未结案的活跃 spec、未 push commits）。两个 PostToolUse hook 在 Claude Code / Codex 上完全对齐；Codex 仅对 `pr-ready-guard` 的 PreToolUse `additionalContext` 信息路径 fail-open（block 路径两边一致）。默认通过插件路径安装。 |
+| auriga-workflow | Claude Code / Codex | auriga 工作流插件 —— 工作流 skill 加上强制执行工作流的 git 生命周期 hook。Skills：`incremental-impl`、`test-designer`、`spec-design`、`arch-design`、`code-simplify`、`session-compound`、`goalify`（plan 出自驱 goal 并通过内置 `/goal` 命令分发执行）、`deep-review`（多维度 PR review 编排器——并行派发各维度 reviewer，汇总成可执行的 punch list）、`reviewer-creator`（在 `docs/rules/review/` 下生成项目级自定义 reviewer）、`git-workflow`（git 生命周期 skill）。Hooks：`commit-reminder`（文件编辑的 PostToolUse —— Claude Code 匹配 `Edit` / `Write` / `MultiEdit`，Codex 匹配 `apply_patch` —— 未提交 diff 对比 `HEAD` 超过 200 行或 8 个文件时，提醒在下一个语义边界 commit）、`pr-create-guard`（`gh pr create` 的 PostToolUse —— 注入 PR body 快照供五要素自检，并对不符合 Conventional Commits 的标题提示）、`pr-ready-guard`（`gh pr ready` 与非 draft `gh pr create` 的 PreToolUse —— 拦截游离规划文档、`docs/specs/` 内未结案的活跃 spec、未 push commits）。两个 PostToolUse hook 在 Claude Code / Codex 上完全对齐；Codex 仅对 `pr-ready-guard` 的 PreToolUse `additionalContext` 信息路径 fail-open（block 路径两边一致）。默认通过插件路径安装。 |
 | auriga-notify *(opt-in)* | Claude Code | Claude Code `Notification` 事件的 macOS 原生通知插件。支持焦点感知仅提示音、点击唤起终端、按项目分组通知，并迁移旧 `config.json` / `icon.png`。不随 `install --all` 默认安装，需要显式执行 `install plugins --plugin auriga-notify`。 |
 | session-instructions-loader | Codex | Codex-only SessionStart 插件，注入上层目录的 `AGENTS.md` 和仓库配置的额外 instruction 文件。 |
 
-### Hooks
-
-传统 hook 安装器仍保留作兼容入口，但本仓库当前不再通过
-`install hooks` 暴露自维护 hook。新的自维护 hook 应随插件分发。原来的
-`notify` hook 已迁移为 `auriga-notify` 插件。
-
 ## 环境要求
 
 - Node.js >= 18
-- [Claude Code](https://docs.anthropic.com/en/docs/claude-code)（Claude Code Plugins 和 Hooks 模块需要）
+- [Claude Code](https://docs.anthropic.com/en/docs/claude-code)（Plugins 模块需要）
 - Codex CLI（仅 `install plugins --agent codex|both` 需要）
 - [Homebrew](https://brew.sh)（`auriga-notify` 插件使用 `alerter` 时推荐安装）
 

package/dist/api-types.d.ts

@@ -5,7 +5,7 @@ export type ItemStatus = "installed" | "not-installed"
  *  agents are enumerated in `PluginState.missingAgents`. */
  | "partial-install";
 /**
- * Per-category scan scope. Each category (workflow / skills / plugins / hooks)
+ * Per-category scan scope. Each category (workflow / skills / plugins)
  * can be independently scanned in either user scope (~/.claude/, ~/.codex/)
  * or project scope (<proj>/.claude/). The Web UI's per-column scope picker
  * carries these through the `/api/state` query so the scanner reads the
@@ -23,7 +23,6 @@ export interface StateReport {
     skills: SkillState[];
     recommendedSkills: SkillState[];
     plugins: PluginState[];
-    hooks: HookState[];
     warnings: StateWarning[];
 }
 export interface WorkflowState {
@@ -70,13 +69,6 @@ export interface PluginState {
      *  `claude plugins update`, not via auriga-cli. */
     external?: boolean;
 }
-export interface HookState {
-    name: string;
-    description: string;
-    status: ItemStatus;
-    /** Scope the scanner read to produce this row. See WorkflowState comment. */
-    observedScope?: ScanScope;
-}
 export interface StateWarning {
     code: "claude-cli-missing" | "codex-cli-missing" | "marketplace-offline" | "claude-code-not-installed" | "settings-unreadable" | "skill-malformed"
     /** Project-scope CLAUDE.md (or the user-scope fallback when scanning
@@ -86,7 +78,11 @@ export interface StateWarning {
      | "workflow-foreign-claudemd";
     message: string;
 }
-export type ApplyCategory = "workflow" | "skill" | "recommended-skill" | "plugin" | "hook";
+export type ApplyCategory = "workflow" | "skill" | "recommended-skill" | "plugin"
+/** The curated preset (workflow doc + workflow skills + auriga-workflow
+ *  plugin). A single apply item drives the whole installPreset
+ *  orchestration; `name` is the sentinel "preset". */
+ | "preset";
 export type ApplyAction = "install" | "uninstall";
 /**
  * Installer scope. Carried per-item so the Web UI can mix scopes within a
@@ -94,7 +90,6 @@ export type ApplyAction = "install" | "uninstall";
  *
  * - workflow: no scope; field MUST be omitted.
  * - skill / recommended-skill / plugin: "project" | "user". Default project.
- * - hook: "project" | "user" for v0.1 (project-local deferred to v0.2).
  */
 export type ApplyScope = "project" | "user";
 /**
@@ -107,18 +102,31 @@ export type ApplyScope = "project" | "user";
  * categories so the API surface stays explicit.
  */
 export type ApplyLang = "en" | "zh-CN";
+/**
+ * Preset install runtime target — Claude Code, Codex, or both.
+ *
+ * Only meaningful for `category === "preset"` (the preset's UI exposes an
+ * agent control); the server rejects it for every other category, where
+ * the per-plugin agent is derived from the catalog rather than supplied
+ * by the client.
+ */
+export type ApplyPresetAgent = "claude" | "codex" | "both";
 export interface ApplyItemRef {
     category: ApplyCategory;
     name: string;
     action: ApplyAction;
-    /** Installer scope. Omitted = "project" (back-compat default). The server
-     *  rejects this field for category="workflow" because workflow has no
-     *  scope concept (it's a single file at the project root). */
+    /** Installer scope. Omitted = "project" (back-compat default), except
+     *  for category="preset" where the handler defaults it to "user". The
+     *  server rejects this field for category="workflow" because workflow
+     *  has no scope concept (it's a single file at the project root). */
     scope?: ApplyScope;
     /** Workflow CLAUDE.md language variant. Omitted = "en" (back-compat
-     *  default). The server rejects this field for any non-workflow
-     *  category. */
+     *  default). The server accepts this field only for category="workflow"
+     *  and category="preset" (the preset installs the workflow doc). */
     lang?: ApplyLang;
+    /** Preset install runtime. Omitted = "both". The server accepts this
+     *  field only for category="preset". */
+    agent?: ApplyPresetAgent;
 }
 export interface ApplyRequest {
     items: ApplyItemRef[];

package/dist/apply-handlers.js

@@ -1,6 +1,6 @@
 // Builds the default ApplyHandlers map that wires the Web UI's /api/apply
-// route to the real installers in workflow.ts / skills.ts / plugins.ts /
-// hooks.ts. Tests inject their own mock handlers; CLI mode (the `web-ui`
+// route to the real installers in workflow.ts / skills.ts / plugins.ts.
+// Tests inject their own mock handlers; CLI mode (the `web-ui`
 // subcommand) calls `buildDefaultApplyHandlers` at boot.
 //
 // Per-item dispatch is layered on top of the existing bulk installers via
@@ -14,16 +14,14 @@
 //   recommended-skill:  uninstallSkill(name, …)          │  same store
 //   plugin:             installPlugins(…, agent, sel:[]) │  per-name
 //   plugin:             uninstallPlugin(name, agent, …)  │
-//   hook:               installHook(hookDef, "project",…)│  needs HookDef
-//   hook:               uninstallHook(name, …)           │
 //
 // v1.19.0 dropped the "update" action — every installer is idempotent and
 // overwriting, so re-running install IS the update path. Apply receives
 // "install" or "uninstall" only.
 //
 // Spec: docs/architecture/web-ui.md §6.4 (apply execution model).
-import { installHook, loadHooksConfig, uninstallHook } from "./hooks.js";
 import { installPlugins, uninstallPlugin, } from "./plugins.js";
+import { installPreset } from "./preset.js";
 import { installRecommendedSkills, installSkills, uninstallSkill, } from "./skills.js";
 import { installWorkflow, uninstallWorkflow } from "./workflow.js";
 const ALL_ACTIONS = new Set([
@@ -154,35 +152,40 @@ export function buildDefaultApplyHandlers(ctx) {
             throw new Error(`plugin ${name} ${action} failed for ${failures.length} agent(s) — ${summary}`);
         }
     };
-    const hook = async (action, name, { onLog, scope }) => {
+    // The preset is a single apply item that drives the whole installPreset
+    // orchestration. scope / agent / lang come from the Dashboard's preset
+    // controls; omitted values fall back to the preset defaults
+    // (user / both / en). Uninstall is not a preset operation.
+    const preset = async (action, _name, { onLog, scope, lang: requestedLang, agent }) => {
         assertAction(action);
-        const installScope = scope ?? "project";
-        if (action === "uninstall") {
-            await uninstallHook(name, {
-                cwd,
-                scope: installScope,
-                onLog: (line) => onLog(line, "info"),
-            });
-            return;
+        if (action !== "install") {
+            throw new Error("preset only supports the install action");
+        }
+        const results = await installPreset(packageRoot, {
+            interactive: false,
+            cwd,
+            scope: scope ?? "user",
+            agent: agent ?? "both",
+            lang: requestedLang ?? lang,
+            onLog: streamLog(onLog),
+        });
+        for (const r of results) {
+            onLog(r.ok
+                ? `preset: ${r.category} installed`
+                : `preset: ${r.category} failed — ${r.err}`, r.ok ? "info" : "error");
         }
-        // Look up the HookDef in the bundled registry; unknown name → loud throw
-        // so the SSE caller surfaces it as item:done success=false. The hook
-        // installer is idempotent; re-running install is the update path.
-        const config = loadHooksConfig(packageRoot);
-        const hookDef = config.hooks.find((h) => h.name === name);
-        if (!hookDef) {
-            throw new Error(`hook not found in registry: ${name}`);
+        const failed = results.filter((r) => !r.ok);
+        if (failed.length > 0) {
+            throw new Error(`preset install failed for ${failed.length} step(s): ${failed
+                .map((f) => f.category)
+                .join(", ")}`);
         }
-        // installHook takes a wider Scope union ("project"|"user"|"project-local");
-        // v0.1 only exposes "project"|"user" via the API. Cast is safe.
-        await installHook(hookDef, scope ?? "project", cwd, packageRoot);
-        onLog(`hook ${name} installed (${scope ?? "project"})`, "info");
     };
     return {
         workflow,
         skill,
         "recommended-skill": recommendedSkill,
         plugin,
-        hook,
+        preset,
     };
 }

package/dist/catalog.d.ts

@@ -6,7 +6,7 @@ export interface CatalogEntry {
      *  config files are NOT shipped in the npm tarball, so the scanner can't
      *  read them at runtime. Baking here lets `/api/state` correctly classify
      *  dual-Agent plugins as `["claude","codex"]` for installed users. Absent
-     *  on skill / hook entries. */
+     *  on skill entries. */
     agents?: ("claude" | "codex")[];
     /** True for plugins whose source lives in an UPSTREAM marketplace
      *  (skill-creator / claude-md-management / codex), not in this repo.
@@ -19,6 +19,5 @@ export interface Catalog {
     workflowSkills: CatalogEntry[];
     recommendedSkills: CatalogEntry[];
     plugins: CatalogEntry[];
-    hooks: CatalogEntry[];
 }
 export declare function loadCatalog(packageRoot: string): Catalog;

package/dist/catalog.json

@@ -1,5 +1,5 @@
 {
-  "generatedAt": "2026-05-15T17:31:57.831Z",
+  "generatedAt": "2026-05-16T02:00:33.470Z",
   "workflowSkills": [
     {
       "name": "planning-with-files",
@@ -99,6 +99,5 @@
         "codex"
       ]
     }
-  ],
-  "hooks": []
+  ]
 }

package/dist/cli.d.ts

@@ -4,6 +4,10 @@ import { type CategoryName } from "./types.js";
 export type { CategoryName } from "./types.js";
 export interface InstallParsed {
     all: boolean;
+    /** `--preset` — atomic install of the curated default set (workflow
+     *  doc + workflow skills + auriga-workflow plugin). Mutually exclusive
+     *  with `all` / `type` / `filter`. */
+    preset?: boolean;
     type?: CategoryName;
     filter?: string[];
     lang?: string;
@@ -37,3 +41,19 @@ export type ParsedArgs = {
 };
 export declare function parseArgs(argv: string[]): ParsedArgs;
 export declare function main(argv: string[]): Promise<number>;
+type LegacyMenuValue = "preset" | "recommended" | "plugins";
+/**
+ * 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 declare const LEGACY_MENU_CHOICES: ReadonlyArray<{
+    value: LegacyMenuValue;
+    name: string;
+    checked: boolean;
+}>;