@akanjs/cli 3.0.0-alpha.7 → 3.0.0-alpha.71

package/{index-bjpxzr6s.js → index-5vy2jzar.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)`);
   }

package/{index-mssqn2sq.js → index-6d5r8q6k.js}

@@ -2,14 +2,16 @@
 import {
   workflowRunArtifactPath,
   workflowSyncDir
-} from "./index-2c3e2xh8.js";
+} from "./index-8besc14m.js";
 import {
   AppExecutor,
   LibExecutor,
-  appRootAllowedDirs,
-  appRootAllowedFiles,
-  isScannedAppRootEntry
-} from "./index-vg0sj9nc.js";
+  extractBlockVersion,
+  isScannedRootEntry,
+  readDevkitVersion,
+  rootAllowedDirs,
+  rootAllowedFiles
+} from "./index-5f4gnt4c.js";
 import {
   collectRecipeSources,
   findInlineRecipeDuplicates,
@@ -124,7 +126,9 @@ var validationCommands = [
   "akan typecheck <app-name>",
   "akan test <app-or-lib-or-pkg>",
   "akan build <app-name>",
-  "akan doctor --strict --format json"
+  "akan doctor --strict --format json",
+  "akan quality scan [--format json]",
+  "akan quality ssr [--format json]"
 ];
 var unknownGeneratedFilesFreshness = {
   status: "unknown",
@@ -365,6 +369,29 @@ class AkanContextAnalyzer {
       validationCommands
     };
   }
+  static async#agentGuideDrift(workspace) {
+    const installed = await readDevkitVersion();
+    if (!installed)
+      return null;
+    const content = await safeReadText(path.join(workspace.workspaceRoot, "AGENTS.md"));
+    if (content === null)
+      return null;
+    const stamped = extractBlockVersion(content);
+    if (stamped === installed)
+      return null;
+    const hint = "Re-render the AGENTS.md managed block from the installed framework release.";
+    if (!stamped)
+      return {
+        code: "agent-guide-unstamped",
+        message: `AGENTS.md carries no generated-version stamp, so its conventions may predate @akanjs/devkit ${installed}`,
+        hint
+      };
+    return {
+      code: "agent-guide-stale",
+      message: `AGENTS.md was generated by @akanjs/devkit ${stamped}, but ${installed} is installed`,
+      hint
+    };
+  }
   static async doctor(workspace, {
     strict = false,
     runIdOrPlan = null,
@@ -377,25 +404,37 @@ 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);
         }
       }
     }
+    const agentDrift = await AkanContextAnalyzer.#agentGuideDrift(workspace);
+    if (agentDrift) {
+      const action = repairAction("generated", "akan agent install agents-md", agentDrift.hint, true);
+      diagnostics.push({
+        severity: "warning",
+        code: agentDrift.code,
+        path: "AGENTS.md",
+        message: agentDrift.message,
+        repairActions: [action]
+      });
+      repairActions.push(action);
+    }
     for (const sys of [...context.apps, ...context.libs]) {
       for (const module of sys.modules) {
         if (!module.abstract.exists) {

package/{index-p3f4q532.js → index-737aj4fm.js}

@@ -4,24 +4,17 @@ import {
   CloudApi,
   GlobalConfig,
   getDefaultHostConfig
-} from "./index-0cj2zxbm.js";
+} from "./index-sh01r3pm.js";
 import {
   openBrowser
-} from "./index-5dw57f0d.js";
+} from "./index-cp00yns2.js";
 import {
   runner
-} from "./index-6rhabeev.js";
+} from "./index-gvq17wqn.js";
 import {
   AppExecutor,
   WorkspaceExecutor
-} from "./index-vg0sj9nc.js";
-
-// pkgs/@akanjs/cli/cloud/cloud.runner.ts
-import path from "path";
-import { confirm, input, select } from "@inquirer/prompts";
-import { Logger, sleep } from "akanjs/common";
-import chalk from "chalk";
-import * as QRcode from "qrcode";
+} from "./index-5f4gnt4c.js";
 
 // pkgs/@akanjs/cli/npmRegistry.ts
 var defaultNpmRegistry = "https://registry.npmjs.org";
@@ -40,6 +33,11 @@ async function getLatestPackageVersion(packageName, tag = "latest", registryUrl)
 }
 
 // pkgs/@akanjs/cli/cloud/cloud.runner.ts
+import path from "path";
+import { confirm, input, select } from "@inquirer/prompts";
+import { Logger, sleep } from "akanjs/common";
+import chalk from "chalk";
+import * as QRcode from "qrcode";
 var addRemoteEnvServerValue = "__addRemoteEnvServer";
 var removeRemoteEnvServerValue = "__removeRemoteEnvServer";
 
@@ -285,7 +283,10 @@ ${chalk.green("\u27A4")} Authentication Required`));
         return;
       }
     }
-    await Promise.all(akanPkgs.map(async (library) => {
+    Logger.info("Logging in to npm...");
+    await workspace.spawn("npm", ["login"], { stdio: "inherit" });
+    Logger.info("Logged in to npm");
+    for (const library of akanPkgs) {
       Logger.info(`Publishing ${library}@${nextVersion} to ${registry ?? "npm"}...`);
       await workspace.spawn("npm", ["publish", "--tag", tag, ...this.#getRegistryArgs(registry), ...this.#getLocalRegistryAuthArgs(registry)], {
         cwd: path.join(workspace.workspaceRoot, "dist/pkgs", library),
@@ -293,7 +294,7 @@ ${chalk.green("\u27A4")} Authentication Required`));
         stdio: "inherit"
       });
       Logger.info(`${library}@${nextVersion} is published to ${registry ?? "npm"}`);
-    }));
+    }
     Logger.info(`All libraries are published to ${registry ?? "npm"}`);
   }
   async update(workspace, tag = "latest", { registryUrl } = {}) {

package/{index-2c3e2xh8.js → index-8besc14m.js}

@@ -2,7 +2,7 @@
 import {
   AppExecutor,
   LibExecutor
-} from "./index-vg0sj9nc.js";
+} from "./index-5f4gnt4c.js";
 
 // pkgs/@akanjs/devkit/workflow/utils.ts
 var jsonText = (value, { trailingNewline = true } = {}) => `${JSON.stringify(value, null, 2)}${trailingNewline ? `