@geeseeker/easyai-dev 3.0.0-alpha.1 → 3.0.1

package/lib/server/utils/journal-utils.js

@@ -0,0 +1,387 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { getProjectRoot } from "./task-utils.js";
+// ============ 常量 ============
+const WORKSPACE_ROOT = ".trellis/workspace";
+const MAX_LINES_PER_FILE = 2000;
+const DEFAULT_USER = "default";
+// ============ 工具函数 ============
+/**
+ * 获取用户 journal 目录
+ * 按 architecture §6.4，journal 文件位于 .trellis/workspace/{user}/
+ * @param user - 用户名，默认为 'default'
+ * @returns journal 目录的绝对路径
+ */
+function getJournalDir(user = DEFAULT_USER) {
+    // 防止路径遍历攻击
+    if (user.includes("..") || user.includes("/") || user.includes("\\")) {
+        throw new Error(`非法的用户名: ${user}`);
+    }
+    const projectRoot = getProjectRoot();
+    // 修复: journal 文件应位于 .trellis/workspace/{user}/，而非 .trellis/workspace/journal/{user}/
+    const journalDir = path.join(projectRoot, WORKSPACE_ROOT, user);
+    return journalDir;
+}
+/**
+ * 获取最新（或当前活跃）的 journal 文件路径
+ * 返回当前正在写入的文件（最高页码的文件，或 journal.md 如果不存在编号文件）
+ * @param user - 用户名，默认为 'default'
+ * @returns 最新 journal 文件的绝对路径
+ */
+function getLatestJournalFile(user = DEFAULT_USER) {
+    const journalDir = getJournalDir(user);
+    // 确保 journal 目录存在
+    if (!fs.existsSync(journalDir)) {
+        fs.mkdirSync(journalDir, { recursive: true });
+    }
+    // 列出所有 journal 文件并按页码排序（从高到低）
+    // journal.md = page 0, journal-1.md = page 1, journal-2.md = page 2, ...
+    const entries = fs.readdirSync(journalDir);
+    const journalFiles = entries
+        .filter((name) => name.startsWith("journal") && name.endsWith(".md"))
+        .map((name) => {
+        if (name === "journal.md") {
+            return { name, page: 0 };
+        }
+        const match = name.match(/journal-(\d+)\.md/);
+        return match ? { name, page: parseInt(match[1], 10) } : null;
+    })
+        .filter((item) => item !== null)
+        .sort((a, b) => b.page - a.page); // 降序排列，最高页码在前
+    // 如果存在文件，返回最高页码的文件（正在写入的文件）
+    if (journalFiles.length > 0) {
+        return path.join(journalDir, journalFiles[0].name);
+    }
+    // 否则返回默认 journal.md 路径
+    return path.join(journalDir, "journal.md");
+}
+/**
+ * 获取下一个编号的 journal 文件名
+ * @param journalDir - journal 目录路径
+ * @returns 下一个编号的文件名（如 journal-1.md）
+ */
+function getNextJournalFileName(journalDir) {
+    const entries = fs.readdirSync(journalDir);
+    const numberedFiles = entries
+        .filter((name) => name.startsWith("journal-") && name.endsWith(".md"))
+        .map((name) => {
+        const match = name.match(/journal-(\d+)\.md/);
+        return match ? parseInt(match[1], 10) : 0;
+    });
+    const maxNumber = numberedFiles.length > 0 ? Math.max(...numberedFiles) : 0;
+    const nextNumber = maxNumber + 1;
+    return `journal-${nextNumber}.md`;
+}
+/**
+ * 计算文件的行数
+ * @param filePath - 文件路径
+ * @returns 文件行数
+ */
+function getFileLineCount(filePath) {
+    if (!fs.existsSync(filePath)) {
+        return 0;
+    }
+    const content = fs.readFileSync(filePath, "utf-8");
+    return content.split("\n").length;
+}
+/**
+ * 追加日志条目到 journal 文件
+ * 如果当前文件超过 MAX_LINES_PER_FILE，自动创建新文件
+ * @param entry - 日志条目
+ * @param user - 用户名，默认为 'default'
+ */
+function appendJournalEntry(entry, user = DEFAULT_USER) {
+    const journalDir = getJournalDir(user);
+    let journalFile = getLatestJournalFile(user);
+    // 确保 journal 目录存在
+    if (!fs.existsSync(journalDir)) {
+        fs.mkdirSync(journalDir, { recursive: true });
+    }
+    // 检查当前文件行数
+    const currentLineCount = getFileLineCount(journalFile);
+    const entryContent = serializeJournalEntry(entry);
+    // 如果超过最大行数，创建新文件
+    if (currentLineCount + entryContent.split("\n").length > MAX_LINES_PER_FILE) {
+        const newFileName = getNextJournalFileName(journalDir);
+        journalFile = path.join(journalDir, newFileName);
+    }
+    // 追加条目
+    const separator = fs.existsSync(journalFile) && getFileLineCount(journalFile) > 0 ? "\n" : "";
+    fs.appendFileSync(journalFile, separator + entryContent + "\n");
+}
+/**
+ * 转义 YAML 字符串值
+ * 对于包含特殊字符的字符串，使用单引号包裹并转义内部单引号
+ * @param value - 原始字符串值
+ * @returns 转义后的字符串
+ */
+function escapeYamlString(value) {
+    // 如果字符串包含特殊字符，使用单引号包裹并转义内部单引号
+    const specialChars = ['"', "\\", ":", "#"];
+    const hasSpecialChar = specialChars.some((char) => value.includes(char));
+    if (hasSpecialChar) {
+        // 单引号包裹：内部单引号通过双写转义（' → ''）
+        return `'${value.replace(/'/g, "''")}'`;
+    }
+    return value;
+}
+/**
+ * 序列化单个日志条目为 YAML frontmatter 格式
+ * @param entry - 日志条目
+ * @returns 序列化后的字符串
+ */
+function serializeJournalEntry(entry) {
+    const lines = ["---"];
+    // date
+    lines.push(`date: ${entry.date}`);
+    // tags - 转义包含特殊字符的标签
+    if (entry.tags && entry.tags.length > 0) {
+        const tagsStr = entry.tags.map((t) => escapeYamlString(t)).join(", ");
+        lines.push(`tags: [${tagsStr}]`);
+    }
+    // tasks_touched - 转义包含特殊字符的任务 ID
+    if (entry.tasks_touched && entry.tasks_touched.length > 0) {
+        const tasksStr = entry.tasks_touched
+            .map((t) => escapeYamlString(t))
+            .join(", ");
+        lines.push(`tasks_touched: [${tasksStr}]`);
+    }
+    lines.push("---");
+    lines.push("");
+    lines.push(entry.content);
+    return lines.join("\n");
+}
+/**
+ * 解析 journal 文件中的所有条目
+ * 条目由 YAML frontmatter 包裹，使用 `---` 作为开始和结束标记
+ * @param content - journal 文件内容
+ * @returns 解析后的日志条目列表
+ */
+function parseJournalEntries(content) {
+    const entries = [];
+    let state = "outside_entry";
+    let currentEntry = {
+        date: "",
+        tags: [],
+        tasks_touched: [],
+        content: "",
+    };
+    let frontmatterLines = [];
+    let bodyLines = [];
+    const lines = content.split("\n");
+    // 使用索引迭代，以支持 body 状态下的 lookahead
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const trimmed = line.trim();
+        if (trimmed === "---") {
+            if (state === "outside_entry") {
+                // 遇到第一个 ---，进入 frontmatter
+                state = "in_frontmatter";
+                frontmatterLines = [];
+                bodyLines = [];
+            }
+            else if (state === "in_frontmatter") {
+                // 遇到第二个 ---，frontmatter 结束，进入 body
+                state = "in_body";
+                // 解析 frontmatter
+                currentEntry = parseFrontmatterLines(frontmatterLines);
+            }
+            else if (state === "in_body") {
+                // 在 body 中遇到 ---：预查下一行是否为合法 frontmatter key
+                // 只有确认是新条目头部（如 date:）才切分，否则视为 Markdown 分隔线
+                const nextNonEmpty = findNextNonEmptyLine(lines, i + 1);
+                if (nextNonEmpty !== null && isFrontmatterKey(nextNonEmpty)) {
+                    // 确认是新条目，保存当前条目并开始新 frontmatter
+                    currentEntry.content = bodyLines.join("\n").trim();
+                    if (currentEntry.date || currentEntry.content) {
+                        entries.push(currentEntry);
+                    }
+                    // 重置状态
+                    state = "in_frontmatter";
+                    frontmatterLines = [];
+                    bodyLines = [];
+                    currentEntry = {
+                        date: "",
+                        tags: [],
+                        tasks_touched: [],
+                        content: "",
+                    };
+                }
+                else {
+                    // 不是新条目，--- 作为 body 内容保留
+                    bodyLines.push(line);
+                }
+            }
+        }
+        else {
+            if (state === "in_frontmatter") {
+                frontmatterLines.push(line);
+            }
+            else if (state === "in_body") {
+                bodyLines.push(line);
+            }
+        }
+    }
+    // 处理最后一个条目（文件可能不以 --- 结尾）
+    if (state === "in_body") {
+        currentEntry.content = bodyLines.join("\n").trim();
+        if (currentEntry.date || currentEntry.content) {
+            entries.push(currentEntry);
+        }
+    }
+    return entries;
+}
+/**
+ * 从指定索引开始，查找下一个非空行
+ * @param lines - 行数组
+ * @param startIdx - 起始索引
+ * @returns 非空行内容（trimmed），如果到末尾都未找到则返回 null
+ */
+function findNextNonEmptyLine(lines, startIdx) {
+    for (let j = startIdx; j < lines.length; j++) {
+        const t = lines[j].trim();
+        if (t)
+            return t;
+    }
+    return null;
+}
+/**
+ * 判断一行是否为合法的 journal frontmatter key
+ * 目前支持的 key：date, tags, tasks_touched
+ */
+function isFrontmatterKey(line) {
+    return /^(date|tags|tasks_touched)\s*:/.test(line);
+}
+/**
+ * 解析 frontmatter 行数组，返回 JournalEntry
+ * @param lines - frontmatter 行数组
+ * @returns 解析后的日志条目（不包含 content）
+ */
+function parseFrontmatterLines(lines) {
+    const entry = {
+        date: "",
+        tags: [],
+        tasks_touched: [],
+        content: "",
+    };
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith("#")) {
+            continue;
+        }
+        const colonIndex = trimmed.indexOf(":");
+        if (colonIndex === -1) {
+            continue;
+        }
+        const key = trimmed.substring(0, colonIndex).trim();
+        const value = trimmed.substring(colonIndex + 1).trim();
+        if (key === "date") {
+            entry.date = value.replace(/^["']|["']$/g, "");
+        }
+        else if (key === "tags") {
+            // 解析数组格式 [item1, item2]
+            const arrayMatch = value.match(/^\[(.*)\]$/);
+            if (arrayMatch) {
+                entry.tags = arrayMatch[1]
+                    .split(",")
+                    .map((item) => item.trim().replace(/^["']|["']$/g, ""))
+                    .filter(Boolean);
+            }
+        }
+        else if (key === "tasks_touched") {
+            const arrayMatch = value.match(/^\[(.*)\]$/);
+            if (arrayMatch) {
+                entry.tasks_touched = arrayMatch[1]
+                    .split(",")
+                    .map((item) => item.trim().replace(/^["']|["']$/g, ""))
+                    .filter(Boolean);
+            }
+        }
+    }
+    return entry;
+}
+/**
+ * 搜索日志条目
+ * @param query - 搜索查询选项
+ * @param user - 用户名，默认为 'default'
+ * @returns 匹配的日志条目列表
+ */
+function searchJournal(query, user = DEFAULT_USER) {
+    const journalDir = getJournalDir(user);
+    if (!fs.existsSync(journalDir)) {
+        return [];
+    }
+    // 获取所有 journal 文件并按页码排序（从高到低）
+    // journal.md = page 0, journal-1.md = page 1, journal-2.md = page 2, ...
+    const entries = fs.readdirSync(journalDir);
+    const journalFiles = entries
+        .filter((name) => name.startsWith("journal") && name.endsWith(".md"))
+        .map((name) => {
+        if (name === "journal.md") {
+            return { name, page: 0 };
+        }
+        const match = name.match(/journal-(\d+)\.md/);
+        return match ? { name, page: parseInt(match[1], 10) } : null;
+    })
+        .filter((item) => item !== null)
+        .sort((a, b) => b.page - a.page); // 降序排列，从最高页码开始读取
+    // 解析所有条目（从最新文件开始读取）
+    const allEntries = [];
+    for (const file of journalFiles) {
+        const filePath = path.join(journalDir, file.name);
+        const content = fs.readFileSync(filePath, "utf-8");
+        const parsed = parseJournalEntries(content);
+        // 将当前文件的条目反转，使文件内最新的条目排在前面
+        allEntries.push(...parsed.reverse());
+    }
+    // 过滤条目
+    const filtered = allEntries.filter((entry) => {
+        // 标签过滤
+        if (query.tags && query.tags.length > 0) {
+            const hasAllTags = query.tags.every((tag) => entry.tags.includes(tag));
+            if (!hasAllTags) {
+                return false;
+            }
+        }
+        // 关键词过滤
+        if (query.keywords && query.keywords.length > 0) {
+            const contentLower = entry.content.toLowerCase();
+            const hasAllKeywords = query.keywords.every((kw) => contentLower.includes(kw.toLowerCase()));
+            if (!hasAllKeywords) {
+                return false;
+            }
+        }
+        // 日期范围过滤
+        if (query.date_range) {
+            const entryDate = new Date(entry.date);
+            if (query.date_range.from) {
+                const fromDate = new Date(query.date_range.from);
+                if (entryDate < fromDate) {
+                    return false;
+                }
+            }
+            if (query.date_range.to) {
+                const toDate = new Date(query.date_range.to);
+                if (entryDate > toDate) {
+                    return false;
+                }
+            }
+        }
+        return true;
+    });
+    return filtered;
+}
+/**
+ * 获取最新的 N 条日志条目
+ * 条目按时间倒序排列（最新的在前）
+ * @param count - 获取的条目数量，默认为 10
+ * @param user - 用户名，默认为 'default'
+ * @returns 最新的日志条目列表
+ */
+function getLatestEntries(count = 10, user = DEFAULT_USER) {
+    const allEntries = searchJournal({}, user);
+    // searchJournal 已经返回倒序的条目（最新的在前），直接取前 count 个即可
+    return allEntries.slice(0, count);
+}
+export { WORKSPACE_ROOT, MAX_LINES_PER_FILE, DEFAULT_USER, getJournalDir, getLatestJournalFile, appendJournalEntry, parseJournalEntries, searchJournal, getLatestEntries, };
+//# sourceMappingURL=journal-utils.js.map

package/lib/server/utils/journal-utils.js.map

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

package/lib/server/utils/status-utils.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Git 信息接口
+ */
+interface GitInfo {
+    branch: string;
+    status: string;
+    recent_commits: Array<{
+        hash: string;
+        message: string;
+        date: string;
+        author: string;
+    }>;
+}
+/**
+ * 任务摘要接口
+ */
+interface TaskSummary {
+    id: string;
+    title: string;
+    status: string;
+}
+/**
+ * 任务统计接口
+ */
+interface TaskStats {
+    total: number;
+    active: number;
+    by_status: Record<string, number>;
+    active_tasks: TaskSummary[];
+}
+/**
+ * 日志摘要接口
+ */
+interface JournalSummary {
+    latest_count: number;
+    entries: Array<{
+        date: string;
+        tags: string[];
+        content: string;
+    }>;
+}
+/**
+ * 项目状态数据接口
+ */
+export interface ProjectStatusData {
+    git: GitInfo;
+    tasks: TaskStats;
+    journal: JournalSummary;
+}
+/**
+ * 获取项目状态数据
+ * @param commitCount - 获取的 Git 提交数量，默认为 5
+ * @param journalCount - 获取的日志条目数量，默认为 3
+ * @returns 项目状态数据
+ */
+export declare function getProjectStatusData(commitCount?: number, journalCount?: number): ProjectStatusData;
+export {};
+//# sourceMappingURL=status-utils.d.ts.map

package/lib/server/utils/status-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-utils.d.ts","sourceRoot":"","sources":["../../src/utils/status-utils.ts"],"names":[],"mappings":"AAkBA;;GAEG;AACH,UAAU,OAAO;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,KAAK,CAAC;QACpB,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC,CAAC;CACJ;AAED;;GAEG;AACH,UAAU,WAAW;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,UAAU,SAAS;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,YAAY,EAAE,WAAW,EAAE,CAAC;CAC7B;AAED;;GAEG;AACH,UAAU,cAAc;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,EAAE,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,OAAO,CAAC;IACb,KAAK,EAAE,SAAS,CAAC;IACjB,OAAO,EAAE,cAAc,CAAC;CACzB;AAID;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,GAAE,MAAU,EACvB,YAAY,GAAE,MAAU,GACvB,iBAAiB,CAkEnB"}

package/lib/server/utils/status-utils.js

@@ -0,0 +1,70 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { getGitBranch, getGitStatus, getRecentCommits, } from './git-utils.js';
+import { listTaskDirs, getTaskDir, parseTaskMd, } from './task-utils.js';
+import { getLatestEntries, } from './journal-utils.js';
+// ============ 工具函数 ============
+/**
+ * 获取项目状态数据
+ * @param commitCount - 获取的 Git 提交数量，默认为 5
+ * @param journalCount - 获取的日志条目数量，默认为 3
+ * @returns 项目状态数据
+ */
+export function getProjectStatusData(commitCount = 5, journalCount = 3) {
+    // Git 信息
+    const gitInfo = {
+        branch: getGitBranch(),
+        status: getGitStatus() || 'clean',
+        recent_commits: getRecentCommits(commitCount).map(c => ({
+            hash: c.hash.substring(0, 8),
+            message: c.message,
+            date: c.date,
+            author: c.author,
+        })),
+    };
+    // 任务列表
+    const taskDirs = listTaskDirs();
+    const tasks = [];
+    for (const taskDir of taskDirs) {
+        const taskPath = getTaskDir(taskDir);
+        const taskMdPath = path.join(taskPath, 'task.md');
+        if (fs.existsSync(taskMdPath)) {
+            const content = fs.readFileSync(taskMdPath, 'utf-8');
+            const parsed = parseTaskMd(content);
+            tasks.push({
+                id: parsed.metadata.id,
+                title: parsed.metadata.title,
+                status: parsed.metadata.status,
+            });
+        }
+    }
+    // 活跃任务（排除已完成、已归档和已取消）
+    const activeTasks = tasks.filter(t => t.status !== 'completed' && t.status !== 'archived' && t.status !== 'cancelled');
+    // 计算按状态分组的任务计数
+    const byStatus = {};
+    for (const task of tasks) {
+        byStatus[task.status] = (byStatus[task.status] || 0) + 1;
+    }
+    // 最新日志
+    const latestJournalEntries = getLatestEntries(journalCount);
+    const journalSummary = {
+        latest_count: latestJournalEntries.length,
+        entries: latestJournalEntries.map(entry => ({
+            date: entry.date,
+            tags: entry.tags,
+            content: entry.content.substring(0, 100) +
+                (entry.content.length > 100 ? '...' : ''),
+        })),
+    };
+    return {
+        git: gitInfo,
+        tasks: {
+            total: tasks.length,
+            active: activeTasks.length,
+            by_status: byStatus,
+            active_tasks: activeTasks,
+        },
+        journal: journalSummary,
+    };
+}
+//# sourceMappingURL=status-utils.js.map

package/lib/server/utils/status-utils.js.map

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

package/lib/server/utils/task-utils.d.ts

@@ -0,0 +1,104 @@
+declare const TRELLIS_ROOT = ".trellis";
+declare const TASKS_ROOT = ".trellis/tasks";
+declare const ARCHIVE_ROOT = ".trellis/tasks/archive";
+/**
+ * 任务状态枚举
+ */
+type TaskStatus = "pending" | "in_progress" | "under_review" | "completed" | "archived" | "cancelled" | "rejected";
+/**
+ * 合法状态转移矩阵（来自 architecture §5.2）
+ * Key: 当前状态, Value: 允许转移到的状态列表
+ */
+declare const VALID_TRANSITIONS: Record<TaskStatus, TaskStatus[]>;
+/**
+ * 任务元数据接口
+ */
+interface TaskMetadata {
+    id: string;
+    title: string;
+    status: TaskStatus;
+    description: string;
+    acceptance_criteria: string;
+    file_scope?: string;
+    assign_strategy?: string;
+    created_at: string;
+    updated_at: string;
+}
+/**
+ * 解析后的任务文档结构
+ */
+interface ParsedTask {
+    metadata: TaskMetadata;
+    body: string;
+}
+/**
+ * 获取项目根目录
+ * 优先级：EASYAI_PROJECT_ROOT 环境变量 → 向上查找 .trellis 目录
+ * @returns 项目根目录的绝对路径
+ */
+declare function getProjectRoot(): string;
+/**
+ * 获取任务目录绝对路径
+ * @returns 任务目录的绝对路径
+ */
+declare function getTasksDir(): string;
+/**
+ * 获取归档目录绝对路径
+ * @returns 归档目录的绝对路径
+ */
+declare function getArchiveDir(): string;
+/**
+ * 获取指定任务的目录路径
+ * @param taskId - 任务 ID（如 T001-login-api）
+ * @returns 任务目录的绝对路径
+ */
+declare function getTaskDir(taskId: string): string;
+/**
+ * 将文本转换为 kebab-case slug
+ * - 转换为小写 ASCII
+ * - 将空格和特殊字符替换为连字符
+ * - 截断至 30 个字符
+ * @param text - 输入文本（支持中文和英文）
+ * @returns kebab-case slug
+ */
+declare function slugify(text: string): string;
+/**
+ * 生成任务 ID（格式：T{NNN}-{slug}）
+ * 自动递增序号，基于现有任务目录（包括归档目录中的任务）
+ * @param title - 任务标题
+ * @returns 任务 ID（如 T001-login-api）
+ */
+declare function generateTaskId(title: string): string;
+/**
+ * 解析 task.md 文件内容
+ * @param content - task.md 文件内容
+ * @returns 解析后的元数据和正文
+ */
+declare function parseTaskMd(content: string): ParsedTask;
+/**
+ * 序列化为 task.md 文件格式
+ * @param metadata - 任务元数据
+ * @param body - 任务正文
+ * @returns task.md 文件内容
+ */
+declare function serializeTaskMd(metadata: TaskMetadata, body: string): string;
+/**
+ * 校验状态转移是否合法
+ * @param from - 当前状态
+ * @param to - 目标状态
+ * @returns 是否允许转移
+ */
+declare function isValidTransition(from: TaskStatus, to: TaskStatus): boolean;
+/**
+ * 列出所有任务目录（排除归档目录）
+ * @returns 任务目录名列表
+ */
+declare function listTaskDirs(): string[];
+/**
+ * 确保目录存在，不存在则创建
+ * @param dirPath - 目录路径
+ */
+declare function ensureDir(dirPath: string): void;
+export type { TaskStatus, TaskMetadata, ParsedTask };
+export { TRELLIS_ROOT, TASKS_ROOT, ARCHIVE_ROOT, VALID_TRANSITIONS, getProjectRoot, getTasksDir, getArchiveDir, getTaskDir, generateTaskId, slugify, parseTaskMd, serializeTaskMd, isValidTransition, listTaskDirs, ensureDir, };
+//# sourceMappingURL=task-utils.d.ts.map

package/lib/server/utils/task-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-utils.d.ts","sourceRoot":"","sources":["../../src/utils/task-utils.ts"],"names":[],"mappings":"AAKA,QAAA,MAAM,YAAY,aAAa,CAAC;AAChC,QAAA,MAAM,UAAU,mBAAmB,CAAC;AACpC,QAAA,MAAM,YAAY,2BAA2B,CAAC;AAI9C;;GAEG;AACH,KAAK,UAAU,GACX,SAAS,GACT,aAAa,GACb,cAAc,GACd,WAAW,GACX,UAAU,GACV,WAAW,GACX,UAAU,CAAC;AAEf;;;GAGG;AACH,QAAA,MAAM,iBAAiB,EAAE,MAAM,CAAC,UAAU,EAAE,UAAU,EAAE,CAQvD,CAAC;AAEF;;GAEG;AACH,UAAU,YAAY;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,UAAU,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,UAAU,UAAU;IAClB,QAAQ,EAAE,YAAY,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;CACd;AAQD;;;;GAIG;AACH,iBAAS,cAAc,IAAI,MAAM,CAiChC;AAED;;;GAGG;AACH,iBAAS,WAAW,IAAI,MAAM,CAG7B;AAED;;;GAGG;AACH,iBAAS,aAAa,IAAI,MAAM,CAG/B;AAED;;;;GAIG;AACH,iBAAS,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAO1C;AAED;;;;;;;GAOG;AACH,iBAAS,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CA0BrC;AAED;;;;;GAKG;AACH,iBAAS,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAiD7C;AAgKD;;;;GAIG;AACH,iBAAS,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,CA4BhD;AAED;;;;;GAKG;AACH,iBAAS,eAAe,CAAC,QAAQ,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAoBrE;AAED;;;;;GAKG;AACH,iBAAS,iBAAiB,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,UAAU,GAAG,OAAO,CAGpE;AAED;;;GAGG;AACH,iBAAS,YAAY,IAAI,MAAM,EAAE,CAahC;AAED;;;GAGG;AACH,iBAAS,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAIxC;AAID,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE,CAAC;AACrD,OAAO,EACL,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,iBAAiB,EACjB,cAAc,EACd,WAAW,EACX,aAAa,EACb,UAAU,EACV,cAAc,EACd,OAAO,EACP,WAAW,EACX,eAAe,EACf,iBAAiB,EACjB,YAAY,EACZ,SAAS,GACV,CAAC"}