akm-cli 0.8.0-rc2 → 0.8.0

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");
@@ -248,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);
@@ -259,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),
+    };
+}

package/dist/commands/distill-promotion-policy.js

@@ -1,5 +1,8 @@
-import { stringify as yamlStringify } from "yaml";
+// 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/.
 import { parseAssetRef } from "../core/asset-ref";
+import { assembleAsset } from "../core/asset-serialize";
 import { parseFrontmatter } from "../core/frontmatter";
 function hasNonEmptyList(value) {
     return Array.isArray(value) && value.some((item) => typeof item === "string" && item.trim().length > 0);
@@ -121,8 +124,7 @@ function buildKnowledgeContent(input) {
         ...(typeof fm.observed_at === "string" && fm.observed_at.trim() ? { observed_at: fm.observed_at.trim() } : {}),
         sources,
     };
-    const frontmatter = yamlStringify(knowledgeFrontmatter).trimEnd();
-    return `---\n${frontmatter}\n---\n\n${body}\n`;
+    return assembleAsset(knowledgeFrontmatter, body);
 }
 function assessWithWeightedModel(input, model, threshold) {
     const knowledgeRef = deriveKnowledgeRef(input.inputRef);