@nowcrew/daemon 0.5.27 → 0.5.28

package/dist/unified-diff.js

@@ -1,84 +0,0 @@
-/** 严格、有限的 unified diff 解析器。只有完整文件头 + hunk 才识别,避免误染普通 +/- 日志。 */
-import { CONSOLE_DIFF_ROWS, CONSOLE_ROW_CHARS, } from "./console-payload.js";
-const HUNK = /^@@ -(\d+)(?:,(\d+))? \+(\d+)(?:,(\d+))? @@/;
-const clip = (text) => text.length > CONSOLE_ROW_CHARS ? `${text.slice(0, CONSOLE_ROW_CHARS)}…` : text;
-const pathFromHeader = (line) => line.slice(4).split("\t", 1)[0].replace(/^[ab]\//, "");
-export function parseUnifiedDiff(input) {
-    const lines = input.split("\n");
-    const files = [];
-    let additions = 0;
-    let deletions = 0;
-    let cursor = 0;
-    let totalRows = 0;
-    let truncated = false;
-    while (cursor < lines.length) {
-        while (cursor < lines.length && !isFileHeaderPair(lines, cursor))
-            cursor++;
-        if (cursor >= lines.length)
-            break;
-        const oldPath = pathFromHeader(lines[cursor]);
-        const newPath = pathFromHeader(lines[cursor + 1]);
-        const path = newPath === "/dev/null" ? oldPath : newPath;
-        cursor += 2;
-        const rows = [];
-        let sawHunk = false;
-        while (cursor < lines.length && !isFileHeaderPair(lines, cursor)) {
-            const match = lines[cursor].match(HUNK);
-            if (!match) {
-                cursor++;
-                continue;
-            }
-            sawHunk = true;
-            let oldLine = Number(match[1]);
-            let oldRemaining = Number(match[2] ?? 1);
-            let newLine = Number(match[3]);
-            let newRemaining = Number(match[4] ?? 1);
-            cursor++;
-            while (cursor < lines.length && (oldRemaining > 0 || newRemaining > 0)) {
-                const line = lines[cursor];
-                cursor++;
-                if (line === "\")
-                    continue;
-                let row;
-                if (line.startsWith("+")) {
-                    row = { type: "add", oldLine: null, newLine, text: clip(line.slice(1)) };
-                    newLine++;
-                    newRemaining--;
-                    additions++;
-                }
-                else if (line.startsWith("-")) {
-                    row = { type: "delete", oldLine, newLine: null, text: clip(line.slice(1)) };
-                    oldLine++;
-                    oldRemaining--;
-                    deletions++;
-                }
-                else if (line.startsWith(" ")) {
-                    row = { type: "context", oldLine, newLine, text: clip(line.slice(1)) };
-                    oldLine++;
-                    newLine++;
-                    oldRemaining--;
-                    newRemaining--;
-                }
-                else
-                    break;
-                if (totalRows < CONSOLE_DIFF_ROWS) {
-                    rows.push(row);
-                    totalRows++;
-                }
-                else
-                    truncated = true;
-            }
-        }
-        if (sawHunk) {
-            if (truncated && !rows.some((row) => row.type === "omitted"))
-                rows.push({ type: "omitted", oldCount: 1, newCount: 1 });
-            files.push({ path, rows });
-        }
-    }
-    if (!files.length)
-        return null;
-    return { kind: "diff_rows", files, additions, deletions, ...(truncated ? { truncated: true } : {}) };
-}
-function isFileHeaderPair(lines, index) {
-    return lines[index]?.startsWith("--- ") === true && lines[index + 1]?.startsWith("+++ ") === true;
-}

package/dist/websocket-shutdown.js

@@ -1,53 +0,0 @@
-import { WebSocket } from "ws";
-export function closeWebSocketWithinDeadline(socket, signal) {
-    if (socket === null || socket.readyState === WebSocket.CLOSED)
-        return Promise.resolve();
-    return new Promise((resolve, reject) => {
-        let settled = false;
-        const cleanup = () => {
-            socket.removeListener("close", onClose);
-            socket.removeListener("error", onError);
-            signal.removeEventListener("abort", onAbort);
-        };
-        const settle = (outcome) => {
-            if (settled)
-                return;
-            settled = true;
-            cleanup();
-            outcome();
-        };
-        const onClose = () => settle(resolve);
-        const onError = () => {
-            if (socket.readyState === WebSocket.CLOSED)
-                onClose();
-        };
-        const onAbort = () => {
-            settle(() => {
-                if (socket.readyState !== WebSocket.CLOSED) {
-                    try {
-                        socket.terminate();
-                    }
-                    catch { /* deadline error remains authoritative */ }
-                }
-                reject(signal.reason);
-            });
-        };
-        socket.on("close", onClose);
-        socket.on("error", onError);
-        signal.addEventListener("abort", onAbort, { once: true });
-        if (signal.aborted) {
-            onAbort();
-        }
-        else if (socket.readyState === WebSocket.CLOSED) {
-            onClose();
-        }
-        else if (socket.readyState !== WebSocket.CLOSING) {
-            try {
-                socket.close();
-            }
-            catch (error) {
-                settle(() => reject(error));
-            }
-        }
-    });
-}

package/dist/win32-job-object.js

@@ -1,193 +0,0 @@
-/**
- * Windows Job Object 执行后端的 FFI 封装(仅 win32 生效)。
- *
- * Node 不暴露 Job Object API,这里用 koffi 直接调 kernel32.dll。koffi 是可选依赖
- * (optionalDependencies),用 createRequire 惰性同步加载 —— 加载失败/非 win32 一律抛错,
- * 由上层降级到 fail-closed,不影响 Mac/Linux 路径。
- *
- * 关键语义:job 上设 JOB_OBJECT_LIMIT_KILL_ON_JOB_CLOSE 后,持有 job handle 的进程一旦退出
- * (含崩溃),内核立即回收 Job 内所有进程 —— 等价于 POSIX「父死子亡 + 进程组整组清理」,且更强。
- * 因此 job 必须由「离 runtime 最近、崩溃即代表该放弃所有权」的进程(supervisor child)创建并持有。
- */
-import { createRequire } from "node:module";
-const JOB_OBJECT_LIMIT_KILL_ON_JOB_CLOSE = 0x0000_2000;
-const JOBOBJECT_EXTENDED_LIMIT_INFORMATION = 9;
-const JOBOBJECT_BASIC_ACCOUNTING_INFORMATION = 1;
-const PROCESS_TERMINATE = 0x0001;
-const PROCESS_SET_QUOTA = 0x0100;
-const JOB_ASSIGN_ACCESS = PROCESS_TERMINATE | PROCESS_SET_QUOTA;
-const JOB_EMPTY_POLL_MS = 10;
-// koffi 的 struct 布局/对齐由类型描述自动推导,无需手工塞 padding。
-// size_t/uintptr_t 在 x64/arm64 均为 8 字节,与 SIZE_T/ULONG_PTR 对齐。
-const BASIC_LIMIT_INFORMATION = {
-    PerProcessUserTimeLimit: "int64",
-    PerJobUserTimeLimit: "int64",
-    LimitFlags: "uint32",
-    MinimumWorkingSetSize: "size_t",
-    MaximumWorkingSetSize: "size_t",
-    ActiveProcessLimit: "uint32",
-    Affinity: "uintptr_t",
-    PriorityClass: "uint32",
-    SchedulingClass: "uint32",
-};
-const IO_COUNTERS = {
-    ReadOperationCount: "uint64",
-    WriteOperationCount: "uint64",
-    OtherOperationCount: "uint64",
-    ReadTransferCount: "uint64",
-    WriteTransferCount: "uint64",
-    OtherTransferCount: "uint64",
-};
-let cachedApi = null;
-let loadFailed = false;
-/**
- * 惰性加载并绑定 kernel32。非 win32 或 koffi 不可用时抛错。结果缓存;失败也缓存(不反复重试)。
- */
-function loadKernel32() {
-    if (cachedApi !== null)
-        return cachedApi;
-    if (loadFailed)
-        throw new Error("Windows Job Object backend previously failed to load");
-    if (process.platform !== "win32") {
-        loadFailed = true;
-        throw new Error("Windows Job Object backend is only available on win32");
-    }
-    try {
-        cachedApi = bindKernel32();
-        return cachedApi;
-    }
-    catch (error) {
-        loadFailed = true;
-        throw error instanceof Error ? error : new Error(String(error));
-    }
-}
-function bindKernel32() {
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any -- koffi 无类型声明,单点收窄。
-    const koffi = createRequire(import.meta.url)("koffi");
-    const lib = koffi.load("kernel32.dll");
-    koffi.struct("JOBOBJECT_BASIC_LIMIT_INFORMATION", BASIC_LIMIT_INFORMATION);
-    koffi.struct("IO_COUNTERS", IO_COUNTERS);
-    koffi.struct("JOBOBJECT_EXTENDED_LIMIT_INFORMATION", {
-        BasicLimitInformation: "JOBOBJECT_BASIC_LIMIT_INFORMATION",
-        IoInfo: "IO_COUNTERS",
-        ProcessMemoryLimit: "size_t",
-        JobMemoryLimit: "size_t",
-        PeakProcessMemoryUsed: "size_t",
-        PeakJobMemoryUsed: "size_t",
-    });
-    koffi.struct("JOBOBJECT_BASIC_ACCOUNTING_INFORMATION", {
-        TotalUserTime: "int64",
-        TotalKernelTime: "int64",
-        ThisPeriodTotalUserTime: "int64",
-        ThisPeriodTotalKernelTime: "int64",
-        TotalPageFaultCount: "uint32",
-        TotalProcesses: "uint32",
-        ActiveProcesses: "uint32",
-        TotalTerminatedProcesses: "uint32",
-    });
-    const CreateJobObjectW = lib.func("void* __stdcall CreateJobObjectW(void* attrs, void* name)");
-    const SetInformationJobObject = lib.func("bool __stdcall SetInformationJobObject(void* job, int cls, void* info, uint32_t len)");
-    const OpenProcess = lib.func("void* __stdcall OpenProcess(uint32_t access, bool inherit, uint32_t pid)");
-    const AssignProcessToJobObject = lib.func("bool __stdcall AssignProcessToJobObject(void* job, void* process)");
-    const TerminateJobObject = lib.func("bool __stdcall TerminateJobObject(void* job, uint32_t code)");
-    const QueryInformationJobObject = lib.func("bool __stdcall QueryInformationJobObject(void* job, int cls, _Out_ void* info, uint32_t len, void* ret)");
-    const CloseHandle = lib.func("bool __stdcall CloseHandle(void* handle)");
-    const GetLastError = lib.func("uint32_t __stdcall GetLastError()");
-    return {
-        createJobObject: () => CreateJobObjectW(null, null),
-        setKillOnClose: (job) => {
-            // 只需把 LimitFlags 置上 KILL_ON_JOB_CLOSE,其余字段留 0。用 Buffer + offsetof 直写,
-            // 规避 koffi.encode 的入参数量怪癖;offset 由 koffi 从结构体推导,x64/arm64 一致。
-            const size = koffi.sizeof("JOBOBJECT_EXTENDED_LIMIT_INFORMATION");
-            const flagsOffset = koffi.offsetof("JOBOBJECT_BASIC_LIMIT_INFORMATION", "LimitFlags");
-            const buffer = Buffer.alloc(size);
-            buffer.writeUInt32LE(JOB_OBJECT_LIMIT_KILL_ON_JOB_CLOSE, flagsOffset);
-            return SetInformationJobObject(job, JOBOBJECT_EXTENDED_LIMIT_INFORMATION, buffer, size);
-        },
-        openProcess: (access, inherit, pid) => OpenProcess(access, inherit, pid),
-        assignProcessToJob: (job, process) => AssignProcessToJobObject(job, process),
-        terminateJobObject: (job, exitCode) => TerminateJobObject(job, exitCode),
-        queryActiveProcessCount: (job) => {
-            const size = koffi.sizeof("JOBOBJECT_BASIC_ACCOUNTING_INFORMATION");
-            const activeOffset = koffi.offsetof("JOBOBJECT_BASIC_ACCOUNTING_INFORMATION", "ActiveProcesses");
-            const buffer = Buffer.alloc(size);
-            const ok = QueryInformationJobObject(job, JOBOBJECT_BASIC_ACCOUNTING_INFORMATION, buffer, size, null);
-            if (!ok)
-                throw new Error(`QueryInformationJobObject failed (GetLastError=${GetLastError()})`);
-            return buffer.readUInt32LE(activeOffset);
-        },
-        closeHandle: (handle) => CloseHandle(handle),
-        getLastError: () => GetLastError(),
-    };
-}
-/**
- * 同步探测:能否创建带 KILL_ON_JOB_CLOSE 的 Job Object。用于 backend 能力判定。
- * 非 win32 / koffi 缺失 / API 调用失败 → false(fail-closed 降级 legacy)。副作用为零(建后即关)。
- */
-export function isJobObjectSupported() {
-    if (process.platform !== "win32")
-        return false;
-    try {
-        const handle = createKillOnCloseJob();
-        closeJob(handle);
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-/** 创建带 KILL_ON_JOB_CLOSE 的 Job Object。失败抛错。 */
-export function createKillOnCloseJob() {
-    const api = loadKernel32();
-    const native = api.createJobObject();
-    if (!native)
-        throw new Error(`CreateJobObjectW failed (GetLastError=${api.getLastError()})`);
-    if (!api.setKillOnClose(native)) {
-        const code = api.getLastError();
-        api.closeHandle(native);
-        throw new Error(`SetInformationJobObject(KILL_ON_JOB_CLOSE) failed (GetLastError=${code})`);
-    }
-    return { native };
-}
-/** 把 pid 对应进程塞进 Job。进程随后 fork 的子孙默认继承 Job(未设 SILENT_BREAKAWAY,禁止逃逸)。 */
-export function assignProcessToJob(handle, pid) {
-    const api = loadKernel32();
-    const process = api.openProcess(JOB_ASSIGN_ACCESS, false, pid);
-    if (!process)
-        throw new Error(`OpenProcess(${pid}) failed (GetLastError=${api.getLastError()})`);
-    try {
-        if (!api.assignProcessToJob(handle.native, process)) {
-            throw new Error(`AssignProcessToJobObject(${pid}) failed (GetLastError=${api.getLastError()})`);
-        }
-    }
-    finally {
-        api.closeHandle(process);
-    }
-}
-/** 一次性杀光 Job 内所有进程(超时/取消/runtime 挂了 supervisor 还在)。 */
-export function terminateJob(handle, exitCode = 1) {
-    const api = loadKernel32();
-    if (!api.terminateJobObject(handle.native, exitCode)) {
-        throw new Error(`TerminateJobObject failed (GetLastError=${api.getLastError()})`);
-    }
-}
-/** 关闭 job handle。若为最后一个引用且设了 KILL_ON_JOB_CLOSE,内核连带杀光 Job 内进程。 */
-export function closeJob(handle) {
-    const api = loadKernel32();
-    api.closeHandle(handle.native);
-}
-/** 当前 Job 内活跃进程数(BasicAccountingInformation.ActiveProcesses)。 */
-export function activeProcessCount(handle) {
-    return loadKernel32().queryActiveProcessCount(handle.native);
-}
-/** 轮询等待 Job 清空(整组退出确认),复用 10ms 节奏。超时抛错。 */
-export async function waitForJobEmpty(handle, timeoutMs, pollMs = JOB_EMPTY_POLL_MS) {
-    const deadline = Date.now() + timeoutMs;
-    while (true) {
-        if (activeProcessCount(handle) === 0)
-            return;
-        if (Date.now() >= deadline)
-            throw new Error(`Job Object did not empty within ${timeoutMs}ms`);
-        await new Promise((resolve) => setTimeout(resolve, pollMs));
-    }
-}

package/dist/workspace-fs.js

@@ -1,80 +0,0 @@
-/**
- * 只读、沙箱化地暴露某 agent 工作区 (<agentsRoot>/<handle>/) 给控制面查看。
- *
- * 安全铁律:
- *  - 所有路径都 resolve 后必须仍落在 agent 根内 (防 `..` / 符号链接逃逸)。
- *  - 隐藏内部目录与点文件 (.crew / .git / 任何 . 开头)。
- *  - 只回文本文件,二进制拒绝;单文件大小上限,超出截断。
- *  - 仅 list / read,无写删。
- */
-import { realpath, readdir, readFile, stat } from "node:fs/promises";
-import { join, resolve, sep } from "node:path";
-export class FsError extends Error {
-}
-const MAX_FILE_BYTES = 256 * 1024; // 单文件查看上限 256KB
-const HIDDEN = new Set([".crew", ".git", ".slock"]);
-const isHidden = (name) => name.startsWith(".") || HIDDEN.has(name);
-/** 把相对路径安全解析到 root 内的绝对路径;越界抛错。realpath 兜底符号链接逃逸。 */
-async function safeResolve(root, rel) {
-    const rootResolved = await realpath(root);
-    const target = resolve(rootResolved, rel.replace(/^\/+/, ""));
-    const withSep = rootResolved.endsWith(sep) ? rootResolved : rootResolved + sep;
-    if (target !== rootResolved && !target.startsWith(withSep)) {
-        throw new FsError("path escapes workspace");
-    }
-    // 解析真实路径再校验一次 (符号链接)
-    let real;
-    try {
-        real = await realpath(target);
-    }
-    catch {
-        return target; // 不存在的路径交给后续 stat 报错
-    }
-    if (real !== rootResolved && !real.startsWith(withSep)) {
-        throw new FsError("path escapes workspace (symlink)");
-    }
-    return real;
-}
-/** 列出某目录 (相对 root)。隐藏点文件/内部目录;目录在前、按名排序。 */
-export async function listWorkspace(root, rel) {
-    // 工作区尚未创建 (agent 还没跑过):返回空,而不是报错
-    const rootExists = await stat(root).then((s) => s.isDirectory()).catch(() => false);
-    if (!rootExists)
-        return { root: resolve(root), path: rel.replace(/^\/+/, ""), entries: [] };
-    const rootResolved = await realpath(root);
-    const dir = await safeResolve(root, rel);
-    const st = await stat(dir).catch(() => null);
-    if (!st || !st.isDirectory())
-        throw new FsError("not a directory");
-    const names = await readdir(dir);
-    const entries = [];
-    for (const name of names) {
-        if (isHidden(name))
-            continue;
-        const full = join(dir, name);
-        const s = await stat(full).catch(() => null);
-        if (!s)
-            continue;
-        if (s.isDirectory())
-            entries.push({ name, type: "dir" });
-        else if (s.isFile())
-            entries.push({ name, type: "file", size: s.size });
-    }
-    entries.sort((a, b) => a.type !== b.type ? (a.type === "dir" ? -1 : 1) : a.name.localeCompare(b.name));
-    return { root: rootResolved, path: rel.replace(/^\/+/, ""), entries };
-}
-/** 读取某文本文件 (相对 root)。二进制/超大拒绝或截断。 */
-export async function readWorkspaceFile(root, rel) {
-    const file = await safeResolve(root, rel);
-    const s = await stat(file).catch(() => null);
-    if (!s || !s.isFile())
-        throw new FsError("not a file");
-    const buf = await readFile(file);
-    // 二进制探测:含 NUL 即视为二进制
-    const sample = buf.subarray(0, Math.min(buf.length, 8192));
-    if (sample.includes(0))
-        throw new FsError("binary file not viewable");
-    const truncated = buf.length > MAX_FILE_BYTES;
-    const content = buf.subarray(0, MAX_FILE_BYTES).toString("utf8");
-    return { path: rel.replace(/^\/+/, ""), content, truncated, size: buf.length };
-}

package/dist/workspace-import.js

@@ -1,127 +0,0 @@
-/**
- * 导入一个已有的 raft agent 工作区到本机的 crew 工作区。
- *
- * raft 工作区目录(~/.slock/agents/<uuid>/)里:
- *   - 用户内容(复制):MEMORY.md、notes/、artifacts/、incoming/、*.html 等非隐藏文件
- *   - raft 内部(不复制,crew 自己重建):.git/、.slock/(系统提示词/mcp/CLI wrapper)
- *
- * crew 侧的唯一 id、隐藏的 .crew/(system-prompt + crew wrapper)由 prepareWorkspace 在
- * 首次运行时生成,DB 行另起新 uuid —— 所以这里只搬运用户内容,内部一律重建。
- */
-import { readFile, writeFile, readdir, stat, cp, mkdir } from "node:fs/promises";
-import { join } from "node:path";
-import { homedir } from "node:os";
-/** 一律跳过的隐藏/内部条目(其余 dotfile 也跳过)。 */
-const SKIP = new Set([".git", ".slock", ".crew", ".DS_Store"]);
-/** 展开开头的 `~` 为用户主目录(daemon 在被测机器上跑,路径里常带 ~)。 */
-export function expandHome(p) {
-    if (p === "~")
-        return homedir();
-    if (p.startsWith("~/"))
-        return join(homedir(), p.slice(2));
-    return p;
-}
-/** 从 MEMORY.md 反填:H1 → name;`## Role` 段正文 → description(无 Role 则取 H1 后首段)。 */
-export function parseMemory(md) {
-    const lines = md.split(/\r?\n/);
-    let name = "";
-    let h1Idx = -1;
-    for (let i = 0; i < lines.length; i++) {
-        const m = lines[i].match(/^#\s+(.+?)\s*$/);
-        if (m) {
-            name = m[1].trim();
-            h1Idx = i;
-            break;
-        }
-    }
-    const sectionBody = (startIdx) => {
-        const body = [];
-        for (let i = startIdx; i < lines.length; i++) {
-            if (/^#{1,6}\s+/.test(lines[i]))
-                break; // 下一个标题为止
-            body.push(lines[i]);
-        }
-        return body.join("\n").trim();
-    };
-    let description = "";
-    const roleIdx = lines.findIndex((l) => /^##\s+Role\b/i.test(l));
-    if (roleIdx >= 0)
-        description = sectionBody(roleIdx + 1);
-    if (!description && h1Idx >= 0)
-        description = sectionBody(h1Idx + 1); // 兜底:H1 后首段
-    return { name, description: description.slice(0, 3000) };
-}
-/**
- * 导入时清空 MEMORY.md 的 `## Active Context` 段:其内容是 raft 里的在办任务进度(含任务 id),
- * 这些 id 在新的 OpenSlock 里不一定存在,照搬会误导。保留标题,正文换成占位提示让 agent 重新记录。
- * 其它段(Role/索引/领域知识)照常保留。
- */
-export function stripActiveContext(md) {
-    const lines = md.split(/\r?\n/);
-    const start = lines.findIndex((l) => /^##\s+Active Context\b/i.test(l));
-    if (start < 0)
-        return md;
-    // 段落结束 = 下一个 # / ## 标题,或 `---` 分隔线,或文件末尾
-    let end = lines.length;
-    for (let i = start + 1; i < lines.length; i++) {
-        if (/^#{1,2}\s+/.test(lines[i]) || /^---\s*$/.test(lines[i])) {
-            end = i;
-            break;
-        }
-    }
-    const replacement = [
-        lines[start], // 原 `## Active Context` 标题
-        "<!-- (导入时已清空:raft 的在办任务/任务 id 不属于本工作区。开工时在此重新记录当前进度。) -->",
-        "",
-    ];
-    return [...lines.slice(0, start), ...replacement, ...lines.slice(end)].join("\n");
-}
-async function assertDir(srcPath) {
-    let st;
-    try {
-        st = await stat(srcPath);
-    }
-    catch {
-        throw new Error(`workspace path not found: ${srcPath}`);
-    }
-    if (!st.isDirectory())
-        throw new Error(`not a directory: ${srcPath}`);
-}
-/** 读取 raft 工作区元信息(name/description/可复制条目),不写入任何文件。 */
-export async function inspectRaftWorkspace(rawPath) {
-    const srcPath = expandHome(rawPath);
-    await assertDir(srcPath);
-    let memory;
-    try {
-        memory = await readFile(join(srcPath, "MEMORY.md"), "utf8");
-    }
-    catch {
-        throw new Error("no MEMORY.md in this folder — is it a raft agent workspace?");
-    }
-    const { name, description } = parseMemory(memory);
-    const all = await readdir(srcPath);
-    const entries = all.filter((e) => !SKIP.has(e) && !e.startsWith("."));
-    return { name, description, fileCount: entries.length, entries };
-}
-/** 复制 raft 工作区的用户内容到目标目录(隐藏/内部条目不复制)。 */
-export async function importRaftWorkspace(rawPath, destDir) {
-    const srcPath = expandHome(rawPath);
-    await assertDir(srcPath);
-    await mkdir(destDir, { recursive: true });
-    const all = await readdir(srcPath);
-    const copied = [];
-    for (const e of all) {
-        if (SKIP.has(e) || e.startsWith("."))
-            continue;
-        if (e === "MEMORY.md") {
-            // MEMORY.md 特殊处理:剥离 Active Context(陈旧任务 id)后再落地,其余原样保留。
-            const cleaned = stripActiveContext(await readFile(join(srcPath, e), "utf8"));
-            await writeFile(join(destDir, e), cleaned, "utf8");
-        }
-        else {
-            await cp(join(srcPath, e), join(destDir, e), { recursive: true });
-        }
-        copied.push(e);
-    }
-    return { copied, dir: destDir };
-}