@zooique/memora 0.1.0

package/dist/utils/frontmatter.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Frontmatter 通用解析/序列化工具
+ *
+ * 为 memory/store.ts、persona/personaManager.ts、skill/skillManager.ts 提供共享的 frontmatter 处理
+ * 详见 ADR-004 · 记忆统一为"类型 + 永久性标记"模型
+ */
+/**
+ * 解析 frontmatter 块为键值对
+ *
+ * @param raw 完整 markdown 内容（含 `---` 包围的 frontmatter）
+ * @returns `{ frontmatter, body }`——frontmatter 为键值对对象，body 为 frontmatter 之后的内容
+ */
+export declare function parseFrontmatter(raw: string): {
+    frontmatter: Record<string, string>;
+    body: string;
+};
+/**
+ * 序列化 frontmatter 为 YAML 块内容（不含 `---` 包围符）
+ *
+ * @param frontmatter 键值对对象
+ * @returns 可拼接进 `---\n${result}\n---\n${body}` 的字符串
+ */
+export declare function serializeFrontmatter(frontmatter: Record<string, string>): string;
+//# sourceMappingURL=frontmatter.d.ts.map

package/dist/utils/frontmatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.d.ts","sourceRoot":"","sources":["../../src/utils/frontmatter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG;IAC7C,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,IAAI,EAAE,MAAM,CAAC;CACd,CAkBA;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAKhF"}

package/dist/utils/frontmatter.js

@@ -0,0 +1,44 @@
+/**
+ * Frontmatter 通用解析/序列化工具
+ *
+ * 为 memory/store.ts、persona/personaManager.ts、skill/skillManager.ts 提供共享的 frontmatter 处理
+ * 详见 ADR-004 · 记忆统一为"类型 + 永久性标记"模型
+ */
+/**
+ * 解析 frontmatter 块为键值对
+ *
+ * @param raw 完整 markdown 内容（含 `---` 包围的 frontmatter）
+ * @returns `{ frontmatter, body }`——frontmatter 为键值对对象，body 为 frontmatter 之后的内容
+ */
+export function parseFrontmatter(raw) {
+    const normalized = raw.replace(/\r\n/g, '\n');
+    const match = normalized.match(/^---\n([\s\S]*?)\n---\n([\s\S]*)$/);
+    if (!match || !match[1] || !match[2]) {
+        return { frontmatter: {}, body: raw };
+    }
+    const [, fmBlock, body] = match;
+    const frontmatter = {};
+    for (const line of fmBlock.split('\n')) {
+        const idx = line.indexOf(':');
+        if (idx < 0)
+            continue;
+        const k = line.slice(0, idx).trim();
+        const v = line.slice(idx + 1).trim();
+        if (k && v)
+            frontmatter[k] = v;
+    }
+    return { frontmatter, body };
+}
+/**
+ * 序列化 frontmatter 为 YAML 块内容（不含 `---` 包围符）
+ *
+ * @param frontmatter 键值对对象
+ * @returns 可拼接进 `---\n${result}\n---\n${body}` 的字符串
+ */
+export function serializeFrontmatter(frontmatter) {
+    return Object.entries(frontmatter)
+        .filter(([, v]) => v !== undefined && v !== null)
+        .map(([k, v]) => `${k}: ${v}`)
+        .join('\n');
+}
+//# sourceMappingURL=frontmatter.js.map

package/dist/utils/frontmatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.js","sourceRoot":"","sources":["../../src/utils/frontmatter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAI1C,MAAM,UAAU,GAAG,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAC9C,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,mCAAmC,CAAC,CAAC;IACpE,IAAI,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QACrC,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC;IACxC,CAAC;IAED,MAAM,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,GAAG,KAAK,CAAC;IAChC,MAAM,WAAW,GAA2B,EAAE,CAAC;IAC/C,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACvC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC9B,IAAI,GAAG,GAAG,CAAC;YAAE,SAAS;QACtB,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QACpC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACrC,IAAI,CAAC,IAAI,CAAC;YAAE,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACjC,CAAC;IAED,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;AAC/B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,WAAmC;IACtE,OAAO,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC;SAC/B,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,IAAI,CAAC;SAChD,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;SAC7B,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC"}

package/dist/utils/json.d.ts

@@ -0,0 +1,20 @@
+/**
+ * JSON 工具函数
+ *
+ * 从 InsightExtractor 和 WorkProjectionManager 提取的公共 JSON 解析函数，
+ * 统一 LLM 输出的 JSON 解析策略。
+ */
+/**
+ * 从 LLM 输出中解析 JSON
+ *
+ * 解析策略（逐级回退）：
+ *   1. 直接 JSON.parse
+ *   2. 剥离 markdown 代码块标记后重试
+ *   3. 修复常见错误（单引号、尾逗号）后重试
+ *   4. 正则提取首个 JSON 对象
+ *
+ * @param raw - LLM 原始输出文本
+ * @returns 解析结果，解析失败返回 null
+ */
+export declare function parseLlmJson<T = unknown>(raw: string): T | null;
+//# sourceMappingURL=json.d.ts.map

package/dist/utils/json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../src/utils/json.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,CA6C/D"}

package/dist/utils/json.js

@@ -0,0 +1,65 @@
+/**
+ * JSON 工具函数
+ *
+ * 从 InsightExtractor 和 WorkProjectionManager 提取的公共 JSON 解析函数，
+ * 统一 LLM 输出的 JSON 解析策略。
+ */
+/**
+ * 从 LLM 输出中解析 JSON
+ *
+ * 解析策略（逐级回退）：
+ *   1. 直接 JSON.parse
+ *   2. 剥离 markdown 代码块标记后重试
+ *   3. 修复常见错误（单引号、尾逗号）后重试
+ *   4. 正则提取首个 JSON 对象
+ *
+ * @param raw - LLM 原始输出文本
+ * @returns 解析结果，解析失败返回 null
+ */
+export function parseLlmJson(raw) {
+    const trimmed = raw.trim();
+    if (!trimmed || trimmed === 'null')
+        return null;
+    // 1. 直接解析
+    try {
+        return JSON.parse(trimmed);
+    }
+    catch {
+        // 继续
+    }
+    // 2. 剥离 markdown 代码块标记（```json ... ```）
+    const codeBlockMatch = trimmed.match(/```(?:json)?\s*\n?([\s\S]*?)\n?\s*```/);
+    if (codeBlockMatch?.[1]) {
+        try {
+            return JSON.parse(codeBlockMatch[1].trim());
+        }
+        catch {
+            // 继续
+        }
+    }
+    // 3. 修复常见错误后重试
+    // 只替换作为 JSON key/value 定界符的单引号，不替换字符串内容中的单引号
+    // 匹配模式：单引号紧跟在 {, [, :, , 后面（定界符位置），或紧靠在 }, ], ,, : 前面
+    const fixed = trimmed
+        .replace(/(?<=[{\[:,\s])'|'(?=[}\]:,\s])/g, '"')
+        .replace(/,\s*}/g, '}')
+        .replace(/,\s*]/g, ']');
+    try {
+        return JSON.parse(fixed);
+    }
+    catch {
+        // 继续
+    }
+    // 4. 正则提取首个 JSON 对象
+    const objectMatch = trimmed.match(/\{[\s\S]*\}/);
+    if (objectMatch) {
+        try {
+            return JSON.parse(objectMatch[0]);
+        }
+        catch {
+            // 放弃
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=json.js.map

package/dist/utils/json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../../src/utils/json.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,YAAY,CAAc,GAAW;IACnD,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAC3B,IAAI,CAAC,OAAO,IAAI,OAAO,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC;IAEhD,UAAU;IACV,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAM,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,KAAK;IACP,CAAC;IAED,wCAAwC;IACxC,MAAM,cAAc,GAAG,OAAO,CAAC,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC9E,IAAI,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxB,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAM,CAAC;QACnD,CAAC;QAAC,MAAM,CAAC;YACP,KAAK;QACP,CAAC;IACH,CAAC;IAED,eAAe;IACf,6CAA6C;IAC7C,sDAAsD;IACtD,MAAM,KAAK,GAAG,OAAO;SAClB,OAAO,CAAC,iCAAiC,EAAE,GAAG,CAAC;SAC/C,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC;SACtB,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IAC1B,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAM,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACP,KAAK;IACP,CAAC;IAED,oBAAoB;IACpB,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;IACjD,IAAI,WAAW,EAAE,CAAC;QAChB,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,CAAM,CAAC;QACzC,CAAC;QAAC,MAAM,CAAC;YACP,KAAK;QACP,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/utils/loggerHolder.d.ts

@@ -0,0 +1,37 @@
+/**
+ * utils 层日志持有器 — 解耦 utils → logging 的运行时依赖
+ *
+ * 设计动机：
+ *   utils 是最底层工具层，不应运行时依赖 logging/（业务层）。
+ *   但 utils 中的错误日志、事件容错、扫描诊断需要日志能力。
+ *   通过 holder 模式，utils 运行时只依赖此模块（同层），
+ *   实际 logger 实例由 logging/ 在模块加载时注入。
+ *
+ * 依赖方向：
+ *   - utils/* → utils/loggerHolder.ts（同层，运行时）
+ *   - utils/loggerHolder.ts → logging/loggerInterface.ts（type-only，编译时擦除）
+ *   - logging/logger.ts → utils/loggerHolder.ts（运行时，桥接注入）
+ *
+ * 使用方式：
+ *   // utils 内部使用
+ *   import { getLogger } from './loggerHolder.js';
+ *   getLogger().warn({ dir }, '扫描目录失败');
+ *
+ *   // logging 层桥接（自动执行，无需手动调用）
+ *   // logging/logger.ts 模块加载时自动调用 setLogger(logger)
+ */
+import type { ILogger } from '../logging/loggerInterface.js';
+/**
+ * 获取当前 logger 实例
+ *
+ * utils 模块统一通过此函数获取 logger，而非直接 import logging/logger.ts。
+ * 在 logging/logger.ts 模块加载前，返回 noopLogger（不输出日志）。
+ */
+export declare function getLogger(): ILogger;
+/**
+ * 注入 logger 实例（由 logging/logger.ts 自动调用）
+ *
+ * 传入 undefined 则恢复为 noopLogger。
+ */
+export declare function setLogger(logger: ILogger | undefined): void;
+//# sourceMappingURL=loggerHolder.d.ts.map

package/dist/utils/loggerHolder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loggerHolder.d.ts","sourceRoot":"","sources":["../../src/utils/loggerHolder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAC;AAa5D;;;;;GAKG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAEnC;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,OAAO,GAAG,SAAS,GAAG,IAAI,CAE3D"}

package/dist/utils/loggerHolder.js

@@ -0,0 +1,49 @@
+/**
+ * utils 层日志持有器 — 解耦 utils → logging 的运行时依赖
+ *
+ * 设计动机：
+ *   utils 是最底层工具层，不应运行时依赖 logging/（业务层）。
+ *   但 utils 中的错误日志、事件容错、扫描诊断需要日志能力。
+ *   通过 holder 模式，utils 运行时只依赖此模块（同层），
+ *   实际 logger 实例由 logging/ 在模块加载时注入。
+ *
+ * 依赖方向：
+ *   - utils/* → utils/loggerHolder.ts（同层，运行时）
+ *   - utils/loggerHolder.ts → logging/loggerInterface.ts（type-only，编译时擦除）
+ *   - logging/logger.ts → utils/loggerHolder.ts（运行时，桥接注入）
+ *
+ * 使用方式：
+ *   // utils 内部使用
+ *   import { getLogger } from './loggerHolder.js';
+ *   getLogger().warn({ dir }, '扫描目录失败');
+ *
+ *   // logging 层桥接（自动执行，无需手动调用）
+ *   // logging/logger.ts 模块加载时自动调用 setLogger(logger)
+ */
+/** 空操作 logger — 默认实现，不输出任何日志 */
+const noopLogger = {
+    debug: () => { },
+    info: () => { },
+    warn: () => { },
+    error: () => { },
+};
+/** 当前注入的 logger 实例（默认 noop，由 logging/logger.ts 桥接注入） */
+let currentLogger = noopLogger;
+/**
+ * 获取当前 logger 实例
+ *
+ * utils 模块统一通过此函数获取 logger，而非直接 import logging/logger.ts。
+ * 在 logging/logger.ts 模块加载前，返回 noopLogger（不输出日志）。
+ */
+export function getLogger() {
+    return currentLogger;
+}
+/**
+ * 注入 logger 实例（由 logging/logger.ts 自动调用）
+ *
+ * 传入 undefined 则恢复为 noopLogger。
+ */
+export function setLogger(logger) {
+    currentLogger = logger ?? noopLogger;
+}
+//# sourceMappingURL=loggerHolder.js.map

package/dist/utils/loggerHolder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loggerHolder.js","sourceRoot":"","sources":["../../src/utils/loggerHolder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAIH,gCAAgC;AAChC,MAAM,UAAU,GAAY;IAC1B,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC;IACf,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC;IACd,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC;IACd,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC;CAChB,CAAC;AAEF,wDAAwD;AACxD,IAAI,aAAa,GAAY,UAAU,CAAC;AAExC;;;;;GAKG;AACH,MAAM,UAAU,SAAS;IACvB,OAAO,aAAa,CAAC;AACvB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,MAA2B;IACnD,aAAa,GAAG,MAAM,IAAI,UAAU,CAAC;AACvC,CAAC"}

package/dist/utils/math.d.ts

@@ -0,0 +1,5 @@
+/**
+ * 数学工具函数
+ */
+export declare function cosineSimilarity(a: number[], b: number[]): number;
+//# sourceMappingURL=math.d.ts.map

package/dist/utils/math.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"math.d.ts","sourceRoot":"","sources":["../../src/utils/math.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAajE"}

package/dist/utils/math.js

@@ -0,0 +1,19 @@
+/**
+ * 数学工具函数
+ */
+export function cosineSimilarity(a, b) {
+    if (a.length !== b.length)
+        return 0;
+    let dot = 0;
+    let normA = 0;
+    let normB = 0;
+    for (let i = 0; i < a.length; i++) {
+        // QC-17 移除非空断言：循环条件保证索引有效，用 ?? 0 兜底（数学上 0 不影响点积）
+        dot += (a[i] ?? 0) * (b[i] ?? 0);
+        normA += (a[i] ?? 0) * (a[i] ?? 0);
+        normB += (b[i] ?? 0) * (b[i] ?? 0);
+    }
+    const denominator = Math.sqrt(normA) * Math.sqrt(normB);
+    return denominator === 0 ? 0 : dot / denominator;
+}
+//# sourceMappingURL=math.js.map

package/dist/utils/math.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"math.js","sourceRoot":"","sources":["../../src/utils/math.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,CAAW,EAAE,CAAW;IACvD,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM;QAAE,OAAO,CAAC,CAAC;IACpC,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,iDAAiD;QACjD,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QACjC,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QACnC,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IACrC,CAAC;IACD,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACxD,OAAO,WAAW,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,WAAW,CAAC;AACnD,CAAC"}

package/dist/utils/path.d.ts

@@ -0,0 +1,28 @@
+/**
+ * 路径工具函数
+ *
+ * 从 workProjection.ts 提取的公共路径处理函数，
+ * 消除跨模块 `filePath.split(/[/\\]/).pop()` 内联重复。
+ * 跨平台兼容（同时处理 / 和 \ 分隔符）。
+ */
+/**
+ * 提取路径的 basename（最后一段）
+ *
+ * 跨平台兼容：同时处理 Unix `/` 和 Windows `\` 分隔符。
+ * 空路径或纯分隔符路径返回空字符串。
+ *
+ * @param filePath 文件路径
+ * @returns basename，如 "/a/b/c.txt" → "c.txt"
+ */
+export declare function basename(filePath: string): string;
+/**
+ * 展开路径中的 `~` 为用户家目录
+ *
+ * 仅处理开头的 `~`，不处理 `~otheruser` 等形式。
+ * 不含 `~` 的路径原样返回。
+ *
+ * @param p 可能包含 `~` 的路径字符串
+ * @returns 展开后的路径，如 "~/data" → "C:\\Users\\SJ\\data"
+ */
+export declare function expandHome(p: string): string;
+//# sourceMappingURL=path.d.ts.map

package/dist/utils/path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.d.ts","sourceRoot":"","sources":["../../src/utils/path.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE5C"}

package/dist/utils/path.js

@@ -0,0 +1,33 @@
+/**
+ * 路径工具函数
+ *
+ * 从 workProjection.ts 提取的公共路径处理函数，
+ * 消除跨模块 `filePath.split(/[/\\]/).pop()` 内联重复。
+ * 跨平台兼容（同时处理 / 和 \ 分隔符）。
+ */
+import { homedir } from 'node:os';
+/**
+ * 提取路径的 basename（最后一段）
+ *
+ * 跨平台兼容：同时处理 Unix `/` 和 Windows `\` 分隔符。
+ * 空路径或纯分隔符路径返回空字符串。
+ *
+ * @param filePath 文件路径
+ * @returns basename，如 "/a/b/c.txt" → "c.txt"
+ */
+export function basename(filePath) {
+    return filePath.split(/[/\\]/).pop() ?? '';
+}
+/**
+ * 展开路径中的 `~` 为用户家目录
+ *
+ * 仅处理开头的 `~`，不处理 `~otheruser` 等形式。
+ * 不含 `~` 的路径原样返回。
+ *
+ * @param p 可能包含 `~` 的路径字符串
+ * @returns 展开后的路径，如 "~/data" → "C:\\Users\\SJ\\data"
+ */
+export function expandHome(p) {
+    return p.replace(/^~/, homedir());
+}
+//# sourceMappingURL=path.js.map

package/dist/utils/path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.js","sourceRoot":"","sources":["../../src/utils/path.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElC;;;;;;;;GAQG;AACH,MAAM,UAAU,QAAQ,CAAC,QAAgB;IACvC,OAAO,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;AAC7C,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,UAAU,CAAC,CAAS;IAClC,OAAO,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;AACpC,CAAC"}

package/dist/utils/safeTimer.d.ts

@@ -0,0 +1,26 @@
+/**
+ * 安全定时器工具 — 提供可追踪的生命周期管理
+ *
+ * 原生 setTimeout / setInterval 不跟踪定时器 ID，
+ * 如果忘记清理可能导致内存泄漏。本模块提供轻量包装，
+ * 统一管理定时器的创建和清理。
+ */
+/**
+ * 安全的 setTimeout 包装
+ * 返回的 timer ID 可用于 clearSafeTimeout 清理
+ */
+export declare function safeSetTimeout(callback: () => void, ms: number): ReturnType<typeof setTimeout>;
+/**
+ * 安全的 setInterval 包装
+ * 返回的 timer ID 可用于 clearSafeInterval 清理
+ */
+export declare function safeSetInterval(callback: () => void, ms: number): ReturnType<typeof setInterval>;
+/**
+ * 清理安全的 setTimeout
+ */
+export declare function clearSafeTimeout(id: ReturnType<typeof setTimeout> | null): void;
+/**
+ * 清理安全的 setInterval
+ */
+export declare function clearSafeInterval(id: ReturnType<typeof setInterval> | null): void;
+//# sourceMappingURL=safeTimer.d.ts.map

package/dist/utils/safeTimer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"safeTimer.d.ts","sourceRoot":"","sources":["../../src/utils/safeTimer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,IAAI,EACpB,EAAE,EAAE,MAAM,GACT,UAAU,CAAC,OAAO,UAAU,CAAC,CAO/B;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,IAAI,EACpB,EAAE,EAAE,MAAM,GACT,UAAU,CAAC,OAAO,WAAW,CAAC,CAIhC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,GAAG,IAAI,GAAG,IAAI,CAK/E;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,GAAG,IAAI,GAAG,IAAI,CAKjF"}

package/dist/utils/safeTimer.js

@@ -0,0 +1,49 @@
+/**
+ * 安全定时器工具 — 提供可追踪的生命周期管理
+ *
+ * 原生 setTimeout / setInterval 不跟踪定时器 ID，
+ * 如果忘记清理可能导致内存泄漏。本模块提供轻量包装，
+ * 统一管理定时器的创建和清理。
+ */
+/** 定时器注册表，用于跟踪所有活跃定时器 */
+const activeTimers = new Set();
+/**
+ * 安全的 setTimeout 包装
+ * 返回的 timer ID 可用于 clearSafeTimeout 清理
+ */
+export function safeSetTimeout(callback, ms) {
+    const id = setTimeout(() => {
+        activeTimers.delete(id);
+        callback();
+    }, ms);
+    activeTimers.add(id);
+    return id;
+}
+/**
+ * 安全的 setInterval 包装
+ * 返回的 timer ID 可用于 clearSafeInterval 清理
+ */
+export function safeSetInterval(callback, ms) {
+    const id = setInterval(callback, ms);
+    activeTimers.add(id);
+    return id;
+}
+/**
+ * 清理安全的 setTimeout
+ */
+export function clearSafeTimeout(id) {
+    if (id !== null) {
+        clearTimeout(id);
+        activeTimers.delete(id);
+    }
+}
+/**
+ * 清理安全的 setInterval
+ */
+export function clearSafeInterval(id) {
+    if (id !== null) {
+        clearInterval(id);
+        activeTimers.delete(id);
+    }
+}
+//# sourceMappingURL=safeTimer.js.map

package/dist/utils/safeTimer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safeTimer.js","sourceRoot":"","sources":["../../src/utils/safeTimer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,yBAAyB;AACzB,MAAM,YAAY,GAAG,IAAI,GAAG,EAAkE,CAAC;AAE/F;;;GAGG;AACH,MAAM,UAAU,cAAc,CAC5B,QAAoB,EACpB,EAAU;IAEV,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,EAAE;QACzB,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACxB,QAAQ,EAAE,CAAC;IACb,CAAC,EAAE,EAAE,CAAC,CAAC;IACP,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACrB,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAC7B,QAAoB,EACpB,EAAU;IAEV,MAAM,EAAE,GAAG,WAAW,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IACrC,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACrB,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,EAAwC;IACvE,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;QAChB,YAAY,CAAC,EAAE,CAAC,CAAC;QACjB,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC1B,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,EAAyC;IACzE,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;QAChB,aAAa,CAAC,EAAE,CAAC,CAAC;QAClB,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC1B,CAAC;AACH,CAAC"}

package/dist/utils/scanner.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Markdown 目录扫描工具
+ *
+ * 从 PersonaManager / SkillManager 提取的公共目录扫描逻辑，
+ * 消除跨模块重复的"扫描 *.md → 解析 frontmatter → 提取字段"代码。
+ *
+ * 使用异步 I/O（与 FileStore / ToolExecutor 保持一致）。
+ */
+/** 扫描结果条目（通用 frontmatter 解析产物） */
+export interface ScannedMarkdownEntry {
+    /** 名称（frontmatter name 字段或文件名去 .md） */
+    name: string;
+    /** frontmatter 原始键值对 */
+    frontmatter: Record<string, string>;
+    /** frontmatter 之后的正文 */
+    body: string;
+    /** 文件绝对路径 */
+    filePath: string;
+}
+/**
+ * 扫描目录下的 *.md 文件，解析 frontmatter
+ *
+ * 排除规则：
+ *   - 文件名以 `.` 开头的隐藏文件
+ *   - 文件名以 `_` 前缀的私有文件
+ *   - README.md / CHANGELOG.md / LICENSE
+ *
+ * @param dir 目录路径
+ * @returns 解析后的条目列表
+ */
+export declare function scanMarkdownDir(dir: string): Promise<ScannedMarkdownEntry[]>;
+/**
+ * 从 frontmatter 中解析逗号分隔的关键词列表
+ *
+ * @param fm frontmatter 键值对
+ * @param key 关键词字段名（默认 'keywords'）
+ * @returns 关键词数组
+ */
+export declare function parseKeywords(fm: Record<string, string>, key?: string): string[];
+/**
+ * 从 frontmatter 中解析正则触发器
+ *
+ * 支持格式：/pattern/flags 或纯 pattern（默认 'i' flag）
+ *
+ * @param fm frontmatter 键值对
+ * @param key 触发器字段名（默认 'trigger'）
+ * @returns 正则表达式，解析失败返回 undefined
+ */
+export declare function parseTrigger(fm: Record<string, string>, key?: string): RegExp | undefined;
+/**
+ * 解析目录路径：如果 configDir 存在则 resolve 子目录，否则返回 undefined
+ */
+export declare function resolveSubdir(configDir: string | undefined, sub: string): string | undefined;
+//# sourceMappingURL=scanner.d.ts.map

package/dist/utils/scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.d.ts","sourceRoot":"","sources":["../../src/utils/scanner.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAUH,kCAAkC;AAClC,MAAM,WAAW,oBAAoB;IACnC,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,wBAAwB;IACxB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,wBAAwB;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,aAAa;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC,CA0ClF;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,SAAa,GAAG,MAAM,EAAE,CAOpF;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,SAAY,GAAG,MAAM,GAAG,SAAS,CAgB5F;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG5F"}

package/dist/utils/scanner.js

@@ -0,0 +1,115 @@
+/**
+ * Markdown 目录扫描工具
+ *
+ * 从 PersonaManager / SkillManager 提取的公共目录扫描逻辑，
+ * 消除跨模块重复的"扫描 *.md → 解析 frontmatter → 提取字段"代码。
+ *
+ * 使用异步 I/O（与 FileStore / ToolExecutor 保持一致）。
+ */
+import { readFile, readdir, access } from 'node:fs/promises';
+import { resolve, join, basename } from 'node:path';
+import { parseFrontmatter } from '../utils/frontmatter.js';
+import { getLogger } from '../utils/loggerHolder.js';
+/** 排除的文件名（README / CHANGELOG / LICENSE 不纳入扫描） */
+const EXCLUDED_FILES = new Set(['README.md', 'CHANGELOG.md', 'LICENSE']);
+/**
+ * 扫描目录下的 *.md 文件，解析 frontmatter
+ *
+ * 排除规则：
+ *   - 文件名以 `.` 开头的隐藏文件
+ *   - 文件名以 `_` 前缀的私有文件
+ *   - README.md / CHANGELOG.md / LICENSE
+ *
+ * @param dir 目录路径
+ * @returns 解析后的条目列表
+ */
+export async function scanMarkdownDir(dir) {
+    try {
+        await access(dir);
+    }
+    catch {
+        getLogger().debug({ dir }, '扫描目录不存在，跳过');
+        return [];
+    }
+    let files;
+    try {
+        files = (await readdir(dir)).filter((f) => f.endsWith('.md') &&
+            !f.startsWith('.') &&
+            !f.startsWith('_') &&
+            !EXCLUDED_FILES.has(f));
+    }
+    catch {
+        getLogger().warn({ dir }, '扫描目录失败');
+        return [];
+    }
+    const entries = [];
+    for (const file of files) {
+        try {
+            const filePath = join(dir, file);
+            const raw = await readFile(filePath, 'utf-8');
+            const { frontmatter: fm, body } = parseFrontmatter(raw);
+            entries.push({
+                name: fm['name'] ?? basename(file, '.md'),
+                frontmatter: fm,
+                body,
+                filePath,
+            });
+        }
+        catch (err) {
+            getLogger().warn({ file, err }, '解析 Markdown 文件失败');
+        }
+    }
+    return entries;
+}
+/**
+ * 从 frontmatter 中解析逗号分隔的关键词列表
+ *
+ * @param fm frontmatter 键值对
+ * @param key 关键词字段名（默认 'keywords'）
+ * @returns 关键词数组
+ */
+export function parseKeywords(fm, key = 'keywords') {
+    const raw = fm[key];
+    if (!raw)
+        return [];
+    return String(raw)
+        .split(',')
+        .map((s) => s.trim())
+        .filter(Boolean);
+}
+/**
+ * 从 frontmatter 中解析正则触发器
+ *
+ * 支持格式：/pattern/flags 或纯 pattern（默认 'i' flag）
+ *
+ * @param fm frontmatter 键值对
+ * @param key 触发器字段名（默认 'trigger'）
+ * @returns 正则表达式，解析失败返回 undefined
+ */
+export function parseTrigger(fm, key = 'trigger') {
+    const raw = fm[key];
+    if (!raw)
+        return undefined;
+    try {
+        const pattern = String(raw).trim();
+        const match = pattern.match(/^\/(.+)\/([gimsuy]*)$/);
+        // QC-17 移除非空断言：使用空值合并回退到 pattern（与 match 为 null 时逻辑一致）
+        const clean = match?.[1] ?? pattern;
+        // 修复 UTIL-02：使用捕获的 flags（默认 'i'），原实现硬编码 'i' 丢弃了声明的 flags
+        const flags = match?.[2] || 'i';
+        return new RegExp(clean, flags);
+    }
+    catch {
+        getLogger().warn({ trigger: raw }, '触发正则无效，已忽略');
+        return undefined;
+    }
+}
+/**
+ * 解析目录路径：如果 configDir 存在则 resolve 子目录，否则返回 undefined
+ */
+export function resolveSubdir(configDir, sub) {
+    if (!configDir)
+        return undefined;
+    return resolve(configDir, sub);
+}
+//# sourceMappingURL=scanner.js.map

package/dist/utils/scanner.js.map

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