skilllib 1.11.3 → 1.11.5

package/dist/index.js

@@ -1,5 +1,6 @@
 #!/usr/bin/env node
 import {
+  VALUE_FLAGS,
   add,
   agentSkill,
   apply,
@@ -30,7 +31,7 @@ import {
   unhide,
   update,
   usage
-} from "./chunk-3XDWEHI4.js";
+} from "./chunk-TE2EDZ7L.js";
 
 // src/index.ts
 import { readFileSync } from "fs";
@@ -97,7 +98,7 @@ var FLAGS_OF = {
   status: ["days"],
   add: ["force", "allow-tracked"],
   remove: ["force"],
-  sync: ["all", "force", "allow-tracked"],
+  sync: ["all", "force"],
   update: ["all", "force", "allow-tracked"],
   outdated: ["all"],
   list: ["days"],
@@ -120,11 +121,12 @@ var FLAGS_OF = {
   version: [],
   help: []
 };
+var NO_ARGS = /* @__PURE__ */ new Set(["", "ui", "status", "outdated", "list", "projects", "link", "doctor", "usage", "version"]);
 async function main() {
   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;
+  while (argv[at]?.startsWith("--") && !["--version", "--help"].includes(argv[at])) at += VALUE_FLAGS.includes(argv[at]) ? 2 : 1;
   const command = argv[at];
   const rest = [...argv.slice(0, at), ...argv.slice(at + 1)];
   const args = parseArgs(rest);
@@ -132,13 +134,14 @@ async function main() {
   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-WSHQRBPF.js")).tui() : overview(args);
+      return process.stdin.isTTY && process.stdout.isTTY ? (await import("./tui-GFQUHPEC.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-WSHQRBPF.js")).tui();
+      return (await import("./tui-GFQUHPEC.js")).tui();
     case "status":
       return status(args);
     case "add":

package/dist/json.d.cts

@@ -11,12 +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`). */
-    /** relinked: the copy was as pinned; only the links skilllib.json records were put back. */
-    action: "installed" | "updated" | "reset" | "relinked" | "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;
@@ -24,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;
 };
@@ -34,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
  */
@@ -42,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";
@@ -53,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;
@@ -171,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?: {
@@ -196,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,12 +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`). */
-    /** relinked: the copy was as pinned; only the links skilllib.json records were put back. */
-    action: "installed" | "updated" | "reset" | "relinked" | "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;
@@ -24,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;
 };
@@ -34,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
  */
@@ -42,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";
@@ -53,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;
@@ -171,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?: {
@@ -196,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;