skillio 0.1.11 → 0.1.13

package/dist/cli.js

@@ -6,12 +6,13 @@ import {
   discoverSkills,
   getLockPath,
   green,
+  promptText,
   readLock,
   red,
   removeSkillFromLock,
   setColorEnabled,
   yellow
-} from "./shared/chunk-0qvp6v8g.js";
+} from "./shared/chunk-2gt0ysd1.js";
 
 // src/cli.ts
 import { createRequire } from "node:module";
@@ -558,6 +559,167 @@ function _getBuiltinFlags(long, short, userNames, userAliases) {
   return [`--${long}`, `-${short}`];
 }
 
+// src/commands/completion.ts
+var BASH = `# skillio bash completion
+# Install: source <(skl completion bash)
+_skillio_completions() {
+  local cur prev words cword
+  COMPREPLY=()
+  cur="\${COMP_WORDS[COMP_CWORD]}"
+  prev="\${COMP_WORDS[COMP_CWORD-1]}"
+
+  local cmds="list ls remove rm cost co cst usage us usg completion"
+  if [ "\${COMP_CWORD}" -eq 1 ]; then
+    COMPREPLY=( $(compgen -W "\${cmds} -h --help -v --version" -- "\${cur}") )
+    return 0
+  fi
+
+  local sub="\${COMP_WORDS[1]}"
+  case "\${sub}" in
+    rm|remove)
+      if [[ "\${cur}" == -* ]]; then
+        COMPREPLY=( $(compgen -W "-g --global --all --dry-run -y --yes --force-lock --lock-only -h --help" -- "\${cur}") )
+      else
+        local names
+        local scope=""
+        for w in "\${COMP_WORDS[@]}"; do
+          if [ "\${w}" = "-g" ] || [ "\${w}" = "--global" ]; then scope="-g"; fi
+        done
+        names="$(skl list --names \${scope} 2>/dev/null)"
+        COMPREPLY=( $(compgen -W "\${names}" -- "\${cur}") )
+      fi
+      return 0
+      ;;
+    completion)
+      COMPREPLY=( $(compgen -W "bash zsh fish" -- "\${cur}") )
+      return 0
+      ;;
+  esac
+}
+complete -F _skillio_completions skl
+complete -F _skillio_completions skillio
+`;
+var ZSH = `# skillio zsh completion
+# Install: source <(skl completion zsh)
+_skillio() {
+  local -a cmds
+  cmds=(
+    'list:List skills per source'
+    'ls:Alias for list'
+    'remove:Delete on-disk skill dirs'
+    'rm:Alias for remove'
+    'cost:Show ambient ballast cost'
+    'co:Alias for cost'
+    'cst:Alias for cost'
+    'usage:Show skill usage'
+    'us:Alias for usage'
+    'usg:Alias for usage'
+    'completion:Print shell completion script'
+  )
+  if (( CURRENT == 2 )); then
+    _describe 'command' cmds
+    return
+  fi
+  local sub=\${words[2]}
+  case $sub in
+    rm|remove)
+      if [[ \${words[CURRENT]} == -* ]]; then
+        _values 'flag' \\
+          '-g[global scope]' '--global[global scope]' \\
+          '--all[remove every skill in scope]' \\
+          '--dry-run[print plan without deleting]' \\
+          '-y[skip confirmation]' '--yes[skip confirmation]' \\
+          '--force-lock[also remove lock entry]' \\
+          '--lock-only[remove only lock entry, keep disk]'
+      else
+        local scope=""
+        for w in \${words[@]}; do
+          if [[ $w == "-g" || $w == "--global" ]]; then scope="-g"; fi
+        done
+        local -a names
+        names=(\${(f)"$(skl list --names $scope 2>/dev/null)"})
+        compadd -- $names
+      fi
+      ;;
+    completion)
+      _values 'shell' bash zsh fish
+      ;;
+  esac
+}
+compdef _skillio skl skillio
+`;
+var FISH = `# skillio fish completion
+# Install: skl completion fish | source
+function __skillio_skill_names
+  set -l scope ""
+  for w in (commandline -opc)
+    if test "$w" = "-g" -o "$w" = "--global"
+      set scope "-g"
+    end
+  end
+  skl list --names $scope 2>/dev/null
+end
+
+function __skillio_needs_command
+  set -l cmd (commandline -opc)
+  test (count $cmd) -le 1
+end
+
+function __skillio_using_subcommand
+  set -l cmd (commandline -opc)
+  if test (count $cmd) -lt 2; return 1; end
+  test "$cmd[2]" = "$argv[1]"
+end
+
+complete -c skl -n __skillio_needs_command -a 'list ls remove rm cost co cst usage us usg completion'
+complete -c skillio -n __skillio_needs_command -a 'list ls remove rm cost co cst usage us usg completion'
+
+for sub in rm remove
+  complete -c skl -n "__skillio_using_subcommand $sub" -f -a '(__skillio_skill_names)'
+  complete -c skillio -n "__skillio_using_subcommand $sub" -f -a '(__skillio_skill_names)'
+  complete -c skl -n "__skillio_using_subcommand $sub" -s g -l global -d 'Use global scope'
+  complete -c skl -n "__skillio_using_subcommand $sub" -l all -d 'Remove every skill in scope'
+  complete -c skl -n "__skillio_using_subcommand $sub" -l dry-run -d 'Print plan without deleting'
+  complete -c skl -n "__skillio_using_subcommand $sub" -s y -l yes -d 'Skip confirmation prompt'
+  complete -c skl -n "__skillio_using_subcommand $sub" -l force-lock -d 'Also remove lock entry'
+  complete -c skl -n "__skillio_using_subcommand $sub" -l lock-only -d 'Remove only lock entry, keep disk'
+end
+
+for sub in completion
+  complete -c skl -n "__skillio_using_subcommand $sub" -f -a 'bash zsh fish'
+  complete -c skillio -n "__skillio_using_subcommand $sub" -f -a 'bash zsh fish'
+end
+`;
+var completionCommand = defineCommand({
+  meta: {
+    description: "Print shell completion script (bash, zsh, fish)"
+  },
+  args: {
+    shell: {
+      type: "positional",
+      required: true,
+      description: "Target shell: bash, zsh, or fish"
+    }
+  },
+  run({ args }) {
+    const shell = String(args.shell ?? "");
+    switch (shell) {
+      case "bash":
+        process.stdout.write(BASH);
+        return;
+      case "zsh":
+        process.stdout.write(ZSH);
+        return;
+      case "fish":
+        process.stdout.write(FISH);
+        return;
+      default:
+        console.error(`unknown shell: ${shell || "(none)"} — supported: bash, zsh, fish`);
+        process.exit(1);
+    }
+  }
+});
+
 // src/commands/cost.ts
 function classify(total) {
   if (total < 1000)
@@ -608,7 +770,7 @@ var costCommand = defineCommand({
       console.log(`${cyan(r.name)}${namePad}  ${tokenCell}${tokenPad}${suffix}`);
     }
     console.log("");
-    console.log(`Total: ~${total} tok across ${rows.length} skills    ${paint(message)}`);
+    console.log(`Total: ~${total} tok across ${rows.length} skills    ${paint(message)}  ·  method: chars/4, yaml-frontmatter`);
   }
 });
 
@@ -634,7 +796,7 @@ function paintDisk(n) {
     return green(n.name);
   return cyan(n.name);
 }
-function bySource(records, roots) {
+function bySource(records, roots, lockLabel) {
   const claudeRecords = records.filter((r) => r.sources.includes(".claude"));
   const agentsRecords = records.filter((r) => r.sources.includes(".agents"));
   const lockRecords = records.filter((r) => r.sources.includes("lock"));
@@ -644,13 +806,18 @@ function bySource(records, roots) {
   return {
     agents: { label: ".agents/skills", names: agentsNames, totalCount: agentsNames.length },
     claude: { label: ".claude/skills", names: claudeNames, totalCount: claudeNames.length },
-    lock: { label: "skills-lock.json", names: lockNames, totalCount: lockNames.length }
+    lock: { label: lockLabel, names: lockNames, totalCount: lockNames.length }
   };
 }
 var listCommand = defineCommand({
   meta: { description: "List skills per source with install-type coloring and lock orphan filter" },
   args: {
-    global: { type: "boolean", alias: "g", default: false, description: "Use global scope" }
+    global: { type: "boolean", alias: "g", default: false, description: "Use global scope" },
+    names: {
+      type: "boolean",
+      default: false,
+      description: "Print one skill name per line (no header, no colors) — for completion scripts"
+    }
   },
   run({ args }) {
     const lockPath = getLockPath(args.global);
@@ -661,7 +828,21 @@ var listCommand = defineCommand({
       claude: rootFor(args.global, lockPath, ".claude"),
       agents: rootFor(args.global, lockPath, ".agents")
     };
-    const rows = bySource(records, roots);
+    const lockLabel = args.global ? ".agents/.skill-lock.json" : "skills-lock.json";
+    const rows = bySource(records, roots, lockLabel);
+    if (args.names) {
+      const all = new Set;
+      for (const n of rows.agents.names)
+        all.add(n.name);
+      for (const n of rows.claude.names)
+        all.add(n.name);
+      for (const n of rows.lock.names)
+        all.add(n.name);
+      for (const name of [...all].sort())
+        console.log(name);
+      return;
+    }
+    console.log(args.global ? "Global" : "Local");
     const claudeSet = new Set(rows.claude.names.map((n) => n.name));
     const agentsSet = new Set(rows.agents.names.map((n) => n.name));
     const orphans = rows.lock.names.filter((n) => !claudeSet.has(n.name) && !agentsSet.has(n.name));
@@ -676,7 +857,13 @@ var listCommand = defineCommand({
       },
       {
         row: rows.lock,
-        render: () => orphans.length === 0 ? green("All skills onboard!") : orphans.map((n) => red(n.name)).join(" ")
+        render: () => {
+          if (rows.lock.totalCount === 0)
+            return "";
+          if (orphans.length === 0)
+            return green("All skills onboard!");
+          return orphans.map((n) => red(n.name)).join(" ");
+        }
       }
     ];
     const labelWidth = Math.max(...sourceRows.map((r) => r.row.label.length));
@@ -847,17 +1034,28 @@ function fileCount(dir) {
   }
   return n;
 }
-function printPlan(plan, modifyLock) {
+function printPlan(plan, modifyLock, lockOnly) {
   const { target } = plan;
   console.log(`Will remove ${q(target.name)}:`);
   if (target.inLock) {
-    if (modifyLock)
+    if (lockOnly || modifyLock)
       console.log("  - skills-lock.json");
     else
       console.log("  - skills-lock.json (kept; use --force-lock to remove lock entry)");
   } else {
     console.log("  - skills-lock.json (not in lock)");
   }
+  if (lockOnly) {
+    if (target.claudeDir)
+      console.log(`  - .claude/skills/${target.name}/  (kept; --lock-only)`);
+    else
+      console.log("  - .claude/skills/  (not found)");
+    if (target.agentsDir)
+      console.log(`  - .agents/skills/${target.name}/  (kept; --lock-only)`);
+    else
+      console.log("  - .agents/skills/  (not found)");
+    return;
+  }
   if (target.claudeDir)
     console.log(`  - .claude/skills/${target.name}/  (${plan.claudeFileCount} files)`);
   else
@@ -880,10 +1078,26 @@ var removeCommand = defineCommand({
       type: "boolean",
       default: false,
       description: "Also remove entry from skills-lock.json (default is to keep lock untouched)"
+    },
+    "lock-only": {
+      type: "boolean",
+      default: false,
+      description: "Remove only the skills-lock.json entry; keep on-disk directories"
     }
   },
   async run({ args }) {
-    const { global: isGlobal, "dry-run": dryRun, yes, all, "force-lock": modifyLock } = args;
+    const {
+      global: isGlobal,
+      "dry-run": dryRun,
+      yes,
+      all,
+      "force-lock": modifyLock,
+      "lock-only": lockOnly
+    } = args;
+    if (lockOnly && modifyLock) {
+      console.error("--lock-only is mutually exclusive with --force-lock");
+      process.exit(1);
+    }
     const subcmdIdx = process.argv.findIndex((a) => a === "remove" || a === "rm");
     const names = process.argv.slice(subcmdIdx + 1).filter((a) => !a.startsWith("-"));
     if (all && names.length > 0) {
@@ -912,14 +1126,29 @@ var removeCommand = defineCommand({
       agentsFileCount: t.agentsDir ? fileCount(t.agentsDir) : undefined
     }));
     for (const p of plans) {
-      printPlan(p, modifyLock);
+      printPlan(p, modifyLock, lockOnly);
       console.log("");
     }
     if (dryRun)
       return;
-    if (!yes) {
-      const promptText = all ? `Remove ALL ${plans.length} skills?` : "Proceed?";
-      const ok = await confirm(promptText);
+    if (all) {
+      const subject = lockOnly ? `ALL ${plans.length} lock entries (disk preserved)` : `ALL ${plans.length} skills`;
+      const interactive = process.stdin.isTTY && process.stdout.isTTY;
+      if (interactive) {
+        const phrase = await promptText(`This will remove ${subject}. Type "all" to confirm:`);
+        if (phrase !== "all") {
+          console.log("Aborted");
+          process.exit(1);
+        }
+      } else if (!yes) {
+        const ok = await confirm(`Remove ${subject}?`);
+        if (!ok) {
+          console.log("Aborted");
+          process.exit(1);
+        }
+      }
+    } else if (!yes) {
+      const ok = await confirm("Proceed?");
       if (!ok) {
         console.log("Aborted");
         process.exit(1);
@@ -928,7 +1157,7 @@ var removeCommand = defineCommand({
     const allowedRoots = [isGlobal ? homedir2() : dirname2(resolve3(lockPath)), homedir2()];
     for (const { target } of plans) {
       if (target.inLock) {
-        if (modifyLock) {
+        if (lockOnly || modifyLock) {
           const r = removeSkillFromLock(lockPath, target.name);
           if (r.removed)
             console.log(`Removed ${q(target.name)} from skills-lock.json`);
@@ -938,6 +1167,17 @@ var removeCommand = defineCommand({
       } else {
         console.log(`Skipped skills-lock.json (not in lock)`);
       }
+      if (lockOnly) {
+        if (target.claudeDir)
+          console.log(`Kept .claude/skills/${target.name}/ (--lock-only)`);
+        else
+          console.log("Skipped .claude/skills (not found)");
+        if (target.agentsDir)
+          console.log(`Kept .agents/skills/${target.name}/ (--lock-only)`);
+        else
+          console.log("Skipped .agents/skills (not found)");
+        continue;
+      }
       if (target.claudeDir) {
         const r = rmSkillDir(target.claudeDir, { allowedRoots });
         console.log(`Removed ${q(target.name)} from .claude/skills (${r.fileCount} files)`);
@@ -1138,7 +1378,7 @@ function extractClaudeMentions(entry) {
     }
     for (const m of node.matchAll(/\bsuperpowers:([a-z0-9-]+)\b/g)) {
       if (m[1] !== undefined)
-        seen.add(`superpowers:${m[1]}`);
+        seen.add(m[1]);
     }
   });
   return [...seen];
@@ -1209,7 +1449,7 @@ function* findJsonlFiles(dir, since) {
 }
 function isRecentEntry(entry, since) {
   if (typeof entry !== "object" || entry === null)
-    return true;
+    return false;
   const e = entry;
   if (typeof e.timestamp === "string") {
     const d = new Date(e.timestamp);
@@ -1217,7 +1457,7 @@ function isRecentEntry(entry, since) {
   }
   if (typeof e.ts === "number")
     return new Date(e.ts * 1000) >= since;
-  return true;
+  return false;
 }
 
 // src/readers/claude.ts
@@ -1232,6 +1472,7 @@ function readClaudeUsage(options) {
     let prevSkill = null;
     const sessionAttr = new Map;
     const sessionAct = new Map;
+    const sessionMen = new Map;
     for (const line of readFileSync2(file, "utf8").split(`
 `)) {
       if (!line.trim())
@@ -1263,7 +1504,7 @@ function readClaudeUsage(options) {
       }
       if (options.mode === "mentions") {
         for (const skill of extractClaudeMentions(entry)) {
-          counts.set(skill, (counts.get(skill) ?? 0) + 1);
+          sessionMen.set(skill, (sessionMen.get(skill) ?? 0) + 1);
         }
       }
     }
@@ -1273,6 +1514,9 @@ function readClaudeUsage(options) {
     } else if (options.mode === "activations") {
       for (const [k, v] of sessionAct)
         counts.set(k, (counts.get(k) ?? 0) + v);
+    } else if (options.mode === "mentions") {
+      for (const [k, v] of sessionMen)
+        counts.set(k, (counts.get(k) ?? 0) + v);
     } else if (options.mode === "merged") {
       const keys = new Set([...sessionAttr.keys(), ...sessionAct.keys()]);
       for (const k of keys) {
@@ -1410,19 +1654,21 @@ var SECOND_MS = 1000;
 var MINUTE_MS = 60 * SECOND_MS;
 var HOUR_MS = 60 * MINUTE_MS;
 var DAY_MS = 24 * HOUR_MS;
+var MONTH_MS = 30 * DAY_MS;
 var UNITS_MS = {
   s: SECOND_MS,
   m: MINUTE_MS,
   h: HOUR_MS,
   d: DAY_MS,
-  w: 7 * DAY_MS
+  w: 7 * DAY_MS,
+  mo: MONTH_MS
 };
 function parsePeriod(period) {
   if (period === "all")
     return Number.POSITIVE_INFINITY;
-  const match = period.match(/^(\d+)([smhdw])$/);
+  const match = period.match(/^(\d+)(mo|[smhdw])$/);
   if (!match) {
-    throw new Error(`Invalid period: "${period}". Use values like 60s, 30m, 24h, 30d, 2w, all.`);
+    throw new Error(`Invalid period: "${period}". Use values like 60s, 30m, 24h, 30d, 2w, 6mo, all.`);
   }
   const unit = UNITS_MS[match[2] ?? ""] ?? 0;
   return Number(match[1]) * unit;
@@ -1433,7 +1679,8 @@ function pad(n, width) {
   return String(n).padStart(width);
 }
 function formatUsageRow(row) {
-  return `${pad(row.count, row.countWidth)} ${cyan(row.name)}`;
+  const suffix = row.installed === false ? ` ${red("(missing)")}` : "";
+  return `${pad(row.count, row.countWidth)} ${cyan(row.name)}${suffix}`;
 }
 function parseAgents(agent) {
   if (!agent)
@@ -1457,7 +1704,7 @@ var usageArgs = {
     type: "string",
     alias: "p",
     default: "all",
-    description: "60s, 30m, 24h, 30d, 2w, all"
+    description: "60s, 30m, 24h, 30d, 2w, 6mo, all"
   },
   since: { type: "string", description: "yyyy-mm-dd, overrides --period" },
   mode: {
@@ -1526,15 +1773,13 @@ async function runUsage(args) {
         name,
         count: counts.get(name) ?? 0,
         tokens: rec?.frontmatterTokens,
-        status: rec?.status ?? "ok"
+        installed: rec !== undefined && rec.status !== "missing"
       };
     });
     const rows = allRows.filter((r) => r.count > 0);
     rows.sort((a, b) => {
-      const aOk = a.status === "ok";
-      const bOk = b.status === "ok";
-      if (aOk !== bOk)
-        return aOk ? -1 : 1;
+      if (a.installed !== b.installed)
+        return a.installed ? -1 : 1;
       if (b.count !== a.count)
         return b.count - a.count;
       return a.name.localeCompare(b.name);
@@ -1550,7 +1795,8 @@ async function runUsage(args) {
         skill: r.name,
         count: r.count,
         tokensPerSkill: r.tokens ?? null,
-        consumption: (r.tokens ?? 0) * r.count
+        consumption: (r.tokens ?? 0) * r.count,
+        installed: r.installed
       }))
     }));
     console.log(JSON.stringify(output.length === 1 ? output[0] : output, null, 2));
@@ -1569,7 +1815,7 @@ async function runUsage(args) {
       continue;
     const countWidth = Math.max(...rows.map((r) => String(r.count).length));
     for (const r of rows) {
-      console.log(formatUsageRow({ count: r.count, name: r.name, countWidth }));
+      console.log(formatUsageRow({ count: r.count, name: r.name, countWidth, installed: r.installed }));
       distinct.add(r.name);
     }
     grandActivations += activations;
@@ -1720,7 +1966,8 @@ var SUBCOMMAND_NAMES = new Set([
   "cst",
   "usage",
   "us",
-  "usg"
+  "usg",
+  "completion"
 ]);
 function reorderRootFlagsToSubcommand(argv) {
   const tail = argv.slice(2);
@@ -1746,15 +1993,16 @@ function printRootHelp() {
     "  -h, --help       Show this help and exit",
     "  -v, --version    Show version and exit",
     "  -g, --global     Use global scope (default: false)",
-    "  -p, --period     Period for `usage`: 60s, 30m, 24h, 30d, 2w, all (default: all)",
+    "  -p, --period     Period for `usage`: 60s, 30m, 24h, 30d, 2w, 6mo, all (default: all)",
     "  -a, --agent      Agent for `usage`: claude-code, codex (default: both)",
     "",
     "COMMANDS",
     "",
-    "  list, ls         List skills per source with totals and lock-vs-disk diff",
-    "  remove, rm       Remove skills from lock and delete their on-disk dirs",
+    "  list, ls         List skills per source: install type, lock orphans, disk/lock diff",
+    "  remove, rm       Delete on-disk skill dirs; lock kept unless --force-lock",
     "  cost, co, cst    Show ambient ballast cost (per-skill frontmatter tokens) sorted desc",
-    "  usage, us, usg   Show skill usage × cost (consumption) with missed rows"
+    "  usage, us, usg   Show skill usage × cost (consumption) with missed rows",
+    "  completion       Print shell completion script (bash, zsh, fish)"
   ];
   console.log(lines.join(`
 `));
@@ -1766,6 +2014,44 @@ function isRootHelp(argv) {
     return false;
   return args.includes("--help") || args.includes("-h");
 }
+function isRemoveHelp(argv) {
+  const args = argv.slice(2);
+  const first = args[0];
+  if (first !== "remove" && first !== "rm")
+    return false;
+  return args.includes("--help") || args.includes("-h");
+}
+function printRemoveHelp() {
+  const lines = [
+    "Remove skills from on-disk dirs (lock preserved unless --force-lock).",
+    "",
+    "USAGE skillio remove [SKILL...] [OPTIONS]",
+    "       skillio rm [SKILL...] [OPTIONS]",
+    "",
+    "ARGUMENTS",
+    "",
+    "  SKILL...         One or more skill names. Use --all to target every skill in scope.",
+    "",
+    "OPTIONS",
+    "",
+    "  -g, --global     Use global scope (default: false)",
+    "      --all        Remove every skill in scope (mutually exclusive with SKILL)",
+    "      --dry-run    Print plan without deleting",
+    "  -y, --yes        Skip confirmation prompt (non-TTY only for --all)",
+    "      --force-lock Also remove entry from skills-lock.json (default: lock preserved)",
+    "      --lock-only  Remove only the lock entry; keep on-disk directories",
+    "",
+    "EXAMPLES",
+    "",
+    "  skillio rm brainstorming",
+    "  skillio rm brainstorming writing-plans --yes",
+    "  skillio rm --all --dry-run",
+    "  skillio rm --force-lock obsolete-skill",
+    "  skillio rm --lock-only stale-entry"
+  ];
+  console.log(lines.join(`
+`));
+}
 function firstPositional(argv) {
   for (let i = 2;i < argv.length; i++) {
     const tok = argv[i];
@@ -1811,7 +2097,7 @@ var main = defineCommand({
       return;
     const interactive = process.stdout.isTTY && process.stdin.isTTY;
     if (interactive) {
-      const { runPicker } = await import("./shared/chunk-j9jc4e4c.js");
+      const { runPicker } = await import("./shared/chunk-ajnqh9j9.js");
       const status = await runPicker({
         global: args.global ?? false
       });
@@ -1833,7 +2119,8 @@ var main = defineCommand({
     cst: costCommand,
     usage: usageCommand,
     us: usageCommand,
-    usg: usageCommand
+    usg: usageCommand,
+    completion: completionCommand
   }
 });
 (async () => {
@@ -1841,6 +2128,10 @@ var main = defineCommand({
     printRootHelp();
     return;
   }
+  if (isRemoveHelp(process.argv)) {
+    printRemoveHelp();
+    return;
+  }
   if (isRootVersion(process.argv)) {
     console.log(version);
     return;