akm-cli 0.9.0-beta.45 → 0.9.0-beta.46

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

@@ -62,8 +62,8 @@ var init_warn = () => {};
 
 // node_modules/dotenv/lib/main.js
 var require_main = __commonJS((exports, module) => {
-  var fs2 = __require("fs");
-  var path = __require("path");
+  var fs3 = __require("fs");
+  var path2 = __require("path");
   var os = __require("os");
   var crypto = __require("crypto");
   var TIPS = [
@@ -196,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 (fs2.existsSync(filepath)) {
+          if (fs3.existsSync(filepath)) {
             possibleVaultPath = filepath.endsWith(".vault") ? filepath : `${filepath}.vault`;
           }
         }
@@ -204,15 +204,15 @@ 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 (fs2.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);
@@ -229,7 +229,7 @@ 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) {
@@ -257,13 +257,13 @@ 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(fs2.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;
       }
@@ -276,7 +276,7 @@ var require_main = __commonJS((exports, module) => {
       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) {
@@ -438,7 +438,7 @@ var init_errors = __esm(() => {
 });
 
 // src/commands/env/env.ts
-import fs2 from "fs";
+import fs3 from "fs";
 function scanKeys(text) {
   const keys = [];
   const seen = new Set;
@@ -465,9 +465,9 @@ function scanComments(text) {
   return comments;
 }
 function listKeys(envPath) {
-  if (!fs2.existsSync(envPath))
+  if (!fs3.existsSync(envPath))
     return { keys: [], comments: [] };
-  const text = fs2.readFileSync(envPath, "utf8");
+  const text = fs3.readFileSync(envPath, "utf8");
   return { keys: scanKeys(text), comments: scanComments(text) };
 }
 var import_dotenv, ASSIGN_RE;
@@ -550,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)
@@ -571,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)
@@ -598,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)
@@ -619,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)
@@ -652,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)) {
@@ -1227,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;
@@ -1249,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) {
@@ -1270,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);
@@ -1284,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);
@@ -1294,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;
@@ -1310,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 {
@@ -3711,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) {
@@ -3762,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) {
@@ -3794,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 = {}) {
@@ -5695,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];
@@ -5706,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)
@@ -5733,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;
 });
@@ -7005,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;
@@ -7140,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":
@@ -7583,11 +7583,11 @@ var init_metadata_contributors = __esm(() => {
 });
 
 // src/indexer/passes/metadata.ts
-import fs3 from "fs";
+import fs4 from "fs";
 function extractDescriptionFromComments(filePath) {
   let content;
   try {
-    content = fs3.readFileSync(filePath, "utf8");
+    content = fs4.readFileSync(filePath, "utf8");
   } catch {
     return null;
   }
@@ -7693,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);
@@ -7701,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) {
@@ -7718,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,
@@ -7732,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) {
@@ -7767,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++) {
@@ -7783,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) {
@@ -7827,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) {
@@ -7849,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;
     }
@@ -7861,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,
@@ -7910,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();
@@ -7921,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;
@@ -7990,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;
@@ -8024,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;
@@ -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
@@ -8463,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";
 }
@@ -8480,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();
@@ -8505,21 +8505,39 @@ var init_paths = __esm(() => {
 
 // scripts/migrations/import-fs-improve-runs-to-db.ts
 import fs5 from "fs";
-import path4 from "path";
+import path5 from "path";
 
 // src/core/state-db.ts
-import fs4 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();
@@ -8544,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;
@@ -8560,30 +8587,6 @@ 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'))
-    );
-  `);
-}
-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/storage/sqlite-pragmas.ts
 init_warn();
 
@@ -8672,6 +8675,18 @@ function warnNetworkFallbackOnce(dataDir) {
   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
 function assertNever(x, context) {
   let serialized;
@@ -8713,20 +8728,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 (!fs4.existsSync(dir)) {
-    fs4.mkdirSync(dir, { recursive: true });
-  }
-  const db = openDatabase(resolvedPath);
-  applyStandardPragmas(db, { dataDir: dir });
-  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",
@@ -9119,6 +9146,14 @@ var MIGRATIONS = [
 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 : [];
@@ -9162,7 +9197,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
   };
@@ -9221,7 +9256,7 @@ function inferScope(envelope) {
 }
 async function main() {
   const args = parseArgs(process.argv.slice(2));
-  const runsRoot = path4.join(args.stashDir, ".akm", "runs");
+  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;
@@ -9240,7 +9275,7 @@ async function main() {
   let skippedParseFailed = 0;
   let skippedNoTimestamp = 0;
   for (const id of entries) {
-    const resultPath = path4.join(runsRoot, id, "improve-result.json");
+    const resultPath = path5.join(runsRoot, id, "improve-result.json");
     if (!fs5.existsSync(resultPath)) {
       skippedNoResult++;
       continue;
@@ -9316,7 +9351,7 @@ async function main() {
     return;
   }
   const ts = new Date().toISOString().replace(/[:.]/g, "-");
-  const archiveTarget = path4.join(args.stashDir, ".akm", `runs.archived-${ts}`);
+  const archiveTarget = path5.join(args.stashDir, ".akm", `runs.archived-${ts}`);
   fs5.renameSync(runsRoot, archiveTarget);
   console.log(`[import] archived ${runsRoot} \u2192 ${archiveTarget}`);
 }