akm-cli 0.7.4 → 0.8.0-rc.10

package/dist/commands/curate.js

@@ -1,3 +1,6 @@
+// This Source Code Form is subject to the terms of the Mozilla Public
+// License, v. 2.0. If a copy of the MPL was not distributed with this
+// file, You can obtain one at https://mozilla.org/MPL/2.0/.
 /**
  * Curate logic for `akm curate`.
  *
@@ -10,7 +13,10 @@
  * pure helpers (`curateSearchResults`, `orderCuratedTypes`,
  * `deriveCurateFallbackQueries`) by importing them directly.
  */
-import { UsageError } from "../core/errors";
+import { rethrowIfTestIsolationError, UsageError } from "../core/errors";
+import { appendEvent } from "../core/events";
+import { closeDatabase, openExistingDatabase } from "../indexer/db";
+import { insertUsageEvent } from "../indexer/usage-events";
 import { truncateDescription } from "../output/shapes";
 import { akmSearch, parseSearchSource } from "./search";
 import { akmShowUnified } from "./show";
@@ -35,6 +41,38 @@ const MAX_CURATE_FALLBACK_KEYWORDS = 6;
 export const CURATE_SEARCH_LIMIT_MULTIPLIER = 4;
 export const MIN_CURATE_SEARCH_LIMIT = 12;
 const DEFAULT_CURATE_LIMIT = 4;
+/**
+ * Fire-and-forget: log a curate event to the usage_events table and events.jsonl.
+ * Never blocks the caller; errors are silently ignored.
+ */
+function logCurateEvent(query, result) {
+    const itemRefs = result.items.map((item) => ("ref" in item ? item.ref : `registry:${item.id}`));
+    appendEvent({
+        eventType: "curate",
+        metadata: { query, itemCount: result.items.length, itemRefs },
+    });
+    try {
+        const db = openExistingDatabase();
+        try {
+            insertUsageEvent(db, {
+                event_type: "curate",
+                query,
+                metadata: JSON.stringify({
+                    itemCount: result.items.length,
+                    itemRefs,
+                }),
+                source: "user",
+            });
+        }
+        finally {
+            closeDatabase(db);
+        }
+    }
+    catch (err) {
+        rethrowIfTestIsolationError(err);
+        /* ignore logging failures */
+    }
+}
 /**
  * Public curate entry point. Performs the search itself when
  * `options.searchResponse` is not supplied.
@@ -55,7 +93,9 @@ export async function akmCurate(options) {
             limit: Math.max(limit * CURATE_SEARCH_LIMIT_MULTIPLIER, MIN_CURATE_SEARCH_LIMIT),
             source,
         }));
-    return curateSearchResults(options.query, searchResponse, limit, options.type);
+    const result = await curateSearchResults(options.query, searchResponse, limit, options.type);
+    logCurateEvent(options.query, result);
+    return result;
 }
 export async function curateSearchResults(query, result, limit, selectedType) {
     const stashHits = result.hits.filter((hit) => hit.type !== "registry");
@@ -135,6 +175,7 @@ async function enrichCuratedStashHit(query, hit) {
         ref: hit.ref,
         ...(description ? { description } : {}),
         ...(preview ? { preview } : {}),
+        ...(shown?.keys?.length ? { keys: shown.keys } : {}),
         ...(shown?.parameters?.length ? { parameters: shown.parameters } : {}),
         ...(shown?.run ? { run: shown.run } : {}),
         followUp: `akm show ${hit.ref}`,
@@ -247,7 +288,7 @@ export function mergeCurateSearchResponses(base, extras) {
     };
 }
 export async function searchForCuration(input) {
-    const initial = await akmSearch(input);
+    const initial = await akmSearch({ ...input, skipLogging: true });
     if (hasSearchResults(initial))
         return initial;
     const fallbackQueries = deriveCurateFallbackQueries(input.query);
@@ -258,6 +299,7 @@ export async function searchForCuration(input) {
         type: input.type,
         limit: input.limit,
         source: input.source,
+        skipLogging: true,
     })));
     return mergeCurateSearchResponses(initial, fallbackResults);
 }

package/dist/commands/db-cli.js

@@ -0,0 +1,23 @@
+// This Source Code Form is subject to the terms of the Mozilla Public
+// License, v. 2.0. If a copy of the MPL was not distributed with this
+// file, You can obtain one at https://mozilla.org/MPL/2.0/.
+/**
+ * CLI command surface for `akm db ...`.
+ *
+ * MVP scope: only `akm db backups` is exposed. It lists the pre-upgrade
+ * snapshots written by `backupDataDir()` under `<dataDir>/backups/`.
+ *
+ * Restoration is intentionally NOT a CLI subcommand for MVP — operators are
+ * expected to stop akm and use `scripts/migrations/restore-data-dir.sh` (or a
+ * plain `mv`/`cp`) to recover. Keeping the surface narrow lets us evolve the
+ * backup format under the hood without locking in an API.
+ */
+import { getDataDir } from "../core/paths";
+import { listBackups } from "../indexer/db-backup";
+export function akmDbBackups() {
+    const dataDir = getDataDir();
+    return {
+        dataDir,
+        backups: listBackups(dataDir),
+    };
+}