heymark 2.0.1 → 2.1.0

package/src/index.js

@@ -1,52 +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();
+#!/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

@@ -1,77 +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,
-};
+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

@@ -1,87 +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,
-};
+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

@@ -1,14 +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,
-};
+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

@@ -1,79 +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,
-};
+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,
+};