@akanjs/cli 3.0.0-alpha.96 → 3.0.0-alpha.98

package/.build-stamp

@@ -1 +1 @@
-97b04ea43cf58fa306823f262329027509339fbc8e621c950b73f9c701d2c2f5
+0c4679d28a49e946ce43ea1d5ce8a4fe26f612a4ba3e51ad5ce716ce794ef12f

package/{application.command-b4jch2m8.js → application.command-c4zsbmjj.js}

@@ -12,9 +12,9 @@ import"./index-q8sn827n.js";
 import"./index-6wwzs1bc.js";
 import {
   ApplicationScript
-} from "./index-hk3ms50t.js";
+} from "./index-8qcydz5h.js";
 import"./index-zkvpaggp.js";
-import"./index-9wtbw98m.js";
+import"./index-hwkygn9s.js";
 import {
   AbstractDoc
 } from "./index-meh558jy.js";

package/{applicationBuildRunner-cpajk38f.js → applicationBuildRunner-nqvj15x7.js}

@@ -11,7 +11,7 @@ import {
 } from "./index-jydtyzva.js";
 import"./index-w8kmx1b6.js";
 import"./index-q0y2jq9j.js";
-import"./index-9wtbw98m.js";
+import"./index-hwkygn9s.js";
 import"./index-n68jx79w.js";
 
 // pkgs/@akanjs/devkit/applicationBuildRunner.ts

package/buildBatch.proc.js

@@ -13,7 +13,7 @@ import {
   SsrBaseArtifactBuilder
 } from "./index-jydtyzva.js";
 import"./index-w8kmx1b6.js";
-import"./index-9wtbw98m.js";
+import"./index-hwkygn9s.js";
 import"./index-n68jx79w.js";
 
 // pkgs/@akanjs/devkit/incrementalBuilder/buildBatch.proc.ts

package/{cloud.command-xgxxq49a.js → cloud.command-me9e9dwb.js}

@@ -9,15 +9,15 @@ import {
 } from "./index-cezy7yb3.js";
 import"./index-q8sn827n.js";
 import"./index-6wwzs1bc.js";
-import"./index-hk3ms50t.js";
+import"./index-8qcydz5h.js";
 import"./index-zkvpaggp.js";
-import"./index-9wtbw98m.js";
+import"./index-hwkygn9s.js";
 import"./index-kcxmv48c.js";
 import"./index-sjak5v5b.js";
-import"./index-6y5sthxr.js";
+import"./index-vp0509kc.js";
 import {
   CloudScript
-} from "./index-tfz4faj3.js";
+} from "./index-4ravxy65.js";
 import"./index-pvb4vdwr.js";
 
 // pkgs/@akanjs/cli/cloud/cloud.command.ts

package/{devTui-m7a5gzet.js → devTui-jbn7cjfg.js}

@@ -1,7 +1,7 @@
 // @bun
 import {
   openBrowser
-} from "./index-hk3ms50t.js";
+} from "./index-8qcydz5h.js";
 
 // pkgs/@akanjs/cli/application/devTui.tsx
 import { render } from "ink";

package/{devTuiView-gb7ta8rv.js → devTuiView-2jffndk4.js}

@@ -1,7 +1,7 @@
 // @bun
 // pkgs/@akanjs/cli/application/devTuiView.ts
 var createDevTuiView = async (supervisor) => {
-  const { DevTui } = await import("./devTui-m7a5gzet.js");
+  const { DevTui } = await import("./devTui-jbn7cjfg.js");
   return new DevTui(supervisor);
 };
 export {

package/guidelines/conventions/conventions.instruction.md

@@ -516,6 +516,13 @@ Full contract — filter-arg `ref` pickers, `getQueryMeta` summary counters, `la
 - A slice's `exec` returns a `QueryOf` (an opaque query descriptor); you **cannot** chain `.sort()`/`.limit()` on
   it. Apply ordering/paging via the store `init` fetch option instead: `initX(..., { sort, page, limit })`. For a
   chainable builder use the model facade's `findMany`/`findOne`.
+- **A slice list is either one window or an accumulated one.** `setPageOf<Model>` swaps the window;
+  `loadMoreOf<Model>()` appends the rows after the ones loaded and takes **no page number** — it skips by
+  `<model>List.length`, so the offset cannot drift from what is on screen when a live insertion moves the server's
+  baseline, and `pageOf<Model>` stays 1, which is what keeps live placement (first page only) working past the
+  first "more". `isCumulativeOf<Model>` is the mode.
+- **"Is there more" is `hasMoreOf<Model>`, never `count > page * limit`.** It comes from the length of the batch
+  the server returned, so it survives `{ insight: false }` and cannot drift from a count a live event moved.
 - **Hydrated vs raw:** server queries return hydrated `cnst.<Model>` instances (with `set`/`save`/`refresh`);
   client fetch results are raw `GetStateObject` plain data, functions stripped.
 - Every filter generates fourteen methods: `list` · `listIds` · `find` · `findId` · `pick` · `pickId` · `exists` ·
@@ -872,6 +879,11 @@ when two shapes disagree.
   from overlapping. `--kill` frees the dev ports first — it resolves each port's listener, walks up to the top
   of that akan dev tree and signals it, so another checkout's server or a stale orphan on the same port is
   reclaimed. A holder that is not recognisably an akan process is reported and left alone.
+- **A dev server watches its own app directory and the libs it actually depends on**, transitively, resolved
+  once at boot from the synced manifests — so a save under a lib the app never imports rebuilds and reloads
+  nothing, and neither does a save in a sibling app. An import that makes a new lib a dependency needs a
+  fresh `akan start`, because it needs a `sync` first anyway. Before the first `sync` the manifests do not
+  exist yet and the whole `libs/` container is watched, which is the safe direction.
 - Test production build generation with `bun run akan build <appName>`.
 - To test a built artifact locally, run it from the generated app directory with the required Akan runtime environment variables.
 

package/guidelines/queryRule/queryRule.instruction.md

@@ -31,6 +31,18 @@ with it. `conventions` carries the invariants — this is the full contract behi
   A model with none renders ids and says so in the picker.
 - A slice's `exec` returns a `QueryOf` (an opaque query descriptor, `pkgs/akanjs/constant/types.ts`); you **cannot** chain `.sort()`/`.limit()` on it.
 - Apply ordering/paging via the store `init` fetch option instead: `initX(..., { sort, page, limit })` (`pkgs/akanjs/fetch/fetchType/sliceFetch.type.ts`).
+- **A slice list is either one window or an accumulated one, and the store says which.** `setPageOf<Model>` swaps
+  the window and `pageOf<Model>` names it; `loadMoreOf<Model>()` appends the rows *after* the ones already loaded
+  and takes no page number, because in an accumulated list no page number names anything. It skips by
+  `<model>List.length` rather than by `page * limit`, which is what keeps the offset from drifting from what is on
+  screen: a live insertion at the front moves the server's baseline by one, so a page number asks for rows the
+  list already shows. It also leaves `pageOf<Model>` at 1 — live placement is refused anywhere but the first page,
+  so paging by number used to switch live sync off permanently on the first "more", silently. `isCumulativeOf<Model>`
+  is the mode, and it is what stops a live insertion from truncating an accumulated list back to one page's worth.
+- **"Is there more" is `hasMoreOf<Model>`, never `count > page * limit`.** It is set from the length of the batch
+  the server just returned, so it survives `{ insight: false }` — which makes no count query at all — and cannot
+  drift from the count a live event moved. `loadMoreOf<Model>()` is a no-op once it is false, and `Load.Units`
+  draws no infinite-scroll sentinel.
 - Generated list accessors like `listBy(...)` return `Promise<Doc[]>`. For a chainable builder (`.sort().skip().limit().select()`) use the model facade's `findMany`/`findOne` (`FindManyChain`, `pkgs/akanjs/document/into.ts`).
 - **Hydrated vs raw:** server queries return hydrated `cnst.<Model>` instances (with `set`/`save`/`refresh`); client fetch results are raw `GetStateObject` plain data (functions stripped, `pkgs/akanjs/base/types.ts`).
 - Every filter generates fourteen methods: `list` · `listIds` · `find` · `findId` · `pick` · `pickId` · `exists` ·

package/guidelines/workspaceRecipes/workspaceRecipes.instruction.md

@@ -379,8 +379,8 @@ akan sync automatically generates APIs across all layers. Only write custom logi
 | `[model]` (cached full model), `[model]Loading`, `[model]Form`, `[model]Modal` | Base model states |
 | `create[Model](data)`, `update[Model](id, data)`, `remove[Model](id)` | CRUD actions |
 | `new[Model](partial)`, `edit[Model](model)`, `view[Model](model)` | Form/view state actions |
-| `[slice]List`, `[slice]InitList`, `[slice]Insight`, `[slice]Selection` | Slice states |
-| `init[Slice](args)`, `refresh[Slice]()`, `setPageOf[Slice](page)` | Slice actions |
+| `[slice]List`, `[slice]InitList`, `[slice]Insight`, `[slice]Selection`, `hasMoreOf[Slice]` | Slice states |
+| `init[Slice](args)`, `refresh[Slice]()`, `setPageOf[Slice](page)`, `loadMoreOf[Slice]()` | Slice actions |
 | `set[Field]On[Model](value)` | Auto-setters for each model field |
 
 **Rule**: Write custom store actions only for toast messages (`msg.loading`/`msg.success`) or multi-step workflows. State fields and CRUD actions are already auto-generated.

package/incrementalBuilder.proc.js

@@ -16,7 +16,7 @@ import {
 import {
   HmrWatcher,
   WatchRootResolver
-} from "./index-9wtbw98m.js";
+} from "./index-hwkygn9s.js";
 import {
   prepareDevWatchBatch
 } from "./index-a5vmm6x4.js";

package/{index-tfz4faj3.js → index-4ravxy65.js}

@@ -12,13 +12,13 @@ import {
 } from "./index-cezy7yb3.js";
 import {
   ApplicationScript
-} from "./index-hk3ms50t.js";
+} from "./index-8qcydz5h.js";
 import {
   PackageScript
 } from "./index-sjak5v5b.js";
 import {
   CloudRunner
-} from "./index-6y5sthxr.js";
+} from "./index-vp0509kc.js";
 
 // pkgs/@akanjs/cli/cloud/cloud.script.ts
 import { Logger } from "akanjs/common";

package/{index-hk3ms50t.js → index-8qcydz5h.js}

@@ -15,7 +15,7 @@ import {
 import {
   HmrWatcher,
   WatchRootResolver
-} from "./index-9wtbw98m.js";
+} from "./index-hwkygn9s.js";
 import {
   SlicePlanner,
   formatSlicePlan
@@ -1964,7 +1964,7 @@ ${uniqueCandidates.map((candidate) => `  - ${candidate}`).join(`
 // pkgs/@akanjs/cli/application/application.runner.ts
 import { Logger as Logger4 } from "akanjs/common";
 import ora from "ora";
-var loadBuildRunner = async () => (await import("./applicationBuildRunner-cpajk38f.js")).ApplicationBuildRunner;
+var loadBuildRunner = async () => (await import("./applicationBuildRunner-nqvj15x7.js")).ApplicationBuildRunner;
 var loadReleasePackager = async () => (await import("./applicationReleasePackager-3wh58n2m.js")).ApplicationReleasePackager;
 var loadCapacitorApp = async () => (await import("./capacitorApp-gzcx6txb.js")).CapacitorApp;
 var loadAbstractCompactor = async () => (await import("./abstractCompactor-cefxzggj.js")).AbstractCompactor;
@@ -3040,7 +3040,7 @@ class ApplicationScript extends script("application", [ApplicationRunner, Librar
       throw new Error("No app selected to start");
     const startedDatabase = dbup ? await this.#prepareSharedDatabase(apps) : false;
     const supervisor = new DevSupervisor({ apps, mode, concurrency, open, write });
-    const view = mode === "tui" ? await (await import("./devTuiView-gb7ta8rv.js")).createDevTuiView(supervisor) : new DevStreamView(apps.map((app) => app.name));
+    const view = mode === "tui" ? await (await import("./devTuiView-2jffndk4.js")).createDevTuiView(supervisor) : new DevStreamView(apps.map((app) => app.name));
     await supervisor.run(view);
     if (startedDatabase)
       await this.#stopDatabase(workspace);

package/{index-9wtbw98m.js → index-hwkygn9s.js}

@@ -463,6 +463,7 @@ class HmrWatcher {
 
 // pkgs/@akanjs/devkit/frontendBuild/watchRootResolver.ts
 import fs2 from "fs";
+import { readFile } from "fs/promises";
 import path4 from "path";
 
 class WatchRootResolver {
@@ -474,6 +475,8 @@ class WatchRootResolver {
     const tsconfig = await this.#app.getTsConfig();
     const appDir = path4.resolve(this.#app.cwdPath);
     const appsContainer = path4.dirname(appDir);
+    const libsContainer = path4.resolve(this.#app.workspace.workspaceRoot, "libs");
+    const libRoots = await this.#resolveLibRoots(libsContainer);
     const set = new Set;
     set.add(path4.resolve(`${this.#app.cwdPath}/page`));
     for (const targets of Object.values(tsconfig.compilerOptions.paths ?? {})) {
@@ -484,6 +487,11 @@ class WatchRootResolver {
           continue;
         const cleaned = target.replace(/\/?\*+.*$/, "").replace(/\/[^/]+\.[^/]+$/, "");
         const resolved = path4.resolve(this.#app.workspace.workspaceRoot, cleaned);
+        if (resolved === libsContainer && libRoots) {
+          for (const root of libRoots)
+            set.add(root);
+          continue;
+        }
         const root = resolved === appsContainer ? appDir : resolved;
         if (fs2.existsSync(root))
           set.add(root);
@@ -491,6 +499,43 @@ class WatchRootResolver {
     }
     return [...set];
   }
+  async#resolveLibRoots(libsContainer) {
+    const libDeps = await this.#resolveLibDeps(libsContainer);
+    if (!libDeps)
+      return null;
+    return libDeps.map((name) => path4.join(libsContainer, name)).filter((dir) => fs2.existsSync(dir));
+  }
+  async#resolveLibDeps(libsContainer) {
+    const scanInfo = this.#app.getScanInfo({ allowEmpty: true });
+    if (scanInfo?.type === "app")
+      return scanInfo.libDeps;
+    const direct = await WatchRootResolver.#readManifestLibDeps(path4.join(this.#app.cwdPath, "akan.app.json"));
+    if (!direct)
+      return null;
+    const closure = new Set;
+    const queue = [...direct];
+    while (queue.length > 0) {
+      const name = queue.shift();
+      if (!name || closure.has(name))
+        continue;
+      closure.add(name);
+      const nested = await WatchRootResolver.#readManifestLibDeps(path4.join(libsContainer, name, "akan.lib.json"));
+      if (!nested)
+        return null;
+      queue.push(...nested);
+    }
+    return [...closure];
+  }
+  static async#readManifestLibDeps(manifestPath) {
+    try {
+      const parsed = JSON.parse(await readFile(manifestPath, "utf8"));
+      if (!Array.isArray(parsed.libDeps))
+        return null;
+      return parsed.libDeps.filter((name) => typeof name === "string" && name.length > 0);
+    } catch {
+      return null;
+    }
+  }
 }
 
 export { HmrWatcher, WatchRootResolver };

package/{index-6y5sthxr.js → index-vp0509kc.js}

@@ -14,7 +14,7 @@ import {
 } from "./index-cezy7yb3.js";
 import {
   openBrowser
-} from "./index-hk3ms50t.js";
+} from "./index-8qcydz5h.js";
 
 // pkgs/@akanjs/cli/npmRegistry.ts
 var defaultNpmRegistry = "https://registry.npmjs.org";

package/index.js

@@ -14,16 +14,16 @@ import path from "path";
 
 // pkgs/@akanjs/cli/commandModules.ts
 var commandModules = {
-  workspace: async () => (await import("./workspace.command-w7ennb3r.js")).WorkspaceCommand,
+  workspace: async () => (await import("./workspace.command-t2v12ewm.js")).WorkspaceCommand,
   agent: async () => (await import("./agent.command-r93wmq7m.js")).AgentCommand,
-  application: async () => (await import("./application.command-b4jch2m8.js")).ApplicationCommand,
+  application: async () => (await import("./application.command-c4zsbmjj.js")).ApplicationCommand,
   library: async () => (await import("./library.command-em103wtn.js")).LibraryCommand,
-  localRegistry: async () => (await import("./localRegistry.command-bqpjr1ck.js")).LocalRegistryCommand,
+  localRegistry: async () => (await import("./localRegistry.command-81acqng9.js")).LocalRegistryCommand,
   package: async () => (await import("./package.command-rfhyf38t.js")).PackageCommand,
   module: async () => (await import("./module.command-451pztkc.js")).ModuleCommand,
   page: async () => (await import("./page.command-kt19da5g.js")).PageCommand,
   context: async () => (await import("./context.command-qd8kqrnh.js")).ContextCommand,
-  cloud: async () => (await import("./cloud.command-xgxxq49a.js")).CloudCommand,
+  cloud: async () => (await import("./cloud.command-me9e9dwb.js")).CloudCommand,
   subspace: async () => (await import("./subspace.command-kqzqtk0p.js")).SubspaceCommand,
   guideline: async () => (await import("./guideline.command-f38x8jhw.js")).GuidelineCommand,
   scalar: async () => (await import("./scalar.command-jcf4e5sv.js")).ScalarCommand,

package/{localRegistry.command-bqpjr1ck.js → localRegistry.command-81acqng9.js}

@@ -12,14 +12,14 @@ import {
 import"./index-6wwzs1bc.js";
 import {
   ApplicationScript
-} from "./index-hk3ms50t.js";
+} from "./index-8qcydz5h.js";
 import"./index-zkvpaggp.js";
-import"./index-9wtbw98m.js";
+import"./index-hwkygn9s.js";
 import"./index-n85fer99.js";
 import {
   getNpmRegistryUrl,
   CloudRunner
-} from "./index-6y5sthxr.js";
+} from "./index-vp0509kc.js";
 import"./index-kcxmv48c.js";
 import {
   PackageScript

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@akanjs/cli",
-  "version": "3.0.0-alpha.96",
+  "version": "3.0.0-alpha.98",
   "sourceType": "module",
   "type": "module",
   "publishConfig": {
@@ -33,7 +33,7 @@
     "@langchain/openai": "^1.4.6",
     "@tailwindcss/node": "^4.3.0",
     "@trapezedev/project": "^7.1.4",
-    "akanjs": "3.0.0-alpha.96",
+    "akanjs": "3.0.0-alpha.98",
     "chalk": "^5.6.2",
     "commander": "^14.0.3",
     "dayjs": "^1.11.20",

package/{workspace.command-w7ennb3r.js → workspace.command-t2v12ewm.js}

@@ -40,11 +40,11 @@ import {
 } from "./index-rntcdss1.js";
 import {
   ApplicationScript
-} from "./index-hk3ms50t.js";
+} from "./index-8qcydz5h.js";
 import {
   LibraryScript
 } from "./index-zkvpaggp.js";
-import"./index-9wtbw98m.js";
+import"./index-hwkygn9s.js";
 import"./index-kcxmv48c.js";
 import {
   PackageScript
@@ -52,10 +52,10 @@ import {
 import {
   getNpmRegistryUrl,
   getLatestPackageVersion
-} from "./index-6y5sthxr.js";
+} from "./index-vp0509kc.js";
 import {
   CloudScript
-} from "./index-tfz4faj3.js";
+} from "./index-4ravxy65.js";
 import {
   ContextScript
 } from "./index-r50qen0z.js";