akm-cli 0.9.0-beta.5 → 0.9.0-beta.50

package/dist/scripts/migrations/import-fs-improve-runs-to-db.js

@@ -34,10 +34,36 @@ var __commonJS = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports,
 var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
 var __require = import.meta.require;
 
+// src/core/warn.ts
+import fs from "fs";
+function appendToLogFile(level, args) {
+  if (!logFilePath)
+    return;
+  const ts = new Date().toISOString();
+  const msg = args.map((a) => typeof a === "string" ? a : JSON.stringify(a)).join(" ");
+  try {
+    fs.appendFileSync(logFilePath, `[${ts}] [${level}] ${msg}
+`);
+  } catch (e) {
+    process.stderr.write(`[akm:warn] log-file write failed (${logFilePath}): ${e}
+`);
+    process.stderr.write(`[${ts}] [${level}] ${msg}
+`);
+  }
+}
+function warn(...args) {
+  appendToLogFile("WARN", args);
+  if (!quiet) {
+    console.warn(...args);
+  }
+}
+var quiet = false, logFilePath;
+var init_warn = () => {};
+
 // node_modules/dotenv/lib/main.js
 var require_main = __commonJS((exports, module) => {
-  var fs = __require("fs");
-  var path = __require("path");
+  var fs3 = __require("fs");
+  var path2 = __require("path");
   var os = __require("os");
   var crypto = __require("crypto");
   var TIPS = [
@@ -170,7 +196,7 @@ var require_main = __commonJS((exports, module) => {
     if (options && options.path && options.path.length > 0) {
       if (Array.isArray(options.path)) {
         for (const filepath of options.path) {
-          if (fs.existsSync(filepath)) {
+          if (fs3.existsSync(filepath)) {
             possibleVaultPath = filepath.endsWith(".vault") ? filepath : `${filepath}.vault`;
           }
         }
@@ -178,20 +204,20 @@ var require_main = __commonJS((exports, module) => {
         possibleVaultPath = options.path.endsWith(".vault") ? options.path : `${options.path}.vault`;
       }
     } else {
-      possibleVaultPath = path.resolve(process.cwd(), ".env.vault");
+      possibleVaultPath = path2.resolve(process.cwd(), ".env.vault");
     }
-    if (fs.existsSync(possibleVaultPath)) {
+    if (fs3.existsSync(possibleVaultPath)) {
       return possibleVaultPath;
     }
     return null;
   }
   function _resolveHome(envPath) {
-    return envPath[0] === "~" ? path.join(os.homedir(), envPath.slice(1)) : envPath;
+    return envPath[0] === "~" ? path2.join(os.homedir(), envPath.slice(1)) : envPath;
   }
   function _configVault(options) {
     const debug = parseBoolean(process.env.DOTENV_CONFIG_DEBUG || options && options.debug);
-    const quiet = parseBoolean(process.env.DOTENV_CONFIG_QUIET || options && options.quiet);
-    if (debug || !quiet) {
+    const quiet2 = parseBoolean(process.env.DOTENV_CONFIG_QUIET || options && options.quiet);
+    if (debug || !quiet2) {
       _log("loading env from encrypted .env.vault");
     }
     const parsed = DotenvModule._parseVault(options);
@@ -203,14 +229,14 @@ var require_main = __commonJS((exports, module) => {
     return { parsed };
   }
   function configDotenv(options) {
-    const dotenvPath = path.resolve(process.cwd(), ".env");
+    const dotenvPath = path2.resolve(process.cwd(), ".env");
     let encoding = "utf8";
     let processEnv = process.env;
     if (options && options.processEnv != null) {
       processEnv = options.processEnv;
     }
     let debug = parseBoolean(processEnv.DOTENV_CONFIG_DEBUG || options && options.debug);
-    let quiet = parseBoolean(processEnv.DOTENV_CONFIG_QUIET || options && options.quiet);
+    let quiet2 = parseBoolean(processEnv.DOTENV_CONFIG_QUIET || options && options.quiet);
     if (options && options.encoding) {
       encoding = options.encoding;
     } else {
@@ -231,26 +257,26 @@ var require_main = __commonJS((exports, module) => {
     }
     let lastError;
     const parsedAll = {};
-    for (const path2 of optionPaths) {
+    for (const path3 of optionPaths) {
       try {
-        const parsed = DotenvModule.parse(fs.readFileSync(path2, { encoding }));
+        const parsed = DotenvModule.parse(fs3.readFileSync(path3, { encoding }));
         DotenvModule.populate(parsedAll, parsed, options);
       } catch (e) {
         if (debug) {
-          _debug(`failed to load ${path2} ${e.message}`);
+          _debug(`failed to load ${path3} ${e.message}`);
         }
         lastError = e;
       }
     }
     const populated = DotenvModule.populate(processEnv, parsedAll, options);
     debug = parseBoolean(processEnv.DOTENV_CONFIG_DEBUG || debug);
-    quiet = parseBoolean(processEnv.DOTENV_CONFIG_QUIET || quiet);
-    if (debug || !quiet) {
+    quiet2 = parseBoolean(processEnv.DOTENV_CONFIG_QUIET || quiet2);
+    if (debug || !quiet2) {
       const keysCount = Object.keys(populated).length;
       const shortPaths = [];
       for (const filePath of optionPaths) {
         try {
-          const relative = path.relative(process.cwd(), filePath);
+          const relative = path2.relative(process.cwd(), filePath);
           shortPaths.push(relative);
         } catch (e) {
           if (debug) {
@@ -412,7 +438,7 @@ var init_errors = __esm(() => {
 });
 
 // src/commands/env/env.ts
-import fs from "fs";
+import fs3 from "fs";
 function scanKeys(text) {
   const keys = [];
   const seen = new Set;
@@ -439,9 +465,9 @@ function scanComments(text) {
   return comments;
 }
 function listKeys(envPath) {
-  if (!fs.existsSync(envPath))
+  if (!fs3.existsSync(envPath))
     return { keys: [], comments: [] };
-  const text = fs.readFileSync(envPath, "utf8");
+  const text = fs3.readFileSync(envPath, "utf8");
   return { keys: scanKeys(text), comments: scanComments(text) };
 }
 var import_dotenv, ASSIGN_RE;
@@ -452,251 +478,6 @@ var init_env = __esm(() => {
   ASSIGN_RE = /^\s*(?:export\s+)?([A-Za-z_][A-Za-z0-9_]*)\s*=/;
 });
 
-// src/core/asset/frontmatter.ts
-function parseFrontmatter(raw) {
-  const parsedBlock = parseFrontmatterBlock(raw);
-  if (!parsedBlock) {
-    return { data: {}, content: raw, frontmatter: null, bodyStartLine: 1 };
-  }
-  const data = {};
-  let currentKey = null;
-  let mode = "scalar";
-  let nested = null;
-  let currentList = null;
-  let blockLines = null;
-  let blockChomping = "clip";
-  const flushPending = () => {
-    if (mode === "pending" && currentKey !== null) {
-      data[currentKey] = "";
-    }
-  };
-  const flushBlock = () => {
-    if (mode !== "block" || currentKey === null || blockLines === null)
-      return;
-    const deindented = blockLines.map((l) => l.startsWith("  ") ? l.slice(2) : l);
-    if (blockChomping === "keep") {
-      data[currentKey] = deindented.join(`
-`);
-    } else if (blockChomping === "strip") {
-      data[currentKey] = deindented.join(`
-`).replace(/\n+$/, "");
-    } else {
-      data[currentKey] = `${deindented.join(`
-`).replace(/\n+$/, "")}
-`;
-    }
-  };
-  for (const line of parsedBlock.frontmatter.split(/\r?\n/)) {
-    if (mode === "block") {
-      if (line.startsWith("  ") || line === "") {
-        blockLines.push(line);
-        continue;
-      }
-      flushBlock();
-      mode = "scalar";
-      blockLines = null;
-    }
-    const seqItem = line.match(/^(?: {2})?- (.*)$/);
-    if (seqItem && currentKey !== null && (mode === "list" || mode === "pending")) {
-      if (mode === "pending") {
-        currentList = [];
-        data[currentKey] = currentList;
-        mode = "list";
-      }
-      currentList.push(parseYamlScalar(seqItem[1].trim()));
-      continue;
-    }
-    if (mode === "scalar" && currentKey !== null && /^ {2}\S/.test(line)) {
-      data[currentKey] = `${String(data[currentKey])} ${line.trim()}`;
-      continue;
-    }
-    const indented = line.match(/^ {2}(\w[\w-]*):\s*(.+)$/);
-    if (indented && currentKey !== null && (mode === "object" || mode === "pending")) {
-      if (mode === "pending") {
-        nested = {};
-        data[currentKey] = nested;
-        mode = "object";
-      }
-      nested[indented[1]] = parseYamlScalar(indented[2].trim());
-      continue;
-    }
-    const top = line.match(/^(\w[\w-]*):\s*(.*)$/);
-    if (!top) {
-      continue;
-    }
-    flushPending();
-    currentKey = top[1];
-    const value = top[2].trim();
-    if (value === "|" || value === "|-" || value === "|+") {
-      mode = "block";
-      blockLines = [];
-      blockChomping = value === "|-" ? "strip" : value === "|+" ? "keep" : "clip";
-      nested = null;
-      currentList = null;
-    } else if (value === "") {
-      mode = "pending";
-      nested = null;
-      currentList = null;
-    } else if (value.startsWith("[") && value.endsWith("]")) {
-      mode = "list";
-      nested = null;
-      currentList = null;
-      currentList = parseFlowArray(value);
-      data[currentKey] = currentList;
-    } else {
-      mode = "scalar";
-      nested = null;
-      currentList = null;
-      data[currentKey] = parseYamlScalar(value);
-    }
-  }
-  if (mode === "block") {
-    flushBlock();
-  }
-  flushPending();
-  return {
-    data,
-    content: parsedBlock.content,
-    frontmatter: parsedBlock.frontmatter,
-    bodyStartLine: parsedBlock.bodyStartLine
-  };
-}
-function parseFlowArray(value) {
-  const inner = value.slice(1, -1).trim();
-  if (!inner)
-    return [];
-  return inner.split(",").map((item) => parseYamlScalar(item.trim()));
-}
-function parseFrontmatterBlock(raw) {
-  const match = raw.match(/^---\r?\n([\s\S]*?)\r?\n---(?:\r\n|\r|\n|$)([\s\S]*)$/);
-  if (!match)
-    return null;
-  const frontmatter = match[1].replace(/\r/g, "");
-  const content = match[2];
-  return {
-    frontmatter,
-    content,
-    bodyStartLine: countLines(raw.slice(0, match[0].length - match[2].length)) + 1
-  };
-}
-function countLines(text) {
-  if (text.length === 0)
-    return 0;
-  return text.split(/\r?\n/).length - 1;
-}
-function parseYamlScalar(value) {
-  if (value === "")
-    return "";
-  if (value === "true")
-    return true;
-  if (value === "false")
-    return false;
-  const asNumber = Number(value);
-  if (!Number.isNaN(asNumber))
-    return asNumber;
-  if (value.startsWith('"') && value.endsWith('"') || value.startsWith("'") && value.endsWith("'")) {
-    return value.slice(1, -1);
-  }
-  return value;
-}
-
-// src/core/asset/markdown.ts
-function parseMarkdownToc(content) {
-  const lines = content.split(/\r?\n/);
-  const headings = [];
-  const parsed = parseFrontmatter(content);
-  const start = parsed.frontmatter ? parsed.bodyStartLine - 1 : 0;
-  for (let i = start;i < lines.length; i++) {
-    const match = lines[i].match(/^(#{1,6})\s+(.+)$/);
-    if (match) {
-      headings.push({
-        level: match[1].length,
-        text: match[2].replace(/\s+#+\s*$/, "").trim(),
-        line: i + 1
-      });
-    }
-  }
-  return { headings, totalLines: lines.length };
-}
-var init_markdown = () => {};
-
-// src/core/warn.ts
-var init_warn = () => {};
-
-// src/indexer/walk/file-context.ts
-var renderers;
-var init_file_context = __esm(() => {
-  init_common();
-  renderers = new Map;
-});
-
-// src/indexer/passes/metadata-contributors.ts
-function registerMetadataContributor(contributor) {
-  contributors.push(contributor);
-}
-var contributors;
-var init_metadata_contributors = __esm(() => {
-  contributors = [];
-});
-
-// src/indexer/passes/metadata.ts
-import fs2 from "fs";
-function extractDescriptionFromComments(filePath) {
-  let content;
-  try {
-    content = fs2.readFileSync(filePath, "utf8");
-  } catch {
-    return null;
-  }
-  const lines = content.split(/\r?\n/).slice(0, 50);
-  const blockStart = lines.findIndex((l) => /^\s*\/\*\*/.test(l));
-  if (blockStart >= 0) {
-    const desc = [];
-    for (let i = blockStart;i < lines.length; i++) {
-      const line = lines[i];
-      if (i > blockStart && /\*\//.test(line))
-        break;
-      const cleaned = line.replace(/^\s*\/?\*\*?\s?/, "").replace(/\*\/\s*$/, "").trim();
-      if (cleaned)
-        desc.push(cleaned);
-    }
-    if (desc.length > 0)
-      return desc.join(" ");
-  }
-  let start = 0;
-  if (lines[0]?.startsWith("#!"))
-    start = 1;
-  const hashLines = [];
-  for (let i = start;i < lines.length; i++) {
-    const line = lines[i].trim();
-    if (line.startsWith("#") && !line.startsWith("#!")) {
-      hashLines.push(line.replace(/^#+\s*/, "").trim());
-    } else if (line === "") {} else {
-      break;
-    }
-  }
-  if (hashLines.length > 0)
-    return hashLines.join(" ");
-  return null;
-}
-var KNOWN_QUALITY_VALUES, warnedUnknownQualityValues, WIKI_INFRA_FILES;
-var init_metadata = __esm(() => {
-  init_asset_spec();
-  init_common();
-  init_warn();
-  init_file_context();
-  init_metadata_contributors();
-  KNOWN_QUALITY_VALUES = new Set(["generated", "curated", "enriched", "proposed"]);
-  warnedUnknownQualityValues = new Set;
-  WIKI_INFRA_FILES = new Set(["schema.md", "index.md", "log.md"]);
-});
-
-// src/core/asset/asset-ref.ts
-var init_asset_ref = __esm(() => {
-  init_common();
-  init_errors();
-});
-
 // node_modules/yaml/dist/nodes/identity.js
 var require_identity = __commonJS((exports) => {
   var ALIAS = Symbol.for("yaml.alias");
@@ -769,17 +550,17 @@ var require_visit = __commonJS((exports) => {
   visit.BREAK = BREAK;
   visit.SKIP = SKIP;
   visit.REMOVE = REMOVE;
-  function visit_(key, node, visitor, path) {
-    const ctrl = callVisitor(key, node, visitor, path);
+  function visit_(key, node, visitor, path2) {
+    const ctrl = callVisitor(key, node, visitor, path2);
     if (identity.isNode(ctrl) || identity.isPair(ctrl)) {
-      replaceNode(key, path, ctrl);
-      return visit_(key, ctrl, visitor, path);
+      replaceNode(key, path2, ctrl);
+      return visit_(key, ctrl, visitor, path2);
     }
     if (typeof ctrl !== "symbol") {
       if (identity.isCollection(node)) {
-        path = Object.freeze(path.concat(node));
+        path2 = Object.freeze(path2.concat(node));
         for (let i = 0;i < node.items.length; ++i) {
-          const ci = visit_(i, node.items[i], visitor, path);
+          const ci = visit_(i, node.items[i], visitor, path2);
           if (typeof ci === "number")
             i = ci - 1;
           else if (ci === BREAK)
@@ -790,13 +571,13 @@ var require_visit = __commonJS((exports) => {
           }
         }
       } else if (identity.isPair(node)) {
-        path = Object.freeze(path.concat(node));
-        const ck = visit_("key", node.key, visitor, path);
+        path2 = Object.freeze(path2.concat(node));
+        const ck = visit_("key", node.key, visitor, path2);
         if (ck === BREAK)
           return BREAK;
         else if (ck === REMOVE)
           node.key = null;
-        const cv = visit_("value", node.value, visitor, path);
+        const cv = visit_("value", node.value, visitor, path2);
         if (cv === BREAK)
           return BREAK;
         else if (cv === REMOVE)
@@ -817,17 +598,17 @@ var require_visit = __commonJS((exports) => {
   visitAsync.BREAK = BREAK;
   visitAsync.SKIP = SKIP;
   visitAsync.REMOVE = REMOVE;
-  async function visitAsync_(key, node, visitor, path) {
-    const ctrl = await callVisitor(key, node, visitor, path);
+  async function visitAsync_(key, node, visitor, path2) {
+    const ctrl = await callVisitor(key, node, visitor, path2);
     if (identity.isNode(ctrl) || identity.isPair(ctrl)) {
-      replaceNode(key, path, ctrl);
-      return visitAsync_(key, ctrl, visitor, path);
+      replaceNode(key, path2, ctrl);
+      return visitAsync_(key, ctrl, visitor, path2);
     }
     if (typeof ctrl !== "symbol") {
       if (identity.isCollection(node)) {
-        path = Object.freeze(path.concat(node));
+        path2 = Object.freeze(path2.concat(node));
         for (let i = 0;i < node.items.length; ++i) {
-          const ci = await visitAsync_(i, node.items[i], visitor, path);
+          const ci = await visitAsync_(i, node.items[i], visitor, path2);
           if (typeof ci === "number")
             i = ci - 1;
           else if (ci === BREAK)
@@ -838,13 +619,13 @@ var require_visit = __commonJS((exports) => {
           }
         }
       } else if (identity.isPair(node)) {
-        path = Object.freeze(path.concat(node));
-        const ck = await visitAsync_("key", node.key, visitor, path);
+        path2 = Object.freeze(path2.concat(node));
+        const ck = await visitAsync_("key", node.key, visitor, path2);
         if (ck === BREAK)
           return BREAK;
         else if (ck === REMOVE)
           node.key = null;
-        const cv = await visitAsync_("value", node.value, visitor, path);
+        const cv = await visitAsync_("value", node.value, visitor, path2);
         if (cv === BREAK)
           return BREAK;
         else if (cv === REMOVE)
@@ -871,23 +652,23 @@ var require_visit = __commonJS((exports) => {
     }
     return visitor;
   }
-  function callVisitor(key, node, visitor, path) {
+  function callVisitor(key, node, visitor, path2) {
     if (typeof visitor === "function")
-      return visitor(key, node, path);
+      return visitor(key, node, path2);
     if (identity.isMap(node))
-      return visitor.Map?.(key, node, path);
+      return visitor.Map?.(key, node, path2);
     if (identity.isSeq(node))
-      return visitor.Seq?.(key, node, path);
+      return visitor.Seq?.(key, node, path2);
     if (identity.isPair(node))
-      return visitor.Pair?.(key, node, path);
+      return visitor.Pair?.(key, node, path2);
     if (identity.isScalar(node))
-      return visitor.Scalar?.(key, node, path);
+      return visitor.Scalar?.(key, node, path2);
     if (identity.isAlias(node))
-      return visitor.Alias?.(key, node, path);
+      return visitor.Alias?.(key, node, path2);
     return;
   }
-  function replaceNode(key, path, node) {
-    const parent = path[path.length - 1];
+  function replaceNode(key, path2, node) {
+    const parent = path2[path2.length - 1];
     if (identity.isCollection(parent)) {
       parent.items[key] = node;
     } else if (identity.isPair(parent)) {
@@ -1446,10 +1227,10 @@ var require_Collection = __commonJS((exports) => {
   var createNode = require_createNode();
   var identity = require_identity();
   var Node = require_Node();
-  function collectionFromPath(schema, path, value) {
+  function collectionFromPath(schema, path2, value) {
     let v = value;
-    for (let i = path.length - 1;i >= 0; --i) {
-      const k = path[i];
+    for (let i = path2.length - 1;i >= 0; --i) {
+      const k = path2[i];
       if (typeof k === "number" && Number.isInteger(k) && k >= 0) {
         const a = [];
         a[k] = v;
@@ -1468,7 +1249,7 @@ var require_Collection = __commonJS((exports) => {
       sourceObjects: new Map
     });
   }
-  var isEmptyPath = (path) => path == null || typeof path === "object" && !!path[Symbol.iterator]().next().done;
+  var isEmptyPath = (path2) => path2 == null || typeof path2 === "object" && !!path2[Symbol.iterator]().next().done;
 
   class Collection extends Node.NodeBase {
     constructor(type, schema) {
@@ -1489,11 +1270,11 @@ var require_Collection = __commonJS((exports) => {
         copy.range = this.range.slice();
       return copy;
     }
-    addIn(path, value) {
-      if (isEmptyPath(path))
+    addIn(path2, value) {
+      if (isEmptyPath(path2))
         this.add(value);
       else {
-        const [key, ...rest] = path;
+        const [key, ...rest] = path2;
         const node = this.get(key, true);
         if (identity.isCollection(node))
           node.addIn(rest, value);
@@ -1503,8 +1284,8 @@ var require_Collection = __commonJS((exports) => {
           throw new Error(`Expected YAML collection at ${key}. Remaining path: ${rest}`);
       }
     }
-    deleteIn(path) {
-      const [key, ...rest] = path;
+    deleteIn(path2) {
+      const [key, ...rest] = path2;
       if (rest.length === 0)
         return this.delete(key);
       const node = this.get(key, true);
@@ -1513,8 +1294,8 @@ var require_Collection = __commonJS((exports) => {
       else
         throw new Error(`Expected YAML collection at ${key}. Remaining path: ${rest}`);
     }
-    getIn(path, keepScalar) {
-      const [key, ...rest] = path;
+    getIn(path2, keepScalar) {
+      const [key, ...rest] = path2;
       const node = this.get(key, true);
       if (rest.length === 0)
         return !keepScalar && identity.isScalar(node) ? node.value : node;
@@ -1529,15 +1310,15 @@ var require_Collection = __commonJS((exports) => {
         return n == null || allowScalar && identity.isScalar(n) && n.value == null && !n.commentBefore && !n.comment && !n.tag;
       });
     }
-    hasIn(path) {
-      const [key, ...rest] = path;
+    hasIn(path2) {
+      const [key, ...rest] = path2;
       if (rest.length === 0)
         return this.has(key);
       const node = this.get(key, true);
       return identity.isCollection(node) ? node.hasIn(rest) : false;
     }
-    setIn(path, value) {
-      const [key, ...rest] = path;
+    setIn(path2, value) {
+      const [key, ...rest] = path2;
       if (rest.length === 0) {
         this.set(key, value);
       } else {
@@ -3930,9 +3711,9 @@ var require_Document = __commonJS((exports) => {
       if (assertCollection(this.contents))
         this.contents.add(value);
     }
-    addIn(path, value) {
+    addIn(path2, value) {
       if (assertCollection(this.contents))
-        this.contents.addIn(path, value);
+        this.contents.addIn(path2, value);
     }
     createAlias(node, name) {
       if (!node.anchor) {
@@ -3981,30 +3762,30 @@ var require_Document = __commonJS((exports) => {
     delete(key) {
       return assertCollection(this.contents) ? this.contents.delete(key) : false;
     }
-    deleteIn(path) {
-      if (Collection.isEmptyPath(path)) {
+    deleteIn(path2) {
+      if (Collection.isEmptyPath(path2)) {
         if (this.contents == null)
           return false;
         this.contents = null;
         return true;
       }
-      return assertCollection(this.contents) ? this.contents.deleteIn(path) : false;
+      return assertCollection(this.contents) ? this.contents.deleteIn(path2) : false;
     }
     get(key, keepScalar) {
       return identity.isCollection(this.contents) ? this.contents.get(key, keepScalar) : undefined;
     }
-    getIn(path, keepScalar) {
-      if (Collection.isEmptyPath(path))
+    getIn(path2, keepScalar) {
+      if (Collection.isEmptyPath(path2))
         return !keepScalar && identity.isScalar(this.contents) ? this.contents.value : this.contents;
-      return identity.isCollection(this.contents) ? this.contents.getIn(path, keepScalar) : undefined;
+      return identity.isCollection(this.contents) ? this.contents.getIn(path2, keepScalar) : undefined;
     }
     has(key) {
       return identity.isCollection(this.contents) ? this.contents.has(key) : false;
     }
-    hasIn(path) {
-      if (Collection.isEmptyPath(path))
+    hasIn(path2) {
+      if (Collection.isEmptyPath(path2))
         return this.contents !== undefined;
-      return identity.isCollection(this.contents) ? this.contents.hasIn(path) : false;
+      return identity.isCollection(this.contents) ? this.contents.hasIn(path2) : false;
     }
     set(key, value) {
       if (this.contents == null) {
@@ -4013,13 +3794,13 @@ var require_Document = __commonJS((exports) => {
         this.contents.set(key, value);
       }
     }
-    setIn(path, value) {
-      if (Collection.isEmptyPath(path)) {
+    setIn(path2, value) {
+      if (Collection.isEmptyPath(path2)) {
         this.contents = value;
       } else if (this.contents == null) {
-        this.contents = Collection.collectionFromPath(this.schema, Array.from(path), value);
+        this.contents = Collection.collectionFromPath(this.schema, Array.from(path2), value);
       } else if (assertCollection(this.contents)) {
-        this.contents.setIn(path, value);
+        this.contents.setIn(path2, value);
       }
     }
     setSchema(version, options = {}) {
@@ -5914,9 +5695,9 @@ var require_cst_visit = __commonJS((exports) => {
   visit.BREAK = BREAK;
   visit.SKIP = SKIP;
   visit.REMOVE = REMOVE;
-  visit.itemAtPath = (cst, path) => {
+  visit.itemAtPath = (cst, path2) => {
     let item = cst;
-    for (const [field, index] of path) {
+    for (const [field, index] of path2) {
       const tok = item?.[field];
       if (tok && "items" in tok) {
         item = tok.items[index];
@@ -5925,23 +5706,23 @@ var require_cst_visit = __commonJS((exports) => {
     }
     return item;
   };
-  visit.parentCollection = (cst, path) => {
-    const parent = visit.itemAtPath(cst, path.slice(0, -1));
-    const field = path[path.length - 1][0];
+  visit.parentCollection = (cst, path2) => {
+    const parent = visit.itemAtPath(cst, path2.slice(0, -1));
+    const field = path2[path2.length - 1][0];
     const coll = parent?.[field];
     if (coll && "items" in coll)
       return coll;
     throw new Error("Parent collection not found");
   };
-  function _visit(path, item, visitor) {
-    let ctrl = visitor(item, path);
+  function _visit(path2, item, visitor) {
+    let ctrl = visitor(item, path2);
     if (typeof ctrl === "symbol")
       return ctrl;
     for (const field of ["key", "value"]) {
       const token = item[field];
       if (token && "items" in token) {
         for (let i = 0;i < token.items.length; ++i) {
-          const ci = _visit(Object.freeze(path.concat([[field, i]])), token.items[i], visitor);
+          const ci = _visit(Object.freeze(path2.concat([[field, i]])), token.items[i], visitor);
           if (typeof ci === "number")
             i = ci - 1;
           else if (ci === BREAK)
@@ -5952,10 +5733,10 @@ var require_cst_visit = __commonJS((exports) => {
           }
         }
         if (typeof ctrl === "function" && field === "key")
-          ctrl = ctrl(item, path);
+          ctrl = ctrl(item, path2);
       }
     }
-    return typeof ctrl === "function" ? ctrl(item, path) : ctrl;
+    return typeof ctrl === "function" ? ctrl(item, path2) : ctrl;
   }
   exports.visit = visit;
 });
@@ -7224,14 +7005,14 @@ var require_parser = __commonJS((exports) => {
           case "scalar":
           case "single-quoted-scalar":
           case "double-quoted-scalar": {
-            const fs3 = this.flowScalar(this.type);
+            const fs4 = this.flowScalar(this.type);
             if (atNextItem || it.value) {
-              map.items.push({ start, key: fs3, sep: [] });
+              map.items.push({ start, key: fs4, sep: [] });
               this.onKeyLine = true;
             } else if (it.sep) {
-              this.stack.push(fs3);
+              this.stack.push(fs4);
             } else {
-              Object.assign(it, { key: fs3, sep: [] });
+              Object.assign(it, { key: fs4, sep: [] });
               this.onKeyLine = true;
             }
             return;
@@ -7359,13 +7140,13 @@ var require_parser = __commonJS((exports) => {
           case "scalar":
           case "single-quoted-scalar":
           case "double-quoted-scalar": {
-            const fs3 = this.flowScalar(this.type);
+            const fs4 = this.flowScalar(this.type);
             if (!it || it.value)
-              fc.items.push({ start: [], key: fs3, sep: [] });
+              fc.items.push({ start: [], key: fs4, sep: [] });
             else if (it.sep)
-              this.stack.push(fs3);
+              this.stack.push(fs4);
             else
-              Object.assign(it, { key: fs3, sep: [] });
+              Object.assign(it, { key: fs4, sep: [] });
             return;
           }
           case "flow-map-end":
@@ -7667,6 +7448,199 @@ var init_dist = __esm(() => {
   $visitAsync = visit.visitAsync;
 });
 
+// src/core/asset/frontmatter.ts
+function parseFrontmatter(raw) {
+  const parsedBlock = parseFrontmatterBlock(raw);
+  if (!parsedBlock) {
+    return { data: {}, content: raw, frontmatter: null, bodyStartLine: 1 };
+  }
+  let data = {};
+  if (parsedBlock.frontmatter.trim()) {
+    try {
+      const parsed = $parse(parsedBlock.frontmatter);
+      if (parsed !== null && typeof parsed === "object" && !Array.isArray(parsed)) {
+        data = normalizeYamlValues(parsed);
+      }
+    } catch {
+      data = parseFrontmatterLenient(parsedBlock.frontmatter);
+    }
+  }
+  return {
+    data,
+    content: parsedBlock.content,
+    frontmatter: parsedBlock.frontmatter,
+    bodyStartLine: parsedBlock.bodyStartLine
+  };
+}
+function normalizeYamlValues(value) {
+  if (value instanceof Date) {
+    const y = value.getUTCFullYear();
+    const m = String(value.getUTCMonth() + 1).padStart(2, "0");
+    const d = String(value.getUTCDate()).padStart(2, "0");
+    return `${y}-${m}-${d}`;
+  }
+  if (value === null)
+    return "";
+  if (Array.isArray(value))
+    return value.map(normalizeYamlValues);
+  if (typeof value === "object") {
+    return Object.fromEntries(Object.entries(value).map(([k, v]) => [k, normalizeYamlValues(v)]));
+  }
+  return value;
+}
+function parseFrontmatterLenient(frontmatter) {
+  const data = {};
+  for (const line of frontmatter.split(/\r?\n/)) {
+    const m = line.match(/^([\w][\w-]*):\s*(.*)$/);
+    if (!m)
+      continue;
+    const key = m[1];
+    const rawValue = (m[2] ?? "").trim();
+    try {
+      const singleEntry = $parse(`k: ${rawValue}`);
+      if (singleEntry !== null && typeof singleEntry === "object" && !Array.isArray(singleEntry)) {
+        const v = singleEntry.k;
+        data[key] = v === null || v === undefined ? "" : v;
+      } else {
+        data[key] = rawValue;
+      }
+    } catch {
+      data[key] = rawValue;
+    }
+  }
+  return data;
+}
+function parseFrontmatterBlock(raw) {
+  const match = raw.match(/^---\r?\n([\s\S]*?)\r?\n---(?:\r\n|\r|\n|$)([\s\S]*)$/);
+  if (match) {
+    const frontmatter = match[1].replace(/\r/g, "");
+    const content = match[2];
+    return {
+      frontmatter,
+      content,
+      bodyStartLine: countLines(raw.slice(0, match[0].length - match[2].length)) + 1
+    };
+  }
+  const emptyMatch = raw.match(/^---\r?\n---(?:\r\n|\r|\n)([\s\S]*)$/);
+  if (emptyMatch) {
+    return { frontmatter: "", content: emptyMatch[1], bodyStartLine: 3 };
+  }
+  return null;
+}
+function countLines(text) {
+  if (text.length === 0)
+    return 0;
+  return text.split(/\r?\n/).length - 1;
+}
+var init_frontmatter = __esm(() => {
+  init_dist();
+});
+
+// src/core/asset/markdown.ts
+function parseMarkdownToc(content) {
+  const lines = content.split(/\r?\n/);
+  const headings = [];
+  const parsed = parseFrontmatter(content);
+  const start = parsed.frontmatter ? parsed.bodyStartLine - 1 : 0;
+  let inFence = false;
+  for (let i = start;i < lines.length; i++) {
+    if (/^\s*(`{3,}|~{3,})/.test(lines[i])) {
+      inFence = !inFence;
+      continue;
+    }
+    if (inFence)
+      continue;
+    const match = lines[i].match(/^(#{1,6})\s+(.+)$/);
+    if (match) {
+      headings.push({
+        level: match[1].length,
+        text: match[2].replace(/\s+#+\s*$/, "").trim(),
+        line: i + 1
+      });
+    }
+  }
+  return { headings, totalLines: lines.length };
+}
+var init_markdown = __esm(() => {
+  init_frontmatter();
+});
+
+// src/indexer/walk/file-context.ts
+var renderers;
+var init_file_context = __esm(() => {
+  init_frontmatter();
+  init_common();
+  renderers = new Map;
+});
+
+// src/indexer/passes/metadata-contributors.ts
+function registerMetadataContributor(contributor) {
+  contributors.push(contributor);
+}
+var contributors;
+var init_metadata_contributors = __esm(() => {
+  contributors = [];
+});
+
+// src/indexer/passes/metadata.ts
+import fs4 from "fs";
+function extractDescriptionFromComments(filePath) {
+  let content;
+  try {
+    content = fs4.readFileSync(filePath, "utf8");
+  } catch {
+    return null;
+  }
+  const lines = content.split(/\r?\n/).slice(0, 50);
+  const blockStart = lines.findIndex((l) => /^\s*\/\*\*/.test(l));
+  if (blockStart >= 0) {
+    const desc = [];
+    for (let i = blockStart;i < lines.length; i++) {
+      const line = lines[i];
+      if (i > blockStart && /\*\//.test(line))
+        break;
+      const cleaned = line.replace(/^\s*\/?\*\*?\s?/, "").replace(/\*\/\s*$/, "").trim();
+      if (cleaned)
+        desc.push(cleaned);
+    }
+    if (desc.length > 0)
+      return desc.join(" ");
+  }
+  let start = 0;
+  if (lines[0]?.startsWith("#!"))
+    start = 1;
+  const hashLines = [];
+  for (let i = start;i < lines.length; i++) {
+    const line = lines[i].trim();
+    if (line.startsWith("#") && !line.startsWith("#!")) {
+      hashLines.push(line.replace(/^#+\s*/, "").trim());
+    } else if (line === "") {} else {
+      break;
+    }
+  }
+  if (hashLines.length > 0)
+    return hashLines.join(" ");
+  return null;
+}
+var KNOWN_QUALITY_VALUES, warnedUnknownQualityValues, WIKI_INFRA_FILES;
+var init_metadata = __esm(() => {
+  init_asset_spec();
+  init_frontmatter();
+  init_common();
+  init_warn();
+  init_file_context();
+  init_metadata_contributors();
+  KNOWN_QUALITY_VALUES = new Set(["generated", "curated", "enriched", "proposed"]);
+  warnedUnknownQualityValues = new Set;
+  WIKI_INFRA_FILES = new Set(["schema.md", "index.md", "log.md"]);
+});
+
+// src/core/asset/asset-ref.ts
+var init_asset_ref = __esm(() => {
+  init_common();
+  init_errors();
+});
+
 // src/workflows/schema.ts
 var WORKFLOW_SCHEMA_VERSION = 1;
 
@@ -7719,7 +7693,7 @@ var init_validator = __esm(() => {
 // src/workflows/parser.ts
 function parseWorkflow(markdown, source) {
   const errors2 = [];
-  const path = source.path;
+  const path2 = source.path;
   const lines = markdown.split(/\r?\n/);
   const totalLines = lines.length;
   const fmBlock = parseFrontmatterBlock(markdown);
@@ -7727,7 +7701,7 @@ function parseWorkflow(markdown, source) {
   const fmData = readFrontmatter(fmBlock?.frontmatter, errors2);
   const description = readDescription(fmData);
   const tags = readTags(fmData, errors2, frontmatterEndLine);
-  const parameters = readParameters(fmData, errors2, frontmatterEndLine, path);
+  const parameters = readParameters(fmData, errors2, frontmatterEndLine, path2);
   const toc = parseMarkdownToc(markdown);
   const { title, titleLine } = extractTitle(toc.headings, errors2);
   for (const h of toc.headings) {
@@ -7744,7 +7718,7 @@ function parseWorkflow(markdown, source) {
       });
     }
   }
-  const steps = extractSteps(toc.headings, lines, totalLines, path, errors2);
+  const steps = extractSteps(toc.headings, lines, totalLines, path2, errors2);
   if (steps.length === 0 && titleLine > 0) {
     errors2.push({
       line: titleLine,
@@ -7758,7 +7732,7 @@ function parseWorkflow(markdown, source) {
     ...tags ? { tags } : {},
     ...parameters ? { parameters } : {},
     steps,
-    source: { path, lineCount: totalLines }
+    source: { path: path2, lineCount: totalLines }
   };
   runSemanticChecks(draft, fmData, frontmatterEndLine, errors2);
   if (errors2.length > 0) {
@@ -7793,7 +7767,7 @@ function extractTitle(headings, errors2) {
   }
   return { title, titleLine: first.line };
 }
-function extractSteps(headings, lines, totalLines, path, errors2) {
+function extractSteps(headings, lines, totalLines, path2, errors2) {
   const steps = [];
   let sequenceIndex = 0;
   for (let i = 0;i < headings.length; i++) {
@@ -7809,11 +7783,11 @@ function extractSteps(headings, lines, totalLines, path, errors2) {
       continue;
     }
     const stepEnd = Math.min(findNextSiblingOrParentLine(headings, i, 2) - 1, totalLines);
-    const stepSource = { path, start: h.line, end: stepEnd };
+    const stepSource = { path: path2, start: h.line, end: stepEnd };
     const subsections = collectSubsections(headings, i, stepEnd);
     const stepIdSearchEnd = subsections.length > 0 ? subsections[0].headingLine - 1 : stepEnd;
     const stepId = scanStepId(lines, h.line + 1, stepIdSearchEnd, stepTitle, errors2);
-    const { instructions, completionCriteria } = collectStepBody(subsections, lines, path, stepTitle, errors2);
+    const { instructions, completionCriteria } = collectStepBody(subsections, lines, path2, stepTitle, errors2);
     if (!stepId)
       continue;
     if (!instructions) {
@@ -7853,7 +7827,7 @@ function collectSubsections(headings, stepIndex, stepEnd) {
   }
   return subs;
 }
-function collectStepBody(subsections, lines, path, stepTitle, errors2) {
+function collectStepBody(subsections, lines, path2, stepTitle, errors2) {
   let instructions;
   let completionCriteria;
   for (const sub of subsections) {
@@ -7875,7 +7849,7 @@ function collectStepBody(subsections, lines, path, stepTitle, errors2) {
       }
       instructions = {
         text,
-        source: { path, start: sub.bodyStart, end: sub.bodyEnd }
+        source: { path: path2, start: sub.bodyStart, end: sub.bodyEnd }
       };
       continue;
     }
@@ -7887,7 +7861,7 @@ function collectStepBody(subsections, lines, path, stepTitle, errors2) {
         });
         continue;
       }
-      const items = collectBullets(lines, sub.bodyStart, sub.bodyEnd, path);
+      const items = collectBullets(lines, sub.bodyStart, sub.bodyEnd, path2);
       if (items.length === 0) {
         errors2.push({
           line: sub.headingLine,
@@ -7936,7 +7910,7 @@ function scanStepId(lines, startLineInclusive, endLineInclusive, stepTitle, erro
   }
   return foundId;
 }
-function collectBullets(lines, startLineInclusive, endLineInclusive, path) {
+function collectBullets(lines, startLineInclusive, endLineInclusive, path2) {
   const items = [];
   for (let lineNum = startLineInclusive;lineNum <= endLineInclusive; lineNum++) {
     const trimmed = (lines[lineNum - 1] ?? "").trim();
@@ -7947,7 +7921,7 @@ function collectBullets(lines, startLineInclusive, endLineInclusive, path) {
       continue;
     items.push({
       text: match[1].trim(),
-      source: { path, start: lineNum, end: lineNum }
+      source: { path: path2, start: lineNum, end: lineNum }
     });
   }
   return items;
@@ -8016,7 +7990,7 @@ function readTags(data, errors2, fmEndLine) {
   }
   return v.map((tag) => tag.trim());
 }
-function readParameters(data, errors2, fmEndLine, path) {
+function readParameters(data, errors2, fmEndLine, path2) {
   const v = data.params;
   if (v === undefined || v === null)
     return;
@@ -8050,7 +8024,7 @@ function readParameters(data, errors2, fmEndLine, path) {
     out.push({
       name: trimmedName,
       description: desc.trim(),
-      source: { path, start: 1, end: fmEndLine }
+      source: { path: path2, start: 1, end: fmEndLine }
     });
   }
   return out.length > 0 ? out : undefined;
@@ -8061,6 +8035,7 @@ function sortErrors(errors2) {
 var WORKFLOW_TITLE_PREFIX = "Workflow:", STEP_PREFIX = "Step:", STEP_ID_LINE, BULLET_LINE, SUBSECTION_INSTRUCTIONS = "Instructions", SUBSECTION_COMPLETION_CRITERIA = "Completion Criteria";
 var init_parser = __esm(() => {
   init_dist();
+  init_frontmatter();
   init_markdown();
   init_validator();
   STEP_ID_LINE = /^Step ID:\s+(.+?)\s*$/;
@@ -8151,6 +8126,25 @@ function applyTocMetadata(entry, ctx) {
       entry.toc = toc.headings;
   } catch {}
 }
+function applyFactMetadata(entry, ctx) {
+  try {
+    const fm = applyFrontmatterDescriptionAndTags(entry, ctx);
+    const tags = new Set([...entry.tags ?? [], "fact"]);
+    const hints = new Set(entry.searchHints ?? []);
+    const category = asNonEmptyString(fm.category);
+    if (category) {
+      tags.add(category);
+      hints.add(`category:${category}`);
+    }
+    if (fm.pinned === true) {
+      tags.add("pinned");
+      hints.add("pinned");
+    }
+    entry.tags = Array.from(tags).filter(Boolean);
+    if (hints.size > 0)
+      entry.searchHints = Array.from(hints).filter(Boolean);
+  } catch {}
+}
 function applyFrontmatterDescriptionAndTags(entry, ctx) {
   const parsed = parseFrontmatter(ctx.content());
   const fm = parsed.data;
@@ -8250,6 +8244,7 @@ function applyTaskMetadata(entry, ctx) {
 }
 var init_renderers = __esm(() => {
   init_env();
+  init_frontmatter();
   init_markdown();
   init_common();
   init_metadata();
@@ -8296,6 +8291,11 @@ var init_renderers = __esm(() => {
     appliesTo: ({ rendererName }) => rendererName === "session-md",
     contribute: (entry, ctx) => applySessionMetadata(entry, ctx.renderContext)
   });
+  registerMetadataContributor({
+    name: "fact-md-metadata",
+    appliesTo: ({ rendererName }) => rendererName === "fact-md",
+    contribute: (entry, ctx) => applyFactMetadata(entry, ctx.renderContext)
+  });
 });
 
 // src/core/asset/asset-registry.ts
@@ -8304,7 +8304,7 @@ var init_asset_registry = __esm(() => {
 });
 
 // src/core/asset/asset-spec.ts
-import path from "path";
+import path2 from "path";
 function getAssetTypes() {
   return Object.keys(ASSET_SPECS_INTERNAL);
 }
@@ -8314,14 +8314,14 @@ var init_asset_spec = __esm(() => {
   init_common();
   init_asset_registry();
   markdownSpec = {
-    isRelevantFile: (fileName) => path.extname(fileName).toLowerCase() === ".md",
+    isRelevantFile: (fileName) => path2.extname(fileName).toLowerCase() === ".md",
     toCanonicalName: (typeRoot, filePath) => {
-      const rel = toPosix(path.relative(typeRoot, filePath));
+      const rel = toPosix(path2.relative(typeRoot, filePath));
       return rel.endsWith(".md") ? rel.slice(0, -3) : rel;
     },
     toAssetPath: (typeRoot, name) => {
       const withExt = name.endsWith(".md") ? name : `${name}.md`;
-      return path.join(typeRoot, withExt);
+      return path2.join(typeRoot, withExt);
     }
   };
   SCRIPT_EXTENSIONS = new Set([
@@ -8343,21 +8343,21 @@ var init_asset_spec = __esm(() => {
     ".kts"
   ]);
   scriptSpec = {
-    isRelevantFile: (fileName) => SCRIPT_EXTENSIONS.has(path.extname(fileName).toLowerCase()),
-    toCanonicalName: (typeRoot, filePath) => toPosix(path.relative(typeRoot, filePath)),
-    toAssetPath: (typeRoot, name) => path.join(typeRoot, name)
+    isRelevantFile: (fileName) => SCRIPT_EXTENSIONS.has(path2.extname(fileName).toLowerCase()),
+    toCanonicalName: (typeRoot, filePath) => toPosix(path2.relative(typeRoot, filePath)),
+    toAssetPath: (typeRoot, name) => path2.join(typeRoot, name)
   };
   ASSET_SPECS_INTERNAL = {
     skill: {
       stashDir: "skills",
       isRelevantFile: (fileName) => fileName === "SKILL.md",
       toCanonicalName: (typeRoot, filePath) => {
-        const relDir = toPosix(path.dirname(path.relative(typeRoot, filePath)));
+        const relDir = toPosix(path2.dirname(path2.relative(typeRoot, filePath)));
         if (!relDir || relDir === ".")
           return;
         return relDir;
       },
-      toAssetPath: (typeRoot, name) => path.join(typeRoot, name, "SKILL.md")
+      toAssetPath: (typeRoot, name) => path2.join(typeRoot, name, "SKILL.md")
     },
     command: { stashDir: "commands", ...markdownSpec },
     agent: { stashDir: "agents", ...markdownSpec },
@@ -8374,10 +8374,10 @@ var init_asset_spec = __esm(() => {
       stashDir: "env",
       isRelevantFile: (fileName) => fileName === ".env" || fileName.endsWith(".env"),
       toCanonicalName: (typeRoot, filePath) => {
-        const rel = toPosix(path.relative(typeRoot, filePath));
-        const fileName = path.basename(rel);
+        const rel = toPosix(path2.relative(typeRoot, filePath));
+        const fileName = path2.basename(rel);
         if (fileName === ".env") {
-          const dir = path.dirname(rel);
+          const dir = path2.dirname(rel);
           return dir === "." || dir === "" ? "default" : `${dir}/default`;
         }
         const stripped = rel.endsWith(".env") ? rel.slice(0, -4) : rel;
@@ -8385,8 +8385,8 @@ var init_asset_spec = __esm(() => {
       },
       toAssetPath: (typeRoot, name) => {
         if (name === "default")
-          return path.join(typeRoot, ".env");
-        return path.join(typeRoot, name.endsWith(".env") ? name : `${name}.env`);
+          return path2.join(typeRoot, ".env");
+        return path2.join(typeRoot, name.endsWith(".env") ? name : `${name}.env`);
       },
       rendererName: "env-file",
       actionBuilder: (ref) => `akm show ${ref} -> inspect key names; akm env run ${ref} -- <command> -> run with the whole .env injected (values never reach stdout); akm env export ${ref} --out <file> -> write a sourceable script to a file`
@@ -8394,8 +8394,8 @@ var init_asset_spec = __esm(() => {
     secret: {
       stashDir: "secrets",
       isRelevantFile: (fileName) => !fileName.endsWith(".lock") && !fileName.endsWith(".sensitive"),
-      toCanonicalName: (typeRoot, filePath) => toPosix(path.relative(typeRoot, filePath)),
-      toAssetPath: (typeRoot, name) => path.join(typeRoot, name),
+      toCanonicalName: (typeRoot, filePath) => toPosix(path2.relative(typeRoot, filePath)),
+      toAssetPath: (typeRoot, name) => path2.join(typeRoot, name),
       rendererName: "secret-file",
       actionBuilder: (ref) => `akm show ${ref} -> name only (value never shown); akm secret path ${ref} -> file path; akm secret run ${ref} <VAR> -- <command> -> run with value injected into $VAR`
     },
@@ -8413,14 +8413,14 @@ var init_asset_spec = __esm(() => {
     },
     task: {
       stashDir: "tasks",
-      isRelevantFile: (fileName) => path.extname(fileName).toLowerCase() === ".yml",
+      isRelevantFile: (fileName) => path2.extname(fileName).toLowerCase() === ".yml",
       toCanonicalName: (typeRoot, filePath) => {
-        const rel = toPosix(path.relative(typeRoot, filePath));
+        const rel = toPosix(path2.relative(typeRoot, filePath));
         return rel.endsWith(".yml") ? rel.slice(0, -4) : rel;
       },
       toAssetPath: (typeRoot, name) => {
         const withExt = name.endsWith(".yml") ? name : `${name}.yml`;
-        return path.join(typeRoot, withExt);
+        return path2.join(typeRoot, withExt);
       },
       rendererName: "task-yaml",
       actionBuilder: buildTaskAction
@@ -8430,6 +8430,12 @@ var init_asset_spec = __esm(() => {
       ...markdownSpec,
       rendererName: "session-md",
       actionBuilder: (ref) => `akm show ${ref} -> read the session summary; follow the \`access\` frontmatter to open the raw log at \`log_path\``
+    },
+    fact: {
+      stashDir: "facts",
+      ...markdownSpec,
+      rendererName: "fact-md",
+      actionBuilder: (ref) => `akm show ${ref} -> read the stash fact and apply it as durable context`
     }
   };
   TYPE_DIRS = Object.fromEntries(Object.entries(ASSET_SPECS_INTERNAL).map(([type, spec]) => [type, spec.stashDir]));
@@ -8457,7 +8463,7 @@ var init_common = __esm(() => {
 });
 
 // src/core/paths.ts
-import path2 from "path";
+import path3 from "path";
 function isUnderBunTest(env) {
   return env.BUN_TEST === "1" || env.NODE_ENV === "test";
 }
@@ -8474,23 +8480,23 @@ function getDataDir(env = process.env, platform = process.platform) {
   if (platform === "win32") {
     const localAppData = env.LOCALAPPDATA?.trim();
     if (localAppData)
-      return path2.join(localAppData, "akm", "data");
+      return path3.join(localAppData, "akm", "data");
     const userProfile = env.USERPROFILE?.trim();
     if (userProfile)
-      return path2.join(userProfile, "AppData", "Local", "akm", "data");
+      return path3.join(userProfile, "AppData", "Local", "akm", "data");
     const appData = env.APPDATA?.trim();
     if (!appData) {
       throw new ConfigError("Unable to determine data directory. Set LOCALAPPDATA, USERPROFILE, or APPDATA.", "CONFIG_DIR_UNRESOLVABLE");
     }
-    return path2.join(appData, "..", "Local", "akm", "data");
+    return path3.join(appData, "..", "Local", "akm", "data");
   }
   const xdgDataHome = env.XDG_DATA_HOME?.trim();
   if (xdgDataHome)
-    return path2.join(xdgDataHome, "akm");
+    return path3.join(xdgDataHome, "akm");
   const home = env.HOME?.trim();
   if (!home)
-    return path2.join("/tmp", "akm-data");
-  return path2.join(home, ".local", "share", "akm");
+    return path3.join("/tmp", "akm-data");
+  return path3.join(home, ".local", "share", "akm");
 }
 var init_paths = __esm(() => {
   init_common();
@@ -8498,22 +8504,40 @@ var init_paths = __esm(() => {
 });
 
 // scripts/migrations/import-fs-improve-runs-to-db.ts
-import fs4 from "fs";
-import path4 from "path";
+import fs5 from "fs";
+import path5 from "path";
 
 // src/core/state-db.ts
-import fs3 from "fs";
-import path3 from "path";
+import path4 from "path";
+
+// src/storage/managed-db.ts
+import fs2 from "fs";
+import path from "path";
 
 // src/storage/database.ts
 import { createRequire } from "module";
 var isBun = !!process.versions?.bun;
 var nodeRequire = createRequire(import.meta.url);
-function openDatabase(path, opts) {
-  if (isBun) {
-    return openBunDatabase(path, opts);
+var bunSqliteProvider = {
+  name: "bun:sqlite",
+  supported: () => isBun,
+  open: openBunDatabase
+};
+var nodeSqliteProvider = {
+  name: "better-sqlite3",
+  supported: () => !isBun,
+  open: openNodeDatabase
+};
+var PROVIDERS = [bunSqliteProvider, nodeSqliteProvider];
+function selectProvider() {
+  const provider = PROVIDERS.find((p) => p.supported());
+  if (!provider) {
+    throw new Error(`No storage provider supports the current runtime (${isBun ? "Bun" : "Node"}).`);
   }
-  return openNodeDatabase(path, opts);
+  return provider;
+}
+function openDatabase(path, opts) {
+  return selectProvider().open(path, opts);
 }
 function openBunDatabase(path, opts) {
   const { Database: BunDatabase } = loadBunSqlite();
@@ -8538,7 +8562,16 @@ function loadBunSqlite() {
 var betterSqlite3Ctor;
 function loadBetterSqlite3() {
   if (!betterSqlite3Ctor) {
-    const mod = nodeRequire("better-sqlite3");
+    let mod;
+    try {
+      mod = nodeRequire("better-sqlite3");
+    } catch (err) {
+      throw new Error(`akm could not load 'better-sqlite3', the SQLite driver it needs on Node.js.
+` + `  \u2022 Reinstall akm with a working C/C++ build toolchain so its optional
+` + "    'better-sqlite3' native binding rebuilds (a global `npm i -g better-sqlite3`\n" + `    will NOT be resolved \u2014 Node loads it from akm's own node_modules).
+` + `  \u2022 Or run akm under Bun, which has a built-in SQLite driver and needs no native build.
+` + `  Underlying load error: ${err instanceof Error ? err.message : String(err)}`);
+    }
     betterSqlite3Ctor = mod.default ?? mod;
   }
   return betterSqlite3Ctor;
@@ -8554,28 +8587,104 @@ function openNodeDatabase(path, opts) {
   return db;
 }
 
-// src/storage/engines/sqlite-migrations.ts
-function ensureMigrationsTable(db) {
-  db.exec(`
-    CREATE TABLE IF NOT EXISTS schema_migrations (
-      id         TEXT    PRIMARY KEY,
-      applied_at TEXT    NOT NULL DEFAULT (datetime('now'))
-    );
-  `);
+// src/storage/sqlite-pragmas.ts
+init_warn();
+
+// src/runtime.ts
+import { createWriteStream, statfsSync } from "fs";
+import { createRequire as createRequire2 } from "module";
+var isBun2 = !!process.versions?.bun;
+var nodeRequire2 = createRequire2(import.meta.url);
+function statfsType(path) {
+  try {
+    return statfsSync(path).type;
+  } catch {
+    return;
+  }
 }
-function runMigrations(db, migrations, opts) {
-  ensureMigrationsTable(db);
-  opts?.bootstrap?.(db);
-  const appliedRows = db.prepare("SELECT id FROM schema_migrations").all();
-  const applied = new Set(appliedRows.map((r) => r.id));
-  for (const migration of migrations) {
-    if (applied.has(migration.id))
-      continue;
-    db.transaction(() => {
-      db.exec(migration.up);
-      db.prepare("INSERT INTO schema_migrations (id) VALUES (?)").run(migration.id);
-    })();
+var mainPath = isBun2 ? bunGlobal().main : process.argv[1];
+function bunGlobal() {
+  return globalThis.Bun;
+}
+
+// src/storage/sqlite-pragmas.ts
+var VALID_MODES = new Set(["WAL", "DELETE", "TRUNCATE"]);
+var warnedInvalid = false;
+var warnedNetworkFallback = false;
+function resolveJournalMode(raw) {
+  if (raw === undefined)
+    return "WAL";
+  const normalized = raw.trim().toUpperCase();
+  if (normalized === "")
+    return "WAL";
+  if (VALID_MODES.has(normalized)) {
+    return normalized;
+  }
+  warnInvalidJournalModeOnce(raw);
+  return "WAL";
+}
+function resolveConfiguredJournalMode() {
+  return resolveJournalMode(process.env.AKM_SQLITE_JOURNAL_MODE);
+}
+function warnInvalidJournalModeOnce(raw) {
+  if (warnedInvalid)
+    return;
+  warnedInvalid = true;
+  warn(`[akm] invalid AKM_SQLITE_JOURNAL_MODE=${JSON.stringify(raw)} \u2014 using WAL (valid: WAL, DELETE, TRUNCATE)`);
+}
+var FS_MAGIC_NFS = 26985;
+var FS_MAGIC_SMB = 20859;
+var FS_MAGIC_CIFS = 4283649346;
+var FS_MAGIC_SMB2 = 4266872130;
+var FS_MAGIC_FUSE = 1702057286;
+var NETWORK_FS_MAGICS = new Set([
+  FS_MAGIC_NFS,
+  FS_MAGIC_SMB,
+  FS_MAGIC_CIFS,
+  FS_MAGIC_SMB2,
+  FS_MAGIC_FUSE
+]);
+function isNetworkFilesystem(fsType) {
+  if (fsType === undefined)
+    return false;
+  return NETWORK_FS_MAGICS.has(fsType);
+}
+function applyStandardPragmas(db, opts = {}) {
+  let mode = resolveConfiguredJournalMode();
+  if (mode === "WAL" && opts.dataDir) {
+    const probe = opts.fsTypeProbe ?? statfsType;
+    if (isNetworkFilesystem(probe(opts.dataDir))) {
+      mode = "DELETE";
+      warnNetworkFallbackOnce(opts.dataDir);
+    }
   }
+  db.exec("PRAGMA busy_timeout = 30000");
+  db.exec(`PRAGMA journal_mode = ${mode}`);
+  if (opts.foreignKeys !== false) {
+    db.exec("PRAGMA foreign_keys = ON");
+  }
+  if (mode !== "WAL") {
+    db.exec("PRAGMA synchronous = FULL");
+  }
+  return mode;
+}
+function warnNetworkFallbackOnce(dataDir) {
+  if (warnedNetworkFallback)
+    return;
+  warnedNetworkFallback = true;
+  warn(`[akm] network filesystem detected at ${dataDir} \u2014 WAL unsupported, using DELETE journal mode`);
+}
+
+// src/storage/managed-db.ts
+function openManagedDatabase(spec) {
+  const dir = path.dirname(spec.path);
+  if (!fs2.existsSync(dir)) {
+    fs2.mkdirSync(dir, { recursive: true });
+  }
+  const db = openDatabase(spec.path);
+  applyStandardPragmas(db, spec.pragmas ?? { dataDir: dir });
+  spec.init?.(db);
+  return db;
 }
 
 // src/core/assert.ts
@@ -8604,6 +8713,7 @@ function classifyImproveAction(mode) {
     case "reflect-cooldown":
     case "reflect-skipped":
     case "distill-skipped":
+      return "skipped";
     case "reflect-guard-rejected":
       return "rejected";
     case "reflect-failed":
@@ -8619,22 +8729,32 @@ function classifyImproveAction(mode) {
 // src/core/state-db.ts
 init_paths();
 init_warn();
-function getStateDbPath() {
-  return path3.join(getDataDir(), "state.db");
+
+// src/storage/engines/sqlite-migrations.ts
+function ensureMigrationsTable(db) {
+  db.exec(`
+    CREATE TABLE IF NOT EXISTS schema_migrations (
+      id         TEXT    PRIMARY KEY,
+      applied_at TEXT    NOT NULL DEFAULT (datetime('now'))
+    );
+  `);
 }
-function openStateDatabase(dbPath) {
-  const resolvedPath = dbPath ?? getStateDbPath();
-  const dir = path3.dirname(resolvedPath);
-  if (!fs3.existsSync(dir)) {
-    fs3.mkdirSync(dir, { recursive: true });
-  }
-  const db = openDatabase(resolvedPath);
-  db.exec("PRAGMA journal_mode = WAL");
-  db.exec("PRAGMA foreign_keys = ON");
-  db.exec("PRAGMA busy_timeout = 30000");
-  runMigrations2(db);
-  return db;
+function runMigrations(db, migrations, opts) {
+  ensureMigrationsTable(db);
+  opts?.bootstrap?.(db);
+  const appliedRows = db.prepare("SELECT id FROM schema_migrations").all();
+  const applied = new Set(appliedRows.map((r) => r.id));
+  for (const migration of migrations) {
+    if (applied.has(migration.id))
+      continue;
+    db.transaction(() => {
+      db.exec(migration.up);
+      db.prepare("INSERT INTO schema_migrations (id) VALUES (?)").run(migration.id);
+    })();
+  }
 }
+
+// src/core/state/migrations.ts
 var MIGRATIONS = [
   {
     id: "001-initial-schema",
@@ -8708,7 +8828,7 @@ var MIGRATIONS = [
       --   metadata_json TEXT      \u2014 JSON object for future proposal fields.
       --                             Current fields stored here: sourceRun,
       --                             review, confidence, gateDecision (#577),
-      --                             backupContent.
+      --                             backupContent, eligibilitySource.
       --
       -- ADD COLUMN extension points (future migrations):
       --   ALTER TABLE proposals ADD COLUMN source_run TEXT DEFAULT NULL;
@@ -8905,17 +9025,143 @@ var MIGRATIONS = [
         imported_count INTEGER NOT NULL DEFAULT 0
       );
     `
+  },
+  {
+    id: "006-proposals-pending-ref-source",
+    up: `
+      CREATE INDEX IF NOT EXISTS idx_proposals_stash_status_ref_source
+        ON proposals(stash_dir, status, ref, source);
+    `
+  },
+  {
+    id: "007-consolidation-judged",
+    up: `
+      CREATE TABLE IF NOT EXISTS consolidation_judged (
+        entry_key    TEXT    PRIMARY KEY,
+        content_hash TEXT    NOT NULL,
+        judged_at    TEXT    NOT NULL,
+        outcome      TEXT    NOT NULL
+      );
+    `
+  },
+  {
+    id: "008-body-embeddings",
+    up: `
+      CREATE TABLE IF NOT EXISTS body_embeddings (
+        content_hash TEXT    PRIMARY KEY,
+        embedding    BLOB    NOT NULL,
+        model_id     TEXT    NOT NULL,
+        created_at   INTEGER NOT NULL
+      );
+    `
+  },
+  {
+    id: "009-asset-salience",
+    up: `
+      CREATE TABLE IF NOT EXISTS asset_salience (
+        asset_ref          TEXT    PRIMARY KEY,
+        encoding_salience  REAL    NOT NULL DEFAULT 0.5,
+        outcome_salience   REAL    NOT NULL DEFAULT 0.0,
+        retrieval_salience REAL    NOT NULL DEFAULT 0.0,
+        rank_score         REAL    NOT NULL DEFAULT 0.0,
+        consecutive_no_ops INTEGER NOT NULL DEFAULT 0,
+        updated_at         INTEGER NOT NULL DEFAULT 0
+      );
+
+      -- Hot path: sort / filter by rank_score for selector queries.
+      CREATE INDEX IF NOT EXISTS idx_asset_salience_rank
+        ON asset_salience(rank_score DESC);
+    `
+  },
+  {
+    id: "010-asset-outcome",
+    up: `
+      CREATE TABLE IF NOT EXISTS asset_outcome (
+        asset_ref                TEXT    PRIMARY KEY,
+        last_retrieved_at        INTEGER NOT NULL DEFAULT 0,
+        retrieval_count          INTEGER NOT NULL DEFAULT 0,
+        expected_retrieval_rate  REAL    NOT NULL DEFAULT 0.0,
+        negative_feedback_count  INTEGER NOT NULL DEFAULT 0,
+        accepted_change_count    INTEGER NOT NULL DEFAULT 0,
+        review_pressure          INTEGER NOT NULL DEFAULT 0,
+        outcome_score            REAL    NOT NULL DEFAULT 0.0,
+        updated_at               INTEGER NOT NULL DEFAULT 0
+      );
+
+      -- Hot path: sort assets by review_pressure DESC for #613 admission.
+      CREATE INDEX IF NOT EXISTS idx_asset_outcome_review_pressure
+        ON asset_outcome(review_pressure DESC);
+
+      -- Secondary: sort by outcome_score DESC for outcomeSalience reads.
+      CREATE INDEX IF NOT EXISTS idx_asset_outcome_score
+        ON asset_outcome(outcome_score DESC);
+    `
+  },
+  {
+    id: "011-asset-salience-homeostatic-demoted-at",
+    up: `
+      ALTER TABLE asset_salience ADD COLUMN homeostatic_demoted_at INTEGER DEFAULT NULL;
+    `
+  },
+  {
+    id: "012-improve-gate-thresholds",
+    up: `
+      CREATE TABLE IF NOT EXISTS improve_gate_thresholds (
+        phase       TEXT    NOT NULL PRIMARY KEY,
+        threshold   INTEGER NOT NULL,
+        updated_at  INTEGER NOT NULL
+      );
+    `
+  },
+  {
+    id: "013-extract-sessions-content-hash",
+    up: `
+      ALTER TABLE extract_sessions_seen ADD COLUMN content_hash TEXT DEFAULT NULL;
+    `
+  },
+  {
+    id: "014-recombine-hypotheses",
+    up: `
+      CREATE TABLE IF NOT EXISTS recombine_hypotheses (
+        hypothesis_ref    TEXT PRIMARY KEY,
+        signature         TEXT NOT NULL,
+        member_key        TEXT NOT NULL,
+        consecutive_count INTEGER NOT NULL DEFAULT 0,
+        first_seen_at     TEXT NOT NULL,
+        last_seen_at      TEXT NOT NULL,
+        last_run          TEXT,
+        promoted_at       TEXT,
+        metadata_json     TEXT NOT NULL DEFAULT '{}'
+      );
+      CREATE INDEX IF NOT EXISTS idx_recombine_hypotheses_last_seen
+        ON recombine_hypotheses(last_seen_at);
+    `
+  },
+  {
+    id: "015-asset-salience-encoding-source",
+    up: `
+      ALTER TABLE asset_salience ADD COLUMN encoding_source TEXT DEFAULT NULL;
+    `
   }
 ];
 function runMigrations2(db) {
   runMigrations(db, MIGRATIONS);
 }
+
+// src/core/state-db.ts
+function getStateDbPath() {
+  return path4.join(getDataDir(), "state.db");
+}
+function openStateDatabase(dbPath) {
+  return openManagedDatabase({ path: dbPath ?? getStateDbPath(), init: runMigrations2 });
+}
 function computeImproveRunMetrics(result) {
   const plannedCount = Array.isArray(result.plannedRefs) ? result.plannedRefs.length : 0;
   const actions = Array.isArray(result.actions) ? result.actions : [];
   const actionsCount = actions.length;
   let acceptedCount = 0;
   let rejectedCount = 0;
+  let skippedCount = 0;
   let autoAcceptedCount = 0;
   let errorCount = 0;
   for (const action of actions) {
@@ -8926,6 +9172,9 @@ function computeImproveRunMetrics(result) {
       case "rejected":
         rejectedCount++;
         break;
+      case "skipped":
+        skippedCount++;
+        break;
       case "error":
         errorCount++;
         break;
@@ -8937,7 +9186,7 @@ function computeImproveRunMetrics(result) {
       autoAcceptedCount++;
   }
   autoAcceptedCount += result.gateAutoAcceptedCount ?? 0;
-  return { plannedCount, actionsCount, acceptedCount, rejectedCount, autoAcceptedCount, errorCount };
+  return { plannedCount, actionsCount, acceptedCount, rejectedCount, skippedCount, autoAcceptedCount, errorCount };
 }
 function recordImproveRun(db, input) {
   const metricsObj = input.metrics ?? computeImproveRunMetrics(input.result);
@@ -8953,7 +9202,7 @@ function recordImproveRun(db, input) {
 function parseArgs(argv) {
   const stashFromEnv = process.env.AKM_STASH_DIR;
   const out = {
-    stashDir: stashFromEnv ?? path4.join(process.env.HOME ?? "", "akm"),
+    stashDir: stashFromEnv ?? path5.join(process.env.HOME ?? "", "akm"),
     dryRun: false,
     archive: true
   };
@@ -9012,12 +9261,12 @@ function inferScope(envelope) {
 }
 async function main() {
   const args = parseArgs(process.argv.slice(2));
-  const runsRoot = path4.join(args.stashDir, ".akm", "runs");
-  if (!fs4.existsSync(runsRoot)) {
+  const runsRoot = path5.join(args.stashDir, ".akm", "runs");
+  if (!fs5.existsSync(runsRoot)) {
     console.log(`[import] no legacy runs directory at ${runsRoot}; nothing to do`);
     return;
   }
-  const entries = fs4.readdirSync(runsRoot, { withFileTypes: true }).filter((e) => e.isDirectory()).map((e) => e.name).sort();
+  const entries = fs5.readdirSync(runsRoot, { withFileTypes: true }).filter((e) => e.isDirectory()).map((e) => e.name).sort();
   if (entries.length === 0) {
     console.log(`[import] ${runsRoot} is empty; nothing to do`);
     return;
@@ -9031,8 +9280,8 @@ async function main() {
   let skippedParseFailed = 0;
   let skippedNoTimestamp = 0;
   for (const id of entries) {
-    const resultPath = path4.join(runsRoot, id, "improve-result.json");
-    if (!fs4.existsSync(resultPath)) {
+    const resultPath = path5.join(runsRoot, id, "improve-result.json");
+    if (!fs5.existsSync(resultPath)) {
       skippedNoResult++;
       continue;
     }
@@ -9042,7 +9291,7 @@ async function main() {
     }
     let envelope;
     try {
-      envelope = JSON.parse(fs4.readFileSync(resultPath, "utf8"));
+      envelope = JSON.parse(fs5.readFileSync(resultPath, "utf8"));
     } catch (err) {
       console.warn(`[import] skipping ${id}: parse failed (${err instanceof Error ? err.message : String(err)})`);
       skippedParseFailed++;
@@ -9107,8 +9356,8 @@ async function main() {
     return;
   }
   const ts = new Date().toISOString().replace(/[:.]/g, "-");
-  const archiveTarget = path4.join(args.stashDir, ".akm", `runs.archived-${ts}`);
-  fs4.renameSync(runsRoot, archiveTarget);
+  const archiveTarget = path5.join(args.stashDir, ".akm", `runs.archived-${ts}`);
+  fs5.renameSync(runsRoot, archiveTarget);
   console.log(`[import] archived ${runsRoot} \u2192 ${archiveTarget}`);
 }
 main().catch((err) => {