hyacinth-ai 0.9.6

package/dist/evolution/git-manager.js

@@ -0,0 +1,276 @@
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+const execFileAsync = promisify(execFile);
+export class GitManager {
+    repoPath;
+    constructor(repoPath) {
+        this.repoPath = repoPath;
+    }
+    /** Run a raw git command in repoPath. Public for use by TurnRecorder etc. */
+    async git(args) {
+        try {
+            return await execFileAsync('git', args, { cwd: this.repoPath, maxBuffer: 10 * 1024 * 1024 });
+        }
+        catch (err) {
+            const raw = (err.stderr || err.message || '').trim();
+            if (!raw) {
+                throw new Error(`git ${args.join(' ')} failed (no output)`);
+            }
+            const lines = raw.split('\n');
+            // 分离 error / warning / 其他行
+            const errors = [];
+            const warningPatterns = new Map();
+            const others = [];
+            for (const line of lines) {
+                const trimmed = line.trim();
+                if (/^(error:|fatal:)/i.test(trimmed)) {
+                    errors.push(trimmed);
+                }
+                else if (/^warning:/i.test(trimmed)) {
+                    // 归一化警告模式：去掉单引号内的具体路径（可能是文件路径、目录路径等）
+                    const normalized = trimmed.replace(/'[^']*'/g, "'<...>'");
+                    warningPatterns.set(normalized, (warningPatterns.get(normalized) || 0) + 1);
+                }
+                else {
+                    others.push(trimmed);
+                }
+            }
+            // 构建精简报告
+            const parts = [];
+            // 错误行优先保留（不合并）
+            if (errors.length > 0) {
+                parts.push(`=== ${errors.length} error(s) ===`);
+                parts.push(...errors);
+            }
+            // 警告去重聚合
+            if (warningPatterns.size > 0) {
+                const totalWarnings = [...warningPatterns.values()].reduce((a, b) => a + b, 0);
+                const summaryParts = [];
+                for (const [pattern, count] of warningPatterns) {
+                    if (count === 1) {
+                        summaryParts.push(pattern);
+                    }
+                    else {
+                        summaryParts.push(`${pattern} (×${count})`);
+                    }
+                }
+                parts.push(`=== ${totalWarnings} warning(s), ${warningPatterns.size} unique pattern(s) ===`);
+                parts.push(...summaryParts);
+            }
+            // 其他行（无 error 时补上，有 error 时只保留前几条）
+            if (others.length > 0) {
+                const maxOthers = errors.length > 0 ? 5 : 20;
+                const sliced = others.slice(0, maxOthers);
+                parts.push(...sliced);
+                if (others.length > maxOthers) {
+                    parts.push(`... (${others.length - maxOthers} more lines omitted)`);
+                }
+            }
+            const summary = parts.join('\n');
+            // 最终保底截断（防止极端情况）
+            const finalMsg = summary.length > 20_000 ? summary.slice(0, 20_000) + '\n... (truncated)' : summary;
+            throw new Error(`git ${args.join(' ')} failed:\n${finalMsg}`);
+        }
+    }
+    // Check if path is a git repo
+    async isRepo() {
+        try {
+            await this.git(['rev-parse', '--git-dir']);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    // Initialize repo: git init, add all, first commit
+    async init() {
+        if (await this.isRepo())
+            return;
+        await this.git(['init']);
+        await this.git(['add', '-A']);
+        await this.git(['commit', '-m', 'Initial agent snapshot']);
+    }
+    // Stage all and commit, returns commit hash
+    async commit(message) {
+        await this.git(['add', '-A']);
+        const { stdout } = await this.git(['commit', '-m', message]);
+        const match = stdout.match(/\[[\w-]+\s+([a-f0-9]+)\]/);
+        return match ? match[1] : '';
+    }
+    // Create and switch to new branch
+    async createBranch(name) {
+        await this.git(['checkout', '-b', name]);
+    }
+    // Checkout a ref (branch, commit, tag)
+    async checkout(ref) {
+        await this.git(['checkout', ref]);
+    }
+    // Merge a branch into current
+    async merge(branch) {
+        await this.git(['merge', branch, '--no-edit']);
+    }
+    // Abort a merge in progress
+    async abortMerge() {
+        await this.git(['merge', '--abort']);
+    }
+    // Get diff (optionally against a ref, default unstaged)
+    async diff(ref) {
+        const args = ['diff'];
+        if (ref)
+            args.push(ref);
+        const { stdout } = await this.git(args);
+        return stdout;
+    }
+    // Get commit log
+    async log(limit = 10) {
+        const { stdout } = await this.git(['log', `-${limit}`, '--oneline', '--format=%H|%s|%ai']);
+        return stdout.trim().split('\n').filter(Boolean).map(line => {
+            const [hash, message, ...dateParts] = line.split('|');
+            return { hash, message, date: dateParts.join('|') };
+        });
+    }
+    // Hard reset to a ref (rollback)
+    async resetHard(ref) {
+        await this.git(['reset', '--hard', ref]);
+    }
+    // Get current branch name
+    async getCurrentBranch() {
+        const { stdout } = await this.git(['rev-parse', '--abbrev-ref', 'HEAD']);
+        return stdout.trim();
+    }
+    // Check for uncommitted changes
+    async hasUncommittedChanges() {
+        const { stdout } = await this.git(['status', '--porcelain']);
+        return stdout.trim().length > 0;
+    }
+    // Delete a branch
+    async deleteBranch(name) {
+        await this.git(['branch', '-D', name]);
+    }
+    // Get the repository path
+    getRepoPath() {
+        return this.repoPath;
+    }
+    // Search commit log with grep pattern
+    async logGrep(pattern, limit = 20) {
+        const { stdout } = await this.git([
+            'log', `-${limit}`, '--oneline', '--all',
+            '--format=%H|%s|%ai|%D',
+            `--grep=${pattern}`,
+            '-i',
+        ]);
+        if (!stdout.trim())
+            return [];
+        return stdout.trim().split('\n').filter(Boolean).map(line => {
+            const [hash, message, ...rest] = line.split('|');
+            const fullRest = rest.join('|');
+            const match = fullRest.match(/^(\d{4}-\d{2}-\d{2}.+?)\|?(.*)$/);
+            if (match) {
+                const branchRef = match[2].trim();
+                const branch = branchRef ? branchRef.split(',').map(s => s.trim().replace(/^(HEAD -> |tag: )/, '')).find(s => s.length > 0) : undefined;
+                return { hash, message, date: match[1], branch };
+            }
+            return { hash, message, date: fullRest };
+        });
+    }
+    // Get changed file names via diff
+    async diffNames(ref) {
+        const args = ['diff', '--name-only'];
+        if (ref)
+            args.push(ref);
+        else
+            args.push('HEAD~1');
+        try {
+            const { stdout } = await this.git(args);
+            return stdout.trim().split('\n').filter(Boolean);
+        }
+        catch {
+            return [];
+        }
+    }
+    // Get diff stat
+    async diffStat(ref) {
+        const args = ['diff', '--stat'];
+        if (ref)
+            args.push(ref);
+        else
+            args.push('HEAD~1');
+        try {
+            const { stdout } = await this.git(args);
+            return stdout.trim();
+        }
+        catch {
+            return '';
+        }
+    }
+    // Get commit log for a specific file
+    async logFile(file, limit = 10) {
+        const { stdout } = await this.git([
+            'log', `-${limit}`, '--oneline',
+            '--format=%H|%s|%ai',
+            '--', file,
+        ]);
+        if (!stdout.trim())
+            return [];
+        return stdout.trim().split('\n').filter(Boolean).map(line => {
+            const [hash, message, ...dateParts] = line.split('|');
+            return { hash, message, date: dateParts.join('|') };
+        });
+    }
+    // Revert a commit
+    async revertCommit(hash) {
+        const { stdout } = await this.git(['revert', '--no-edit', hash]);
+        return stdout.trim();
+    }
+    // Stash current changes
+    async stash() {
+        await this.git(['stash', 'push', '-m', 'agent-auto-stash']);
+    }
+    // Pop the most recent stash
+    async stashPop() {
+        await this.git(['stash', 'pop']);
+    }
+    // Run a safe git operation (no throw on expected errors)
+    async gitSafe(args) {
+        try {
+            return await execFileAsync('git', args, { cwd: this.repoPath, maxBuffer: 10 * 1024 * 1024 });
+        }
+        catch {
+            return null;
+        }
+    }
+    // Search commits with multiple keywords (OR logic), returns expanded context entries
+    async searchContext(keywords, currentBranch, limit = 15) {
+        if (keywords.length === 0)
+            return [];
+        const pattern = keywords.map(k => k.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')).join('\\|');
+        const commits = await this.logGrep(pattern, limit);
+        if (commits.length === 0)
+            return [];
+        const entries = [];
+        for (const c of commits) {
+            let files = [];
+            try {
+                files = await this.diffNames(c.hash);
+            }
+            catch {
+                // skip file lookup on error
+            }
+            entries.push({
+                hash: c.hash.slice(0, 8),
+                message: c.message,
+                date: c.date,
+                branch: c.branch ?? 'unknown',
+                files,
+            });
+        }
+        // Cross-branch weighting: current branch results first
+        entries.sort((a, b) => {
+            const aCur = a.branch === currentBranch ? 0 : 1;
+            const bCur = b.branch === currentBranch ? 0 : 1;
+            return aCur - bCur;
+        });
+        return entries;
+    }
+}
+//# sourceMappingURL=git-manager.js.map

package/dist/evolution/index.d.ts

@@ -0,0 +1,3 @@
+export { GitManager } from './git-manager.js';
+export type { CommitInfo } from './git-manager.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/evolution/index.js

@@ -0,0 +1,2 @@
+export { GitManager } from './git-manager.js';
+//# sourceMappingURL=index.js.map

package/dist/flow/bootstrap-flow.d.ts

@@ -0,0 +1,19 @@
+import type { FlowController, FlowStep, FlowStatus } from './types.js';
+export declare class BootstrapFlow implements FlowController {
+    readonly id = "bootstrap";
+    status: FlowStatus;
+    currentStepIndex: number;
+    private steps;
+    private personaDir;
+    constructor(personaDir: string);
+    activate(): void;
+    deactivate(): void;
+    getSteps(): FlowStep[];
+    getCurrentStep(): FlowStep | null;
+    advance(): boolean;
+    isComplete(): boolean;
+    getInjection(): string | null;
+    /** 所有步骤完成后调用：标记 bootstrap 完成，永久不再触发 */
+    onComplete(): Promise<void>;
+}
+//# sourceMappingURL=bootstrap-flow.d.ts.map

package/dist/flow/bootstrap-flow.js

@@ -0,0 +1,72 @@
+// ============================================================
+// BootstrapFlow — 身份引导 Flow
+// ============================================================
+//
+// 首次安装后自动运行一次。通过 4 个步骤引导模型与用户交流，
+// 逐步填写 SOUL.md、IDENTITY.md、USER.md，完成后永久标记。
+//
+// 步骤提示词从 src/prompts/flows/bootstrap-*.md 加载。
+// ============================================================
+import { loadPrompt } from '../prompts/loader.js';
+import { markBootstrapComplete } from '../setup/persona-bootstrap.js';
+const STEP_FILES = [
+    'bootstrap-soul',
+    'bootstrap-identity',
+    'bootstrap-user',
+    'bootstrap-confirm',
+];
+export class BootstrapFlow {
+    id = 'bootstrap';
+    status = 'idle';
+    currentStepIndex = 0;
+    steps = [];
+    personaDir;
+    constructor(personaDir) {
+        this.personaDir = personaDir;
+    }
+    activate() {
+        this.currentStepIndex = 0;
+        this.status = 'active';
+        // 延迟加载步骤提示词（activate 时才加载，避免模块导入时的副作用）
+        this.steps = STEP_FILES.map((file) => ({
+            id: file,
+            prompt: loadPrompt(`flows/${file}`).replace(/\{\{personaDir\}\}/g, this.personaDir),
+        }));
+    }
+    deactivate() {
+        this.status = 'idle';
+        this.steps = [];
+    }
+    getSteps() {
+        return this.steps;
+    }
+    getCurrentStep() {
+        if (this.status !== 'active')
+            return null;
+        return this.steps[this.currentStepIndex] ?? null;
+    }
+    advance() {
+        this.currentStepIndex++;
+        if (this.currentStepIndex >= this.steps.length) {
+            return false; // 所有步骤完成
+        }
+        return true;
+    }
+    isComplete() {
+        return this.currentStepIndex >= this.steps.length;
+    }
+    getInjection() {
+        const step = this.getCurrentStep();
+        if (!step)
+            return null;
+        const total = this.steps.length;
+        const current = this.currentStepIndex + 1;
+        const header = `\n[Bootstrap ${current}/${total}]\n`;
+        return header + step.prompt;
+    }
+    /** 所有步骤完成后调用：标记 bootstrap 完成，永久不再触发 */
+    async onComplete() {
+        await markBootstrapComplete(this.personaDir);
+    }
+}
+//# sourceMappingURL=bootstrap-flow.js.map

package/dist/flow/flow-registry.d.ts

@@ -0,0 +1,12 @@
+import type { FlowController, IFlowRegistry } from './types.js';
+export declare class FlowRegistry implements IFlowRegistry {
+    private flows;
+    private activeFlowId;
+    register(flow: FlowController): void;
+    get(id: string): FlowController | undefined;
+    getActive(): FlowController | undefined;
+    activate(id: string, context?: Record<string, unknown>): void;
+    deactivate(): void;
+    onStepComplete(): Promise<void>;
+}
+//# sourceMappingURL=flow-registry.d.ts.map

package/dist/flow/flow-registry.js

@@ -0,0 +1,74 @@
+// ============================================================
+// FlowRegistry — Flow 注册表
+// ============================================================
+//
+// 管理所有 FlowController 的生命周期。
+// 同一时间只有一个 Flow 处于活跃状态——激活新 Flow 前
+// 自动停用当前活跃的 Flow。
+// ============================================================
+import { createLogger } from '../logging/logger.js';
+const logger = createLogger('flow-registry');
+export class FlowRegistry {
+    flows = new Map();
+    activeFlowId = null;
+    register(flow) {
+        if (this.flows.has(flow.id)) {
+            logger.warn('Flow already registered, replacing', { id: flow.id });
+        }
+        this.flows.set(flow.id, flow);
+    }
+    get(id) {
+        return this.flows.get(id);
+    }
+    getActive() {
+        if (!this.activeFlowId)
+            return undefined;
+        const flow = this.flows.get(this.activeFlowId);
+        if (flow?.status === 'active')
+            return flow;
+        return undefined;
+    }
+    activate(id, context) {
+        const flow = this.flows.get(id);
+        if (!flow) {
+            logger.error('Cannot activate unknown flow', undefined, { id });
+            return;
+        }
+        // 停用当前活跃 Flow
+        if (this.activeFlowId && this.activeFlowId !== id) {
+            this.deactivate();
+        }
+        this.activeFlowId = id;
+        // MutableFlowController 接受 context 参数；固定步骤 Flow 忽略
+        flow.activate(context);
+        logger.info('Flow activated', { id });
+    }
+    deactivate() {
+        if (this.activeFlowId) {
+            const flow = this.flows.get(this.activeFlowId);
+            if (flow && flow.status === 'active') {
+                flow.deactivate();
+            }
+            logger.info('Flow deactivated', { id: this.activeFlowId });
+            this.activeFlowId = null;
+        }
+    }
+    async onStepComplete() {
+        const active = this.getActive();
+        if (!active)
+            return;
+        const hasNext = active.advance();
+        if (!hasNext) {
+            // 所有步骤完成
+            logger.info('Flow completed', { id: active.id });
+            if (active.onComplete) {
+                await active.onComplete();
+            }
+            active.status = 'completed';
+            // deactivate() 会调用 deactivate()，但我们已经手动设置了 status
+            // 直接清理 activeFlowId
+            this.activeFlowId = null;
+        }
+    }
+}
+//# sourceMappingURL=flow-registry.js.map

package/dist/flow/flow-tools.d.ts

@@ -0,0 +1,8 @@
+import type { Tool } from '../tools/interface.js';
+import type { FlowRegistry } from './flow-registry.js';
+/** 判断给定工具名是否为 Flow 框架工具 */
+export declare function isFlowTool(name: string): boolean;
+export declare function createCompleteFlowStepTool(registry: FlowRegistry): Tool;
+export declare function createActivateTodoTool(registry: FlowRegistry): Tool;
+export declare function createAddTodoStepTool(registry: FlowRegistry): Tool;
+//# sourceMappingURL=flow-tools.d.ts.map

package/dist/flow/flow-tools.js

@@ -0,0 +1,106 @@
+// ============================================================
+// Flow Tools — 流程控制工具
+// ============================================================
+//
+// complete_flow_step  — 完成当前步骤，推进到下一步（所有 Flow 通用）
+// activate_todo       — 激活 TODO 模式，开始任务拆分
+// add_todo_step       — 向 TODO Flow 添加执行步骤（仅 planning 阶段）
+// ============================================================
+/** Flow 框架工具名称集合 — 这些工具不记入对话历史 */
+const FLOW_TOOL_NAMES = new Set([
+    'complete_flow_step',
+    'activate_todo',
+    'add_todo_step',
+]);
+/** 判断给定工具名是否为 Flow 框架工具 */
+export function isFlowTool(name) {
+    return FLOW_TOOL_NAMES.has(name);
+}
+export function createCompleteFlowStepTool(registry) {
+    return {
+        name: 'complete_flow_step',
+        description: 'Complete the current flow step and advance to the next one. Call this when you have finished the current step\'s task. In TODO planning phase, this finishes planning and starts execution. In execution phase or bootstrap, this advances to the next step. If this is the final step, the flow ends.',
+        inputSchema: {
+            type: 'object',
+            properties: {},
+            required: [],
+        },
+        async execute(_args) {
+            const active = registry.getActive();
+            if (!active) {
+                return 'No active flow. Nothing to complete.';
+            }
+            // NOTE: 此处不调用 advance()。advance 统一由 loop.ts → onStepComplete()
+            // 在工具执行后调用（见 flow-registry.ts）。两边都调会导致每步跳两步。
+            const mutableFlow = active;
+            const isTodoPlanning = active.id === 'todo' && mutableFlow.phase === 'planning';
+            const currentStep = active.getCurrentStep();
+            const stepLabel = currentStep
+                ? `"${currentStep.id}" (step ${active.currentStepIndex + 1}/${active.getSteps().length})`
+                : isTodoPlanning
+                    ? `planning phase`
+                    : `step ${active.currentStepIndex + 1}`;
+            if (isTodoPlanning) {
+                const stepCount = active.getSteps().length;
+                return `Planning acknowledged. ${stepCount > 0 ? `${stepCount} steps defined, transitioning to execution.` : 'No steps defined — flow will end.'}`;
+            }
+            return `Step ${stepLabel} acknowledged. Advancing...`;
+        },
+    };
+}
+export function createActivateTodoTool(registry) {
+    return {
+        name: 'activate_todo',
+        description: 'Activate TODO mode to break down a complex task into ordered steps. After activation, use add_todo_step to add each step, then call complete_flow_step to start execution. The framework will guide you through one step at a time.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                task: {
+                    type: 'string',
+                    description: 'A concise description of the overall task to be completed.',
+                },
+            },
+            required: ['task'],
+        },
+        async execute(args) {
+            const task = args.task ?? '';
+            const todoFlow = registry.get('todo');
+            if (!todoFlow) {
+                return 'TODO flow is not registered. Cannot activate.';
+            }
+            // 激活 TODO Flow（带任务上下文），自动停用当前活跃 Flow
+            registry.activate('todo', { task });
+            return `TODO mode activated for task: "${task}". Break down the task into steps using add_todo_step, then call complete_flow_step to start execution.`;
+        },
+    };
+}
+export function createAddTodoStepTool(registry) {
+    return {
+        name: 'add_todo_step',
+        description: 'Add a step to the current TODO flow. Only works when TODO mode is active and in the planning phase. Each step should be a concrete, verifiable action.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                description: {
+                    type: 'string',
+                    description: 'A clear, actionable description of this step. Include what constitutes success.',
+                },
+            },
+            required: ['description'],
+        },
+        async execute(args) {
+            const active = registry.getActive();
+            if (!active || active.id !== 'todo') {
+                return 'TODO mode is not active. Use activate_todo first.';
+            }
+            const mutableFlow = active;
+            if (mutableFlow.phase !== 'planning') {
+                return 'Cannot add steps — TODO is already in execution phase.';
+            }
+            const description = args.description ?? '';
+            const step = mutableFlow.addStep(description);
+            return `Step #${mutableFlow.getSteps().length} added: "${step.prompt}". Total: ${mutableFlow.getSteps().length} steps. Add more steps or call complete_flow_step to start execution.`;
+        },
+    };
+}
+//# sourceMappingURL=flow-tools.js.map

package/dist/flow/index.d.ts

@@ -0,0 +1,6 @@
+export type { FlowStep, FlowStatus, FlowPhase, FlowController, MutableFlowController, IFlowRegistry, } from './types.js';
+export { FlowRegistry } from './flow-registry.js';
+export { BootstrapFlow } from './bootstrap-flow.js';
+export { TodoFlow } from './todo-flow.js';
+export { createCompleteFlowStepTool, createActivateTodoTool, createAddTodoStepTool, } from './flow-tools.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/flow/index.js

@@ -0,0 +1,8 @@
+// ============================================================
+// Flow Control — 桶导出
+// ============================================================
+export { FlowRegistry } from './flow-registry.js';
+export { BootstrapFlow } from './bootstrap-flow.js';
+export { TodoFlow } from './todo-flow.js';
+export { createCompleteFlowStepTool, createActivateTodoTool, createAddTodoStepTool, } from './flow-tools.js';
+//# sourceMappingURL=index.js.map

package/dist/flow/todo-flow.d.ts

@@ -0,0 +1,25 @@
+import type { FlowStep, FlowStatus, FlowPhase, MutableFlowController } from './types.js';
+export declare class TodoFlow implements MutableFlowController {
+    readonly id = "todo";
+    status: FlowStatus;
+    currentStepIndex: number;
+    phase: FlowPhase;
+    private steps;
+    private task;
+    private stepCounter;
+    private planningPrompt;
+    private executionPromptTemplate;
+    constructor();
+    activate(context?: Record<string, unknown>): void;
+    deactivate(): void;
+    getSteps(): FlowStep[];
+    getCurrentStep(): FlowStep | null;
+    addStep(description: string): FlowStep;
+    clearSteps(): void;
+    advance(): boolean;
+    isComplete(): boolean;
+    getInjection(): string | null;
+    private buildPlanningInjection;
+    private buildExecutionInjection;
+}
+//# sourceMappingURL=todo-flow.d.ts.map