@clubmatto/ai-kit 0.0.1

package/dist/tests/content.test.js

@@ -0,0 +1,141 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const path_1 = require("path");
+const content_1 = require("../src/content");
+const template_1 = require("../src/template");
+const fixturesDir = (0, path_1.join)(__dirname, "fixtures");
+const commandsDir = (0, path_1.join)(fixturesDir, "commands");
+const rulesDir = (0, path_1.join)(fixturesDir, "rules");
+const skillsDir = (0, path_1.join)(fixturesDir, "skills");
+const agentsDir = (0, path_1.join)(fixturesDir, "agents");
+(0, vitest_1.describe)("getCommandConfig", () => {
+    (0, vitest_1.it)("parses command files and returns config object", () => {
+        const config = (0, content_1.getCommandConfig)(commandsDir);
+        (0, vitest_1.expect)(config).toHaveProperty("test");
+        (0, vitest_1.expect)(config.test.description).toBe("A test command for testing purposes.");
+        (0, vitest_1.expect)(config.test.template).toContain("This is a test command template.");
+    });
+    (0, vitest_1.it)("includes all command files", () => {
+        const config = (0, content_1.getCommandConfig)(commandsDir);
+        (0, vitest_1.expect)(config).toHaveProperty("test");
+        (0, vitest_1.expect)(config).toHaveProperty("another");
+    });
+    (0, vitest_1.it)("has correct structure for opencode.json command format", () => {
+        const config = (0, content_1.getCommandConfig)(commandsDir);
+        for (const [_, cmd] of Object.entries(config)) {
+            (0, vitest_1.expect)(cmd).toHaveProperty("description");
+            (0, vitest_1.expect)(cmd).toHaveProperty("template");
+            (0, vitest_1.expect)(typeof cmd.description).toBe("string");
+            (0, vitest_1.expect)(typeof cmd.template).toBe("string");
+        }
+    });
+    (0, vitest_1.it)("returns empty object for non-existent directory", () => {
+        const config = (0, content_1.getCommandConfig)("/non/existent/dir");
+        (0, vitest_1.expect)(config).toEqual({});
+    });
+});
+(0, vitest_1.describe)("getContentFiles", () => {
+    (0, vitest_1.it)("returns files from rules and skills directories", () => {
+        const files = (0, content_1.getContentFiles)(rulesDir, skillsDir);
+        const ruleFiles = files.filter((f) => f.type === "rules");
+        const skillFiles = files.filter((f) => f.type === "skills");
+        (0, vitest_1.expect)(ruleFiles.length).toBeGreaterThan(0);
+        (0, vitest_1.expect)(skillFiles.length).toBeGreaterThan(0);
+    });
+    (0, vitest_1.it)("includes nested files recursively", () => {
+        const files = (0, content_1.getContentFiles)(rulesDir, skillsDir);
+        const nestedRule = files.find((f) => f.name === "nested/nested-rule.md" && f.type === "rules");
+        (0, vitest_1.expect)(nestedRule).toBeDefined();
+        (0, vitest_1.expect)(nestedRule?.content).toContain("Nested Rule");
+    });
+    (0, vitest_1.it)("returns correct file structure", () => {
+        const files = (0, content_1.getContentFiles)(rulesDir, skillsDir);
+        for (const file of files) {
+            (0, vitest_1.expect)(file).toHaveProperty("type");
+            (0, vitest_1.expect)(file).toHaveProperty("name");
+            (0, vitest_1.expect)(file).toHaveProperty("content");
+            (0, vitest_1.expect)(["rules", "skills"]).toContain(file.type);
+            (0, vitest_1.expect)(file.name.endsWith(".md")).toBe(true);
+        }
+    });
+    (0, vitest_1.it)("includes skill directory name in file path", () => {
+        const files = (0, content_1.getContentFiles)(rulesDir, skillsDir);
+        const skillFile = files.find((f) => f.type === "skills" && f.name === "test-skill/SKILL.md");
+        (0, vitest_1.expect)(skillFile).toBeDefined();
+        (0, vitest_1.expect)(skillFile?.content).toContain("Test Skill");
+    });
+    (0, vitest_1.it)("includes additional files in skill directories", () => {
+        const files = (0, content_1.getContentFiles)(rulesDir, skillsDir);
+        const detailsFile = files.find((f) => f.type === "skills" && f.name === "test-skill/skill-details.md");
+        (0, vitest_1.expect)(detailsFile).toBeDefined();
+        (0, vitest_1.expect)(detailsFile?.content).toContain("Skill Details");
+    });
+    (0, vitest_1.it)("includes nested references in skill directories", () => {
+        const files = (0, content_1.getContentFiles)(rulesDir, skillsDir);
+        const refFile = files.find((f) => f.type === "skills" && f.name === "test-skill/nested-refs/doc.md");
+        (0, vitest_1.expect)(refFile).toBeDefined();
+    });
+});
+(0, vitest_1.describe)("getRootFiles", () => {
+    (0, vitest_1.it)("returns JSON files from agents directory", () => {
+        const files = (0, content_1.getRootFiles)(agentsDir);
+        (0, vitest_1.expect)(files.length).toBe(2);
+        (0, vitest_1.expect)(files.map((f) => f.name).sort()).toEqual([
+            "another.json",
+            "opencode.json",
+        ]);
+    });
+    (0, vitest_1.it)("returns file content as string", () => {
+        const files = (0, content_1.getRootFiles)(agentsDir);
+        const opencodeFile = files.find((f) => f.name === "opencode.json");
+        (0, vitest_1.expect)(opencodeFile?.content).toContain("test-agent");
+    });
+    (0, vitest_1.it)("returns empty array for non-existent directory", () => {
+        const files = (0, content_1.getRootFiles)("/non/existent/dir");
+        (0, vitest_1.expect)(files).toEqual([]);
+    });
+});
+(0, vitest_1.describe)("getAgentsFile", () => {
+    (0, vitest_1.it)("returns AGENTS.md file content", () => {
+        const file = (0, content_1.getAgentsFile)(agentsDir);
+        (0, vitest_1.expect)(file).not.toBeNull();
+        (0, vitest_1.expect)(file?.name).toBe("AGENTS.md");
+        (0, vitest_1.expect)(file?.content).toContain("AGENTS.md");
+    });
+    (0, vitest_1.it)("returns null when monorepo.md does not exist", () => {
+        const file = (0, content_1.getAgentsFile)(rulesDir);
+        (0, vitest_1.expect)(file).toBeNull();
+    });
+});
+(0, vitest_1.describe)("processTemplate", () => {
+    (0, vitest_1.it)("replaces {{FOOTER}} with full footer text and ISO date", () => {
+        const result = (0, template_1.processTemplate)("{{FOOTER}}");
+        const today = new Date().toISOString().split("T")[0];
+        (0, vitest_1.expect)(result).toBe(`Last updated: ${today}. This file extends the global rules in @AGENTS.md. Always check both files.`);
+    });
+    (0, vitest_1.it)("replaces {{AGENTS_FOOTER}} with agents footer text and ISO date", () => {
+        const result = (0, template_1.processTemplate)("{{AGENTS_FOOTER}}");
+        const today = new Date().toISOString().split("T")[0];
+        (0, vitest_1.expect)(result).toBe(`This file was last updated: ${today}. Always check the \`.ai/rules/\` directory for the most current language-specific guidelines.`);
+    });
+    (0, vitest_1.it)("replaces multiple placeholders in same content", () => {
+        const result = (0, template_1.processTemplate)("{{FOOTER}} and {{AGENTS_FOOTER}}");
+        const today = new Date().toISOString().split("T")[0];
+        (0, vitest_1.expect)(result).toContain(`Last updated: ${today}`);
+        (0, vitest_1.expect)(result).toContain(`This file was last updated: ${today}`);
+    });
+    (0, vitest_1.it)("leaves non-matching content unchanged", () => {
+        const input = "Some {{OTHER}} content {{NOTREAL}}";
+        const result = (0, template_1.processTemplate)(input);
+        (0, vitest_1.expect)(result).toBe(input);
+    });
+    (0, vitest_1.it)("handles empty string", () => {
+        const result = (0, template_1.processTemplate)("");
+        (0, vitest_1.expect)(result).toBe("");
+    });
+    (0, vitest_1.it)("handles content without placeholders", () => {
+        const result = (0, template_1.processTemplate)("No placeholders here");
+        (0, vitest_1.expect)(result).toBe("No placeholders here");
+    });
+});

package/dist/tests/integration/cli.test.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const child_process_1 = require("child_process");
+const path_1 = require("path");
+const utils_1 = require("../utils");
+const projectRoot = (0, path_1.join)(__dirname, "..", "..");
+(0, vitest_1.describe)("CLI integration", () => {
+    let tempDir;
+    (0, vitest_1.beforeEach)(() => {
+        tempDir = (0, utils_1.createTempDir)();
+    });
+    (0, vitest_1.it)("runs as CLI and syncs files", () => {
+        (0, child_process_1.execSync)(`node ${(0, path_1.join)(projectRoot, "dist", "src", "index.js")} sync`, {
+            cwd: tempDir,
+        });
+        (0, vitest_1.expect)((0, utils_1.fileExists)(tempDir, ".agents/.ai-kit")).toBe(true);
+        (0, vitest_1.expect)((0, utils_1.fileExists)(tempDir, ".agents/rules")).toBe(true);
+        (0, vitest_1.expect)((0, utils_1.fileExists)(tempDir, "opencode.json")).toBe(true);
+        (0, vitest_1.expect)((0, utils_1.fileExists)(tempDir, "AGENTS.md")).toBe(true);
+    });
+    (0, vitest_1.it)("creates rules with templated content", () => {
+        (0, child_process_1.execSync)(`node ${(0, path_1.join)(projectRoot, "dist", "src", "index.js")} sync`, {
+            cwd: tempDir,
+        });
+        const ruleContent = (0, utils_1.readFile)(tempDir, ".agents/rules/typescript.md");
+        (0, vitest_1.expect)(ruleContent).toContain("Last updated:");
+        (0, vitest_1.expect)(ruleContent).not.toContain("{{FOOTER}}");
+        (0, vitest_1.expect)(ruleContent).toMatch(/\d{4}-\d{2}-\d{2}/);
+    });
+    (0, vitest_1.it)("injects commands into opencode.json", () => {
+        (0, child_process_1.execSync)(`node ${(0, path_1.join)(projectRoot, "dist", "src", "index.js")} sync`, {
+            cwd: tempDir,
+        });
+        const opencodeJson = JSON.parse((0, utils_1.readFile)(tempDir, "opencode.json"));
+        (0, vitest_1.expect)(opencodeJson).toHaveProperty("command");
+    });
+    (0, vitest_1.it)("skips opencode.json when --skip-opencode is passed", () => {
+        (0, child_process_1.execSync)(`node ${(0, path_1.join)(projectRoot, "dist", "src", "index.js")} sync --skip-opencode`, { cwd: tempDir });
+        (0, vitest_1.expect)((0, utils_1.fileExists)(tempDir, "opencode.json")).toBe(false);
+        (0, vitest_1.expect)((0, utils_1.fileExists)(tempDir, "AGENTS.md")).toBe(true);
+    });
+});

package/dist/tests/output.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.testLog = void 0;
+exports.getLastLog = getLastLog;
+exports.findLogs = findLogs;
+const logs = [];
+exports.testLog = {
+    clear: () => {
+        logs.length = 0;
+    },
+    get: () => [...logs],
+    logo: (version) => {
+        logs.push(["logo", version]);
+    },
+    welcome: () => {
+        logs.push(["welcome", ""]);
+    },
+    section: (msg) => {
+        logs.push(["section", msg]);
+    },
+    success: (msg) => {
+        logs.push(["success", msg]);
+    },
+    final: (msg) => {
+        logs.push(["final", msg]);
+    },
+    summary: (counts) => {
+        logs.push(["summary", JSON.stringify(counts)]);
+    },
+};
+function getLastLog() {
+    return logs[logs.length - 1];
+}
+function findLogs(type) {
+    return logs.filter(([t]) => t === type);
+}

package/dist/tests/reader.test.js

@@ -0,0 +1,141 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const path_1 = require("path");
+const reader_1 = require("../src/reader");
+const template_1 = require("../src/template");
+const fixturesDir = (0, path_1.join)(__dirname, "fixtures");
+const commandsDir = (0, path_1.join)(fixturesDir, "commands");
+const rulesDir = (0, path_1.join)(fixturesDir, "rules");
+const skillsDir = (0, path_1.join)(fixturesDir, "skills");
+const agentsDir = (0, path_1.join)(fixturesDir, "agents");
+(0, vitest_1.describe)("getCommandConfig", () => {
+    (0, vitest_1.it)("parses command files and returns config object", () => {
+        const config = (0, reader_1.getCommandConfig)(commandsDir);
+        (0, vitest_1.expect)(config).toHaveProperty("test");
+        (0, vitest_1.expect)(config.test.description).toBe("A test command for testing purposes.");
+        (0, vitest_1.expect)(config.test.template).toContain("This is a test command template.");
+    });
+    (0, vitest_1.it)("includes all command files", () => {
+        const config = (0, reader_1.getCommandConfig)(commandsDir);
+        (0, vitest_1.expect)(config).toHaveProperty("test");
+        (0, vitest_1.expect)(config).toHaveProperty("another");
+    });
+    (0, vitest_1.it)("has correct structure for opencode.json command format", () => {
+        const config = (0, reader_1.getCommandConfig)(commandsDir);
+        for (const [_, cmd] of Object.entries(config)) {
+            (0, vitest_1.expect)(cmd).toHaveProperty("description");
+            (0, vitest_1.expect)(cmd).toHaveProperty("template");
+            (0, vitest_1.expect)(typeof cmd.description).toBe("string");
+            (0, vitest_1.expect)(typeof cmd.template).toBe("string");
+        }
+    });
+    (0, vitest_1.it)("returns empty object for non-existent directory", () => {
+        const config = (0, reader_1.getCommandConfig)("/non/existent/dir");
+        (0, vitest_1.expect)(config).toEqual({});
+    });
+});
+(0, vitest_1.describe)("readContent", () => {
+    (0, vitest_1.it)("returns files from rules and skills directories", () => {
+        const files = (0, reader_1.readContent)(rulesDir, skillsDir);
+        const ruleFiles = files.filter((f) => f.type === "rules");
+        const skillFiles = files.filter((f) => f.type === "skills");
+        (0, vitest_1.expect)(ruleFiles.length).toBeGreaterThan(0);
+        (0, vitest_1.expect)(skillFiles.length).toBeGreaterThan(0);
+    });
+    (0, vitest_1.it)("includes nested files recursively", () => {
+        const files = (0, reader_1.readContent)(rulesDir, skillsDir);
+        const nestedRule = files.find((f) => f.name === "nested/nested-rule.md" && f.type === "rules");
+        (0, vitest_1.expect)(nestedRule).toBeDefined();
+        (0, vitest_1.expect)(nestedRule?.content).toContain("Nested Rule");
+    });
+    (0, vitest_1.it)("returns correct file structure", () => {
+        const files = (0, reader_1.readContent)(rulesDir, skillsDir);
+        for (const file of files) {
+            (0, vitest_1.expect)(file).toHaveProperty("type");
+            (0, vitest_1.expect)(file).toHaveProperty("name");
+            (0, vitest_1.expect)(file).toHaveProperty("content");
+            (0, vitest_1.expect)(["rules", "skills"]).toContain(file.type);
+            (0, vitest_1.expect)(file.name.endsWith(".md")).toBe(true);
+        }
+    });
+    (0, vitest_1.it)("includes skill directory name in file path", () => {
+        const files = (0, reader_1.readContent)(rulesDir, skillsDir);
+        const skillFile = files.find((f) => f.type === "skills" && f.name === "test-skill/SKILL.md");
+        (0, vitest_1.expect)(skillFile).toBeDefined();
+        (0, vitest_1.expect)(skillFile?.content).toContain("Test Skill");
+    });
+    (0, vitest_1.it)("includes additional files in skill directories", () => {
+        const files = (0, reader_1.readContent)(rulesDir, skillsDir);
+        const detailsFile = files.find((f) => f.type === "skills" && f.name === "test-skill/skill-details.md");
+        (0, vitest_1.expect)(detailsFile).toBeDefined();
+        (0, vitest_1.expect)(detailsFile?.content).toContain("Skill Details");
+    });
+    (0, vitest_1.it)("includes nested references in skill directories", () => {
+        const files = (0, reader_1.readContent)(rulesDir, skillsDir);
+        const refFile = files.find((f) => f.type === "skills" && f.name === "test-skill/nested-refs/doc.md");
+        (0, vitest_1.expect)(refFile).toBeDefined();
+    });
+});
+(0, vitest_1.describe)("readConfigs", () => {
+    (0, vitest_1.it)("returns JSON files from agents directory", () => {
+        const files = (0, reader_1.readConfigs)(agentsDir);
+        (0, vitest_1.expect)(files.length).toBe(2);
+        (0, vitest_1.expect)(files.map((f) => f.name).sort()).toEqual([
+            "another.json",
+            "opencode.json",
+        ]);
+    });
+    (0, vitest_1.it)("returns file content as string", () => {
+        const files = (0, reader_1.readConfigs)(agentsDir);
+        const opencodeFile = files.find((f) => f.name === "opencode.json");
+        (0, vitest_1.expect)(opencodeFile?.content).toContain("test-agent");
+    });
+    (0, vitest_1.it)("returns empty array for non-existent directory", () => {
+        const files = (0, reader_1.readConfigs)("/non/existent/dir");
+        (0, vitest_1.expect)(files).toEqual([]);
+    });
+});
+(0, vitest_1.describe)("readAgents", () => {
+    (0, vitest_1.it)("returns AGENTS.md file content", () => {
+        const file = (0, reader_1.readAgents)(agentsDir);
+        (0, vitest_1.expect)(file).not.toBeNull();
+        (0, vitest_1.expect)(file?.name).toBe("AGENTS.md");
+        (0, vitest_1.expect)(file?.content).toContain("AGENTS.md");
+    });
+    (0, vitest_1.it)("returns null when monorepo.md does not exist", () => {
+        const file = (0, reader_1.readAgents)(rulesDir);
+        (0, vitest_1.expect)(file).toBeNull();
+    });
+});
+(0, vitest_1.describe)("processTemplate", () => {
+    (0, vitest_1.it)("replaces {{FOOTER}} with full footer text and ISO date", () => {
+        const result = (0, template_1.processTemplate)("{{FOOTER}}");
+        const today = new Date().toISOString().split("T")[0];
+        (0, vitest_1.expect)(result).toBe(`Last updated: ${today}. This file extends the global rules in @AGENTS.md. Always check both files.`);
+    });
+    (0, vitest_1.it)("replaces {{AGENTS_FOOTER}} with agents footer text and ISO date", () => {
+        const result = (0, template_1.processTemplate)("{{AGENTS_FOOTER}}");
+        const today = new Date().toISOString().split("T")[0];
+        (0, vitest_1.expect)(result).toBe(`This file was last updated: ${today}. Always check the \`.ai/rules/\` directory for the most current language-specific guidelines.`);
+    });
+    (0, vitest_1.it)("replaces multiple placeholders in same content", () => {
+        const result = (0, template_1.processTemplate)("{{FOOTER}} and {{AGENTS_FOOTER}}");
+        const today = new Date().toISOString().split("T")[0];
+        (0, vitest_1.expect)(result).toContain(`Last updated: ${today}`);
+        (0, vitest_1.expect)(result).toContain(`This file was last updated: ${today}`);
+    });
+    (0, vitest_1.it)("leaves non-matching content unchanged", () => {
+        const input = "Some {{OTHER}} content {{NOTREAL}}";
+        const result = (0, template_1.processTemplate)(input);
+        (0, vitest_1.expect)(result).toBe(input);
+    });
+    (0, vitest_1.it)("handles empty string", () => {
+        const result = (0, template_1.processTemplate)("");
+        (0, vitest_1.expect)(result).toBe("");
+    });
+    (0, vitest_1.it)("handles content without placeholders", () => {
+        const result = (0, template_1.processTemplate)("No placeholders here");
+        (0, vitest_1.expect)(result).toBe("No placeholders here");
+    });
+});

package/dist/tests/sync.test.js

@@ -0,0 +1,90 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const sync_1 = require("../src/cmd/sync");
+const utils_1 = require("./utils");
+const output_1 = require("./output");
+const path_1 = require("path");
+const fixturesDir = (0, path_1.join)(__dirname, "fixtures");
+const testSourceDirs = {
+    rules: (0, path_1.join)(fixturesDir, "rules"),
+    skills: (0, path_1.join)(fixturesDir, "skills"),
+    agents: (0, path_1.join)(fixturesDir, "agents"),
+    commands: (0, path_1.join)(fixturesDir, "commands"),
+};
+(0, vitest_1.describe)("sync command", () => {
+    let tempDir;
+    (0, vitest_1.beforeEach)(() => {
+        tempDir = (0, utils_1.createTempDir)();
+        output_1.testLog.clear();
+    });
+    (0, vitest_1.it)("initializes when not already initialized", async () => {
+        await (0, sync_1.sync)(tempDir, "0.0.1", {}, output_1.testLog, testSourceDirs);
+        (0, vitest_1.expect)((0, utils_1.fileExists)(tempDir, ".agents/.ai-kit")).toBe(true);
+        (0, vitest_1.expect)((0, utils_1.fileExists)(tempDir, ".agents/rules")).toBe(true);
+        (0, vitest_1.expect)((0, utils_1.fileExists)(tempDir, "opencode.json")).toBe(true);
+        (0, vitest_1.expect)((0, utils_1.fileExists)(tempDir, "AGENTS.md")).toBe(true);
+    });
+    (0, vitest_1.it)("skips opencode.json when skipOpencode is true", async () => {
+        await (0, sync_1.sync)(tempDir, "0.0.1", { skipOpencode: true }, output_1.testLog, testSourceDirs);
+        (0, vitest_1.expect)((0, utils_1.fileExists)(tempDir, "opencode.json")).toBe(false);
+        (0, vitest_1.expect)((0, utils_1.fileExists)(tempDir, "AGENTS.md")).toBe(true);
+    });
+    (0, vitest_1.it)("writes correct manifest on init", async () => {
+        await (0, sync_1.sync)(tempDir, "0.0.1", {}, output_1.testLog, testSourceDirs);
+        const manifest = JSON.parse((0, utils_1.readFile)(tempDir, ".agents/.ai-kit"));
+        (0, vitest_1.expect)(manifest.version).toBe("0.0.1");
+        (0, vitest_1.expect)(manifest.rootFiles).toContain("opencode.json");
+    });
+    (0, vitest_1.it)("does not re-initialize if already at latest version", async () => {
+        await (0, sync_1.sync)(tempDir, "0.0.1", {}, output_1.testLog, testSourceDirs);
+        await (0, sync_1.sync)(tempDir, "0.0.1", {}, output_1.testLog, testSourceDirs);
+        const lastLog = (0, output_1.getLastLog)();
+        (0, vitest_1.expect)(lastLog).toEqual(["success", "Already at latest version (0.0.1)"]);
+    });
+    (0, vitest_1.it)("updates when version differs", async () => {
+        await (0, sync_1.sync)(tempDir, "0.0.1", {}, output_1.testLog, testSourceDirs);
+        await (0, sync_1.sync)(tempDir, "0.0.2", {}, output_1.testLog, testSourceDirs);
+        const manifest = JSON.parse((0, utils_1.readFile)(tempDir, ".agents/.ai-kit"));
+        (0, vitest_1.expect)(manifest.version).toBe("0.0.2");
+    });
+    (0, vitest_1.it)("respects skipOpencode option on update", async () => {
+        await (0, sync_1.sync)(tempDir, "0.0.1", { skipOpencode: true }, output_1.testLog, testSourceDirs);
+        await (0, sync_1.sync)(tempDir, "0.0.2", { skipOpencode: true }, output_1.testLog, testSourceDirs);
+        const manifest = JSON.parse((0, utils_1.readFile)(tempDir, ".agents/.ai-kit"));
+        (0, vitest_1.expect)(manifest.rootFiles).toEqual([]);
+    });
+    (0, vitest_1.it)("includes commands in opencode.json", async () => {
+        await (0, sync_1.sync)(tempDir, "0.0.1", {}, output_1.testLog, testSourceDirs);
+        const opencodeJson = JSON.parse((0, utils_1.readFile)(tempDir, "opencode.json"));
+        (0, vitest_1.expect)(opencodeJson).toHaveProperty("command");
+        (0, vitest_1.expect)(opencodeJson.command).toHaveProperty("commit");
+        (0, vitest_1.expect)(opencodeJson.command.commit.description).toBe("Commit the work done in this session with a structured commit message.");
+    });
+    (0, vitest_1.it)("processes template variables in content files", async () => {
+        await (0, sync_1.sync)(tempDir, "0.0.1", {}, output_1.testLog, testSourceDirs);
+        const ruleFiles = (0, utils_1.readFile)(tempDir, ".agents/rules/typescript.md");
+        (0, vitest_1.expect)(ruleFiles).toContain("Last updated:");
+        (0, vitest_1.expect)(ruleFiles).not.toContain("{{FOOTER}}");
+        (0, vitest_1.expect)(ruleFiles).toMatch(/\d{4}-\d{2}-\d{2}/);
+    });
+    (0, vitest_1.it)("processes template variables in AGENTS.md", async () => {
+        await (0, sync_1.sync)(tempDir, "0.0.1", {}, output_1.testLog, testSourceDirs);
+        const agentsMd = (0, utils_1.readFile)(tempDir, "AGENTS.md");
+        (0, vitest_1.expect)(agentsMd).not.toContain("{{AGENTS_FOOTER}}");
+        (0, vitest_1.expect)(agentsMd).toMatch(/\d{4}-\d{2}-\d{2}/);
+    });
+    (0, vitest_1.it)("logs output correctly", async () => {
+        await (0, sync_1.sync)(tempDir, "0.0.1", {}, output_1.testLog, testSourceDirs);
+        const logs = output_1.testLog.get();
+        (0, vitest_1.expect)(logs[logs.length - 1][0]).toBe("summary");
+    });
+    (0, vitest_1.it)("logs all synced files", async () => {
+        await (0, sync_1.sync)(tempDir, "0.0.1", {}, output_1.testLog, testSourceDirs);
+        const successLogs = (0, output_1.findLogs)("success");
+        (0, vitest_1.expect)(successLogs.length).toBeGreaterThan(0);
+        (0, vitest_1.expect)(successLogs.some(([, msg]) => msg.includes(".md"))).toBe(true);
+        (0, vitest_1.expect)(successLogs.some(([, msg]) => msg === "opencode.json")).toBe(true);
+        (0, vitest_1.expect)(successLogs.some(([, msg]) => msg === "AGENTS.md")).toBe(true);
+    });
+});

package/dist/tests/utils.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createTempDir = createTempDir;
+exports.readFile = readFile;
+exports.fileExists = fileExists;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const os_1 = require("os");
+function createTempDir() {
+    return (0, fs_1.mkdtempSync)((0, path_1.join)((0, os_1.tmpdir)(), "ai-kit-test-"));
+}
+function readFile(dir, filename) {
+    const path = (0, path_1.join)(dir, filename);
+    if (!(0, fs_1.existsSync)(path))
+        return null;
+    return (0, fs_1.readFileSync)(path, "utf-8");
+}
+function fileExists(dir, filename) {
+    return (0, fs_1.existsSync)((0, path_1.join)(dir, filename));
+}

package/dist/vitest.config.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const config_1 = require("vitest/config");
+exports.default = (0, config_1.defineConfig)({
+    test: {
+        include: ["tests/**/*.test.ts"],
+        testTimeout: 10000,
+    },
+});

package/docs/roadmap.md

@@ -0,0 +1,16 @@
+# Roadmap
+
+## Near
+
+- Publish to npm
+
+## Soon
+
+- Add --force flag to sync (reimports everything)
+- Safe copy files (check if file exists before writing)
+- AGENTS.md for single repo (non monorepo)
+- Selective sync (choose which commands/rules to install)
+
+## Long-term
+
+- Language detection for lang rules

package/eslint.config.mjs

@@ -0,0 +1,38 @@
+import js from "@eslint/js";
+import tseslint from "typescript-eslint";
+
+export default tseslint.config(
+  { ignores: ["dist", "node_modules", "src/skills/**/scripts"] },
+  js.configs.recommended,
+  ...tseslint.configs.recommended,
+  {
+    files: ["src/**/*.ts"],
+    languageOptions: {
+      parserOptions: {
+        project: "./tsconfig.json",
+      },
+    },
+    rules: {
+      "@typescript-eslint/no-unused-vars": [
+        "error",
+        { argsIgnorePattern: "^_", varsIgnorePattern: "^_" },
+      ],
+      "no-unused-vars": "off",
+    },
+  },
+  {
+    files: ["tests/**/*.ts", "vitest.config.ts"],
+    languageOptions: {
+      parserOptions: {
+        project: "./tsconfig.json",
+      },
+    },
+    rules: {
+      "@typescript-eslint/no-unused-vars": [
+        "error",
+        { argsIgnorePattern: "^_", varsIgnorePattern: "^_" },
+      ],
+      "no-unused-vars": "off",
+    },
+  },
+);

package/package.json

@@ -0,0 +1,78 @@
+{
+  "name": "@clubmatto/ai-kit",
+  "version": "0.0.1",
+  "description": "The AI configuration CLI from Club Matto",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/clubmatto/vetrina.git"
+  },
+  "bugs": {
+    "url": "https://github.com/clubmatto/vetrina/issues"
+  },
+  "homepage": "https://github.com/clubmatto/vetrina#readme",
+  "bin": {
+    "ai-kit": "./dist/src/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "dev:link": "npm run build && npm link",
+    "fetch-playwright-skills": "tsx scripts/fetch-playwright-skills.ts v0.1.1",
+    "release": "release-it",
+    "test": "vitest run --exclude 'tests/integration/**'",
+    "test:integration": "npm run build && vitest run tests/integration",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "prettier:write": "prettier --write .",
+    "prettier:check": "prettier --check .",
+    "format": "prettier --write .",
+    "lint": "eslint . && knip",
+    "ci": "npm run typecheck && npm run lint && npm run test && npm run test:integration"
+  },
+  "dependencies": {
+    "commander": "^14.0.3",
+    "gradient-string": "^3.0.0"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@release-it/keep-a-changelog": "^7.0.1",
+    "@types/node": "^25.3.0",
+    "eslint": "^10.0.1",
+    "knip": "^5.85.0",
+    "prettier": "^3.4.2",
+    "release-it": "^19.2.4",
+    "tsx": "latest",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.56.0",
+    "vitest": "^4.0.18"
+  },
+  "keywords": [
+    "ai",
+    "opencode",
+    "ai-configuration",
+    "club-matto",
+    "prompt-management",
+    "cli"
+  ],
+  "license": "MIT",
+  "release-it": {
+    "npm": {
+      "publish": true
+    },
+    "git": {
+      "commitMessage": "chore: release v${version}",
+      "tagName": "v${version}"
+    },
+    "version": {
+      "bump": false
+    },
+    "plugins": {
+      "@release-it/keep-a-changelog": {}
+    }
+  },
+  "knip": {
+    "ignore": [
+      "src/skills/**/scripts/*.js"
+    ]
+  }
+}