@comet/cli 9.0.0-beta.3 → 9.0.0-beta.5

package/lib/comet.js

@@ -4,12 +4,12 @@ var commander_1 = require("commander");
 var download_mitmproxy_1 = require("./commands/download-mitmproxy");
 var download_oauth2_proxy_1 = require("./commands/download-oauth2-proxy");
 var generate_block_types_1 = require("./commands/generate-block-types");
-var install_agent_skills_1 = require("./commands/install-agent-skills");
+var install_agent_features_1 = require("./commands/install-agent-features");
 var site_configs_1 = require("./commands/site-configs");
 var program = new commander_1.Command();
 program.addCommand(generate_block_types_1.generateBlockTypes);
 program.addCommand(site_configs_1.injectSiteConfigsCommand);
 program.addCommand(download_oauth2_proxy_1.downloadOAuth2ProxyCommand);
 program.addCommand(download_mitmproxy_1.downloadMitmproxyCommand);
-program.addCommand(install_agent_skills_1.installAgentSkillsCommand);
+program.addCommand(install_agent_features_1.installAgentFeaturesCommand);
 program.parse();

package/lib/commands/install-agent-features.d.ts

@@ -0,0 +1,7 @@
+import { Command } from "commander";
+interface InstallOptions {
+    dryRun: boolean;
+}
+export declare function installFeatures(cwd: string, repos: string[], options: InstallOptions): void;
+export declare const installAgentFeaturesCommand: Command;
+export {};

package/lib/commands/install-agent-features.js

@@ -0,0 +1,434 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
+    return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
+    if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
+        if (ar || !(i in from)) {
+            if (!ar) ar = Array.prototype.slice.call(from, 0, i);
+            ar[i] = from[i];
+        }
+    }
+    return to.concat(ar || Array.prototype.slice.call(from));
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.installAgentFeaturesCommand = void 0;
+exports.installFeatures = installFeatures;
+/* eslint-disable no-console */
+var child_process_1 = require("child_process");
+var commander_1 = require("commander");
+var fs = __importStar(require("fs"));
+var yaml = __importStar(require("js-yaml"));
+var os = __importStar(require("os"));
+var path = __importStar(require("path"));
+var SKILL_SOURCE_PATHS = ["skills", "agentic-plugin/skills"];
+var RULE_SOURCE_PATHS = ["rules"];
+function discoverNodeModulesPackages(cwd) {
+    var nodeModulesDir = path.join(cwd, "node_modules");
+    if (!fs.existsSync(nodeModulesDir)) {
+        return [];
+    }
+    var packageDirs = [];
+    var entries;
+    try {
+        entries = fs.readdirSync(nodeModulesDir);
+    }
+    catch (_a) {
+        return [];
+    }
+    for (var _i = 0, entries_1 = entries; _i < entries_1.length; _i++) {
+        var entry = entries_1[_i];
+        if (entry.startsWith(".")) {
+            continue;
+        }
+        var fullPath = path.join(nodeModulesDir, entry);
+        if (entry.startsWith("@")) {
+            // Scoped package: read one level deeper
+            var scopedEntries = void 0;
+            try {
+                scopedEntries = fs.readdirSync(fullPath);
+            }
+            catch (_b) {
+                continue;
+            }
+            for (var _c = 0, scopedEntries_1 = scopedEntries; _c < scopedEntries_1.length; _c++) {
+                var scopedEntry = scopedEntries_1[_c];
+                if (scopedEntry.startsWith(".")) {
+                    continue;
+                }
+                var scopedPath = path.join(fullPath, scopedEntry);
+                try {
+                    if (fs.statSync(scopedPath).isDirectory()) {
+                        packageDirs.push(scopedPath);
+                    }
+                }
+                catch (_d) {
+                    // skip unreadable entries
+                }
+            }
+        }
+        else {
+            try {
+                if (fs.statSync(fullPath).isDirectory()) {
+                    packageDirs.push(fullPath);
+                }
+            }
+            catch (_e) {
+                // skip unreadable entries
+            }
+        }
+    }
+    return packageDirs;
+}
+function parseRepoUrl(rawUrl) {
+    var hashIndex = rawUrl.lastIndexOf("#");
+    if (hashIndex === -1) {
+        return { repoUrl: rawUrl, ref: undefined };
+    }
+    return { repoUrl: rawUrl.slice(0, hashIndex), ref: rawUrl.slice(hashIndex + 1) || undefined };
+}
+function cloneRepo(rawUrl, sparsePatterns) {
+    var _a = parseRepoUrl(rawUrl), repoUrl = _a.repoUrl, ref = _a.ref;
+    var tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "comet-agent-install-"));
+    (0, child_process_1.execFileSync)("git", ["init", tmpDir], { stdio: "pipe" });
+    (0, child_process_1.execFileSync)("git", ["-C", tmpDir, "remote", "add", "origin", "--", repoUrl], { stdio: "pipe" });
+    (0, child_process_1.execFileSync)("git", ["-C", tmpDir, "config", "core.sparseCheckout", "true"], { stdio: "pipe" });
+    fs.writeFileSync(path.join(tmpDir, ".git", "info", "sparse-checkout"), sparsePatterns.map(function (p) { return "".concat(p, "\n"); }).join(""));
+    var fetchRef = ref !== null && ref !== void 0 ? ref : "HEAD";
+    try {
+        console.log("Fetching ".concat(repoUrl, " ref \"").concat(fetchRef, "\" (sparse: ").concat(sparsePatterns.join(", "), ")..."));
+        (0, child_process_1.execFileSync)("git", ["-C", tmpDir, "fetch", "--depth", "1", "origin", fetchRef], { stdio: "pipe" });
+        (0, child_process_1.execFileSync)("git", ["-C", tmpDir, "checkout", "FETCH_HEAD"], { stdio: "pipe" });
+    }
+    catch (_b) {
+        console.log("Shallow fetch failed for ref \"".concat(fetchRef, "\"; falling back to full fetch..."));
+        (0, child_process_1.execFileSync)("git", ["-C", tmpDir, "fetch", "origin", fetchRef], { stdio: "pipe" });
+        (0, child_process_1.execFileSync)("git", ["-C", tmpDir, "checkout", "FETCH_HEAD"], { stdio: "pipe" });
+    }
+    return tmpDir;
+}
+function pathExists(p) {
+    try {
+        fs.lstatSync(p);
+        return true;
+    }
+    catch (_a) {
+        return false;
+    }
+}
+function isInternalMarkdown(mdPath) {
+    var _a;
+    var content;
+    try {
+        content = fs.readFileSync(mdPath, "utf-8");
+    }
+    catch (_b) {
+        return false;
+    }
+    var match = content.match(/^---\n([\s\S]*?)\n---/);
+    if (!match) {
+        return false;
+    }
+    try {
+        var parsed = yaml.load(match[1]);
+        return ((_a = parsed === null || parsed === void 0 ? void 0 : parsed.metadata) === null || _a === void 0 ? void 0 : _a.internal) === true;
+    }
+    catch (_c) {
+        return false;
+    }
+}
+function listFolders(directory, filterInternal) {
+    return fs
+        .readdirSync(directory)
+        .filter(function (entry) { return fs.statSync(path.join(directory, entry)).isDirectory(); })
+        .filter(function (folder) { return !filterInternal || !isInternalMarkdown(path.join(directory, folder, "SKILL.md")); })
+        .sort();
+}
+function listMarkdownFiles(directory, filterInternal) {
+    var results = [];
+    var walk = function (currentDir, relativePath) {
+        for (var _i = 0, _a = fs.readdirSync(currentDir); _i < _a.length; _i++) {
+            var entry = _a[_i];
+            var fullPath = path.join(currentDir, entry);
+            var relPath = relativePath ? path.join(relativePath, entry) : entry;
+            var stat = fs.statSync(fullPath);
+            if (stat.isDirectory()) {
+                walk(fullPath, relPath);
+            }
+            else if (stat.isFile() && entry.endsWith(".md")) {
+                if (!filterInternal || !isInternalMarkdown(fullPath)) {
+                    results.push(relPath);
+                }
+            }
+        }
+    };
+    walk(directory, "");
+    return results.sort();
+}
+function symlinkOrCopy(src, dest, symlink) {
+    if (symlink) {
+        try {
+            fs.symlinkSync(src, dest);
+            return "symlinked";
+        }
+        catch (err) {
+            if (err.code !== "EPERM") {
+                throw err;
+            }
+            // Windows without symlink privilege — fall back to copy
+        }
+    }
+    fs.cpSync(src, dest, { recursive: true });
+    return "copied";
+}
+function installItems(sources, targetDirs, _a) {
+    var dryRun = _a.dryRun;
+    var totalInstalled = 0;
+    for (var _i = 0, sources_1 = sources; _i < sources_1.length; _i++) {
+        var source = sources_1[_i];
+        var label = source.label, directory = source.directory, discover = source.discover, symlink = source.symlink, filterInternal = source.filterInternal, installed = source.installed, itemLabelSingular = source.itemLabelSingular, itemLabelPlural = source.itemLabelPlural;
+        if (!fs.existsSync(directory)) {
+            console.log("No ".concat(itemLabelPlural, " found in ").concat(label));
+            continue;
+        }
+        var items = discover === "folders" ? listFolders(directory, filterInternal !== null && filterInternal !== void 0 ? filterInternal : false) : listMarkdownFiles(directory, filterInternal !== null && filterInternal !== void 0 ? filterInternal : false);
+        if (items.length === 0) {
+            console.log("No ".concat(itemLabelPlural, " found in ").concat(label));
+            continue;
+        }
+        console.log("Installing ".concat(items.length, " ").concat(items.length === 1 ? itemLabelSingular : itemLabelPlural, " from ").concat(label, "..."));
+        for (var _b = 0, items_1 = items; _b < items_1.length; _b++) {
+            var item = items_1[_b];
+            if (installed.has(item)) {
+                console.warn("  CONFLICT: \"".concat(item, "\" from ").concat(label, " skipped (already installed from a higher-priority source)"));
+                continue;
+            }
+            var srcPath = path.resolve(path.join(directory, item));
+            for (var _c = 0, targetDirs_1 = targetDirs; _c < targetDirs_1.length; _c++) {
+                var targetDir = targetDirs_1[_c];
+                var destPath = path.join(targetDir, item);
+                if (dryRun) {
+                    console.log("  [dry-run] Would ".concat(symlink ? "symlink" : "copy", ": ").concat(srcPath, " -> ").concat(destPath));
+                }
+                else {
+                    if (pathExists(destPath)) {
+                        fs.rmSync(destPath, { recursive: true, force: true });
+                    }
+                    fs.mkdirSync(path.dirname(destPath), { recursive: true });
+                    var action = symlinkOrCopy(srcPath, destPath, symlink);
+                    console.log("  ".concat(action === "symlinked" ? "Symlinked" : "Copied", ": ").concat(item));
+                }
+            }
+            installed.add(item);
+            totalInstalled++;
+        }
+    }
+    return totalInstalled;
+}
+function loadConfig(configPath) {
+    var resolved = path.resolve(configPath);
+    if (!fs.existsSync(resolved)) {
+        throw new Error("Config file not found: ".concat(resolved));
+    }
+    var raw = fs.readFileSync(resolved, "utf-8");
+    return JSON.parse(raw);
+}
+function installFeatures(cwd, repos, options) {
+    var skillsTargetDirs = [path.join(cwd, ".agents", "skills"), path.join(cwd, ".claude", "skills")];
+    var rulesTargetDirs = [
+        path.join(cwd, ".agents", "rules"),
+        path.join(cwd, ".claude", "rules"),
+        path.join(cwd, ".cursor", "rules"),
+        path.join(cwd, ".github", "instructions"),
+    ];
+    for (var _i = 0, _a = __spreadArray(__spreadArray([], skillsTargetDirs, true), rulesTargetDirs, true); _i < _a.length; _i++) {
+        var dir = _a[_i];
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    var installedSkills = new Set();
+    var installedRules = new Set();
+    var skillSources = SKILL_SOURCE_PATHS.map(function (p) { return ({
+        label: "local ".concat(p, "/"),
+        directory: path.join(cwd, p),
+        discover: "folders",
+        symlink: true,
+        installed: installedSkills,
+        itemLabelSingular: "skill",
+        itemLabelPlural: "skills",
+    }); });
+    var ruleSources = RULE_SOURCE_PATHS.map(function (p) { return ({
+        label: "local ".concat(p, "/"),
+        directory: path.join(cwd, p),
+        discover: "files",
+        symlink: true,
+        installed: installedRules,
+        itemLabelSingular: "rule",
+        itemLabelPlural: "rules",
+    }); });
+    // Discover skills/rules from node_modules (direct dependencies only, including @scoped packages)
+    var nodeModulesPackages = discoverNodeModulesPackages(cwd);
+    for (var _b = 0, nodeModulesPackages_1 = nodeModulesPackages; _b < nodeModulesPackages_1.length; _b++) {
+        var pkgDir = nodeModulesPackages_1[_b];
+        var pkgName = pkgDir.includes("".concat(path.sep, "@")) ? pkgDir.split(path.sep).slice(-2).join("/") : path.basename(pkgDir);
+        for (var _c = 0, SKILL_SOURCE_PATHS_1 = SKILL_SOURCE_PATHS; _c < SKILL_SOURCE_PATHS_1.length; _c++) {
+            var p = SKILL_SOURCE_PATHS_1[_c];
+            var dir = path.join(pkgDir, p);
+            if (fs.existsSync(dir)) {
+                skillSources.push({
+                    label: "node_modules ".concat(pkgName, " (").concat(p, "/)"),
+                    directory: dir,
+                    discover: "folders",
+                    symlink: true,
+                    filterInternal: true,
+                    installed: installedSkills,
+                    itemLabelSingular: "skill",
+                    itemLabelPlural: "skills",
+                });
+            }
+        }
+        for (var _d = 0, RULE_SOURCE_PATHS_1 = RULE_SOURCE_PATHS; _d < RULE_SOURCE_PATHS_1.length; _d++) {
+            var p = RULE_SOURCE_PATHS_1[_d];
+            var dir = path.join(pkgDir, p);
+            if (fs.existsSync(dir)) {
+                ruleSources.push({
+                    label: "node_modules ".concat(pkgName, " (").concat(p, "/)"),
+                    directory: dir,
+                    discover: "files",
+                    symlink: true,
+                    filterInternal: true,
+                    installed: installedRules,
+                    itemLabelSingular: "rule",
+                    itemLabelPlural: "rules",
+                });
+            }
+        }
+    }
+    var sparsePatterns = __spreadArray(__spreadArray([], SKILL_SOURCE_PATHS, true), RULE_SOURCE_PATHS, true).map(function (p) { return "".concat(p, "/"); });
+    var tempDirs = [];
+    try {
+        for (var _e = 0, repos_1 = repos; _e < repos_1.length; _e++) {
+            var rawUrl = repos_1[_e];
+            var cloneDir = cloneRepo(rawUrl, sparsePatterns);
+            tempDirs.push(cloneDir);
+            for (var _f = 0, SKILL_SOURCE_PATHS_2 = SKILL_SOURCE_PATHS; _f < SKILL_SOURCE_PATHS_2.length; _f++) {
+                var p = SKILL_SOURCE_PATHS_2[_f];
+                skillSources.push({
+                    label: "external ".concat(rawUrl, " (").concat(p, "/)"),
+                    directory: path.join(cloneDir, p),
+                    discover: "folders",
+                    symlink: false,
+                    filterInternal: true,
+                    installed: installedSkills,
+                    itemLabelSingular: "skill",
+                    itemLabelPlural: "skills",
+                });
+            }
+            for (var _g = 0, RULE_SOURCE_PATHS_2 = RULE_SOURCE_PATHS; _g < RULE_SOURCE_PATHS_2.length; _g++) {
+                var p = RULE_SOURCE_PATHS_2[_g];
+                ruleSources.push({
+                    label: "external ".concat(rawUrl, " (").concat(p, "/)"),
+                    directory: path.join(cloneDir, p),
+                    discover: "files",
+                    symlink: false,
+                    filterInternal: true,
+                    installed: installedRules,
+                    itemLabelSingular: "rule",
+                    itemLabelPlural: "rules",
+                });
+            }
+        }
+        var skillCount = installItems(skillSources, skillsTargetDirs, options);
+        var ruleCount = installItems(ruleSources, rulesTargetDirs, options);
+        console.log("\nTotal skills installed: ".concat(skillCount));
+        console.log("Total rules installed: ".concat(ruleCount));
+    }
+    finally {
+        for (var _h = 0, tempDirs_1 = tempDirs; _h < tempDirs_1.length; _h++) {
+            var tmpDir = tempDirs_1[_h];
+            fs.rmSync(tmpDir, { recursive: true, force: true });
+        }
+    }
+}
+exports.installAgentFeaturesCommand = new commander_1.Command("install-agent-features")
+    .description("Install agent features (skills and rules) from local directories and optional external git repos")
+    .option("--config <path>", "Path to a JSON config file specifying repos to install features from", "agent-features.json")
+    .option("--dry-run", "Show which symlinks/copies would be created without making changes", false)
+    .action(function (options) { return __awaiter(void 0, void 0, void 0, function () {
+    var configPath, dryRun, resolvedConfig, repos;
+    var _a;
+    return __generator(this, function (_b) {
+        configPath = options.config, dryRun = options.dryRun;
+        resolvedConfig = path.resolve(configPath);
+        repos = fs.existsSync(resolvedConfig) ? ((_a = loadConfig(configPath).repos) !== null && _a !== void 0 ? _a : []) : [];
+        console.log("=== Installing agent features".concat(dryRun ? " (dry run)" : "", " ==="));
+        installFeatures(process.cwd(), repos, { dryRun: dryRun });
+        console.log("=== Finished ===");
+        return [2 /*return*/];
+    });
+}); });