zapmyco 0.16.0 → 0.17.2-beta.2

package/README.md

@@ -1,62 +1,47 @@
-# zapmyco
+# ai-typescript-starter
 
-[![CI](https://github.com/shenjingnan/zapmyco/actions/workflows/ci.yml/badge.svg)](https://github.com/shenjingnan/zapmyco/actions/workflows/ci.yml)
-[![npm version](https://img.shields.io/npm/v/zapmyco.svg)](https://www.npmjs.com/package/zapmyco)
+[![CI](https://github.com/shenjingnan/ai-typescript-starter/actions/workflows/ci.yml/badge.svg)](https://github.com/shenjingnan/ai-typescript-starter/actions/workflows/ci.yml)
+[![npm version](https://img.shields.io/npm/v/ai-typescript-starter.svg)](https://www.npmjs.com/package/ai-typescript-starter)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-AI 原生并行任务编排系统 -- AI 总管 (Personal AI Chief of Staff)。
+AI 原生的 TypeScript 启动模板，专为 AI 辅助开发时代打造。
 
 ## 特性
 
-- **Agent 协议**: 统一的 `IAgent` / `IStreamingAgent` 接口，支持请求-响应 + 流式事件双通道模式
-- **任务编排**: 目标分解、子任务依赖图、并行执行与结果聚合
-- **Agent 运行时**: 基于 pi-agent-core 的适配层，支持 LLM 驱动的 Agent 创建与工具桥接
-- **LLM 集成**: 多 Provider 抽象、结构化输出、Token 用量追踪
-- **交互式 REPL**: 基于 pi-tui 的终端界面，支持命令注册、历史记录、自定义编辑器
-- **CLI 工具链**: `run` 直接执行目标、`agents` 查看注册 Agent、`config` 管理配置
-- **配置系统**: cosmiconfig 驱动，支持多级配置覆盖
-- **基础设施**: 事件总线、统一错误体系、结构化日志
+- **现代技术栈**: TypeScript + Node.js 24+ + pnpm
+- **构建工具**: tsdown - 基于 rolldown 的 TypeScript 打包器
+- **测试框架**: Vitest - Vite 原生测试框架
+- **代码质量**: Biome (Lint + Format) + cspell (拼写检查)
+- **Git 工作流**: Husky + lint-staged + release-it
+- **AI 集成**: 内置 CLAUDE.md 和 .claude/ 目录配置
+- **CI/CD**: GitHub Actions 自动化测试和发布
 
 ## 快速开始
 
+### 使用模板
+
+点击仓库页面的 "Use this template" 按钮创建新项目。
+
 ### 安装
 
 ```bash
 # 克隆项目
-git clone https://github.com/shenjingnan/zapmyco.git
-cd zapmyco
+git clone https://github.com/your-username/your-project.git
+cd your-project
 
 # 安装依赖
 pnpm install
 ```
 
-### 使用
-
-```bash
-# 构建项目
-pnpm run build
-
-# 进入交互式 REPL 模式
-pnpm run start
-# 或直接运行 CLI
-zapmyco
-
-# 直接执行单次目标（非交互模式）
-zapmyco run "重构用户认证模块"
-
-# 列出可用 Agent
-zapmyco agents
-
-# 显示版本号
-zapmyco version
-```
-
 ### 开发
 
 ```bash
-# 开发模式 (watch)
+# 开发模式
 pnpm run dev
 
+# 构建
+pnpm run build
+
 # 测试
 pnpm run test
 
@@ -73,27 +58,16 @@ pnpm run check
 ## 项目结构
 
 ```
-zapmyco/
-├── .agents/              # AI Agent 配置 (.claude 符号链接指向此目录)
+ai-typescript-starter/
+├── .claude/              # Claude Code 配置
 │   ├── commands/         # Slash 命令
 │   └── skills/           # 技能定义
 ├── .github/              # GitHub 配置
-│   └── workflows/        # CI/CD 工作流
+│   ├── workflows/        # CI/CD 工作流
+│   └── ISSUE_TEMPLATE/   # Issue 模板
 ├── docs/                 # 文档
 ├── examples/             # 示例代码
-├── src/
-│   ├── cli/              # CLI 入口 & REPL 交互界面
-│   │   └── repl/         # REPL 核心：命令注册、会话、渲染、历史、编辑器
-│   ├── config/           # 配置加载与默认值
-│   ├── core/             # 核心领域模型
-│   │   ├── agent-runtime/# Agent 运行时 (pi-agent-core 适配层)
-│   │   ├── aggregator/   # 结果聚合
-│   │   ├── intent/       # 目标与意图
-│   │   ├── result/       # 任务结果
-│   │   └── task/         # 子任务与依赖图
-│   ├── infra/            # 基础设施：常量、错误、事件总线、日志
-│   ├── llm/              # LLM Provider 抽象 & Token 追踪
-│   ├── protocol/         # Agent 协议接口定义
+├── src/                  # 源代码
 │   └── __tests__/        # 测试文件
 ├── AGENTS.md             # AI Agent 配置
 └── dist/                 # 构建产物
@@ -101,107 +75,41 @@ zapmyco/
 
 ## 可用脚本
 
-| 命令 | 说明 |
-|------|------|
-| `pnpm run build` | 构建项目 |
-| `pnpm run dev` | 开发模式 (watch) |
-| `pnpm run start` | 启动 CLI (REPL 模式) |
-| `pnpm run test` | 运行测试 |
-| `pnpm run test:watch` | 测试监听模式 |
-| `pnpm run test:coverage` | 测试覆盖率报告 |
-| `pnpm run lint` | 代码检查 |
-| `pnpm run lint:fix` | 自动修复代码问题 |
-| `pnpm run format` | 格式化代码 |
-| `pnpm run typecheck` | TypeScript 类型检查 |
-| `pnpm run check` | 完整检查 (typecheck + lint) |
-| `pnpm run check:fix` | 检查并自动修复 |
-| `pnpm run spellcheck` | 拼写检查 |
-| `pnpm run release` | 创建发布 |
-| `pnpm run release:beta` | 发布 beta 预发布版本 |
-| `pnpm run release:dry` | 发布干运行 (不实际发布) |
-| `pnpm run release:patch` | 直接发布 patch 版本 |
-| `pnpm run release:minor` | 直接发布 minor 版本 |
-| `pnpm run release:major` | 直接发布 major 版本 |
-
-## 公共 API
-
-### 核心导出
-
-```typescript
-import {
-  VERSION,
-  APP_NAME,
-  // 配置
-  loadConfig,
-  DEFAULT_CONFIG,
-  type ZapmycoConfig,
-  // Agent 运行时
-  createLlmBasedAgent,
-  createToolsFromCapabilities,
-  createToolFromCapability,
-  adaptAgentEvent,
-  createEventBridgeListener,
-  dispatchToEventBus,
-  LlmBasedAgent,
-  // LLM
-  CostTracker,
-  costTracker,
-  // 基础设施
-  eventBus,
-  Logger,
-  logger,
-  ZapmycoError,
-} from 'zapmyco';
-```
-
-### Protocol 层类型
-
-```typescript
-import type {
-  IAgent,
-  IStreamingAgent,
-  AgentExecuteRequest,
-  AgentExecuteOptions,
-  AgentStatus,
-  Capability,
-  CapabilityCategory,
-  Goal,
-  SubTask,
-  TaskGraph,
-  TaskResult,
-  FinalResult,
-  TokenUsage,
-} from 'zapmyco';
-
-// 或单独导入协议层
-import type { IAgent, IStreamingAgent } from 'zapmyco/protocol';
-```
-
-### 核心领域类型
-
-| 模块 | 关键类型 | 说明 |
-|------|---------|------|
-| `protocol/agent` | `IAgent`, `IStreamingAgent` | Agent 统一接口 |
-| `core/intent` | `Goal`, `GoalType`, `GoalConstraints` | 目标与意图定义 |
-| `core/task` | `SubTask`, `TaskGraph`, `TaskStatus` | 子任务与依赖图 |
-| `core/result` | `TaskResult`, `FinalResult`, `TokenUsage` | 执行结果与用量 |
-| `core/aggregator` | `ProgressEvent`, `ProgressPayload` | 进度事件 |
-| `core/agent-runtime` | `AgentRuntimeConfig`, `ToolRegistration` | 运行时配置 |
-| `llm/types` | `ChatMessage`, `LlmResponse`, `StructuredOutputSchema` | LLM 交互类型 |
-| `config/types` | `ZapmycoConfig` | 应用配置 |
+| 命令                     | 说明                        |
+| ------------------------ | --------------------------- |
+| `pnpm run build`         | 构建项目                    |
+| `pnpm run dev`           | 开发模式 (watch)            |
+| `pnpm run test`          | 运行测试                    |
+| `pnpm run test:watch`    | 测试监听模式                |
+| `pnpm run test:coverage` | 测试覆盖率报告              |
+| `pnpm run lint`          | 代码检查                    |
+| `pnpm run lint:fix`      | 自动修复代码问题            |
+| `pnpm run format`        | 格式化代码                  |
+| `pnpm run typecheck`     | TypeScript 类型检查         |
+| `pnpm run check`         | 完整检查 (typecheck + lint) |
+| `pnpm run check:fix`     | 检查并修复                  |
+| `pnpm run spellcheck`    | 拼写检查                    |
+| `pnpm run release`       | 创建发布                    |
+| `pnpm run release:beta`  | 发布 beta 预发布版本        |
+| `pnpm run release:dry`   | 发布干运行 (不实际发布)     |
+| `pnpm run release:patch` | 直接发布 patch 版本         |
+| `pnpm run release:minor` | 直接发布 minor 版本         |
+| `pnpm run release:major` | 直接发布 major 版本         |
 
 ## AI 辅助开发
 
 本项目专为 AI 辅助开发设计，内置了完善的 AI 工程约束：
 
-### AGENTS.md / CLAUDE.md
+### CLAUDE.md
 
 为 Claude Code 提供项目上下文和开发规范。
 
-### .agents/ 目录
+### .claude/ 目录
 
-- `commands/` - 自定义 Slash 命令 (`/build`, `/test`, `/lint`, `/typecheck`, `/release`, `/commit-push-pr`)
-- `skills/` - 项目技能定义 (`update-readme`, `resolve-git-conflicts`, `project-context` 等)
+- `commands/` - 自定义 Slash 命令 (`/build`, `/test`, `/lint`, `/typecheck`, `/spellcheck`,
+  `/release`, `/commit-push-pr`)
+- `skills/` - 项目技能定义 (`resolve-git-conflicts`, `fix-audit`, `project-context`,
+  `update-readme`)
 
 ## 代码风格
 
@@ -226,6 +134,7 @@ pnpm run release
 ```
 
 发布过程会自动：
+
 1. 更新版本号
 2. 更新 CHANGELOG.md
 3. 创建 Git tag

package/esm/_dnt.polyfills.js

@@ -0,0 +1,127 @@
+/**
+ * Based on [import-meta-ponyfill](https://github.com/gaubee/import-meta-ponyfill),
+ * but instead of using npm to install additional dependencies,
+ * this approach manually consolidates cjs/mjs/d.ts into a single file.
+ *
+ * Note that this code might be imported multiple times
+ * (for example, both dnt.test.polyfills.ts and dnt.polyfills.ts contain this code;
+ *  or Node.js might dynamically clear the cache and then force a require).
+ * Therefore, it's important to avoid redundant writes to global objects.
+ * Additionally, consider that commonjs is used alongside esm,
+ * so the two ponyfill functions are stored independently in two separate global objects.
+ */
+//@ts-ignore
+import { createRequire } from "node:module";
+//@ts-ignore
+import { fileURLToPath, pathToFileURL } from "node:url";
+//@ts-ignore
+import { dirname } from "node:path";
+const defineGlobalPonyfill = (symbolFor, fn) => {
+    if (!Reflect.has(globalThis, Symbol.for(symbolFor))) {
+        Object.defineProperty(globalThis, Symbol.for(symbolFor), {
+            configurable: true,
+            get() {
+                return fn;
+            },
+        });
+    }
+};
+export let import_meta_ponyfill_commonjs = (Reflect.get(globalThis, Symbol.for("import-meta-ponyfill-commonjs")) ??
+    (() => {
+        const moduleImportMetaWM = new WeakMap();
+        return (require, module) => {
+            let importMetaCache = moduleImportMetaWM.get(module);
+            if (importMetaCache == null) {
+                const importMeta = Object.assign(Object.create(null), {
+                    url: pathToFileURL(module.filename).href,
+                    main: require.main == module,
+                    resolve: (specifier, parentURL = importMeta.url) => {
+                        return pathToFileURL((importMeta.url === parentURL
+                            ? require
+                            : createRequire(parentURL))
+                            .resolve(specifier)).href;
+                    },
+                    filename: module.filename,
+                    dirname: module.path,
+                });
+                moduleImportMetaWM.set(module, importMeta);
+                importMetaCache = importMeta;
+            }
+            return importMetaCache;
+        };
+    })());
+defineGlobalPonyfill("import-meta-ponyfill-commonjs", import_meta_ponyfill_commonjs);
+export let import_meta_ponyfill_esmodule = (Reflect.get(globalThis, Symbol.for("import-meta-ponyfill-esmodule")) ??
+    ((importMeta) => {
+        const resolveFunStr = String(importMeta.resolve);
+        const shimWs = new WeakSet();
+        //@ts-ignore
+        const mainUrl = ("file:///" + process.argv[1].replace(/\\/g, "/"))
+            .replace(/\/{3,}/, "///");
+        const commonShim = (importMeta) => {
+            if (typeof importMeta.main !== "boolean") {
+                importMeta.main = importMeta.url === mainUrl;
+            }
+            if (typeof importMeta.filename !== "string") {
+                importMeta.filename = fileURLToPath(importMeta.url);
+                importMeta.dirname = dirname(importMeta.filename);
+            }
+        };
+        if (
+        // v16.2.0+, v14.18.0+: Add support for WHATWG URL object to parentURL parameter.
+        resolveFunStr === "undefined" ||
+            // v20.0.0+, v18.19.0+"" This API now returns a string synchronously instead of a Promise.
+            resolveFunStr.startsWith("async")
+        // enable by --experimental-import-meta-resolve flag
+        ) {
+            import_meta_ponyfill_esmodule = (importMeta) => {
+                if (!shimWs.has(importMeta)) {
+                    shimWs.add(importMeta);
+                    const importMetaUrlRequire = {
+                        url: importMeta.url,
+                        require: createRequire(importMeta.url),
+                    };
+                    importMeta.resolve = function resolve(specifier, parentURL = importMeta.url) {
+                        return pathToFileURL((importMetaUrlRequire.url === parentURL
+                            ? importMetaUrlRequire.require
+                            : createRequire(parentURL)).resolve(specifier)).href;
+                    };
+                    commonShim(importMeta);
+                }
+                return importMeta;
+            };
+        }
+        else {
+            /// native support
+            import_meta_ponyfill_esmodule = (importMeta) => {
+                if (!shimWs.has(importMeta)) {
+                    shimWs.add(importMeta);
+                    commonShim(importMeta);
+                }
+                return importMeta;
+            };
+        }
+        return import_meta_ponyfill_esmodule(importMeta);
+    }));
+defineGlobalPonyfill("import-meta-ponyfill-esmodule", import_meta_ponyfill_esmodule);
+export let import_meta_ponyfill = ((...args) => {
+    const _MODULE = (() => {
+        if (typeof require === "function" && typeof module === "object") {
+            return "commonjs";
+        }
+        else {
+            // eval("typeof import.meta");
+            return "esmodule";
+        }
+    })();
+    if (_MODULE === "commonjs") {
+        //@ts-ignore
+        import_meta_ponyfill = (r, m) => import_meta_ponyfill_commonjs(r, m);
+    }
+    else {
+        //@ts-ignore
+        import_meta_ponyfill = (im) => import_meta_ponyfill_esmodule(im);
+    }
+    //@ts-ignore
+    return import_meta_ponyfill(...args);
+});

package/esm/_dnt.shims.js

@@ -0,0 +1,61 @@
+import { Deno } from "@deno/shim-deno";
+export { Deno } from "@deno/shim-deno";
+const dntGlobals = {
+    Deno,
+};
+export const dntGlobalThis = createMergeProxy(globalThis, dntGlobals);
+function createMergeProxy(baseObj, extObj) {
+    return new Proxy(baseObj, {
+        get(_target, prop, _receiver) {
+            if (prop in extObj) {
+                return extObj[prop];
+            }
+            else {
+                return baseObj[prop];
+            }
+        },
+        set(_target, prop, value) {
+            if (prop in extObj) {
+                delete extObj[prop];
+            }
+            baseObj[prop] = value;
+            return true;
+        },
+        deleteProperty(_target, prop) {
+            let success = false;
+            if (prop in extObj) {
+                delete extObj[prop];
+                success = true;
+            }
+            if (prop in baseObj) {
+                delete baseObj[prop];
+                success = true;
+            }
+            return success;
+        },
+        ownKeys(_target) {
+            const baseKeys = Reflect.ownKeys(baseObj);
+            const extKeys = Reflect.ownKeys(extObj);
+            const extKeysSet = new Set(extKeys);
+            return [...baseKeys.filter((k) => !extKeysSet.has(k)), ...extKeys];
+        },
+        defineProperty(_target, prop, desc) {
+            if (prop in extObj) {
+                delete extObj[prop];
+            }
+            Reflect.defineProperty(baseObj, prop, desc);
+            return true;
+        },
+        getOwnPropertyDescriptor(_target, prop) {
+            if (prop in extObj) {
+                return Reflect.getOwnPropertyDescriptor(extObj, prop);
+            }
+            else {
+                return Reflect.getOwnPropertyDescriptor(baseObj, prop);
+            }
+        },
+        has(_target, prop) {
+            return prop in extObj || prop in baseObj;
+        },
+    });
+}

package/esm/deno.js

@@ -0,0 +1,65 @@
+export default {
+    "name": "@zapmyco/zapmyco",
+    "version": "0.17.2-beta.2",
+    "description": "AI 原生的 TypeScript 启动模板，专为 AI 辅助开发时代打造",
+    "exports": "./src/index.ts",
+    "tasks": {
+        "cli": "deno run --allow-env --allow-net src/index.ts",
+        "ai": "deno run --allow-env --allow-net src/index.ts ai",
+        "install:global": "deno install -g -n zapmyco --allow-env --allow-net src/index.ts",
+        "dev": "deno run --watch src/index.ts",
+        "test": "deno test --allow-env",
+        "test:coverage": "deno test --allow-env --coverage && deno coverage",
+        "lint": "deno lint",
+        "fmt": "deno fmt",
+        "fmt:check": "deno fmt --check",
+        "check": "deno check src/",
+        "check:all": "deno fmt --check && deno lint && deno check src/ && deno test --allow-env",
+        "release": "deno run -A tools/release.ts",
+        "release:dry": "deno run -A tools/release.ts --dry-run",
+        "build:npm": "deno run -A tools/build-npm.ts"
+    },
+    "nodeModulesDir": "auto",
+    "fmt": {
+        "exclude": [
+            "docs/"
+        ],
+        "lineWidth": 100,
+        "indentWidth": 2,
+        "semiColons": true,
+        "singleQuote": true
+    },
+    "lint": {
+        "rules": {
+            "tags": [
+                "recommended"
+            ],
+            "exclude": [
+                "no-explicit-any"
+            ]
+        }
+    },
+    "publish": {
+        "exclude": [
+            ".agents",
+            ".claude",
+            ".githooks",
+            ".github",
+            "coverage",
+            "docs",
+            "examples",
+            "CHANGELOG.md",
+            "AGENTS.md",
+            "src/**/*_test.ts",
+            "tools",
+            "dist"
+        ]
+    },
+    "compilerOptions": {
+        "strict": true,
+        "noUnusedLocals": true,
+        "noUnusedParameters": true,
+        "noImplicitReturns": true,
+        "noUncheckedIndexedAccess": true
+    }
+};

package/esm/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "module"
+}

package/esm/src/ai-agent.js

@@ -0,0 +1,138 @@
+/**
+ * AI Agent - 基于 @anthropic-ai/sdk 的 LLM 对话代理
+ */
+import * as dntShim from "../_dnt.shims.js";
+import Anthropic from '@anthropic-ai/sdk';
+import { TextLineStream } from './text-line-stream.js';
+const DEFAULT_BASE_URL = 'https://api.deepseek.com/anthropic';
+const DEFAULT_MODEL = 'deepseek-v4-flash';
+const DEFAULT_SYSTEM_PROMPT = '你是一个 AI 编程助手，帮助用户解决编程问题。';
+/**
+ * AI Agent 类 - 封装 LLM 对话功能
+ */
+export class AiAgent {
+    constructor(options = {}) {
+        Object.defineProperty(this, "client", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "model", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "messages", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: []
+        });
+        Object.defineProperty(this, "systemPrompt", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        const apiKey = options.apiKey ?? dntShim.Deno.env.get('DEEPSEEK_API_KEY');
+        if (!apiKey) {
+            throw new Error('DEEPSEEK_API_KEY 未设置。请通过环境变量 DEEPSEEK_API_KEY 设置 API Key。');
+        }
+        this.client = new Anthropic({
+            baseURL: options.baseURL ?? DEFAULT_BASE_URL,
+            apiKey,
+        });
+        this.model = options.model ?? DEFAULT_MODEL;
+        this.systemPrompt = options.systemPrompt ?? DEFAULT_SYSTEM_PROMPT;
+    }
+    /**
+     * 非流式对话 - 发送消息并获取完整回复
+     * @param input - 用户输入
+     * @returns 完整回复文本
+     */
+    async chat(input) {
+        this.messages.push({ role: 'user', content: input });
+        const response = await this.client.messages.create({
+            model: this.model,
+            max_tokens: 4096,
+            system: this.systemPrompt,
+            messages: this.messages,
+        });
+        const firstBlock = response.content[0];
+        const content = firstBlock?.type === 'text' ? firstBlock.text : '';
+        this.messages.push({ role: 'assistant', content });
+        return content;
+    }
+    /**
+     * 流式对话 - 发送消息并通过回调逐块获取回复
+     * @param input - 用户输入
+     * @param onChunk - 每收到一个文本块的回调
+     * @returns 完整回复文本
+     */
+    async chatStream(input, onChunk) {
+        this.messages.push({ role: 'user', content: input });
+        const stream = this.client.messages.stream({
+            model: this.model,
+            max_tokens: 4096,
+            system: this.systemPrompt,
+            messages: this.messages,
+        });
+        stream.on('text', (text) => {
+            onChunk(text);
+        });
+        const response = await stream.finalMessage();
+        const firstBlock = response.content[0];
+        const content = firstBlock?.type === 'text' ? firstBlock.text : '';
+        this.messages.push({ role: 'assistant', content });
+        return content;
+    }
+    /**
+     * 启动交互式对话 - 从 stdin 读取输入，流式输出到 stdout
+     */
+    async startInteractiveChat() {
+        const encoder = new TextEncoder();
+        console.error('进入 AI 对话模式');
+        console.error(`模型: ${this.model}`);
+        console.error('输入 /exit 退出，/clear 清空上下文');
+        console.error('---');
+        const lines = dntShim.Deno.stdin.readable
+            .pipeThrough(new TextDecoderStream())
+            .pipeThrough(new TextLineStream());
+        for await (const line of lines) {
+            const trimmed = line.trim();
+            if (!trimmed)
+                continue;
+            if (trimmed === '/exit') {
+                console.error('\n再见！');
+                break;
+            }
+            if (trimmed === '/clear') {
+                this.messages = [];
+                console.error('上下文已清空');
+                continue;
+            }
+            // 在 stderr 显示用户输入（不影响 stdout 的纯 AI 输出）
+            console.error(`\n❯ ${trimmed}\n`);
+            try {
+                await this.chatStream(trimmed, (chunk) => {
+                    dntShim.Deno.stdout.writeSync(encoder.encode(chunk));
+                });
+                console.error('\n---');
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                console.error(`\n[错误] ${message}`);
+            }
+        }
+    }
+    /** 清空对话上下文 */
+    clearContext() {
+        this.messages = [];
+    }
+    /** 获取当前对话历史 */
+    getMessages() {
+        return this.messages;
+    }
+}