heymark 1.2.0 → 2.0.1

package/src/commands/link/index.js

@@ -0,0 +1,58 @@
+const path = require("path");
+const { writeConfig } = require("@/skill-repo/config-file");
+const { SKILL_REPO_DEFAULT_BRANCH } = require("@/skill-repo/constants");
+const branch = require("@/commands/link/flags/branch");
+const folder = require("@/commands/link/flags/folder");
+
+function parseFlags(flags, handlers) {
+    const result = {};
+    for (let i = 0; i < flags.length; i++) {
+        const flag = flags[i];
+        const handler = handlers.find((h) => h.is(flag));
+        if (handler) {
+            const parsed = handler.parse(flags, i);
+            result[handler.key] = parsed.value;
+            i += parsed.advance;
+            continue;
+        }
+        console.error(`[Error] Unknown flag: ${flag}`);
+        process.exit(1);
+    }
+    return result;
+}
+
+function parseConfig(flags) {
+    const repoUrl = flags[0];
+    if (!repoUrl || repoUrl.startsWith("--")) {
+        console.error(
+            "[Error] Provide a repo URL. Example: heymark link https://github.com/org/repo.git"
+        );
+        process.exit(1);
+    }
+
+    const parsed = parseFlags(flags.slice(1), [branch, folder]);
+
+    return {
+        repoUrl: repoUrl.trim(),
+        branch: parsed.branch || SKILL_REPO_DEFAULT_BRANCH,
+        folder: parsed.folder || "",
+    };
+}
+
+function runLink(flags, context) {
+    const config = parseConfig(flags);
+    const configPath = writeConfig(context.cwd, config);
+
+    console.log(`[Link] Saved to ${path.relative(context.cwd, configPath) || configPath}`);
+    console.log(`  repo: ${config.repoUrl}`);
+    if (config.branch !== SKILL_REPO_DEFAULT_BRANCH) {
+        console.log(`  branch: ${config.branch}`);
+    }
+    if (config.folder) {
+        console.log(`  folder: ${config.folder}`);
+    }
+}
+
+module.exports = {
+    runLink,
+};

package/src/commands/select-tools.js

@@ -0,0 +1,35 @@
+const ALL_TOOLS_TOKEN = ".";
+
+function selectTools(flags, availableTools) {
+    const availableToolKeys = Object.keys(availableTools);
+    if (flags.length === 0) {
+        return availableToolKeys;
+    }
+
+    if (flags.some((tool) => tool.includes(","))) {
+        console.error("[Error] Use spaces between tools, not commas.");
+        process.exit(1);
+    }
+
+    if (flags.includes(ALL_TOOLS_TOKEN)) {
+        if (flags.length > 1) {
+            console.error("[Error] Use '.' alone for all tools.");
+            process.exit(1);
+        }
+        return availableToolKeys;
+    }
+
+    const invalid = flags.filter((tool) => !availableTools[tool]);
+    if (invalid.length > 0) {
+        console.error(
+            `[Error] Unknown: ${invalid.join(", ")}. Available: ${availableToolKeys.join(", ")}`
+        );
+        process.exit(1);
+    }
+
+    return Array.from(new Set(flags));
+}
+
+module.exports = {
+    selectTools,
+};

package/src/commands/sync/index.js

@@ -0,0 +1,35 @@
+const { cleaner } = require("@/commands/cleaner");
+const { selectTools } = require("@/commands/select-tools");
+const { readCache } = require("@/skill-repo/cache-folder");
+const { readConfig } = require("@/skill-repo/config-file");
+const { SKILL_REPO_DEFAULT_BRANCH } = require("@/skill-repo/constants");
+
+function runSync(flags, context) {
+    const selectedTools = selectTools(flags, context.tools);
+    const { skills } = readCache(context.cwd);
+    const config = readConfig(context.cwd);
+
+    console.log("[Sync]");
+    if (config) {
+        console.log(`  repo:   ${config.repoUrl}`);
+        if (config.folder) console.log(`  folder: ${config.folder}`);
+        if (config.branch !== SKILL_REPO_DEFAULT_BRANCH) console.log(`  branch: ${config.branch}`);
+    }
+    console.log("");
+
+    const skillNames = skills.map((s) => s.name);
+    cleaner(context.tools, selectedTools, skillNames, context.cwd);
+
+    for (const toolKey of selectedTools) {
+        const tool = context.tools[toolKey];
+        const count = tool.generate(skills, context.cwd);
+        console.log(`  ${tool.name.padEnd(16)} -> ${tool.output} (${count} skills)`);
+    }
+
+    console.log("");
+    console.log(`[Done] ${selectedTools.length} tools synced.`);
+}
+
+module.exports = {
+    runSync,
+};

package/src/index.js

@@ -0,0 +1,52 @@
+#!/usr/bin/env node
+
+require("./alias.js");
+
+const { COMMAND_LINK, COMMAND_SYNC, COMMAND_CLEAN, COMMAND_HELP } = require("@/commands/constants");
+const { runLink } = require("@/commands/link");
+const { runSync } = require("@/commands/sync");
+const { runClean } = require("@/commands/clean");
+const { runHelp } = require("@/commands/help");
+const { loadTools } = require("@/tools/loader");
+
+function main() {
+    const context = {
+        cwd: process.cwd(),
+        tools: loadTools(),
+    };
+
+    const args = process.argv.slice(2);
+
+    if (args.length === 0) {
+        runHelp([], context);
+        return;
+    }
+
+    const command = args[0];
+    const flags = args.slice(1);
+
+    if (command === COMMAND_LINK) {
+        runLink(flags, context);
+        return;
+    }
+
+    if (command === COMMAND_SYNC) {
+        runSync(flags, context);
+        return;
+    }
+
+    if (command === COMMAND_CLEAN) {
+        runClean(flags, context);
+        return;
+    }
+
+    if (command === COMMAND_HELP) {
+        runHelp(flags, context);
+        return;
+    }
+
+    console.error(`[Error] Unknown command: ${command}. Run: heymark help`);
+    process.exit(1);
+}
+
+main();

package/src/skill-repo/cache-folder.js

@@ -0,0 +1,77 @@
+const fs = require("fs");
+const path = require("path");
+const { execSync } = require("child_process");
+const { HEYMARK, SKILL_REPO_DEFAULT_BRANCH } = require("@/skill-repo/constants");
+const { readConfig } = require("@/skill-repo/config-file");
+const { readSkillFiles } = require("@/skill-repo/skill-file-parser");
+
+function getCloneFolderPath(cwd, repoUrl) {
+    const name = repoUrl.trim().split("/").pop() || "repo";
+    const dirName = name.endsWith(".git") ? name.slice(0, -4) : name;
+    return path.join(cwd, HEYMARK.DIR, HEYMARK.CACHE_DIR, dirName);
+}
+
+function gitClone(cwd, dir, branch, repoUrl) {
+    execSync(`git clone --depth 1 --branch "${branch}" "${repoUrl}" "${dir}"`, {
+        stdio: "inherit",
+        cwd,
+    });
+}
+
+function gitPull(dir, branch) {
+    execSync(`git fetch origin && git checkout --quiet . && git pull --quiet origin "${branch}"`, {
+        stdio: "pipe",
+        cwd: dir,
+    });
+}
+
+function writeCache(cwd) {
+    const config = readConfig(cwd);
+    if (!config) {
+        console.error(
+            `[Error] Not linked. Run: heymark link <repo-url> (config: ${HEYMARK.DIR}/${HEYMARK.CONFIG_FILE})`
+        );
+        process.exit(1);
+    }
+
+    const branch = config.branch || SKILL_REPO_DEFAULT_BRANCH;
+    const cacheBase = path.join(cwd, HEYMARK.DIR, HEYMARK.CACHE_DIR);
+    const cloneFolderPath = getCloneFolderPath(cwd, config.repoUrl);
+
+    if (!fs.existsSync(cloneFolderPath)) {
+        fs.mkdirSync(cacheBase, { recursive: true });
+        try {
+            gitClone(cwd, cloneFolderPath, branch, config.repoUrl);
+        } catch {
+            console.error("[Error] Clone failed. Check repo access (SSH or token).");
+            process.exit(1);
+        }
+    } else {
+        try {
+            gitPull(cloneFolderPath, branch);
+        } catch {
+            // Continue with cached clone when fetch/pull fails.
+        }
+    }
+
+    return { config, cloneFolderPath };
+}
+
+function readCache(cwd) {
+    const { config, cloneFolderPath } = writeCache(cwd);
+
+    const folder = config.folder || "";
+    const skillsFolderPath = folder ? path.join(cloneFolderPath, folder) : cloneFolderPath;
+    if (!fs.existsSync(skillsFolderPath) || !fs.statSync(skillsFolderPath).isDirectory()) {
+        console.error(`[Error] Folder not found in repo: ${folder || "(root)"}`);
+        process.exit(1);
+    }
+
+    const skills = readSkillFiles(skillsFolderPath);
+
+    return { config, skillsFolderPath, skills };
+}
+
+module.exports = {
+    readCache,
+};

package/src/skill-repo/config-file.js

@@ -0,0 +1,87 @@
+const fs = require("fs");
+const path = require("path");
+const { HEYMARK, SKILL_REPO_DEFAULT_BRANCH } = require("@/skill-repo/constants");
+
+function getConfigFilePath(cwd) {
+    return path.join(cwd, HEYMARK.DIR, HEYMARK.CONFIG_FILE);
+}
+
+function parseRawConfig(rawConfig) {
+    if (!rawConfig || typeof rawConfig !== "object") {
+        return null;
+    }
+
+    const raw = rawConfig;
+
+    const repoUrl =
+        typeof raw.repoUrl === "string" && raw.repoUrl.trim()
+            ? raw.repoUrl.trim()
+            : typeof raw.skillSource === "string" && raw.skillSource.trim()
+              ? raw.skillSource.trim()
+              : typeof raw.rulesSource === "string" && raw.rulesSource.trim()
+                ? raw.rulesSource.trim()
+                : "";
+
+    if (!repoUrl) {
+        return null;
+    }
+
+    const branch =
+        typeof raw.branch === "string" && raw.branch.trim()
+            ? raw.branch.trim()
+            : SKILL_REPO_DEFAULT_BRANCH;
+
+    const folder =
+        typeof raw.folder === "string"
+            ? raw.folder.trim()
+            : typeof raw.skillSourceDir === "string"
+              ? raw.skillSourceDir.trim()
+              : typeof raw.rulesSourceDir === "string"
+                ? raw.rulesSourceDir.trim()
+                : "";
+
+    return { repoUrl, branch, folder };
+}
+
+function writeConfig(cwd, config) {
+    const dir = path.join(cwd, HEYMARK.DIR);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+
+    const data = parseRawConfig(config);
+    if (!data) {
+        throw new Error("Invalid config");
+    }
+
+    const filePath = getConfigFilePath(cwd);
+    const payload = {
+        repoUrl: data.repoUrl,
+        branch: data.branch || SKILL_REPO_DEFAULT_BRANCH,
+    };
+    if (data.folder) {
+        payload.folder = data.folder;
+    }
+
+    fs.writeFileSync(filePath, JSON.stringify(payload, null, 2), "utf8");
+    return filePath;
+}
+
+function readConfig(cwd) {
+    const filePath = getConfigFilePath(cwd);
+    if (!fs.existsSync(filePath)) {
+        return null;
+    }
+
+    try {
+        const raw = fs.readFileSync(filePath, "utf8");
+        return parseRawConfig(JSON.parse(raw));
+    } catch {
+        return null;
+    }
+}
+
+module.exports = {
+    writeConfig,
+    readConfig,
+};

package/src/skill-repo/constants.js

@@ -0,0 +1,14 @@
+const HEYMARK = {
+    DIR: ".heymark",
+    CONFIG_FILE: "config.json",
+    CACHE_DIR: "cache",
+};
+
+const SKILL_FILE_EXTENSION = ".md";
+const SKILL_REPO_DEFAULT_BRANCH = "main";
+
+module.exports = {
+    HEYMARK,
+    SKILL_FILE_EXTENSION,
+    SKILL_REPO_DEFAULT_BRANCH,
+};

package/src/skill-repo/skill-file-parser.js

@@ -0,0 +1,79 @@
+const fs = require("fs");
+const path = require("path");
+const { SKILL_FILE_EXTENSION } = require("@/skill-repo/constants");
+
+const FRONTMATTER_REGEX = /^---\r?\n([\s\S]+?)\r?\n---\r?\n?([\s\S]*)$/;
+
+function parseFrontmatter(content) {
+    const match = content.match(FRONTMATTER_REGEX);
+    if (!match) {
+        return { metadata: {}, body: content.trim() };
+    }
+
+    const [, metadataBlock, body] = match;
+
+    const metadata = {};
+    metadataBlock.split(/\r?\n/).forEach((line) => {
+        const separatorIndex = line.indexOf(":");
+        if (separatorIndex === -1) return;
+
+        const key = line.slice(0, separatorIndex).trim();
+        let value = line.slice(separatorIndex + 1).trim();
+
+        if (
+            (value.startsWith('"') && value.endsWith('"')) ||
+            (value.startsWith("'") && value.endsWith("'"))
+        ) {
+            value = value.slice(1, -1);
+        }
+
+        if (value === "true") metadata[key] = true;
+        else if (value === "false") metadata[key] = false;
+        else metadata[key] = value;
+    });
+
+    return { metadata, body: body.trim() };
+}
+
+function readSkillFile(skillsDir, fileName) {
+    const filePath = path.join(skillsDir, fileName);
+    const raw = fs.readFileSync(filePath, "utf8");
+    const { metadata, body } = parseFrontmatter(raw);
+    const baseName = path.basename(fileName, SKILL_FILE_EXTENSION);
+
+    return {
+        fileName,
+        name: typeof metadata.name === "string" && metadata.name ? metadata.name : baseName,
+        description:
+            typeof metadata.description === "string" && metadata.description
+                ? metadata.description
+                : baseName,
+        globs: typeof metadata.globs === "string" ? metadata.globs : "",
+        alwaysApply: metadata.alwaysApply === true,
+        metadata,
+        body,
+    };
+}
+
+function readSkillFiles(skillsDir) {
+    if (!fs.existsSync(skillsDir)) {
+        console.error(`[Error] Skills folder not found: ${skillsDir}`);
+        process.exit(1);
+    }
+
+    const files = fs
+        .readdirSync(skillsDir)
+        .filter((fileName) => fileName.endsWith(SKILL_FILE_EXTENSION))
+        .sort();
+
+    if (files.length === 0) {
+        console.error(`[Error] No .md files in: ${skillsDir}`);
+        process.exit(1);
+    }
+
+    return files.map((fileName) => readSkillFile(skillsDir, fileName));
+}
+
+module.exports = {
+    readSkillFiles,
+};

package/src/tools/antigravity/index.js

@@ -0,0 +1,33 @@
+const { ANTIGRAVITY } = require("@/tools/constants");
+const { generate, clean } = require("@/tools/skill-per-folder");
+
+function createContent(skill) {
+    const frontmatterLines = [
+        "---",
+        `name: ${skill.name}`,
+        `description: "${skill.description}"`,
+        "---",
+    ];
+
+    return `${frontmatterLines.join("\n")}\n\n${skill.body}\n`;
+}
+
+module.exports = {
+    key: ANTIGRAVITY.KEY,
+    name: ANTIGRAVITY.NAME,
+    output: ANTIGRAVITY.OUTPUT_PATTERN,
+
+    generate(skills, cwd) {
+        return generate({
+            cwd,
+            dir: ANTIGRAVITY.SKILLS_DIR,
+            fileName: ANTIGRAVITY.SKILL_FILE_NAME,
+            skills,
+            createContent,
+        });
+    },
+
+    clean(skillNames, cwd) {
+        return clean(cwd, ANTIGRAVITY.SKILLS_DIR);
+    },
+};

package/src/tools/claude-code/index.js

@@ -0,0 +1,33 @@
+const { CLAUDE_CODE } = require("@/tools/constants");
+const { generate, clean } = require("@/tools/skill-per-folder");
+
+function createContent(skill) {
+    const frontmatterLines = [
+        "---",
+        `name: ${skill.name}`,
+        `description: "${skill.description}"`,
+        "---",
+    ];
+
+    return `${frontmatterLines.join("\n")}\n\n${skill.body}\n`;
+}
+
+module.exports = {
+    key: CLAUDE_CODE.KEY,
+    name: CLAUDE_CODE.NAME,
+    output: CLAUDE_CODE.OUTPUT_PATTERN,
+
+    generate(skills, cwd) {
+        return generate({
+            cwd,
+            dir: CLAUDE_CODE.SKILLS_DIR,
+            fileName: CLAUDE_CODE.SKILL_FILE_NAME,
+            skills,
+            createContent,
+        });
+    },
+
+    clean(skillNames, cwd) {
+        return clean(cwd, CLAUDE_CODE.SKILLS_DIR);
+    },
+};

package/src/tools/codex/index.js

@@ -0,0 +1,33 @@
+const { CODEX } = require("@/tools/constants");
+const { generate, clean } = require("@/tools/skill-per-folder");
+
+function createContent(skill) {
+    const frontmatterLines = [
+        "---",
+        `name: ${skill.name}`,
+        `description: "${skill.description}"`,
+        "---",
+    ];
+
+    return `${frontmatterLines.join("\n")}\n\n${skill.body}\n`;
+}
+
+module.exports = {
+    key: CODEX.KEY,
+    name: CODEX.NAME,
+    output: CODEX.OUTPUT_PATTERN,
+
+    generate(skills, cwd) {
+        return generate({
+            cwd,
+            dir: CODEX.SKILLS_DIR,
+            fileName: CODEX.SKILL_FILE_NAME,
+            skills,
+            createContent,
+        });
+    },
+
+    clean(skillNames, cwd) {
+        return clean(cwd, CODEX.SKILLS_DIR);
+    },
+};

package/src/tools/constants.js

@@ -0,0 +1,44 @@
+const path = require("path");
+
+const ANTIGRAVITY = {
+    KEY: "antigravity",
+    NAME: "Antigravity",
+    SKILLS_DIR: path.join(".agent", "skills"),
+    SKILL_FILE_NAME: "SKILL.md",
+    OUTPUT_PATTERN: ".agent/skills/*/SKILL.md",
+};
+
+const CLAUDE_CODE = {
+    KEY: "claude-code",
+    NAME: "Claude Code",
+    SKILLS_DIR: path.join(".claude", "skills"),
+    SKILL_FILE_NAME: "SKILL.md",
+    OUTPUT_PATTERN: ".claude/skills/*/SKILL.md",
+};
+
+const CODEX = {
+    KEY: "codex",
+    NAME: "Codex",
+    SKILLS_DIR: path.join(".agents", "skills"),
+    SKILL_FILE_NAME: "SKILL.md",
+    OUTPUT_PATTERN: ".agents/skills/*/SKILL.md",
+};
+
+const COPILOT = {
+    KEY: "copilot",
+    NAME: "Copilot",
+    INSTRUCTIONS_DIR: path.join(".github", "instructions"),
+    FILE_SUFFIX: ".instructions.md",
+    DEFAULT_GLOB: "**",
+    OUTPUT_PATTERN: ".github/instructions/*.instructions.md",
+};
+
+const CURSOR = {
+    KEY: "cursor",
+    NAME: "Cursor",
+    SKILLS_DIR: path.join(".cursor", "rules"),
+    FILE_SUFFIX: ".mdc",
+    OUTPUT_PATTERN: ".cursor/rules/*.mdc",
+};
+
+module.exports = { ANTIGRAVITY, CLAUDE_CODE, CODEX, COPILOT, CURSOR };

package/src/tools/copilot/index.js

@@ -0,0 +1,40 @@
+const { COPILOT } = require("@/tools/constants");
+const { generate, clean } = require("@/tools/skill-per-file");
+
+function getFileName(skill) {
+    return `${skill.name}${COPILOT.FILE_SUFFIX}`;
+}
+
+function createContent(skill) {
+    const globs = skill.globs
+        ? skill.globs
+              .split(",")
+              .map((g) => g.trim())
+              .filter(Boolean)
+        : [];
+    const applyToLines = (globs.length > 0 ? globs : [COPILOT.DEFAULT_GLOB])
+        .map((glob) => `  - "${glob}"`)
+        .join("\n");
+    const header = `applyTo:\n${applyToLines}\n---`;
+    return `${header}\n\n${skill.body}\n`;
+}
+
+module.exports = {
+    key: COPILOT.KEY,
+    name: COPILOT.NAME,
+    output: COPILOT.OUTPUT_PATTERN,
+
+    generate(skills, cwd) {
+        return generate({
+            cwd,
+            dir: COPILOT.INSTRUCTIONS_DIR,
+            skills,
+            getFileName,
+            createContent,
+        });
+    },
+
+    clean(skillNames, cwd) {
+        return clean(cwd, COPILOT.INSTRUCTIONS_DIR);
+    },
+};

package/src/tools/cursor/index.js

@@ -0,0 +1,39 @@
+const { CURSOR } = require("@/tools/constants");
+const { generate, clean } = require("@/tools/skill-per-file");
+
+function getFileName(skill) {
+    return `${skill.name}${CURSOR.FILE_SUFFIX}`;
+}
+
+function createContent(skill) {
+    const frontmatterLines = ["---", `description: "${skill.description}"`];
+
+    if (skill.globs) {
+        frontmatterLines.push(`globs: "${skill.globs}"`);
+    }
+
+    frontmatterLines.push(`alwaysApply: ${skill.alwaysApply}`);
+    frontmatterLines.push("---");
+
+    return `${frontmatterLines.join("\n")}\n\n${skill.body}\n`;
+}
+
+module.exports = {
+    key: CURSOR.KEY,
+    name: CURSOR.NAME,
+    output: CURSOR.OUTPUT_PATTERN,
+
+    generate(skills, cwd) {
+        return generate({
+            cwd,
+            dir: CURSOR.SKILLS_DIR,
+            skills,
+            getFileName,
+            createContent,
+        });
+    },
+
+    clean(skillNames, cwd) {
+        return clean(cwd, CURSOR.SKILLS_DIR);
+    },
+};

package/src/tools/loader.js

@@ -0,0 +1,17 @@
+const fs = require("fs");
+const path = require("path");
+
+const TOOLS_DIR = path.join(__dirname);
+
+function loadTools() {
+    const tools = fs
+        .readdirSync(TOOLS_DIR)
+        .filter((name) => fs.statSync(path.join(TOOLS_DIR, name)).isDirectory())
+        .map((name) => require(path.join(TOOLS_DIR, name)));
+
+    return Object.fromEntries(tools.map((tool) => [tool.key, tool]));
+}
+
+module.exports = {
+    loadTools,
+};