zapmyco 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 shenjingnan
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,149 @@
+# ai-typescript-starter
+
+[![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 原生的 TypeScript 启动模板，专为 AI 辅助开发时代打造。
+
+## 特性
+
+- **现代技术栈**: 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/your-username/your-project.git
+cd your-project
+
+# 安装依赖
+pnpm install
+```
+
+### 开发
+
+```bash
+# 开发模式
+pnpm run dev
+
+# 构建
+pnpm run build
+
+# 测试
+pnpm run test
+
+# 代码检查
+pnpm run lint
+
+# 类型检查
+pnpm run typecheck
+
+# 完整检查
+pnpm run check
+```
+
+## 项目结构
+
+```
+ai-typescript-starter/
+├── .claude/              # Claude Code 配置
+│   ├── commands/         # Slash 命令
+│   └── skills/           # 技能定义
+├── .github/              # GitHub 配置
+│   ├── workflows/        # CI/CD 工作流
+│   └── ISSUE_TEMPLATE/   # Issue 模板
+├── docs/                 # 文档
+├── examples/             # 示例代码
+├── src/                  # 源代码
+│   └── __tests__/        # 测试文件
+├── AGENTS.md             # AI Agent 配置
+└── dist/                 # 构建产物
+```
+
+## 可用脚本
+
+| 命令 | 说明 |
+|------|------|
+| `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 工程约束：
+
+### CLAUDE.md
+
+为 Claude Code 提供项目上下文和开发规范。
+
+### .claude/ 目录
+
+- `commands/` - 自定义 Slash 命令 (`/build`, `/test`, `/lint`, `/typecheck`, `/spellcheck`, `/release`, `/commit-push-pr`)
+- `skills/` - 项目技能定义 (`resolve-git-conflicts`, `fix-audit`, `project-context`, `update-readme`)
+
+## 代码风格
+
+- 2 空格缩进
+- 单引号
+- 必须有分号
+- 行宽 100 字符
+- 禁止 `any` 类型 (warn)
+
+## 测试规范
+
+- 测试文件放在 `src/__tests__/` 目录
+- 测试覆盖率阈值: 80%
+- 使用 Vitest 全局 API
+
+## 发布流程
+
+本项目使用 [release-it](https://github.com/release-it/release-it) 进行版本管理：
+
+```bash
+pnpm run release
+```
+
+发布过程会自动：
+1. 更新版本号
+2. 更新 CHANGELOG.md
+3. 创建 Git tag
+4. 推送到远程仓库
+5. 创建 GitHub Release
+
+## 文档
+
+- [架构文档](docs/architecture.md)
+- [API 文档](docs/api.md)
+- [贡献指南](docs/contributing.md)
+
+## 许可证
+
+[MIT](LICENSE) © 2026 shenjingnan

package/dist/agent-PR6zGvgA.d.mts

@@ -0,0 +1,323 @@
+import { EventEmitter } from "node:events";
+
+//#region src/core/result/types.d.ts
+/**
+ * 结果整合器类型定义
+ *
+ * 定义 Agent 执行结果的数据结构和最终输出格式。
+ */
+/** 制品类型 */
+type ArtifactType = 'pull-request' | 'file' | 'report' | 'comment' | 'url';
+/**
+ * 制品（Agent 执行产生的有价值的产出）
+ *
+ * 例如：创建的 PR、生成的文件、分析报告等。
+ */
+interface Artifact {
+  /** 制品类型 */
+  type: ArtifactType;
+  /** 制品引用（URL 或文件路径） */
+  reference: string;
+  /** 制品描述 */
+  description: string;
+}
+/** Token 使用量统计 */
+interface TokenUsage {
+  inputTokens: number;
+  outputTokens: number;
+  totalTokens: number;
+  /** 估算成本（美元） */
+  estimatedCostUsd: number;
+}
+/** 任务错误信息 */
+interface TaskError {
+  code: string;
+  message: string;
+  retryable: boolean;
+  details?: Record<string, unknown>;
+}
+/**
+ * 单个子任务的执行结果
+ *
+ * 每个 Agent 完成任务后返回此对象。
+ */
+interface TaskResult {
+  /** 任务 ID */
+  taskId: string;
+  /** 执行状态 */
+  status: 'success' | 'failure' | 'partial';
+  /** 结构化输出 */
+  output: unknown;
+  /** 产生的制品列表 */
+  artifacts: Artifact[];
+  /** 执行耗时（毫秒） */
+  duration: number;
+  /** Token 消耗统计 */
+  tokenUsage: TokenUsage;
+  /** 错误信息（如果失败） */
+  error?: TaskError;
+}
+/**
+ * 最终整合结果
+ *
+ * 结果整合器将所有子任务的 TaskResult 合并为用户可理解的最终输出。
+ */
+interface FinalResult {
+  /** 关联的 Goal ID */
+  goalId: string;
+  /** 整体状态 */
+  overallStatus: 'success' | 'partial-failure' | 'failure';
+  /** 人类可读的摘要（LLM 生成或模板化拼接） */
+  summary: string;
+  /** 各子任务结果 */
+  taskResults: TaskResult[];
+  /** 所有制品汇总 */
+  allArtifacts: Artifact[];
+  /** 总耗时（毫秒） */
+  totalDuration: number;
+  /** 总 Token 消耗 */
+  totalTokenUsage: TokenUsage;
+  /** 后续建议操作 */
+  nextSteps?: string[];
+}
+//#endregion
+//#region src/protocol/capability.d.ts
+/**
+ * Agent 能力声明
+ *
+ * 每个 Agent 通过 Capability 声明自己能做什么类型的任务。
+ * 调度器通过能力匹配将任务分发给合适的 Agent。
+ */
+/** 能力类别 */
+type CapabilityCategory = 'code-generation' | 'code-modification' | 'code-analysis' | 'code-review' | 'security-scan' | 'testing' | 'documentation' | 'research' | 'planning' | 'data-analysis' | 'chat' | 'generic';
+/** Agent 能力声明 */
+interface Capability {
+  /** 能力唯一标识符 */
+  id: string;
+  /** 能力名称 */
+  name: string;
+  /** 能力描述 */
+  description: string;
+  /** 能力类别 */
+  category: CapabilityCategory;
+}
+/** Agent 注册信息 */
+interface AgentRegistration {
+  /** Agent 唯一标识 */
+  agentId: string;
+  /** Agent 显示名称 */
+  displayName: string;
+  /** Agent 声明的能力列表 */
+  capabilities: Capability[];
+  /** Agent 端点 URL（远程 Agent） */
+  endpoint?: string;
+  /** 当前状态 */
+  status: AgentRegistrationStatus;
+  /** 当前负载数 */
+  currentLoad: number;
+  /** 最大并发数 */
+  maxConcurrency: number;
+}
+/** Agent 注册状态 */
+type AgentRegistrationStatus = 'online' | 'offline' | 'busy';
+//#endregion
+//#region src/core/aggregator/types.d.ts
+/**
+ * 进度聚合器类型定义
+ *
+ * 实时收集各 Agent 的进度事件，统一推送给 UI 层。
+ */
+/** 进度事件类型 */
+type ProgressEventType = 'task:started' | 'task:progress' | 'task:output' | 'task:completed' | 'task:failed' | 'task:retrying';
+/** 进度事件载荷 */
+interface ProgressPayload {
+  /** 当前进度 0-100 */
+  percent?: number;
+  /** 当前步骤描述 */
+  message?: string;
+  /** 流式文本片段 */
+  textChunk?: string;
+  /** 错误信息 */
+  error?: string;
+  /** 制品引用（如 PR URL） */
+  artifactUrl?: string;
+}
+/**
+ * 进度事件
+ *
+ * Agent 在执行过程中发出的结构化进度信息。
+ */
+interface ProgressEvent {
+  /** 事件 ID */
+  eventId: string;
+  /** 关联的任务 ID */
+  taskId: string;
+  /** 关联的 Agent ID */
+  agentId: string;
+  /** 事件类型 */
+  type: ProgressEventType;
+  /** 事件时间戳 */
+  timestamp: number;
+  /** 事件载荷 */
+  payload: ProgressPayload;
+}
+//#endregion
+//#region src/core/intent/types.d.ts
+/**
+ * 意图理解引擎类型定义
+ *
+ * 将用户的自然语言输入转化为结构化的 Goal 对象。
+ */
+/** 用户目标的类型 */
+type GoalType = 'code-review' | 'security-audit' | 'bug-fix' | 'feature-dev' | 'refactor' | 'test-generation' | 'doc-generation' | 'research' | 'planning' | 'data-analysis' | 'chat' | 'generic';
+/** 项目上下文（自动收集） */
+interface ProjectContext {
+  /** 项目根目录路径 */
+  rootPath: string;
+  /** 包管理器类型 */
+  packageManager: 'npm' | 'pnpm' | 'yarn' | 'bun' | 'unknown';
+  /** 检测到的框架/技术栈 */
+  techStack: string[];
+  /** git 分支信息 */
+  gitBranch?: string;
+  /** 是否有未提交的更改 */
+  hasUncommittedChanges?: boolean;
+}
+/** 目标约束条件 */
+interface GoalConstraints {
+  /** 最大并行度（覆盖全局配置） */
+  maxParallelism?: number;
+  /** 是否允许修改文件 */
+  allowFileModification?: boolean;
+  /** 是否需要确认后执行 */
+  requireConfirmation?: boolean;
+  /** 超时时间（毫秒） */
+  timeout?: number;
+}
+/**
+ * 结构化目标
+ *
+ * 意图理解引擎的输出，是整个编排管线的输入。
+ */
+interface Goal {
+  /** 目标唯一 ID */
+  id: string;
+  /** 目标类型 */
+  type: GoalType;
+  /** 目标描述（由引擎提炼） */
+  description: string;
+  /** 原始用户输入 */
+  rawInput: string;
+  /** 项目上下文（自动收集） */
+  context: ProjectContext;
+  /** 约束条件 */
+  constraints: GoalConstraints;
+  /** 引擎置信度 (0-1) */
+  confidence: number;
+}
+//#endregion
+//#region src/core/task/types.d.ts
+/** 子任务状态 */
+type TaskStatus = 'pending' | 'ready' | 'running' | 'succeeded' | 'failed' | 'skipped' | 'cancelled';
+/**
+ * 子任务定义
+ *
+ * 任务拆分器的输出单元，代表一个可独立执行的原子工作。
+ */
+interface SubTask {
+  /** 任务 ID */
+  id: string;
+  /** 任务名称（简短，用于显示） */
+  name: string;
+  /** 任务详细描述（发给 Agent 的具体指令） */
+  description: string;
+  /** 所需的 Agent 能力 */
+  requiredCapability: Capability;
+  /** 依赖的任务 ID 列表 */
+  dependencies: string[];
+  /** 任务优先级（数值越小优先级越高） */
+  priority: number;
+  /** 预估 token 消耗（用于成本估算） */
+  estimatedTokens?: number;
+  /** 当前状态 */
+  status: TaskStatus;
+  /** 执行结果（完成后填充） */
+  result?: TaskResult;
+}
+/**
+ * 任务图（DAG）
+ *
+ * 描述子任务之间的依赖关系和执行拓扑。
+ */
+interface TaskGraph {
+  /** 图 ID（关联到 Goal） */
+  goalId: string;
+  /** 所有节点 */
+  nodes: Map<string, SubTask>;
+  /** 有向边：依赖关系（from 依赖 to） */
+  edges: Array<{
+    from: string;
+    to: string;
+  }>;
+  /** 入口节点（无依赖的任务） */
+  entryNodes: string[];
+  /** 拓扑排序后的执行层级（同层可并行） */
+  layers: string[][];
+}
+//#endregion
+//#region src/protocol/agent.d.ts
+/** Agent 执行选项 */
+interface AgentExecuteOptions {
+  /** 超时时间（毫秒） */
+  timeout: number;
+  /** 是否启用详细日志 */
+  verbose: boolean;
+  /** 自定义参数 */
+  params?: Record<string, unknown>;
+}
+/** Agent 执行请求 */
+interface AgentExecuteRequest {
+  /** 任务 ID */
+  taskId: string;
+  /** 任务描述（来自 TaskDecomposer 的具体指令） */
+  taskDescription: string;
+  /** 上游任务的结果（作为上下文，有依赖时传入） */
+  upstreamResults?: TaskResult[];
+  /** 项目工作目录 */
+  workdir: string;
+  /** 执行配置 */
+  options: AgentExecuteOptions;
+}
+/** Agent 状态 */
+type AgentStatus = 'online' | 'offline' | 'busy' | 'degraded';
+/** 健康检查结果 */
+interface AgentHealthStatus {
+  是否健康: boolean;
+  latencyMs: number;
+  version: string;
+  details?: Record<string, unknown>;
+}
+/**
+ * Agent 统一接口 -- 所有 Agent 的契约
+ */
+interface IAgent {
+  readonly agentId: string;
+  readonly displayName: string;
+  readonly capabilities: readonly Capability[];
+  readonly status: AgentStatus;
+  readonly currentLoad: number;
+  execute(request: AgentExecuteRequest): Promise<TaskResult>;
+  cancel(taskId: string): Promise<void>;
+  healthCheck(): Promise<AgentHealthStatus>;
+}
+/**
+ * 支持流式事件的 Agent 接口（推荐实现）
+ */
+interface IStreamingAgent extends IAgent, EventEmitter {
+  readonly EVENT_PROGRESS: 'progress';
+  readonly EVENT_OUTPUT: 'output';
+  readonly EVENT_ERROR: 'error';
+}
+//#endregion
+export { FinalResult as C, TokenUsage as E, ArtifactType as S, TaskResult as T, AgentRegistration as _, IAgent as a, CapabilityCategory as b, TaskGraph as c, GoalConstraints as d, GoalType as f, ProgressPayload as g, ProgressEventType as h, AgentStatus as i, TaskStatus as l, ProgressEvent as m, AgentExecuteRequest as n, IStreamingAgent as o, ProjectContext as p, AgentHealthStatus as r, SubTask as s, AgentExecuteOptions as t, Goal as u, AgentRegistrationStatus as v, TaskError as w, Artifact as x, Capability as y };
+//# sourceMappingURL=agent-PR6zGvgA.d.mts.map

package/dist/agent-PR6zGvgA.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-PR6zGvgA.d.mts","names":[],"sources":["../src/core/result/types.ts","../src/protocol/capability.ts","../src/core/aggregator/types.ts","../src/core/intent/types.ts","../src/core/task/types.ts","../src/protocol/agent.ts"],"mappings":"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"}

package/dist/cli/index.d.mts

@@ -0,0 +1 @@
+export { };