@synity/bitrix-skills 1.3.0

package/dist/features/bx-task/install.js

@@ -0,0 +1,111 @@
+// src/features/bx-task/install.ts
+import { homedir } from "os";
+import { resolve, join, dirname } from "path";
+import { fileURLToPath } from "url";
+import { mkdir, copyFile, readdir, stat, rm, access } from "fs/promises";
+
+// src/lib/fs-safety.ts
+import { lstat } from "fs/promises";
+import path from "path";
+async function assertNotSymlink(destPath) {
+  try {
+    const stat2 = await lstat(destPath);
+    if (stat2.isSymbolicLink()) {
+      throw new Error(
+        `Refusing to overwrite symlink: ${destPath}. Remove it manually then re-run install.`
+      );
+    }
+  } catch (err) {
+    if (err.code === "ENOENT") return;
+    throw err;
+  }
+}
+function assertContainedIn(destAbs, allowedRoot, label) {
+  const root = allowedRoot.endsWith(path.sep) ? allowedRoot : allowedRoot + path.sep;
+  if (!destAbs.startsWith(root)) {
+    throw new Error(
+      `"${label}" resolves outside allowed root (${root}). Refusing \u2014 possible path traversal.`
+    );
+  }
+}
+
+// src/features/bx-task/install.ts
+async function getAssetsDir() {
+  const here = dirname(fileURLToPath(import.meta.url));
+  const candidates = [
+    // dist/ context (inlined in cli.js): ../src/features/bx-task/assets
+    resolve(here, "../src/features/bx-task/assets"),
+    // dist/features/bx-task/ context: ../../../src/features/bx-task/assets
+    resolve(here, "../../../src/features/bx-task/assets"),
+    // src/features/bx-task/ (dev)
+    resolve(here, "assets")
+  ];
+  for (const c of candidates) {
+    try {
+      await access(c);
+      return c;
+    } catch {
+    }
+  }
+  return candidates[0];
+}
+function getSkillBase() {
+  return resolve(homedir(), ".claude", "skills");
+}
+async function install(opts) {
+  const skillBase = getSkillBase();
+  const dest = opts._destOverride ?? resolve(skillBase, "bx-task");
+  const resolvedDest = resolve(dest);
+  if (!opts._destOverride && !resolvedDest.startsWith(skillBase)) {
+    throw new Error(`Path traversal detected: ${resolvedDest}`);
+  }
+  const result = {
+    installedFiles: [],
+    skippedFiles: [],
+    warnings: []
+  };
+  await installDir(await getAssetsDir(), resolvedDest, result, opts);
+  result.warnings.push(
+    '[bx-task] Requires MCP server "bitrix-synity-mcp" \u2014 verify it is configured in Claude Code settings.'
+  );
+  return result;
+}
+async function installDir(srcDir, destDir, result, opts) {
+  await mkdir(destDir, { recursive: true });
+  const entries = await readdir(srcDir, { withFileTypes: true });
+  for (const entry of entries) {
+    const srcPath = join(srcDir, entry.name);
+    const destPath = join(destDir, entry.name);
+    if (entry.isDirectory()) {
+      await installDir(srcPath, destPath, result, opts);
+      continue;
+    }
+    await assertNotSymlink(destPath);
+    const exists = await fileExists(destPath);
+    if (exists && !opts.force && opts.onConflict === "skip") {
+      result.skippedFiles.push(destPath);
+      continue;
+    }
+    await copyFile(srcPath, destPath);
+    result.installedFiles.push(destPath);
+  }
+}
+async function fileExists(filePath) {
+  try {
+    await stat(filePath);
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function uninstall(opts) {
+  const dest = resolve(opts?._destOverride ?? resolve(homedir(), ".claude", "skills", "bx-task"));
+  if (!opts?._destOverride) {
+    assertContainedIn(dest, getSkillBase(), dest);
+  }
+  await rm(dest, { recursive: true, force: true });
+}
+export {
+  install,
+  uninstall
+};