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

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

@@ -0,0 +1,84 @@
+import { execSync } from 'node:child_process';
+// ============ 工具函数 ============
+/**
+ * 获取当前 Git 分支名
+ * @returns 当前分支名，失败返回 'HEAD'
+ */
+function getGitBranch() {
+    try {
+        const result = execSync('git rev-parse --abbrev-ref HEAD', {
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        return result.trim();
+    }
+    catch (error) {
+        return 'HEAD';
+    }
+}
+/**
+ * 获取 Git 状态（简短格式）
+ * @returns `git status --short` 输出，失败返回空字符串
+ */
+function getGitStatus() {
+    try {
+        const result = execSync('git status --short', {
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        return result.trim();
+    }
+    catch (error) {
+        return '';
+    }
+}
+/**
+ * 获取最近 N 条 commit 记录
+ * @param count - 获取的 commit 数量，默认为 10
+ * @returns commit 信息列表
+ */
+function getRecentCommits(count = 10) {
+    try {
+        // 使用 git log 格式化输出
+        const format = '%H|%s|%ci|%an';
+        const result = execSync(`git log -n ${count} --format="${format}"`, {
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        const commits = [];
+        const lines = result.trim().split('\n');
+        for (const line of lines) {
+            const parts = line.split('|');
+            if (parts.length >= 4) {
+                commits.push({
+                    hash: parts[0],
+                    message: parts[1],
+                    date: parts[2],
+                    author: parts[3],
+                });
+            }
+        }
+        return commits;
+    }
+    catch (error) {
+        return [];
+    }
+}
+/**
+ * 检查当前目录是否在 Git 仓库中
+ * @returns 是否在 Git 仓库中
+ */
+function isGitRepo() {
+    try {
+        execSync('git rev-parse --git-dir', {
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        return true;
+    }
+    catch (error) {
+        return false;
+    }
+}
+export { getGitBranch, getGitStatus, getRecentCommits, isGitRepo, };
+//# sourceMappingURL=git-utils.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"git-utils.js","sourceRoot":"","sources":["../../src/utils/git-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAc9C,iCAAiC;AAEjC;;;GAGG;AACH,SAAS,YAAY;IACnB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,QAAQ,CAAC,iCAAiC,EAAE;YACzD,QAAQ,EAAE,OAAO;YACjB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;SAChC,CAAC,CAAC;QACH,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;IACvB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,MAAM,CAAC;IAChB,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,SAAS,YAAY;IACnB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,QAAQ,CAAC,oBAAoB,EAAE;YAC5C,QAAQ,EAAE,OAAO;YACjB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;SAChC,CAAC,CAAC;QACH,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;IACvB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,SAAS,gBAAgB,CAAC,QAAgB,EAAE;IAC1C,IAAI,CAAC;QACH,mBAAmB;QACnB,MAAM,MAAM,GAAG,eAAe,CAAC;QAC/B,MAAM,MAAM,GAAG,QAAQ,CAAC,cAAc,KAAK,cAAc,MAAM,GAAG,EAAE;YAClE,QAAQ,EAAE,OAAO;YACjB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;SAChC,CAAC,CAAC;QAEH,MAAM,OAAO,GAAgB,EAAE,CAAC;QAChC,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAExC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAC9B,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;gBACtB,OAAO,CAAC,IAAI,CAAC;oBACX,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;oBACd,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;oBACjB,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;oBACd,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;iBACjB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,SAAS,SAAS;IAChB,IAAI,CAAC;QACH,QAAQ,CAAC,yBAAyB,EAAE;YAClC,QAAQ,EAAE,OAAO;YACjB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;SAChC,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAKD,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAChB,SAAS,GACV,CAAC"}

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

@@ -0,0 +1,78 @@
+/**
+ * context.jsonl 中每条记录的结构
+ */
+interface ContextEntry {
+    uri: string;
+    phase?: string;
+    priority?: string;
+    reason?: string;
+    confidence?: number;
+    token_estimate?: number;
+    source?: string;
+    content_hash?: string;
+    frozen_at?: string | null;
+    stale?: boolean;
+}
+/**
+ * 快照生成结果
+ */
+interface SnapshotResult {
+    snapshotPath: string;
+    entriesCount: number;
+    frozenAt: string;
+}
+/**
+ * Stale 检测结果
+ */
+interface StaleCheckResult {
+    totalEntries: number;
+    staleEntries: StaleEntry[];
+    allFresh: boolean;
+}
+/**
+ * 单条 stale 记录
+ */
+interface StaleEntry {
+    uri: string;
+    snapshotHash: string;
+    currentHash: string;
+}
+/**
+ * 计算文件内容的 SHA256 哈希值
+ * @param filePath - 文件绝对路径
+ * @returns 格式为 "sha256:xxxx" 的哈希字符串
+ */
+declare function computeContentHash(filePath: string): string;
+/**
+ * 将 URI 解析为文件系统绝对路径
+ * 支持 trellis:// 和 spec:// 协议
+ * @param uri - 资源 URI
+ * @returns 文件绝对路径，无法解析时返回 null
+ */
+declare function resolveUriToPath(uri: string): string | null;
+/**
+ * 解析 context.jsonl 文件
+ * 每行一条 JSON 记录，跳过空行和解析失败的行
+ * @param jsonlPath - context.jsonl 文件绝对路径
+ * @returns 解析后的条目数组
+ */
+declare function parseContextJsonl(jsonlPath: string): ContextEntry[];
+/**
+ * 生成 Phase-Frozen 快照
+ * 读取任务目录下的 context.jsonl，为每条 URI 条目计算 content_hash，
+ * 填入 frozen_at 时间戳，写入 context-snapshot-{phase}.jsonl
+ *
+ * @param taskDir - 任务目录绝对路径
+ * @param phase - 阶段标识（如 "implement"）
+ * @returns 快照结果，context.jsonl 不存在时返回 null
+ */
+declare function generateSnapshot(taskDir: string, phase: string): SnapshotResult | null;
+/**
+ * Stale 检测 — 比对快照中每条记录的 content_hash 与当前文件 hash
+ * @param snapshotPath - 快照文件绝对路径
+ * @returns stale 检测结果
+ */
+declare function checkStale(snapshotPath: string): StaleCheckResult;
+export type { ContextEntry, SnapshotResult, StaleCheckResult, StaleEntry, };
+export { computeContentHash, resolveUriToPath, parseContextJsonl, generateSnapshot, checkStale, };
+//# sourceMappingURL=hash-utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hash-utils.d.ts","sourceRoot":"","sources":["../../src/utils/hash-utils.ts"],"names":[],"mappings":"AAQA;;GAEG;AACH,UAAU,YAAY;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,UAAU,cAAc;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,UAAU,gBAAgB;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,UAAU,EAAE,CAAC;IAC3B,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,UAAU,UAAU;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB;AAID;;;;GAIG;AACH,iBAAS,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAIpD;AAED;;;;;GAKG;AACH,iBAAS,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAkCpD;AAED;;;;;GAKG;AACH,iBAAS,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY,EAAE,CAmB5D;AAED;;;;;;;;GAQG;AACH,iBAAS,gBAAgB,CACvB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,GACZ,cAAc,GAAG,IAAI,CAsCvB;AAED;;;;GAIG;AACH,iBAAS,UAAU,CAAC,YAAY,EAAE,MAAM,GAAG,gBAAgB,CAsC1D;AAID,YAAY,EACV,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,UAAU,GACX,CAAC;AAEF,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,UAAU,GACX,CAAC"}

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

@@ -0,0 +1,153 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import * as crypto from "node:crypto";
+import { getProjectRoot } from "./task-utils.js";
+// ============ 核心函数 ============
+/**
+ * 计算文件内容的 SHA256 哈希值
+ * @param filePath - 文件绝对路径
+ * @returns 格式为 "sha256:xxxx" 的哈希字符串
+ */
+function computeContentHash(filePath) {
+    const content = fs.readFileSync(filePath, "utf-8");
+    const hash = crypto.createHash("sha256").update(content).digest("hex");
+    return `sha256:${hash}`;
+}
+/**
+ * 将 URI 解析为文件系统绝对路径
+ * 支持 trellis:// 和 spec:// 协议
+ * @param uri - 资源 URI
+ * @returns 文件绝对路径，无法解析时返回 null
+ */
+function resolveUriToPath(uri) {
+    const projectRoot = getProjectRoot();
+    // 统一前缀：追加 sep 防止匹配兄弟目录如 spec-malicious/
+    const specRoot = path.join(projectRoot, ".trellis", "spec") + path.sep;
+    // spec:// 简写 → trellis://spec/...
+    if (uri.startsWith("spec://")) {
+        let specPath = uri.replace("spec://", "");
+        // 规范化：去除已有 .md 后缀后统一追加，防止 .md.md
+        if (specPath.endsWith(".md")) {
+            specPath = specPath.slice(0, -3);
+        }
+        const fullPath = path.resolve(projectRoot, ".trellis", "spec", `${specPath}.md`);
+        if (!fullPath.startsWith(specRoot))
+            return null;
+        return fs.existsSync(fullPath) ? fullPath : null;
+    }
+    // trellis://spec/{category}/{name}
+    if (uri.startsWith("trellis://spec/")) {
+        let specPath = uri.replace("trellis://spec/", "");
+        // 规范化：去除已有 .md 后缀后统一追加，防止 .md.md
+        if (specPath.endsWith(".md")) {
+            specPath = specPath.slice(0, -3);
+        }
+        const fullPath = path.resolve(projectRoot, ".trellis", "spec", `${specPath}.md`);
+        if (!fullPath.startsWith(specRoot))
+            return null;
+        return fs.existsSync(fullPath) ? fullPath : null;
+    }
+    return null;
+}
+/**
+ * 解析 context.jsonl 文件
+ * 每行一条 JSON 记录，跳过空行和解析失败的行
+ * @param jsonlPath - context.jsonl 文件绝对路径
+ * @returns 解析后的条目数组
+ */
+function parseContextJsonl(jsonlPath) {
+    const content = fs.readFileSync(jsonlPath, "utf-8");
+    const entries = [];
+    for (const line of content.split("\n")) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        try {
+            entries.push(JSON.parse(trimmed));
+        }
+        catch (err) {
+            // 记录解析失败的行，便于排查 context.jsonl 格式错误
+            console.warn(`[hash-utils] context.jsonl 解析失败，跳过该行: ${trimmed.substring(0, 80)}`);
+        }
+    }
+    return entries;
+}
+/**
+ * 生成 Phase-Frozen 快照
+ * 读取任务目录下的 context.jsonl，为每条 URI 条目计算 content_hash，
+ * 填入 frozen_at 时间戳，写入 context-snapshot-{phase}.jsonl
+ *
+ * @param taskDir - 任务目录绝对路径
+ * @param phase - 阶段标识（如 "implement"）
+ * @returns 快照结果，context.jsonl 不存在时返回 null
+ */
+function generateSnapshot(taskDir, phase) {
+    const contextPath = path.join(taskDir, "context.jsonl");
+    if (!fs.existsSync(contextPath)) {
+        return null;
+    }
+    const entries = parseContextJsonl(contextPath);
+    const frozenAt = new Date().toISOString();
+    // 为每条记录计算 content_hash 并设置 frozen_at
+    const frozenEntries = entries.map((entry) => {
+        const filePath = resolveUriToPath(entry.uri);
+        const contentHash = filePath ? computeContentHash(filePath) : (entry.content_hash || "");
+        return {
+            ...entry,
+            content_hash: contentHash,
+            frozen_at: frozenAt,
+        };
+    });
+    // 写入快照文件
+    const snapshotPath = path.join(taskDir, `context-snapshot-${phase}.jsonl`);
+    const snapshotContent = frozenEntries
+        .map((e) => JSON.stringify(e))
+        .join("\n");
+    fs.writeFileSync(snapshotPath, snapshotContent + "\n", "utf-8");
+    return {
+        snapshotPath,
+        entriesCount: frozenEntries.length,
+        frozenAt,
+    };
+}
+/**
+ * Stale 检测 — 比对快照中每条记录的 content_hash 与当前文件 hash
+ * @param snapshotPath - 快照文件绝对路径
+ * @returns stale 检测结果
+ */
+function checkStale(snapshotPath) {
+    if (!fs.existsSync(snapshotPath)) {
+        return { totalEntries: 0, staleEntries: [], allFresh: true };
+    }
+    const entries = parseContextJsonl(snapshotPath);
+    const staleEntries = [];
+    for (const entry of entries) {
+        if (!entry.content_hash)
+            continue;
+        const filePath = resolveUriToPath(entry.uri);
+        // 文件已删除或重命名 → 标记为 stale（漂移的最严重形式）
+        if (!filePath) {
+            staleEntries.push({
+                uri: entry.uri,
+                snapshotHash: entry.content_hash,
+                currentHash: "deleted",
+            });
+            continue;
+        }
+        const currentHash = computeContentHash(filePath);
+        if (currentHash !== entry.content_hash) {
+            staleEntries.push({
+                uri: entry.uri,
+                snapshotHash: entry.content_hash,
+                currentHash,
+            });
+        }
+    }
+    return {
+        totalEntries: entries.length,
+        staleEntries,
+        allFresh: staleEntries.length === 0,
+    };
+}
+export { computeContentHash, resolveUriToPath, parseContextJsonl, generateSnapshot, checkStale, };
+//# sourceMappingURL=hash-utils.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hash-utils.js","sourceRoot":"","sources":["../../src/utils/hash-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AAEtC,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AA+CjD,iCAAiC;AAEjC;;;;GAIG;AACH,SAAS,kBAAkB,CAAC,QAAgB;IAC1C,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACnD,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,OAAO,UAAU,IAAI,EAAE,CAAC;AAC1B,CAAC;AAED;;;;;GAKG;AACH,SAAS,gBAAgB,CAAC,GAAW;IACnC,MAAM,WAAW,GAAG,cAAc,EAAE,CAAC;IACrC,wCAAwC;IACxC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,UAAU,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC;IAEvE,kCAAkC;IAClC,IAAI,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC9B,IAAI,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QAC1C,iCAAiC;QACjC,IAAI,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YAC7B,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACnC,CAAC;QACD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAC3B,WAAW,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,QAAQ,KAAK,CAClD,CAAC;QACF,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,QAAQ,CAAC;YAAE,OAAO,IAAI,CAAC;QAChD,OAAO,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC;IACnD,CAAC;IAED,mCAAmC;IACnC,IAAI,GAAG,CAAC,UAAU,CAAC,iBAAiB,CAAC,EAAE,CAAC;QACtC,IAAI,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC;QAClD,iCAAiC;QACjC,IAAI,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YAC7B,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACnC,CAAC;QACD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAC3B,WAAW,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,QAAQ,KAAK,CAClD,CAAC;QACF,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,QAAQ,CAAC;YAAE,OAAO,IAAI,CAAC;QAChD,OAAO,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC;IACnD,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;GAKG;AACH,SAAS,iBAAiB,CAAC,SAAiB;IAC1C,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACpD,MAAM,OAAO,GAAmB,EAAE,CAAC;IAEnC,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACvC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC5B,IAAI,CAAC,OAAO;YAAE,SAAS;QAEvB,IAAI,CAAC;YACH,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAiB,CAAC,CAAC;QACpD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,mCAAmC;YACnC,OAAO,CAAC,IAAI,CACV,yCAAyC,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CACpE,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;;;GAQG;AACH,SAAS,gBAAgB,CACvB,OAAe,EACf,KAAa;IAEb,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;IAExD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAChC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,OAAO,GAAG,iBAAiB,CAAC,WAAW,CAAC,CAAC;IAC/C,MAAM,QAAQ,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAE1C,qCAAqC;IACrC,MAAM,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QAC1C,MAAM,QAAQ,GAAG,gBAAgB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC7C,MAAM,WAAW,GAAG,QAAQ,CAAC,CAAC,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAC5D,KAAK,CAAC,YAAY,IAAI,EAAE,CACzB,CAAC;QAEF,OAAO;YACL,GAAG,KAAK;YACR,YAAY,EAAE,WAAW;YACzB,SAAS,EAAE,QAAQ;SACpB,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,SAAS;IACT,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAC5B,OAAO,EAAE,oBAAoB,KAAK,QAAQ,CAC3C,CAAC;IACF,MAAM,eAAe,GAAG,aAAa;SAClC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;SAC7B,IAAI,CAAC,IAAI,CAAC,CAAC;IACd,EAAE,CAAC,aAAa,CAAC,YAAY,EAAE,eAAe,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;IAEhE,OAAO;QACL,YAAY;QACZ,YAAY,EAAE,aAAa,CAAC,MAAM;QAClC,QAAQ;KACT,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,SAAS,UAAU,CAAC,YAAoB;IACtC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QACjC,OAAO,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC/D,CAAC;IAED,MAAM,OAAO,GAAG,iBAAiB,CAAC,YAAY,CAAC,CAAC;IAChD,MAAM,YAAY,GAAiB,EAAE,CAAC;IAEtC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,CAAC,KAAK,CAAC,YAAY;YAAE,SAAS;QAElC,MAAM,QAAQ,GAAG,gBAAgB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAE7C,kCAAkC;QAClC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,YAAY,CAAC,IAAI,CAAC;gBAChB,GAAG,EAAE,KAAK,CAAC,GAAG;gBACd,YAAY,EAAE,KAAK,CAAC,YAAY;gBAChC,WAAW,EAAE,SAAS;aACvB,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QAED,MAAM,WAAW,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC;QACjD,IAAI,WAAW,KAAK,KAAK,CAAC,YAAY,EAAE,CAAC;YACvC,YAAY,CAAC,IAAI,CAAC;gBAChB,GAAG,EAAE,KAAK,CAAC,GAAG;gBACd,YAAY,EAAE,KAAK,CAAC,YAAY;gBAChC,WAAW;aACZ,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO;QACL,YAAY,EAAE,OAAO,CAAC,MAAM;QAC5B,YAAY;QACZ,QAAQ,EAAE,YAAY,CAAC,MAAM,KAAK,CAAC;KACpC,CAAC;AACJ,CAAC;AAWD,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,UAAU,GACX,CAAC"}

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

@@ -0,0 +1,69 @@
+declare const WORKSPACE_ROOT = ".trellis/workspace";
+declare const MAX_LINES_PER_FILE = 2000;
+declare const DEFAULT_USER = "default";
+/**
+ * Journal 条目接口
+ */
+export interface JournalEntry {
+    date: string;
+    tags: string[];
+    tasks_touched?: string[];
+    content: string;
+}
+/**
+ * 日志搜索查询选项
+ */
+interface JournalSearchQuery {
+    tags?: string[];
+    keywords?: string[];
+    date_range?: {
+        from?: string;
+        to?: string;
+    };
+}
+/**
+ * 获取用户 journal 目录
+ * 按 architecture §6.4，journal 文件位于 .trellis/workspace/{user}/
+ * @param user - 用户名，默认为 'default'
+ * @returns journal 目录的绝对路径
+ */
+declare function getJournalDir(user?: string): string;
+/**
+ * 获取最新（或当前活跃）的 journal 文件路径
+ * 返回当前正在写入的文件（最高页码的文件，或 journal.md 如果不存在编号文件）
+ * @param user - 用户名，默认为 'default'
+ * @returns 最新 journal 文件的绝对路径
+ */
+declare function getLatestJournalFile(user?: string): string;
+/**
+ * 追加日志条目到 journal 文件
+ * 如果当前文件超过 MAX_LINES_PER_FILE，自动创建新文件
+ * @param entry - 日志条目
+ * @param user - 用户名，默认为 'default'
+ */
+declare function appendJournalEntry(entry: JournalEntry, user?: string): void;
+/**
+ * 解析 journal 文件中的所有条目
+ * 条目由 YAML frontmatter 包裹，使用 `---` 作为开始和结束标记
+ * @param content - journal 文件内容
+ * @returns 解析后的日志条目列表
+ */
+declare function parseJournalEntries(content: string): JournalEntry[];
+/**
+ * 搜索日志条目
+ * @param query - 搜索查询选项
+ * @param user - 用户名，默认为 'default'
+ * @returns 匹配的日志条目列表
+ */
+declare function searchJournal(query: JournalSearchQuery, user?: string): JournalEntry[];
+/**
+ * 获取最新的 N 条日志条目
+ * 条目按时间倒序排列（最新的在前）
+ * @param count - 获取的条目数量，默认为 10
+ * @param user - 用户名，默认为 'default'
+ * @returns 最新的日志条目列表
+ */
+declare function getLatestEntries(count?: number, user?: string): JournalEntry[];
+export type { JournalSearchQuery };
+export { WORKSPACE_ROOT, MAX_LINES_PER_FILE, DEFAULT_USER, getJournalDir, getLatestJournalFile, appendJournalEntry, parseJournalEntries, searchJournal, getLatestEntries, };
+//# sourceMappingURL=journal-utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"journal-utils.d.ts","sourceRoot":"","sources":["../../src/utils/journal-utils.ts"],"names":[],"mappings":"AAMA,QAAA,MAAM,cAAc,uBAAuB,CAAC;AAC5C,QAAA,MAAM,kBAAkB,OAAO,CAAC;AAChC,QAAA,MAAM,YAAY,YAAY,CAAC;AAI/B;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,UAAU,kBAAkB;IAC1B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,UAAU,CAAC,EAAE;QACX,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,EAAE,CAAC,EAAE,MAAM,CAAC;KACb,CAAC;CACH;AAID;;;;;GAKG;AACH,iBAAS,aAAa,CAAC,IAAI,GAAE,MAAqB,GAAG,MAAM,CAU1D;AAED;;;;;GAKG;AACH,iBAAS,oBAAoB,CAAC,IAAI,GAAE,MAAqB,GAAG,MAAM,CA8BjE;AAoCD;;;;;GAKG;AACH,iBAAS,kBAAkB,CACzB,KAAK,EAAE,YAAY,EACnB,IAAI,GAAE,MAAqB,GAC1B,IAAI,CAuBN;AAqDD;;;;;GAKG;AACH,iBAAS,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,EAAE,CA6E5D;AA+ED;;;;;GAKG;AACH,iBAAS,aAAa,CACpB,KAAK,EAAE,kBAAkB,EACzB,IAAI,GAAE,MAAqB,GAC1B,YAAY,EAAE,CA0EhB;AAED;;;;;;GAMG;AACH,iBAAS,gBAAgB,CACvB,KAAK,GAAE,MAAW,EAClB,IAAI,GAAE,MAAqB,GAC1B,YAAY,EAAE,CAIhB;AAID,YAAY,EAAE,kBAAkB,EAAE,CAAC;AACnC,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,YAAY,EACZ,aAAa,EACb,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,EACnB,aAAa,EACb,gBAAgB,GACjB,CAAC"}