@akanjs/cli 3.0.0-alpha.5 → 3.0.0-alpha.50

package/incrementalBuilder.proc.js

@@ -8,18 +8,19 @@ import {
   DevGeneratedIndexSync,
   GraphClientEntryDiscovery,
   RouteClientBuilder
-} from "./index-j9cxndc0.js";
+} from "./index-qnv0aqmm.js";
 import {
   HmrWatcher,
   WatchRootResolver
-} from "./index-bjpxzr6s.js";
+} from "./index-5vy2jzar.js";
 import {
   AppExecutor,
   WorkspaceExecutor
-} from "./index-47qxw1tz.js";
+} from "./index-90zyjrby.js";
 import"./index-mxvakhsm.js";
+import"./index-1577bej2.js";
 import"./index-67546d0j.js";
-import"./index-r24hmh0q.js";
+import"./index-yb2wsc7f.js";
 
 // pkgs/@akanjs/devkit/incrementalBuilder/incrementalBuilder.proc.ts
 import path2 from "path";
@@ -249,7 +250,7 @@ class IncrementalBuilder {
       return;
     this.#shuttingDown = true;
     const started = Date.now();
-    this.#logger.info(`shutdown requested (${reason}); draining ${this.#inFlight} work item(s)`);
+    this.#logger.debug(`shutdown requested (${reason}); draining ${this.#inFlight} work item(s)`);
     if (this.#cssRebuildTimer) {
       clearTimeout(this.#cssRebuildTimer);
       this.#cssRebuildTimer = null;
@@ -262,7 +263,7 @@ class IncrementalBuilder {
       return;
     });
     const flushed = await BuilderChannel.drain();
-    this.#logger.info(`drained in ${Date.now() - started}ms${flushed ? ` after flushing ${flushed} ipc write(s)` : ""}; exiting for recycle`);
+    this.#logger.debug(`drained in ${Date.now() - started}ms${flushed ? ` after flushing ${flushed} ipc write(s)` : ""}; exiting for recycle`);
     process.exit(0);
   }
   get shuttingDown() {

package/index-1577bej2.js

@@ -0,0 +1,7 @@
+// @bun
+// pkgs/@akanjs/devkit/getDirname.ts
+import path from "path";
+import { fileURLToPath } from "url";
+var getDirname = (url) => path.dirname(fileURLToPath(url));
+
+export { getDirname };

package/{index-jn9vfpwz.js → index-24h5bqpj.js}

@@ -2,14 +2,16 @@
 import {
   workflowRunArtifactPath,
   workflowSyncDir
-} from "./index-m4kpmmtj.js";
+} from "./index-5em412h5.js";
 import {
   AppExecutor,
   LibExecutor,
-  appRootAllowedDirs,
-  appRootAllowedFiles,
-  isScannedAppRootEntry
-} from "./index-47qxw1tz.js";
+  extractBlockVersion,
+  isScannedRootEntry,
+  readDevkitVersion,
+  rootAllowedDirs,
+  rootAllowedFiles
+} from "./index-90zyjrby.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-hrwzz2wf.js → index-4z05haak.js}

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

package/{index-m4kpmmtj.js → index-5em412h5.js}

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

package/{index-6npsfpxr.js → index-5fe016p2.js}

@@ -1,17 +1,17 @@
 // @bun
 import {
   AkanContextAnalyzer
-} from "./index-jn9vfpwz.js";
+} from "./index-24h5bqpj.js";
 import {
   createRepairReport,
   generatedFilePathsForTarget,
   renderRepairReport,
   writeGeneratedSyncState,
   writeWorkflowRunArtifact
-} from "./index-m4kpmmtj.js";
+} from "./index-5em412h5.js";
 import {
   runner
-} from "./index-jkynkyfk.js";
+} from "./index-8rr621r2.js";
 
 // pkgs/@akanjs/cli/repair/repair.runner.ts
 var commandForShell = (command) => command.startsWith("akan ") ? `bun run ${command}` : command;

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-exhpp31y.js → index-6bs24rb4.js}

@@ -2,16 +2,17 @@
 import {
   runner,
   script
-} from "./index-jkynkyfk.js";
+} from "./index-8rr621r2.js";
 import {
   LibExecutor
-} from "./index-47qxw1tz.js";
+} from "./index-90zyjrby.js";
 
 // pkgs/@akanjs/cli/semver.ts
-function parseVersion(version) {
+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,7 +22,14 @@ 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") {
@@ -70,7 +78,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];

package/{index-nx1vbtsc.js → index-7etegaht.js}

@@ -1,27 +1,27 @@
 // @bun
+import {
+  LibraryScript
+} from "./index-6bs24rb4.js";
 import {
   resolveMobileTargets
 } from "./index-76rn3g2c.js";
-import {
-  LibraryScript
-} from "./index-exhpp31y.js";
 import {
   runner,
   script
-} from "./index-jkynkyfk.js";
+} from "./index-8rr621r2.js";
 import {
   HmrWatcher,
   WatchRootResolver
-} from "./index-bjpxzr6s.js";
+} from "./index-5vy2jzar.js";
 import {
   AppExecutor,
   LibExecutor,
   PkgExecutor,
   WorkspaceExecutor
-} from "./index-47qxw1tz.js";
+} from "./index-90zyjrby.js";
 import {
   __require
-} from "./index-r24hmh0q.js";
+} from "./index-yb2wsc7f.js";
 
 // pkgs/@akanjs/devkit/applicationBuildReporter.ts
 import { Logger } from "akanjs/common";
@@ -350,7 +350,7 @@ class IncrementalBuilderHost {
       return false;
     this.#recycleRequested = true;
     this.#status = "recycling";
-    this.logger.info(`recycling builder pid=${proc.pid} (${reason})`);
+    this.logger.debug(`recycling builder pid=${proc.pid} (${reason})`);
     this.#recycleTimer = setTimeout(() => {
       this.#recycleTimer = null;
       if (this.#proc !== proc)
@@ -1898,10 +1898,10 @@ function openBrowser(url) {
 }
 
 // pkgs/@akanjs/cli/application/application.runner.ts
-var loadBuildRunner = async () => (await import("./applicationBuildRunner-n1svrwgt.js")).ApplicationBuildRunner;
-var loadReleasePackager = async () => (await import("./applicationReleasePackager-gg8ccbeh.js")).ApplicationReleasePackager;
-var loadCapacitorApp = async () => (await import("./capacitorApp-yyw35vg4.js")).CapacitorApp;
-var loadAbstractCompactor = async () => (await import("./abstractCompactor-e5yq60qz.js")).AbstractCompactor;
+var loadBuildRunner = async () => (await import("./applicationBuildRunner-t5v6tcrm.js")).ApplicationBuildRunner;
+var loadReleasePackager = async () => (await import("./applicationReleasePackager-93nzdfsy.js")).ApplicationReleasePackager;
+var loadCapacitorApp = async () => (await import("./capacitorApp-927ahhz2.js")).CapacitorApp;
+var loadAbstractCompactor = async () => (await import("./abstractCompactor-20e0cwbs.js")).AbstractCompactor;
 var loadPrompts = async () => await import("@inquirer/prompts");
 
 class ApplicationRunner extends runner("application") {
@@ -2528,7 +2528,7 @@ class ApplicationScript extends script("application", [ApplicationRunner, Librar
     let stopping = false;
     process.on("SIGINT", () => {
       if (stopping) {
-        Logger5.rawLog("Abandoning the local database teardown; containers are left running.", undefined, "warn");
+        Logger5.rawLog("Abandoning the local database teardown; containers are left running.", undefined, "error");
         process.exit(130);
       }
       stopping = true;
@@ -2542,7 +2542,7 @@ class ApplicationScript extends script("application", [ApplicationRunner, Librar
     }), timeout]);
     if (result !== "timeout")
       return;
-    Logger5.rawLog(`Local database did not stop within ${ApplicationScript.dbShutdownTimeoutMs}ms; run \`akan dbdown\` once Docker responds.`, undefined, "warn");
+    Logger5.rawLog(`Local database did not stop within ${ApplicationScript.dbShutdownTimeoutMs}ms; run \`akan dbdown\` once Docker responds.`, undefined, "error");
   }
   async testSys(sys) {
     if (sys.type === "app")

package/{index-wrrb8rxk.js → index-7w5vv8jk.js}

@@ -4,19 +4,19 @@ import {
 } from "./index-ss469dec.js";
 import {
   AiSession
-} from "./index-0cj2zxbm.js";
+} from "./index-sh01r3pm.js";
 import {
   createPassedPrimitiveReport,
   generatedFilesForSync,
   scalarChangedFiles
-} from "./index-m4kpmmtj.js";
+} from "./index-5em412h5.js";
 import {
   Prompter
-} from "./index-qp089jp0.js";
+} from "./index-j37qq1f2.js";
 import {
   runner,
   script
-} from "./index-jkynkyfk.js";
+} from "./index-8rr621r2.js";
 
 // pkgs/@akanjs/cli/scalar/scalar.prompt.ts
 import { input } from "@inquirer/prompts";

package/{index-meh7mmz9.js → index-7zd96bng.js}

@@ -2,10 +2,10 @@
 import {
   runner,
   script
-} from "./index-jkynkyfk.js";
+} from "./index-8rr621r2.js";
 import {
   PkgExecutor
-} from "./index-47qxw1tz.js";
+} from "./index-90zyjrby.js";
 import {
   TypeScriptDependencyScanner
 } from "./index-46tjzh6s.js";
@@ -163,13 +163,17 @@ class PackageRunner extends runner("package") {
         "tailwind-scrollbar"
       ].filter((dep) => dep !== "akanjs" && dep !== "@akanjs/devkit");
     }
-    const bundledRuntimeDeps = new Set(pkg.name === "@akanjs/cli" ? ["@akanjs/devkit"] : []);
+    const packageBundledRuntimeDependencies = {
+      "@akanjs/cli": ["@akanjs/devkit"],
+      akanjs: ["use-agentic"]
+    };
+    const bundledRuntimeDeps = new Set(packageBundledRuntimeDependencies[pkg.name] ?? []);
     const forcedRuntimeDeps = packageRuntimeDependencies[pkg.name] ?? [];
     const forcedRuntimeDevDeps = packageRuntimeDevDependencies[pkg.name] ?? [];
     const [rootPackageJson, pkgJson] = await Promise.all([pkg.workspace.getPackageJson(), pkg.getPackageJson()]);
     const optionalPeerDeps = new Set(Object.entries(pkgJson.peerDependenciesMeta ?? {}).filter(([, meta]) => meta.optional).map(([dep]) => dep));
     const packageRuntimeDeps = [...new Set([...npmDeps, ...forcedRuntimeDeps])].filter((dep) => !optionalPeerDeps.has(dep) && !bundledRuntimeDeps.has(dep));
-    const packageRuntimeDevDeps = [...new Set([...npmDevDeps, ...forcedRuntimeDevDeps])].filter((dep) => !optionalPeerDeps.has(dep));
+    const packageRuntimeDevDeps = [...new Set([...npmDevDeps, ...forcedRuntimeDevDeps])].filter((dep) => !optionalPeerDeps.has(dep) && !bundledRuntimeDeps.has(dep));
     const rootDeps = { ...rootPackageJson.dependencies, ...rootPackageJson.devDependencies };
     const missingForcedDeps = forcedRuntimeDeps.filter((dep) => !rootDeps[dep]);
     const missingForcedDevDeps = forcedRuntimeDevDeps.filter((dep) => !rootDeps[dep]);

package/{index-p69fcwe1.js → index-866yqz3y.js}

@@ -1,22 +1,22 @@
 // @bun
 import {
   RepairRunner
-} from "./index-6npsfpxr.js";
+} from "./index-5fe016p2.js";
 import {
   WorkflowRunner
-} from "./index-c94nq3c1.js";
+} from "./index-k7sm38v6.js";
+import {
+  ScalarScript
+} from "./index-7w5vv8jk.js";
 import {
   PrimitiveScript
-} from "./index-pfrt7qwh.js";
+} from "./index-97cw8sg1.js";
 import {
   ModuleScript
-} from "./index-60a3jfcz.js";
-import {
-  ScalarScript
-} from "./index-wrrb8rxk.js";
+} from "./index-xrdrttjb.js";
 import {
   isPlaceholderAppId
-} from "./index-mterpj70.js";
+} from "./index-zgkey4d0.js";
 import {
   AkanContextAnalyzer,
   akanMcpInstallConfigPaths,
@@ -27,17 +27,17 @@ import {
   renderDoctorText,
   resourceList,
   upsertCodexMcpServerBlock
-} from "./index-jn9vfpwz.js";
+} from "./index-24h5bqpj.js";
 import {
   buildAkanModuleContextIndex,
   createWorkflowBaselineSummary,
   createWorkflowStepRegistry,
   jsonText,
   toolingRolloutGate
-} from "./index-m4kpmmtj.js";
+} from "./index-5em412h5.js";
 import {
   Prompter
-} from "./index-qp089jp0.js";
+} from "./index-j37qq1f2.js";
 import {
   getMobileTargets
 } from "./index-76rn3g2c.js";
@@ -45,10 +45,10 @@ import {
   CommandContainer,
   runner,
   script
-} from "./index-jkynkyfk.js";
+} from "./index-8rr621r2.js";
 import {
   AppExecutor
-} from "./index-47qxw1tz.js";
+} from "./index-90zyjrby.js";
 
 // pkgs/@akanjs/cli/context/context.script.ts
 import { Logger } from "akanjs/common";

package/{index-jkynkyfk.js → index-8rr621r2.js}

@@ -5,15 +5,17 @@ import {
   LibExecutor,
   ModuleExecutor,
   PkgExecutor,
-  WorkspaceExecutor,
+  WorkspaceExecutor
+} from "./index-90zyjrby.js";
+import {
   getDirname
-} from "./index-47qxw1tz.js";
+} from "./index-1577bej2.js";
 import {
   FileSys
 } from "./index-67546d0j.js";
 import {
   __require
-} from "./index-r24hmh0q.js";
+} from "./index-yb2wsc7f.js";
 
 // pkgs/@akanjs/devkit/commandDecorators/targetMeta.ts
 var COMMAND_META = Symbol("akan.command.meta");