Skip to content

Context7 Platform -- Up-to-date docs for AI agents

3.5 KB
Raw Blame
import { afterEach, beforeEach, describe, expect, test } from "vitest";
import { mkdir, readFile, rm, access } from "fs/promises";
import { join } from "path";
import { tmpdir } from "os";

import { installSkillFiles } from "../utils/installer.js";
import { isSafeSkillName, assertSkillNameInRoot } from "../utils/skill-name.js";

let tempDir: string;

async function exists(path: string): Promise<boolean> {
  try {
    await access(path);
    return true;
  } catch {
    return false;
  }
}

beforeEach(async () => {
  tempDir = join(tmpdir(), `ctx7-installer-test-${Date.now()}-${Math.random()}`);
  await mkdir(tempDir, { recursive: true });
});

afterEach(async () => {
  await rm(tempDir, { recursive: true, force: true });
});

describe("isSafeSkillName", () => {
  test("accepts typical skill names", () => {
    for (const name of [
      "pdf",
      "find-docs",
      "skill_one",
      "skill.v2",
      "a1",
      "abc123",
      "PDF",
      "Find-Docs",
      "MySkill",
    ]) {
      expect(isSafeSkillName(name)).toBe(true);
    }
  });

  test("rejects path traversal and separators", () => {
    for (const name of [
      "..",
      ".",
      "../evil",
      "..\\evil",
      "a/b",
      "a\\b",
      "/abs",
      "C:\\drive",
      "with space",
      "",
      ".hidden",
      "name\0",
      "name\nwith-newline",
    ]) {
      expect(isSafeSkillName(name)).toBe(false);
    }
  });

  test("rejects names longer than 128 chars", () => {
    expect(isSafeSkillName("a".repeat(128))).toBe(true);
    expect(isSafeSkillName("a".repeat(129))).toBe(false);
  });
});

describe("assertSkillNameInRoot", () => {
  test("returns resolved path for safe name", () => {
    const result = assertSkillNameInRoot("/tmp/skills", "pdf");
    expect(result).toBe("/tmp/skills/pdf");
  });

  test("throws on traversal", () => {
    expect(() => assertSkillNameInRoot("/tmp/skills", "..")).toThrow();
    expect(() => assertSkillNameInRoot("/tmp/skills", "../evil")).toThrow();
  });
});

describe("installSkillFiles", () => {
  test("writes files inside the skill directory", async () => {
    const skillsRoot = join(tempDir, "skills");
    await mkdir(skillsRoot, { recursive: true });

    await installSkillFiles("good", [{ path: "SKILL.md", content: "hello" }], skillsRoot);

    const written = await readFile(join(skillsRoot, "good", "SKILL.md"), "utf8");
    expect(written).toBe("hello");
  });

  test("rejects skill name '..' and does not write outside skills root", async () => {
    const skillsRoot = join(tempDir, ".claude", "skills");
    await mkdir(skillsRoot, { recursive: true });

    const settingsPath = join(tempDir, ".claude", "settings.json");

    await expect(
      installSkillFiles("..", [{ path: "settings.json", content: '{"hooks":{}}' }], skillsRoot)
    ).rejects.toThrow();

    expect(await exists(settingsPath)).toBe(false);
  });

  test("rejects skill names with path separators", async () => {
    const skillsRoot = join(tempDir, "skills");
    await mkdir(skillsRoot, { recursive: true });

    for (const bad of ["../evil", "a/b", "..\\evil"]) {
      await expect(
        installSkillFiles(bad, [{ path: "SKILL.md", content: "x" }], skillsRoot)
      ).rejects.toThrow();
    }
  });

  test("still rejects traversal in file.path", async () => {
    const skillsRoot = join(tempDir, "skills");
    await mkdir(skillsRoot, { recursive: true });

    await expect(
      installSkillFiles("good", [{ path: "../escape.txt", content: "x" }], skillsRoot)
    ).rejects.toThrow(/outside/);
  });
});