@shgroup/opencode-serenity-plugin 0.2.0

package/dist/errors.d.ts

@@ -0,0 +1,90 @@
+/**
+ * 错误类清单（contract-v0.md 附录 B）
+ *
+ * 设计原则：
+ * - 所有错误都是 Error 子类（保证 stack trace 完整）
+ * - 错误名以 Error 结尾（grep 友好；不强制 SerenityError 前缀以便精细分类）
+ * - 错误传播策略：
+ *   1. plugin 入口（index.ts / tui.ts）不抛 — 返回空 hooks 或 toast 通知
+ *   2. 大多数 hook 用 safeHook / safeCreateHook 静默（v0.0.1 release 静默原则 + retry-storm 防护）
+ *   3. 例外：permission-guards.ts 的 tool.execute.before（RR5 hard block）故意
+ *      让 throw 透传 — 中断整条 Effect 链正是 RR5 想要的行为
+ */
+/** 基类：所有 serenity plugin 错误的父类 */
+export declare class SerenityError extends Error {
+    constructor(message: string);
+}
+/** RR1 违反：cwd 不在 git repo 内 */
+export declare class NotInGitRepoError extends SerenityError {
+    constructor(cwd: string);
+}
+/** RR1 违反：/.serenity 文件不存在 */
+export declare class SerenityFileNotFoundError extends SerenityError {
+    constructor(cwdRoot: string);
+}
+/** /.serenity 文件存在但内容为空或无效 */
+export declare class SerenityFileEmptyError extends SerenityError {
+    constructor(path: string);
+}
+/** RR2 违反：.opencode/skills/<instanceName>/SKILL.md 不存在 */
+export declare class SkillNotFoundError extends SerenityError {
+    constructor(cwdRoot: string, instanceName: string);
+}
+/** msm_exec 失败：MSM 不在注册表中 */
+export declare class MsmNotRegisteredError extends SerenityError {
+    constructor(msmName: string);
+}
+/** msm_exec 失败：MSM 子进程超时 */
+export declare class MsmTimeoutError extends SerenityError {
+    constructor(msmName: string, timeoutMs: number);
+}
+/** msm_register 失败：name 已被注册 */
+export declare class MsmAlreadyRegisteredError extends SerenityError {
+    constructor(msmName: string);
+}
+/** msm_register 失败：脚本文件不存在（拒绝注册空路径）*/
+export declare class MsmScriptNotFoundError extends SerenityError {
+    constructor(msmName: string, scriptPath: string);
+}
+/** msm_deregister 失败：name 不在 registry */
+export declare class MsmNotInRegistryError extends SerenityError {
+    constructor(msmName: string);
+}
+/** msm_exec 失败：MSM 子进程 exit code != 0
+ *
+ * v1.15.1：MsmExecutionError 显式持有 stdout/stderr/exitCode 三个字段
+ * - 修复 S022 RFC §9 缺陷（plugin 端 msm_exec 吞掉 stdout）
+ * - JSON 模式下业务 msm 把错误信息写在 stdout（per S022 §2.3），
+ *   错误对象必须能让 LLM 看到 stdout 原文以便重试/诊断
+ */
+export declare class MsmExecutionError extends SerenityError {
+    readonly stdout: string;
+    readonly stderr: string;
+    readonly exitCode: number;
+    constructor(msmName: string, exitCode: number, stdout: string, stderr: string);
+}
+/** RR7 触发：/.serenity 创建失败（git add/commit 阶段）*/
+export declare class InitGitCommitError extends SerenityError {
+    constructor(reason: string);
+}
+/** v1.10 RR7：用户输入的 prefix 不是 kebab-case */
+export declare class InvalidInstanceNameError extends SerenityError {
+    constructor(name: string);
+}
+/** msm_exec 失败：path-arg 解析为 cwdRoot 之外的路径（v0.1-2 path escape guard）*/
+export declare class MsmPathEscapeError extends SerenityError {
+    constructor(msmName: string, argName: string, value: string, resolved: string);
+}
+/** msm_exec 失败：path-arg 指向 symlink / symlink 链（v1-1 symlink 防御）*/
+export declare class MsmSymlinkError extends SerenityError {
+    constructor(msmName: string, argName: string, value: string, resolved: string, reason: string);
+}
+/** 文件系统操作错误（file-system-tool） */
+export declare class FileSystemError extends SerenityError {
+    constructor(message: string);
+}
+/** 会话管理操作错误（session-tool） */
+export declare class SessionError extends SerenityError {
+    constructor(message: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,kCAAkC;AAClC,qBAAa,aAAc,SAAQ,KAAK;gBAC1B,OAAO,EAAE,MAAM;CAI5B;AAED,+BAA+B;AAC/B,qBAAa,iBAAkB,SAAQ,aAAa;gBACtC,GAAG,EAAE,MAAM;CAIxB;AAED,8BAA8B;AAC9B,qBAAa,yBAA0B,SAAQ,aAAa;gBAC9C,OAAO,EAAE,MAAM;CAI5B;AAED,8BAA8B;AAC9B,qBAAa,sBAAuB,SAAQ,aAAa;gBAC3C,IAAI,EAAE,MAAM;CAIzB;AAED,0DAA0D;AAC1D,qBAAa,kBAAmB,SAAQ,aAAa;gBACvC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM;CAIlD;AAED,6BAA6B;AAC7B,qBAAa,qBAAsB,SAAQ,aAAa;gBAC1C,OAAO,EAAE,MAAM;CAI5B;AAED,4BAA4B;AAC5B,qBAAa,eAAgB,SAAQ,aAAa;gBACpC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;CAI/C;AAED,gCAAgC;AAChC,qBAAa,yBAA0B,SAAQ,aAAa;gBAC9C,OAAO,EAAE,MAAM;CAI5B;AAED,sCAAsC;AACtC,qBAAa,sBAAuB,SAAQ,aAAa;gBAC3C,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;CAIhD;AAED,yCAAyC;AACzC,qBAAa,qBAAsB,SAAQ,aAAa;gBAC1C,OAAO,EAAE,MAAM;CAI5B;AAED;;;;;;GAMG;AACH,qBAAa,iBAAkB,SAAQ,aAAa;IAClD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBACd,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAW9E;AAED,+CAA+C;AAC/C,qBAAa,kBAAmB,SAAQ,aAAa;gBACvC,MAAM,EAAE,MAAM;CAI3B;AAED,2CAA2C;AAC3C,qBAAa,wBAAyB,SAAQ,aAAa;gBAC7C,IAAI,EAAE,MAAM;CAOzB;AAED,sEAAsE;AACtE,qBAAa,kBAAmB,SAAQ,aAAa;gBACvC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;CAO9E;AAED,kEAAkE;AAClE,qBAAa,eAAgB,SAAQ,aAAa;gBACpC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAO9F;AAED,iCAAiC;AACjC,qBAAa,eAAgB,SAAQ,aAAa;gBACpC,OAAO,EAAE,MAAM;CAI5B;AAED,6BAA6B;AAC7B,qBAAa,YAAa,SAAQ,aAAa;gBACjC,OAAO,EAAE,MAAM;CAI5B"}

package/dist/errors.js

@@ -0,0 +1,151 @@
+/**
+ * 错误类清单（contract-v0.md 附录 B）
+ *
+ * 设计原则：
+ * - 所有错误都是 Error 子类（保证 stack trace 完整）
+ * - 错误名以 Error 结尾（grep 友好；不强制 SerenityError 前缀以便精细分类）
+ * - 错误传播策略：
+ *   1. plugin 入口（index.ts / tui.ts）不抛 — 返回空 hooks 或 toast 通知
+ *   2. 大多数 hook 用 safeHook / safeCreateHook 静默（v0.0.1 release 静默原则 + retry-storm 防护）
+ *   3. 例外：permission-guards.ts 的 tool.execute.before（RR5 hard block）故意
+ *      让 throw 透传 — 中断整条 Effect 链正是 RR5 想要的行为
+ */
+/** 基类：所有 serenity plugin 错误的父类 */
+export class SerenityError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'SerenityError';
+    }
+}
+/** RR1 违反：cwd 不在 git repo 内 */
+export class NotInGitRepoError extends SerenityError {
+    constructor(cwd) {
+        super(`cwd "${cwd}" is not inside a git repository; serenity plugin requires RR6 (cwd must be in a git repo)`);
+        this.name = 'NotInGitRepoError';
+    }
+}
+/** RR1 违反：/.serenity 文件不存在 */
+export class SerenityFileNotFoundError extends SerenityError {
+    constructor(cwdRoot) {
+        super(`/.serenity file not found in "${cwdRoot}"; serenity plugin requires RR1 (/.serenity must exist in cwd root)`);
+        this.name = 'SerenityFileNotFoundError';
+    }
+}
+/** /.serenity 文件存在但内容为空或无效 */
+export class SerenityFileEmptyError extends SerenityError {
+    constructor(path) {
+        super(`/.serenity file at "${path}" is empty or contains only whitespace; expected a non-empty instance name`);
+        this.name = 'SerenityFileEmptyError';
+    }
+}
+/** RR2 违反：.opencode/skills/<instanceName>/SKILL.md 不存在 */
+export class SkillNotFoundError extends SerenityError {
+    constructor(cwdRoot, instanceName) {
+        super(`SKILL.md not found at "${cwdRoot}/.opencode/skills/${instanceName}/SKILL.md"; serenity plugin requires RR2 (the instance skill must exist)`);
+        this.name = 'SkillNotFoundError';
+    }
+}
+/** msm_exec 失败：MSM 不在注册表中 */
+export class MsmNotRegisteredError extends SerenityError {
+    constructor(msmName) {
+        super(`MSM "${msmName}" is not in mech-registry.json; serenity plugin requires registration before use`);
+        this.name = 'MsmNotRegisteredError';
+    }
+}
+/** msm_exec 失败：MSM 子进程超时 */
+export class MsmTimeoutError extends SerenityError {
+    constructor(msmName, timeoutMs) {
+        super(`MSM "${msmName}" timed out after ${timeoutMs}ms`);
+        this.name = 'MsmTimeoutError';
+    }
+}
+/** msm_register 失败：name 已被注册 */
+export class MsmAlreadyRegisteredError extends SerenityError {
+    constructor(msmName) {
+        super(`MSM "${msmName}" is already registered; use msm_deregister first to replace, or pick a different name`);
+        this.name = 'MsmAlreadyRegisteredError';
+    }
+}
+/** msm_register 失败：脚本文件不存在（拒绝注册空路径）*/
+export class MsmScriptNotFoundError extends SerenityError {
+    constructor(msmName, scriptPath) {
+        super(`MSM "${msmName}" script not found at "${scriptPath}"; serenity plugin refuses to register MSMs whose script does not exist`);
+        this.name = 'MsmScriptNotFoundError';
+    }
+}
+/** msm_deregister 失败：name 不在 registry */
+export class MsmNotInRegistryError extends SerenityError {
+    constructor(msmName) {
+        super(`MSM "${msmName}" is not in mech-registry.json; nothing to deregister`);
+        this.name = 'MsmNotInRegistryError';
+    }
+}
+/** msm_exec 失败：MSM 子进程 exit code != 0
+ *
+ * v1.15.1：MsmExecutionError 显式持有 stdout/stderr/exitCode 三个字段
+ * - 修复 S022 RFC §9 缺陷（plugin 端 msm_exec 吞掉 stdout）
+ * - JSON 模式下业务 msm 把错误信息写在 stdout（per S022 §2.3），
+ *   错误对象必须能让 LLM 看到 stdout 原文以便重试/诊断
+ */
+export class MsmExecutionError extends SerenityError {
+    stdout;
+    stderr;
+    exitCode;
+    constructor(msmName, exitCode, stdout, stderr) {
+        const stdoutSnippet = stdout ? `
+stdout: ${stdout.slice(0, 1000)}` : '';
+        const stderrSnippet = stderr ? `
+stderr: ${stderr.slice(0, 500)}` : '';
+        super(`MSM "${msmName}" failed with exit code ${exitCode}${stdoutSnippet}${stderrSnippet}`);
+        this.name = 'MsmExecutionError';
+        this.exitCode = exitCode;
+        this.stdout = stdout;
+        this.stderr = stderr;
+    }
+}
+/** RR7 触发：/.serenity 创建失败（git add/commit 阶段）*/
+export class InitGitCommitError extends SerenityError {
+    constructor(reason) {
+        super(`failed to git add + commit /.serenity: ${reason}`);
+        this.name = 'InitGitCommitError';
+    }
+}
+/** v1.10 RR7：用户输入的 prefix 不是 kebab-case */
+export class InvalidInstanceNameError extends SerenityError {
+    constructor(name) {
+        super(`Invalid serenity prefix "${name}"; must be kebab-case ` +
+            `(lowercase a-z, 0-9, dashes; no leading or trailing dash)`);
+        this.name = 'InvalidInstanceNameError';
+    }
+}
+/** msm_exec 失败：path-arg 解析为 cwdRoot 之外的路径（v0.1-2 path escape guard）*/
+export class MsmPathEscapeError extends SerenityError {
+    constructor(msmName, argName, value, resolved) {
+        super(`MSM "${msmName}" path-arg "${argName}"="${value}" resolves to "${resolved}" ` +
+            `which is outside cwdRoot; serenity plugin blocks path traversal (v0.1-2 pre-indexed guard)`);
+        this.name = 'MsmPathEscapeError';
+    }
+}
+/** msm_exec 失败：path-arg 指向 symlink / symlink 链（v1-1 symlink 防御）*/
+export class MsmSymlinkError extends SerenityError {
+    constructor(msmName, argName, value, resolved, reason) {
+        super(`MSM "${msmName}" path-arg "${argName}"="${value}" → "${resolved}": ${reason}; ` +
+            `serenity plugin blocks symlink attacks (v1-1 symlink guard)`);
+        this.name = 'MsmSymlinkError';
+    }
+}
+/** 文件系统操作错误（file-system-tool） */
+export class FileSystemError extends SerenityError {
+    constructor(message) {
+        super(message);
+        this.name = 'FileSystemError';
+    }
+}
+/** 会话管理操作错误（session-tool） */
+export class SessionError extends SerenityError {
+    constructor(message) {
+        super(message);
+        this.name = 'SessionError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

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

package/dist/fs/file-system-tool.d.ts

@@ -0,0 +1,25 @@
+/**
+ * file-system-tool.ts — 宁静号文件系统基础设施工具
+ *
+ * 提供跨实例的文件系统操作，不依赖任何实例特定的脚本。
+ * 所有路径基于 .serenity 向上遍历动态解析。
+ *
+ * 子命令：
+ *   root     — 寻找并返回宁静号实例根目录
+ *   resolve  — 将相对路径基于根目录解析为绝对路径
+ *   exists   — 检测路径是否存在
+ *   list     — 列出目录内容（含元数据）
+ *   relative — 返回相对于根的相对路径
+ *   mkdir    — 创建目录（递归，类似 mkdir -p）
+ *   rm       — 删除文件/目录（支持多路径批量，--recursive，--dry-run）
+ *   mv       — 移动/重命名
+ *   cp       — 复制文件/目录（--recursive）
+ *   touch    — 创建空文件或更新时间戳
+ *
+ * 安全约束：
+ *   - 写操作（mkdir/rm/mv/cp/touch）自动限制在 .serenity 根内
+ *   - .serenity 文件本身受保护不可删除
+ */
+import { type ToolDefinition } from '@opencode-ai/plugin';
+export declare const fileSystemTool: ToolDefinition;
+//# sourceMappingURL=file-system-tool.d.ts.map

package/dist/fs/file-system-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-system-tool.d.ts","sourceRoot":"","sources":["../../src/fs/file-system-tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AASH,OAAO,EAAQ,KAAK,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAsFhE,eAAO,MAAM,cAAc,EAAE,cA4Q3B,CAAC"}

package/dist/fs/file-system-tool.js

@@ -0,0 +1,318 @@
+/**
+ * file-system-tool.ts — 宁静号文件系统基础设施工具
+ *
+ * 提供跨实例的文件系统操作，不依赖任何实例特定的脚本。
+ * 所有路径基于 .serenity 向上遍历动态解析。
+ *
+ * 子命令：
+ *   root     — 寻找并返回宁静号实例根目录
+ *   resolve  — 将相对路径基于根目录解析为绝对路径
+ *   exists   — 检测路径是否存在
+ *   list     — 列出目录内容（含元数据）
+ *   relative — 返回相对于根的相对路径
+ *   mkdir    — 创建目录（递归，类似 mkdir -p）
+ *   rm       — 删除文件/目录（支持多路径批量，--recursive，--dry-run）
+ *   mv       — 移动/重命名
+ *   cp       — 复制文件/目录（--recursive）
+ *   touch    — 创建空文件或更新时间戳
+ *
+ * 安全约束：
+ *   - 写操作（mkdir/rm/mv/cp/touch）自动限制在 .serenity 根内
+ *   - .serenity 文件本身受保护不可删除
+ */
+import { existsSync, statSync, readdirSync, mkdirSync, unlinkSync, rmdirSync, rmSync, renameSync, cpSync, utimesSync, writeFileSync, } from 'node:fs';
+import { resolve, dirname, normalize } from 'node:path';
+import { tool } from '@opencode-ai/plugin';
+import { z } from 'zod';
+import { FileSystemError } from '../errors.js';
+import { findSerenityRoot, resolveRootPath, isPathInsideSerenity, serenityPathRelative, } from './resolve-path.js';
+import pkg from '../../package.json' with { type: 'json' };
+const VERSION = pkg.version;
+function detectFileType(stat) {
+    if (stat.isDirectory())
+        return 'dir';
+    if (stat.isFile())
+        return 'file';
+    if (stat.isSymbolicLink())
+        return 'symlink';
+    return 'other';
+}
+function humanSize(bytes) {
+    if (bytes < 1024)
+        return `${bytes} B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(1)} KB`;
+    return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+}
+function getFileInfo(absPath, name) {
+    try {
+        const stat = statSync(absPath);
+        return {
+            name,
+            type: detectFileType(stat),
+            size: stat.size,
+            sizeHuman: humanSize(stat.size),
+            mtime: stat.mtime.toISOString(),
+        };
+    }
+    catch {
+        return { name, type: 'other', size: 0, sizeHuman: '?', mtime: '?' };
+    }
+}
+// ── 写操作路径校验 ──
+function validateWritePath(root, target) {
+    const absPath = target.startsWith('/') ? normalize(target) : resolveRootPath(root, target);
+    if (!isPathInsideSerenity(root, absPath)) {
+        throw new FileSystemError(`file-system: path "${target}" resolves to "${absPath}" which is outside serenity root "${root}"`);
+    }
+    return absPath;
+}
+function assertNotProtected(root, absPath, targetLabel) {
+    // Protect .serenity file from deletion
+    const serenityMarker = resolve(root, '.serenity');
+    if (absPath === serenityMarker) {
+        throw new FileSystemError(`file-system: refusing to delete protected path: ${targetLabel} (.serenity is the serenity instance marker)`);
+    }
+    // Protect the root directory itself
+    if (absPath === root) {
+        throw new FileSystemError(`file-system: refusing to delete the serenity root directory: ${targetLabel}`);
+    }
+}
+// ── Tool 定义 ──
+const SUBCOMMANDS = [
+    'root', 'resolve', 'exists', 'list', 'relative',
+    'mkdir', 'rm', 'mv', 'cp', 'touch',
+];
+export const fileSystemTool = tool({
+    description: `Serenity file-system utility (v${VERSION}). ` +
+        'Resolves paths relative to the serenity instance root (the directory containing .serenity). ' +
+        'Use this instead of raw read/edit tools when you need to work with serenity instance paths. ' +
+        'All subcommands validate that paths stay within the serenity root.',
+    args: {
+        subcommand: z
+            .enum(SUBCOMMANDS)
+            .describe('Operation to perform:\n' +
+            '  root     — Find and return the serenity root directory\n' +
+            '  resolve  — Resolve a relative path to absolute (relative to root)\n' +
+            '  exists   — Check if a path exists\n' +
+            '  list     — List directory contents with metadata (JSON)\n' +
+            '  relative — Get path relative to serenity root\n' +
+            '  mkdir    — Create directory (recursive, like mkdir -p)\n' +
+            '  rm       — Delete files/directories (batch: pass multiple paths via paths arg)\n' +
+            '  mv       — Move or rename a file/directory\n' +
+            '  cp       — Copy a file or directory\n' +
+            '  touch    — Create empty file or update timestamp'),
+        path: z
+            .string()
+            .optional()
+            .describe('Single path argument for resolve/exists/list/relative/mkdir/touch subcommands. ' +
+            'Can be relative (from serenity root) or absolute (must be inside serenity root for write operations).'),
+        paths: z
+            .array(z.string())
+            .optional()
+            .describe('Multiple paths for rm batch delete. ' +
+            'Each path can be relative or absolute (must be inside serenity root). ' +
+            'Also accepts a single path via the "path" arg for convenience.'),
+        src: z
+            .string()
+            .optional()
+            .describe('Source path for mv/cp subcommands.'),
+        dst: z
+            .string()
+            .optional()
+            .describe('Destination path for mv/cp subcommands.'),
+        recursive: z
+            .boolean()
+            .optional()
+            .default(false)
+            .describe('Recursive operation for rm (delete directories) and cp (copy directories).'),
+        'dry-run': z
+            .boolean()
+            .optional()
+            .default(false)
+            .describe('Preview changes without actually modifying files. Supported by rm.'),
+    },
+    execute: async (input, ctx) => {
+        const cwd = ctx.directory;
+        const root = findSerenityRoot(cwd);
+        const sub = input.subcommand;
+        // ── root ──
+        if (sub === 'root') {
+            return root;
+        }
+        // ── resolve ──
+        if (sub === 'resolve') {
+            if (!input.path)
+                throw new FileSystemError('file-system resolve: requires a path argument');
+            return resolveRootPath(root, input.path);
+        }
+        // ── relative ──
+        if (sub === 'relative') {
+            if (!input.path)
+                throw new FileSystemError('file-system relative: requires a path argument');
+            const absPath = input.path.startsWith('/')
+                ? input.path
+                : resolveRootPath(root, input.path);
+            if (!isPathInsideSerenity(root, absPath)) {
+                throw new FileSystemError(`file-system relative: path "${input.path}" resolves to "${absPath}" which is outside serenity root "${root}"`);
+            }
+            return serenityPathRelative(root, absPath);
+        }
+        // ── exists ──
+        if (sub === 'exists') {
+            if (!input.path)
+                throw new FileSystemError('file-system exists: requires a path argument');
+            const absPath = input.path.startsWith('/')
+                ? input.path
+                : resolveRootPath(root, input.path);
+            return existsSync(absPath) ? 'true' : 'false';
+        }
+        // ── list（增强：返回 JSON 元数据）──
+        if (sub === 'list') {
+            if (!input.path)
+                throw new FileSystemError('file-system list: requires a path argument');
+            const absPath = input.path.startsWith('/')
+                ? input.path
+                : resolveRootPath(root, input.path);
+            if (!existsSync(absPath)) {
+                throw new FileSystemError(`file-system list: path "${absPath}" does not exist`);
+            }
+            const names = readdirSync(absPath);
+            const entries = names.sort().map((name) => getFileInfo(resolve(absPath, name), name));
+            return JSON.stringify({ path: absPath, entries, count: entries.length }, null, 2);
+        }
+        // ── mkdir（递归创建，类似 mkdir -p）──
+        if (sub === 'mkdir') {
+            if (!input.path)
+                throw new FileSystemError('file-system mkdir: requires a path argument');
+            const absPath = validateWritePath(root, input.path);
+            if (existsSync(absPath)) {
+                const stat = statSync(absPath);
+                if (stat.isDirectory())
+                    return `directory already exists: ${input.path}`;
+                throw new FileSystemError(`file-system mkdir: path "${input.path}" exists but is not a directory`);
+            }
+            mkdirSync(absPath, { recursive: true });
+            return `created directory: ${input.path}`;
+        }
+        // ── rm（多路径批量删除）──
+        if (sub === 'rm') {
+            // 合并单路径和多路径参数
+            const targets = [...(input.paths ?? [])];
+            if (input.path)
+                targets.push(input.path);
+            if (targets.length === 0) {
+                throw new FileSystemError('file-system rm: requires at least one path argument (path or paths)');
+            }
+            const dryRun = input['dry-run'] ?? false;
+            const recursive = input.recursive ?? false;
+            const results = [];
+            for (const target of targets) {
+                const absPath = validateWritePath(root, target);
+                if (!existsSync(absPath)) {
+                    results.push(`[SKIP] not found: ${target}`);
+                    continue;
+                }
+                const stat = statSync(absPath);
+                const isDir = stat.isDirectory();
+                // 保护 .serenity 和根目录
+                try {
+                    assertNotProtected(root, absPath, target);
+                }
+                catch (e) {
+                    results.push(`[SKIP] ${e.message}`);
+                    continue;
+                }
+                const relLabel = serenityPathRelative(root, absPath);
+                if (dryRun) {
+                    const extra = isDir ? (recursive ? ' (recursive)' : '') : '';
+                    results.push(`[DRY-RUN] ${isDir ? 'directory' : 'file'}: ${relLabel}${extra}`);
+                    continue;
+                }
+                if (isDir && !recursive) {
+                    const entries = readdirSync(absPath);
+                    if (entries.length > 0) {
+                        results.push(`[SKIP] directory not empty (${entries.length} items), use --recursive: ${relLabel}`);
+                        continue;
+                    }
+                    rmdirSync(absPath);
+                }
+                else if (isDir) {
+                    rmSync(absPath, { recursive: true, force: false });
+                }
+                else {
+                    unlinkSync(absPath);
+                }
+                results.push(`[OK] deleted: ${relLabel}`);
+            }
+            return results.join('\n');
+        }
+        // ── mv（移动/重命名）──
+        if (sub === 'mv') {
+            if (!input.src || !input.dst) {
+                throw new FileSystemError('file-system mv: requires both --src and --dst arguments');
+            }
+            const srcAbs = validateWritePath(root, input.src);
+            const dstAbs = validateWritePath(root, input.dst);
+            if (!existsSync(srcAbs)) {
+                throw new FileSystemError(`file-system mv: source not found: ${input.src}`);
+            }
+            if (existsSync(dstAbs)) {
+                throw new FileSystemError(`file-system mv: destination already exists: ${input.dst}`);
+            }
+            // 自动创建目标父目录
+            const parentDir = dirname(dstAbs);
+            if (!existsSync(parentDir)) {
+                mkdirSync(parentDir, { recursive: true });
+            }
+            renameSync(srcAbs, dstAbs);
+            return `moved: ${input.src} \u2192 ${input.dst}`;
+        }
+        // ── cp（复制）──
+        if (sub === 'cp') {
+            if (!input.src || !input.dst) {
+                throw new FileSystemError('file-system cp: requires both --src and --dst arguments');
+            }
+            const srcAbs = validateWritePath(root, input.src);
+            const dstAbs = validateWritePath(root, input.dst);
+            if (!existsSync(srcAbs)) {
+                throw new FileSystemError(`file-system cp: source not found: ${input.src}`);
+            }
+            if (existsSync(dstAbs)) {
+                throw new FileSystemError(`file-system cp: destination already exists: ${input.dst}`);
+            }
+            const stat = statSync(srcAbs);
+            if (stat.isDirectory() && !input.recursive) {
+                throw new FileSystemError(`file-system cp: source is a directory, use --recursive to copy: ${input.src}`);
+            }
+            // 自动创建目标父目录
+            const parentDir = dirname(dstAbs);
+            if (!existsSync(parentDir)) {
+                mkdirSync(parentDir, { recursive: true });
+            }
+            cpSync(srcAbs, dstAbs, { recursive: input.recursive ?? false });
+            return `copied: ${input.src} \u2192 ${input.dst}`;
+        }
+        // ── touch（创建空文件 / 更新时间戳）──
+        if (sub === 'touch') {
+            if (!input.path)
+                throw new FileSystemError('file-system touch: requires a path argument');
+            const absPath = validateWritePath(root, input.path);
+            if (existsSync(absPath)) {
+                // 更新时间戳到当前时间
+                const now = new Date();
+                utimesSync(absPath, now, now);
+                return `updated timestamp: ${input.path}`;
+            }
+            // 创建空文件，自动创建父目录
+            const parentDir = dirname(absPath);
+            if (!existsSync(parentDir)) {
+                mkdirSync(parentDir, { recursive: true });
+            }
+            writeFileSync(absPath, '', 'utf8');
+            return `created empty file: ${input.path}`;
+        }
+        throw new FileSystemError(`file-system: unknown subcommand "${sub}"`);
+    },
+});
+//# sourceMappingURL=file-system-tool.js.map

package/dist/fs/file-system-tool.js.map

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