akm-cli 0.10.261007-beta → 0.10.261009-beta

package/dist/indexer/search/db-search.js

@@ -22,7 +22,7 @@ import { embed } from "../../llm/embedder.js";
 import { applyEmbeddingTemplate, resolveEmbeddingProfile } from "../../llm/embedders/profile.js";
 import { normalizeEmbeddingEndpoint } from "../../llm/embedders/remote.js";
 import { assertIndexPathReadable, closeDatabase, openExistingDatabase, openReadonlyExistingDatabase, } from "../../storage/repositories/index-connection.js";
-import { getAllEntries, getBaseBeliefStatesForDerivedTwins, getEntryById, getEntryCount, getEntryRefsAndTypes, } from "../../storage/repositories/index-entries-repository.js";
+import { getAllEntries, getBaseBeliefStatesForDerivedTwins, getEntriesByIds, getEntryById, getEntryCount, getEntryRefsAndTypes, } from "../../storage/repositories/index-entries-repository.js";
 import { searchFts } from "../../storage/repositories/index-fts-repository.js";
 import { getMeta } from "../../storage/repositories/index-meta-repository.js";
 import { getEmbeddingCount, searchVec } from "../../storage/repositories/index-vec-repository.js";
@@ -221,8 +221,14 @@ async function searchDatabase(db, input) {
     const typeFilter = searchType === "any" ? undefined : searchType;
     const startedAt = Date.now();
     // The query embedding request goes out first, so FTS runs while it is in flight.
-    const vectorChannel = startVectorChannel(db, query, config);
-    const lexical = searchFts(db, query, CHANNEL_DEPTH, typeFilter, defaultExcludes);
+    const filterCandidates = (ids) => {
+        const entries = getEntriesByIds(db, ids)
+            .filter(hasIndexedProvenance)
+            .filter((row) => (typeFilter ? row.entry.type === typeFilter : !defaultExcludes.includes(row.entry.type)));
+        return new Set(applyEntryFilters(entries, filterOptions).map((row) => row.id));
+    };
+    const vectorChannel = startVectorChannel(db, query, config, filterCandidates);
+    const lexical = searchFts(db, query, CHANNEL_DEPTH, typeFilter, defaultExcludes, filterCandidates);
     const vector = await vectorChannel;
     const embedMs = Date.now() - startedAt;
     const tRank0 = Date.now();
@@ -244,6 +250,7 @@ async function searchDatabase(db, input) {
         sources,
         config,
         db,
+        eligible: (row) => applyEntryFilters([row], filterOptions).length > 0,
     })));
     const mode = vector.warning ? "fts-fallback" : vector.neighbors ? "semantic" : "keyword";
     return { embedMs, rankMs, hits, mode, semanticWarning: vector.warning, feedbackWarning: feedback.warning };
@@ -371,6 +378,7 @@ async function enumerateEntries(opts) {
         sources,
         config,
         db,
+        eligible: (row) => applyEntryFilters([row], opts).length > 0,
     })));
 }
 /**
@@ -378,7 +386,7 @@ async function enumerateEntries(opts) {
  * source-narrowing → scope → proposed-quality → derived-twin belief
  * inheritance → belief filter.
  */
-function applyEntryFilters(items, opts) {
+export function applyEntryFilters(items, opts) {
     const { filters } = opts;
     // Source filter: when the caller narrowed `sources` via `--from <name>`,
     // drop entries whose filePath does not live under any requested source. The
@@ -428,7 +436,7 @@ function inheritDerivedTwinBeliefStates(db, items) {
         }
     }
 }
-function matchBeliefFilter(beliefState, filter) {
+export function matchBeliefFilter(beliefState, filter) {
     if (filter === "all")
         return true;
     // 03: the belief filter applies to ANY flagged entry, not just memories, so
@@ -452,7 +460,7 @@ function matchBeliefFilter(beliefState, filter) {
  * query overlaps it. A slow or failing embedder degrades the search to keyword
  * ranking with a warning after `embedding.queryTimeoutMs`.
  */
-function startVectorChannel(db, query, config) {
+function startVectorChannel(db, query, config, filterCandidates) {
     if (config.semanticSearchMode === "off")
         return Promise.resolve({ neighbors: null });
     // A real-time completeness fact, not a cached verdict: skip the round trip
@@ -472,7 +480,7 @@ function startVectorChannel(db, query, config) {
     });
     const queryText = applyEmbeddingTemplate(resolveEmbeddingProfile(config.embedding).queryTemplate, query);
     return Promise.race([embed(queryText, config.embedding, controller.signal), timeout])
-        .then((vector) => ({ neighbors: searchVec(db, vector, CHANNEL_DEPTH) }))
+        .then((vector) => ({ neighbors: searchVec(db, vector, CHANNEL_DEPTH, undefined, filterCandidates) }))
         .catch((error) => ({ neighbors: null, warning: buildVectorFallbackWarning(config, error) }))
         .finally(() => clearTimeout(timer));
 }
@@ -574,6 +582,7 @@ export async function buildDbHit(input) {
         stashDir: entryStashDir,
         bundleId: input.bundleId,
         db: input.db,
+        eligible: input.eligible,
     });
     return hit;
 }

package/dist/indexer/search/search-hit-enrichers.js

@@ -17,7 +17,7 @@ export async function enrichSearchHit(hit, ctx) {
         renderer?.enrichSearchHit?.(hit, ctx.stashDir);
     }
     if (ctx.type === "memory" && ctx.db)
-        surfaceDerivedMemory(hit, ctx.db, ctx.bundleId);
+        surfaceDerivedMemory(hit, ctx.db, ctx.bundleId, ctx.eligible);
 }
 /**
  * Phase 5A / Advantage D5 — when a parent memory has a `.derived` child
@@ -28,7 +28,7 @@ export async function enrichSearchHit(hit, ctx) {
  * The parent ref is preserved on the hit — only the surface text is
  * swapped, so links and provenance still point at the canonical parent.
  */
-function surfaceDerivedMemory(hit, db, bundleId) {
+function surfaceDerivedMemory(hit, db, bundleId, eligible) {
     // Never recurse: a `.derived` hit is itself the child surface; leaving
     // it untouched also avoids `<parent>.derived.derived` chains.
     if (hit.name.toLowerCase().endsWith(".derived"))
@@ -38,7 +38,7 @@ function surfaceDerivedMemory(hit, db, bundleId) {
     // carries. INTERNAL lookup key into `getDerivedForParent`: the `derived_from`
     // column stores this same conceptId grammar.
     const derived = getDerivedForParent(db, `memories/${hit.name}`, bundleId);
-    if (!derived)
+    if (!derived || (eligible && !eligible(derived)))
         return;
     // Swap description / tags from the derived child (SourceSearchHit carries no
     // `searchHints`).

package/dist/output/shapes/curate.js

@@ -5,7 +5,7 @@ import { capDescription, NORMAL_DESCRIPTION_LIMIT, pickFields } from "./helpers.
 // Curation is a small, high-signal top-N. Even at `brief` we keep `followUp`
 // (the actionable `akm show <ref>` command) and `reason` (why this asset was
 // selected) — these are the point of curate, unlike a bulk search listing.
-const BRIEF_FIELDS = ["source", "type", "name", "ref", "id", "supportRefs", "followUp", "reason"];
+const BRIEF_FIELDS = ["source", "type", "name", "ref", "id", "supportRefs", "beliefState", "followUp", "reason"];
 const NORMAL_FIELDS = [
     "source",
     "type",
@@ -21,6 +21,7 @@ const NORMAL_FIELDS = [
     "parameters",
     "run",
     "supportRefs",
+    "beliefState",
     "followUp",
     "reason",
     "score",
@@ -37,6 +38,7 @@ const AGENT_FIELDS = [
     "id",
     "description",
     "supportRefs",
+    "beliefState",
     "followUp",
     "reason",
     "score",

package/dist/output/shapes/helpers.js

@@ -386,6 +386,9 @@ export function shapeShowOutput(result, detail, shape = "human") {
             "steps",
             "keys",
             "links",
+            "evidence",
+            "evidenceSources",
+            "provenance",
             ...FRAGMENT_PROVENANCE_FIELDS,
             ...FRAGMENT_CONTEXT_FIELDS,
         ]);
@@ -418,6 +421,9 @@ export function shapeShowOutput(result, detail, shape = "human") {
         "activeRun",
         "keys",
         "links",
+        "evidence",
+        "evidenceSources",
+        "provenance",
         ...FRAGMENT_PROVENANCE_FIELDS,
         ...FRAGMENT_CONTEXT_FIELDS,
         // ref, path, and editable are always projected — at every --detail level,

package/dist/output/text/show-format.js

@@ -20,6 +20,13 @@ export function formatShowPlain(r, detail) {
     }
     if (r.description)
         lines.push(`description: ${String(r.description)}`);
+    // Evidence is captured text: keep it on one line so it cannot forge other fields.
+    if (r.evidence)
+        lines.push(`evidence: ${String(r.evidence).replace(/\s+/g, " ")}`);
+    if (Array.isArray(r.evidenceSources))
+        lines.push(`evidenceSources: ${r.evidenceSources.join(", ")}`);
+    if (r.evidence && r.provenance)
+        lines.push(`provenance: ${JSON.stringify(r.provenance)}`);
     if (r.workflowTitle)
         lines.push(`workflowTitle: ${String(r.workflowTitle)}`);
     if (r.agent)