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

package/{index-n0z3f2xg.js → index-eyyf2149.js}

@@ -1,22 +1,24 @@
 // @bun
 import {
   AkanContextAnalyzer
-} from "./index-4yp06pn1.js";
+} from "./index-774gcx29.js";
 import {
   Prompter
-} from "./index-xwgm94zr.js";
+} from "./index-j37qq1f2.js";
 import {
   runner,
   script
-} from "./index-jk9q6pse.js";
+} from "./index-kdh76j26.js";
 import {
   AGENT_BLOCK_END,
   AGENT_BLOCK_START,
   AppExecutor,
   LibExecutor,
+  readDevkitVersion,
   renderRecipeEntries,
+  stampBlockVersion,
   upsertAgentBlock
-} from "./index-jtm86byd.js";
+} from "./index-z8ptfkzv.js";
 import {
   collectRecipeSources,
   scanRecipes
@@ -103,19 +105,33 @@ ${scopeIndexPointer}
 
 `;
 };
+var renderGuides = async (context) => {
+  const conventions = (await Prompter.getInstruction("conventions")).trim();
+  if (context.pkgs.some((pkg) => pkg.name === "akanjs"))
+    return conventions;
+  const onboarding = (await Prompter.getInstruction("workspaceOnboarding")).trim();
+  const appName = context.apps[0]?.name ?? "app";
+  return `${conventions}
+
+${onboarding.replaceAll("<%= appName %>", appName)}`;
+};
 var renderManagedBlock = async (workspace) => {
   const context = await AkanContextAnalyzer.analyze(workspace);
   const frameworkGuide = await Prompter.getInstruction("framework");
   const appNames = context.apps.map((app) => app.name);
   const sampleCleanup = await renderSampleCleanup(workspace, appNames);
   const recipeIndex = await renderRecipeIndex(workspace);
-  return `## Workspace
+  const guides = await renderGuides(context);
+  const version = await readDevkitVersion();
+  const block = `## Workspace
 
 - Repo: ${context.repoName}
 - Apps: ${context.apps.map((app) => app.name).join(", ") || "none"}
 - Libraries: ${context.libs.map((lib) => lib.name).join(", ") || "none"}
 - Packages: ${context.pkgs.map((pkg) => pkg.name).join(", ") || "none"}
 
+${guides}
+
 ${sampleCleanup}## Akan Module Abstracts
 
 - Before changing a domain, service, or scalar module, read its \`*.abstract.md\` file first.
@@ -148,7 +164,19 @@ ${context.validationCommands.map((command) => `- \`${command}\``).join(`
 
 ## Framework Guide
 
-${frameworkGuide.trim()}`;
+${frameworkGuide.trim()}
+
+## Before You Finish
+
+1. \`bun run akan lint <appName>\` \u2014 Tailwind class order, \`Err\`, \`console\`, \`#private\` scope, unused imports.
+2. \`bun run akan typecheck <appName>\` \u2014 server/client boundary violations.
+3. \`bun run akan sync <appName>\` if you added, renamed, or deleted any file.
+4. Did you write or change a \`.tsx\` file? \`bun run akan quality ssr\` \u2014 did the server share hold, and did you add
+   a \`"use client"\` you cannot justify?
+5. Re-read the file you wrote against its section above.
+6. Did you add a comment? Delete it unless it documents an external constraint or a security decision.
+7. Did behavior or an invariant change? Update the module's \`*.abstract.md\`.`;
+  return version ? stampBlockVersion(block, version) : block;
 };
 var renderAgentsMd = async (workspace, existing) => {
   const block = await renderManagedBlock(workspace);

package/{index-e3qskyt2.js → index-gcv8ncfh.js}

@@ -2,10 +2,10 @@
 import {
   runner,
   script
-} from "./index-jk9q6pse.js";
+} from "./index-kdh76j26.js";
 import {
   PkgExecutor
-} from "./index-jtm86byd.js";
+} from "./index-z8ptfkzv.js";
 import {
   TypeScriptDependencyScanner
 } from "./index-46tjzh6s.js";

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

@@ -1,7 +1,7 @@
 // @bun
 import {
   getDirname
-} from "./index-jtm86byd.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-b978vs2e.js → index-jf2ya7r2.js}

@@ -1,17 +1,17 @@
 // @bun
 import {
   AkanContextAnalyzer
-} from "./index-4yp06pn1.js";
+} from "./index-774gcx29.js";
 import {
   createRepairReport,
   generatedFilePathsForTarget,
   renderRepairReport,
   writeGeneratedSyncState,
   writeWorkflowRunArtifact
-} from "./index-4zgs8g1w.js";
+} from "./index-rxkpk7n4.js";
 import {
   runner
-} from "./index-jk9q6pse.js";
+} from "./index-kdh76j26.js";
 
 // pkgs/@akanjs/cli/repair/repair.runner.ts
 var commandForShell = (command) => command.startsWith("akan ") ? `bun run ${command}` : command;

package/{index-vhv3xnjz.js → index-jhpa13zj.js}

@@ -1,13 +1,13 @@
 // @bun
-import {
-  PageScript
-} from "./index-hjzr8ja1.js";
 import {
   pluralizeName
 } from "./index-ss469dec.js";
+import {
+  PageScript
+} from "./index-xmmzf150.js";
 import {
   AiSession
-} from "./index-3pgtw35d.js";
+} from "./index-0cj2zxbm.js";
 import {
   bilingualDescriptionForField,
   bilingualLabelForField,
@@ -15,17 +15,17 @@ import {
   generatedFilesForSync,
   moduleSourcePaths,
   sourceFile
-} from "./index-4zgs8g1w.js";
+} from "./index-rxkpk7n4.js";
 import {
   Prompter
-} from "./index-xwgm94zr.js";
+} from "./index-j37qq1f2.js";
 import {
   runner,
   script
-} from "./index-jk9q6pse.js";
+} from "./index-kdh76j26.js";
 import {
   ModuleExecutor
-} from "./index-jtm86byd.js";
+} from "./index-z8ptfkzv.js";
 import {
   FileSys
 } from "./index-67546d0j.js";

package/{index-jk9q6pse.js → index-kdh76j26.js}

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

package/{index-6pz1j0zj.js → index-mxvakhsm.js}

@@ -4,6 +4,10 @@ import ora from "ora";
 
 class Spinner {
   static padding = 12;
+  static oraOptions = { discardStdin: false };
+  static canAnimate(stream = process.stderr) {
+    return !stream.isTTY || stream.columns > 0;
+  }
   spinner;
   stopWatch = null;
   startAt = new Date;
@@ -14,10 +18,10 @@ class Spinner {
     Spinner.padding = Math.max(Spinner.padding, prefix.length);
     this.prefix = prefix;
     this.message = message;
-    this.spinner = ora(message);
+    this.spinner = ora({ ...Spinner.oraOptions, text: message });
     this.spinner.prefixText = prefix.padStart(Spinner.padding, " ");
     this.spinner.indent = indent;
-    this.enableSpin = enableSpin;
+    this.enableSpin = enableSpin && Spinner.canAnimate();
   }
   start() {
     this.startAt = new Date;

package/{index-pyt2b4nw.js → index-qb61h0k7.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;
@@ -2025,14 +2041,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 +2067,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-csqk9z5j.js → index-qzdjd4ct.js}

@@ -1,7 +1,7 @@
 // @bun
 import {
   AkanContextAnalyzer
-} from "./index-4yp06pn1.js";
+} from "./index-774gcx29.js";
 import {
   WorkflowExecutor,
   compactWorkflowInputs,
@@ -23,10 +23,10 @@ import {
   workflowCommandsForPlan,
   workflowPlanApproval,
   writeWorkflowRunArtifact
-} from "./index-4zgs8g1w.js";
+} from "./index-rxkpk7n4.js";
 import {
   runner
-} from "./index-jk9q6pse.js";
+} from "./index-kdh76j26.js";
 
 // pkgs/@akanjs/cli/workflow/workflow.runner.ts
 import { mkdir, readFile, writeFile } from "fs/promises";

package/{index-4zgs8g1w.js → index-rxkpk7n4.js}

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

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

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

package/{index-fmgbwsr5.js → index-y4vkyhvv.js}

@@ -4,19 +4,19 @@ import {
 } from "./index-ss469dec.js";
 import {
   AiSession
-} from "./index-3pgtw35d.js";
+} from "./index-0cj2zxbm.js";
 import {
   createPassedPrimitiveReport,
   generatedFilesForSync,
   scalarChangedFiles
-} from "./index-4zgs8g1w.js";
+} from "./index-rxkpk7n4.js";
 import {
   Prompter
-} from "./index-xwgm94zr.js";
+} from "./index-j37qq1f2.js";
 import {
   runner,
   script
-} from "./index-jk9q6pse.js";
+} from "./index-kdh76j26.js";
 
 // pkgs/@akanjs/cli/scalar/scalar.prompt.ts
 import { input } from "@inquirer/prompts";