akm-cli 0.0.18 → 0.0.19

package/dist/common.js

@@ -147,6 +147,12 @@ export async function fetchWithTimeout(url, opts, timeoutMs = 30_000) {
     try {
         return await fetch(url, { ...opts, signal: controller.signal });
     }
+    catch (err) {
+        if (err instanceof DOMException && err.name === "AbortError") {
+            throw new Error(`Request timed out after ${timeoutMs}ms: ${url}`);
+        }
+        throw err;
+    }
     finally {
         clearTimeout(timer);
     }

package/dist/db.js

@@ -180,6 +180,15 @@ export function upsertEntry(db, entryKey, dirPath, filePath, stashDir, entry, se
 }
 export function deleteEntriesByDir(db, dirPath) {
     const ids = db.prepare("SELECT id FROM entries WHERE dir_path = ?").all(dirPath);
+    deleteRelatedRows(db, ids);
+    db.prepare("DELETE FROM entries WHERE dir_path = ?").run(dirPath);
+}
+export function deleteEntriesByStashDir(db, stashDir) {
+    const ids = db.prepare("SELECT id FROM entries WHERE stash_dir = ?").all(stashDir);
+    deleteRelatedRows(db, ids);
+    db.prepare("DELETE FROM entries WHERE stash_dir = ?").run(stashDir);
+}
+function deleteRelatedRows(db, ids) {
     for (const { id } of ids) {
         try {
             db.prepare("DELETE FROM embeddings WHERE id = ?").run(id);
@@ -196,7 +205,6 @@ export function deleteEntriesByDir(db, dirPath) {
             }
         }
     }
-    db.prepare("DELETE FROM entries WHERE dir_path = ?").run(dirPath);
 }
 export function rebuildFts(db) {
     db.exec("DELETE FROM entries_fts");

package/dist/indexer.js

@@ -1,7 +1,7 @@
 import fs from "node:fs";
 import path from "node:path";
 import { resolveStashDir } from "./common";
-import { closeDatabase, DB_VERSION, deleteEntriesByDir, getEntriesByDir, getEntryCount, getMeta, isVecAvailable, openDatabase, rebuildFts, setMeta, upsertEmbedding, upsertEntry, warnIfVecMissing, } from "./db";
+import { closeDatabase, DB_VERSION, deleteEntriesByDir, deleteEntriesByStashDir, getEntriesByDir, getEntryCount, getMeta, isVecAvailable, openDatabase, rebuildFts, setMeta, upsertEmbedding, upsertEntry, warnIfVecMissing, } from "./db";
 import { generateMetadataFlat, loadStashFile } from "./metadata";
 import { getDbPath } from "./paths";
 import { walkStashFlat } from "./walker";
@@ -45,6 +45,20 @@ export async function agentikitIndex(options) {
             db.exec("DELETE FROM entries_fts");
             db.exec("DELETE FROM entries");
         }
+        else {
+            // Incremental: purge entries from stash dirs that have been removed
+            // (e.g. after `akm remove`) so orphaned entries don't linger.
+            const prevStashDirsJson = getMeta(db, "stashDirs");
+            if (prevStashDirsJson) {
+                const prevStashDirs = JSON.parse(prevStashDirsJson);
+                const currentSet = new Set(allStashDirs);
+                for (const dir of prevStashDirs) {
+                    if (!currentSet.has(dir)) {
+                        deleteEntriesByStashDir(db, dir);
+                    }
+                }
+            }
+        }
         const tWalkStart = Date.now();
         // Walk stash dirs and index entries
         const { scannedDirs, skippedDirs, generatedCount, dirsNeedingLlm } = indexEntries(db, allStashDirs, stashDir, isIncremental, builtAtMs);

package/dist/providers/skills-sh.js

@@ -75,6 +75,7 @@ class SkillsShProvider {
                 id: `skills-sh:${entry.id}`,
                 title: entry.name,
                 ref: entry.source,
+                installRef: `github:${entry.source}`,
                 homepage: `${baseUrl}/${entry.id}`,
                 score,
                 metadata: {

package/dist/providers/static-index.js

@@ -219,6 +219,7 @@ function toSearchHit(kit, score, registryName) {
         title: kit.name,
         description: kit.description,
         ref: kit.ref,
+        installRef: buildInstallRef(kit.source, kit.ref),
         homepage: kit.homepage,
         score: Math.round(score * 1000) / 1000,
         metadata,
@@ -260,13 +261,7 @@ function scoreAssets(kits, query, limit) {
     for (const { kit, registryName } of kits) {
         if (!kit.assets || kit.assets.length === 0)
             continue;
-        const installRef = kit.source === "npm"
-            ? `npm:${kit.ref}`
-            : kit.source === "git"
-                ? `git+${kit.ref}`
-                : kit.source === "local"
-                    ? kit.ref
-                    : `github:${kit.ref}`;
+        const installRef = buildInstallRef(kit.source, kit.ref);
         for (const asset of kit.assets) {
             const score = scoreAsset(asset, tokens);
             if (score > 0) {
@@ -335,6 +330,18 @@ function asStringArray(value) {
     const filtered = value.filter((v) => typeof v === "string");
     return filtered.length > 0 ? filtered : undefined;
 }
+function buildInstallRef(source, ref) {
+    switch (source) {
+        case "npm":
+            return `npm:${ref}`;
+        case "git":
+            return `git+${ref}`;
+        case "local":
+            return ref;
+        default:
+            return `github:${ref}`;
+    }
+}
 function toErrorMessage(error) {
     return error instanceof Error ? error.message : String(error);
 }

package/dist/registry-resolve.js

@@ -9,6 +9,12 @@ export function parseRegistryRef(rawRef) {
     const ref = rawRef.trim();
     if (!ref)
         throw new Error("Registry ref is required.");
+    // Detect registry search result IDs (e.g. "skills-sh:org/skills/name")
+    // that are not installable refs. Known installable prefixes are handled below.
+    const registryIdHint = detectRegistrySearchId(ref);
+    if (registryIdHint) {
+        throw new Error(registryIdHint);
+    }
     if (ref.startsWith("npm:")) {
         return parseNpmRef(ref.slice(4), ref);
     }
@@ -33,6 +39,37 @@ export function parseRegistryRef(rawRef) {
     }
     return parseGithubShorthand(ref, ref);
 }
+/**
+ * Known prefixes that `parseRegistryRef` handles as installable sources.
+ * Anything with a colon that doesn't start with one of these is likely a
+ * registry search result ID (e.g. `skills-sh:org/skills/name`).
+ */
+const KNOWN_PREFIXES = ["npm:", "github:", "git+", "file:", "http://", "https://"];
+function detectRegistrySearchId(ref) {
+    const colonIdx = ref.indexOf(":");
+    if (colonIdx < 1)
+        return undefined;
+    // Skip known installable prefixes
+    for (const prefix of KNOWN_PREFIXES) {
+        if (ref.startsWith(prefix))
+            return undefined;
+    }
+    const prefix = ref.slice(0, colonIdx);
+    // Registry IDs use lowercase-with-hyphens prefixes (e.g. skills-sh, static-index)
+    if (!/^[a-z][a-z0-9-]*$/.test(prefix))
+        return undefined;
+    const rest = ref.slice(colonIdx + 1);
+    return [
+        `"${ref}" looks like a registry search result ID, not an installable ref.`,
+        `The "${prefix}:" prefix is a registry identifier and cannot be passed to \`akm add\`.`,
+        "",
+        "Use the installRef or ref field from the search result instead. For example:",
+        `  akm registry search "${rest}" --format json`,
+        "Then install using the installRef value from the result:",
+        "  akm add github:owner/repo",
+        "  akm add npm:package-name",
+    ].join("\n");
+}
 export async function resolveRegistryArtifact(parsed) {
     if (parsed.source === "npm") {
         return resolveNpmArtifact(parsed);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "akm-cli",
-  "version": "0.0.18",
+  "version": "0.0.19",
   "type": "module",
   "description": "CLI tool to search, open, and run extension assets from an akm stash directory.",
   "keywords": [