@event4u/agent-config 4.3.0 → 4.5.0

package/dist/install/toolDetection.js

@@ -0,0 +1,104 @@
+/**
+ * Native AI-tool presence detection (road-to-wizard-ux-improvements § Phase 2).
+ *
+ * Distinct from `detectToolPresence` (detect.ts), which checks the *project*
+ * for agent-config bridge dirs ("we set up a bridge here"). This module
+ * answers "is the AI tool itself installed on this machine?" by probing the
+ * user's home dir, well-known app bundles, and `$PATH` — so the wizard's
+ * Step-1 list can pre-select detected tools (first run) and show a per-tool
+ * installed/not-installed badge.
+ *
+ * The signal table is intentionally data-driven and best-effort: a tool with
+ * no reliable signal (e.g. a VS Code extension) simply reports `false`
+ * (badge = not installed, no pre-select) — false negatives are acceptable,
+ * false positives are not. Extend `TOOL_SIGNALS` as new tools/signals are
+ * learned; that is the single place to maintain (the accepted trade-off).
+ */
+import { existsSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { delimiter, join } from 'node:path';
+/**
+ * Best-effort signal table keyed by the tool id used in the wizard's
+ * `VALID_TOOLS` (src/ui/wizard/state.ts). Keep ids in sync with that list.
+ */
+const TOOL_SIGNALS = {
+    'claude-code': { bins: ['claude'], homePaths: ['.claude', '.claude.json', '.config/claude'] },
+    'claude-desktop': { absPaths: ['/Applications/Claude.app'], homePaths: ['Library/Application Support/Claude', '.config/Claude'] },
+    'cursor': { bins: ['cursor'], absPaths: ['/Applications/Cursor.app'], homePaths: ['.cursor'] },
+    'windsurf': { bins: ['windsurf'], absPaths: ['/Applications/Windsurf.app'], homePaths: ['.codeium/windsurf'] },
+    'cline': { homePaths: ['Documents/Cline'] },
+    'gemini-cli': { bins: ['gemini'], homePaths: ['.gemini'] },
+    'copilot': { bins: ['copilot'], homePaths: ['.config/github-copilot'] },
+    'augment': { bins: ['auggie', 'augment'], homePaths: ['.augment'] },
+    'aider': { bins: ['aider'], homePaths: ['.aider.conf.yml'] },
+    'codex': { bins: ['codex'], homePaths: ['.codex'] },
+    'roocode': {},
+    'continue': { homePaths: ['.continue'] },
+    'kilocode': {},
+    'zed': { bins: ['zed'], absPaths: ['/Applications/Zed.app'], homePaths: ['.config/zed'] },
+    'jetbrains': { homePaths: ['Library/Application Support/JetBrains', '.config/JetBrains'] },
+    'kiro': { bins: ['kiro'], absPaths: ['/Applications/Kiro.app'], homePaths: ['.kiro'] },
+    'qoder': { absPaths: ['/Applications/Qoder.app'], homePaths: ['.qoder'] },
+    'opencode': { bins: ['opencode'], homePaths: ['.opencode', '.config/opencode'] },
+    'trae': { absPaths: ['/Applications/Trae.app'], homePaths: ['.trae'] },
+    'antigravity': { absPaths: ['/Applications/Antigravity.app'], homePaths: ['.antigravity'] },
+    'codebuddy': { homePaths: ['.codebuddy'] },
+    'droid': { bins: ['droid'], homePaths: ['.factory', '.droid'] },
+    'warp': { absPaths: ['/Applications/Warp.app', '/Applications/Warp.app/Contents'], homePaths: ['.warp', '.local/share/warp-terminal'] },
+};
+/** Tool ids this module knows how to probe (the wizard's full tool set). */
+export function knownToolIds() {
+    return Object.keys(TOOL_SIGNALS);
+}
+/**
+ * Is an executable named `name` resolvable on `$PATH`? Exported for one-off
+ * presence checks (e.g. `rtk` on the Editor-and-tooling step). Defaults to
+ * `process.env.PATH`.
+ */
+export function isBinaryOnPath(name, pathEnv) {
+    return binOnPath(name, pathEnv ?? process.env['PATH'] ?? '');
+}
+function binOnPath(name, pathEnv) {
+    if (pathEnv.length === 0)
+        return false;
+    for (const dir of pathEnv.split(delimiter)) {
+        if (dir.length === 0)
+            continue;
+        if (existsSync(join(dir, name)))
+            return true;
+        // Windows-style executables.
+        if (existsSync(join(dir, `${name}.exe`)) || existsSync(join(dir, `${name}.cmd`)))
+            return true;
+    }
+    return false;
+}
+function isToolInstalled(signal, home, pathEnv) {
+    for (const rel of signal.homePaths ?? []) {
+        if (existsSync(join(home, rel)))
+            return true;
+    }
+    for (const abs of signal.absPaths ?? []) {
+        if (existsSync(abs))
+            return true;
+    }
+    for (const bin of signal.bins ?? []) {
+        if (binOnPath(bin, pathEnv))
+            return true;
+    }
+    return false;
+}
+/**
+ * Probe every known tool and return a `{ <toolId>: installed }` map. Tools
+ * with no reliable signal report `false`. Pure w.r.t. injected `home`/`pathEnv`
+ * (only reads the filesystem), so it's safe to call per wizard boot.
+ */
+export function detectInstalledTools(opts = {}) {
+    const home = opts.home ?? homedir();
+    const pathEnv = opts.pathEnv ?? process.env['PATH'] ?? '';
+    const out = {};
+    for (const [id, signal] of Object.entries(TOOL_SIGNALS)) {
+        out[id] = isToolInstalled(signal, home, pathEnv);
+    }
+    return out;
+}
+//# sourceMappingURL=toolDetection.js.map

package/dist/install/toolDetection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolDetection.js","sourceRoot":"","sources":["../../src/install/toolDetection.ts"],"names":[],"mappings":"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"}

package/dist/mcp/registry-manifest.json

@@ -1,7 +1,7 @@
 {
   "discovery": {
     "artefact_count": 432,
-    "scanner_version": "b59a6d49e745"
+    "scanner_version": "d75eba636abb"
   },
   "generated_at": "2026-05-27",
   "package": {
@@ -9,7 +9,7 @@
     "homepage": "https://github.com/event4u-app/agent-config#readme",
     "name": "@event4u/agent-config",
     "repository": "https://github.com/event4u-app/agent-config",
-    "version": "4.3.0"
+    "version": "4.5.0"
   },
   "registries": [
     {

package/dist/server/app.js

@@ -80,6 +80,42 @@ export async function createApp(opts) {
         }
         return undefined;
     });
+    // Browser-lifecycle watchdog (real-serve only — see CreateAppOptions).
+    if (opts.idleShutdown !== undefined) {
+        const { onIdle } = opts.idleShutdown;
+        const timeoutMs = opts.idleShutdown.timeoutMs ?? 1_800_000;
+        const intervalMs = opts.idleShutdown.intervalMs ?? 30_000;
+        let lastActivity = 0; // 0 = disarmed: no client has connected yet.
+        let fired = false;
+        const timer = setInterval(() => {
+            if (lastActivity === 0)
+                return; // not yet armed
+            if (Date.now() - lastActivity > timeoutMs)
+                fire();
+        }, intervalMs);
+        function fire() {
+            if (fired)
+                return;
+            fired = true;
+            clearInterval(timer);
+            void onIdle();
+        }
+        // Never let the watchdog alone keep the process alive.
+        if (typeof timer.unref === 'function')
+            timer.unref();
+        app.addHook('onClose', async () => { clearInterval(timer); });
+        // Any authed /api/* request marks the client alive and arms the
+        // backstop. The dedicated shutdown beacon fires immediately.
+        app.addHook('onRequest', async (request) => {
+            if (request.url.startsWith('/api/'))
+                lastActivity = Date.now();
+            return undefined;
+        });
+        app.post('/api/v1/shutdown', async () => {
+            fire();
+            return { ok: true };
+        });
+    }
     await app.register(fastifyStatic, {
         root: opts.uiDistDir,
         prefix: '/',

package/dist/server/app.js.map

@@ -1 +1 @@
-{"version":3,"file":"app.js","sourceRoot":"","sources":["../../src/server/app.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"app.js","sourceRoot":"","sources":["../../src/server/app.ts"],"names":[],"mappings":"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"}

package/dist/server/routes/ping.js

@@ -8,7 +8,17 @@
  */
 import { z } from 'zod';
 import { readFileSync } from 'node:fs';
+import { userInfo } from 'node:os';
 import { PACKAGE_JSON } from '../../cli/paths.js';
+function systemUserName() {
+    try {
+        const name = userInfo().username;
+        return typeof name === 'string' ? name : '';
+    }
+    catch {
+        return '';
+    }
+}
 export const PingResponseSchema = z.object({
     ok: z.literal(true),
     version: z.string().min(1),
@@ -27,6 +37,12 @@ export const PingResponseSchema = z.object({
      * operator pinned `writeRoot` via `--project`.
      */
     projectScopeAvailable: z.boolean(),
+    /**
+     * Best-effort OS account name (e.g. `matze`), used to pre-fill the
+     * welcome step's name field on a fresh wizard. Empty string when the
+     * platform does not expose it.
+     */
+    systemUser: z.string(),
 });
 function readPackageVersion() {
     try {
@@ -48,6 +64,7 @@ export function pingRoute(opts) {
                 mode: opts.mode,
                 dryRun: opts.dryRun === true,
                 projectScopeAvailable: opts.projectScopeRoot !== undefined && opts.projectScopeRoot !== null,
+                systemUser: systemUserName(),
             };
             return response;
         });

package/dist/server/routes/ping.js.map

@@ -1 +1 @@
-{"version":3,"file":"ping.js","sourceRoot":"","sources":["../../../src/server/routes/ping.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;IACnB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1B;;;OAGG;IACH,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5B,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,iBAAiB,EAAE,QAAQ,CAAC,CAAC;IAC3C,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE;IACnB;;;;;OAKG;IACH,qBAAqB,EAAE,CAAC,CAAC,OAAO,EAAE;CACrC,CAAC,CAAC;AAIH,SAAS,kBAAkB;IACvB,IAAI,CAAC;QACD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,YAAY,EAAE,MAAM,CAAC,CAA0B,CAAC;QACpF,OAAO,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;IACnE,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,OAAO,CAAC;IACnB,CAAC;AACL,CAAC;AAcD,MAAM,UAAU,SAAS,CAAC,IAAsB;IAC5C,MAAM,MAAM,GAAuB,KAAK,EAAE,GAAoB,EAAE,EAAE;QAC9D,GAAG,CAAC,GAAG,CAAC,cAAc,EAAE,KAAK,IAAI,EAAE;YAC/B,MAAM,QAAQ,GAAiB;gBAC3B,EAAE,EAAE,IAAI;gBACR,OAAO,EAAE,kBAAkB,EAAE;gBAC7B,WAAW,EAAE,IAAI,CAAC,SAAS;gBAC3B,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,MAAM,EAAE,IAAI,CAAC,MAAM,KAAK,IAAI;gBAC5B,qBAAqB,EAAE,IAAI,CAAC,gBAAgB,KAAK,SAAS,IAAI,IAAI,CAAC,gBAAgB,KAAK,IAAI;aAC/F,CAAC;YACF,OAAO,QAAQ,CAAC;QACpB,CAAC,CAAC,CAAC;IACP,CAAC,CAAC;IACF,OAAO,MAAM,CAAC;AAClB,CAAC"}
+{"version":3,"file":"ping.js","sourceRoot":"","sources":["../../../src/server/routes/ping.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,SAAS,cAAc;IACnB,IAAI,CAAC;QACD,MAAM,IAAI,GAAG,QAAQ,EAAE,CAAC,QAAQ,CAAC;QACjC,OAAO,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IAChD,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,EAAE,CAAC;IACd,CAAC;AACL,CAAC;AAED,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;IACnB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1B;;;OAGG;IACH,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5B,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,iBAAiB,EAAE,QAAQ,CAAC,CAAC;IAC3C,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE;IACnB;;;;;OAKG;IACH,qBAAqB,EAAE,CAAC,CAAC,OAAO,EAAE;IAClC;;;;OAIG;IACH,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;CACzB,CAAC,CAAC;AAIH,SAAS,kBAAkB;IACvB,IAAI,CAAC;QACD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,YAAY,EAAE,MAAM,CAAC,CAA0B,CAAC;QACpF,OAAO,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;IACnE,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,OAAO,CAAC;IACnB,CAAC;AACL,CAAC;AAcD,MAAM,UAAU,SAAS,CAAC,IAAsB;IAC5C,MAAM,MAAM,GAAuB,KAAK,EAAE,GAAoB,EAAE,EAAE;QAC9D,GAAG,CAAC,GAAG,CAAC,cAAc,EAAE,KAAK,IAAI,EAAE;YAC/B,MAAM,QAAQ,GAAiB;gBAC3B,EAAE,EAAE,IAAI;gBACR,OAAO,EAAE,kBAAkB,EAAE;gBAC7B,WAAW,EAAE,IAAI,CAAC,SAAS;gBAC3B,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,MAAM,EAAE,IAAI,CAAC,MAAM,KAAK,IAAI;gBAC5B,qBAAqB,EAAE,IAAI,CAAC,gBAAgB,KAAK,SAAS,IAAI,IAAI,CAAC,gBAAgB,KAAK,IAAI;gBAC5F,UAAU,EAAE,cAAc,EAAE;aAC/B,CAAC;YACF,OAAO,QAAQ,CAAC;QACpB,CAAC,CAAC,CAAC;IACP,CAAC,CAAC;IACF,OAAO,MAAM,CAAC;AAClB,CAAC"}

package/dist/server/routes/wizard.js

@@ -1,5 +1,5 @@
 import { promises as fs, existsSync } from 'node:fs';
-import { tmpdir } from 'node:os';
+import { tmpdir, homedir } from 'node:os';
 import { join, dirname } from 'node:path';
 import { spawn } from 'node:child_process';
 import { randomBytes } from 'node:crypto';
@@ -7,21 +7,35 @@ import { z } from 'zod';
 import { settingsSchema } from '../schemas/settings.js';
 import { userIdentitySchema } from '../../shared/userMd/schema.js';
 import { composeUserIdentity } from '../../shared/userMd/utils.js';
-import { mergeIntoTemplate } from '../io/yamlIO.js';
+import { mergeIntoTemplate, parseYaml, replaceScalar } from '../io/yamlIO.js';
 import { commitMulti } from '../io/atomicMultiWrite.js';
 import { writeAtomic } from '../io/atomicWrite.js';
+import { detectInstalledTools, isBinaryOnPath, knownToolIds } from '../../install/toolDetection.js';
+import { readSelectedTools, writeSelectedTools } from '../../install/selectedTools.js';
 const STATE_REL = join('state', 'wizard-state.json');
 const SETTINGS_REL = join('settings', '.agent-settings.yml');
 const USER_IDENTITY_REL = join('settings', '.agent-user.yml');
+// road-to-wizard-ux-improvements § Phase 8 — AI Council config file. Lives
+// beside the other settings under <writeRoot>/settings/; seeded from the
+// package's hand-tuned reference when the target is absent (first run).
+const AI_COUNCIL_REL = join('settings', '.ai-council.yml');
+const PACKAGE_AI_COUNCIL_REL = join('agents', 'settings', '.ai-council.yml');
+const AI_COUNCIL_PROVIDERS = ['anthropic', 'openai', 'gemini', 'xai', 'perplexity'];
+// Only these two ship an interactive 0600-key installer; the rest use env vars.
+const AI_COUNCIL_KEY_INSTALL = {
+    anthropic: 'bash scripts/install_anthropic_key.sh',
+    openai: 'bash scripts/install_openai_key.sh',
+};
 /** Legacy flat-root files — read for migration, deleted on successful finish. */
 const LEGACY_USER_MD_REL = '.agent-user.md';
 const LEGACY_SETTINGS_REL = '.agent-settings.yml';
-// Step count mirrors the UI's `WIZARD_STEPS` array in `src/ui/wizard/steps.ts`
-// and the chat-side `~/.claude/skills/onboard/SKILL.md`. Bump in lockstep.
-// Extended mode (road-to-global-only-install § Phase 1) prepends three
-// steps (ai-tools + packs + modules) to ship the unified 10-step flow.
-const DEFAULT_TOTAL_STEPS = 7;
-const EXTENDED_TOTAL_STEPS = 10;
+// Step count mirrors the UI's `WIZARD_STEPS` array in `src/ui/wizard/steps.ts`.
+// Bump in lockstep. Core flow = 8 steps (editor, personality, cost,
+// roadmap-quality, memory, ai-council, user-md, review —
+// road-to-wizard-ux-improvements § Phase 8 added ai-council). Extended mode
+// prepends three install-only steps (ai-tools + packs + modules) → 11.
+const DEFAULT_TOTAL_STEPS = 9;
+const EXTENDED_TOTAL_STEPS = 13;
 /**
  * Discovery-manifest path. Resolved from the package root the server
  * was booted with — same artefact the installer reads (ADR-015 locks
@@ -60,18 +74,6 @@ const applyPayloadSchema = z.discriminatedUnion('schema_version', [
 function statePath(root) {
     return join(root, STATE_REL);
 }
-async function readState(root) {
-    try {
-        const raw = await fs.readFile(statePath(root), 'utf8');
-        const parsed = wizardStateSchema.safeParse(JSON.parse(raw));
-        return parsed.success ? parsed.data : null;
-    }
-    catch (err) {
-        if (err.code === 'ENOENT')
-            return null;
-        return null;
-    }
-}
 async function writeState(root, state) {
     const path = statePath(root);
     await fs.mkdir(dirname(path), { recursive: true });
@@ -80,6 +82,70 @@ async function writeState(root, state) {
 async function readTemplate(packageRoot) {
     return fs.readFile(join(packageRoot, 'config', 'agent-settings.template.yml'), 'utf8');
 }
+/**
+ * Read the AI-council YAML body for editing (road-to-wizard-ux-improvements
+ * § Phase 8): prefer the target under `<writeRoot>/settings/.ai-council.yml`;
+ * fall back to the package's hand-tuned reference so a first-run consumer edits
+ * a fully-commented file rather than a synthesised stub.
+ */
+async function readCouncilBody(writeRoot, packageRoot) {
+    try {
+        return await fs.readFile(join(writeRoot, AI_COUNCIL_REL), 'utf8');
+    }
+    catch (err) {
+        if (err.code !== 'ENOENT')
+            throw err;
+    }
+    return fs.readFile(join(packageRoot, PACKAGE_AI_COUNCIL_REL), 'utf8');
+}
+/** Which provider key files exist on disk (`~/.event4u/agent-config/<p>.key`). */
+function councilKeyPresence() {
+    const roots = [
+        join(homedir(), '.event4u', 'agent-config'),
+        join(homedir(), '.config', 'agent-config'),
+    ];
+    const out = {};
+    for (const p of AI_COUNCIL_PROVIDERS) {
+        out[p] = roots.some((r) => existsSync(join(r, `${p}.key`)));
+    }
+    return out;
+}
+/** Pull the wizard-controlled scalar subset out of a parsed council config. */
+function extractCouncilConfig(body) {
+    const doc = parseYaml(body);
+    const obj = (v) => (typeof v === 'object' && v !== null ? v : {});
+    const defaults = obj(doc['defaults']);
+    const costBudget = obj(doc['cost_budget']);
+    const membersRaw = obj(doc['members']);
+    const dr = obj(doc['decision_resolution']);
+    const classes = obj(dr['classes']);
+    const members = {};
+    for (const p of AI_COUNCIL_PROVIDERS) {
+        const m = obj(membersRaw[p]);
+        members[p] = {
+            enabled: m['enabled'] === true,
+            participate_low_impact: m['participate_low_impact'] === true,
+        };
+    }
+    const decision = {};
+    for (const cls of ['trivial', 'low_impact', 'medium_impact']) {
+        const c = obj(classes[cls]);
+        if (typeof c['mode'] === 'string')
+            decision[cls] = c['mode'];
+    }
+    return {
+        enabled: doc['enabled'] === true,
+        defaults: {
+            mode: typeof defaults['mode'] === 'string' ? defaults['mode'] : 'api',
+            min_rounds: typeof defaults['min_rounds'] === 'number' ? defaults['min_rounds'] : 2,
+        },
+        cost_budget: {
+            max_total_usd: typeof costBudget['max_total_usd'] === 'number' ? costBudget['max_total_usd'] : 0,
+        },
+        members,
+        decision,
+    };
+}
 function detectProjectSignals(root) {
     const out = [];
     const exists = (rel) => existsSync(join(root, rel));
@@ -271,6 +337,22 @@ const modulesConfigSchema = z.object({
     agent_folder: z.string().optional(),
     skip_dirs: z.array(z.string()).optional(),
 }).strict();
+// road-to-wizard-ux-improvements § Phase 8 — wizard-controlled scalar subset of
+// `.ai-council.yml`. Scalar leaves only (safe for `replaceScalar`); the LOCKED
+// decision classes (high_impact / user_required) and deep knobs (advisors,
+// model_ladder, …) are intentionally NOT writable here — hand-edit only.
+const aiCouncilPayloadSchema = z.object({
+    enabled: z.boolean().optional(),
+    defaultMode: z.enum(['manual', 'api', 'cli']).optional(),
+    minRounds: z.number().int().min(1).optional(),
+    maxTotalUsd: z.number().min(0).optional(),
+    members: z.record(z.object({
+        enabled: z.boolean().optional(),
+        participateLowImpact: z.boolean().optional(),
+    })).optional(),
+    // keys ∈ {trivial, low_impact, medium_impact} — others ignored.
+    decision: z.record(z.enum(['agent', 'council', 'user'])).optional(),
+}).strict();
 export function wizardRoute(opts) {
     const extended = opts.extendedSteps === true;
     const totalSteps = opts.totalSteps ?? (extended ? EXTENDED_TOTAL_STEPS : DEFAULT_TOTAL_STEPS);
@@ -282,16 +364,19 @@ export function wizardRoute(opts) {
     const dryRun = opts.dryRun === true;
     const legacyReadRoot = opts.legacyReadRoot ?? null;
     const projectScopeRoot = opts.projectScopeRoot ?? null;
-    // Per-process in-memory state for dry-run. One CLI invocation = one
-    // server = one Map; cross-session leakage is impossible because each
-    // `agent-config setup --dry-run` mints a fresh server. See § Dry-run
-    // state contract in the roadmap.
+    // Per-server-session in-memory wizard state (road-to-wizard-ux-improvements
+    // § Phase 1 — "server-boot = fresh"). Each `init`/`setup`/`--dry-run`
+    // launch mints a fresh server, so a brand-new launch ALWAYS starts at
+    // `initialStep`. Resume happens only within the same running server
+    // lifetime (e.g. a browser refresh while the server is up), driven by this
+    // in-memory state — never from the on-disk `wizard-state.json`, which is a
+    // crash breadcrumb, not a cross-launch resume source.
     let memState = null;
     const plugin = async (app) => {
         app.get('/api/v1/wizard/state', async () => {
-            // Dry-run: in-memory write wins; fall back to disk so an
-            // in-progress real run can be previewed.
-            const existing = dryRun ? (memState ?? await readState(opts.writeRoot)) : await readState(opts.writeRoot);
+            // Resume from the in-memory session only — a fresh server boot has
+            // no session state and therefore starts fresh at `initialStep`.
+            const existing = memState;
             if (existing === null) {
                 return {
                     step: initialStep,
@@ -322,6 +407,124 @@ export function wizardRoute(opts) {
             const signals = detectProjectSignals(root);
             return { root, signals };
         });
+        // road-to-wizard-ux-improvements § Phase 2 — AI-tool presence on the
+        // machine running the wizard. Probes the user's home dir + app bundles
+        // + $PATH (NOT the project) so Step 1 can pre-select installed tools on
+        // first run and badge each tool. Read-only; extended-mode only.
+        app.get('/api/v1/wizard/detect-tools', async (_request, reply) => {
+            if (!extended) {
+                await reply.code(404).send({ error: { code: 'NOT_FOUND', message: 'extended-mode endpoint disabled' } });
+                return reply;
+            }
+            // `configured` = the tools the user selected in a prior wizard run
+            // (wizard-tools.json), NOT every deployed tool. Step 1 pre-selects
+            // these on a repeat run; only when none are recorded does it fall
+            // back to pre-selecting every installed tool (first-run convenience).
+            return {
+                tools: detectInstalledTools(),
+                configured: readSelectedTools(new Set(knownToolIds())),
+            };
+        });
+        // road-to-wizard-ux-improvements § Phase 7 — rtk presence on the
+        // Editor-and-tooling step. Detection is the ONLY source of truth (the
+        // value is never loaded from `.agent-settings.yml`). When rtk is
+        // missing, return the suggested per-OS install command + repo so the
+        // UI can offer a copy-and-run button (we surface the command rather
+        // than shelling out an unverified package install — non-destructive
+        // by default). Read-only; extended-mode only.
+        app.get('/api/v1/wizard/detect-rtk', async (_request, reply) => {
+            if (!extended) {
+                await reply.code(404).send({ error: { code: 'NOT_FOUND', message: 'extended-mode endpoint disabled' } });
+                return reply;
+            }
+            const installed = isBinaryOnPath('rtk');
+            // Per-OS install hint (maintainer-tunable). `cargo install --git`
+            // is the portable fallback for the Rust tool when no packaged
+            // formula is known.
+            const repo = 'https://github.com/event4u-app/rtk';
+            const installCommandByOs = {
+                darwin: 'brew install rtk',
+                linux: `cargo install --git ${repo}`,
+                win32: `cargo install --git ${repo}`,
+            };
+            return {
+                installed,
+                platform: process.platform,
+                repo,
+                installCommand: installed ? null : (installCommandByOs[process.platform] ?? `cargo install --git ${repo}`),
+            };
+        });
+        // road-to-wizard-ux-improvements § Phase 8 — AI Council config.
+        // GET returns the wizard-controlled scalar subset (read from the write
+        // root, or seeded from the package's hand-tuned reference), plus which
+        // provider keys exist + the install-command affordance. Extended only.
+        app.get('/api/v1/wizard/ai-council', async (_request, reply) => {
+            if (!extended) {
+                await reply.code(404).send({ error: { code: 'NOT_FOUND', message: 'extended-mode endpoint disabled' } });
+                return reply;
+            }
+            try {
+                const body = await readCouncilBody(opts.writeRoot, opts.packageRoot);
+                return {
+                    config: extractCouncilConfig(body),
+                    providers: AI_COUNCIL_PROVIDERS,
+                    keyPresence: councilKeyPresence(),
+                    keyInstall: AI_COUNCIL_KEY_INSTALL,
+                };
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : 'failed to read .ai-council.yml';
+                await reply.code(500).send({ error: { code: 'COUNCIL_READ_FAILED', message } });
+                return reply;
+            }
+        });
+        // POST applies the scalar subset into `.ai-council.yml` via
+        // comment-preserving `replaceScalar` edits (never a full dump), then
+        // atomic-writes <writeRoot>/settings/.ai-council.yml.
+        app.post('/api/v1/wizard/ai-council', async (request, reply) => {
+            if (!extended) {
+                await reply.code(404).send({ error: { code: 'NOT_FOUND', message: 'extended-mode endpoint disabled' } });
+                return reply;
+            }
+            const parsed = aiCouncilPayloadSchema.safeParse(request.body ?? {});
+            if (!parsed.success) {
+                await reply.code(422).send({
+                    error: { code: 'VALIDATION', message: 'invalid ai-council payload', fields: zodIssuesToFields(parsed.error.issues) },
+                });
+                return reply;
+            }
+            const p = parsed.data;
+            try {
+                let body = await readCouncilBody(opts.writeRoot, opts.packageRoot);
+                const set = (path, value) => {
+                    if (value !== undefined)
+                        body = replaceScalar(body, path, value);
+                };
+                set(['enabled'], p.enabled);
+                set(['defaults', 'mode'], p.defaultMode);
+                set(['defaults', 'min_rounds'], p.minRounds);
+                set(['cost_budget', 'max_total_usd'], p.maxTotalUsd);
+                for (const provider of AI_COUNCIL_PROVIDERS) {
+                    const m = p.members?.[provider];
+                    if (m === undefined)
+                        continue;
+                    set(['members', provider, 'enabled'], m.enabled);
+                    set(['members', provider, 'participate_low_impact'], m.participateLowImpact);
+                }
+                for (const cls of ['trivial', 'low_impact', 'medium_impact']) {
+                    set(['decision_resolution', 'classes', cls, 'mode'], p.decision?.[cls]);
+                }
+                const target = join(opts.writeRoot, AI_COUNCIL_REL);
+                await fs.mkdir(dirname(target), { recursive: true });
+                await writeAtomic(target, body, { mode: 0o600 });
+                return { ok: true, written: target };
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : 'failed to write .ai-council.yml';
+                await reply.code(500).send({ error: { code: 'COUNCIL_WRITE_FAILED', message } });
+                return reply;
+            }
+        });
         // road-to-configurable-modules § Phase E — Modules detect endpoint.
         // Read-only scan: spawns `scripts/propose_modules_config.py --json`
         // against the consumer project so the wizard's modules step can
@@ -510,10 +713,13 @@ export function wizardRoute(opts) {
                 });
                 return reply;
             }
+            // Always update the in-memory session state (the resume source).
+            memState = parsed.data;
             if (dryRun) {
-                memState = parsed.data;
                 return { ok: true, dryRun: true };
             }
+            // Disk write is a crash breadcrumb only (not read back for resume);
+            // the finish handler clears it on a successful commit.
             await writeState(opts.writeRoot, parsed.data);
             return { ok: true };
         });
@@ -586,6 +792,12 @@ export function wizardRoute(opts) {
                     controller.abort();
             };
             reply.raw.on('close', onClose);
+            // Record the user's tool selection so the next wizard run
+            // pre-selects exactly these (detect-tools `configured`). Written
+            // on the real-apply path only — a dry-run preview must not.
+            if (payload.schema_version === 'wizard-v2') {
+                writeSelectedTools(payload.tools);
+            }
             let written = 0;
             let total = 0;
             let sawTerminal = false;