add-skill-kit 3.2.6 → 3.2.8

package/bin/lib/commands/update.js

@@ -1,55 +1,55 @@
-/**
- * @fileoverview Update command
- */
-
-import fs from "fs";
-import path from "path";
-
-import { resolveScope, createBackup } from "../helpers.js";
-import { step, stepLine, S, c, fatal, spinner } from "../ui.js";
-import { DRY } from "../config.js";
-
-/**
- * Update a skill
- * @param {string} skillName
- */
-export async function run(skillName) {
-    if (!skillName) fatal("Missing skill name");
-
-    const scope = resolveScope();
-    const targetDir = path.join(scope, skillName);
-
-    if (!fs.existsSync(targetDir)) fatal(`Skill not found: ${skillName}`);
-
-    const metaFile = path.join(targetDir, ".skill-source.json");
-    if (!fs.existsSync(metaFile)) fatal("Skill metadata not found");
-
-    const meta = JSON.parse(fs.readFileSync(metaFile, "utf-8"));
-    if (!meta.repo || meta.repo === "local") fatal("Cannot update local skill");
-
-    stepLine();
-
-    const s = spinner();
-    s.start(`Updating ${skillName}`);
-
-    try {
-        if (!DRY) {
-            createBackup(targetDir, skillName);
-            fs.rmSync(targetDir, { recursive: true, force: true });
-        }
-
-        const spec = `${meta.repo}#${meta.skill}${meta.ref ? "@" + meta.ref : ""}`;
-
-        if (DRY) {
-            s.stop("Dry run analysis complete");
-            step(`Would update: ${skillName}`);
-        } else {
-            s.stop("Preparing update...");
-            // Dynamically import install command
-            const { run: install } = await import("./install.js");
-            await install(spec);
-        }
-    } catch (err) {
-        s.fail(`Failed: ${err.message}`);
-    }
-}
+/**
+ * @fileoverview Update command
+ */
+
+import fs from "fs";
+import path from "path";
+
+import { resolveScope, createBackup } from "../helpers.js";
+import { step, stepLine, S, c, fatal, spinner } from "../ui.js";
+import { DRY } from "../config.js";
+
+/**
+ * Update a skill
+ * @param {string} skillName
+ */
+export async function run(skillName) {
+    if (!skillName) fatal("Missing skill name");
+
+    const scope = resolveScope();
+    const targetDir = path.join(scope, skillName);
+
+    if (!fs.existsSync(targetDir)) fatal(`Skill not found: ${skillName}`);
+
+    const metaFile = path.join(targetDir, ".skill-source.json");
+    if (!fs.existsSync(metaFile)) fatal("Skill metadata not found");
+
+    const meta = JSON.parse(fs.readFileSync(metaFile, "utf-8"));
+    if (!meta.repo || meta.repo === "local") fatal("Cannot update local skill");
+
+    stepLine();
+
+    const s = spinner();
+    s.start(`Updating ${skillName}`);
+
+    try {
+        if (!DRY) {
+            createBackup(targetDir, skillName);
+            fs.rmSync(targetDir, { recursive: true, force: true });
+        }
+
+        const spec = `${meta.repo}#${meta.skill}${meta.ref ? "@" + meta.ref : ""}`;
+
+        if (DRY) {
+            s.stop("Dry run analysis complete");
+            step(`Would update: ${skillName}`);
+        } else {
+            s.stop("Preparing update...");
+            // Dynamically import install command
+            const { run: install } = await import("./install.js");
+            await install(spec);
+        }
+    } catch (err) {
+        s.fail(`Failed: ${err.message}`);
+    }
+}

package/bin/lib/commands/validate.js

@@ -1,69 +1,69 @@
-/**
- * @fileoverview Validate command - Antigravity spec validation
- */
-
-import fs from "fs";
-import path from "path";
-import { getInstalledSkills, parseSkillMdFrontmatter } from "../skills.js";
-import { resolveScope } from "../helpers.js";
-import { step, stepLine, S, c, fatal } from "../ui.js";
-import { VERBOSE, STRICT } from "../config.js";
-
-/**
- * Validate skills against Antigravity spec
- * @param {string} [skillName] - Optional specific skill
- */
-export async function run(skillName) {
-    const scope = resolveScope();
-    let skillsToValidate = [];
-
-    if (skillName) {
-        const sd = path.join(scope, skillName);
-        if (!fs.existsSync(sd)) fatal(`Skill not found: ${skillName}`);
-        skillsToValidate = [{ name: skillName, path: sd }];
-    } else {
-        skillsToValidate = getInstalledSkills();
-    }
-
-    if (skillsToValidate.length === 0) {
-        stepLine();
-        step("No skills to validate", S.diamond);
-        return;
-    }
-
-    stepLine();
-    step(c.bold("Antigravity Validation"), S.diamondFilled, "cyan");
-    stepLine();
-
-    let totalErrors = 0, totalWarnings = 0;
-
-    for (const skill of skillsToValidate) {
-        const errors = [], warnings = [];
-        const smp = path.join(skill.path, "SKILL.md");
-
-        if (!fs.existsSync(smp)) {
-            errors.push("Missing SKILL.md");
-        } else {
-            const m = parseSkillMdFrontmatter(smp);
-            if (!m.description) errors.push("Missing description");
-            else if (m.description.length < 50) warnings.push("Description too short");
-        }
-
-        const status = errors.length > 0 ? c.red("FAIL") : warnings.length > 0 ? c.yellow("WARN") : c.green("PASS");
-        console.log(`${c.gray(S.branch)}  ${status}  ${c.bold(skill.name)}`);
-
-        if (VERBOSE || errors.length || warnings.length) {
-            errors.forEach(e => console.log(`${c.gray(S.branch)}      ${c.red("ERROR: " + e)}`));
-            warnings.forEach(w => console.log(`${c.gray(S.branch)}      ${c.yellow("WARN: " + w)}`));
-        }
-
-        totalErrors += errors.length;
-        totalWarnings += warnings.length;
-    }
-
-    stepLine();
-    console.log(`${c.gray(S.branch)}  Total: ${skillsToValidate.length}, Errors: ${totalErrors}, Warnings: ${totalWarnings}`);
-    stepLine();
-
-    if (STRICT && totalErrors > 0) process.exit(1);
-}
+/**
+ * @fileoverview Validate command - Antigravity spec validation
+ */
+
+import fs from "fs";
+import path from "path";
+import { getInstalledSkills, parseSkillMdFrontmatter } from "../skills.js";
+import { resolveScope } from "../helpers.js";
+import { step, stepLine, S, c, fatal } from "../ui.js";
+import { VERBOSE, STRICT } from "../config.js";
+
+/**
+ * Validate skills against Antigravity spec
+ * @param {string} [skillName] - Optional specific skill
+ */
+export async function run(skillName) {
+    const scope = resolveScope();
+    let skillsToValidate = [];
+
+    if (skillName) {
+        const sd = path.join(scope, skillName);
+        if (!fs.existsSync(sd)) fatal(`Skill not found: ${skillName}`);
+        skillsToValidate = [{ name: skillName, path: sd }];
+    } else {
+        skillsToValidate = getInstalledSkills();
+    }
+
+    if (skillsToValidate.length === 0) {
+        stepLine();
+        step("No skills to validate", S.diamond);
+        return;
+    }
+
+    stepLine();
+    step(c.bold("Antigravity Validation"), S.diamondFilled, "cyan");
+    stepLine();
+
+    let totalErrors = 0, totalWarnings = 0;
+
+    for (const skill of skillsToValidate) {
+        const errors = [], warnings = [];
+        const smp = path.join(skill.path, "SKILL.md");
+
+        if (!fs.existsSync(smp)) {
+            errors.push("Missing SKILL.md");
+        } else {
+            const m = parseSkillMdFrontmatter(smp);
+            if (!m.description) errors.push("Missing description");
+            else if (m.description.length < 50) warnings.push("Description too short");
+        }
+
+        const status = errors.length > 0 ? c.red("FAIL") : warnings.length > 0 ? c.yellow("WARN") : c.green("PASS");
+        console.log(`${c.gray(S.branch)}  ${status}  ${c.bold(skill.name)}`);
+
+        if (VERBOSE || errors.length || warnings.length) {
+            errors.forEach(e => console.log(`${c.gray(S.branch)}      ${c.red("ERROR: " + e)}`));
+            warnings.forEach(w => console.log(`${c.gray(S.branch)}      ${c.yellow("WARN: " + w)}`));
+        }
+
+        totalErrors += errors.length;
+        totalWarnings += warnings.length;
+    }
+
+    stepLine();
+    console.log(`${c.gray(S.branch)}  Total: ${skillsToValidate.length}, Errors: ${totalErrors}, Warnings: ${totalWarnings}`);
+    stepLine();
+
+    if (STRICT && totalErrors > 0) process.exit(1);
+}

package/bin/lib/commands/verify.js

@@ -1,56 +1,56 @@
-/**
- * @fileoverview Verify command - Checksum verification
- */
-
-import fs from "fs";
-import path from "path";
-import { resolveScope, merkleHash } from "../helpers.js";
-import { step, stepLine, S, c } from "../ui.js";
-import { STRICT } from "../config.js";
-
-/**
- * Verify skill checksums
- */
-export async function run() {
-    const scope = resolveScope();
-
-    if (!fs.existsSync(scope)) {
-        stepLine();
-        step("No skills directory found", S.diamond);
-        return;
-    }
-
-    stepLine();
-    step(c.bold("Verifying Skills"), S.diamondFilled, "cyan");
-    stepLine();
-
-    let issues = 0;
-
-    for (const name of fs.readdirSync(scope)) {
-        const dir = path.join(scope, name);
-        if (!fs.statSync(dir).isDirectory()) continue;
-
-        const mf = path.join(dir, ".skill-source.json");
-        if (!fs.existsSync(mf)) {
-            step(`${name}: ${c.red("missing metadata")}`, S.cross, "red");
-            issues++;
-            continue;
-        }
-
-        const m = JSON.parse(fs.readFileSync(mf, "utf-8"));
-        const actual = merkleHash(dir);
-
-        if (actual !== m.checksum) {
-            step(`${name}: ${c.red("checksum mismatch")}`, S.cross, "red");
-            issues++;
-        } else {
-            step(`${name}: ${c.green("OK")}`, S.check, "green");
-        }
-    }
-
-    stepLine();
-    console.log(`${c.gray(S.branch)}  ${issues ? c.red(issues + " issue(s)") : c.green("All verified")}`);
-    stepLine();
-
-    if (issues && STRICT) process.exit(1);
-}
+/**
+ * @fileoverview Verify command - Checksum verification
+ */
+
+import fs from "fs";
+import path from "path";
+import { resolveScope, merkleHash } from "../helpers.js";
+import { step, stepLine, S, c } from "../ui.js";
+import { STRICT } from "../config.js";
+
+/**
+ * Verify skill checksums
+ */
+export async function run() {
+    const scope = resolveScope();
+
+    if (!fs.existsSync(scope)) {
+        stepLine();
+        step("No skills directory found", S.diamond);
+        return;
+    }
+
+    stepLine();
+    step(c.bold("Verifying Skills"), S.diamondFilled, "cyan");
+    stepLine();
+
+    let issues = 0;
+
+    for (const name of fs.readdirSync(scope)) {
+        const dir = path.join(scope, name);
+        if (!fs.statSync(dir).isDirectory()) continue;
+
+        const mf = path.join(dir, ".skill-source.json");
+        if (!fs.existsSync(mf)) {
+            step(`${name}: ${c.red("missing metadata")}`, S.cross, "red");
+            issues++;
+            continue;
+        }
+
+        const m = JSON.parse(fs.readFileSync(mf, "utf-8"));
+        const actual = merkleHash(dir);
+
+        if (actual !== m.checksum) {
+            step(`${name}: ${c.red("checksum mismatch")}`, S.cross, "red");
+            issues++;
+        } else {
+            step(`${name}: ${c.green("OK")}`, S.check, "green");
+        }
+    }
+
+    stepLine();
+    console.log(`${c.gray(S.branch)}  ${issues ? c.red(issues + " issue(s)") : c.green("All verified")}`);
+    stepLine();
+
+    if (issues && STRICT) process.exit(1);
+}

package/bin/lib/config.js

@@ -1,81 +1,81 @@
-/**
- * @fileoverview Configuration and argument parsing
- */
-
-import path from "path";
-import os from "os";
-
-/** Current working directory */
-export const cwd = process.cwd();
-
-/** Local workspace skills directory (configurable via ADD_SKILL_WORKSPACE) */
-export const WORKSPACE = process.env.ADD_SKILL_WORKSPACE || path.join(cwd, ".agent", "skills");
-
-/** Global skills directory (configurable via ADD_SKILL_GLOBAL_DIR) */
-export const GLOBAL_DIR = process.env.ADD_SKILL_GLOBAL_DIR || path.join(os.homedir(), ".gemini", "antigravity", "skills");
-
-/** Cache root directory */
-export const CACHE_ROOT = process.env.ADD_SKILL_CACHE_DIR || path.join(os.homedir(), ".cache", "agentskillskit");
-
-/** Registry cache directory */
-export const REGISTRY_CACHE = path.join(CACHE_ROOT, "registries");
-
-/** Registries file path */
-export const REGISTRIES_FILE = path.join(CACHE_ROOT, "registries.json");
-
-/** Backup directory */
-export const BACKUP_DIR = path.join(CACHE_ROOT, "backups");
-
-// --- Argument Parsing ---
-
-const args = process.argv.slice(2);
-
-/** Command name (first non-flag argument) */
-export const command = args[0] || "help";
-
-/** All flags (starting with --) */
-export const flags = new Set(args.filter((a) => a.startsWith("--")));
-
-/** Command parameters (non-flag arguments after command) */
-export const params = args.filter((a) => !a.startsWith("--")).slice(1);
-
-// --- Flag Shortcuts ---
-
-/** @type {boolean} Use global scope */
-export const GLOBAL = flags.has("--global") || flags.has("-g");
-
-/** @type {boolean} Verbose output */
-export const VERBOSE = flags.has("--verbose") || flags.has("-v");
-
-/** @type {boolean} JSON output mode */
-export const JSON_OUTPUT = flags.has("--json");
-
-/** @type {boolean} Force operation */
-export const FORCE = flags.has("--force") || flags.has("-f");
-
-/** @type {boolean} Dry run mode */
-export const DRY = flags.has("--dry-run");
-
-/** @type {boolean} Auto-fix mode */
-export const FIX = flags.has("--fix");
-
-/** @type {boolean} Strict mode */
-export const STRICT = flags.has("--strict");
-
-/** @type {boolean} Locked mode (install from lockfile) */
-export const LOCKED = flags.has("--locked");
-
-/** @type {boolean} Offline mode (skip network operations) */
-export const OFFLINE = flags.has("--offline");
-
-// --- Package Info ---
-
-import { createRequire } from "module";
-const require = createRequire(import.meta.url);
-
-/** @type {string} Package version */
-export const VERSION = (() => {
-    try { return require("../../package.json").version; }
-    catch { return "1.2.0"; }
-})();
-
+/**
+ * @fileoverview Configuration and argument parsing
+ */
+
+import path from "path";
+import os from "os";
+
+/** Current working directory */
+export const cwd = process.cwd();
+
+/** Local workspace skills directory (configurable via ADD_SKILL_WORKSPACE) */
+export const WORKSPACE = process.env.ADD_SKILL_WORKSPACE || path.join(cwd, ".agent", "skills");
+
+/** Global skills directory (configurable via ADD_SKILL_GLOBAL_DIR) */
+export const GLOBAL_DIR = process.env.ADD_SKILL_GLOBAL_DIR || path.join(os.homedir(), ".gemini", "antigravity", "skills");
+
+/** Cache root directory */
+export const CACHE_ROOT = process.env.ADD_SKILL_CACHE_DIR || path.join(os.homedir(), ".cache", "agentskillskit");
+
+/** Registry cache directory */
+export const REGISTRY_CACHE = path.join(CACHE_ROOT, "registries");
+
+/** Registries file path */
+export const REGISTRIES_FILE = path.join(CACHE_ROOT, "registries.json");
+
+/** Backup directory */
+export const BACKUP_DIR = path.join(CACHE_ROOT, "backups");
+
+// --- Argument Parsing ---
+
+const args = process.argv.slice(2);
+
+/** Command name (first non-flag argument) */
+export const command = args[0] || "help";
+
+/** All flags (starting with --) */
+export const flags = new Set(args.filter((a) => a.startsWith("--")));
+
+/** Command parameters (non-flag arguments after command) */
+export const params = args.filter((a) => !a.startsWith("--")).slice(1);
+
+// --- Flag Shortcuts ---
+
+/** @type {boolean} Use global scope */
+export const GLOBAL = flags.has("--global") || flags.has("-g");
+
+/** @type {boolean} Verbose output */
+export const VERBOSE = flags.has("--verbose") || flags.has("-v");
+
+/** @type {boolean} JSON output mode */
+export const JSON_OUTPUT = flags.has("--json");
+
+/** @type {boolean} Force operation */
+export const FORCE = flags.has("--force") || flags.has("-f");
+
+/** @type {boolean} Dry run mode */
+export const DRY = flags.has("--dry-run");
+
+/** @type {boolean} Auto-fix mode */
+export const FIX = flags.has("--fix");
+
+/** @type {boolean} Strict mode */
+export const STRICT = flags.has("--strict");
+
+/** @type {boolean} Locked mode (install from lockfile) */
+export const LOCKED = flags.has("--locked");
+
+/** @type {boolean} Offline mode (skip network operations) */
+export const OFFLINE = flags.has("--offline");
+
+// --- Package Info ---
+
+import { createRequire } from "module";
+const require = createRequire(import.meta.url);
+
+/** @type {string} Package version */
+export const VERSION = (() => {
+    try { return require("../../package.json").version; }
+    catch { return "1.2.0"; }
+})();
+