@akanjs/cli 3.0.0-alpha.10 → 3.0.0-alpha.100

package/{index-wnp7hwq7.js → index-92zztqy1.js}

@@ -5,7 +5,7 @@ import * as path from "path";
 import chalk from "chalk";
 import * as ts from "typescript";
 
-class TypeChecker {
+class TypeChecker2 {
   configPath;
   configFile;
   config;
@@ -143,12 +143,12 @@ ${summary.join(", ")} found${output.join(`
     try {
       const { diagnostics } = this.check(filePath);
       return diagnostics.length === 0;
-    } catch (error) {
+    } catch (_error) {
       return false;
     }
   }
   static checkProject(configPath) {
-    const parsedConfig = TypeChecker.parseConfig(configPath);
+    const parsedConfig = TypeChecker2.parseConfig(configPath);
     const host = ts.createIncrementalCompilerHost(parsedConfig.options);
     const builderProgram = ts.createIncrementalProgram({
       rootNames: parsedConfig.fileNames,
@@ -166,19 +166,19 @@ ${summary.join(", ")} found${output.join(`
       diagnostics,
       errors,
       warnings,
-      message: TypeChecker.formatDiagnosticMessages(diagnostics)
+      message: TypeChecker2.formatDiagnosticMessages(diagnostics)
     };
   }
   static parseConfig(configPath) {
     const configFile = ts.readConfigFile(configPath, (fileName) => ts.sys.readFile(fileName));
     const configDiagnostics = configFile.error ? [configFile.error] : [];
     if (!configFile.config) {
-      const message = TypeChecker.formatDiagnosticMessages(configDiagnostics);
+      const message = TypeChecker2.formatDiagnosticMessages(configDiagnostics);
       throw new Error(message || `Error reading tsconfig.json: ${configPath}`);
     }
     const parsedConfig = ts.parseJsonConfigFileContent(configFile.config, ts.sys, path.dirname(configPath), undefined, configPath);
     if (parsedConfig.errors.length > 0)
-      throw new Error(TypeChecker.formatDiagnosticMessages(parsedConfig.errors));
+      throw new Error(TypeChecker2.formatDiagnosticMessages(parsedConfig.errors));
     return parsedConfig;
   }
   static formatDiagnosticMessages(diagnostics) {
@@ -190,4 +190,4 @@ ${summary.join(", ")} found${output.join(`
   }
 }
 
-export { TypeChecker };
+export { TypeChecker2 };

package/{index-fgc8r6dj.js → index-a5vmm6x4.js}

@@ -19,12 +19,14 @@ var prepareDevWatchBatch = ({
     generatedFiles: indexSync.changedFiles
   });
   if (indexSync.errors.length > 0 && !devPlan.actions.includes("report-error")) {
-    devPlan.actions = [...devPlan.actions, "report-error"].sort();
+    const withReport = [...devPlan.actions, "report-error"];
+    devPlan.actions = withReport.sort();
   }
   return {
     files,
     kinds,
     expandedBatch,
+    devPlan,
     event: { type: "invalidate", kinds, files, generation, devPlan },
     hasSyncErrors: indexSync.errors.length > 0
   };

package/{index-xys926f2.js → index-by5gpp8x.js}

@@ -2,7 +2,7 @@
 // pkgs/@akanjs/devkit/recipeScanner.ts
 import { readdir } from "fs/promises";
 import ts from "typescript";
-var collectRecipeSources = async (uiDirPath, importFrom, basename = "Recipe") => {
+var collectRecipeSources2 = async (uiDirPath, importFrom, basename = "Recipe") => {
   const read = async (filePath) => {
     const content = await Bun.file(filePath).text().catch(() => "");
     return content ? { path: filePath, content, importFrom } : null;
@@ -12,7 +12,7 @@ var collectRecipeSources = async (uiDirPath, importFrom, basename = "Recipe") =>
   const fromDir = await Promise.all(dirEntries.filter((entry) => entry.endsWith(".ts") && entry !== "index.ts" && !/\.(test|spec)\.ts$/.test(entry)).sort().map((entry) => read(`${uiDirPath}/${basename}/${entry}`)));
   return [flat, ...fromDir].filter((source) => !!source);
 };
-var scanRecipes = (sources) => {
+var scanRecipes2 = (sources) => {
   const recipes = [];
   for (const source of sources) {
     const sourceFile = ts.createSourceFile(source.path, source.content, ts.ScriptTarget.Latest, true, ts.ScriptKind.TSX);
@@ -87,7 +87,7 @@ var isNamed = (name) => ts.isIdentifier(name) || ts.isStringLiteral(name);
 var propName = (name) => name.text;
 var DUPLICATE_TOKEN_RATIO = 0.7;
 var MIN_FINGERPRINT_TOKENS = 3;
-var findInlineRecipeDuplicates = (recipes, files) => {
+var findInlineRecipeDuplicates2 = (recipes, files) => {
   const fingerprints = recipes.map((recipe) => ({ recipe: recipe.name, tokens: (recipe.base ?? "").split(/\s+/).filter(Boolean) })).filter((fingerprint) => fingerprint.tokens.length >= MIN_FINGERPRINT_TOKENS).map((fingerprint) => ({ ...fingerprint, needed: Math.ceil(fingerprint.tokens.length * DUPLICATE_TOKEN_RATIO) }));
   if (fingerprints.length === 0)
     return [];
@@ -133,4 +133,4 @@ var getLeadingDoc = (fullText, node) => {
   return line || undefined;
 };
 
-export { collectRecipeSources, scanRecipes, findInlineRecipeDuplicates };
+export { collectRecipeSources2, scanRecipes2, findInlineRecipeDuplicates2 };

package/{index-0cj2zxbm.js → index-c69j78kk.js}

@@ -1,13 +1,13 @@
 // @bun
-import {
-  Spinner
-} from "./index-mxvakhsm.js";
 import {
   FileSys
-} from "./index-67546d0j.js";
+} from "./index-q0y2jq9j.js";
+import {
+  Spinner
+} from "./index-qsq3q8fy.js";
 
 // pkgs/@akanjs/devkit/cloud/globalConfig.ts
-import { mkdir } from "fs/promises";
+import { chmod, mkdir } from "fs/promises";
 import dayjs from "dayjs";
 
 // pkgs/@akanjs/devkit/cloud/constants.ts
@@ -34,8 +34,9 @@ class GlobalConfig {
     };
   }
   static async#setAkanGlobalConfig(akanConfig) {
-    await mkdir(basePath, { recursive: true });
+    await mkdir(basePath, { recursive: true, mode: 448 });
     await Bun.write(configPath, JSON.stringify(akanConfig, null, 2));
+    await chmod(configPath, 384);
   }
   static async getHostConfig(host = GlobalConfig.akanCloudHost) {
     const akanConfig = await GlobalConfig.#getAkanGlobalConfig();
@@ -240,7 +241,7 @@ import { ChatOpenAI } from "@langchain/openai";
 import { Logger } from "akanjs/common";
 import chalk from "chalk";
 var MAX_ASK_TRY = 300;
-var deepSeekLlmModels = ["deepseek-chat", "deepseek-reasoner"];
+var deepSeekLlmModels = ["deepseek-v4-flash", "deepseek-v4-pro"];
 var openAiLlmModels = ["gpt-5.5"];
 var supportedLlmModels = [...deepSeekLlmModels, ...openAiLlmModels];
 var isOpenAiLlmModel = (model) => openAiLlmModels.includes(model);
@@ -275,10 +276,10 @@ class AiSession {
   static #chat = null;
   static async init({ temperature = 0, useExisting = true } = {}) {
     if (useExisting) {
-      const llmConfig2 = await AiSession.getLlmConfig();
-      if (llmConfig2) {
-        AiSession.#setChatModel(llmConfig2.model, llmConfig2.apiKey);
-        Logger.rawLog(chalk.dim(`\uD83E\uDD16akan editor uses existing LLM config (${llmConfig2.model})`));
+      const llmConfig = await AiSession.getLlmConfig();
+      if (llmConfig) {
+        AiSession.#setChatModel(llmConfig.model, llmConfig.apiKey);
+        Logger.rawLog(chalk.dim(`\uD83E\uDD16akan editor uses existing LLM config (${llmConfig.model})`));
         return AiSession;
       }
     } else

package/{index-rxkpk7n4.js → index-fc1bh0a7.js}

@@ -2,7 +2,7 @@
 import {
   AppExecutor,
   LibExecutor
-} from "./index-z8ptfkzv.js";
+} from "./index-qsq3q8fy.js";
 
 // pkgs/@akanjs/devkit/workflow/utils.ts
 var jsonText = (value, { trailingNewline = true } = {}) => `${JSON.stringify(value, null, 2)}${trailingNewline ? `
@@ -914,9 +914,9 @@ ${options.closingIndent}}`);
   const beforeField = locator.fields[insertIndex];
   if (beforeField) {
     const leadingComments = ts.getLeadingCommentRanges(content, beforeField.fullStart) ?? [];
-    const insertAt2 = lineStartAt(content, leadingComments[0]?.pos ?? beforeField.start);
-    const indent2 = lineIndentAt(content, beforeField.start) || options.fieldIndent;
-    return spliceText(content, insertAt2, insertAt2, `${indent2}${formattedLine}
+    const insertAt = lineStartAt(content, leadingComments[0]?.pos ?? beforeField.start);
+    const indent = lineIndentAt(content, beforeField.start) || options.fieldIndent;
+    return spliceText(content, insertAt, insertAt, `${indent}${formattedLine}
 `);
   }
   const afterField = locator.fields[locator.fields.length - 1];

package/{index-d43t8af2.js → index-gq44bqjt.js}

@@ -2,16 +2,24 @@
 import {
   runner,
   script
-} from "./index-kdh76j26.js";
+} from "./index-znynzt5w.js";
 import {
   LibExecutor
-} from "./index-z8ptfkzv.js";
+} from "./index-qsq3q8fy.js";
+import {
+  LibSource,
+  formatLibStatuses
+} from "./index-3d9y066c.js";
+
+// pkgs/@akanjs/cli/library/library.script.ts
+import { Logger } from "akanjs/common";
 
-// pkgs/@akanjs/cli/semver.ts
-function parseVersion(version) {
+// pkgs/@akanjs/devkit/semver.ts
+var stripRangeOperator = (version) => version.replace(/^[\s^~>=<v]+/, "").trim();
+var parseVersion = (version) => {
   return version.replace(/^[^\d]*/, "").split(/[.-]/).map((part) => Number.parseInt(part, 10)).map((part) => Number.isFinite(part) ? part : 0);
-}
-function compareSemver(a, b) {
+};
+var compareNumeric = (a, b) => {
   const left = parseVersion(a);
   const right = parseVersion(b);
   const length = Math.max(left.length, right.length);
@@ -21,40 +29,64 @@ function compareSemver(a, b) {
       return diff > 0 ? 1 : -1;
   }
   return 0;
-}
+};
+var compareSemver = (a, b) => {
+  try {
+    return Bun.semver.order(stripRangeOperator(a), stripRangeOperator(b));
+  } catch {
+    return compareNumeric(a, b);
+  }
+};
 
 // pkgs/@akanjs/cli/library/library.runner.ts
 class LibraryRunner extends runner("library") {
+  static libraryRepository = "https://github.com/akan-team/akanjs.git";
   async createLibrary(libName, workspace) {
-    await workspace.exec(`mkdir -p libs/${libName}`);
+    await workspace.mkdir(`libs/${libName}`);
     await workspace.applyTemplate({ basePath: `libs/${libName}`, template: "libRoot", dict: { libName } });
     const lib = LibExecutor.from(workspace, libName);
     return lib;
   }
   async removeLibrary(lib) {
-    await lib.workspace.exec(`rm -rf libs/${lib.name}`);
+    await lib.workspace.removeDir(`libs/${lib.name}`);
   }
   async#copyInstalledLibrary(workspace, libName) {
     const installedPackageJson = `node_modules/akanjs/libs/${libName}/package.json`;
     if (!await workspace.exists(installedPackageJson))
-      return false;
+      return null;
     await workspace.cp(`node_modules/akanjs/libs/${libName}`, `libs/${libName}`);
-    return true;
+    return { origin: "akanjs", sha: await this.#installedAkanVersion(workspace) };
+  }
+  async#installedAkanVersion(workspace) {
+    const manifestPath = "node_modules/akanjs/package.json";
+    if (!await workspace.exists(manifestPath))
+      return "unknown";
+    const { version } = await workspace.readJson(manifestPath);
+    return version ?? "unknown";
   }
   async#copyLibraryFromRepository(workspace, libName) {
     await workspace.mkdir("node_modules/.akan");
     if (await workspace.exists("node_modules/.akan/akanjs"))
       await workspace.removeDir("node_modules/.akan/akanjs");
-    await workspace.exec(`cd node_modules/.akan && git clone https://github.com/akan-team/akanjs.git`);
+    await workspace.exec(`cd node_modules/.akan && git clone ${LibraryRunner.libraryRepository}`);
     await workspace.cp(`node_modules/.akan/akanjs/libs/${libName}`, `libs/${libName}`);
+    const sha = await workspace.spawn("git", ["-C", "node_modules/.akan/akanjs", "rev-parse", "HEAD"]);
+    return { origin: LibraryRunner.libraryRepository, sha: sha.trim().slice(0, 12) };
   }
   async installLibrary(workspace, libName) {
-    const copiedFromInstalledPackage = await this.#copyInstalledLibrary(workspace, libName);
-    if (!copiedFromInstalledPackage)
-      await this.#copyLibraryFromRepository(workspace, libName);
-    await workspace.cp(`libs/${libName}/env/env.server.example.ts`, `libs/${libName}/env/env.server.testing.ts`);
-    await workspace.commit(`Add ${libName} library`);
-    return LibExecutor.from(workspace, libName);
+    const source = await this.#copyInstalledLibrary(workspace, libName) ?? await this.#copyLibraryFromRepository(workspace, libName);
+    const testingEnv = `libs/${libName}/env/env.server.testing.ts`;
+    if (!await workspace.exists(testingEnv))
+      await workspace.cp(`libs/${libName}/env/env.server.example.ts`, testingEnv);
+    const lib = LibExecutor.from(workspace, libName);
+    const stamp = await new LibSource(lib).write(source);
+    if (await workspace.hasChanges())
+      await workspace.commit(`Install ${libName} library from ${stamp.origin}`);
+    return lib;
+  }
+  async libraryStatuses(workspace) {
+    const libNames = await workspace.getLibs();
+    return await Promise.all(libNames.map((libName) => new LibSource(LibExecutor.from(workspace, libName)).status()));
   }
   async mergeLibraryDependencies(lib) {
     const libPackageJson = await lib.getPackageJson();
@@ -70,7 +102,7 @@ class LibraryRunner extends runner("library") {
       return [dep, newerVersion];
     }));
     Object.keys(allDependencies).sort().forEach((dep) => {
-      if (!!libPackageJson.dependencies?.[dep] || !!rootPackageJson.dependencies?.[dep])
+      if (libPackageJson.dependencies?.[dep] || rootPackageJson.dependencies?.[dep])
         dependencies[dep] = allDependencies[dep];
       else
         devDependencies[dep] = allDependencies[dep];
@@ -80,7 +112,6 @@ class LibraryRunner extends runner("library") {
     await lib.workspace.spawn("bun", ["install"]);
     await lib.workspace.commit(`Merge ${lib.name} library dependencies`);
   }
-  async testLibrary(lib) {}
 }
 
 // pkgs/@akanjs/cli/library/library.script.ts
@@ -102,6 +133,13 @@ class LibraryScript extends script("library", [LibraryRunner]) {
     await this.libraryRunner.removeLibrary(lib);
     spinner.succeed(`Library ${lib.name} (libs/${lib.name}) is removed`);
   }
+  async libraryStatus(workspace, format = "text") {
+    const spinner = workspace.spinning("Checking library sources...");
+    const statuses = await this.libraryRunner.libraryStatuses(workspace);
+    const drifted = statuses.filter((status) => status.drift === "drifted").length;
+    spinner.succeed(`Checked ${statuses.length} libraries (${drifted} drifted)`);
+    Logger.rawLog(format === "json" ? JSON.stringify(statuses, null, 2) : formatLibStatuses(statuses));
+  }
   async installLibrary(workspace, libName) {
     const installSpinner = workspace.spinning(`Installing ${libName} library`);
     const lib = await this.libraryRunner.installLibrary(workspace, libName);
@@ -110,11 +148,6 @@ class LibraryScript extends script("library", [LibraryRunner]) {
     await this.libraryRunner.mergeLibraryDependencies(lib);
     mergeSpinner.succeed(`${libName} library (libs/${libName}) dependencies merged to root package.json`);
   }
-  async testLibrary(lib) {
-    const spinner = lib.spinning("Testing library...");
-    await this.libraryRunner.testLibrary(lib);
-    spinner.succeed(`Library ${lib.name} (libs/${lib.name}) test is successful`);
-  }
 }
 
 export { LibraryScript };

package/{index-774gcx29.js → index-gtmz74tj.js}

@@ -1,38 +1,45 @@
 // @bun
 import {
-  workflowRunArtifactPath,
-  workflowSyncDir
-} from "./index-rxkpk7n4.js";
-import {
-  AppExecutor,
-  LibExecutor,
-  appRootAllowedDirs,
-  appRootAllowedFiles,
   extractBlockVersion,
-  isScannedAppRootEntry,
-  readDevkitVersion
-} from "./index-z8ptfkzv.js";
-import {
-  collectRecipeSources,
-  findInlineRecipeDuplicates,
-  scanRecipes
-} from "./index-xys926f2.js";
+  readDevkitVersion,
+  rootAllowedFiles,
+  rootAllowedDirs,
+  isScannedRootEntry,
+  AppExecutor,
+  LibExecutor
+} from "./index-qsq3q8fy.js";
 import {
   FileSys
-} from "./index-67546d0j.js";
+} from "./index-q0y2jq9j.js";
+import {
+  collectRecipeSources2,
+  scanRecipes2,
+  findInlineRecipeDuplicates2
+} from "./index-by5gpp8x.js";
+import {
+  workflowRunArtifactPath,
+  workflowSyncDir
+} from "./index-fc1bh0a7.js";
 
 // pkgs/@akanjs/devkit/akanContext.ts
 import { readdir } from "fs/promises";
 import path from "path";
 import { capitalize } from "akanjs/common";
-var resourceList = [
+var guidelineResourceUri = (name) => `akan://guidelines/${name}`;
+var staticResourceList = [
   { uri: "akan://docs/framework", name: "Akan framework guide", mimeType: "text/markdown" },
-  { uri: "akan://guidelines/framework", name: "Framework guideline", mimeType: "text/markdown" },
-  { uri: "akan://guidelines/modelSignal", name: "Model signal guideline", mimeType: "text/markdown" },
   { uri: "akan://workspace/summary", name: "Workspace summary", mimeType: "application/json" },
   { uri: "akan://workspace/apps", name: "Workspace apps", mimeType: "application/json" },
   { uri: "akan://workspace/modules", name: "Workspace modules", mimeType: "application/json" }
 ];
+var buildResourceList = (guidelineNames) => [
+  ...staticResourceList,
+  ...guidelineNames.map((name) => ({
+    uri: guidelineResourceUri(name),
+    name: `${name} guideline`,
+    mimeType: "text/markdown"
+  }))
+];
 var cursorMcpConfigPath = ".cursor/mcp.json";
 var claudeMcpConfigPath = ".mcp.json";
 var codexMcpConfigPath = ".codex/config.toml";
@@ -404,19 +411,19 @@ class AkanContextAnalyzer {
       repairAction("generated", "akan repair generated --app <app-or-lib>", "Refresh generated Akan files.", true),
       repairAction("format", "akan repair format --target <app-or-lib-or-pkg>", "Run the formatter/linter repair path.", true)
     ];
-    for (const app of context.apps) {
-      const appPath = path.join(workspace.workspaceRoot, app.path);
-      for (const entry of await safeReadDir(appPath)) {
-        if (!isScannedAppRootEntry(entry.name))
+    for (const sys of [...context.apps, ...context.libs]) {
+      const sysPath = path.join(workspace.workspaceRoot, sys.path);
+      for (const entry of await safeReadDir(sysPath)) {
+        if (!isScannedRootEntry(sys.type, entry.name))
           continue;
-        const allowed = entry.isDirectory() ? appRootAllowedDirs.has(entry.name) : appRootAllowedFiles.has(entry.name);
+        const allowed = entry.isDirectory() ? rootAllowedDirs[sys.type].has(entry.name) : rootAllowedFiles[sys.type].has(entry.name);
         if (!allowed) {
-          const action = repairAction("module-shape", `akan repair module-shape --app ${app.name}`, "Review app root shape and remove or move the unknown entry.", false);
+          const action = repairAction("module-shape", `akan repair module-shape --app ${sys.name}`, `Review ${sys.type} root shape and remove or move the unknown entry.`, false);
           diagnostics.push({
             severity: "error",
-            code: "app-root-unknown-entry",
-            path: `${app.path}/${entry.name}`,
-            message: `Unexpected ${entry.isDirectory() ? "folder" : "file"} in app root: ${app.path}/${entry.name}`,
+            code: `${sys.type}-root-unknown-entry`,
+            path: `${sys.path}/${entry.name}`,
+            message: `Unexpected ${entry.isDirectory() ? "folder" : "file"} in ${sys.type} root: ${sys.path}/${entry.name}`,
             repairActions: [action]
           });
           repairActions.push(action);
@@ -486,10 +493,10 @@ class AkanContextAnalyzer {
       }
     }
     for (const sys of [...context.apps, ...context.libs]) {
-      const sources = await collectRecipeSources(path.join(workspace.workspaceRoot, sys.path, "ui"), "ui");
+      const sources = await collectRecipeSources2(path.join(workspace.workspaceRoot, sys.path, "ui"), "ui");
       if (sources.length === 0)
         continue;
-      const recipes = scanRecipes(sources);
+      const recipes = scanRecipes2(sources);
       const files = [];
       const glob = new Bun.Glob("**/*.tsx");
       for await (const abs of glob.scan({ cwd: path.join(workspace.workspaceRoot, sys.path), absolute: true })) {
@@ -500,7 +507,7 @@ class AkanContextAnalyzer {
           content: await Bun.file(abs).text().catch(() => "")
         });
       }
-      const duplicates = findInlineRecipeDuplicates(recipes, files);
+      const duplicates = findInlineRecipeDuplicates2(recipes, files);
       if (duplicates.length === 0)
         continue;
       const preview = duplicates.slice(0, 3).map((duplicate) => `${path.relative(workspace.workspaceRoot, duplicate.path)}:${duplicate.line}`).join(", ");
@@ -511,7 +518,7 @@ class AkanContextAnalyzer {
         message: `${sys.name}: ${duplicates.length} inline className(s) re-author a recipe fingerprint (${preview}${duplicates.length > 3 ? ", \u2026" : ""}) \u2014 consume the recipe instead.`
       });
     }
-    const scanNames = async (uiDirPath, basename) => new Set(scanRecipes(await collectRecipeSources(uiDirPath, "ui", basename)).map((info) => info.name));
+    const scanNames = async (uiDirPath, basename) => new Set(scanRecipes2(await collectRecipeSources2(uiDirPath, "ui", basename)).map((info) => info.name));
     const declaredByImport = new Map;
     declaredByImport.set("akanjs/ui", await scanNames(path.join(workspace.workspaceRoot, "pkgs/akanjs/ui"), "recipe"));
     for (const sys of [...context.apps, ...context.libs])
@@ -626,4 +633,4 @@ class AkanContextAnalyzer {
   }
 }
 
-export { resourceList, codexMcpConfigPath, akanMcpInstallTargets, akanMcpInstallConfigPaths, createAkanMcpServer, createAkanCodexMcpServerBlock, upsertCodexMcpServerBlock, renderDoctorText, AkanContextAnalyzer };
+export { buildResourceList, codexMcpConfigPath, akanMcpInstallTargets, akanMcpInstallConfigPaths, createAkanMcpServer, createAkanCodexMcpServerBlock, upsertCodexMcpServerBlock, renderDoctorText, AkanContextAnalyzer };

package/{index-j37qq1f2.js → index-h7yw2z9n.js}

@@ -1,14 +1,14 @@
 // @bun
 import {
-  getDirname
-} from "./index-1577bej2.js";
+  getDirname2
+} from "./index-6wwzs1bc.js";
 
 // pkgs/@akanjs/devkit/prompter.ts
 import fsPromise from "fs/promises";
 import { input, select } from "@inquirer/prompts";
 class Prompter {
   static async#getGuidelineRoot() {
-    const dirname = getDirname(import.meta.url);
+    const dirname = getDirname2(import.meta.url);
     const candidates = [`${dirname}/guidelines`, `${dirname}/../cli/guidelines`];
     for (const candidate of candidates) {
       try {
@@ -19,7 +19,6 @@ class Prompter {
     return candidates[0];
   }
   static async selectGuideline() {
-    const guidelineRoot = await Prompter.#getGuidelineRoot();
     const guideNames = await Prompter.listGuidelines();
     return await select({
       message: "Select a guideline",
@@ -37,10 +36,11 @@ class Prompter {
     return JSON.parse(guideJson);
   }
   static async getInstruction(guideName) {
+    const guideNames = await Prompter.listGuidelines();
+    if (!guideNames.includes(guideName))
+      throw new Error(`Unknown guideline "${guideName}". Available: ${guideNames.join(", ")}`);
     const guidelineRoot = await Prompter.#getGuidelineRoot();
-    const filePath = `${guidelineRoot}/${guideName}/${guideName}.instruction.md`;
-    const content = await fsPromise.readFile(filePath, "utf-8");
-    return content;
+    return await fsPromise.readFile(`${guidelineRoot}/${guideName}/${guideName}.instruction.md`, "utf-8");
   }
   static async getUpdateRequest(guideName) {
     return await input({

package/{index-bjpxzr6s.js → index-hwkygn9s.js}

@@ -422,7 +422,7 @@ class HmrWatcher {
     this.#unreportedChanges += unreported;
     if (!this.#reportedCompensating) {
       this.#reportedCompensating = true;
-      this.#logger.info(`[hmr] recovered ${unreported} change(s) that fs.watch did not report; Bun coalesces concurrent saves and drops all but one, so changes are resolved by mtime`);
+      this.#logger.verbose(`[hmr] recovered ${unreported} change(s) that fs.watch did not report; Bun coalesces concurrent saves and drops all but one, so changes are resolved by mtime`);
     }
     this.#logger.verbose(`[hmr] mtime scan found ${unreported} change(s) fs.watch never reported (${this.#unreportedChanges} total)`);
   }
@@ -463,6 +463,7 @@ class HmrWatcher {
 
 // pkgs/@akanjs/devkit/frontendBuild/watchRootResolver.ts
 import fs2 from "fs";
+import { readFile } from "fs/promises";
 import path4 from "path";
 
 class WatchRootResolver {
@@ -472,6 +473,10 @@ class WatchRootResolver {
   }
   async resolve() {
     const tsconfig = await this.#app.getTsConfig();
+    const appDir = path4.resolve(this.#app.cwdPath);
+    const appsContainer = path4.dirname(appDir);
+    const libsContainer = path4.resolve(this.#app.workspace.workspaceRoot, "libs");
+    const libRoots = await this.#resolveLibRoots(libsContainer);
     const set = new Set;
     set.add(path4.resolve(`${this.#app.cwdPath}/page`));
     for (const targets of Object.values(tsconfig.compilerOptions.paths ?? {})) {
@@ -482,12 +487,55 @@ class WatchRootResolver {
           continue;
         const cleaned = target.replace(/\/?\*+.*$/, "").replace(/\/[^/]+\.[^/]+$/, "");
         const resolved = path4.resolve(this.#app.workspace.workspaceRoot, cleaned);
-        if (fs2.existsSync(resolved))
-          set.add(resolved);
+        if (resolved === libsContainer && libRoots) {
+          for (const root of libRoots)
+            set.add(root);
+          continue;
+        }
+        const root = resolved === appsContainer ? appDir : resolved;
+        if (fs2.existsSync(root))
+          set.add(root);
       }
     }
     return [...set];
   }
+  async#resolveLibRoots(libsContainer) {
+    const libDeps = await this.#resolveLibDeps(libsContainer);
+    if (!libDeps)
+      return null;
+    return libDeps.map((name) => path4.join(libsContainer, name)).filter((dir) => fs2.existsSync(dir));
+  }
+  async#resolveLibDeps(libsContainer) {
+    const scanInfo = this.#app.getScanInfo({ allowEmpty: true });
+    if (scanInfo?.type === "app")
+      return scanInfo.libDeps;
+    const direct = await WatchRootResolver.#readManifestLibDeps(path4.join(this.#app.cwdPath, "akan.app.json"));
+    if (!direct)
+      return null;
+    const closure = new Set;
+    const queue = [...direct];
+    while (queue.length > 0) {
+      const name = queue.shift();
+      if (!name || closure.has(name))
+        continue;
+      closure.add(name);
+      const nested = await WatchRootResolver.#readManifestLibDeps(path4.join(libsContainer, name, "akan.lib.json"));
+      if (!nested)
+        return null;
+      queue.push(...nested);
+    }
+    return [...closure];
+  }
+  static async#readManifestLibDeps(manifestPath) {
+    try {
+      const parsed = JSON.parse(await readFile(manifestPath, "utf8"));
+      if (!Array.isArray(parsed.libDeps))
+        return null;
+      return parsed.libDeps.filter((name) => typeof name === "string" && name.length > 0);
+    } catch {
+      return null;
+    }
+  }
 }
 
 export { HmrWatcher, WatchRootResolver };

package/{index-xmmzf150.js → index-hyywke0f.js}

@@ -2,7 +2,7 @@
 import {
   runner,
   script
-} from "./index-kdh76j26.js";
+} from "./index-znynzt5w.js";
 
 // pkgs/@akanjs/cli/page/page.runner.ts
 class PageRunner extends runner("page") {