import { test } from "node:test"; import assert from "node:assert/strict"; import { existsSync, mkdtempSync, readFileSync, rmSync } from "node:fs"; import { tmpdir } from "node:os"; import { join } from "node:path"; import { SKILL_MARKER_FILE, installSkillToDirectories, readSkillInstallRecord, uninstallSkillFromDirectory, writeSkillTo, } from "../out/agent/skill.js"; test("writeSkillTo creates SKILL.md and avoids project-doc noise", async () => { const dir = mkdtempSync(join(tmpdir(), "ra3-skill-test-")); try { const skillDir = join(dir, "ra3-mod-xml"); await writeSkillTo(skillDir, "0.1.25"); assert.ok(existsSync(join(skillDir, "SKILL.md"))); assert.ok(existsSync(join(skillDir, "references", "query-guide.md"))); assert.ok(existsSync(join(skillDir, SKILL_MARKER_FILE))); const content = readFileSync(join(skillDir, "SKILL.md"), "utf8"); assert.ok(content.includes("find_asset")); assert.ok(!content.includes("codebase-navigation-guide")); } finally { rmSync(dir, { recursive: true, force: true }); } }); test("SKILL.md scopes itself to SAGE/RA3 projects and warns off others", async () => { const dir = mkdtempSync(join(tmpdir(), "ra3-skill-scope-")); try { const skillDir = join(dir, "ra3-mod-xml"); await writeSkillTo(skillDir, "0.1.25"); const content = readFileSync(join(skillDir, "SKILL.md"), "utf8"); // Must state its applicability and list concrete positive signals. assert.match(content, /When this skill applies/); assert.ok(content.includes("Data/Mod.xml")); assert.ok(content.includes("babproj")); assert.ok(content.includes("AssetDeclaration")); // Must give an explicit negative rule and a cheap probe. assert.match(content, /Do \*\*not\*\* use these tools for unrelated repositories/); assert.ok(content.includes("get_status")); assert.ok(content.includes("projectDir")); // The CnC3 red herring is called out explicitly. assert.ok(content.includes("CnC3Types.xsd")); assert.ok(content.includes("C&C3")); // Second-phase capability must be documented. assert.ok(content.includes("get_asset_references")); assert.ok(content.includes("definedIn")); } finally { rmSync(dir, { recursive: true, force: true }); } }); test("SKILL.md explains how to reach the index without MCP", async () => { const dir = mkdtempSync(join(tmpdir(), "ra3-skill-reach-")); try { const skillDir = join(dir, "ra3-mod-xml"); await writeSkillTo(skillDir, "0.1.25"); const content = readFileSync(join(skillDir, "SKILL.md"), "utf8"); assert.match(content, /## Reaching the index/); // The discovery manifest is the stable entry point. assert.ok(content.includes("~/.ra3modxml/index.json")); // The launcher and the bundled CLI are both mentioned. assert.ok(content.includes("ra3-mod-xml-mcp")); assert.ok(content.includes("cli.js")); // The stdio escape hatch must be shown, since it needs no setup at all. assert.ok(content.includes("tools/call")); // It must not pretend configuring a client takes effect immediately. assert.ok(content.includes("new session")); // And it must refuse to invent results. assert.match(content, /Never fabricate index results/); // Instructions must not send it looking for project-specific docs. assert.equal(content.includes("codebase-navigation-guide"), false); } finally { rmSync(dir, { recursive: true, force: true }); } }); test("installSkillToDirectories records managed copies and uninstall removes them", async () => { const home = mkdtempSync(join(tmpdir(), "ra3-skill-home-")); const dir = mkdtempSync(join(tmpdir(), "ra3-skill-target-")); try { const target = join(dir, "ra3-mod-xml"); const succeeded = await installSkillToDirectories([target], "0.1.25", home); assert.deepEqual(succeeded, [target]); const record = await readSkillInstallRecord(home); assert.equal(record.length, 1); assert.equal(record[0].path, target); await uninstallSkillFromDirectory(target, home); assert.equal(existsSync(target), false); assert.equal((await readSkillInstallRecord(home)).length, 0); } finally { rmSync(home, { recursive: true, force: true }); rmSync(dir, { recursive: true, force: true }); } });