hyacinth-ai 0.9.14 → 0.9.16

package/dist/cli/doctor.js

@@ -54,7 +54,7 @@ function checkEncoding() {
 }
 function checkPersona() {
     const personaDir = path.join(os.homedir(), '.agent', 'prompts', 'persona');
-    const files = ['SOUL.md', 'IDENTITY.md', 'USER.md', 'BOOTSTRAP.md'];
+    const files = ['SOUL.md', 'IDENTITY.md', 'USER.md'];
     const existing = [];
     const missing = [];
     for (const f of files) {
@@ -64,20 +64,15 @@ function checkPersona() {
         else
             missing.push(f);
     }
-    const hasBootstrap = existing.includes('BOOTSTRAP.md');
     return {
         label: 'Persona 文件',
-        ok: existing.length >= 3 && !hasBootstrap,
-        detail: hasBootstrap
-            ? `BOOTSTRAP.md 仍存在 — 需要完成身份初始化（${existing.length}/4 文件存在）`
-            : missing.length > 0
-                ? `缺失: ${missing.join(', ')}`
-                : `完整 (${existing.length}/4 文件，bootstrap 已完成)`,
+        ok: existing.length >= 3,
+        detail: missing.length > 0
+            ? `缺失: ${missing.join(', ')}`
+            : `完整 (${existing.length}/3 文件)`,
         fix: missing.length > 0
             ? '运行 hyacinth setup 完成初始化'
-            : hasBootstrap
-                ? '启动 TUI 并完成身份对话，或运行 hyacinth setup'
-                : undefined,
+            : undefined,
     };
 }
 function checkDeps() {
@@ -267,7 +262,6 @@ export async function runDoctor(opts = {}) {
         console.log('\n── 自动修复 ──');
         // 修复 persona 文件
         const personaDir = path.join(os.homedir(), '.agent', 'prompts', 'persona');
-        const bootstrapPath = path.join(personaDir, 'BOOTSTRAP.md');
         if (!fs.existsSync(personaDir)) {
             fs.mkdirSync(personaDir, { recursive: true });
         }
@@ -279,10 +273,6 @@ export async function runDoctor(opts = {}) {
                 personaCreated++;
             }
         }
-        // 确保 BOOTSTRAP.md 存在（触发 bootstrap 流程）
-        if (!fs.existsSync(bootstrapPath) && personaCreated > 0) {
-            fs.writeFileSync(bootstrapPath, '# Bootstrap\n请与用户对话，了解其偏好后填写 IDENTITY.md 和 USER.md。', 'utf-8');
-        }
         if (personaCreated > 0) {
             console.log(`  ✅ 创建了 ${personaCreated} 个 Persona 文件`);
         }

package/dist/gateway/cli.js

@@ -20,7 +20,7 @@ import { ConfigManager, API_KEY_MAP, DEFAULT_MAX_CONTEXT_TOKENS } from '../setup
 import { getModelContextWindow } from '../setup/model-defaults.js';
 import { SetupWizard } from '../setup/wizard.js';
 import { PROVIDER_MODELS } from '../setup/model-defaults.js';
-import { DEFAULT_PERSONA_DIR, ensurePersonaFiles, getBootstrapStatus } from '../setup/persona-bootstrap.js';
+import { DEFAULT_PERSONA_DIR, ensurePersonaFiles } from '../setup/persona-bootstrap.js';
 import { createLogger } from '../logging/logger.js';
 import { getDefaultConfig } from '../runtime/defaults.js';
 const logger = createLogger('cli');
@@ -184,7 +184,6 @@ export async function runCli() {
         // 初始化 persona 文件
         const personaDir = DEFAULT_PERSONA_DIR;
         await ensurePersonaFiles(personaDir);
-        const bootstrapStatus = await getBootstrapStatus(personaDir);
         // 如果用户选择进入 TUI，自动启动
         if (result.enterTui && result.config.provider) {
             await configManager.loadEnvKeys();
@@ -195,7 +194,6 @@ export async function runCli() {
                 maxContext: String(result.config.maxContext),
                 tui: true,
                 skipSetup: true,
-                bootstrapStatus,
             });
         }
     });
@@ -686,7 +684,6 @@ async function executeAction(prompt, options) {
     const startModel = options.startModel;
     const skipSetup = options.skipSetup;
     const localModelName = options.localModel;
-    const bootstrapStatus = options.bootstrapStatus;
     // 加载 .env 中的 API Key
     const configManager = new ConfigManager(process.cwd());
     await configManager.loadEnvKeys();
@@ -794,7 +791,7 @@ async function executeAction(prompt, options) {
                 continuationMessage = fsSync.readFileSync(continuationFile, 'utf-8').trim() || undefined;
                 fsSync.unlinkSync(continuationFile);
             }
-            await runTui(provider, sessionId, shouldContinue ?? false, maxTurns, maxContext, maxMessages, skipSetup, DEFAULT_PERSONA_DIR, bootstrapStatus, localModelProvider, continuationMessage);
+            await runTui(provider, sessionId, shouldContinue ?? false, maxTurns, maxContext, maxMessages, skipSetup, DEFAULT_PERSONA_DIR, localModelProvider, continuationMessage);
             return;
         }
         // Session + 模块初始化（由工厂统一处理）
@@ -813,10 +810,6 @@ async function executeAction(prompt, options) {
         sessionDir = agentResult.sessionDir;
         // 注入 LifecycleSupervisor，实现运行时 provider 切换时自动管理本地模型进程
         loop.setLifecycleSupervisor(supervisor);
-        // Bootstrap Flow 已在 factory 中自动激活，发送空消息启动引导对话
-        if (loop.bootstrapActive) {
-            await loop.run('');
-        }
         // 检测重启续工指令
         if (!prompt) {
             const continuationFile = path.join(os.homedir(), '.agent', '.restart-continuation');

package/dist/gateway/factory.d.ts

@@ -12,7 +12,6 @@ import { AgentLoop } from '../orchestrator/loop.js';
 import type { Provider } from '../provider/interface.js';
 import type { DependencyAnalyzer } from '../dependency/analyzer.js';
 import type { OutputHandler } from '../orchestrator/loop.js';
-import type { BootstrapStatus } from '../setup/persona-bootstrap.js';
 import { ModelRouter } from '../provider/model-router.js';
 import { HeartbeatScheduler } from '../schedule/scheduler.js';
 import { HotReloadManager } from '../hot-reload/index.js';
@@ -31,10 +30,8 @@ export interface CreateAgentOptions {
     shouldContinue?: boolean;
     /** 每个 session 的最大消息数 */
     maxMessages?: number;
-    /** Bootstrap 工作区目录 */
+    /** Persona 文件目录 */
     personaDir?: string;
-    /** Bootstrap 状态 */
-    bootstrapStatus?: BootstrapStatus;
     /** 本地模型 Provider（用于压缩通道，不影响主对话） */
     localModelProvider?: Provider;
     /** 渠道信息（注入到 System Prompt 的 environment section） */

package/dist/gateway/factory.js

@@ -27,7 +27,7 @@ import { MemoryStore } from '../memory/memory-store.js';
 import { AgentLoop } from '../orchestrator/loop.js';
 import { PluginManager } from '../plugins/index.js';
 import { initDependencyAnalyzer } from '../dependency/index.js';
-import { ensureGlobalPersonaFiles, ensureGlobalPromptDir, getBootstrapStatus } from '../setup/persona-bootstrap.js';
+import { ensureGlobalPersonaFiles, ensureGlobalPromptDir } from '../setup/persona-bootstrap.js';
 import { ConfigManager } from '../setup/config.js';
 import { RuntimeConfigCenter } from '../runtime/config-center.js';
 import { getDefaultConfig } from '../runtime/defaults.js';
@@ -45,7 +45,7 @@ import { injectConfigCenter } from '../provider/local-config.js';
 import { getModelContextWindow } from '../setup/model-defaults.js';
 import { modelCatalog } from '../provider/catalog.js';
 import { TurnRecorder, TurnStore, createRollbackStatusTool, createRollbackTool } from '../rollback/index.js';
-import { MachineRegistry, BootstrapFlow, TodoFlow, SpecFlow } from '../machine/index.js';
+import { MachineRegistry, TodoFlow, SpecFlow } from '../machine/index.js';
 import { createAskUserTool } from '../tools/ask-user.js';
 import { createFlowStartTool, createFlowAddTool, createFlowCompleteTool } from '../tools/flow.js';
 import { createTriggerCompressionTool } from '../tools/compression.js';
@@ -73,7 +73,7 @@ const logger = createLogger('factory');
 //
 // ─────────────────────────────────────────────────────────────────────
 export async function createAgent(options, supervisor) {
-    const { cwd, provider, maxTurns, maxContext, outputHandler, sessionId, shouldContinue, maxMessages = 10000, personaDir, bootstrapStatus, localModelProvider, channelsInfo } = options;
+    const { cwd, provider, maxTurns, maxContext, outputHandler, sessionId, shouldContinue, maxMessages = 10000, personaDir, localModelProvider, channelsInfo } = options;
     // ── 配置预加载（需在 session 创建前读取 startup.defaultMode）──────
     const configManager = new ConfigManager(cwd);
     const config = await configManager.load();
@@ -118,7 +118,6 @@ export async function createAgent(options, supervisor) {
     // ── Global Persona Bootstrap ──────────────────────────────────────
     const personaSetup = await ensureGlobalPersonaFiles();
     const effectivePersonaDir = personaDir ?? personaSetup.personaDir;
-    const effectiveBootstrapStatus = bootstrapStatus ?? (await getBootstrapStatus(effectivePersonaDir));
     // ── 内置 Prompt 同步 ─────────────────────────────────────────────
     // 将所有内置 prompt 同步到 ~/.agent/prompts/ 下，
     // 使得 loadPrompt() 的查找优先级正确：外部覆盖 > 内置兜底。
@@ -130,8 +129,7 @@ export async function createAgent(options, supervisor) {
     await ensureGlobalPromptDir('precise');
     await ensureGlobalPromptDir('environment');
     // root 级文件 summary.md 由 loadPrompt 递归搜索找到，暂不单独同步
-    // ── 注册 Flow（Bootstrap + TODO + Spec）──────────────────────────
-    flowRegistry.register(new BootstrapFlow(effectivePersonaDir));
+    // ── 注册 Flow（TODO + Spec）────────────────────────────────
     flowRegistry.register(new TodoFlow());
     flowRegistry.register(new SpecFlow());
     // ── Provider Config Loader（必须在 getDefaultConfig 之前，确保 providerDefault 读到 JSON） ──
@@ -523,10 +521,6 @@ export async function createAgent(options, supervisor) {
     // 注入旁路 Provider 引用（供模式切换时 setBypassUserId 使用）
     if (bypassProvider)
         loop.setBypassProvider(bypassProvider);
-    // ── Bootstrap Flow 自动激活（首次安装后自动运行） ──
-    if (effectiveBootstrapStatus === 'pending') {
-        flowRegistry.activate('bootstrap');
-    }
     // 注册后台进程注册表到 LifecycleSupervisor（优雅关闭时自动清理）
     if (supervisor) {
         supervisor.registerBackgroundRegistry(backgroundRegistry);

package/dist/gateway/tui.d.ts

@@ -11,6 +11,5 @@
  *   editor          — user input area
  */
 import type { Provider } from '../provider/interface.js';
-import type { BootstrapStatus } from '../setup/persona-bootstrap.js';
-export declare function runTui(provider: Provider, sessionId: string | undefined, shouldContinue: boolean, maxTurns: number, maxContext: number, maxMessages?: number, skipSetup?: boolean, personaDir?: string, bootstrapStatus?: BootstrapStatus, localModelProvider?: Provider, continuationMessage?: string): Promise<void>;
+export declare function runTui(provider: Provider, sessionId: string | undefined, shouldContinue: boolean, maxTurns: number, maxContext: number, maxMessages?: number, skipSetup?: boolean, personaDir?: string, localModelProvider?: Provider, continuationMessage?: string): Promise<void>;
 //# sourceMappingURL=tui.d.ts.map

package/dist/gateway/tui.js

@@ -23,7 +23,7 @@ import { RuntimeConfigCenter } from '../runtime/config-center.js';
 import { ProviderManager } from '../provider/manager.js';
 import { LifecycleSupervisor } from '../lifecycle/index.js';
 import { createAgent } from './factory.js';
-import { getBootstrapStatus, DEFAULT_PERSONA_DIR } from '../setup/persona-bootstrap.js';
+import { DEFAULT_PERSONA_DIR } from '../setup/persona-bootstrap.js';
 import { createLogger } from '../logging/logger.js';
 import { TuiChannel } from '../channels/builtin/tui-channel.js';
 import { ChannelManager } from '../channels/manager.js';
@@ -197,7 +197,7 @@ function replayEvents(chatLog, sessionDir) {
     });
 }
 // ─── Main TUI ─────────────────────────────────────────────────────────────
-export async function runTui(provider, sessionId, shouldContinue, maxTurns, maxContext, maxMessages = 10000, skipSetup, personaDir = DEFAULT_PERSONA_DIR, bootstrapStatus, localModelProvider, continuationMessage) {
+export async function runTui(provider, sessionId, shouldContinue, maxTurns, maxContext, maxMessages = 10000, skipSetup, personaDir = DEFAULT_PERSONA_DIR, localModelProvider, continuationMessage) {
     // ── Force UTF-8 console encoding on Windows ──
     if (process.platform === 'win32') {
         try {
@@ -716,8 +716,6 @@ export async function runTui(provider, sessionId, shouldContinue, maxTurns, maxC
             });
         },
     };
-    // ── Bootstrap detection ──
-    const resolvedBootstrapStatus = bootstrapStatus ?? (await getBootstrapStatus(personaDir));
     // ── Local Model (llama.cpp) ──
     try {
         const loadedModels = await supervisor.loadAndStartModels(process.cwd());
@@ -793,7 +791,6 @@ export async function runTui(provider, sessionId, shouldContinue, maxTurns, maxC
             shouldContinue,
             maxMessages,
             personaDir,
-            bootstrapStatus: resolvedBootstrapStatus,
             localModelProvider,
             channel: 'tui',
         });
@@ -821,7 +818,6 @@ export async function runTui(provider, sessionId, shouldContinue, maxTurns, maxC
         setScheduler: () => { },
         notifyTaskFired: async () => { },
         subscribeConfig: () => { },
-        isBootstrapPending: () => false,
         shutdown: async () => { },
     };
     // 远程模式下 agent 为 undefined，这些变量仅用于本地 TUI 功能（斜杠命令等），用 any 避免 null 检查
@@ -1049,22 +1045,6 @@ export async function runTui(provider, sessionId, shouldContinue, maxTurns, maxC
     chatLog.addSystem('');
     chatLog.addSystem(theme.dim('Persona: ') + theme.accent(personaDir));
     chatLog.addSystem('');
-    // ── Bootstrap ──
-    if (resolvedBootstrapStatus === 'pending') {
-        chatLog.addSystem(theme.warning('\u256d' + BOX_H.repeat(56) + '\u256e'));
-        chatLog.addSystem(theme.warning('\u2502  \uD83D\uDD27 Bootstrap Init'));
-        chatLog.addSystem(theme.warning('\u2502  AI will ask you setup questions to configure the persona.'));
-        chatLog.addSystem(theme.warning('\u2570' + BOX_H.repeat(56) + '\u256f'));
-        chatLog.addSystem('');
-        try {
-            // Flow 已在 factory.ts 中自动激活，发送空消息让模型根据 flow_injection 引导对话
-            await loop.run('');
-        }
-        catch (error) {
-            const message = error instanceof Error ? error.message : String(error);
-            chatLog.addSystem(theme.errorBright('[Bootstrap Error] ') + theme.error(message));
-        }
-    }
     chatLog.addSystem(theme.dim('Type ') +
         theme.success('exit') +
         theme.dim(' to quit. ') +

package/dist/machine/index.d.ts

@@ -3,6 +3,5 @@ export { MachineRunner } from './runner.js';
 export { MachineRegistry } from './registry.js';
 export type { FlowController } from './flows/types.js';
 export { TodoFlow } from './flows/todo.js';
-export { BootstrapFlow } from './flows/bootstrap.js';
 export { SpecFlow } from './flows/spec.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/machine/index.js

@@ -4,6 +4,5 @@
 export { MachineRunner } from './runner.js';
 export { MachineRegistry } from './registry.js';
 export { TodoFlow } from './flows/todo.js';
-export { BootstrapFlow } from './flows/bootstrap.js';
 export { SpecFlow } from './flows/spec.js';
 //# sourceMappingURL=index.js.map

package/dist/machine/runner.js

@@ -77,46 +77,45 @@ export class MachineRunner {
         if (this.status !== 'active') {
             return { ok: false, reason: `Machine "${this.definition.id}" is not active (status: ${this.status}).` };
         }
-        // 1. 找匹配的转移
-        const transition = this.definition.transitions.find((t) => {
+        // 1. 找匹配的转移（按优先级——跳过 guard 不通过的）
+        let transition;
+        for (const t of this.definition.transitions) {
             const fromMatch = Array.isArray(t.from)
                 ? t.from.includes(this.currentState)
                 : t.from === this.currentState;
-            return fromMatch && t.event === event;
-        });
+            if (fromMatch && t.event === event) {
+                if (t.guard) {
+                    const guardResult = t.guard(this.context);
+                    if (!guardResult.ok)
+                        continue; // guard 不通过，试下一个
+                }
+                transition = t;
+                break;
+            }
+        }
         if (!transition) {
             return {
                 ok: false,
                 reason: `Event "${event}" is not valid in state "${this.currentState}" of machine "${this.definition.id}". Available events: [${this.getAvailableEvents().join(', ')}]`,
             };
         }
-        // 2. Guard 检查
-        if (transition.guard) {
-            const guardResult = transition.guard(this.context);
-            if (!guardResult.ok) {
-                return {
-                    ok: false,
-                    reason: guardResult.reason ?? `Guard rejected transition from "${this.currentState}" to "${transition.to}" via "${event}".`,
-                };
-            }
-        }
-        // 3. onExit 副作用（fire-and-forget）
+        // 2. onExit 副作用（fire-and-forget）
         const oldState = this.currentState;
         const oldDef = this.definition.states[oldState];
         safeFire(oldDef?.onExit, this.context);
-        // 4. onTransition 副作用（同步执行——可阻塞）
+        // 3. onTransition 副作用（同步执行——可阻塞）
         transition.onTransition?.(this.context);
-        // 5. 更新状态
+        // 4. 更新状态
         this.currentState = transition.to;
-        // 6. onEnter 副作用（fire-and-forget）
+        // 5. onEnter 副作用（fire-and-forget）
         const newDef = this.definition.states[this.currentState];
         safeFire(newDef?.onEnter, this.context);
-        // 7. 记录历史
+        // 6. 记录历史
         this.transitionHistory.push({ from: oldState, to: transition.to, event });
         if (this.transitionHistory.length > MAX_HISTORY) {
             this.transitionHistory = this.transitionHistory.slice(-MAX_HISTORY);
         }
-        // 8. 终端状态检查
+        // 7. 终端状态检查
         const isTerminal = this.definition.terminalStates?.includes(this.currentState) ?? false;
         if (isTerminal) {
             this.status = 'completed';

package/dist/orchestrator/loop.d.ts

@@ -213,8 +213,6 @@ export declare class AgentLoop {
     /** Get current turn/mode info for status display */
     getTurnInfo(turnCount: number, tokensUsed: number): TurnInfo;
     private getRecentToolCallNames;
-    /** Bootstrap Flow 是否活跃（供 CLI/TUI 判断是否需要发送空消息启动引导） */
-    get bootstrapActive(): boolean;
     /** 就地切换到指定 session，无需重启进程 */
     switchSession(newSessionDir: string): Promise<void>;
     /** 设置调度器 */

package/dist/orchestrator/loop.js

@@ -411,10 +411,6 @@ export class AgentLoop {
     getRecentToolCallNames() {
         return this.recentToolNames;
     }
-    /** Bootstrap Flow 是否活跃（供 CLI/TUI 判断是否需要发送空消息启动引导） */
-    get bootstrapActive() {
-        return this.flowRegistry.getActive()?.id === 'bootstrap';
-    }
     /** 就地切换到指定 session，无需重启进程 */
     async switchSession(newSessionDir) {
         this.sessionDir = newSessionDir;

package/dist/setup/persona-bootstrap.d.ts

@@ -1,9 +1,7 @@
-declare const PERSONA_FILE_NAMES: readonly ["BOOTSTRAP.md", "SOUL.md", "IDENTITY.md", "USER.md", "PartnerSoul.md", "PartnerMemory.md"];
+declare const PERSONA_FILE_NAMES: readonly ["SOUL.md", "IDENTITY.md", "USER.md", "PartnerSoul.md", "PartnerMemory.md"];
 export type PersonaFileName = (typeof PERSONA_FILE_NAMES)[number];
-export type BootstrapStatus = 'pending' | 'complete';
 export interface PersonaState {
     version: number;
-    bootstrapSeededAt?: string;
     setupCompletedAt?: string;
 }
 export interface PersonaFile {
@@ -22,29 +20,25 @@ export declare const DEFAULT_PERSONA_DIR: string;
 /**
  * 确保内置 prompt 目录同步到 ~/.agent/prompts/{name}/。
  *
- * 和 persona 不同（有 bootstrap 状态机），这只是一个简单的文件复制：
+ * 这只是一个简单的文件复制：
  * 首次安装时复制，已存在则跳过。
  *
  * 用于 attention.md 等非 persona 的内置 prompt 文件。
  */
 export declare function ensureGlobalPromptDir(name: string, configHome?: string): Promise<string[]>;
 export declare function ensurePersonaFiles(personaDir: string): Promise<{
-    status: BootstrapStatus;
+    needsSetup: boolean;
     filesCreated: string[];
     state: PersonaState;
 }>;
 export declare function ensureGlobalPersonaFiles(configHome?: string): Promise<{
-    status: BootstrapStatus;
+    needsSetup: boolean;
     filesCreated: string[];
     state: PersonaState;
     personaDir: string;
 }>;
 export declare function validatePersonaFiles(personaDir: string): Promise<PersonaValidationResult>;
 export declare function validatePersonaFilesSync(personaDir: string): PersonaValidationResult;
-export declare function isBootstrapComplete(personaDir: string): Promise<boolean>;
-export declare function getBootstrapStatus(personaDir: string): Promise<BootstrapStatus>;
-export declare function markBootstrapComplete(personaDir: string): Promise<void>;
-export declare function markBootstrapCompleteSync(personaDir: string): void;
 export declare function loadPersonaFiles(personaDir: string, cwdFallback?: string): Promise<PersonaFile[]>;
 export declare function getPersonaState(personaDir: string): Promise<PersonaState>;
 export {};

package/dist/setup/persona-bootstrap.js

@@ -11,7 +11,6 @@ const PERSONA_STATE_DIR = '.state';
 const PERSONA_STATE_FILE = 'persona-state.json';
 const PERSONA_STATE_VERSION = 1;
 const PERSONA_FILE_NAMES = [
-    'BOOTSTRAP.md',
     'SOUL.md',
     'IDENTITY.md',
     'USER.md',
@@ -97,7 +96,7 @@ async function fileContentDiffersFromTemplate(filePath, template) {
 /**
  * 确保内置 prompt 目录同步到 ~/.agent/prompts/{name}/。
  *
- * 和 persona 不同（有 bootstrap 状态机），这只是一个简单的文件复制：
+ * 这只是一个简单的文件复制：
  * 首次安装时复制，已存在则跳过。
  *
  * 用于 attention.md 等非 persona 的内置 prompt 文件。
@@ -150,9 +149,7 @@ export async function ensurePersonaFiles(personaDir) {
     await fsp.mkdir(personaDir, { recursive: true });
     let state = await readState(personaDir);
     const now = new Date().toISOString();
-    // 自动补检测：如果 persona 文件已被填写（内容 ≠ 模板）但 state 文件未反映
-    //（例如 markBootstrapComplete 因格式验证过严而失败），
-    // 在重建 BOOTSTRAP.md 之前标记为完成。这是修复"每次启动都重新引导"的 bug。
+    // 自动检测：如果 persona 文件已被填写（内容 ≠ 模板）但 state 文件未反映，自动标记完成
     if (!state.setupCompletedAt) {
         try {
             const identityPath = path.join(personaDir, 'IDENTITY.md');
@@ -173,8 +170,6 @@ export async function ensurePersonaFiles(personaDir) {
     const alreadyComplete = !!state.setupCompletedAt;
     const filesCreated = [];
     for (const fileName of PERSONA_FILE_NAMES) {
-        if (alreadyComplete && fileName === 'BOOTSTRAP.md')
-            continue;
         const filePath = path.join(personaDir, fileName);
         const template = loadTemplateContent(fileName);
         const created = await writeFileIfMissing(filePath, template);
@@ -183,38 +178,27 @@ export async function ensurePersonaFiles(personaDir) {
             logger.info('Created persona file', { file: fileName, dir: personaDir });
         }
     }
-    const bootstrapPath = path.join(personaDir, 'BOOTSTRAP.md');
-    let bootstrapExists = true;
-    try {
-        await fsp.access(bootstrapPath);
-    }
-    catch {
-        bootstrapExists = false;
-    }
-    if (bootstrapExists && !state.bootstrapSeededAt) {
-        state = { ...state, bootstrapSeededAt: now };
-    }
+    // 二次检查：如果文件已被修改但 state 尚未记录
     if (!state.setupCompletedAt) {
-        const identityPath = path.join(personaDir, 'IDENTITY.md');
-        const userPath = path.join(personaDir, 'USER.md');
-        const identityTemplate = loadTemplateContent('IDENTITY.md');
-        const userTemplate = loadTemplateContent('USER.md');
-        const identityChanged = await fileContentDiffersFromTemplate(identityPath, identityTemplate);
-        const userChanged = await fileContentDiffersFromTemplate(userPath, userTemplate);
-        if ((identityChanged || userChanged) && !bootstrapExists) {
-            state = { ...state, setupCompletedAt: now };
-            logger.info('Persona setup detected as complete (user-modified files)');
-        }
-        else if (!bootstrapExists && state.bootstrapSeededAt && !state.setupCompletedAt) {
+        try {
+            const identityPath = path.join(personaDir, 'IDENTITY.md');
+            const userPath = path.join(personaDir, 'USER.md');
+            const identityTemplate = loadTemplateContent('IDENTITY.md');
+            const userTemplate = loadTemplateContent('USER.md');
+            const identityChanged = await fileContentDiffersFromTemplate(identityPath, identityTemplate);
+            const userChanged = await fileContentDiffersFromTemplate(userPath, userTemplate);
             if (identityChanged || userChanged) {
                 state = { ...state, setupCompletedAt: now };
-                logger.info('Persona setup auto-completed (seeded + files modified + bootstrap deleted)');
+                logger.info('Persona setup detected as complete (user-modified files)');
             }
         }
+        catch {
+            // 文件可能尚未创建
+        }
     }
     await writeState(personaDir, state);
-    const status = state.setupCompletedAt ? 'complete' : 'pending';
-    return { status, filesCreated, state };
+    const needsSetup = !state.setupCompletedAt;
+    return { needsSetup, filesCreated, state };
 }
 export async function ensureGlobalPersonaFiles(configHome) {
     const personaDir = getGlobalPersonaDir(configHome);
@@ -281,98 +265,6 @@ export function validatePersonaFilesSync(personaDir) {
         templateFiles,
     };
 }
-export async function isBootstrapComplete(personaDir) {
-    const state = await readState(personaDir);
-    if (!state.setupCompletedAt)
-        return false;
-    const validation = await validatePersonaFiles(personaDir);
-    return validation.complete;
-}
-export async function getBootstrapStatus(personaDir) {
-    const state = await readState(personaDir);
-    if (state.setupCompletedAt) {
-        const validation = await validatePersonaFiles(personaDir);
-        return validation.complete ? 'complete' : 'pending';
-    }
-    const bootstrapPath = path.join(personaDir, 'BOOTSTRAP.md');
-    try {
-        await fsp.access(bootstrapPath);
-        return 'pending';
-    }
-    catch {
-        return 'complete';
-    }
-}
-export async function markBootstrapComplete(personaDir) {
-    const validation = await validatePersonaFiles(personaDir);
-    if (!validation.complete) {
-        const details = [
-            validation.missing.length > 0 ? `missing: ${validation.missing.join(', ')}` : '',
-            validation.templateFiles.length > 0 ? `templates: ${validation.templateFiles.join(', ')}` : '',
-        ].filter(Boolean).join('; ');
-        throw new Error(`Persona bootstrap is incomplete${details ? ` (${details})` : ''}.`);
-    }
-    const bootstrapPath = path.join(personaDir, 'BOOTSTRAP.md');
-    try {
-        await fsp.unlink(bootstrapPath);
-        logger.info('Deleted BOOTSTRAP.md');
-    }
-    catch (err) {
-        const code = err.code;
-        if (code !== 'ENOENT')
-            throw err;
-    }
-    const state = await readState(personaDir);
-    state.setupCompletedAt = new Date().toISOString();
-    await writeState(personaDir, state);
-    logger.info('Bootstrap marked as complete');
-}
-export function markBootstrapCompleteSync(personaDir) {
-    const validation = validatePersonaFilesSync(personaDir);
-    if (!validation.complete) {
-        const details = [
-            validation.missing.length > 0 ? `missing: ${validation.missing.join(', ')}` : '',
-            validation.templateFiles.length > 0 ? `templates: ${validation.templateFiles.join(', ')}` : '',
-        ].filter(Boolean).join('; ');
-        throw new Error(`Persona bootstrap is incomplete${details ? ` (${details})` : ''}.`);
-    }
-    const bootstrapPath = path.join(personaDir, 'BOOTSTRAP.md');
-    try {
-        fs.unlinkSync(bootstrapPath);
-        logger.info('Deleted BOOTSTRAP.md');
-    }
-    catch (err) {
-        const code = err.code;
-        if (code !== 'ENOENT')
-            throw err;
-    }
-    const state = readStateSync(personaDir);
-    state.setupCompletedAt = new Date().toISOString();
-    writeStateSync(personaDir, state);
-    logger.info('Bootstrap marked as complete');
-}
-function readStateSync(personaDir) {
-    const statePath = resolveStatePath(personaDir);
-    try {
-        const raw = fs.readFileSync(statePath, 'utf-8');
-        const parsed = JSON.parse(raw);
-        if (parsed && typeof parsed === 'object' && parsed.version === PERSONA_STATE_VERSION) {
-            return parsed;
-        }
-        return { version: PERSONA_STATE_VERSION };
-    }
-    catch (err) {
-        const code = err.code;
-        if (code === 'ENOENT')
-            return { version: PERSONA_STATE_VERSION };
-        throw err;
-    }
-}
-function writeStateSync(personaDir, state) {
-    const stateDir = path.join(personaDir, PERSONA_STATE_DIR);
-    fs.mkdirSync(stateDir, { recursive: true });
-    fs.writeFileSync(resolveStatePath(personaDir), JSON.stringify(state, null, 2) + '\n', 'utf-8');
-}
 export async function loadPersonaFiles(personaDir, cwdFallback) {
     const files = [];
     for (const fileName of PERSONA_FILE_NAMES) {
@@ -406,8 +298,6 @@ export async function loadPersonaFiles(personaDir, cwdFallback) {
     if (cwdFallback) {
         for (let i = 0; i < files.length; i++) {
             const f = files[i];
-            if (f.name === 'BOOTSTRAP.md')
-                continue;
             const template = loadTemplateContent(f.name);
             if (f.content === template || !f.content) {
                 const cwdPath = path.join(cwdFallback, f.name);

package/dist/setup/wizard.js

@@ -121,7 +121,7 @@ export class SetupWizard {
                 if (ws.filesCreated.length > 0) {
                     p.log.info(`已在 ${personaDir} 创建 ${ws.filesCreated.length} 个模板文件`);
                 }
-                if (ws.status === 'pending') {
+                if (ws.needsSetup) {
                     p.log.info(pc.cyan('首次启动时将进行个性化引导对话'));
                 }
             }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hyacinth-ai",
-  "version": "0.9.14",
+  "version": "0.9.16",
   "description": "Hyacinth 🪻 — multi-provider AI agent with tool system and context management",
   "type": "module",
   "main": "dist/index.js",