@hasna/skills 0.1.19 → 0.1.20

package/bin/mcp.js

@@ -38746,7 +38746,7 @@ init_adapter();
 // package.json
 var package_default = {
   name: "@hasna/skills",
-  version: "0.1.19",
+  version: "0.1.20",
   description: "Skills library for AI coding agents",
   type: "module",
   bin: {
@@ -38835,6 +38835,94 @@ var package_default = {
 import { existsSync as existsSync4, readFileSync as readFileSync2, readdirSync as readdirSync3 } from "fs";
 import { join as join5 } from "path";
 import { homedir as homedir6 } from "os";
+
+// src/lib/search.ts
+function editDistance(a, b) {
+  if (a === b)
+    return 0;
+  if (a.length === 0)
+    return b.length;
+  if (b.length === 0)
+    return a.length;
+  const prev = Array.from({ length: b.length + 1 }, (_, i) => i);
+  const curr = new Array(b.length + 1);
+  for (let i = 1;i <= a.length; i++) {
+    curr[0] = i;
+    for (let j = 1;j <= b.length; j++) {
+      const cost = a[i - 1] === b[j - 1] ? 0 : 1;
+      curr[j] = Math.min(curr[j - 1] + 1, prev[j] + 1, prev[j - 1] + cost);
+    }
+    prev.splice(0, prev.length, ...curr);
+  }
+  return prev[b.length];
+}
+function fuzzyMatchScore(word, target) {
+  if (target.includes(word))
+    return 1;
+  const tokens = target.split(/[\s\-_]+/).filter(Boolean);
+  for (const token of tokens) {
+    if (token.startsWith(word))
+      return 0.6;
+  }
+  if (word.length >= 3) {
+    const maxDist = word.length <= 3 ? 1 : 2;
+    for (const token of tokens) {
+      if (Math.abs(token.length - word.length) <= maxDist) {
+        const dist = editDistance(word, token);
+        if (dist <= maxDist)
+          return 0.4;
+      }
+    }
+  }
+  return 0;
+}
+function searchSkills(query) {
+  const words = query.toLowerCase().split(/\s+/).filter(Boolean);
+  if (words.length === 0)
+    return [];
+  const scored = [];
+  for (const skill of loadRegistry()) {
+    const nameLower = skill.name.toLowerCase();
+    const displayNameLower = skill.displayName.toLowerCase();
+    const descriptionLower = skill.description.toLowerCase();
+    const tagsLower = skill.tags.map((t) => t.toLowerCase());
+    const tagsCombined = tagsLower.join(" ");
+    let score = 0;
+    let allWordsMatch = true;
+    for (const word of words) {
+      let wordScore = 0;
+      const nameMatch = fuzzyMatchScore(word, nameLower);
+      if (nameMatch > 0)
+        wordScore += 10 * nameMatch;
+      const displayMatch = fuzzyMatchScore(word, displayNameLower);
+      if (displayMatch > 0)
+        wordScore += 7 * displayMatch;
+      const tagMatch = Math.max(...tagsLower.map((t) => fuzzyMatchScore(word, t)), fuzzyMatchScore(word, tagsCombined));
+      if (tagMatch > 0)
+        wordScore += 5 * tagMatch;
+      const descMatch = fuzzyMatchScore(word, descriptionLower);
+      if (descMatch > 0)
+        wordScore += 2 * descMatch;
+      if (wordScore === 0) {
+        allWordsMatch = false;
+        break;
+      }
+      score += wordScore;
+    }
+    if (allWordsMatch && score > 0) {
+      scored.push({ skill, score });
+    }
+  }
+  scored.sort((a, b) => b.score - a.score);
+  return scored.map((s) => s.skill);
+}
+function findSimilarSkills(query, maxResults = 3) {
+  const q = query.toLowerCase();
+  const scored = loadRegistry().map((s) => ({ name: s.name, dist: editDistance(q, s.name.toLowerCase()) })).filter((s) => s.dist <= Math.max(3, Math.floor(q.length / 2))).sort((a, b) => a.dist - b.dist);
+  return scored.slice(0, maxResults).map((s) => s.name);
+}
+
+// src/lib/registry.ts
 var CATEGORIES = [
   "Development Tools",
   "Business & Marketing",
@@ -38876,6 +38964,21 @@ var SKILLS = [
     category: "Development Tools",
     tags: ["code", "linting", "formatting", "quality"]
   },
+  {
+    name: "commitpush",
+    displayName: "Commit Push",
+    description: "Create logical commits from repo changes and push directly to the main branch",
+    category: "Development Tools",
+    tags: ["git", "commit", "push", "automation"]
+  },
+  {
+    name: "commitpushpr",
+    displayName: "Commit Push PR",
+    description: "Create logical commits, push a feature branch, and open a GitHub pull request",
+    category: "Development Tools",
+    tags: ["git", "commit", "pull-request", "github", "automation"],
+    dependencies: ["commitpush"]
+  },
   {
     name: "consolelog",
     displayName: "Console Log",
@@ -39037,6 +39140,13 @@ var SKILLS = [
     category: "Development Tools",
     tags: ["mcp", "builder", "scaffold", "server"]
   },
+  {
+    name: "monitor",
+    displayName: "Monitor",
+    description: "Operate the open-monitor MCP for machine health, processes, cron jobs, and cleanup workflows",
+    category: "Development Tools",
+    tags: ["monitoring", "mcp", "processes", "operations"]
+  },
   {
     name: "npmpublish",
     displayName: "NPM Publish",
@@ -39087,6 +39197,13 @@ var SKILLS = [
     category: "Development Tools",
     tags: ["terraform", "iac", "infrastructure", "devops"]
   },
+  {
+    name: "tmux-session",
+    displayName: "Tmux Session",
+    description: "Create and manage grouped tmux sessions with workspace-aware naming and window layout guidance",
+    category: "Development Tools",
+    tags: ["tmux", "terminal", "sessions", "workspace"]
+  },
   {
     name: "validate-config",
     displayName: "Validate Config",
@@ -39689,6 +39806,34 @@ var SKILLS = [
     category: "Data & Analysis",
     tags: ["kpi", "digest", "metrics", "reporting"]
   },
+  {
+    name: "read-csv",
+    displayName: "Read CSV",
+    description: "Parse CSV files into structured JSON with delimiter and encoding detection",
+    category: "Data & Analysis",
+    tags: ["csv", "parsing", "tabular", "data"]
+  },
+  {
+    name: "read-excel",
+    displayName: "Read Excel",
+    description: "Parse XLS and XLSX workbooks into structured JSON with sheet and formatted cell metadata",
+    category: "Data & Analysis",
+    tags: ["excel", "spreadsheet", "xlsx", "data"]
+  },
+  {
+    name: "read-image",
+    displayName: "Read Image",
+    description: "Analyze local or remote images with Claude vision and extract visible text and visual structure",
+    category: "Data & Analysis",
+    tags: ["image", "vision", "ocr", "analysis"]
+  },
+  {
+    name: "read-pdf",
+    displayName: "Read PDF",
+    description: "Extract text and structured content from PDF files with chunked Claude document analysis",
+    category: "Data & Analysis",
+    tags: ["pdf", "documents", "extraction", "analysis"]
+  },
   {
     name: "spreadsheet-cleanroom",
     displayName: "Spreadsheet Cleanroom",
@@ -40370,103 +40515,9 @@ function loadRegistry(cwd) {
 function getSkillsByCategory(category) {
   return loadRegistry().filter((s) => s.category === category);
 }
-function editDistance(a, b) {
-  if (a === b)
-    return 0;
-  if (a.length === 0)
-    return b.length;
-  if (b.length === 0)
-    return a.length;
-  const prev = Array.from({ length: b.length + 1 }, (_, i) => i);
-  const curr = new Array(b.length + 1);
-  for (let i = 1;i <= a.length; i++) {
-    curr[0] = i;
-    for (let j = 1;j <= b.length; j++) {
-      const cost = a[i - 1] === b[j - 1] ? 0 : 1;
-      curr[j] = Math.min(curr[j - 1] + 1, prev[j] + 1, prev[j - 1] + cost);
-    }
-    prev.splice(0, prev.length, ...curr);
-  }
-  return prev[b.length];
-}
-function fuzzyMatchScore(word, target) {
-  if (target.includes(word))
-    return 1;
-  const tokens = target.split(/[\s\-_]+/).filter(Boolean);
-  for (const token of tokens) {
-    if (token.startsWith(word))
-      return 0.6;
-  }
-  if (word.length >= 3) {
-    const maxDist = word.length <= 3 ? 1 : 2;
-    for (const token of tokens) {
-      if (Math.abs(token.length - word.length) <= maxDist) {
-        const dist = editDistance(word, token);
-        if (dist <= maxDist)
-          return 0.4;
-      }
-    }
-  }
-  return 0;
-}
-function searchSkills(query) {
-  const words = query.toLowerCase().split(/\s+/).filter(Boolean);
-  if (words.length === 0)
-    return [];
-  const scored = [];
-  for (const skill of loadRegistry()) {
-    const nameLower = skill.name.toLowerCase();
-    const displayNameLower = skill.displayName.toLowerCase();
-    const descriptionLower = skill.description.toLowerCase();
-    const tagsLower = skill.tags.map((t) => t.toLowerCase());
-    const tagsCombined = tagsLower.join(" ");
-    let score = 0;
-    let allWordsMatch = true;
-    for (const word of words) {
-      let wordScore = 0;
-      const nameMatch = fuzzyMatchScore(word, nameLower);
-      if (nameMatch > 0)
-        wordScore += 10 * nameMatch;
-      const displayMatch = fuzzyMatchScore(word, displayNameLower);
-      if (displayMatch > 0)
-        wordScore += 7 * displayMatch;
-      const tagMatch = Math.max(...tagsLower.map((t) => fuzzyMatchScore(word, t)), fuzzyMatchScore(word, tagsCombined));
-      if (tagMatch > 0)
-        wordScore += 5 * tagMatch;
-      const descMatch = fuzzyMatchScore(word, descriptionLower);
-      if (descMatch > 0)
-        wordScore += 2 * descMatch;
-      if (wordScore === 0) {
-        allWordsMatch = false;
-        break;
-      }
-      score += wordScore;
-    }
-    if (allWordsMatch && score > 0) {
-      scored.push({ skill, score });
-    }
-  }
-  scored.sort((a, b) => b.score - a.score);
-  return scored.map((s) => s.skill);
-}
 function getSkill(name) {
   return loadRegistry().find((s) => s.name === name);
 }
-function levenshtein(a, b) {
-  const m = a.length, n = b.length;
-  const dp = Array.from({ length: m + 1 }, (_, i) => Array.from({ length: n + 1 }, (_2, j) => i === 0 ? j : j === 0 ? i : 0));
-  for (let i = 1;i <= m; i++) {
-    for (let j = 1;j <= n; j++) {
-      dp[i][j] = a[i - 1] === b[j - 1] ? dp[i - 1][j - 1] : 1 + Math.min(dp[i - 1][j], dp[i][j - 1], dp[i - 1][j - 1]);
-    }
-  }
-  return dp[m][n];
-}
-function findSimilarSkills(query, maxResults = 3) {
-  const q = query.toLowerCase();
-  const scored = loadRegistry().map((s) => ({ name: s.name, dist: levenshtein(q, s.name.toLowerCase()) })).filter((s) => s.dist <= Math.max(3, Math.floor(q.length / 2))).sort((a, b) => a.dist - b.dist);
-  return scored.slice(0, maxResults).map((s) => s.name);
-}
 
 // src/lib/installer.ts
 import { existsSync as existsSync6, cpSync, mkdirSync as mkdirSync3, writeFileSync as writeFileSync2, rmSync, readdirSync as readdirSync5, statSync, readFileSync as readFileSync3, accessSync, constants } from "fs";
@@ -41063,11 +41114,61 @@ function saveSchedules(data, targetDir = process.cwd()) {
     mkdirSync5(dir, { recursive: true });
   writeFileSync3(path, JSON.stringify(data, null, 2));
 }
+function validateCronField(expr, min, max, label) {
+  for (const part of expr.split(",")) {
+    if (part === "*")
+      continue;
+    let valuePart = part;
+    if (part.includes("/")) {
+      const slashIdx = part.indexOf("/");
+      valuePart = part.slice(0, slashIdx);
+      const stepStr = part.slice(slashIdx + 1);
+      const step = parseInt(stepStr);
+      if (isNaN(step) || step < 1)
+        return { valid: false, error: `Invalid step value in "${part}" in ${label}` };
+    }
+    if (valuePart === "*")
+      continue;
+    if (valuePart.includes("-")) {
+      const rangeParts = valuePart.split("-");
+      if (rangeParts.length !== 2)
+        return { valid: false, error: `Invalid range expression "${valuePart}" in ${label}` };
+      const lo = parseInt(rangeParts[0]);
+      const hi = parseInt(rangeParts[1]);
+      if (isNaN(lo) || isNaN(hi))
+        return { valid: false, error: `Invalid range "${valuePart}" in ${label}` };
+      if (lo < min || hi > max || lo > hi) {
+        return { valid: false, error: `Range ${lo}-${hi} outside valid ${min}-${max} in ${label}` };
+      }
+      continue;
+    }
+    const n = parseInt(valuePart);
+    if (isNaN(n))
+      return { valid: false, error: `Invalid value "${valuePart}" in ${label}` };
+    if (n < min || n > max) {
+      return { valid: false, error: `Value ${n} outside valid ${min}-${max} in ${label}` };
+    }
+  }
+  return { valid: true };
+}
 function validateCron(expr) {
   const fields = expr.trim().split(/\s+/);
   if (fields.length !== 5) {
     return { valid: false, error: `Expected 5 fields, got ${fields.length}. Format: "minute hour day-of-month month day-of-week"` };
   }
+  const [minuteF, hourF, domF, monthF, dowF] = fields;
+  const checks4 = [
+    { expr: minuteF, min: 0, max: 59, label: "minute" },
+    { expr: hourF, min: 0, max: 23, label: "hour" },
+    { expr: domF, min: 1, max: 31, label: "day-of-month" },
+    { expr: monthF, min: 1, max: 12, label: "month" },
+    { expr: dowF, min: 0, max: 6, label: "day-of-week" }
+  ];
+  for (const { expr: f, min, max, label } of checks4) {
+    const result = validateCronField(f, min, max, label);
+    if (!result.valid)
+      return result;
+  }
   return { valid: true };
 }
 function getNextRun(cron, from = new Date) {

package/dist/cli/commands/completion.d.ts

@@ -0,0 +1,5 @@
+/**
+ * completion — shell completion generation
+ */
+import type { Command } from "commander";
+export declare function registerCompletion(parent: Command): void;

package/dist/cli/commands/create-sync-config.d.ts

@@ -0,0 +1,5 @@
+/**
+ * config / create / sync — configuration and scaffolding commands
+ */
+import type { Command } from "commander";
+export declare function registerCreateSync(parent: Command): void;

package/dist/cli/commands/diagnostic.d.ts

@@ -0,0 +1,5 @@
+/**
+ * test / doctor / auth / whoami / outdated — diagnostic commands
+ */
+import type { Command } from "commander";
+export declare function registerDiagnostic(parent: Command): void;

package/dist/cli/commands/init.d.ts

@@ -0,0 +1,5 @@
+/**
+ * init / export / import — project setup and sharing commands
+ */
+import type { Command } from "commander";
+export declare function registerSetup(parent: Command): void;

package/dist/cli/commands/install.d.ts

@@ -0,0 +1,5 @@
+/**
+ * install / remove / update — skill lifecycle commands
+ */
+import type { Command } from "commander";
+export declare function registerInstall(parent: Command): void;

package/dist/cli/commands/introspect.d.ts

@@ -0,0 +1,5 @@
+/**
+ * info / docs / requires / validate / diff — skill introspection commands
+ */
+import type { Command } from "commander";
+export declare function registerIntrospect(parent: Command): void;

package/dist/cli/commands/list.d.ts

@@ -0,0 +1,5 @@
+/**
+ * list / search / categories / tags — browsing commands
+ */
+import type { Command } from "commander";
+export declare function registerBrowse(parent: Command): void;

package/dist/cli/commands/runtime.d.ts

@@ -0,0 +1,5 @@
+/**
+ * run / mcp / serve / self-update — runtime commands
+ */
+import type { Command } from "commander";
+export declare function registerRuntime(parent: Command): void;

package/dist/cli/commands/schedule.d.ts

@@ -0,0 +1,5 @@
+/**
+ * schedule — cron-based skill scheduling commands
+ */
+import type { Command } from "commander";
+export declare function registerSchedule(parent: Command): void;