npm - autosnippet - Versions diffs - 3.1.15 → 3.2.2 - Mend

autosnippet 3.1.15 → 3.2.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (41) hide show

package/README.md +1 -0
package/bin/cli.js +242 -23
package/dashboard/dist/assets/{icons-CC5R_iwL.js → icons-18VxiaCT.js} +108 -98
package/dashboard/dist/assets/index-BJiuaVPD.css +1 -0
package/dashboard/dist/assets/{index-WmnJCXq4.js → index-CRH5Umim.js} +50 -50
package/dashboard/dist/index.html +3 -3
package/lib/cli/SetupService.js +152 -21
package/lib/domain/task/Task.js +214 -0
package/lib/domain/task/TaskDependency.js +48 -0
package/lib/domain/task/TaskIdGenerator.js +83 -0
package/lib/domain/task/index.js +6 -0
package/lib/external/mcp/McpServer.js +4 -4
package/lib/external/mcp/handlers/task.js +295 -0
package/lib/external/mcp/tools.js +100 -3
package/lib/http/HttpServer.js +8 -0
package/lib/http/routes/guard.js +283 -0
package/lib/http/routes/task.js +282 -0
package/lib/infrastructure/config/Paths.js +18 -8
package/lib/infrastructure/database/migrations/002_add_tasks.js +88 -0
package/lib/injection/ServiceContainer.js +58 -0
package/lib/repository/task/TaskRepository.impl.js +398 -0
package/lib/service/cursor/AgentInstructionsGenerator.js +28 -9
package/lib/service/cursor/CursorDeliveryPipeline.js +42 -20
package/lib/service/cursor/KnowledgeCompressor.js +40 -0
package/lib/service/cursor/TokenBudget.js +2 -2
package/lib/service/guard/GuardFeedbackLoop.js +17 -2
package/lib/service/knowledge/KnowledgeService.js +6 -0
package/lib/service/task/TaskGraphService.js +410 -0
package/lib/service/task/TaskKnowledgeBridge.js +86 -0
package/lib/service/task/TaskReadyEngine.js +127 -0
package/lib/shared/constants.js +3 -3
package/package.json +1 -1
package/skills/autosnippet-intent/SKILL.md +4 -1
package/skills/autosnippet-recipes/SKILL.md +17 -2
package/templates/claude-hooks.yaml +19 -0
package/templates/copilot-instructions.md +33 -1
package/templates/cursor-rules/autosnippet-conventions.mdc +12 -0
package/templates/cursor-rules/autosnippet-workflow.mdc +43 -0
package/templates/guard-ci.yml +1 -0
package/templates/pre-commit-guard.sh +2 -1
package/dashboard/dist/assets/index-6iola4rb.css +0 -1

package/dashboard/dist/index.html CHANGED Viewed

@@ -5,13 +5,13 @@
     <link rel="icon" type="image/svg+xml" href="/vite.svg" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <title>AutoSnippet Dashboard</title>
-    <script type="module" crossorigin src="/assets/index-WmnJCXq4.js"></script>
+    <script type="module" crossorigin src="/assets/index-CRH5Umim.js"></script>
     <link rel="modulepreload" crossorigin href="/assets/yaml-qRaU8Ldn.js">
     <link rel="modulepreload" crossorigin href="/assets/vendor-Ck-HBmg5.js">
     <link rel="modulepreload" crossorigin href="/assets/axios-C0Zqfgkc.js">
-    <link rel="modulepreload" crossorigin href="/assets/icons-CC5R_iwL.js">
+    <link rel="modulepreload" crossorigin href="/assets/icons-18VxiaCT.js">
     <link rel="modulepreload" crossorigin href="/assets/framer-motion-DOATyqla.js">
-    <link rel="stylesheet" crossorigin href="/assets/index-6iola4rb.css">
+    <link rel="stylesheet" crossorigin href="/assets/index-BJiuaVPD.css">
   </head>
   <body>
     <div id="root"></div>

package/lib/cli/SetupService.js CHANGED Viewed

@@ -5,7 +5,8 @@
  *
  *   Step 1  .autosnippet/ 运行时目录 + config.json + .gitignore
  *   Step 2  AutoSnippet/ 子仓库（核心数据 + 权限能力 + skills/）
- *   Step 3  IDE 集成（VSCode MCP + Cursor MCP + copilot-instructions + cursor-rules + skills-template）
+ *   Step 3  IDE 集成（VSCode MCP + Cursor MCP + copilot-instructions + cursor-rules
+ *           + skills-template + cursor-workflow + claude-hooks + guard-ci + pre-commit-hook）
  *   Step 4  SQLite 数据库 + V1 数据迁移
  *   Step 5  平台相关初始化（macOS → Xcode Snippets）
  *
@@ -432,24 +433,26 @@ export class SetupService {
   /* ═══ Step 3: IDE 集成 ═══════════════════════════════ */
   stepIDE() {
+    const configured = [];
+    // MCP 配置（总是写入/合并，不会跳过）
     this._configureVSCodeMCP();
+    configured.push('vscode-mcp');
     this._configureCursorMCP();
-    this._copyCopilotInstructions();
-    this._generateAgentInstructionFiles();
-    this._copyCursorRules();
-    this._copySkillsTemplate();
+    configured.push('cursor-mcp');
+    // 模板文件（可能因已存在/用户文件而跳过）
+    if (this._copyCopilotInstructions()) configured.push('copilot-instructions');
+    if (this._generateAgentInstructionFiles()) configured.push('agent-instructions');
+    if (this._copyCursorRules()) configured.push('cursor-rules');
+    if (this._copySkillsTemplate()) configured.push('skills-template');
+    if (this._copyCursorWorkflow()) configured.push('cursor-workflow');
+    if (this._copyClaudeHooks()) configured.push('claude-hooks');
+    if (this._copyGuardCI()) configured.push('guard-ci');
+    if (this._installPreCommitHook()) configured.push('pre-commit-hook');
     // NOTE: .qoder/ .trae/ 不再自动创建，用户可通过 `asd mirror` 按需生成
     const extResult = this._installVSCodeExtension();
-    const configured = [
-      'vscode-mcp',
-      'cursor-mcp',
-      'copilot-instructions',
-      'agent-instructions',
-      'cursor-rules',
-      'skills-template',
-    ];
     if (extResult) {
       configured.push(...extResult);
     }
@@ -711,23 +714,24 @@ export class SetupService {
   _copyCopilotInstructions() {
     const src = join(REPO_ROOT, 'templates', 'copilot-instructions.md');
     if (!existsSync(src)) {
-      return;
+      return false;
     }
     const destDir = join(this.projectRoot, '.github');
     const dest = join(destDir, 'copilot-instructions.md');
     if (existsSync(dest) && !this.force) {
-      return;
+      return false;
     }
     // 即使 --force，也不覆盖用户原有的非 AutoSnippet 文件
     const { canWrite } = checkWriteSafety(dest);
     if (!canWrite) {
-      return;
+      return false;
     }
     mkdirSync(destDir, { recursive: true });
     copyFileSync(src, dest);
+    return true;
   }
   /**
@@ -737,6 +741,7 @@ export class SetupService {
    */
   _generateAgentInstructionFiles() {
     const projectName = this.projectRoot.split('/').pop();
+    let wrote = false;
     // AGENTS.md
     const agentsPath = join(this.projectRoot, 'AGENTS.md');
@@ -771,6 +776,7 @@ export class SetupService {
           '',
         ].join('\n');
         writeFileSync(agentsPath, agentsContent);
+        wrote = true;
       } else {
       }
     }
@@ -803,44 +809,169 @@ export class SetupService {
           '',
         ].join('\n');
         writeFileSync(claudePath, claudeContent);
+        wrote = true;
       } else {
       }
     }
+    return wrote;
   }
   /** @private .cursor/rules/autosnippet-conventions.mdc */
   _copyCursorRules() {
     const src = join(REPO_ROOT, 'templates', 'cursor-rules', 'autosnippet-conventions.mdc');
     if (!existsSync(src)) {
-      return;
+      return false;
     }
     const destDir = join(this.projectRoot, '.cursor', 'rules');
     const dest = join(destDir, 'autosnippet-conventions.mdc');
     if (existsSync(dest) && !this.force) {
-      return;
+      return false;
     }
     mkdirSync(destDir, { recursive: true });
     copyFileSync(src, dest);
+    return true;
   }
   /** @private .cursor/rules/autosnippet-skills.mdc — Project Skills 索引模板 */
   _copySkillsTemplate() {
     const src = join(REPO_ROOT, 'templates', 'cursor-rules', 'autosnippet-skills.mdc');
     if (!existsSync(src)) {
-      return;
+      return false;
     }
     const destDir = join(this.projectRoot, '.cursor', 'rules');
     const dest = join(destDir, 'autosnippet-skills.mdc');
     if (existsSync(dest) && !this.force) {
-      return;
+      return false;
+    }
+    mkdirSync(destDir, { recursive: true });
+    copyFileSync(src, dest);
+    return true;
+  }
+  /** @private .cursor/rules/autosnippet-workflow.mdc — TaskGraph & Guard 工作流 */
+  _copyCursorWorkflow() {
+    const src = join(REPO_ROOT, 'templates', 'cursor-rules', 'autosnippet-workflow.mdc');
+    if (!existsSync(src)) {
+      return false;
+    }
+    const destDir = join(this.projectRoot, '.cursor', 'rules');
+    const dest = join(destDir, 'autosnippet-workflow.mdc');
+    if (existsSync(dest) && !this.force) {
+      return false;
+    }
+    mkdirSync(destDir, { recursive: true });
+    copyFileSync(src, dest);
+    return true;
+  }
+  /**
+   * @private .claude/hooks.yaml — Claude Code SessionStart hook
+   * 会话开始时自动 prime TaskGraph 上下文
+   */
+  _copyClaudeHooks() {
+    const src = join(REPO_ROOT, 'templates', 'claude-hooks.yaml');
+    if (!existsSync(src)) {
+      return false;
+    }
+    const claudeDir = join(this.projectRoot, '.claude');
+    const dest = join(claudeDir, 'hooks.yaml');
+    if (existsSync(dest) && !this.force) {
+      return false;
+    }
+    // 即使 --force，也不覆盖用户自己的 hooks 文件
+    const { canWrite } = checkWriteSafety(dest);
+    if (!canWrite) {
+      return false;
+    }
+    mkdirSync(claudeDir, { recursive: true });
+    copyFileSync(src, dest);
+    return true;
+  }
+  /**
+   * @private .github/workflows/autosnippet-guard.yml — Guard CI/CD workflow
+   * 在 push/PR 时自动运行 Guard 合规检查
+   */
+  _copyGuardCI() {
+    const src = join(REPO_ROOT, 'templates', 'guard-ci.yml');
+    if (!existsSync(src)) {
+      return false;
+    }
+    const destDir = join(this.projectRoot, '.github', 'workflows');
+    const dest = join(destDir, 'autosnippet-guard.yml');
+    if (existsSync(dest) && !this.force) {
+      return false;
+    }
+    const { canWrite } = checkWriteSafety(dest);
+    if (!canWrite) {
+      return false;
     }
     mkdirSync(destDir, { recursive: true });
     copyFileSync(src, dest);
+    return true;
   }
+  /**
+   * @private .git/hooks/pre-commit — Guard pre-commit hook
+   * 如果项目使用 husky，则安装到 .husky/pre-commit
+   * 否则安装到 .git/hooks/pre-commit
+   * 已存在 pre-commit hook 时不覆盖（避免破坏用户现有 hook）
+   */
+  _installPreCommitHook() {
+    const src = join(REPO_ROOT, 'templates', 'pre-commit-guard.sh');
+    if (!existsSync(src)) {
+      return false;
+    }
+    // 优先检查 husky
+    const huskyDir = join(this.projectRoot, '.husky');
+    const gitHooksDir = join(this.projectRoot, '.git', 'hooks');
+    let dest;
+    if (existsSync(huskyDir)) {
+      // 项目使用 husky — 安装到 .husky/pre-commit
+      dest = join(huskyDir, 'pre-commit');
+    } else if (existsSync(join(this.projectRoot, '.git'))) {
+      // 普通 git 项目 — 安装到 .git/hooks/pre-commit
+      dest = join(gitHooksDir, 'pre-commit');
+      mkdirSync(gitHooksDir, { recursive: true });
+    } else {
+      // 非 git 项目，跳过
+      return false;
+    }
+    // 已存在 pre-commit hook 时不覆盖（可能是用户自己的 hook）
+    if (existsSync(dest) && !this.force) {
+      return false;
+    }
+    // 即使 --force，也不覆盖用户自己的 pre-commit hook
+    const { canWrite } = checkWriteSafety(dest);
+    if (!canWrite) {
+      return false;
+    }
+    copyFileSync(src, dest);
+    // 确保可执行
+    try {
+      execSync(`chmod +x "${dest}"`, { stdio: 'pipe' });
+    } catch {
+      /* Windows 不需要 chmod */
+    }
+    return true;
+  }
   /** @private 镜像 .cursor/rules/ 中的 autosnippet-* 文件到目标 IDE 目录（Qoder / Trae 兼容）
    *  只复制 autosnippet- 前缀的文件，不触碰用户自己创建的规则 */
   _mirrorCursorToIDE(targetDirName) {

package/lib/domain/task/Task.js ADDED Viewed

@@ -0,0 +1,214 @@
+import { createHash } from 'node:crypto';
+/**
+ * Task — 任务实体
+ *
+ * 参考 Beads Issue 结构，裁剪为 AutoSnippet 所需的核心字段。
+ *
+ * 字段分组：
+ *   Core Identification → id, parentId, contentHash
+ *   Content             → title, description, design, acceptance
+ *   Status & Workflow   → status, priority, taskType
+ *   Assignment          → assignee, claimedAt
+ *   Timestamps          → createdAt, updatedAt, closedAt
+ *   Knowledge Bridge    → knowledgeContext (运行时，不持久化)
+ */
+export class Task {
+  constructor(props = {}) {
+    // ── Core Identification ──
+    this.id = props.id || null;
+    this.parentId = props.parentId || null;
+    this.childSeq = props.childSeq || 0;
+    // ── Content ──
+    this.title = props.title || '';
+    this.description = props.description || '';
+    this.design = props.design || '';
+    this.acceptance = props.acceptance || '';
+    this.notes = props.notes || '';
+    // ── Status & Workflow ──
+    this.status = props.status || 'open';
+    this.priority = props.priority ?? 2;
+    this.taskType = props.taskType || 'task';
+    this.closeReason = props.closeReason || '';
+    this.failCount = props.failCount || 0;
+    this.lastFailReason = props.lastFailReason || '';
+    // ── Content Hash (去重) ──
+    this.contentHash = props.contentHash || null;
+    // ── Assignment ──
+    this.assignee = props.assignee || '';
+    this.createdBy = props.createdBy || 'agent';
+    // ── Timestamps ──
+    this.createdAt = props.createdAt || Math.floor(Date.now() / 1000);
+    this.updatedAt = props.updatedAt || Math.floor(Date.now() / 1000);
+    this.closedAt = props.closedAt || null;
+    // ── Knowledge Bridge (运行时填充, 不持久化) ──
+    this.knowledgeContext = props.knowledgeContext || null;
+    // ── Metadata (可扩展 JSON) ──
+    this.metadata = props.metadata || {};
+  }
+  // ── 生命周期方法 ──
+  claim(assignee = 'agent') {
+    if (this.status === 'closed') {
+      throw new Error('Cannot claim a closed task');
+    }
+    this.status = 'in_progress';
+    this.assignee = assignee;
+    this.updatedAt = Math.floor(Date.now() / 1000);
+  }
+  close(reason = 'Completed') {
+    this.status = 'closed';
+    this.closeReason = reason;
+    this.closedAt = Math.floor(Date.now() / 1000);
+    this.updatedAt = this.closedAt;
+  }
+  reopen() {
+    this.status = 'open';
+    this.closedAt = null;
+    this.closeReason = '';
+    this.updatedAt = Math.floor(Date.now() / 1000);
+  }
+  defer(reason = '') {
+    this.status = 'deferred';
+    if (reason) {
+      this.notes = `[deferred] ${reason}`;
+    }
+    this.updatedAt = Math.floor(Date.now() / 1000);
+  }
+  fail(reason) {
+    if (this.status === 'closed') {
+      throw new Error('Cannot fail a closed task');
+    }
+    this.status = 'open';
+    this.failCount += 1;
+    this.lastFailReason = reason || 'Unknown failure';
+    this.assignee = '';
+    this.updatedAt = Math.floor(Date.now() / 1000);
+  }
+  /**
+   * 计算内容哈希（用于去重检测）
+   * 相同标题+描述+类型 = 重复任务
+   */
+  computeContentHash() {
+    const content = `${this.title}|${this.description}|${this.taskType}`;
+    this.contentHash = createHash('sha256').update(content).digest('hex').substring(0, 12);
+    return this.contentHash;
+  }
+  // ── 校验 ──
+  validate() {
+    if (!this.title || this.title.length === 0) {
+      throw new Error('title is required');
+    }
+    if (this.title.length > 500) {
+      throw new Error(`title must be 500 characters or less (got ${this.title.length})`);
+    }
+    if (typeof this.priority !== 'number' || !Number.isInteger(this.priority) || this.priority < 0 || this.priority > 4) {
+      throw new Error(`priority must be an integer between 0 and 4 (got ${this.priority})`);
+    }
+    const validStatuses = ['open', 'in_progress', 'deferred', 'closed'];
+    if (!validStatuses.includes(this.status)) {
+      throw new Error(`invalid status: ${this.status}`);
+    }
+    const validTypes = ['epic', 'task', 'bug', 'chore'];
+    if (!validTypes.includes(this.taskType)) {
+      throw new Error(`invalid task type: ${this.taskType}`);
+    }
+    if (this.status === 'closed' && !this.closedAt) {
+      throw new Error('closed tasks must have closedAt timestamp');
+    }
+    return true;
+  }
+  /**
+   * 是否有效（快捷校验）
+   */
+  isValid() {
+    try {
+      this.validate();
+      return true;
+    } catch {
+      return false;
+    }
+  }
+  toJSON() {
+    return {
+      id: this.id,
+      parentId: this.parentId,
+      title: this.title,
+      description: this.description,
+      design: this.design,
+      acceptance: this.acceptance,
+      notes: this.notes,
+      status: this.status,
+      priority: this.priority,
+      taskType: this.taskType,
+      closeReason: this.closeReason,
+      assignee: this.assignee,
+      createdBy: this.createdBy,
+      createdAt: this.createdAt,
+      updatedAt: this.updatedAt,
+      closedAt: this.closedAt,
+      contentHash: this.contentHash,
+      failCount: this.failCount,
+      lastFailReason: this.lastFailReason,
+      metadata: this.metadata,
+      ...(this.knowledgeContext ? { knowledgeContext: this.knowledgeContext } : {}),
+    };
+  }
+  static fromJSON(data) {
+    if (!data) return new Task();
+    return new Task(data);
+  }
+  /**
+   * 从数据库行构造 Task（snake_case → camelCase）
+   */
+  static fromRow(row) {
+    if (!row) return null;
+    return new Task({
+      id: row.id,
+      parentId: row.parent_id,
+      childSeq: row.child_seq,
+      title: row.title,
+      description: row.description,
+      design: row.design,
+      acceptance: row.acceptance,
+      notes: row.notes,
+      status: row.status,
+      priority: row.priority,
+      taskType: row.task_type,
+      closeReason: row.close_reason,
+      contentHash: row.content_hash,
+      failCount: row.fail_count,
+      lastFailReason: row.last_fail_reason,
+      assignee: row.assignee,
+      createdBy: row.created_by,
+      createdAt: row.created_at,
+      updatedAt: row.updated_at,
+      closedAt: row.closed_at,
+      metadata: (() => {
+        if (typeof row.metadata !== 'string') return row.metadata || {};
+        try { return JSON.parse(row.metadata); } catch { return {}; }
+      })(),
+    });
+  }
+}
+export default Task;

package/lib/domain/task/TaskDependency.js ADDED Viewed

@@ -0,0 +1,48 @@
+/**
+ * 任务依赖类型
+ *
+ * Phase 1 引入 6 种核心依赖类型，按 "是否影响就绪" 分为两组。
+ *
+ *   阻塞型: blocks, waits-for        → 影响 ready 计算
+ *   结构型: parent-child              → 仅层次关系
+ *   关联型: discovered-from, related, knowledge-ref → 不影响 ready
+ */
+export const DepType = Object.freeze({
+  // ── 阻塞型（影响 ready 计算）──
+  BLOCKS: 'blocks',
+  WAITS_FOR: 'waits-for',
+  // ── 结构型（建立层次，不影响 ready）──
+  PARENT_CHILD: 'parent-child',
+  // ── 关联型（不影响 ready，构建知识/因果图谱）──
+  DISCOVERED_FROM: 'discovered-from',
+  RELATED: 'related',
+  KNOWLEDGE_REF: 'knowledge-ref', // AutoSnippet 独有：关联知识条目
+});
+/** 所有合法的依赖类型值列表 */
+const ALL_DEP_TYPES = Object.values(DepType);
+/** 影响就绪计算的依赖类型集合 */
+const BLOCKING_TYPES = new Set([DepType.BLOCKS, DepType.WAITS_FOR]);
+/**
+ * 判断依赖类型是否影响就绪计算
+ * @param {string} depType
+ * @returns {boolean}
+ */
+export function affectsReadyWork(depType) {
+  return BLOCKING_TYPES.has(depType);
+}
+/**
+ * 判断依赖类型是否合法
+ * @param {string} depType
+ * @returns {boolean}
+ */
+export function isValidDepType(depType) {
+  return ALL_DEP_TYPES.includes(depType);
+}
+export default DepType;

package/lib/domain/task/TaskIdGenerator.js ADDED Viewed

@@ -0,0 +1,83 @@
+import { createHash } from 'node:crypto';
+import { v4 as uuidv4 } from 'uuid';
+/**
+ * TaskIdGenerator — 短 Hash ID 生成器
+ *
+ * 渐进式长度扩展（随任务数增长自动加长）：
+ *   0-500 tasks  → 4 字符  (16^4 = 65,536 组合)
+ *   500-1500     → 5 字符  (16^5 = 1,048,576)
+ *   1500+        → 6 字符  (16^6 = 16,777,216)
+ *
+ * 前缀 'asd-'，与 Beads 的 'bd-' 区分。
+ */
+export class TaskIdGenerator {
+  /**
+   * @param {import('better-sqlite3').Database} db — raw SQLite handle
+   */
+  constructor(db) {
+    this._db = db;
+    this._prefix = 'asd';
+  }
+  /**
+   * 生成新的短 Hash ID
+   * @returns {string} 如 'asd-a1b2'
+   */
+  generate() {
+    const taskCount = this._getTaskCount();
+    const hashLen = taskCount < 500 ? 4 : taskCount < 1500 ? 5 : 6;
+    // 尝试生成无冲突 ID（最多 10 次）
+    for (let attempt = 0; attempt < 10; attempt++) {
+      const uuid = uuidv4();
+      const hash = createHash('sha256').update(uuid).digest('hex');
+      const shortHash = hash.substring(0, hashLen);
+      const id = `${this._prefix}-${shortHash}`;
+      if (!this._exists(id)) {
+        return id;
+      }
+    }
+    // 回退到 6 位 + 冲突检查 + 终极 8 位兜底
+    const uuid = uuidv4();
+    const hash = createHash('sha256').update(uuid).digest('hex');
+    const fallbackId = `${this._prefix}-${hash.substring(0, 6)}`;
+    if (!this._exists(fallbackId)) return fallbackId;
+    return `${this._prefix}-${hash.substring(0, 8)}`;
+  }
+  /**
+   * 生成子任务 ID
+   * asd-a3f8 → asd-a3f8.1, asd-a3f8.2, ...
+   * @param {string} parentId
+   * @returns {string}
+   */
+  generateChild(parentId) {
+    const parent = this._db.prepare('SELECT child_seq FROM tasks WHERE id = ?').get(parentId);
+    if (!parent) {
+      throw new Error(`Parent task not found: ${parentId}`);
+    }
+    const nextSeq = (parent.child_seq || 0) + 1;
+    this._db.prepare('UPDATE tasks SET child_seq = ? WHERE id = ?').run(nextSeq, parentId);
+    return `${parentId}.${nextSeq}`;
+  }
+  /** @private */
+  _getTaskCount() {
+    const row = this._db.prepare('SELECT COUNT(*) as cnt FROM tasks').get();
+    return row?.cnt || 0;
+  }
+  /** @private */
+  _exists(id) {
+    const row = this._db.prepare('SELECT 1 FROM tasks WHERE id = ?').get(id);
+    return !!row;
+  }
+}
+export default TaskIdGenerator;

package/lib/domain/task/index.js ADDED Viewed

@@ -0,0 +1,6 @@
+/**
+ * Task Domain — 统一导出
+ */
+export { Task } from './Task.js';
+export { DepType, affectsReadyWork, isValidDepType } from './TaskDependency.js';
+export { TaskIdGenerator } from './TaskIdGenerator.js';

package/lib/external/mcp/McpServer.js CHANGED Viewed

@@ -4,7 +4,7 @@
  * Model Context Protocol (stdio transport)
  * 提供给 IDE AI Agent (Cursor/VSCode Copilot) 的工具集
  *
- * V3.1 整合：39 → 19 工具（15 agent + 4 admin）
+ * V3.1 整合：39 → 20 工具（16 agent + 4 admin）
  * 通过 ASD_MCP_TIER 环境变量控制可见工具集（agent/admin）
  *
  * 冷启动双路径:
@@ -38,8 +38,7 @@ import * as systemHandlers from './handlers/system.js';
 // ─── External Agent Bootstrap 新 handler ──────────────────────
 import { bootstrapExternal } from './handlers/bootstrap-external.js';
-import { dimensionComplete } from './handlers/dimension-complete-external.js';
-import { wikiFinalize, wikiPlan } from './handlers/wiki-external.js';
+import { dimensionComplete } from './handlers/dimension-complete-external.js';import { taskHandler } from './handlers/task.js';import { wikiFinalize, wikiPlan } from './handlers/wiki-external.js';
 // ─── McpServer 类 ─────────────────────────────────────────────
@@ -180,7 +179,7 @@ export class McpServer {
    */
   _resolveHandler(name) {
     const HANDLER_MAP = {
-      // ── Agent 层 (15) ──
+      // ── Agent 层 (16) ──
       autosnippet_health: (ctx) => systemHandlers.health(ctx),
       autosnippet_capabilities: () => systemHandlers.capabilities(),
       autosnippet_search: (ctx, args) => consolidated.consolidatedSearch(ctx, args),
@@ -193,6 +192,7 @@ export class McpServer {
         knowledgeHandlers.submitKnowledgeBatch(ctx, args),
       autosnippet_save_document: (ctx, args) => knowledgeHandlers.saveDocument(ctx, args),
       autosnippet_skill: (ctx, args) => consolidated.consolidatedSkill(ctx, args),
+      autosnippet_task: (ctx, args) => taskHandler(ctx, args),
       // ── External Agent Bootstrap (v3.1) ──
       autosnippet_bootstrap: (ctx, _args) => bootstrapExternal(ctx),
       autosnippet_dimension_complete: (ctx, args) => dimensionComplete(ctx, args),