skilllib 1.11.2 → 1.11.4

package/dist/index.js

@@ -30,7 +30,7 @@ import {
   unhide,
   update,
   usage
-} from "./chunk-OFWHWIER.js";
+} from "./chunk-CS6T66EE.js";
 
 // src/index.ts
 import { readFileSync } from "fs";
@@ -91,33 +91,69 @@ function packageVersion() {
     return "unknown";
   }
 }
+var FLAGS_OF = {
+  "": ["days"],
+  ui: [],
+  status: ["days"],
+  add: ["force", "allow-tracked"],
+  remove: ["force"],
+  sync: ["all", "force"],
+  update: ["all", "force", "allow-tracked"],
+  outdated: ["all"],
+  list: ["days"],
+  show: [],
+  import: ["force", "global"],
+  scan: [],
+  projects: [],
+  link: ["all", "allow-tracked"],
+  tidy: ["all", "global", "dry-run", "allow-git", "keep"],
+  harnesses: [],
+  folders: [],
+  unhide: [],
+  new: [],
+  global: ["allow-tracked", "to"],
+  restore: [],
+  doctor: ["fix", "days"],
+  apply: ["days"],
+  usage: ["days"],
+  "agent-skill": [],
+  version: [],
+  help: []
+};
+var NO_ARGS = /* @__PURE__ */ new Set(["", "ui", "status", "outdated", "list", "projects", "link", "doctor", "usage", "version"]);
 async function main() {
-  const [command, ...rest] = process.argv.slice(2);
-  setJsonMode(rest.includes("--json"));
+  const argv = process.argv.slice(2);
+  setJsonMode(argv.includes("--json"));
+  let at = 0;
+  while (argv[at]?.startsWith("--") && !["--version", "--help"].includes(argv[at])) at += ["--days", "--keep", "--to"].includes(argv[at]) ? 2 : 1;
+  const command = argv[at];
+  const rest = [...argv.slice(0, at), ...argv.slice(at + 1)];
   const args = parseArgs(rest);
+  const takes = FLAGS_OF[command ?? ""];
+  const flagOf = (a) => a.slice(2).split("=")[0];
+  const wrong = takes ? rest.filter((a) => a.startsWith("--") && flagOf(a) !== "json" && !takes.includes(flagOf(a))) : [];
+  if (wrong.length) throw new Error(`skilllib${command ? ` ${command}` : ""} doesn't take ${wrong.join(", ")}`);
+  if (NO_ARGS.has(command ?? "") && args.positional.length) throw new Error(`skilllib${command ? ` ${command}` : ""} doesn't take ${args.positional.join(" ")}`);
   if (!["--version", "-v", "version", "help", "--help", "-h"].includes(command ?? "")) refreshAgentSkill();
   switch (command) {
     case void 0:
-      return process.stdin.isTTY && process.stdout.isTTY ? (await import("./tui-NGTOOVAQ.js")).tui() : overview(args);
+      return process.stdin.isTTY && process.stdout.isTTY ? (await import("./tui-BDLJOMSC.js")).tui() : overview(args);
     case "ui":
       if (!process.stdin.isTTY || !process.stdout.isTTY) throw new Error("`skilllib ui` needs an interactive terminal. Agents and scripts: use `skilllib status --json`.");
-      return (await import("./tui-NGTOOVAQ.js")).tui();
+      return (await import("./tui-BDLJOMSC.js")).tui();
     case "status":
       return status(args);
     case "add":
       return add(args);
     case "remove":
-    case "rm":
       return remove(args);
     case "sync":
       return sync(args);
     case "update":
-    case "upgrade":
       return update(args);
     case "outdated":
       return outdated(args);
     case "list":
-    case "ls":
       return list(args);
     case "show":
       return show(args);
@@ -130,18 +166,14 @@ async function main() {
     case "link":
       return link(args);
     case "tidy":
-    case "dedup":
       return tidy(args);
     case "harnesses":
-    case "agents":
       return harnessesCommand(args);
     case "folders":
-    case "roots":
       return folders(args);
     case "unhide":
       return unhide(args);
     case "new":
-    case "create":
       return newSkill(args);
     case "global":
       return globalCommand(args);
@@ -158,7 +190,7 @@ async function main() {
     case "--version":
     case "-v":
     case "version":
-      console.log(packageVersion());
+      console.log(isJsonMode() ? JSON.stringify(packageVersion()) : packageVersion());
       return;
     case "help":
     case "--help":

package/dist/json.d.cts

@@ -11,11 +11,17 @@ type AgentSkillState = "installed" | "outdated" | "missing";
  */
 type GitState = "committed" | "changed" | "new" | "ignored";
 
-type SkillState = "ok" | "update available" | "edited locally" | "edited locally, update available" | "folder missing" | "not in library" | "untracked copy of library skill" | "untracked, differs from library" | "local only" | "repo skill" | "repo skill, in library" | "repo skill, differs from library" | "from npx skills";
+type SkillState = "ok" | "update available" | "edited locally" | "edited locally, update available"
+/** The copy is another version from your library than the one skilllib.json pins (after a pull, say): sync installs the pinned one. */
+ | "out of sync" | "folder missing" | "not in library" | "untracked copy of library skill" | "untracked, differs from library" | "local only" | "repo skill" | "repo skill, in library" | "repo skill, differs from library" | "from npx skills";
 type Change = {
     name: string;
-    /** reset: back to the version it had; its local edits were overwritten (and backed up, see `backedUp`). */
-    action: "installed" | "updated" | "reset" | "removed" | "skipped";
+    /**
+     * reset: back to the version it had; its local edits were overwritten (and backed up, see `backedUp`).
+     * relinked: the copy was as pinned; only the links skilllib.json records were put back.
+     * unchanged: it was already as asked (same version, same links): nothing was written.
+     */
+    action: "installed" | "updated" | "reset" | "relinked" | "unchanged" | "removed" | "skipped";
     reason?: string;
     from?: number;
     to?: number;
@@ -23,6 +29,8 @@ type Change = {
     blocked?: string[];
     /** Harness folders git tracks, left without a link because git doesn't share the real copy (teammates would get a broken link). */
     uncommitted?: string[];
+    /** What kept a link out (a file or another copy where it goes): an agent can't use the skill there. */
+    inTheWay?: string[];
     /** Where overwritten local edits went (~/.skilllib/edit-backup/…); `skilllib restore` puts them back. */
     backedUp?: string;
 };
@@ -33,7 +41,7 @@ type Change = {
  * - skills.sh: a symlink into ~/.agents/skills, installed by `npx skills`
  * - claude.ai: synced from your claude.ai account
  * - plugin: shipped inside an enabled Claude Code plugin
- * - built-in: bundled with an agent (Cursor's ~/.cursor/skills-cursor, Grok's ~/.grok/bundled/skills)
+ * - built-in: bundled with an agent (Cursor's ~/.cursor/skills-cursor, Codex's ~/.codex/skills/.system, Grok's ~/.grok/bundled/skills)
  * - system: a machine-wide folder an admin manages (/etc/codex/skills)
  * - skilllib: skilllib's own skill, which `skilllib agent-skill install` puts in your global folders
  */
@@ -41,7 +49,7 @@ type SourceKind = "global" | "skills.sh" | "claude.ai" | "plugin" | "built-in" |
 
 /**
  * - library: added from your skills with skilllib (pinned in skilllib.json)
- * - repo:    the team's: committed to git (any skill folder), or in .agents/skills
+ * - repo:    the team's: committed to git (any skill folder), or in .agents/skills or .grok/skills
  * - local:   only on this machine: not committed, not managed by skilllib
  */
 type ProjectSource = "library" | "repo" | "local";
@@ -52,7 +60,7 @@ type StatusSkillGroup = {
     /** Folder with the real copy, when it isn't .claude/skills. */
     dir?: string;
     version?: number;
-    /** Only when it isn't "ok". */
+    /** Only when it isn't the usual one: "ok", "local only", or a repo skill's. */
     state?: SkillState;
     /** Newer library version, when there is one. */
     latest?: number;
@@ -170,7 +178,10 @@ type DoctorJson = {
     detail: string;
     /** A safe repair; `doctor --fix` runs it. */
     fix?: string;
-    /** Fixes that need a decision: `skilllib apply <id> <n>` runs the nth (from 1). */
+    /**
+     * Fixes that need a decision: `skilllib apply <id> <n>` runs the nth (from 1). An issue that spans repos can list
+     * other choices inside one (status there), and then apply takes only the label: `skilllib apply <id> "<label>"`.
+     */
     choices?: string[];
     /** With --fix: what running `fix` did. */
     fixed?: {
@@ -195,6 +206,8 @@ type GlobalMoveJson = {
     /** Added to every repo and no longer global. When false, it still loads globally and `reason` says why. */
     moved: boolean;
     reason?: string;
+    /** Links in a repo's packages now pointing at nothing (the repo's own copy serves them): remove them. */
+    left?: string[];
     projects: {
         project: string;
         path: string;

package/dist/json.d.ts

@@ -11,11 +11,17 @@ type AgentSkillState = "installed" | "outdated" | "missing";
  */
 type GitState = "committed" | "changed" | "new" | "ignored";
 
-type SkillState = "ok" | "update available" | "edited locally" | "edited locally, update available" | "folder missing" | "not in library" | "untracked copy of library skill" | "untracked, differs from library" | "local only" | "repo skill" | "repo skill, in library" | "repo skill, differs from library" | "from npx skills";
+type SkillState = "ok" | "update available" | "edited locally" | "edited locally, update available"
+/** The copy is another version from your library than the one skilllib.json pins (after a pull, say): sync installs the pinned one. */
+ | "out of sync" | "folder missing" | "not in library" | "untracked copy of library skill" | "untracked, differs from library" | "local only" | "repo skill" | "repo skill, in library" | "repo skill, differs from library" | "from npx skills";
 type Change = {
     name: string;
-    /** reset: back to the version it had; its local edits were overwritten (and backed up, see `backedUp`). */
-    action: "installed" | "updated" | "reset" | "removed" | "skipped";
+    /**
+     * reset: back to the version it had; its local edits were overwritten (and backed up, see `backedUp`).
+     * relinked: the copy was as pinned; only the links skilllib.json records were put back.
+     * unchanged: it was already as asked (same version, same links): nothing was written.
+     */
+    action: "installed" | "updated" | "reset" | "relinked" | "unchanged" | "removed" | "skipped";
     reason?: string;
     from?: number;
     to?: number;
@@ -23,6 +29,8 @@ type Change = {
     blocked?: string[];
     /** Harness folders git tracks, left without a link because git doesn't share the real copy (teammates would get a broken link). */
     uncommitted?: string[];
+    /** What kept a link out (a file or another copy where it goes): an agent can't use the skill there. */
+    inTheWay?: string[];
     /** Where overwritten local edits went (~/.skilllib/edit-backup/…); `skilllib restore` puts them back. */
     backedUp?: string;
 };
@@ -33,7 +41,7 @@ type Change = {
  * - skills.sh: a symlink into ~/.agents/skills, installed by `npx skills`
  * - claude.ai: synced from your claude.ai account
  * - plugin: shipped inside an enabled Claude Code plugin
- * - built-in: bundled with an agent (Cursor's ~/.cursor/skills-cursor, Grok's ~/.grok/bundled/skills)
+ * - built-in: bundled with an agent (Cursor's ~/.cursor/skills-cursor, Codex's ~/.codex/skills/.system, Grok's ~/.grok/bundled/skills)
  * - system: a machine-wide folder an admin manages (/etc/codex/skills)
  * - skilllib: skilllib's own skill, which `skilllib agent-skill install` puts in your global folders
  */
@@ -41,7 +49,7 @@ type SourceKind = "global" | "skills.sh" | "claude.ai" | "plugin" | "built-in" |
 
 /**
  * - library: added from your skills with skilllib (pinned in skilllib.json)
- * - repo:    the team's: committed to git (any skill folder), or in .agents/skills
+ * - repo:    the team's: committed to git (any skill folder), or in .agents/skills or .grok/skills
  * - local:   only on this machine: not committed, not managed by skilllib
  */
 type ProjectSource = "library" | "repo" | "local";
@@ -52,7 +60,7 @@ type StatusSkillGroup = {
     /** Folder with the real copy, when it isn't .claude/skills. */
     dir?: string;
     version?: number;
-    /** Only when it isn't "ok". */
+    /** Only when it isn't the usual one: "ok", "local only", or a repo skill's. */
     state?: SkillState;
     /** Newer library version, when there is one. */
     latest?: number;
@@ -170,7 +178,10 @@ type DoctorJson = {
     detail: string;
     /** A safe repair; `doctor --fix` runs it. */
     fix?: string;
-    /** Fixes that need a decision: `skilllib apply <id> <n>` runs the nth (from 1). */
+    /**
+     * Fixes that need a decision: `skilllib apply <id> <n>` runs the nth (from 1). An issue that spans repos can list
+     * other choices inside one (status there), and then apply takes only the label: `skilllib apply <id> "<label>"`.
+     */
     choices?: string[];
     /** With --fix: what running `fix` did. */
     fixed?: {
@@ -195,6 +206,8 @@ type GlobalMoveJson = {
     /** Added to every repo and no longer global. When false, it still loads globally and `reason` says why. */
     moved: boolean;
     reason?: string;
+    /** Links in a repo's packages now pointing at nothing (the repo's own copy serves them): remove them. */
+    left?: string[];
     projects: {
         project: string;
         path: string;