encoding-aware-fs 0.1.1 → 0.1.3

package/dist/index.js

@@ -26539,6 +26539,10 @@ var init_config_io = __esm({
 // src/uninstaller.ts
 var uninstaller_exports = {};
 __export(uninstaller_exports, {
+  detectInstalled: () => detectInstalled,
+  isOpenCodeJsoncEmpty: () => isOpenCodeJsoncEmpty,
+  removeOpenCodeConfig: () => removeOpenCodeConfig,
+  removeRuleFile: () => removeRuleFile,
   runUninstaller: () => runUninstaller
 });
 async function fileExists(filePath) {
@@ -26561,8 +26565,18 @@ async function removeDirIfEmpty(dirPath) {
 function isEmptyMcpJson(data) {
   return data && typeof data === "object" && data.mcpServers && typeof data.mcpServers === "object" && Object.keys(data.mcpServers).length === 0 && Object.keys(data).length === 1;
 }
-function isEmptyOpenCodeJsonc(data) {
-  return data && typeof data === "object" && data.mcp && typeof data.mcp === "object" && Object.keys(data.mcp).length === 0 && Object.keys(data).length === 1;
+function isOpenCodeJsoncEmpty(data) {
+  if (!data || typeof data !== "object")
+    return false;
+  const keys = Object.keys(data);
+  return keys.every((key) => {
+    const val = data[key];
+    if (Array.isArray(val))
+      return val.length === 0;
+    if (typeof val === "object" && val !== null)
+      return Object.keys(val).length === 0;
+    return false;
+  });
 }
 async function detectInstalled(cwd) {
   const found = [];
@@ -26570,24 +26584,31 @@ async function detectInstalled(cwd) {
   const mcpJson = await readJsonFile(mcpJsonPath);
   const claudeSkillPath = path5.join(cwd, ".claude", "skills", "encoding-aware-fs", "SKILL.md");
   const hasClaudeSkill = await fileExists(claudeSkillPath);
-  if (mcpJson?.mcpServers?.["encoding-aware-fs"] || hasClaudeSkill) {
+  const claudeRulePath = path5.join(cwd, ".claude", "rules", "encoding-aware-fs.md");
+  const hasClaudeRule = await fileExists(claudeRulePath);
+  if (mcpJson?.mcpServers?.["encoding-aware-fs"] || hasClaudeSkill || hasClaudeRule) {
     found.push({
       type: "claude-code",
       name: "Claude Code (.mcp.json)",
       configPath: mcpJsonPath,
-      skillPath: hasClaudeSkill ? claudeSkillPath : void 0
+      skillPath: hasClaudeSkill ? claudeSkillPath : void 0,
+      rulePath: hasClaudeRule ? claudeRulePath : void 0
     });
   }
   const openCodePath = path5.join(cwd, "opencode.jsonc");
   const openCode = await readJsonFile(openCodePath);
   const openCodeSkillPath = path5.join(cwd, ".agents", "skills", "encoding-aware-fs", "SKILL.md");
   const hasOpenCodeSkill = await fileExists(openCodeSkillPath);
-  if (openCode?.mcp?.["encoding-aware-fs"] || hasOpenCodeSkill) {
+  const openCodeRulePath = path5.join(cwd, ".agents", "rules", "encoding-aware-fs.md");
+  const hasOpenCodeRule = await fileExists(openCodeRulePath);
+  const hasOpenCodeInstructions = Array.isArray(openCode?.instructions) && openCode.instructions.includes(".agents/rules/encoding-aware-fs.md");
+  if (openCode?.mcp?.["encoding-aware-fs"] || hasOpenCodeSkill || hasOpenCodeRule || hasOpenCodeInstructions) {
     found.push({
       type: "opencode",
       name: "OpenCode (opencode.jsonc)",
       configPath: openCodePath,
-      skillPath: hasOpenCodeSkill ? openCodeSkillPath : void 0
+      skillPath: hasOpenCodeSkill ? openCodeSkillPath : void 0,
+      rulePath: hasOpenCodeRule ? openCodeRulePath : void 0
     });
   }
   return found;
@@ -26605,17 +26626,28 @@ async function removeClaudeCodeEntry(configPath) {
     console.log(`  \u2713 Removed encoding-aware-fs entry from ${configPath}`);
   }
 }
-async function removeOpenCodeEntry(configPath) {
+async function removeOpenCodeConfig(configPath) {
   const data = await readJsonFile(configPath);
-  if (!data?.mcp?.["encoding-aware-fs"])
+  if (!data)
     return;
-  delete data.mcp["encoding-aware-fs"];
-  if (isEmptyOpenCodeJsonc(data)) {
+  if (data.mcp?.["encoding-aware-fs"]) {
+    delete data.mcp["encoding-aware-fs"];
+    if (Object.keys(data.mcp).length === 0)
+      delete data.mcp;
+  }
+  if (Array.isArray(data.instructions)) {
+    data.instructions = data.instructions.filter(
+      (i) => i !== ".agents/rules/encoding-aware-fs.md"
+    );
+    if (data.instructions.length === 0)
+      delete data.instructions;
+  }
+  if (isOpenCodeJsoncEmpty(data) || Object.keys(data).length === 0) {
     await fs9.unlink(configPath);
     console.log(`  \u2713 Removed ${configPath} (was empty after cleanup)`);
   } else {
     await writeJsonFile(configPath, data);
-    console.log(`  \u2713 Removed encoding-aware-fs entry from ${configPath}`);
+    console.log(`  \u2713 Removed encoding-aware-fs entries from ${configPath}`);
   }
 }
 async function removeSkillFiles(platform) {
@@ -26636,6 +26668,22 @@ async function removeSkillFiles(platform) {
   const parentDir = path5.dirname(skillsDir);
   await removeDirIfEmpty(parentDir);
 }
+async function removeRuleFile(platform) {
+  if (!platform.rulePath)
+    return;
+  try {
+    await fs9.unlink(platform.rulePath);
+    console.log(`  \u2713 Removed ${platform.rulePath}`);
+  } catch (err) {
+    if (err.code !== "ENOENT")
+      throw err;
+    return;
+  }
+  const ruleDir = path5.dirname(platform.rulePath);
+  await removeDirIfEmpty(ruleDir);
+  const parentDir = path5.dirname(ruleDir);
+  await removeDirIfEmpty(parentDir);
+}
 async function runUninstaller() {
   const cwd = process.cwd();
   console.log();
@@ -26655,10 +26703,13 @@ async function runUninstaller() {
     if (p.skillPath) {
       console.log(`    + Skill file: ${p.skillPath}`);
     }
+    if (p.rulePath) {
+      console.log(`    + Rule file: ${p.rulePath}`);
+    }
   }
   console.log();
   const proceed = await (0, import_prompts.confirm)({
-    message: "Remove encoding-aware-fs MCP config entries and skill files?",
+    message: "Remove encoding-aware-fs MCP config entries, skill files, and rule files?",
     default: false
   });
   if (!proceed) {
@@ -26670,12 +26721,15 @@ async function runUninstaller() {
     if (p.type === "claude-code") {
       await removeClaudeCodeEntry(p.configPath);
     } else if (p.type === "opencode") {
-      await removeOpenCodeEntry(p.configPath);
+      await removeOpenCodeConfig(p.configPath);
     }
   }
   for (const p of installed) {
     await removeSkillFiles(p);
   }
+  for (const p of installed) {
+    await removeRuleFile(p);
+  }
   const encodingConfigPath = path5.join(cwd, ".encoding-converter.json");
   try {
     await fs9.access(encodingConfigPath);
@@ -26700,6 +26754,8 @@ var init_uninstaller = __esm({
 // src/installer.ts
 var installer_exports = {};
 __export(installer_exports, {
+  addOpenCodeInstructions: () => addOpenCodeInstructions,
+  copyRuleFile: () => copyRuleFile,
   runInstaller: () => runInstaller
 });
 function checkNodeVersion() {
@@ -26725,9 +26781,10 @@ async function writeClaudeCodeConfig(cwd) {
   if (!merged.mcpServers) {
     merged.mcpServers = {};
   }
+  const isWindows = process.platform === "win32";
   merged.mcpServers["encoding-aware-fs"] = {
-    command: "npx",
-    args: ["-y", "encoding-aware-fs", "serve"],
+    command: isWindows ? "cmd" : "npx",
+    args: isWindows ? ["/c", "npx", "-y", "encoding-aware-fs", "serve"] : ["-y", "encoding-aware-fs", "serve"],
     env: {}
   };
   await writeJsonFile(configPath, merged);
@@ -26740,9 +26797,10 @@ async function writeOpenCodeConfig(cwd) {
   if (!merged.mcp) {
     merged.mcp = {};
   }
+  const isWindows = process.platform === "win32";
   merged.mcp["encoding-aware-fs"] = {
     type: "local",
-    command: ["npx", "-y", "encoding-aware-fs", "serve"],
+    command: isWindows ? ["cmd", "/c", "npx", "-y", "encoding-aware-fs", "serve"] : ["npx", "-y", "encoding-aware-fs", "serve"],
     enabled: true,
     timeout: 3e4
   };
@@ -26763,6 +26821,33 @@ async function copySkillFile(cwd, platform) {
   await fs10.copyFile(sourcePath, targetPath);
   console.log(`  \u2713 Installed skill \u2192 ${targetPath}`);
 }
+async function copyRuleFile(cwd, platform) {
+  const sourcePath = path6.join(path6.resolve(__dirname, ".."), "skills", platform, "RULE.md");
+  try {
+    await fs10.access(sourcePath);
+  } catch {
+    console.log(`  \u26A0 Rule file template not found, skipping`);
+    return;
+  }
+  const ruleDir = platform === "claude-code" ? path6.join(cwd, ".claude", "rules") : path6.join(cwd, ".agents", "rules");
+  const rulePath = path6.join(ruleDir, "encoding-aware-fs.md");
+  await fs10.mkdir(ruleDir, { recursive: true });
+  await fs10.copyFile(sourcePath, rulePath);
+  console.log(`  \u2713 Installed rule \u2192 ${rulePath}`);
+}
+async function addOpenCodeInstructions(cwd) {
+  const configPath = path6.join(cwd, "opencode.jsonc");
+  const existing = await readJsonFile(configPath);
+  const merged = existing ?? {};
+  if (!merged.instructions) {
+    merged.instructions = [];
+  }
+  const rulePath = ".agents/rules/encoding-aware-fs.md";
+  if (!merged.instructions.includes(rulePath)) {
+    merged.instructions.push(rulePath);
+  }
+  await writeJsonFile(configPath, merged);
+}
 async function ensureEncodingConfig(cwd) {
   const configPath = path6.join(cwd, ".encoding-converter.json");
   try {
@@ -26826,6 +26911,15 @@ async function runInstaller() {
   for (const platform of platforms) {
     await copySkillFile(cwd, platform);
   }
+  console.log();
+  console.log("Rule files:");
+  for (const platform of platforms) {
+    await copyRuleFile(cwd, platform);
+  }
+  if (platforms.includes("opencode")) {
+    await addOpenCodeInstructions(cwd);
+    console.log("  \u2713 Added rule to opencode.jsonc instructions");
+  }
   await ensureEncodingConfig(cwd);
   console.log();
   console.log("\u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510");
@@ -26838,7 +26932,7 @@ async function runInstaller() {
     console.log("\u2502  OpenCode:    restart opencode            \u2502");
   }
   console.log("\u2502                                          \u2502");
-  console.log("\u2502  Skill files installed for AI discovery.  \u2502");
+  console.log("\u2502  Rule + Skill files installed for AI.     \u2502");
   console.log("\u2502  The MCP server will start automatically  \u2502");
   console.log("\u2502  when your AI tool connects.             \u2502");
   console.log("\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "encoding-aware-fs",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Encoding-aware file operations MCP Server for AI tools working with GB18030 projects",
   "main": "dist/server.js",
   "bin": {

package/skills/claude-code/RULE.md

@@ -0,0 +1,3 @@
+MUST use encoding-aware-fs MCP tools (read_file, write_file, edit_file)
+for ALL file operations in this project. NEVER use the built-in Read, Write,
+or Edit tools for any file inside the project directory.

package/skills/opencode/RULE.md

@@ -0,0 +1,3 @@
+MUST use encoding-aware-fs MCP tools (read_file, write_file, edit_file)
+for ALL file operations in this project. NEVER use the built-in Read, Write,
+or Edit tools for any file inside the project directory.

package/.encoding-converter.json

@@ -1,5 +0,0 @@
-{
-  "sourceEncoding": "GB18030",
-  "targetEncoding": "UTF-8",
-  "confidenceThreshold": 0.8
-}

package/.mcp.json

@@ -1,13 +0,0 @@
-{
-  "mcpServers": {
-    "encoding-aware-fs": {
-      "command": "npx",
-      "args": [
-        "-y",
-        "encoding-aware-fs",
-        "serve"
-      ],
-      "env": {}
-    }
-  }
-}

package/opencode.jsonc

@@ -1,15 +0,0 @@
-{
-  "mcp": {
-    "encoding-aware-fs": {
-      "type": "local",
-      "command": [
-        "npx",
-        "-y",
-        "encoding-aware-fs",
-        "serve"
-      ],
-      "enabled": true,
-      "timeout": 30000
-    }
-  }
-}