@spader/dotllm 1.2.0 → 1.2.3

package/README.md

@@ -1,4 +1,20 @@
-# motivation
+# dotllm
+`dotllm` manages a system-wide cache of commonly referenced repositories and provides a beautiful command line for linking them anywhere on your system
+
+```bash
+> tree .llm/reference/
+```
+
+```
+.llm/reference/
+├── cloudflare-docs -> /home/spader/.local/share/dotllm/store/cloudflare-docs
+├── cuda-toolkit -> /home/spader/.local/share/dotllm/store/cuda-toolkit
+├── ghostty -> /home/spader/.local/share/dotllm/store/ghostty
+├── node-llama-cpp -> /home/spader/.local/share/dotllm/store/node-llama-cpp
+├── opencode -> /home/spader/.local/share/dotllm/store/opencode
+└── sprites-docs -> /home/spader/.local/share/dotllm/store/sprites-docs
+```
+
 LLMs work best with references. If you're like me, every project has loose repositories lying around half a dozen places because some LLM needed it.
 
 Instead, keep a cache of such repositories and use `dotllm` to link them to `.llm`. Check in `.llm/dotllm.json`, and a simple `dotllm sync` will restore all of your references.
@@ -9,7 +25,7 @@ bun install -g @spader/dotllm
 ```
 
 # usage
-Register a repository (by HTTPS, SSH, or path)
+Register a repository (by HTTPS, SSH, or local path)
 ```bash
 dotllm add https://github.com/tspader/dotllm.git
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spader/dotllm",
-  "version": "1.2.0",
+  "version": "1.2.3",
   "description": "A simple CLI to clone, manage, and link repositories for LLM reference",
   "type": "module",
   "repository": {

package/src/cli/commands/add.js

@@ -35,20 +35,42 @@ function stem(value) {
   return base;
 }
 function github(uri) {
-  const https = uri.match(/^https?:\/\/github\.com\/([^/]+)\/([^/]+?)(?:\.git)?\/?$/);
+  return hosted(uri, "github.com");
+}
+function codeberg(uri) {
+  return hosted(uri, "codeberg.org");
+}
+function hosted(uri, host) {
+  const escaped = host.replace(/\./g, "\\.");
+  const https = uri.match(new RegExp(`^https?:\\/\\/${escaped}\\/([^/]+)\\/([^/]+?)(?:\\.git)?\\/?$`));
   if (https) {
     return { owner: https[1], repo: https[2] };
   }
-  const ssh = uri.match(/^ssh:\/\/git@github\.com\/([^/]+)\/([^/]+?)(?:\.git)?\/?$/);
+  const ssh = uri.match(new RegExp(`^ssh:\\/\\/git@${escaped}\\/([^/]+)\\/([^/]+?)(?:\\.git)?\\/?$`));
   if (ssh) {
     return { owner: ssh[1], repo: ssh[2] };
   }
-  const scp = uri.match(/^git@github\.com:([^/]+)\/([^/]+?)(?:\.git)?$/);
+  const scp = uri.match(new RegExp(`^git@${escaped}:([^/]+)\\/([^/]+?)(?:\\.git)?$`));
   if (scp) {
     return { owner: scp[1], repo: scp[2] };
   }
   return null;
 }
+async function apiDescription(url, accept) {
+  const response = await fetch(url, {
+    headers: {
+      accept,
+      "user-agent": "dotllm"
+    }
+  });
+  if (!response.ok)
+    return "";
+  const raw = await response.json();
+  const result = RepoShape.safeParse(raw);
+  if (!result.success)
+    return "";
+  return result.data.description ?? "";
+}
 function gitName(uri) {
   const dir = path.resolve(uri);
   if (!fs.existsSync(dir))
@@ -68,23 +90,17 @@ function gitName(uri) {
   return stem(out);
 }
 async function remoteDescription(uri) {
-  const repo = github(uri);
-  if (!repo)
-    return "";
-  const url = `https://api.github.com/repos/${repo.owner}/${repo.repo}`;
-  const response = await fetch(url, {
-    headers: {
-      accept: "application/vnd.github+json",
-      "user-agent": "dotllm"
-    }
-  });
-  if (!response.ok)
-    return "";
-  const raw = await response.json();
-  const result = RepoShape.safeParse(raw);
-  if (!result.success)
-    return "";
-  return result.data.description ?? "";
+  const gh = github(uri);
+  if (gh) {
+    const url = `https://api.github.com/repos/${gh.owner}/${gh.repo}`;
+    return apiDescription(url, "application/vnd.github+json");
+  }
+  const cb = codeberg(uri);
+  if (cb) {
+    const url = `https://codeberg.org/api/v1/repos/${cb.owner}/${cb.repo}`;
+    return apiDescription(url, "application/json");
+  }
+  return "";
 }
 async function prefill(uri) {
   const remote = isUrl(uri);
@@ -181,5 +197,6 @@ var command = {
 export {
   stem,
   github,
-  command
+  command,
+  codeberg
 };

package/src/cli/index.js

@@ -6,25 +6,28 @@ import { build } from "@spader/dotllm/cli/yargs";
 import { add, remove, list, link, sync, which, cd } from "@spader/dotllm/cli/commands/index";
 var DotLlmCli;
 ((DotLlmCli) => {
-  DotLlmCli.def = {
-    name: "dotllm",
-    description: "Manage git repo references symlinked into .llm/reference/",
-    commands: {
-      add,
-      remove,
-      list,
-      link,
-      sync,
-      which,
-      cd
-    }
-  };
-  function run() {
-    build(DotLlmCli.def).parse();
+  async function run() {
+    const raw = await Bun.file(new URL("../../package.json", import.meta.url)).json();
+    const version = typeof raw.version === "string" ? raw.version : undefined;
+    const def = {
+      name: "dotllm",
+      description: "Manage git repo references symlinked into .llm/reference/",
+      version,
+      commands: {
+        add,
+        remove,
+        list,
+        link,
+        sync,
+        which,
+        cd
+      }
+    };
+    build(def).parse();
   }
   DotLlmCli.run = run;
 })(DotLlmCli ||= {});
-DotLlmCli.run();
+await DotLlmCli.run();
 export {
   DotLlmCli
 };

package/src/cli/yargs.js

@@ -58,6 +58,9 @@ function help(def, name, path = [], t = defaultTheme) {
     ...def.options ?? {},
     help: { alias: "h", type: "boolean", description: "Show help" }
   };
+  if ("version" in def && def.version) {
+    opts.version = { alias: "v", type: "boolean", description: "Show version" };
+  }
   if (Object.keys(opts).length > 0) {
     if (prev)
       console.log("");
@@ -145,6 +148,9 @@ function configure(y, def, root, path) {
     y.demandCommand(1, "You must specify a command");
   }
   y.help(false).option("help", { alias: "h", type: "boolean", describe: "Show help" }).check(check(def, root, path)).fail(fail(def, root, path));
+  if (path.length === 0 && "version" in def && def.version) {
+    y.version(def.version).alias("version", "v");
+  }
 }
 function command(y, name, def, root, path) {
   let cmd = name;