@downcity/plugins 1.0.253 → 1.0.254

package/bin/memory/runtime/Writer.js

@@ -1,274 +0,0 @@
-/**
- * Memory Writer（LLM Wiki 文件读写与路径安全）。
- *
- * 关键点（中文）
- * - `sources/` 保存原始证据，`wiki/` 保存整理后的长期记忆。
- * - 所有外部传入路径都必须限制在 Memory Plugin 自己的 `.downcity/memory` 目录内。
- * - 无 LLM 注入时使用 append fallback，保证 MemoryPlugin 仍然可用。
- */
-import fs from "node:fs/promises";
-import path from "node:path";
-function nowIso() {
-    return new Date().toISOString();
-}
-function dateStamp(now = new Date()) {
-    return now.toISOString().slice(0, 10);
-}
-function toRelPath(rootPath, absPath) {
-    return path.relative(rootPath, absPath).replace(/\\/g, "/");
-}
-function isWithin(parentPath, childPath) {
-    const parent = path.resolve(parentPath);
-    const child = path.resolve(childPath);
-    if (parent === child)
-        return true;
-    return child.startsWith(`${parent}${path.sep}`);
-}
-function slugify(value) {
-    const text = String(value || "")
-        .trim()
-        .toLowerCase()
-        .replace(/[^\p{L}\p{N}]+/gu, "-")
-        .replace(/^-+|-+$/g, "")
-        .slice(0, 80);
-    return text || "inbox";
-}
-function normalizeMarkdownPath(value) {
-    const clean = String(value || "")
-        .replace(/\\/g, "/")
-        .replace(/^\/+/, "")
-        .trim();
-    if (!clean)
-        return "";
-    return clean.toLowerCase().endsWith(".md") ? clean : `${clean}.md`;
-}
-function resolveWikiPath(context, requestedPath, title) {
-    const memoryRoot = path.join(context.workspace_path, ".downcity", "memory");
-    const wikiRoot = path.join(memoryRoot, "wiki");
-    const normalized = normalizeMarkdownPath(requestedPath || slugify(title || "inbox"));
-    const withoutPrefix = normalized
-        .replace(/^\.downcity\/memory\/wiki\//, "")
-        .replace(/^wiki\//, "");
-    const absPath = path.resolve(wikiRoot, withoutPrefix);
-    if (!isWithin(wikiRoot, absPath)) {
-        throw new Error("wiki path is not allowed");
-    }
-    return {
-        absPath,
-        relPath: toRelPath(context.workspace_path, absPath),
-    };
-}
-function resolveAllowedReadPath(context, relPath) {
-    const normalized = relPath.replace(/\\/g, "/").replace(/^\/+/, "").trim();
-    if (!normalized) {
-        throw new Error("path is required");
-    }
-    const absPath = path.resolve(context.workspace_path, normalized);
-    const memoryRoot = path.resolve(path.join(context.workspace_path, ".downcity", "memory"));
-    const isMemoryPath = isWithin(memoryRoot, absPath);
-    if (!isMemoryPath) {
-        throw new Error("path is not allowed");
-    }
-    if (!normalized.toLowerCase().endsWith(".md")) {
-        throw new Error("path must be markdown");
-    }
-    return absPath;
-}
-function buildSourceEntry(content, source) {
-    const clean = String(content || "").trim();
-    const sourceText = source ? `Source: ${source}\n\n` : "";
-    return `## ${nowIso()}\n\n${sourceText}${clean}\n`;
-}
-function buildFallbackWikiEntry(payload) {
-    const lines = [
-        `## ${nowIso()}`,
-        "",
-        ...(payload.instruction ? [`Instruction: ${payload.instruction}`, ""] : []),
-        payload.content.trim(),
-        "",
-        ...(payload.sourcePath ? [`Source: ${payload.sourcePath}`, ""] : []),
-    ];
-    return lines.join("\n");
-}
-function ensureFrontmatter(draft) {
-    const content = String(draft.content || "").trim();
-    if (content.startsWith("---")) {
-        return `${content}\n`;
-    }
-    const title = String(draft.title || "Memory Page").trim();
-    const tags = draft.tags && draft.tags.length > 0
-        ? draft.tags.map((tag) => String(tag).trim()).filter(Boolean)
-        : ["memory"];
-    return [
-        "---",
-        `title: ${JSON.stringify(title)}`,
-        `date: ${dateStamp()}`,
-        `tags: [${tags.map((tag) => JSON.stringify(tag)).join(", ")}]`,
-        "---",
-        "",
-        content,
-        "",
-    ].join("\n");
-}
-async function readTextIfExists(absPath) {
-    try {
-        return String(await fs.readFile(absPath, "utf-8"));
-    }
-    catch {
-        return "";
-    }
-}
-/**
- * 初始化 memory wiki 目录结构（幂等）。
- */
-export async function ensureMemoryDirectories(rootPath) {
-    const memoryRoot = path.join(rootPath, ".downcity", "memory");
-    await fs.mkdir(path.join(memoryRoot, "wiki"), { recursive: true });
-    await fs.mkdir(path.join(memoryRoot, "sources", "manual"), { recursive: true });
-    await fs.mkdir(path.join(memoryRoot, "sources", "sessions"), { recursive: true });
-    const indexPath = path.join(memoryRoot, "wiki", "index.md");
-    const exists = await fs
-        .access(indexPath)
-        .then(() => true)
-        .catch(() => false);
-    if (!exists) {
-        await fs.writeFile(indexPath, [
-            "---",
-            'title: "Memory Index"',
-            `date: ${dateStamp()}`,
-            'tags: ["memory", "index"]',
-            "---",
-            "",
-            "This is the root index for the agent-maintained LLM Wiki memory.",
-            "",
-        ].join("\n"), "utf-8");
-    }
-}
-/**
- * 读取指定记忆文件（支持行区间）。
- */
-export async function readMemory(context, payload) {
-    const requestedPath = String(payload.path || "").trim();
-    if (!requestedPath) {
-        throw new Error("path is required");
-    }
-    const absPath = resolveAllowedReadPath(context, requestedPath);
-    const relPath = toRelPath(context.workspace_path, absPath);
-    const exists = await fs
-        .access(absPath)
-        .then(() => true)
-        .catch(() => false);
-    if (!exists) {
-        return { path: relPath, text: "", missing: true };
-    }
-    const content = String(await fs.readFile(absPath, "utf-8"));
-    const from = payload.from ? Math.max(1, Math.floor(payload.from)) : undefined;
-    const lines = payload.lines ? Math.max(1, Math.floor(payload.lines)) : undefined;
-    if (!from && !lines) {
-        return { path: relPath, text: content };
-    }
-    const rows = content.split("\n");
-    const start = from ?? 1;
-    const size = lines ?? rows.length;
-    const slice = rows.slice(start - 1, start - 1 + size).join("\n");
-    return { path: relPath, text: slice };
-}
-/**
- * 读取 wiki index 内容。
- */
-export async function readWikiIndex(context) {
-    const indexPath = path.join(context.workspace_path, ".downcity", "memory", "wiki", "index.md");
-    return await readTextIfExists(indexPath);
-}
-/**
- * 归档手动 source。
- */
-export async function appendManualSource(context, content, source) {
-    const absPath = path.join(context.workspace_path, ".downcity", "memory", "sources", "manual", `${dateStamp()}.md`);
-    await fs.mkdir(path.dirname(absPath), { recursive: true });
-    const entry = buildSourceEntry(content, source);
-    await fs.appendFile(absPath, `\n${entry}`, "utf-8");
-    return {
-        path: toRelPath(context.workspace_path, absPath),
-        writtenChars: entry.length,
-    };
-}
-/**
- * 写入 session source。
- */
-export async function writeSessionSource(context, session_id, content) {
-    const safeSessionId = slugify(session_id);
-    const absPath = path.join(context.workspace_path, ".downcity", "memory", "sources", "sessions", `${safeSessionId}.md`);
-    const text = [
-        "---",
-        `title: ${JSON.stringify(`Session ${session_id}`)}`,
-        `date: ${dateStamp()}`,
-        'tags: ["memory-source", "session"]',
-        "---",
-        "",
-        `# Session ${session_id}`,
-        "",
-        content.trim(),
-        "",
-    ].join("\n");
-    await fs.mkdir(path.dirname(absPath), { recursive: true });
-    await fs.writeFile(absPath, text, "utf-8");
-    return {
-        path: toRelPath(context.workspace_path, absPath),
-        writtenChars: text.length,
-    };
-}
-/**
- * 写入完整 wiki page。
- */
-export async function writeWikiPage(context, draft) {
-    const resolved = resolveWikiPath(context, draft.path, draft.title);
-    const content = ensureFrontmatter(draft);
-    await fs.mkdir(path.dirname(resolved.absPath), { recursive: true });
-    await fs.writeFile(resolved.absPath, content, "utf-8");
-    return {
-        path: resolved.relPath,
-        writtenChars: content.length,
-    };
-}
-/**
- * 追加写入 wiki page。
- */
-export async function appendWikiPage(context, payload) {
-    const resolved = resolveWikiPath(context, payload.path, payload.title);
-    await fs.mkdir(path.dirname(resolved.absPath), { recursive: true });
-    const exists = await fs
-        .access(resolved.absPath)
-        .then(() => true)
-        .catch(() => false);
-    if (!exists) {
-        await writeWikiPage(context, {
-            path: resolved.relPath,
-            title: payload.title || "Memory Inbox",
-            content: "This page is maintained by MemoryPlugin fallback writes.",
-            tags: ["memory"],
-        });
-    }
-    const entry = buildFallbackWikiEntry(payload);
-    await fs.appendFile(resolved.absPath, `\n${entry}`, "utf-8");
-    return {
-        path: resolved.relPath,
-        writtenChars: entry.length,
-    };
-}
-/**
- * 使用 fallback 方式修订 wiki page。
- */
-export async function appendMemoryRevision(context, payload) {
-    const written = await appendWikiPage(context, {
-        path: payload.path,
-        content: String(payload.evidence || "").trim() || "(no evidence)",
-        instruction: payload.instruction,
-    });
-    return {
-        path: written.path,
-        mode: "appended",
-        writtenChars: written.writtenChars,
-    };
-}
-//# sourceMappingURL=Writer.js.map

package/bin/memory/runtime/Writer.js.map

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

package/src/memory/runtime/Search.ts

@@ -1,327 +0,0 @@
-/**
- * Memory Search 运行时。
- *
- * 关键点（中文）
- * - 直接扫描 LLM Wiki Markdown 文件，不依赖额外索引库。
- * - 统一收敛检索、分块、打分与状态统计逻辑。
- */
-
-import fs from "node:fs/promises";
-import type { PluginContext } from "@downcity/agent";
-import type {
-  MemorySearchPayload,
-  MemorySearchResponse,
-  MemorySearchResultItem,
-  MemorySourceStat,
-  MemoryStatusResponse,
-} from "@/memory/types/Memory.js";
-import {
-  listMemorySourceFiles,
-  MEMORY_DEFAULTS,
-  type MemoryRuntimeState,
-} from "./Store.js";
-
-const SNIPPET_MAX_CHARS = 700;
-const CHUNK_MAX_CHARS = 1600;
-const CHUNK_OVERLAP_CHARS = 240;
-
-function clampNumber(value: number, min: number, max: number): number {
-  if (!Number.isFinite(value)) return min;
-  return Math.max(min, Math.min(max, value));
-}
-
-function normalizeText(input: string): string {
-  return String(input || "").replace(/\r\n/g, "\n");
-}
-
-function truncateText(value: string, maxChars: number): string {
-  if (value.length <= maxChars) {
-    return value;
-  }
-  return value.slice(0, maxChars);
-}
-
-function tokenizeQuery(raw: string): string[] {
-  return String(raw || "")
-    .toLowerCase()
-    .replace(/[^\p{L}\p{N}_-]+/gu, " ")
-    .split(/\s+/)
-    .map((item) => item.trim())
-    .filter(Boolean)
-    .slice(0, 12);
-}
-
-function countTokenOccurrences(text: string, token: string): number {
-  if (!token) return 0;
-  let hits = 0;
-  let start = 0;
-  while (start < text.length) {
-    const index = text.indexOf(token, start);
-    if (index < 0) break;
-    hits += 1;
-    start = index + token.length;
-  }
-  return hits;
-}
-
-function buildSnippetScore(text: string, tokens: string[]): number {
-  if (tokens.length === 0) return 0;
-  const normalized = normalizeText(text).toLowerCase();
-  let matchedTokens = 0;
-  let totalHits = 0;
-  for (const token of tokens) {
-    const hits = countTokenOccurrences(normalized, token);
-    if (hits > 0) {
-      matchedTokens += 1;
-      totalHits += Math.min(hits, 4);
-    }
-  }
-  if (matchedTokens === 0) {
-    return 0;
-  }
-  const coverageScore = matchedTokens / tokens.length;
-  const densityScore = Math.min(totalHits, tokens.length * 3) / (tokens.length * 3);
-  return Number((coverageScore * 0.75 + densityScore * 0.25).toFixed(4));
-}
-
-function chunkMarkdown(content: string): Array<{
-  startLine: number;
-  endLine: number;
-  text: string;
-}> {
-  const lines = normalizeText(content).split("\n");
-  if (lines.length === 0) {
-    return [];
-  }
-  const out: Array<{
-    startLine: number;
-    endLine: number;
-    text: string;
-  }> = [];
-  let bucket: Array<{ line: string; lineNo: number }> = [];
-  let chars = 0;
-
-  const flush = () => {
-    if (bucket.length === 0) return;
-    const startLine = bucket[0]?.lineNo ?? 1;
-    const endLine = bucket[bucket.length - 1]?.lineNo ?? startLine;
-    const text = bucket.map((item) => item.line).join("\n").trim();
-    if (!text) return;
-    out.push({
-      startLine,
-      endLine,
-      text,
-    });
-  };
-
-  const carryOverlap = () => {
-    if (bucket.length === 0 || CHUNK_OVERLAP_CHARS <= 0) {
-      bucket = [];
-      chars = 0;
-      return;
-    }
-    let acc = 0;
-    const next: Array<{ line: string; lineNo: number }> = [];
-    for (let i = bucket.length - 1; i >= 0; i -= 1) {
-      const row = bucket[i];
-      if (!row) continue;
-      acc += row.line.length + 1;
-      next.unshift(row);
-      if (acc >= CHUNK_OVERLAP_CHARS) break;
-    }
-    bucket = next;
-    chars = bucket.reduce((sum, item) => sum + item.line.length + 1, 0);
-  };
-
-  for (let i = 0; i < lines.length; i += 1) {
-    const line = lines[i] ?? "";
-    const rowSize = line.length + 1;
-    if (bucket.length > 0 && chars + rowSize > CHUNK_MAX_CHARS) {
-      flush();
-      carryOverlap();
-    }
-    bucket.push({ line, lineNo: i + 1 });
-    chars += rowSize;
-  }
-  flush();
-  return out;
-}
-
-async function readMemoryChunks(
-  context: PluginContext,
-  options: { includeSources?: boolean },
-): Promise<Array<{
-  path: string;
-  source: "wiki" | "source" | "working";
-  startLine: number;
-  endLine: number;
-  text: string;
-}>> {
-  const files = await listMemorySourceFiles(context.workspace_path, options);
-  const out: Array<{
-    path: string;
-    source: "wiki" | "source" | "working";
-    startLine: number;
-    endLine: number;
-    text: string;
-  }> = [];
-  for (const file of files) {
-    const content = String(await fs.readFile(file.absPath, "utf-8"));
-    for (const chunk of chunkMarkdown(content)) {
-      out.push({
-        path: file.relPath,
-        source: file.source,
-        startLine: chunk.startLine,
-        endLine: chunk.endLine,
-        text: chunk.text,
-      });
-    }
-  }
-  return out;
-}
-
-/**
- * 收集当前 memory Markdown 状态。
- */
-export async function collectMemoryStatus(
-  context: PluginContext,
-  state: MemoryRuntimeState,
-): Promise<MemoryStatusResponse> {
-  void state;
-  const files = await listMemorySourceFiles(context.workspace_path, {
-    includeSources: true,
-  });
-  const sourceCounts: MemorySourceStat[] = [
-    { source: "wiki", files: 0, chunks: 0 },
-    { source: "source", files: 0, chunks: 0 },
-    { source: "working", files: 0, chunks: 0 },
-  ];
-
-  let totalChunks = 0;
-  for (const file of files) {
-    const bucket = sourceCounts.find((item) => item.source === file.source);
-    if (bucket) {
-      bucket.files += 1;
-    }
-    const content = String(await fs.readFile(file.absPath, "utf-8"));
-    const chunks = chunkMarkdown(content).length;
-    totalChunks += chunks;
-    if (bucket) {
-      bucket.chunks += chunks;
-    }
-  }
-
-  return {
-    backend: "builtin",
-    mode: "scan",
-    files: files.length,
-    chunks: totalChunks,
-    sourceCounts,
-  };
-}
-
-/**
- * 执行检索。
- */
-export async function searchMemory(
-  context: PluginContext,
-  state: MemoryRuntimeState,
-  payload: MemorySearchPayload,
-): Promise<MemorySearchResponse> {
-  void state;
-
-  const query = String(payload.query || "").trim();
-  if (!query) {
-    return {
-      backend: "builtin",
-      mode: "scan",
-      results: [],
-    };
-  }
-
-  const tokens = tokenizeQuery(query);
-  if (tokens.length === 0) {
-    return {
-      backend: "builtin",
-      mode: "scan",
-      results: [],
-    };
-  }
-
-  const maxResults = Math.floor(
-    clampNumber(
-      Number(payload.maxResults ?? MEMORY_DEFAULTS.maxResults),
-      1,
-      20,
-    ),
-  );
-  const minScore = clampNumber(
-    Number(payload.minScore ?? MEMORY_DEFAULTS.minScore),
-    0,
-    1,
-  );
-
-  try {
-    const results = (await readMemoryChunks(context, {
-      includeSources: payload.includeSources,
-    }))
-      .map((chunk) => {
-        const score = buildSnippetScore(chunk.text, tokens);
-        const citation =
-          chunk.startLine === chunk.endLine
-            ? `${chunk.path}#L${chunk.startLine}`
-            : `${chunk.path}#L${chunk.startLine}-L${chunk.endLine}`;
-        return {
-          path: chunk.path,
-          source: chunk.source,
-          startLine: chunk.startLine,
-          endLine: chunk.endLine,
-          score,
-          snippet: truncateText(chunk.text, SNIPPET_MAX_CHARS),
-          citation,
-        } satisfies MemorySearchResultItem;
-      })
-      .filter((item) => item.score >= minScore)
-      .sort((left, right) => {
-        if (right.score !== left.score) {
-          return right.score - left.score;
-        }
-        if (left.path !== right.path) {
-          return left.path.localeCompare(right.path);
-        }
-        return left.startLine - right.startLine;
-      })
-      .slice(0, maxResults * 3);
-
-    let remain = Math.max(0, MEMORY_DEFAULTS.maxInjectedChars);
-    const clamped: MemorySearchResultItem[] = [];
-    for (const item of results) {
-      if (remain <= 0 || clamped.length >= maxResults) break;
-      if (item.snippet.length <= remain) {
-        clamped.push(item);
-        remain -= item.snippet.length;
-        continue;
-      }
-      clamped.push({
-        ...item,
-        snippet: item.snippet.slice(0, remain),
-      });
-      break;
-    }
-
-    return {
-      backend: "builtin",
-      mode: "scan",
-      results: clamped,
-    };
-  } catch (error) {
-    const message = String(error);
-    return {
-      backend: "builtin",
-      mode: "scan",
-      results: [],
-      error: message,
-      action: "Check the Markdown memory files under `.downcity/memory/`.",
-    };
-  }
-}