autosnippet 3.2.9 → 3.2.11

package/dist/lib/http/routes/skills.js

@@ -0,0 +1,197 @@
+/**
+ * Skills API 路由
+ * 管理 Agent Skills 的查询、加载和创建（项目级）
+ */
+import express from 'express';
+import { CreateSkillBody, UpdateSkillBody } from '#shared/schemas/http-requests.js';
+import { createSkill, deleteSkill, listSkills, loadSkill, suggestSkills, updateSkill, } from '../../external/mcp/handlers/skill.js';
+import { asyncHandler } from '../middleware/errorHandler.js';
+import { validate } from '../middleware/validate.js';
+const router = express.Router();
+/**
+ * GET /api/v1/skills
+ * 列出所有可用 Skills（内置 + 项目级）
+ */
+router.get('/', asyncHandler(async (_req, res) => {
+    const raw = listSkills();
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        return void res.status(500).json({
+            success: false,
+            error: { code: 'PARSE_ERROR', message: 'Invalid response from listSkills' },
+        });
+    }
+    if (!parsed.success) {
+        return void res.status(500).json(parsed);
+    }
+    res.json({ success: true, data: parsed.data });
+}));
+/**
+ * GET /api/v1/skills/signal-status
+ * 获取 SignalCollector 后台服务状态
+ */
+router.get('/signal-status', asyncHandler(async (_req, res) => {
+    const { _signalCollector } = global;
+    if (!_signalCollector) {
+        return void res.json({
+            success: true,
+            data: { running: false, mode: 'off', snapshot: null },
+        });
+    }
+    res.json({
+        success: true,
+        data: {
+            running: true,
+            mode: _signalCollector.getMode(),
+            snapshot: _signalCollector.getSnapshot(),
+            // 返回 AI 的待处理建议，前端可直接展示
+            suggestions: _signalCollector.getSnapshot().pendingSuggestions || [],
+        },
+    });
+}));
+/**
+ * GET /api/v1/skills/suggest
+ * 基于使用模式分析，推荐创建 Skill
+ */
+router.get('/suggest', asyncHandler(async (req, res) => {
+    const ctx = { container: req.app.locals?.container || null };
+    const raw = await suggestSkills(ctx);
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        return void res.status(500).json({
+            success: false,
+            error: { code: 'PARSE_ERROR', message: 'Invalid response from suggestSkills' },
+        });
+    }
+    if (!parsed.success) {
+        return void res.status(500).json(parsed);
+    }
+    res.json({ success: true, data: parsed.data });
+}));
+/**
+ * GET /api/v1/skills/:name
+ * 加载指定 Skill 的完整文档
+ * Query: ?section=xxx 可只返回指定章节
+ */
+router.get('/:name', asyncHandler(async (req, res) => {
+    const { name } = req.params;
+    const { section } = req.query;
+    const raw = loadSkill(null, {
+        skillName: name,
+        section: section,
+    });
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        return void res.status(500).json({
+            success: false,
+            error: { code: 'PARSE_ERROR', message: 'Invalid response from loadSkill' },
+        });
+    }
+    if (!parsed.success) {
+        const status = parsed.error?.code === 'SKILL_NOT_FOUND' ? 404 : 400;
+        return void res.status(status).json(parsed);
+    }
+    res.json({ success: true, data: parsed.data });
+}));
+/**
+ * POST /api/v1/skills
+ * 创建项目级 Skill
+ * Body: { name, description, content, overwrite? }
+ */
+router.post('/', validate(CreateSkillBody), asyncHandler(async (req, res) => {
+    const { name, description, content, overwrite, createdBy } = req.body;
+    const raw = createSkill(null, {
+        name,
+        description,
+        content,
+        overwrite,
+        createdBy: createdBy || 'manual',
+    });
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        return void res.status(500).json({
+            success: false,
+            error: { code: 'PARSE_ERROR', message: 'Invalid response from createSkill' },
+        });
+    }
+    if (!parsed.success) {
+        const status = parsed.error?.code === 'BUILTIN_CONFLICT'
+            ? 409
+            : parsed.error?.code === 'ALREADY_EXISTS'
+                ? 409
+                : parsed.error?.code === 'INVALID_NAME'
+                    ? 400
+                    : 500;
+        return void res.status(status).json(parsed);
+    }
+    res.status(201).json({ success: true, data: parsed.data });
+}));
+/**
+ * PUT /api/v1/skills/:name
+ * 更新项目级 Skill（description / content）
+ */
+router.put('/:name', validate(UpdateSkillBody), asyncHandler(async (req, res) => {
+    const { name } = req.params;
+    const { description, content } = req.body;
+    const raw = updateSkill(null, { name: name, description, content });
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        return void res.status(500).json({
+            success: false,
+            error: { code: 'PARSE_ERROR', message: 'Invalid response from updateSkill' },
+        });
+    }
+    if (!parsed.success) {
+        const status = parsed.error?.code === 'SKILL_NOT_FOUND'
+            ? 404
+            : parsed.error?.code === 'BUILTIN_PROTECTED'
+                ? 403
+                : 500;
+        return void res.status(status).json(parsed);
+    }
+    res.json({ success: true, data: parsed.data });
+}));
+/**
+ * DELETE /api/v1/skills/:name
+ * 删除项目级 Skill
+ */
+router.delete('/:name', asyncHandler(async (req, res) => {
+    const { name } = req.params;
+    const raw = deleteSkill(null, { name: name });
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        return void res.status(500).json({
+            success: false,
+            error: { code: 'PARSE_ERROR', message: 'Invalid response from deleteSkill' },
+        });
+    }
+    if (!parsed.success) {
+        const status = parsed.error?.code === 'SKILL_NOT_FOUND'
+            ? 404
+            : parsed.error?.code === 'BUILTIN_PROTECTED'
+                ? 403
+                : 500;
+        return void res.status(status).json(parsed);
+    }
+    res.json({ success: true, data: parsed.data });
+}));
+export default router;
+//# sourceMappingURL=skills.js.map

package/dist/lib/http/routes/skills.js.map

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

package/dist/lib/http/routes/snippets.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Snippets API 路由
+ * Snippet = Recipe 的附属产物，从 Recipe 实时生成，不存 DB
+ */
+declare const router: import("express-serve-static-core").Router;
+export default router;
+//# sourceMappingURL=snippets.d.ts.map

package/dist/lib/http/routes/snippets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snippets.d.ts","sourceRoot":"","sources":["../../../../lib/http/routes/snippets.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,QAAA,MAAM,MAAM,4CAAmB,CAAC;AAuDhC,eAAe,MAAM,CAAC"}

package/dist/lib/http/routes/snippets.js

@@ -0,0 +1,51 @@
+/**
+ * Snippets API 路由
+ * Snippet = Recipe 的附属产物，从 Recipe 实时生成，不存 DB
+ */
+import express from 'express';
+import { getServiceContainer } from '../../injection/ServiceContainer.js';
+import { NotFoundError } from '../../shared/errors/index.js';
+import { asyncHandler } from '../middleware/errorHandler.js';
+const router = express.Router();
+/**
+ * GET /api/v1/snippets
+ * 从 Recipe 实时生成 Snippet 列表
+ */
+router.get('/', asyncHandler(async (req, res) => {
+    const container = getServiceContainer();
+    const snippetFactory = container.get('snippetFactory');
+    const { language, category, keyword } = req.query;
+    const filters = {};
+    if (language) {
+        filters.language = String(language);
+    }
+    if (category) {
+        filters.category = String(category);
+    }
+    if (keyword) {
+        filters.keyword = String(keyword);
+    }
+    const snippets = await snippetFactory.listSnippets(filters);
+    res.json({
+        success: true,
+        data: {
+            snippets,
+            total: snippets.length,
+        },
+    });
+}));
+/**
+ * GET /api/v1/snippets/:id
+ * 从单个 Recipe 实时生成 Snippet
+ */
+router.get('/:id', asyncHandler(async (req, res) => {
+    const container = getServiceContainer();
+    const snippetFactory = container.get('snippetFactory');
+    const snippet = await snippetFactory.getSnippet(req.params.id);
+    if (!snippet) {
+        throw new NotFoundError('Snippet (recipe)', req.params.id);
+    }
+    res.json({ success: true, data: snippet });
+}));
+export default router;
+//# sourceMappingURL=snippets.js.map

package/dist/lib/http/routes/snippets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snippets.js","sourceRoot":"","sources":["../../../../lib/http/routes/snippets.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,OAAwC,MAAM,SAAS,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAE7D,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;AAEhC;;;GAGG;AACH,MAAM,CAAC,GAAG,CACR,GAAG,EACH,YAAY,CAAC,KAAK,EAAE,GAAY,EAAE,GAAa,EAAE,EAAE;IACjD,MAAM,SAAS,GAAG,mBAAmB,EAAE,CAAC;IACxC,MAAM,cAAc,GAAG,SAAS,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;IAEvD,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC;IAClD,MAAM,OAAO,GAA2B,EAAE,CAAC;IAC3C,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;IACtC,CAAC;IACD,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;IACtC,CAAC;IACD,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IACpC,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;IAE5D,GAAG,CAAC,IAAI,CAAC;QACP,OAAO,EAAE,IAAI;QACb,IAAI,EAAE;YACJ,QAAQ;YACR,KAAK,EAAE,QAAQ,CAAC,MAAM;SACvB;KACF,CAAC,CAAC;AACL,CAAC,CAAC,CACH,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,GAAG,CACR,MAAM,EACN,YAAY,CAAC,KAAK,EAAE,GAAY,EAAE,GAAa,EAAE,EAAE;IACjD,MAAM,SAAS,GAAG,mBAAmB,EAAE,CAAC;IACxC,MAAM,cAAc,GAAG,SAAS,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;IAEvD,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC/D,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,aAAa,CAAC,kBAAkB,EAAE,GAAG,CAAC,MAAM,CAAC,EAAY,CAAC,CAAC;IACvE,CAAC;IAED,GAAG,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;AAC7C,CAAC,CAAC,CACH,CAAC;AAEF,eAAe,MAAM,CAAC"}

package/dist/lib/http/routes/task.d.ts

@@ -0,0 +1,13 @@
+/**
+ * TaskGraph HTTP API 路由
+ *
+ * 为 VS Code Extension `taskTool.ts` 提供 HTTP 转发端点。
+ * Extension 通过 lm.registerTool 拦截 tokenBudget 后，
+ * 将业务逻辑转发到此端点，由 TaskGraphService 执行。
+ *
+ * 端点:
+ *   POST /api/v1/task  — 统一入口（operation 路由）
+ */
+declare const router: import("express-serve-static-core").Router;
+export default router;
+//# sourceMappingURL=task.d.ts.map

package/dist/lib/http/routes/task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task.d.ts","sourceRoot":"","sources":["../../../../lib/http/routes/task.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAmDH,QAAA,MAAM,MAAM,4CAAmB,CAAC;AAqahC,eAAe,MAAM,CAAC"}

package/dist/lib/http/routes/task.js

@@ -0,0 +1,384 @@
+/**
+ * TaskGraph HTTP API 路由
+ *
+ * 为 VS Code Extension `taskTool.ts` 提供 HTTP 转发端点。
+ * Extension 通过 lm.registerTool 拦截 tokenBudget 后，
+ * 将业务逻辑转发到此端点，由 TaskGraphService 执行。
+ *
+ * 端点:
+ *   POST /api/v1/task  — 统一入口（operation 路由）
+ */
+import express from 'express';
+import { TaskDispatchBody } from '#shared/schemas/http-requests.js';
+import { getServiceContainer } from '../../injection/ServiceContainer.js';
+import { asyncHandler } from '../middleware/errorHandler.js';
+import { validate } from '../middleware/validate.js';
+const router = express.Router();
+/**
+ * POST /api/v1/task
+ *
+ * 请求体:
+ *   { operation: string, ...params }
+ *
+ * 响应:
+ *   { success: boolean, data?: unknown, message?: string }
+ */
+router.post('/', validate(TaskDispatchBody), asyncHandler(async (req, res) => {
+    const container = getServiceContainer();
+    const taskService = container.get('taskGraphService');
+    if (!taskService) {
+        return void res.status(503).json({
+            success: false,
+            message: 'TaskGraphService not available',
+        });
+    }
+    const { operation, ...params } = req.body;
+    try {
+        const result = await _dispatch(taskService, operation, params);
+        if (result.success === false) {
+            return void res.status(400).json(result);
+        }
+        return void res.json(result);
+    }
+    catch (err) {
+        return void res.status(400).json({
+            success: false,
+            message: err.message,
+            operation,
+        });
+    }
+}));
+/**
+ * 操作路由 — 与 MCP handler/task.js 保持一致
+ */
+async function _dispatch(svc, operation, params) {
+    switch (operation) {
+        case 'create':
+            return _create(svc, params);
+        case 'ready':
+            return _ready(svc, params);
+        case 'claim':
+            return _claim(svc, params);
+        case 'close':
+            return _close(svc, params);
+        case 'fail':
+            return _fail(svc, params);
+        case 'defer':
+            return _defer(svc, params);
+        case 'progress':
+            return _progress(svc, params);
+        case 'prime':
+            return _prime(svc);
+        case 'decompose':
+            return _decompose(svc, params);
+        case 'show':
+            return _show(svc, params);
+        case 'list':
+            return _list(svc, params);
+        case 'blocked':
+            return _blocked(svc);
+        case 'dep_add':
+            return _depAdd(svc, params);
+        case 'dep_tree':
+            return _depTree(svc, params);
+        case 'stats':
+            return _stats(svc);
+        case 'record_decision':
+            return _recordDecision(svc, params);
+        case 'revise_decision':
+            return _reviseDecision(svc, params);
+        case 'unpin_decision':
+            return _unpinDecision(svc, params);
+        case 'list_decisions':
+            return _list(svc, { ...params, taskType: 'decision', status: params.status || 'pinned' });
+        default:
+            return { success: false, message: `Unknown operation: ${operation}` };
+    }
+}
+// ── create ──
+async function _create(svc, args) {
+    if (!args.title) {
+        return { success: false, message: 'title is required' };
+    }
+    const { task, isDuplicate } = await svc.create({
+        title: args.title,
+        description: args.description || '',
+        design: args.design || '',
+        acceptance: args.acceptance || '',
+        priority: args.priority ?? 2,
+        taskType: args.taskType || 'task',
+        parentId: args.parentId || null,
+    });
+    return {
+        success: true,
+        data: task.toJSON(),
+        message: isDuplicate
+            ? `Duplicate detected: ${task.id} already exists`
+            : `Created ${task.id}: ${task.title}`,
+    };
+}
+// ── ready ──
+async function _ready(svc, args) {
+    const tasks = await svc.ready({
+        limit: args.limit || 5,
+        withKnowledge: args.withKnowledge !== false,
+    });
+    return {
+        success: true,
+        data: tasks.map((t) => (t.toJSON ? t.toJSON() : t)),
+        count: tasks.length,
+    };
+}
+// ── claim ──
+async function _claim(svc, args) {
+    if (!args.id) {
+        return { success: false, message: 'id is required' };
+    }
+    const task = await svc.claim(args.id, args.assignee || 'agent');
+    return { success: true, data: task.toJSON() };
+}
+// ── close ──
+async function _close(svc, args) {
+    if (!args.id) {
+        return { success: false, message: 'id is required' };
+    }
+    const { task, newlyReady } = await svc.close(args.id, args.reason || 'Completed');
+    return {
+        success: true,
+        data: task.toJSON(),
+        newlyReady,
+        message: `Closed ${task.id}. ${newlyReady.length} tasks newly ready.`,
+    };
+}
+// ── fail ──
+async function _fail(svc, args) {
+    if (!args.id) {
+        return { success: false, message: 'id is required' };
+    }
+    const task = await svc.fail(args.id, args.reason || '');
+    return { success: true, data: task.toJSON() };
+}
+// ── defer ──
+async function _defer(svc, args) {
+    if (!args.id) {
+        return { success: false, message: 'id is required' };
+    }
+    const task = await svc.defer(args.id, args.reason || '');
+    return { success: true, data: task.toJSON() };
+}
+// ── progress ──
+async function _progress(svc, args) {
+    if (!args.id) {
+        return { success: false, message: 'id is required' };
+    }
+    const task = await svc.progress(args.id, args.note || args.description || '');
+    return { success: true, data: task.toJSON() };
+}
+// ── prime ──
+async function _prime(svc) {
+    const result = await svc.prime({ withKnowledge: true });
+    const decisionCount = (result.decisions || []).length;
+    const staleCount = (result.staleDecisions || []).length;
+    const decisionTitles = (result.decisions || []).map((d) => d.title).join('; ');
+    const statsLine = `${result.inProgress.length} in-progress, ${result.ready.length} ready, ${result.stats.total} total`;
+    // ── Behavioral Rules Reminder (synced with MCP handler) ──
+    result._taskRules = {
+        reminder: [
+            '📋 TASK RULES (MANDATORY):',
+            '🔑 YOU are the task operator — user speaks naturally, you translate to task operations. NEVER tell user to run task commands.',
+            '• MUST prime on EVERY message BEFORE anything else',
+            '• MUST create task for non-trivial work (≥2 files OR ≥10 lines)',
+            '• MUST claim before coding, close when done with meaningful reason',
+            '• MUST handle unfinished tasks before starting new work (ask user: Continue/Defer/Abandon)',
+            '• NEVER skip prime, NEVER start new work with open in_progress tasks',
+            '• NEVER leave tasks in in_progress when session ends — close or defer ALL',
+            '• When in doubt → create a task. When idle → ready()',
+            '• Session end → close all tasks, defer incomplete, verify zero in_progress',
+        ].join('\n'),
+        translationHint: [
+            'User Says → You Run:',
+            '"fix bug"/"implement" → create→claim→code→close',
+            '"continue" → resume in-progress→close',
+            '"pause" → defer | "abandon" → fail | "break down" → decompose',
+            '"what\'s next" → ready() | "agreed" → record_decision',
+            'Quick question → No task. Just answer.',
+        ].join('\n'),
+    };
+    // ── Resume Prompt: 有 inProgress 任务时，提示 Agent 让用户选择 ──
+    if (result.inProgress.length > 0) {
+        const taskList = result.inProgress
+            .map((t) => {
+            const age = t.updatedAt
+                ? `${Math.floor((Date.now() / 1000 - t.updatedAt) / 86400)}d ago`
+                : '';
+            return `• **${t.id}** — ${t.title}${age ? ` (${age})` : ''}`;
+        })
+            .join('\n');
+        result._resumePrompt = {
+            instruction: [
+                'There are unfinished tasks. You MUST present these options to the user BEFORE doing anything else:',
+                '',
+                '**Unfinished tasks:**',
+                taskList,
+                '',
+                'Ask the user to choose:',
+                '1. **Continue** — resume the unfinished task(s)',
+                '2. **Defer** — pause it and work on something else',
+                '3. **Abandon** — close/fail it and start fresh',
+                '',
+                "Wait for the user's answer. Do NOT auto-resume.",
+            ].join('\n'),
+            taskIds: result.inProgress.map((t) => t.id),
+        };
+    }
+    let message;
+    if (decisionCount > 0) {
+        const stalePart = staleCount > 0 ? ` ${staleCount} stale.` : '';
+        message = `⚠️ ${decisionCount} ACTIVE DECISION(S): [${decisionTitles}].${stalePart} ${statsLine}.`;
+    }
+    else {
+        message = `${statsLine}.`;
+    }
+    if (result.inProgress.length > 0) {
+        message += ` ⏸️ ${result.inProgress.length} unfinished task(s) — ask user before resuming.`;
+    }
+    return {
+        success: true,
+        data: result,
+        message,
+    };
+}
+// ── decompose ──
+async function _decompose(svc, args) {
+    const epicId = args.parentId || args.id;
+    const subtasks = args.children || args.subtasks;
+    if (!epicId) {
+        return { success: false, message: 'parentId (or id) is required' };
+    }
+    if (!subtasks || !Array.isArray(subtasks)) {
+        return { success: false, message: 'children (or subtasks) array is required' };
+    }
+    const tasks = await svc.decompose(epicId, subtasks);
+    return {
+        success: true,
+        data: tasks.map((t) => t.toJSON()),
+        count: tasks.length,
+    };
+}
+// ── show ──
+async function _show(svc, args) {
+    if (!args.id) {
+        return { success: false, message: 'id is required' };
+    }
+    const task = await svc.show(args.id);
+    if (!task) {
+        return { success: false, message: `Task ${args.id} not found` };
+    }
+    return { success: true, data: task.toJSON() };
+}
+// ── list ──
+async function _list(svc, args) {
+    const tasks = await svc.list({ status: args.status, taskType: args.taskType, parentId: args.parentId }, { limit: args.limit || 50 });
+    return {
+        success: true,
+        data: tasks.map((t) => t.toJSON()),
+        count: tasks.length,
+    };
+}
+// ── blocked ──
+async function _blocked(svc) {
+    const tasks = await svc.blocked();
+    return {
+        success: true,
+        data: tasks.map((t) => (t.toJSON ? t.toJSON() : t)),
+        count: tasks.length,
+    };
+}
+// ── dep_add ──
+async function _depAdd(svc, args) {
+    if (!args.taskId || !args.dependsOn) {
+        return { success: false, message: 'taskId and dependsOn are required' };
+    }
+    await svc.addDependency(args.taskId, args.dependsOn, args.depType || 'blocks');
+    return {
+        success: true,
+        message: `Dependency added: ${args.taskId} ${args.depType || 'blocks'} ${args.dependsOn}`,
+    };
+}
+// ── dep_tree ──
+async function _depTree(svc, args) {
+    if (!args.id) {
+        return { success: false, message: 'id is required' };
+    }
+    const tree = await svc.depTree(args.id);
+    return { success: true, data: tree };
+}
+// ── stats ──
+async function _stats(svc) {
+    const stats = await svc.stats();
+    return { success: true, data: stats };
+}
+// ── record_decision ──
+async function _recordDecision(svc, args) {
+    if (!args.title) {
+        return { success: false, message: 'title is required' };
+    }
+    if (!args.description) {
+        return { success: false, message: 'description is required' };
+    }
+    const { task, isDuplicate } = await svc.recordDecision({
+        title: args.title,
+        description: args.description,
+        rationale: args.rationale || '',
+        tags: args.tags || [],
+        relatedTaskId: args.relatedTaskId || null,
+    });
+    return {
+        success: true,
+        data: task.toJSON(),
+        message: isDuplicate
+            ? `Decision already recorded: ${task.id}`
+            : `Decision pinned: ${task.id} — "${args.title}"`,
+    };
+}
+// ── revise_decision ──
+async function _reviseDecision(svc, args) {
+    if (!args.id) {
+        return { success: false, message: 'id of old decision is required' };
+    }
+    if (!args.title) {
+        return { success: false, message: 'title of new decision is required' };
+    }
+    if (!args.description) {
+        return { success: false, message: 'description of new decision is required' };
+    }
+    const result = await svc.reviseDecision({
+        oldDecisionId: args.id,
+        title: args.title,
+        description: args.description,
+        rationale: args.rationale || '',
+        reason: args.reason || '',
+    });
+    return {
+        success: true,
+        data: {
+            newDecision: result.newDecision.toJSON(),
+            superseded: result.oldDecisionId,
+        },
+        message: `Decision revised: ${result.oldDecisionId} → ${result.newDecision.id}`,
+    };
+}
+// ── unpin_decision ──
+async function _unpinDecision(svc, args) {
+    if (!args.id) {
+        return { success: false, message: 'id is required' };
+    }
+    const task = await svc.unpinDecision(args.id, args.reason || '');
+    return {
+        success: true,
+        data: task.toJSON(),
+        message: `Decision ${args.id} unpinned and closed`,
+    };
+}
+export default router;
+//# sourceMappingURL=task.js.map