@akanjs/cli 3.0.0-alpha.1 → 3.0.0-alpha.11

package/{index-pyt2b4nw.js → index-cav1azma.js}

@@ -9,7 +9,7 @@ import {
   createTsconfigPackageResolver,
   rewriteBarrelImports,
   transformUseClient
-} from "./index-rh16j3c7.js";
+} from "./index-j9cxndc0.js";
 import {
   __require
 } from "./index-r24hmh0q.js";
@@ -415,11 +415,21 @@ class AllRoutesBuilder {
     const seedIndex = computeRouteSeedIndex(pageEntries);
     this.#app.verbose(`[build-all] discovered ${seedIndex.entries.length} routes`);
     this.#discovery = await GraphClientEntryDiscovery.create(this.#app);
+    const allEntries = [];
+    const seen = new Set;
     for (const entry of seedIndex.entries) {
       const seeds = Array.from(new Set([...seedIndex.globalLayoutFiles, ...entry.seeds]));
-      const delta = await this.#buildRoute(entry.routeId, seeds);
-      this.#mergeRoute(entry.routeId, delta);
+      for (const discovered of await this.#discovery.discover(seeds)) {
+        if (seen.has(discovered))
+          continue;
+        seen.add(discovered);
+        allEntries.push(discovered);
+      }
+      this.#routeIds.push(entry.routeId);
     }
+    this.#app.verbose(`[build-all] ${allEntries.length} client entries across ${this.#routeIds.length} routes`);
+    const delta = await this.#buildEntries(allEntries);
+    this.#mergeDelta(delta);
     this.#merged.knownEntries = Array.from(this.#knownSet);
     const manifest = {
       routeIds: this.#routeIds,
@@ -433,23 +443,30 @@ class AllRoutesBuilder {
     this.#app.verbose(`[build-all] wrote ${manifestPath} routes=${this.#routeIds.length} entries=${this.#merged.knownEntries.length}`);
     return { manifest, manifestPath, seedIndex };
   }
-  async#buildRoute(routeId, seeds) {
+  async#buildEntries(entries) {
     if (!this.#discovery)
       throw new Error("[build-all] client entry discovery is not initialized");
+    if (entries.length === 0)
+      return {
+        manifestDelta: {},
+        ssrManifestDelta: { moduleLoading: null, moduleMap: {} },
+        newEntries: [],
+        clientDeps: []
+      };
     const started = Date.now();
     const delta = await new RouteClientBuilder({
       app: this.#app,
-      routeId,
-      seeds,
+      seeds: [],
+      entries,
       artifact: this.#artifact,
       knownEntries: this.#knownSet,
       discovery: this.#discovery,
       command: this.#command
     }).build();
-    this.#app.verbose(`[build-all] ${routeId} +${delta.newEntries.length} entries (${Date.now() - started}ms)`);
+    this.#app.verbose(`[build-all] bundled ${delta.newEntries.length} entries (${Date.now() - started}ms)`);
     return delta;
   }
-  #mergeRoute(routeId, delta) {
+  #mergeDelta(delta) {
     for (const [key, row] of Object.entries(delta.manifestDelta))
       this.#merged.clientManifest[key] = row;
     for (const [url, byName] of Object.entries(delta.ssrManifestDelta.moduleMap)) {
@@ -457,7 +474,6 @@ class AllRoutesBuilder {
     }
     for (const abs of delta.newEntries)
       this.#knownSet.add(abs);
-    this.#routeIds.push(routeId);
   }
 }
 
@@ -794,10 +810,10 @@ import { compile } from "tailwindcss";
 
 // pkgs/@akanjs/devkit/frontendBuild/cssCandidateCache.ts
 import { stat } from "fs/promises";
-var CANDIDATE_RE = /-?[\w@][\w:/.-]*(?:\[[^\]]+\][\w:/.-]*)*/g;
+var CANDIDATE_RE = /-?(?:[\w@]|\[[^\]\s]+\])[\w:/.-]*(?:\[[^\]\s]+\][\w:/.-]*)*/g;
 
 class CssCandidateCache {
-  static #version = 1;
+  static #version = 3;
   #path;
   #entries = new Map;
   #dirty = false;
@@ -957,8 +973,12 @@ class CssImportResolver {
       const pkg = await Bun.file(pkgPath).json();
       const subpath = id === pkgName ? "." : `.${id.slice(pkgName.length)}`;
       const exportValue = pkg.exports?.[subpath];
-      const styleEntry = (typeof exportValue === "string" ? exportValue : exportValue?.style || exportValue?.import || exportValue?.default) || pkg.exports?.["."]?.style || pkg.style || "index.css";
-      return await this.#firstExisting(path7.resolve(pkgDir, styleEntry));
+      const exportedEntry = typeof exportValue === "string" ? exportValue : exportValue?.style || exportValue?.import || exportValue?.default;
+      if (exportedEntry)
+        return await this.#firstExisting(path7.resolve(pkgDir, exportedEntry));
+      if (subpath !== ".")
+        return await this.#firstExisting(path7.resolve(pkgDir, subpath));
+      return await this.#firstExisting(path7.resolve(pkgDir, pkg.exports?.["."]?.style || pkg.style || "index.css"));
     } catch {
       return null;
     }
@@ -1015,6 +1035,7 @@ class CssCompiler {
   #fileExistsCache = new Map;
   #resolvedFileCache = new Map;
   #resolvedSpecifierCache = new Map;
+  #discoveredCssPaths = new Set;
   #fileExists(absPath) {
     let cached = this.#fileExistsCache.get(absPath);
     if (!cached) {
@@ -1048,13 +1069,16 @@ class CssCompiler {
   async getCss({ refresh } = {}) {
     if (this.#cssText !== null && !refresh)
       return this.#cssText;
+    this.#discoveredCssPaths.clear();
     const { cssPaths, sourcePaths } = await this.discoverCssAndSources({ refresh });
     this.#cssText = await this.compileCss(cssPaths, sourcePaths);
+    await this.#warnUnreachableStylesheets();
     return this.#cssText;
   }
   async getCssByBasePath({ refresh } = {}) {
     if (this.#cssTextByBasePath !== null && !refresh)
       return this.#cssTextByBasePath;
+    this.#discoveredCssPaths.clear();
     const akanConfig = await this.#app.getConfig({ refresh });
     const pageKeys = await this.#app.getPageKeys({ refresh });
     const basePaths = [...akanConfig.basePaths];
@@ -1081,8 +1105,20 @@ class CssCompiler {
       })
     ]);
     this.#cssTextByBasePath = Object.fromEntries(cssEntries);
+    await this.#warnUnreachableStylesheets();
     return this.#cssTextByBasePath;
   }
+  async#warnUnreachableStylesheets() {
+    const pageDir = path8.join(this.#app.cwdPath, "page");
+    const glob = new Bun.Glob("**/*.css");
+    for await (const cssPath of glob.scan({ cwd: pageDir, absolute: true })) {
+      if (cssPath.includes(`${path8.sep}(libs)${path8.sep}`))
+        continue;
+      if (this.#discoveredCssPaths.has(cssPath))
+        continue;
+      this.#logger.warn(`css ${path8.relative(this.#app.cwdPath, cssPath)} is imported by no route and never compiled`);
+    }
+  }
   async discoverCss({ refresh } = {}) {
     const { cssPaths } = await this.discoverCssAndSources({ refresh });
     return cssPaths;
@@ -1142,7 +1178,28 @@ class CssCompiler {
         queue.push(resolved);
       }
     }
-    return { cssPaths: [...cssFiles], sourcePaths: [...sourceFiles] };
+    const tokenPaths = await this.#libTokenStylesheets(sourceFiles);
+    const cssPaths = [...new Set([...tokenPaths, ...cssFiles])];
+    for (const cssPath of cssPaths)
+      this.#discoveredCssPaths.add(cssPath);
+    return { cssPaths, sourcePaths: [...sourceFiles] };
+  }
+  async#libTokenStylesheets(sourceFiles) {
+    const libsRoot = path8.join(this.#app.workspace.workspaceRoot, "libs");
+    const libNames = new Set;
+    for (const filePath of sourceFiles) {
+      const relPath = path8.relative(libsRoot, filePath);
+      if (relPath.startsWith("..") || path8.isAbsolute(relPath))
+        continue;
+      const [libName] = relPath.split(path8.sep);
+      if (libName)
+        libNames.add(libName);
+    }
+    const tokenPaths = await Promise.all([...libNames].sort().map(async (libName) => {
+      const tokensPath = path8.join(libsRoot, libName, "ui/tokens.css");
+      return await this.#fileExists(tokensPath) ? tokensPath : null;
+    }));
+    return tokenPaths.filter((tokensPath) => !!tokensPath);
   }
   async compileCss(cssPaths, sourcePaths) {
     if (cssPaths.length === 0)
@@ -1180,12 +1237,17 @@ class CssCompiler {
   }
   async#loadStylesheet(id, fromBase) {
     const p = await this.#resolveCssImport(id, fromBase);
+    this.#discoveredCssPaths.add(p);
     const content = await Bun.file(p).text();
     return { path: p, base: path8.dirname(p), content };
   }
   async#resolveCssImport(id, fromBase) {
-    if (id.startsWith(".") || id.startsWith("/"))
-      return path8.resolve(fromBase, id);
+    if (id.startsWith(".") || id.startsWith("/")) {
+      const filePath = path8.resolve(fromBase, id);
+      if (await this.#fileExists(filePath))
+        return filePath;
+      throw new Error(`[css] failed to resolve stylesheet import "${id}" from ${fromBase} (no file at ${filePath})`);
+    }
     const resolver = await this.#getCssImportResolver();
     const resolved = await resolver.resolve(id, fromBase);
     if (resolved)
@@ -2025,14 +2087,21 @@ function loaderFor2(absPath) {
 // pkgs/@akanjs/devkit/frontendBuild/precompressArtifacts.ts
 import fs2 from "fs";
 import path12 from "path";
+import zlib from "zlib";
 var COMPRESSIBLE_EXTS = new Set([".css", ".html", ".js", ".json", ".svg"]);
 var MIN_COMPRESS_BYTES = 1024;
+var BROTLI_QUALITY_BY_EXT = { ".css": 11 };
+var DEFAULT_BROTLI_QUALITY = 9;
+var GZIP_LEVEL = 9;
 async function precompressArtifacts(app) {
-  const roots = [path12.join(app.dist.cwdPath, ".akan/artifact/client")];
-  const result = { files: 0, inputBytes: 0, outputBytes: 0 };
+  const roots = [
+    path12.join(app.dist.cwdPath, ".akan/artifact/client"),
+    path12.join(app.dist.cwdPath, ".akan/artifact/styles")
+  ];
+  const result = { files: 0, inputBytes: 0, outputBytes: 0, brotliBytes: 0 };
   await Promise.all(roots.map((root) => precompressRoot(root, result)));
   if (result.files > 0) {
-    app.verbose(`[precompress] wrote ${result.files} gzip sidecars (${formatBytes(result.inputBytes)} -> ${formatBytes(result.outputBytes)})`);
+    app.verbose(`[precompress] wrote ${result.files} sidecars (${formatBytes(result.inputBytes)} -> gzip ${formatBytes(result.outputBytes)} / br ${formatBytes(result.brotliBytes)})`);
   }
   return result;
 }
@@ -2044,15 +2113,27 @@ async function precompressRoot(root, result) {
     if (!await shouldPrecompress(filePath))
       continue;
     const bytes = await Bun.file(filePath).bytes();
-    const gz = Bun.gzipSync(toArrayBuffer(bytes));
-    await Bun.write(`${filePath}.gz`, gz);
+    const buffer = toArrayBuffer(bytes);
+    const gz = Bun.gzipSync(buffer, { level: GZIP_LEVEL });
+    const br = brotliCompress(buffer, path12.extname(filePath).toLowerCase());
+    await Promise.all([Bun.write(`${filePath}.gz`, gz), Bun.write(`${filePath}.br`, br)]);
     result.files += 1;
     result.inputBytes += bytes.byteLength;
     result.outputBytes += gz.byteLength;
+    result.brotliBytes += br.byteLength;
   }
 }
+function brotliCompress(buffer, ext) {
+  const quality = BROTLI_QUALITY_BY_EXT[ext] ?? DEFAULT_BROTLI_QUALITY;
+  return zlib.brotliCompressSync(buffer, {
+    params: {
+      [zlib.constants.BROTLI_PARAM_QUALITY]: quality,
+      [zlib.constants.BROTLI_PARAM_SIZE_HINT]: buffer.byteLength
+    }
+  });
+}
 async function shouldPrecompress(filePath) {
-  if (filePath.endsWith(".gz"))
+  if (filePath.endsWith(".gz") || filePath.endsWith(".br"))
     return false;
   if (!COMPRESSIBLE_EXTS.has(path12.extname(filePath).toLowerCase()))
     return false;

package/{index-2q1f5j9k.js → index-cv9cxs5k.js}

@@ -1,7 +1,7 @@
 // @bun
 import {
   AkanContextAnalyzer
-} from "./index-a00jg8x8.js";
+} from "./index-e4b2ae6b.js";
 import {
   WorkflowExecutor,
   compactWorkflowInputs,
@@ -23,10 +23,10 @@ import {
   workflowCommandsForPlan,
   workflowPlanApproval,
   writeWorkflowRunArtifact
-} from "./index-rzwcpcc3.js";
+} from "./index-kcsa1zff.js";
 import {
   runner
-} from "./index-8hsbnyes.js";
+} from "./index-etwh7sd3.js";
 
 // pkgs/@akanjs/cli/workflow/workflow.runner.ts
 import { mkdir, readFile, writeFile } from "fs/promises";

package/{index-a00jg8x8.js → index-e4b2ae6b.js}

@@ -2,11 +2,16 @@
 import {
   workflowRunArtifactPath,
   workflowSyncDir
-} from "./index-rzwcpcc3.js";
+} from "./index-kcsa1zff.js";
 import {
   AppExecutor,
-  LibExecutor
-} from "./index-hgna5rjy.js";
+  LibExecutor,
+  appRootAllowedDirs,
+  appRootAllowedFiles,
+  extractBlockVersion,
+  isScannedAppRootEntry,
+  readDevkitVersion
+} from "./index-yzsxc30b.js";
 import {
   collectRecipeSources,
   findInlineRecipeDuplicates,
@@ -121,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",
@@ -150,33 +157,6 @@ var moduleShapeFiles = (module) => {
   ];
 };
 var constantFieldNames = (content) => [...content.matchAll(/\b([A-Za-z_$][\w$]*)\s*:\s*field\(/g)].map((match) => match[1]).filter(Boolean);
-var appRootAllowFiles = new Set([
-  "AGENTS.md",
-  "CLAUDE.md",
-  "akan.app.json",
-  "akan.config.ts",
-  "capacitor.config.ts",
-  "client.ts",
-  "main.ts",
-  "package.json",
-  "server.ts",
-  "tsconfig.json"
-]);
-var appRootAllowDirs = new Set([
-  ".akan",
-  "android",
-  "common",
-  "env",
-  "ios",
-  "lib",
-  "page",
-  "private",
-  "public",
-  "script",
-  "srvkit",
-  "ui",
-  "webkit"
-]);
 var safeReadDir = async (dirPath) => {
   try {
     return (await readdir(dirPath, { withFileTypes: true })).sort((a, b) => a.name.localeCompare(b.name));
@@ -389,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,
@@ -404,7 +407,9 @@ class AkanContextAnalyzer {
     for (const app of context.apps) {
       const appPath = path.join(workspace.workspaceRoot, app.path);
       for (const entry of await safeReadDir(appPath)) {
-        const allowed = entry.isDirectory() ? appRootAllowDirs.has(entry.name) : appRootAllowFiles.has(entry.name);
+        if (!isScannedAppRootEntry(entry.name))
+          continue;
+        const allowed = entry.isDirectory() ? appRootAllowedDirs.has(entry.name) : appRootAllowedFiles.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);
           diagnostics.push({
@@ -418,6 +423,18 @@ class AkanContextAnalyzer {
         }
       }
     }
+    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-8hsbnyes.js → index-etwh7sd3.js}

@@ -5,9 +5,11 @@ import {
   LibExecutor,
   ModuleExecutor,
   PkgExecutor,
-  WorkspaceExecutor,
+  WorkspaceExecutor
+} from "./index-yzsxc30b.js";
+import {
   getDirname
-} from "./index-hgna5rjy.js";
+} from "./index-1577bej2.js";
 import {
   FileSys
 } from "./index-67546d0j.js";

package/{index-k95xkh4p.js → index-h5whaj26.js}

@@ -2,10 +2,10 @@
 import {
   runner,
   script
-} from "./index-8hsbnyes.js";
+} from "./index-etwh7sd3.js";
 import {
   PkgExecutor
-} from "./index-hgna5rjy.js";
+} from "./index-yzsxc30b.js";
 import {
   TypeScriptDependencyScanner
 } from "./index-46tjzh6s.js";

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

@@ -1,7 +1,7 @@
 // @bun
 import {
   getDirname
-} from "./index-hgna5rjy.js";
+} from "./index-1577bej2.js";
 
 // pkgs/@akanjs/devkit/prompter.ts
 import fsPromise from "fs/promises";

package/{index-rh16j3c7.js → index-j9cxndc0.js}

@@ -1143,16 +1143,17 @@ class RouteClientBuilder {
   #knownEntries;
   #command;
   #discovery;
+  #entries;
   constructor(options) {
     this.#app = options.app;
     this.#seeds = options.seeds;
     this.#knownEntries = options.knownEntries ?? new Set;
     this.#command = options.command ?? "start";
     this.#discovery = options.discovery;
+    this.#entries = options.entries;
   }
   async build() {
-    const discovery = this.#discovery ?? await GraphClientEntryDiscovery.create(this.#app);
-    const discovered = await discovery.discover(this.#seeds);
+    const discovered = this.#entries ?? await (this.#discovery ?? await GraphClientEntryDiscovery.create(this.#app)).discover(this.#seeds);
     const entries = discovered.filter((e) => !this.#knownEntries.has(e));
     if (entries.length === 0)
       return this.#emptyResult(discovered);

package/{index-rzwcpcc3.js → index-kcsa1zff.js}

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

package/{index-bekddz9q.js → index-m90fn8xe.js}

@@ -1,7 +1,7 @@
 // @bun
 import {
   ModuleScript
-} from "./index-yzmhasdb.js";
+} from "./index-mewacxye.js";
 import {
   addFieldUiPolicyForType,
   coerceFieldDefault,
@@ -34,15 +34,15 @@ import {
   sourceFile,
   validationCommandsForTarget,
   viaBuilderParameterName
-} from "./index-rzwcpcc3.js";
+} from "./index-kcsa1zff.js";
 import {
   script
-} from "./index-8hsbnyes.js";
+} from "./index-etwh7sd3.js";
 import {
   AppExecutor,
   LibExecutor,
   ModuleExecutor
-} from "./index-hgna5rjy.js";
+} from "./index-yzsxc30b.js";
 
 // pkgs/@akanjs/cli/primitive/primitive.script.ts
 import { capitalize } from "akanjs/common";

package/{index-yzmhasdb.js → index-mewacxye.js}

@@ -1,10 +1,10 @@
 // @bun
-import {
-  PageScript
-} from "./index-bbkek1bp.js";
 import {
   pluralizeName
 } from "./index-ss469dec.js";
+import {
+  PageScript
+} from "./index-65aeh789.js";
 import {
   AiSession
 } from "./index-0cj2zxbm.js";
@@ -15,17 +15,17 @@ import {
   generatedFilesForSync,
   moduleSourcePaths,
   sourceFile
-} from "./index-rzwcpcc3.js";
+} from "./index-kcsa1zff.js";
 import {
   Prompter
-} from "./index-tdbas9r0.js";
+} from "./index-j37qq1f2.js";
 import {
   runner,
   script
-} from "./index-8hsbnyes.js";
+} from "./index-etwh7sd3.js";
 import {
   ModuleExecutor
-} from "./index-hgna5rjy.js";
+} from "./index-yzsxc30b.js";
 import {
   FileSys
 } from "./index-67546d0j.js";

package/{index-zasydjxd.js → index-nwqqssnb.js}

@@ -7,21 +7,14 @@ import {
 } from "./index-0cj2zxbm.js";
 import {
   openBrowser
-} from "./index-e16gnn26.js";
+} from "./index-bzznxgcx.js";
 import {
   runner
-} from "./index-8hsbnyes.js";
+} from "./index-etwh7sd3.js";
 import {
   AppExecutor,
   WorkspaceExecutor
-} from "./index-hgna5rjy.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-yzsxc30b.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";
 

package/{index-mr5s7mqd.js → index-yzmqvg23.js}

@@ -1,17 +1,17 @@
 // @bun
 import {
   AkanContextAnalyzer
-} from "./index-a00jg8x8.js";
+} from "./index-e4b2ae6b.js";
 import {
   createRepairReport,
   generatedFilePathsForTarget,
   renderRepairReport,
   writeGeneratedSyncState,
   writeWorkflowRunArtifact
-} from "./index-rzwcpcc3.js";
+} from "./index-kcsa1zff.js";
 import {
   runner
-} from "./index-8hsbnyes.js";
+} from "./index-etwh7sd3.js";
 
 // pkgs/@akanjs/cli/repair/repair.runner.ts
 var commandForShell = (command) => command.startsWith("akan ") ? `bun run ${command}` : command;