clover-hackathon 0.1.0

package/dist/models/provider.js

@@ -0,0 +1,347 @@
+// 模型 Provider 抽象与实现：OpenAI / Anthropic / Gemini / Ollama / 自定义兼容接口
+// M2：统一 chat(messages, options) 协议，把各家 function calling 转换为内部 ToolCallRequest。
+import { estimateCostUsd } from "../utils/cost.js";
+import { toJsonSchema } from "../core/tools.js";
+export class CloverError extends Error {
+}
+function requireKey(config) {
+    if (!config.apiKey) {
+        throw new CloverError(config.id + " 未配置 API Key：请运行 clover config 配置，或设置 CLOVER_" + config.id.toUpperCase() + "_KEY 环境变量");
+    }
+    return config.apiKey;
+}
+function toUsage(inputTokens, outputTokens) {
+    return { inputTokens, outputTokens };
+}
+function finish(model, content, usage, toolCalls) {
+    const result = {
+        content,
+        usage,
+        estimatedCostUsd: estimateCostUsd(usage, model),
+        model,
+    };
+    if (toolCalls && toolCalls.length > 0)
+        result.toolCalls = toolCalls;
+    return result;
+}
+function stripSystem(messages) {
+    const system = messages.find((m) => m.role === "system")?.content;
+    return { system, rest: messages.filter((m) => m.role !== "system") };
+}
+/** 解析 OpenAI 风格 tool_calls（arguments 可能是 JSON 字符串或对象） */
+function parseOpenAIToolCalls(raw) {
+    return (raw ?? []).map((tc, index) => {
+        let args = {};
+        const rawArgs = tc.function?.arguments;
+        if (typeof rawArgs === "string") {
+            try {
+                const parsed = JSON.parse(rawArgs);
+                if (parsed && typeof parsed === "object")
+                    args = parsed;
+            }
+            catch {
+                args = {};
+            }
+        }
+        else if (rawArgs && typeof rawArgs === "object") {
+            args = rawArgs;
+        }
+        return { id: tc.id ?? "call_" + index, name: tc.function?.name ?? "", args };
+    });
+}
+/** OpenAI 风格消息转换（OpenAI / custom / Ollama 共用；arguments 按各家要求决定字符串化与否） */
+export function toOpenAIMessages(messages, argsAsString) {
+    return messages.map((m) => {
+        if (m.role === "assistant") {
+            const msg = { role: "assistant", content: m.content };
+            if (m.toolCalls && m.toolCalls.length > 0) {
+                msg.tool_calls = m.toolCalls.map((tc) => ({
+                    id: tc.id,
+                    type: "function",
+                    function: { name: tc.name, arguments: argsAsString ? JSON.stringify(tc.args) : tc.args },
+                }));
+            }
+            return msg;
+        }
+        if (m.role === "tool") {
+            return { role: "tool", tool_call_id: m.toolCallId, content: m.content };
+        }
+        if (m.role === "user" && m.images && m.images.length > 0) {
+            const parts = [];
+            if (m.content)
+                parts.push({ type: "text", text: m.content });
+            for (const img of m.images) {
+                parts.push({ type: "image_url", image_url: { url: "data:" + img.mediaType + ";base64," + img.dataBase64 } });
+            }
+            return { role: "user", content: parts };
+        }
+        return { role: m.role, content: m.content };
+    });
+}
+/** Anthropic 消息转换：tool_use/tool_result 与图片块，合并相邻 user 消息 */
+export function toAnthropicMessages(messages) {
+    const mapped = [];
+    for (const m of messages) {
+        if (m.role === "assistant") {
+            const content = [];
+            if (m.content)
+                content.push({ type: "text", text: m.content });
+            for (const tc of m.toolCalls ?? []) {
+                content.push({ type: "tool_use", id: tc.id, name: tc.name, input: tc.args });
+            }
+            mapped.push({ role: "assistant", content });
+        }
+        else if (m.role === "tool") {
+            mapped.push({
+                role: "user",
+                content: [{ type: "tool_result", tool_use_id: m.toolCallId ?? "", content: m.content }],
+            });
+        }
+        else {
+            const content = [];
+            if (m.content)
+                content.push({ type: "text", text: m.content });
+            for (const img of m.images ?? []) {
+                content.push({ type: "image", source: { type: "base64", media_type: img.mediaType, data: img.dataBase64 } });
+            }
+            mapped.push({ role: "user", content });
+        }
+    }
+    const merged = [];
+    for (const m of mapped) {
+        const prev = merged[merged.length - 1];
+        if (prev && prev.role === m.role)
+            prev.content.push(...m.content);
+        else
+            merged.push({ role: m.role, content: [...m.content] });
+    }
+    return merged;
+}
+function openAITools(tools) {
+    return tools.map((t) => ({
+        type: "function",
+        function: { name: t.name, description: t.description, parameters: toJsonSchema(t) },
+    }));
+}
+// ---------- OpenAI 与自定义兼容接口 ----------
+class OpenAICompatibleProvider {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    async chat(messages, options) {
+        const apiKey = requireKey(this.config);
+        const baseUrl = (this.config.baseUrl ?? "https://api.openai.com/v1").replace(/\/$/, "");
+        const body = {
+            model: this.config.model,
+            messages: toOpenAIMessages(messages, true),
+        };
+        if (options?.tools && options.tools.length > 0) {
+            body.tools = openAITools(options.tools);
+            body.tool_choice = "auto";
+        }
+        const res = await fetch(baseUrl + "/chat/completions", {
+            method: "POST",
+            headers: { "Content-Type": "application/json", Authorization: "Bearer " + apiKey },
+            body: JSON.stringify(body),
+        });
+        if (!res.ok)
+            throw new CloverError(this.config.id + " 请求失败：" + res.status + " " + (await res.text()));
+        const data = (await res.json());
+        const message = data.choices[0]?.message;
+        return finish(this.config.model, message?.content ?? "", toUsage(data.usage.prompt_tokens, data.usage.completion_tokens), parseOpenAIToolCalls(message?.tool_calls ?? []));
+    }
+}
+/** Gemini 消息转换：functionCall/functionResponse 与内联图片，合并相邻同角色消息 */
+export function toGeminiContents(messages) {
+    const mapped = [];
+    for (const m of messages) {
+        if (m.role === "assistant") {
+            const parts = [];
+            if (m.content)
+                parts.push({ text: m.content });
+            for (const tc of m.toolCalls ?? []) {
+                parts.push({ functionCall: { name: tc.name, args: tc.args } });
+            }
+            mapped.push({ role: "model", parts });
+        }
+        else if (m.role === "tool") {
+            mapped.push({
+                role: "user",
+                parts: [{ functionResponse: { name: m.name, response: { result: m.content } } }],
+            });
+        }
+        else {
+            const parts = [];
+            if (m.content)
+                parts.push({ text: m.content });
+            for (const img of m.images ?? []) {
+                parts.push({ inline_data: { mime_type: img.mediaType, data: img.dataBase64 } });
+            }
+            mapped.push({ role: "user", parts });
+        }
+    }
+    const merged = [];
+    for (const m of mapped) {
+        const prev = merged[merged.length - 1];
+        if (prev && prev.role === m.role)
+            prev.parts.push(...m.parts);
+        else
+            merged.push({ role: m.role, parts: [...m.parts] });
+    }
+    return merged;
+}
+// ---------- Anthropic ----------
+class AnthropicProvider {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    async chat(messages, options) {
+        const apiKey = requireKey(this.config);
+        const { system, rest } = stripSystem(messages);
+        const merged = toAnthropicMessages(rest);
+        const body = {
+            model: this.config.model,
+            max_tokens: 4096,
+            system: system ?? undefined,
+            messages: merged,
+        };
+        if (options?.tools && options.tools.length > 0) {
+            body.tools = options.tools.map((t) => ({
+                name: t.name,
+                description: t.description,
+                input_schema: toJsonSchema(t),
+            }));
+            body.tool_choice = { type: "auto" };
+        }
+        const res = await fetch("https://api.anthropic.com/v1/messages", {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                "x-api-key": apiKey,
+                "anthropic-version": "2023-06-01",
+            },
+            body: JSON.stringify(body),
+        });
+        if (!res.ok)
+            throw new CloverError("anthropic 请求失败：" + res.status + " " + (await res.text()));
+        const data = (await res.json());
+        const text = data.content.filter((c) => c.type === "text").map((c) => c.text ?? "").join("");
+        const toolCalls = data.content
+            .filter((c) => c.type === "tool_use")
+            .map((c) => ({ id: c.id ?? "", name: c.name ?? "", args: c.input ?? {} }));
+        return finish(this.config.model, text, toUsage(data.usage.input_tokens, data.usage.output_tokens), toolCalls);
+    }
+}
+// ---------- Gemini ----------
+class GeminiProvider {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    async chat(messages, options) {
+        const apiKey = requireKey(this.config);
+        const url = "https://generativelanguage.googleapis.com/v1beta/models/" +
+            this.config.model +
+            ":generateContent?key=" +
+            encodeURIComponent(apiKey);
+        const { system, rest } = stripSystem(messages);
+        const merged = toGeminiContents(rest);
+        const body = {
+            systemInstruction: system ? { parts: [{ text: system }] } : undefined,
+            contents: merged,
+        };
+        if (options?.tools && options.tools.length > 0) {
+            body.tools = [
+                {
+                    functionDeclarations: options.tools.map((t) => ({
+                        name: t.name,
+                        description: t.description,
+                        parameters: toJsonSchema(t),
+                    })),
+                },
+            ];
+        }
+        const res = await fetch(url, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify(body),
+        });
+        if (!res.ok)
+            throw new CloverError("gemini 请求失败：" + res.status + " " + (await res.text()));
+        const data = (await res.json());
+        const parts = data.candidates?.[0]?.content?.parts ?? [];
+        const text = parts.map((p) => p.text ?? "").join("");
+        const toolCalls = parts
+            .filter((p) => p.functionCall)
+            .map((p, index) => ({
+            id: "fc_" + index,
+            name: p.functionCall?.name ?? "",
+            args: p.functionCall?.args ?? {},
+        }));
+        return finish(this.config.model, text, toUsage(data.usageMetadata?.promptTokenCount ?? 0, data.usageMetadata?.candidatesTokenCount ?? 0), toolCalls);
+    }
+}
+/** Ollama 消息转换：OpenAI 形态，图片走 images 字段 */
+export function toOllamaMessages(messages) {
+    return toOpenAIMessages(messages, false).map((m) => {
+        if (m.role === "user" && Array.isArray(m.content)) {
+            const parts = m.content;
+            const images = parts
+                .filter((p) => p.type === "image_url")
+                .map((p) => String(p.image_url?.url ?? "").split(",").pop() ?? "");
+            const text = parts
+                .filter((p) => p.type === "text")
+                .map((p) => String(p.text ?? ""))
+                .join("\n");
+            const msg = { role: "user", content: text };
+            if (images.length > 0)
+                msg.images = images;
+            return msg;
+        }
+        return m;
+    });
+}
+// ---------- Ollama ----------
+class OllamaProvider {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    async chat(messages, options) {
+        const baseUrl = (this.config.baseUrl ?? "http://localhost:11434").replace(/\/$/, "");
+        const body = {
+            model: this.config.model,
+            stream: false,
+            messages: toOllamaMessages(messages),
+        };
+        if (options?.tools && options.tools.length > 0) {
+            body.tools = openAITools(options.tools);
+        }
+        const res = await fetch(baseUrl + "/api/chat", {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify(body),
+        });
+        if (!res.ok)
+            throw new CloverError("ollama 请求失败：" + res.status + " " + (await res.text()));
+        const data = (await res.json());
+        return finish(this.config.model, data.message?.content ?? "", toUsage(data.prompt_eval_count ?? 0, data.eval_count ?? 0), parseOpenAIToolCalls(data.message?.tool_calls ?? []));
+    }
+}
+export function createProvider(config) {
+    switch (config.id) {
+        case "openai":
+            return new OpenAICompatibleProvider(config);
+        case "custom":
+            return new OpenAICompatibleProvider(config);
+        case "anthropic":
+            return new AnthropicProvider(config);
+        case "gemini":
+            return new GeminiProvider(config);
+        case "ollama":
+            return new OllamaProvider(config);
+    }
+}
+//# sourceMappingURL=provider.js.map

package/dist/models/provider.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,131 @@
+export type ProviderId = "openai" | "anthropic" | "gemini" | "ollama" | "custom";
+export type ChatRole = "system" | "user" | "assistant" | "tool";
+export interface ImageBlock {
+    mediaType: string;
+    dataBase64: string;
+}
+export interface ChatMessage {
+    role: ChatRole;
+    content: string;
+    /** 附件图片（多模态） */
+    images?: ImageBlock[];
+    /** 工具结果消息：对应的工具调用 ID */
+    toolCallId?: string;
+    /** 工具结果消息：工具名 */
+    name?: string;
+    /** assistant 消息：本轮请求的工具调用列表 */
+    toolCalls?: ToolCallRequest[];
+}
+export interface ChatUsage {
+    inputTokens: number;
+    outputTokens: number;
+}
+export interface ToolCallRequest {
+    id: string;
+    name: string;
+    args: Record<string, unknown>;
+}
+export interface ChatOptions {
+    /** 本轮可用的工具定义（各家会转换为自己的 function calling 协议） */
+    tools?: ToolDefinition[];
+}
+export interface ChatResult {
+    content: string;
+    usage: ChatUsage;
+    /** 估算费用（美元） */
+    estimatedCostUsd: number;
+    model: string;
+    /** 模型请求的工具调用（没有则为空） */
+    toolCalls?: ToolCallRequest[];
+}
+export interface ToolParameter {
+    name: string;
+    /** JSON Schema 类型 */
+    type: "string" | "number" | "boolean" | "array" | "object";
+    description: string;
+    required?: boolean;
+}
+export interface ToolResult {
+    ok: boolean;
+    output: string;
+}
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    parameters: ToolParameter[];
+    run(args: Record<string, string | undefined>): Promise<ToolResult>;
+}
+export interface ProviderConfig {
+    id: ProviderId;
+    /** 默认模型名 */
+    model: string;
+    apiKey?: string;
+    baseUrl?: string;
+    enabled: boolean;
+}
+export interface CloverConfig {
+    /** 界面与生成文档的语言：zh | en */
+    language: "zh" | "en";
+    /** 默认模型 Provider */
+    defaultProvider: ProviderId;
+    providers: Partial<Record<ProviderId, ProviderConfig>>;
+    /** 预算上限（美元），0 表示不限制 */
+    budgetUsd: number;
+    /** 竞速模式：自动执行已批准类型命令 */
+    speedMode: boolean;
+    /** 自动 git 备份间隔（分钟） */
+    backupIntervalMinutes: number;
+    /** 定时备份开关 */
+    autoBackup: boolean;
+}
+export interface HackathonMeta {
+    name: string;
+    theme?: string;
+    url?: string;
+    startAt?: string;
+    endAt?: string;
+    durationHours: number;
+    createdAt: string;
+}
+export interface SessionRecord {
+    id: string;
+    startedAt: string;
+    updatedAt: string;
+    messages: ChatMessage[];
+    totalInputTokens: number;
+    totalOutputTokens: number;
+    totalCostUsd: number;
+}
+export interface ProjectState {
+    meta: HackathonMeta | null;
+    challengeSummary?: string;
+    ideas?: IdeaRecord[];
+    mvpPlan?: MvpRecord;
+    checklist?: Record<string, boolean>;
+}
+export interface IdeaRecord {
+    id: string;
+    title: string;
+    summary: string;
+    score: number;
+    marketNote?: string;
+    createdAt: string;
+}
+export interface MvpRecord {
+    goal: string;
+    features: string[];
+    milestones: Array<{
+        title: string;
+        hours: number;
+        tasks: string[];
+    }>;
+    createdAt: string;
+}
+export interface ArchiveEntry {
+    id: string;
+    name: string;
+    path: string;
+    createdAt: string;
+    endedAt?: string;
+    retrospective?: string;
+}

package/dist/types.js

@@ -0,0 +1,3 @@
+// Clover 共享类型定义
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,gBAAgB"}

package/dist/utils/config.d.ts

@@ -0,0 +1,15 @@
+import type { CloverConfig } from "../types.js";
+export declare const GLOBAL_DIR: string;
+export declare const GLOBAL_CONFIG_PATH: string;
+export declare const PROJECT_DIR_NAME = ".clover";
+export declare const PROJECT_CONFIG_PATH: string;
+export declare const ARCHIVE_PATH: string;
+export declare const DEFAULT_CONFIG: CloverConfig;
+/** 读取 JSON，兼容 UTF-8 BOM；文件不存在返回 null */
+export declare function readJsonFile<T>(filePath: string): T | null;
+export declare function writeJsonFile(filePath: string, data: unknown): void;
+export declare function loadGlobalConfig(): CloverConfig;
+export declare function saveGlobalConfig(config: CloverConfig): void;
+/** 判断当前目录是否已初始化比赛项目 */
+export declare function isProject(): boolean;
+export declare function requireProject(): CloverConfig;

package/dist/utils/config.js

@@ -0,0 +1,93 @@
+// 配置系统：全局配置（~/.clover/config.json）+ 项目状态（.clover/）
+// 支持 .env 注入 API Key（CLOVER_OPENAI_KEY 等），向导生成 + 手动编辑双通道。
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import dotenv from "dotenv";
+import { z } from "zod";
+dotenv.config();
+export const GLOBAL_DIR = path.join(os.homedir(), ".clover");
+export const GLOBAL_CONFIG_PATH = path.join(GLOBAL_DIR, "config.json");
+export const PROJECT_DIR_NAME = ".clover";
+export const PROJECT_CONFIG_PATH = path.join(PROJECT_DIR_NAME, "clover.json");
+export const ARCHIVE_PATH = path.join(GLOBAL_DIR, "archive.json");
+const providerSchema = z.object({
+    id: z.enum(["openai", "anthropic", "gemini", "ollama", "custom"]),
+    model: z.string(),
+    apiKey: z.string().optional(),
+    baseUrl: z.string().optional(),
+    enabled: z.boolean(),
+});
+const configSchema = z.object({
+    language: z.enum(["zh", "en"]),
+    defaultProvider: z.enum(["openai", "anthropic", "gemini", "ollama", "custom"]),
+    providers: z.record(z.string(), providerSchema).optional(),
+    budgetUsd: z.number().min(0),
+    speedMode: z.boolean(),
+    backupIntervalMinutes: z.number().min(1),
+    autoBackup: z.boolean(),
+});
+export const DEFAULT_CONFIG = {
+    language: "zh",
+    defaultProvider: "openai",
+    providers: {
+        openai: { id: "openai", model: "gpt-4o-mini", apiKey: undefined, enabled: false },
+        anthropic: { id: "anthropic", model: "claude-sonnet-4-5", apiKey: undefined, enabled: false },
+        gemini: { id: "gemini", model: "gemini-2.5-flash", apiKey: undefined, enabled: false },
+        ollama: { id: "ollama", model: "qwen2.5:7b", baseUrl: "http://localhost:11434", enabled: false },
+        custom: { id: "custom", model: "gpt-4o-mini", apiKey: undefined, baseUrl: undefined, enabled: false },
+    },
+    budgetUsd: 10,
+    speedMode: false,
+    backupIntervalMinutes: 30,
+    autoBackup: true,
+};
+/** 读取 JSON，兼容 UTF-8 BOM；文件不存在返回 null */
+export function readJsonFile(filePath) {
+    if (!fs.existsSync(filePath))
+        return null;
+    const raw = fs.readFileSync(filePath, "utf8").replace(/^\uFEFF/, "");
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+export function writeJsonFile(filePath, data) {
+    fs.mkdirSync(path.dirname(filePath), { recursive: true });
+    fs.writeFileSync(filePath, JSON.stringify(data, null, 2) + "\n", "utf8");
+}
+/** 从环境变量补全 API Key：CLOVER_<PROVIDER>_KEY */
+function applyEnvKeys(config) {
+    for (const id of Object.keys(config.providers)) {
+        const envKey = "CLOVER_" + id.toUpperCase() + "_KEY";
+        const value = process.env[envKey];
+        const provider = config.providers[id];
+        if (provider && value && !provider.apiKey) {
+            provider.apiKey = value;
+        }
+    }
+    return config;
+}
+export function loadGlobalConfig() {
+    const raw = readJsonFile(GLOBAL_CONFIG_PATH);
+    if (!raw)
+        return DEFAULT_CONFIG;
+    const parsed = configSchema.safeParse(raw);
+    return applyEnvKeys(parsed.success ? parsed.data : DEFAULT_CONFIG);
+}
+export function saveGlobalConfig(config) {
+    writeJsonFile(GLOBAL_CONFIG_PATH, config);
+}
+/** 判断当前目录是否已初始化比赛项目 */
+export function isProject() {
+    return fs.existsSync(PROJECT_CONFIG_PATH);
+}
+export function requireProject() {
+    if (!isProject()) {
+        throw new Error("当前目录不是 Clover 比赛项目，请先运行 clover init");
+    }
+    return loadGlobalConfig();
+}
+//# sourceMappingURL=config.js.map

package/dist/utils/config.js.map

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

package/dist/utils/cost.d.ts

@@ -0,0 +1,16 @@
+import type { ChatUsage } from "../types.js";
+export interface ModelPrice {
+    inputPerM: number;
+    outputPerM: number;
+}
+export declare const PRICING: Record<string, ModelPrice>;
+export declare function estimateCostUsd(usage: ChatUsage, model: string): number;
+export declare function formatUsd(value: number): string;
+export interface BudgetStatus {
+    totalUsd: number;
+    limitUsd: number;
+    ratio: number;
+    nearLimit: boolean;
+}
+export declare function checkBudget(totalUsd: number, limitUsd: number): BudgetStatus;
+export declare function addUsage(a: ChatUsage, b: ChatUsage): ChatUsage;