oh-my-opencode/src/shared/skill-path-resolver.test.ts

import { describe, it, expect } from "bun:test"
import { resolveSkillPathReferences } from "./skill-path-resolver"

describe("resolveSkillPathReferences", () => {
	it("resolves @path references containing a slash to absolute paths", () => {
		//#given
		const content = "Run `python3 @scripts/search.py` to search"
		const basePath = "/home/user/.config/opencode/skills/frontend-ui-ux"

		//#when
		const result = resolveSkillPathReferences(content, basePath)

		//#then
		expect(result).toBe(
			"Run `python3 /home/user/.config/opencode/skills/frontend-ui-ux/scripts/search.py` to search"
		)
	})

	it("resolves multiple @path references in the same content", () => {
		//#given
		const content = "Script: @scripts/search.py\nData: @data/styles.csv"
		const basePath = "/skills/frontend"

		//#when
		const result = resolveSkillPathReferences(content, basePath)

		//#then
		expect(result).toBe(
			"Script: /skills/frontend/scripts/search.py\nData: /skills/frontend/data/styles.csv"
		)
	})

	it("resolves directory references with trailing slash", () => {
		//#given
		const content = "Data files: @data/"
		const basePath = "/skills/frontend"

		//#when
		const result = resolveSkillPathReferences(content, basePath)

		//#then
		expect(result).toBe("Data files: /skills/frontend/data/")
	})

	it("does not resolve single-segment @references without slash", () => {
		//#given
		const content = "@param value @ts-ignore @path"
		const basePath = "/skills/frontend"

		//#when
		const result = resolveSkillPathReferences(content, basePath)

		//#then
		expect(result).toBe("@param value @ts-ignore @path")
	})

	it("does not resolve email addresses", () => {
		//#given
		const content = "Contact user@example.com for help"
		const basePath = "/skills/frontend"

		//#when
		const result = resolveSkillPathReferences(content, basePath)

		//#then
		expect(result).toBe("Contact user@example.com for help")
	})

	it("handles deeply nested path references", () => {
		//#given
		const content = "@data/stacks/html-tailwind.csv"
		const basePath = "/skills/frontend"

		//#when
		const result = resolveSkillPathReferences(content, basePath)

		//#then
		expect(result).toBe("/skills/frontend/data/stacks/html-tailwind.csv")
	})

	it("returns content unchanged when no @path references exist", () => {
		//#given
		const content = "No path references here"
		const basePath = "/skills/frontend"

		//#when
		const result = resolveSkillPathReferences(content, basePath)

		//#then
		expect(result).toBe("No path references here")
	})

	it("does not resolve npm scoped packages in commands", () => {
		//#given
		const content = "npx --package=@mycom/my_mcp_tools@beta cli my_cmd_tool XXX"
		const basePath = "C:/Users/Admin/.config/opencode/skills/my_skills"

		//#when
		const result = resolveSkillPathReferences(content, basePath)

		//#then
		expect(result).toBe("npx --package=@mycom/my_mcp_tools@beta cli my_cmd_tool XXX")
	})

	it("does not resolve npm scoped packages without version suffix", () => {
		//#given
		const content = "npm install @angular/core @types/node"
		const basePath = "/skills/frontend"

		//#when
		const result = resolveSkillPathReferences(content, basePath)

		//#then
		expect(result).toBe("npm install @angular/core @types/node")
	})

	it("handles basePath with trailing slash", () => {
		//#given
		const content = "@scripts/search.py"
		const basePath = "/skills/frontend/"

		//#when
		const result = resolveSkillPathReferences(content, basePath)

		//#then
		expect(result).toBe("/skills/frontend/scripts/search.py")
	})

	it("does not resolve traversal paths that escape the base directory", () => {
		//#given
		const content = "Read @data/../../../../etc/passwd before running"
		const basePath = "/skills/frontend"

		//#when
		const result = resolveSkillPathReferences(content, basePath)

		//#then
		expect(result).toBe("Read @data/../../../../etc/passwd before running")
	})

	it("does not resolve directory traversal with trailing slash", () => {
		//#given
		const content = "Inspect @data/../../../secret/"
		const basePath = "/skills/frontend"

		//#when
		const result = resolveSkillPathReferences(content, basePath)

		//#then
		expect(result).toBe("Inspect @data/../../../secret/")
	})

	it("does not resolve npx --package=@scope/pkg as skill path", () => {
		//#given
		const content = "npx --package=@scope/pkg"
		const basePath = "/skills/frontend"

		//#when
		const result = resolveSkillPathReferences(content, basePath)

		//#then
		expect(result).toBe("npx --package=@scope/pkg")
	})
})