@akanjs/cli 2.4.1 → 2.4.2-rc.0

package/{module.command-29wvnb56.js → module.command-vwahdkzr.js}

@@ -1,21 +1,21 @@
 // @bun
 import {
   ModuleScript
-} from "./index-h6pevatb.js";
-import"./index-qacv44mm.js";
+} from "./index-tnngmzgf.js";
+import"./index-f1x6fe2e.js";
 import"./index-ss469dec.js";
 import {
   renderPrimitiveReport
-} from "./index-2v10yr8g.js";
-import"./index-eqxmxan6.js";
-import"./index-5vvwc0cz.js";
+} from "./index-ckywhpvp.js";
+import"./index-ehjhzg5y.js";
+import"./index-nsj2ftxj.js";
 import {
   Module,
   Sys,
   command
-} from "./index-phj3ewxv.js";
-import"./index-0t7pwff2.js";
-import"./index-61keag0s.js";
+} from "./index-en4zpzdm.js";
+import"./index-s6nk9815.js";
+import"./index-67546d0j.js";
 import"./index-6pz1j0zj.js";
 import"./index-r24hmh0q.js";
 

package/{package.command-46r1dncm.js → package.command-wkwd5x5p.js}

@@ -1,15 +1,15 @@
 // @bun
 import {
   PackageScript
-} from "./index-p9f1rpbp.js";
+} from "./index-31e8cwjq.js";
 import {
   Pkg,
   Workspace,
   command
-} from "./index-phj3ewxv.js";
-import"./index-0t7pwff2.js";
-import"./index-x53a5nya.js";
-import"./index-61keag0s.js";
+} from "./index-en4zpzdm.js";
+import"./index-s6nk9815.js";
+import"./index-46tjzh6s.js";
+import"./index-67546d0j.js";
 import"./index-6pz1j0zj.js";
 import"./index-r24hmh0q.js";
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@akanjs/cli",
-  "version": "2.4.1",
+  "version": "2.4.2-rc.0",
   "sourceType": "module",
   "type": "module",
   "publishConfig": {
@@ -34,7 +34,7 @@
     "@langchain/openai": "^1.4.6",
     "@tailwindcss/node": "^4.3.0",
     "@trapezedev/project": "^7.1.4",
-    "akanjs": "2.4.1",
+    "akanjs": "2.4.2-rc.0",
     "chalk": "^5.6.2",
     "commander": "^14.0.3",
     "daisyui": "5.5.23",

package/{page.command-vxvqdzc0.js → page.command-9w85hrg0.js}

@@ -1,14 +1,14 @@
 // @bun
 import {
   PageScript
-} from "./index-qacv44mm.js";
+} from "./index-f1x6fe2e.js";
 import {
   App,
   Module,
   command
-} from "./index-phj3ewxv.js";
-import"./index-0t7pwff2.js";
-import"./index-61keag0s.js";
+} from "./index-en4zpzdm.js";
+import"./index-s6nk9815.js";
+import"./index-67546d0j.js";
 import"./index-6pz1j0zj.js";
 import"./index-r24hmh0q.js";
 

package/{primitive.command-yk622wmt.js → primitive.command-2hnr8h7f.js}

@@ -1,21 +1,21 @@
 // @bun
 import {
   PrimitiveScript
-} from "./index-m04as81s.js";
-import"./index-h6pevatb.js";
-import"./index-qacv44mm.js";
+} from "./index-mpj63mbw.js";
+import"./index-tnngmzgf.js";
+import"./index-f1x6fe2e.js";
 import"./index-ss469dec.js";
 import {
   renderPrimitiveReport
-} from "./index-2v10yr8g.js";
-import"./index-eqxmxan6.js";
-import"./index-5vvwc0cz.js";
+} from "./index-ckywhpvp.js";
+import"./index-ehjhzg5y.js";
+import"./index-nsj2ftxj.js";
 import {
   Workspace,
   command
-} from "./index-phj3ewxv.js";
-import"./index-0t7pwff2.js";
-import"./index-61keag0s.js";
+} from "./index-en4zpzdm.js";
+import"./index-s6nk9815.js";
+import"./index-67546d0j.js";
 import"./index-6pz1j0zj.js";
 import"./index-r24hmh0q.js";
 

package/{quality.command-p0mb5xwt.js → quality.command-4kerz7mh.js}

@@ -4,9 +4,9 @@ import {
   command,
   runner,
   script
-} from "./index-phj3ewxv.js";
-import"./index-0t7pwff2.js";
-import"./index-61keag0s.js";
+} from "./index-en4zpzdm.js";
+import"./index-s6nk9815.js";
+import"./index-67546d0j.js";
 import"./index-6pz1j0zj.js";
 import"./index-r24hmh0q.js";
 

package/{repair.command-nptckp6w.js → repair.command-zmwshmvr.js}

@@ -1,16 +1,16 @@
 // @bun
 import {
   RepairRunner
-} from "./index-81epkybm.js";
-import"./index-eay4t1te.js";
-import"./index-2v10yr8g.js";
+} from "./index-xjkjcbhd.js";
+import"./index-xdf6rxyt.js";
+import"./index-ckywhpvp.js";
 import {
   Workspace,
   command,
   script
-} from "./index-phj3ewxv.js";
-import"./index-0t7pwff2.js";
-import"./index-61keag0s.js";
+} from "./index-en4zpzdm.js";
+import"./index-s6nk9815.js";
+import"./index-67546d0j.js";
 import"./index-6pz1j0zj.js";
 import"./index-r24hmh0q.js";
 

package/{routeSourceValidator-wbhmbwpj.js → routeSourceValidator-cncd92fv.js}

@@ -100,6 +100,45 @@ class RouteSourceValidator {
     if (exported.has("metadata") && exported.has("generateMetadata")) {
       throw new Error(`[route-convention] metadata and generateMetadata cannot both be exported in ${filePath}`);
     }
+    return { devOnly: RouteSourceValidator.#readDevOnly(sourceFile, filePath) };
+  }
+  static #readDevOnly(sourceFile, filePath) {
+    for (const statement of sourceFile.statements) {
+      if (!ts.isVariableStatement(statement))
+        continue;
+      const isExported = ts.getModifiers(statement)?.some((m) => m.kind === ts.SyntaxKind.ExportKeyword) ?? false;
+      if (!isExported)
+        continue;
+      for (const declaration of statement.declarationList.declarations) {
+        if (!ts.isIdentifier(declaration.name) || declaration.name.text !== "pageConfig")
+          continue;
+        const initializer = RouteSourceValidator.#unwrapExpression(declaration.initializer);
+        if (!initializer || !ts.isObjectLiteralExpression(initializer))
+          continue;
+        for (const property of initializer.properties) {
+          if (!ts.isPropertyAssignment(property))
+            continue;
+          const name = property.name;
+          const key = ts.isIdentifier(name) ? name.text : ts.isStringLiteral(name) ? name.text : null;
+          if (key !== "devOnly")
+            continue;
+          const value = RouteSourceValidator.#unwrapExpression(property.initializer);
+          if (value?.kind === ts.SyntaxKind.TrueKeyword)
+            return true;
+          if (value?.kind === ts.SyntaxKind.FalseKeyword)
+            return false;
+          throw new Error(`[route-convention] pageConfig.devOnly must be a literal true or false in ${filePath} \u2014 the build reads it without evaluating the module`);
+        }
+      }
+    }
+    return false;
+  }
+  static #unwrapExpression(expression) {
+    let current = expression;
+    while (current && (ts.isAsExpression(current) || ts.isSatisfiesExpression(current) || ts.isParenthesizedExpression(current))) {
+      current = current.expression;
+    }
+    return current;
   }
   static validateOverridesSourceExports(source, filePath) {
     const sourceFile = ts.createSourceFile(filePath, source, ts.ScriptTarget.Latest, true, ts.ScriptKind.TSX);

package/{scalar.command-bss14hez.js → scalar.command-9kanb73t.js}

@@ -1,19 +1,19 @@
 // @bun
 import {
   ScalarScript
-} from "./index-d2e2y85b.js";
+} from "./index-cp26p7qd.js";
 import"./index-ss469dec.js";
 import {
   renderPrimitiveReport
-} from "./index-2v10yr8g.js";
-import"./index-eqxmxan6.js";
-import"./index-5vvwc0cz.js";
+} from "./index-ckywhpvp.js";
+import"./index-ehjhzg5y.js";
+import"./index-nsj2ftxj.js";
 import {
   Sys,
   command
-} from "./index-phj3ewxv.js";
-import"./index-0t7pwff2.js";
-import"./index-61keag0s.js";
+} from "./index-en4zpzdm.js";
+import"./index-s6nk9815.js";
+import"./index-67546d0j.js";
 import"./index-6pz1j0zj.js";
 import"./index-r24hmh0q.js";
 

package/templates/workspaceRoot/.gitignore.template

@@ -67,6 +67,7 @@ local.properties
 **/public/fallback-*.js
 **/public/libs
 **/private/libs
+**/page/**/(libs)
 **/public/firebase-messaging-sw.js
 
 **/android/keystore.properties

package/templates/workspaceRoot/AGENTS.md.template

@@ -255,6 +255,20 @@ final fallback when no CLI command covers the change.
 | Use `<a>` tag for internal navigation between pages | Akan.js uses `<Link>` from `akanjs/ui` for client-side navigation — avoids full page reloads. | `import { Link } from "akanjs/ui"` and use `<Link href="/task">...</Link>` |
 | Name a custom `Endpoint`/`Slice` like a generated CRUD op — `create<Model>`, `update<Model>`, `remove<Model>`, `view<Model>`, `edit<Model>`, `merge<Model>` | These names are already auto-generated. A collision can pass sync/typecheck/build and only fail at runtime. | Pick a distinct verb, e.g. `startTask`/`archiveTask`, never `createTask` for a custom endpoint |
 
+## Comments
+
+- Never add comments in code by default.
+- Prefer clear names and structure so the code needs no explanation.
+- Do not narrate what the code already says.
+- Do not add JSDoc, section banners, or "why/how" comments for ordinary logic.
+- Comments are allowed only for these purposes:
+  1. `TODO` — unfinished work that must be tracked in-code
+  2. `FIXME` — known broken or incorrect behavior that must be fixed
+  3. `XXX` — dangerous / surprising hazard that a reader must not miss
+  4. Deletion caution — warn why removing a line or block would break something non-obvious
+- Keep allowed comments one short line when possible.
+- Match nearby file style: if the surrounding code has few comments, keep it that way.
+
 ## Generated File Tracker (Quick Reference)
 
 These files are regenerated by `akan sync` and overwritten on every sync. **Do not hand-edit them.**

package/{workflow.command-7fhqb33d.js → workflow.command-4areq0ex.js}

@@ -1,31 +1,31 @@
 // @bun
 import {
   WorkflowRunner
-} from "./index-1b9f27pm.js";
+} from "./index-2nb022xv.js";
 import {
   ScalarScript
-} from "./index-d2e2y85b.js";
+} from "./index-cp26p7qd.js";
 import {
   PrimitiveScript
-} from "./index-m04as81s.js";
+} from "./index-mpj63mbw.js";
 import {
   ModuleScript
-} from "./index-h6pevatb.js";
-import"./index-qacv44mm.js";
+} from "./index-tnngmzgf.js";
+import"./index-f1x6fe2e.js";
 import"./index-ss469dec.js";
-import"./index-eay4t1te.js";
+import"./index-xdf6rxyt.js";
 import {
   createWorkflowStepRegistry
-} from "./index-2v10yr8g.js";
-import"./index-eqxmxan6.js";
-import"./index-5vvwc0cz.js";
+} from "./index-ckywhpvp.js";
+import"./index-ehjhzg5y.js";
+import"./index-nsj2ftxj.js";
 import {
   Workspace,
   command,
   script
-} from "./index-phj3ewxv.js";
-import"./index-0t7pwff2.js";
-import"./index-61keag0s.js";
+} from "./index-en4zpzdm.js";
+import"./index-s6nk9815.js";
+import"./index-67546d0j.js";
 import"./index-6pz1j0zj.js";
 import"./index-r24hmh0q.js";
 

package/{workspace.command-xkcec7ky.js → workspace.command-02x93b10.js}

@@ -1,59 +1,59 @@
 // @bun
 import {
   ContextScript
-} from "./index-e3b8ms64.js";
-import"./index-81epkybm.js";
-import"./index-1b9f27pm.js";
+} from "./index-8dsjmcbp.js";
+import"./index-xjkjcbhd.js";
+import"./index-2nb022xv.js";
 import {
   CloudScript
-} from "./index-eja0sbm6.js";
-import"./index-d2e2y85b.js";
-import"./index-m04as81s.js";
-import"./index-h6pevatb.js";
-import"./index-qacv44mm.js";
+} from "./index-0wgpfp7t.js";
+import"./index-cp26p7qd.js";
+import"./index-mpj63mbw.js";
+import"./index-tnngmzgf.js";
+import"./index-f1x6fe2e.js";
 import"./index-ss469dec.js";
-import"./index-hk58kr1m.js";
+import"./index-smt4re0s.js";
 import {
   AgentScript
-} from "./index-q4sc46ec.js";
-import"./index-eay4t1te.js";
-import"./index-2v10yr8g.js";
-import"./index-eqxmxan6.js";
+} from "./index-79v9jwqe.js";
+import"./index-xdf6rxyt.js";
+import"./index-ckywhpvp.js";
+import"./index-ehjhzg5y.js";
 import {
   getLatestPackageVersion,
   getNpmRegistryUrl
-} from "./index-zw4aqvwh.js";
+} from "./index-t5rn8q9f.js";
 import {
   GlobalConfig
-} from "./index-5vvwc0cz.js";
+} from "./index-nsj2ftxj.js";
 import {
   ApplicationScript
-} from "./index-n2mp0f48.js";
+} from "./index-31183bxt.js";
 import"./index-76rn3g2c.js";
 import {
   LibraryScript
-} from "./index-3a4vntr0.js";
+} from "./index-n08vr4hh.js";
 import {
   PackageScript
-} from "./index-p9f1rpbp.js";
+} from "./index-31e8cwjq.js";
 import {
   Exec,
   Workspace,
   command,
   runner,
   script
-} from "./index-phj3ewxv.js";
+} from "./index-en4zpzdm.js";
 import"./index-fgc8r6dj.js";
 import {
   AppExecutor,
   LibExecutor,
   PkgExecutor,
   WorkspaceExecutor
-} from "./index-0t7pwff2.js";
-import"./index-x53a5nya.js";
+} from "./index-s6nk9815.js";
+import"./index-46tjzh6s.js";
 import {
   FileSys
-} from "./index-61keag0s.js";
+} from "./index-67546d0j.js";
 import"./index-bjpxzr6s.js";
 import"./index-6pz1j0zj.js";
 import"./index-r24hmh0q.js";