skilllib 1.11.1 → 1.11.3

package/dist/index.js

@@ -9,6 +9,8 @@ import {
   globalCommand,
   harnessesCommand,
   importSkills,
+  isJsonMode,
+  json,
   link,
   list,
   newSkill,
@@ -28,7 +30,7 @@ import {
   unhide,
   update,
   usage
-} from "./chunk-LO4FMXDE.js";
+} from "./chunk-3XDWEHI4.js";
 
 // src/index.ts
 import { readFileSync } from "fs";
@@ -89,34 +91,67 @@ function packageVersion() {
     return "unknown";
   }
 }
+var FLAGS_OF = {
+  "": ["days"],
+  ui: [],
+  status: ["days"],
+  add: ["force", "allow-tracked"],
+  remove: ["force"],
+  sync: ["all", "force", "allow-tracked"],
+  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: []
+};
 async function main() {
-  const [command, ...rest] = process.argv.slice(2);
+  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);
-  setJsonMode(args.json);
+  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 (!["--version", "-v", "version", "help", "--help", "-h"].includes(command ?? "")) refreshAgentSkill();
   switch (command) {
     case void 0:
-      return process.stdin.isTTY && process.stdout.isTTY ? (await import("./tui-3LDZ5GOZ.js")).tui() : overview(args);
+      return process.stdin.isTTY && process.stdout.isTTY ? (await import("./tui-WSHQRBPF.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-3LDZ5GOZ.js")).tui();
+      return (await import("./tui-WSHQRBPF.js")).tui();
     case "status":
       return status(args);
     case "add":
       return add(args);
     case "remove":
-    case "rm":
       return remove(args);
     case "sync":
-    case "install":
       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);
@@ -129,18 +164,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);
@@ -157,7 +188,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":
@@ -165,6 +196,7 @@ async function main() {
       console.log(HELP);
       return;
     default:
+      if (isJsonMode()) throw new Error(`Unknown command: ${command} (skilllib help lists them)`);
       console.error(`Unknown command: ${command}
 `);
       console.log(HELP);
@@ -172,7 +204,9 @@ async function main() {
   }
 }
 main().catch((err) => {
-  error(err instanceof Error ? err.message : String(err));
+  const message = err instanceof Error ? err.message : String(err);
+  if (isJsonMode()) json("error", { error: message });
+  error(message);
   if (process.env.DEBUG && err instanceof Error) console.error(err.stack);
   process.exit(1);
 });

package/dist/json.d.cts

@@ -15,7 +15,8 @@ type SkillState = "ok" | "update available" | "edited locally" | "edited locally
 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";
+    /** relinked: the copy was as pinned; only the links skilllib.json records were put back. */
+    action: "installed" | "updated" | "reset" | "relinked" | "removed" | "skipped";
     reason?: string;
     from?: number;
     to?: number;
@@ -178,6 +179,10 @@ type DoctorJson = {
         message: string;
     };
 }[];
+/** Any command with --json that fails: it exits 1, and this is the one line on stdout. */
+type ErrorJson = {
+    error: string;
+};
 /** `skilllib apply <issue-id> [choice] --json` */
 type ApplyJson = {
     id: string;
@@ -219,4 +224,4 @@ type AgentSkillJson = {
     removed?: string[];
 };
 
-export type { AgentSkillJson, AgentSkillState, AllChangesJson, ApplyJson, ChangeJson, ChangesJson, DoctorJson, GitState, GlobalMoveJson, HarnessId, ImportJson, ListJson, OutdatedJson, ProjectSource, ProjectsJson, ShowJson, SkillState, SourceKind, StatusGlobalGroup, StatusIssue, StatusJson, StatusSkillGroup, UsageJson };
+export type { AgentSkillJson, AgentSkillState, AllChangesJson, ApplyJson, ChangeJson, ChangesJson, DoctorJson, ErrorJson, GitState, GlobalMoveJson, HarnessId, ImportJson, ListJson, OutdatedJson, ProjectSource, ProjectsJson, ShowJson, SkillState, SourceKind, StatusGlobalGroup, StatusIssue, StatusJson, StatusSkillGroup, UsageJson };

package/dist/json.d.ts

@@ -15,7 +15,8 @@ type SkillState = "ok" | "update available" | "edited locally" | "edited locally
 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";
+    /** relinked: the copy was as pinned; only the links skilllib.json records were put back. */
+    action: "installed" | "updated" | "reset" | "relinked" | "removed" | "skipped";
     reason?: string;
     from?: number;
     to?: number;
@@ -178,6 +179,10 @@ type DoctorJson = {
         message: string;
     };
 }[];
+/** Any command with --json that fails: it exits 1, and this is the one line on stdout. */
+type ErrorJson = {
+    error: string;
+};
 /** `skilllib apply <issue-id> [choice] --json` */
 type ApplyJson = {
     id: string;
@@ -219,4 +224,4 @@ type AgentSkillJson = {
     removed?: string[];
 };
 
-export type { AgentSkillJson, AgentSkillState, AllChangesJson, ApplyJson, ChangeJson, ChangesJson, DoctorJson, GitState, GlobalMoveJson, HarnessId, ImportJson, ListJson, OutdatedJson, ProjectSource, ProjectsJson, ShowJson, SkillState, SourceKind, StatusGlobalGroup, StatusIssue, StatusJson, StatusSkillGroup, UsageJson };
+export type { AgentSkillJson, AgentSkillState, AllChangesJson, ApplyJson, ChangeJson, ChangesJson, DoctorJson, ErrorJson, GitState, GlobalMoveJson, HarnessId, ImportJson, ListJson, OutdatedJson, ProjectSource, ProjectsJson, ShowJson, SkillState, SourceKind, StatusGlobalGroup, StatusIssue, StatusJson, StatusSkillGroup, UsageJson };