@akanjs/cli 3.0.0-beta.28 → 3.0.0-beta.29

package/.build-stamp

@@ -1 +1 @@
-4303a4be1f9e80c8d096d61ecbdfc40f9354ddce71c2526133f623a2c8793dec
+17c8586a89cd04b60d3d62ff58838eecd420ba14c959958abb0d7baf5bd6628c

package/{CodeAgent-7acv4ah8.js → CodeAgent-86q8d13j.js}

@@ -1,8 +1,8 @@
 // @bun
 import {
   CodeAgent2
-} from "./index-ewbek95g.js";
-import"./index-52n8xr63.js";
+} from "./index-krwz9ek9.js";
+import"./index-8ej6r02m.js";
 import"./index-7md2g9vw.js";
 export {
   CodeAgent2 as CodeAgent

package/{CodeTui-9tkh34mj.js → CodeTui-r8tgxsyb.js}

@@ -4,7 +4,7 @@ import {
   McpServerConfig,
   McpTokenStore,
   McpSignIn
-} from "./index-52n8xr63.js";
+} from "./index-8ej6r02m.js";
 import {
   CodeTuiLines2,
   CodeTuiAgents2,

package/akanCode.js

@@ -28,7 +28,7 @@ import {
   CodeMailbox2,
   CodeSessionFork2,
   CodeAgent2
-} from "./index-ewbek95g.js";
+} from "./index-krwz9ek9.js";
 import {
   akanCodeDefaultModel2,
   akanCodeModel2,
@@ -39,7 +39,7 @@ import {
 import {
   SubagentPool2,
   akanCodePaths2
-} from "./index-52n8xr63.js";
+} from "./index-8ej6r02m.js";
 import"./index-7md2g9vw.js";
 import {
   CodeAgentRpcHost2

package/{application.command-xpnkyx4z.js → application.command-712jd2z8.js}

@@ -11,12 +11,12 @@ import"./index-52w0fvh8.js";
 import"./index-r8gp8zk3.js";
 import {
   getMobileTargetChoices
-} from "./index-tfe3711h.js";
+} from "./index-1hs6jrys.js";
 import"./index-48k96p55.js";
 import"./index-qtz88kh0.js";
 import {
   ApplicationScript
-} from "./index-0ej0sr6m.js";
+} from "./index-n9gxx7bp.js";
 import"./index-7md2g9vw.js";
 import"./index-nbg9bfnr.js";
 

package/{applicationBuildRunner-w4917tje.js → applicationBuildRunner-ez37p161.js}

@@ -34,7 +34,7 @@ var createServerEnvPlugin = ({ envDir, environment, environments }) => {
       build.onLoad({ filter }, async (args) => {
         const name = path.basename(args.path, ".ts").slice("env.server.".length);
         const { exports } = new Bun.Transpiler({ loader: "ts" }).scan(await Bun.file(args.path).text());
-        const message = `env/env.server.${name}.ts is not in this build: \`akan build\` bundles the server env of AKAN_PUBLIC_ENV=${environment} alone, the environment its image runs. Build with AKAN_PUBLIC_ENV=${name} to run ${name}.`;
+        const message = `env/env.server.${name}.ts is not in this build: \`akan build\` bundles the server env of AKAN_PUBLIC_ENV=${environment} alone, the environment its image runs. To run ${name}, build for it: AKAN_PUBLIC_ENV=${name} in the workspace's .env, which outranks the shell, or --env ${name} on a desktop or mobile build.`;
         return {
           loader: "js",
           contents: [

package/{cloud.command-7yd624qd.js → cloud.command-8eegwcsc.js}

@@ -12,15 +12,15 @@ import {
   PlatformTestRun
 } from "./index-rrt9pnb4.js";
 import"./index-48k96p55.js";
+import"./index-1hs6jrys.js";
 import"./index-qtz88kh0.js";
-import"./index-0ej0sr6m.js";
-import"./index-tfe3711h.js";
+import"./index-n9gxx7bp.js";
 import"./index-7md2g9vw.js";
 import"./index-2ahj896a.js";
 import"./index-k7809wmg.js";
 import {
   CloudScript2
-} from "./index-9j0kykc6.js";
+} from "./index-g44da4r2.js";
 import"./index-nbg9bfnr.js";
 
 // pkgs/@akanjs/cli/cloud/cloud.command.ts

package/{cloud.script-25vzkz7b.js → cloud.script-55s1cmz9.js}

@@ -1,13 +1,13 @@
 // @bun
 import {
   CloudScript2
-} from "./index-9j0kykc6.js";
+} from "./index-g44da4r2.js";
 import"./index-rrt9pnb4.js";
 import"./index-k7809wmg.js";
-import"./index-0ej0sr6m.js";
+import"./index-n9gxx7bp.js";
 import"./index-nbg9bfnr.js";
 import"./index-qtz88kh0.js";
-import"./index-tfe3711h.js";
+import"./index-1hs6jrys.js";
 import"./index-94s080qm.js";
 import"./index-b68zfsvz.js";
 import"./index-7md2g9vw.js";

package/{code.command-fpx4gzmy.js → code.command-n0c2tyzx.js}

@@ -19,7 +19,7 @@ class CodeRunner extends runner("code") {
   async serve(options, listen) {
     await import("./consoleToStderr-h5bryj94.js");
     const [{ CodeAgent }, { CodeAgentRpcHost }, { CodeAgentRpcListener }] = await Promise.all([
-      import("./CodeAgent-7acv4ah8.js"),
+      import("./CodeAgent-86q8d13j.js"),
       import("./CodeAgentRpcHost-p7h6n2hp.js"),
       import("./CodeAgentRpcListener-7p7z5dd7.js")
     ]);
@@ -34,8 +34,8 @@ class CodeRunner extends runner("code") {
   }
   async tui(options, seed) {
     const [{ CodeAgent }, { CodeTui }] = await Promise.all([
-      import("./CodeAgent-7acv4ah8.js"),
-      import("./CodeTui-9tkh34mj.js")
+      import("./CodeAgent-86q8d13j.js"),
+      import("./CodeTui-r8tgxsyb.js")
     ]);
     const agentOptions = await CodeRunner.#agentOptions(options, false);
     let resume = options.resume;
@@ -60,7 +60,7 @@ class CodeRunner extends runner("code") {
     }
   }
   async run(prompt, options) {
-    const { CodeAgent } = await import("./CodeAgent-7acv4ah8.js");
+    const { CodeAgent } = await import("./CodeAgent-86q8d13j.js");
     const agent = await CodeAgent.create(await CodeRunner.#agentOptions(options, false));
     const printer = new CodeAgentStreamPrinter2({ json: options.json, thinking: options.thinking });
     agent.on((event) => printer.print(event));

package/{context.command-snn1k5q3.js → context.command-vxf6d7q2.js}

@@ -8,8 +8,8 @@ import"./index-r8gp8zk3.js";
 import"./index-hj6w4ka1.js";
 import"./index-2s2e5qnd.js";
 import"./index-0pqzrbpr.js";
-import"./index-vt64c067.js";
-import"./index-tfe3711h.js";
+import"./index-16k7m3cs.js";
+import"./index-1hs6jrys.js";
 import"./index-zzvvc845.js";
 import"./index-2z30v4k5.js";
 import"./index-ss828r32.js";
@@ -19,7 +19,7 @@ import"./index-2ctqegdm.js";
 import"./index-h9ed99ax.js";
 import {
   ContextScript
-} from "./index-n9704w6y.js";
+} from "./index-2yvy9ztj.js";
 
 // pkgs/@akanjs/cli/context/context.command.ts
 class ContextCommand extends command("context", [ContextScript], ({ public: target }) => ({

package/{context.runner-nzaf8c98.js → context.runner-70r2fmty.js}

@@ -1,14 +1,14 @@
 // @bun
 import {
   ContextRunner2
-} from "./index-vt64c067.js";
+} from "./index-16k7m3cs.js";
 import"./index-h9ed99ax.js";
 import"./index-2ctqegdm.js";
 import"./index-20r2g1t3.js";
 import"./index-2z30v4k5.js";
 import"./index-genegfnt.js";
 import"./index-ss828r32.js";
-import"./index-tfe3711h.js";
+import"./index-1hs6jrys.js";
 import"./index-0pqzrbpr.js";
 import"./index-2s2e5qnd.js";
 import"./index-zzvvc845.js";

package/guidelines/conventions/conventions.instruction.md

@@ -356,9 +356,9 @@ Full contract: `get_guideline` with `runtimeRule`, or `akan guideline show runti
   that builds itself at install goes in `trustedDependencies`, which the image honours too. Carry a static LGPL ffmpeg: a `--enable-nonfree` build may
   not be redistributed. A file the user picks with `filePicker.pickFiles({ forServer: true })` reaches it as a
   grant, never a copy or a path: `NativeFile.resolve(grant, "read")` in `akanjs/server` asks the shell for it.
-  What it carries is readable on the user's computer — `private/`, the one `env.server.<env>.ts` of its
-  `--env` and the server env defaults of its libs — and it has no `public/`: read runtime files from
-  `AKAN_APP_DIR`, never `process.cwd()`.
+  What it carries is readable on the user's computer — `private/` (each lib's too, under `private/libs/<lib>`), the
+  one `env.server.<env>.ts` of its `--env` and its libs' server env defaults (`env.server.testing.ts`) — and it has
+  no `public/`: read runtime files from `AKAN_APP_DIR`, never `process.cwd()`.
 - **`assets: { pruneFonts, keepFonts }`** trims from the `dist` copy of `public/` the fonts nothing reads; source
   trees are never touched. A font with `optimize` on is a build input, not a runtime asset. `keepFonts` belongs to
   the `akan.config.ts` that owns the font, written against that scope's own `public/`.

package/guidelines/runtimeRule/runtimeRule.instruction.md

@@ -187,27 +187,34 @@ const config: AppConfig = { docker: "FROM oven/bun:1-slim\n…" }; // verbatim,
 ## A Desktop App's Server — `bin` And `trustedDependencies`
 
 A mobile target that declares `native: { desktop: { server: true } }` carries the app's server: `akan build-desktop`,
-`start-desktop --release` and `publish-update` put the backend `akan build` made into the app — the dist `.js`,
-`akan.build.json` and `private/` — and install it on their own with `bun install --production`, and `start-desktop`
-without `--release` starts `akan start` beside the app when no dev server answers. The setting is the app's backend,
+`start-desktop --release` and `publish-update` put the backend `akan build` made into the app — everything the
+backend build wrote (the `.js`, `akan.build.json`, `private/`, a bundled package's `.node`, `.wasm` or file asset)
+but the Dockerfile, the RSC worker, the console, `csr/` and `public/` — and install its packages first with
+`bun install --production --prefer-offline`, before `akan build` runs. `start-desktop` without `--release` starts
+`akan start` beside the app when no dev server of this checkout answers. The setting is the app's backend,
 so it does not change under an installed app: an update whose release carries a server when the app has none, or
 none when it has one, is refused, and switching means a reinstall.
 A desktop app builds only for the computer it is built on, so every native addon's prebuild matches the one it runs
 on. It runs as an API-only edge server on SQLite, on a loopback port the launcher picks — the last session's when
 it is free, which is not a guarantee, so a provider that needs an exact redirect URI signs in through a cloud
-server's adapter. It runs in one process, so a `main.ts` asking for replicas (`replica`, `solo: false`) does not
-boot in the app. Its data lives in the app's local data folder (`%LOCALAPPDATA%\<id>\server` on Windows, never
-Roaming; `server-debug` for a `--debug` build). It trusts the OS certificate store and takes the session's
-`HTTP(S)_PROXY` / `NO_PROXY` / `NODE_EXTRA_CA_CERTS`, and nothing else of the user's environment.
-
-**Everything it carries is on the user's computer, readable.** That is `private/` as it is, and the server env of
-the one environment the build is for (`--env`: `debug` for `build-desktop`, `main` for `publish-update`, unless
-named): the build keeps `env/env.server.<env>.ts` and swaps every other environment's file for exports that refuse to
-be read. The server env each lib exports as its defaults (spread into every environment by `env.server.type.ts`)
-ships as well. Keep a key in those files only if every user of the app may hold it; a secret the server needs belongs
-to a cloud server its adapter calls. There is no `public/`: a file the server reads at runtime goes in `private/` and is
-read from `AKAN_APP_DIR` (the folder `server.js` sits in), never from `process.cwd()`, which is the app's data
-folder.
+server's adapter. It refuses a `Host` other than its own, but any program on the computer can still call that port:
+guard its endpoints as a network server's. It runs in one process, so a `main.ts` or an env asking for replicas (`replica`,
+`solo: false`, `AKAN_SOLO=false`, `AKAN_REPLICA`, `AKAN_COMMAND_TYPE=start`) does not boot in the app. Its data lives in the app's local data folder (`%LOCALAPPDATA%\<id>\server`
+on Windows, never Roaming; `server-debug` for a `--debug` build). It trusts the OS certificate store, and of the
+user's environment it takes a fixed set and nothing else: the system's own (`PATH`, `HOME`, the temp folder, `LANG`,
+`TZ`, Windows' folders and `ComSpec`), the desktop session a `bin` tool needs for the screen or the audio server
+(`DISPLAY`, `XAUTHORITY`, `WAYLAND_DISPLAY`, the session bus, `PULSE_*`, `XDG_*`), and the proxy and CA variables
+(`HTTP(S)_PROXY`, `NO_PROXY`, `NODE_EXTRA_CA_CERTS`, `SSL_CERT_FILE`).
+
+**Everything it carries is on the user's computer, readable.** That is `private/` as it is — each lib's too, under
+`private/libs/<lib>` — and the server env of the one environment the build is for (`--env`: `debug` for
+`build-desktop`, `local` for `start-desktop --release`, `main` for `publish-update`, unless named): the build keeps
+`env/env.server.<env>.ts` and swaps every other environment's file for exports that refuse to be read. The server env
+each lib exports as its defaults (the lib's `env.server.testing.ts`, spread into every environment by
+`env.server.type.ts`) ships as well. Keep a key in those files only if every user of the app may hold it; a secret the
+server needs belongs to a cloud server its adapter calls. There is no `public/`: a file the server reads at runtime
+goes in `private/` and is read from `AKAN_APP_DIR` (the folder `server.js` sits in), never from `process.cwd()`, which
+is the app's data folder.
 
 **Nothing from `docker` reaches it.** `preRuns`, `postRuns` and a whole Dockerfile install into a Linux image the
 desktop app never runs in, and the build warns when an app has them and carries no `bin`. What the server needs
@@ -265,9 +272,11 @@ Windows, VAAPI or NVENC on Linux. Codec patents are a separate question to settl
 **A server bound to its machine stays a service.** A server that needs a whole environment — ROS, system services,
 root to change the network or the clock — runs as a service on that machine (the image), and the desktop app's
 target leaves `desktop.server` off, pinned to it with `AKAN_PUBLIC_SERVER_URL` at build time. A carried server runs
-as the signed-in user and stops with the app, and so does what it started: on macOS and Linux the server leads its
-own process group, which ends with it, also when the app was killed or crashed; on Windows the job object does the
-same.
+as the signed-in user and stops with the app, and so does what it started. On macOS and Linux the server leads its
+own process group: quitting the app ends the group, and when the app was killed or crashed — even while the server
+was still starting — the server sees its parent gone and ends the group itself, SIGTERM first and SIGKILL a second
+later for whatever ignored it. On Windows the job object ends them all with the app. A process started `detached`
+leaves the group, or the job, and keeps running.
 
 **A file the user picks reaches the server as a grant, never as a copy or a path.** With `native.plugins:
 ["file-picker"]` on the target, `filePicker.pickFiles({ forServer: true })` (also `pickDirectory` and `saveFile`,

package/{index-vt64c067.js → index-16k7m3cs.js}

@@ -26,7 +26,7 @@ import {
   appIdsOf,
   NativeApp,
   isPlaceholderAppId
-} from "./index-tfe3711h.js";
+} from "./index-1hs6jrys.js";
 import {
   Prompter2
 } from "./index-zzvvc845.js";

package/{index-tfe3711h.js → index-1hs6jrys.js}

@@ -80,7 +80,6 @@ var targetHtmlFilename = (target) => {
 };
 
 // pkgs/@akanjs/devkit/mobile/nativeApp.ts
-import { mkdir as mkdir3 } from "fs/promises";
 import path6 from "path";
 
 // pkgs/@akanjs/devkit/mobile/desktopBin.ts
@@ -573,11 +572,14 @@ ${html}`;
 ${script}${html.slice(at)}`;
   }
   static #targetTag = "<script>window.__AKAN_MOBILE_TARGET__=";
+  async clear() {
+    await rm2(this.dir, { recursive: true, force: true });
+    await mkdir2(this.dir, { recursive: true });
+  }
   async assemble(target, { html, publicDir, fontsDir }) {
     if (!await Bun.file(html).exists())
       throw new Error(`CSR html for mobile target '${target.name}' not found: ${html}`);
-    await rm2(this.dir, { recursive: true, force: true });
-    await mkdir2(this.dir, { recursive: true });
+    await this.clear();
     if (publicDir && await NativeWebDir.#isDir(publicDir))
       await cp(publicDir, this.dir, { recursive: true });
     if (fontsDir && await NativeWebDir.#isDir(fontsDir))
@@ -615,6 +617,9 @@ class NativeApp {
   outDir(platform) {
     return path6.join(this.targetRoot, "native", platform);
   }
+  devOutDir(platform) {
+    return path6.join(this.targetRoot, "dev", platform);
+  }
   async assembleWeb() {
     const dist = this.app.dist.cwdPath;
     return await this.web.assemble(this.target.config, {
@@ -658,12 +663,15 @@ class NativeApp {
     ]);
     for (const warning of warnings)
       this.app.logger.warn(warning);
+    this.#assertValid(api, config);
+    return { api, config };
+  }
+  #assertValid(api, config) {
     const problems = api.validateConfig(config, { appDir: this.app.cwdPath });
     if (problems.length)
       throw new Error(`Mobile target '${this.target.name}' makes an invalid native config:
 - ${problems.join(`
 - `)}`);
-    return { api, config };
   }
   #appLine = (line) => {
     const read = NativeAppLine.read(line, { verbose: Executor.verbose });
@@ -672,12 +680,12 @@ class NativeApp {
     else
       this.app.logger[read.level](read.message);
   };
-  #task(platform, config) {
+  #task(platform, config, outDir = this.outDir(platform)) {
     return {
       appDir: this.app.cwdPath,
       config,
       platform,
-      outDir: this.outDir(platform),
+      outDir,
       envFiles: false,
       skipWebBuild: true,
       log: (event) => {
@@ -723,10 +731,10 @@ class NativeApp {
     const boot = { steps: [], lines: [] };
     this.#boot = boot;
     try {
-      await mkdir3(this.web.dir, { recursive: true });
+      await this.web.clear();
       const [{ api, config }, { api: routes }] = await Promise.all([this.prepare(platform), this.app.getConfig()]);
       const session = await api.dev({
-        ...this.#task(platform, config),
+        ...this.#task(platform, config, this.devOutDir(platform)),
         upstream,
         hmrPath: "/_akan/hmr",
         wsPaths: [`${routes.prefix}${routes.websocketPrefix}`],
@@ -772,8 +780,7 @@ class NativeApp {
   }
   async publishUpdate(platform, { channel, server } = {}) {
     NativeApp.#assertServerPlatform(platform, server);
-    if (!this.target.config.updates)
-      throw new Error(`Mobile target '${this.target.name}' has no updates: { url, publicKey } in akan.config.ts; \`akan update-keygen ${this.app.name}\` prints the key.`);
+    this.#assertUpdates();
     await this.assembleWeb();
     const { api, config } = await this.prepare(platform, server);
     return await api.publishUpdate({
@@ -783,6 +790,32 @@ class NativeApp {
       ...channel ? { channel } : {}
     });
   }
+  async assertPublishable(platform, { channel, server = false } = {}) {
+    this.#assertUpdates();
+    const [api, { config }] = await Promise.all([
+      NativeApi.load(this.app.cwdPath),
+      this.config({ platform, stageBin: false })
+    ]);
+    this.#assertValid(api, config);
+    try {
+      api.checkPublishUpdate({
+        appDir: this.app.cwdPath,
+        config,
+        platform,
+        out: this.updatesDir,
+        server,
+        ...channel ? { channel } : {}
+      });
+    } catch (error) {
+      throw new Error(`Mobile target '${this.target.name}': ${error instanceof Error ? error.message : String(error)}`, {
+        cause: error
+      });
+    }
+  }
+  #assertUpdates() {
+    if (!this.target.config.updates)
+      throw new Error(`Mobile target '${this.target.name}' has no updates: { url, publicKey } in akan.config.ts; \`akan update-keygen ${this.app.name}\` prints the key.`);
+  }
   async updateKeygen(platform) {
     const [api, { config }] = await Promise.all([
       NativeApi.load(this.app.cwdPath),
@@ -874,11 +907,20 @@ var isPlaceholderAppId = (appId) => {
   return normalized.split(".").some((segment) => placeholderAppIdSegment.test(segment));
 };
 // pkgs/@akanjs/devkit/mobile/desktopServerStage.ts
-import { cp as cp2, mkdir as mkdir4, readdir as readdir2, rm as rm3, writeFile as writeFile2 } from "fs/promises";
+import { cp as cp2, mkdir as mkdir3, readdir as readdir2, rm as rm3, writeFile as writeFile2 } from "fs/promises";
 import path7 from "path";
 class DesktopServerStage {
   app;
-  static skippedFiles = new Set(["rscWorker.js", "console.js", "console-runtime.js"]);
+  static uncarried = new Set([
+    "Dockerfile",
+    "package.json",
+    "rscWorker.js",
+    "console.js",
+    "console-runtime.js",
+    "csr",
+    "public",
+    ".akan"
+  ]);
   static rscRenderer = "react-server-dom-webpack";
   dir;
   constructor(app) {
@@ -920,22 +962,27 @@ class DesktopServerStage {
     const dependencies = Object.entries(built.dependencies ?? {}).filter(([name]) => config.externalLibs.includes(name) || name !== DesktopServerStage.rscRenderer && !otherDrivers.has(name));
     return { ...built, dependencies: Object.fromEntries(dependencies) };
   }
-  async prepare(environment) {
+  async install() {
     const config = await this.app.getConfig();
     DesktopServerStage.assertCarriable(config);
-    const dist = this.app.dist.cwdPath;
     await rm3(this.dir, { recursive: true, force: true });
-    await mkdir4(this.dir, { recursive: true });
-    const entries = await readdir2(dist, { withFileTypes: true });
-    for (const entry of entries) {
-      const carried = entry.isFile() && (entry.name.endsWith(".js") && !DesktopServerStage.skippedFiles.has(entry.name) || entry.name === "akan.build.json") || entry.isDirectory() && entry.name === "private";
-      if (carried)
-        await cp2(path7.join(dist, entry.name), path7.join(this.dir, entry.name), { recursive: true });
+    await mkdir3(this.dir, { recursive: true });
+    await writeFile2(path7.join(this.dir, "package.json"), JSON.stringify(DesktopServerStage.packageJson(config, config.getProductionPackageJson()), null, 2));
+    try {
+      await this.app.spawn(process.execPath, ["install", "--production", "--prefer-offline"], { cwd: this.dir });
+    } catch (error) {
+      throw new Error(`The desktop app's server could not install its packages in ${this.dir}: it needs the npm registry, or a Bun cache that already holds every one of them.
+${error instanceof Error ? error.message : String(error)}`, { cause: error });
     }
-    const built = await Bun.file(path7.join(dist, "package.json")).json();
-    await writeFile2(path7.join(this.dir, "package.json"), JSON.stringify(DesktopServerStage.packageJson(config, built), null, 2));
-    await this.app.spawn(process.execPath, ["install", "--production"], { cwd: this.dir });
     await rm3(path7.join(this.dir, "node_modules", ".bin"), { recursive: true, force: true });
+  }
+  async prepare(environment) {
+    const config = await this.app.getConfig();
+    const dist = this.app.dist.cwdPath;
+    await mkdir3(this.dir, { recursive: true });
+    for (const name of await readdir2(dist))
+      if (!DesktopServerStage.uncarried.has(name))
+        await cp2(path7.join(dist, name), path7.join(this.dir, name), { recursive: true });
     const scanInfo = this.app.getScanInfo({ allowEmpty: true }) ?? await this.app.scan({ write: false });
     const carried = [...DesktopBin.select(config, scanInfo.getLibs()).keys()];
     const notice = DesktopServerStage.imageStepsNotice(config, carried);

package/{index-n9704w6y.js → index-2yvy9ztj.js}

@@ -10,7 +10,7 @@ import {
 } from "./index-b68zfsvz.js";
 import {
   ContextRunner2
-} from "./index-vt64c067.js";
+} from "./index-16k7m3cs.js";
 
 // pkgs/@akanjs/cli/context/context.script.ts
 import { Logger } from "akanjs/common";

package/{index-52n8xr63.js → index-8ej6r02m.js}

@@ -116,7 +116,7 @@ class SubagentPool2 {
     }
   }
   async#run(id, kind, prompt, signal) {
-    const { CodeAgent } = await import("./CodeAgent-7acv4ah8.js");
+    const { CodeAgent } = await import("./CodeAgent-86q8d13j.js");
     const budget = this.#options.parent.tools.subagent;
     const child = SubagentPool2.childOf(this.#options.parent, kind);
     const agent = await CodeAgent.create({

package/{index-9j0kykc6.js → index-g44da4r2.js}

@@ -11,7 +11,7 @@ import {
 } from "./index-r8gp8zk3.js";
 import {
   ApplicationScript
-} from "./index-0ej0sr6m.js";
+} from "./index-n9gxx7bp.js";
 import {
   PackageScript
 } from "./index-k7809wmg.js";

package/{index-ewbek95g.js → index-krwz9ek9.js}

@@ -4,7 +4,7 @@ import {
   akanCodePaths2,
   McpServerConfig,
   McpSignIn
-} from "./index-52n8xr63.js";
+} from "./index-8ej6r02m.js";
 import {
   stripAnsi
 } from "./index-7md2g9vw.js";
@@ -511,7 +511,7 @@ class AkanToolPack2 {
     return { name: "akan-tools", factory: async (pi) => await this.#register(pi) };
   }
   async names() {
-    const { ContextRunner } = await import("./context.runner-nzaf8c98.js");
+    const { ContextRunner } = await import("./context.runner-70r2fmty.js");
     return [
       ...new ContextRunner().listMcpTools(this.#options.mode).map((tool) => tool.name),
       AkanToolPack2.verifyToolName
@@ -519,7 +519,7 @@ class AkanToolPack2 {
   }
   static verifyToolName = "akan_verify";
   async#register(pi) {
-    const { ContextRunner } = await import("./context.runner-nzaf8c98.js");
+    const { ContextRunner } = await import("./context.runner-70r2fmty.js");
     const runner = new ContextRunner;
     const guidelineNames = await AkanToolPack2.#guidelineNames();
     for (const tool of runner.listMcpTools(this.#options.mode, { guidelineNames })) {

package/{index-0ej0sr6m.js → index-n9gxx7bp.js}

@@ -44,15 +44,15 @@ import {
   LibExecutor,
   PkgExecutor
 } from "./index-r8gp8zk3.js";
-import {
-  LibraryScript
-} from "./index-qtz88kh0.js";
 import {
   DesktopServerStage,
   resolveMobileTargets,
   resolveAppId,
   NativeApp
-} from "./index-tfe3711h.js";
+} from "./index-1hs6jrys.js";
+import {
+  LibraryScript
+} from "./index-qtz88kh0.js";
 import {
   stripAnsi
 } from "./index-7md2g9vw.js";
@@ -69,6 +69,7 @@ import { confirm } from "@inquirer/prompts";
 import { Logger as Logger6 } from "akanjs/common";
 
 // pkgs/@akanjs/cli/application/application.runner.ts
+import { realpathSync } from "fs";
 import path5 from "path";
 
 // pkgs/@akanjs/devkit/akanApp/akanApp.host.ts
@@ -860,6 +861,8 @@ class AkanAppHost {
             message: msg.data.message
           });
           this.#sendOrQueueBuildStatus(status);
+          if (!status.ok)
+            this.#emitDevEvent("failed", status.message);
           return;
         }
         if (backendMsgTypeSet.has(msg.type))
@@ -1864,7 +1867,7 @@ ${uniqueCandidates.map((candidate) => `  - ${candidate}`).join(`
 
 // pkgs/@akanjs/cli/application/application.runner.ts
 import { Logger as Logger3 } from "akanjs/common";
-var loadBuildRunner = async () => (await import("./applicationBuildRunner-w4917tje.js")).ApplicationBuildRunner;
+var loadBuildRunner = async () => (await import("./applicationBuildRunner-ez37p161.js")).ApplicationBuildRunner;
 var loadPrompts = async () => await import("@inquirer/prompts");
 
 class ApplicationRunner extends runner("application") {
@@ -2087,7 +2090,7 @@ try {
       return;
     }
     const upstream = `http://localhost:${await app.getDevPort()}`;
-    if (!await ApplicationRunner.answers(upstream, app.name))
+    if (!await ApplicationRunner.answers(upstream, app.name, app.workspace.workspaceRoot))
       throw new Error(`No dev server answers on ${upstream}; run \`akan start ${app.name}\` first.`);
     const { i18n } = await app.getConfig();
     const session = await nativeApp.dev(platform, { upstream, lang: i18n.defaultLocale, ...selection });
@@ -2109,20 +2112,33 @@ try {
       throw new Error(`start-${platform === "ios" || platform === "android" ? platform : "desktop"} runs one mobile target at a time; pass --target <name>.`);
     return mobileTarget;
   }
-  static async answers(url, appName) {
+  static async answers(url, appName, workspaceRoot) {
     const signal = AbortSignal.timeout(3000);
     const health = await fetch(new URL("/_akan/app/health", url), { signal }).catch(() => null);
     if (!health)
       return false;
     const info = await fetch(new URL("/_akan/app/info", url), { signal }).then(async (res) => res.ok ? await res.json() : null).catch(() => null);
-    if (info?.appName === appName)
-      return true;
     const stopIt = `Stop it (\`akan start ${appName} --kill\` takes the port over) or give ${appName} another port with AKAN_DEV_PORT`;
+    if (info?.appName === appName) {
+      if (typeof info.workspaceRoot !== "string" || ApplicationRunner.#sameCheckout(info.workspaceRoot, workspaceRoot))
+        return true;
+      throw new Error(`${url} is the dev server of ${appName} in ${info.workspaceRoot}, not in ${workspaceRoot}. ${stopIt}.`);
+    }
     if (typeof info?.appName === "string")
       throw new Error(`${url} is the dev server of ${info.appName}, not ${appName}. ${stopIt}.`);
     const { pid } = await health.json().catch(() => null) ?? {};
     throw new Error(typeof pid === "number" ? `${url} is an akan dev server (pid ${pid}) too old to say which app it serves. ${stopIt}.` : `${url} answers, but not as an akan dev server. Stop what holds the port or give ${appName} another port with AKAN_DEV_PORT.`);
   }
+  static #sameCheckout(reported, own) {
+    const canonical = (root) => {
+      try {
+        return realpathSync.native(root);
+      } catch {
+        return path5.resolve(root);
+      }
+    };
+    return canonical(reported) === canonical(own);
+  }
   async releaseIos(app, { target, env = "main", teamId, adHoc = false } = {}) {
     const targets = await resolveMobileTargets(app, target);
     await this.#buildMobileCsr(app, env);
@@ -2176,6 +2192,11 @@ try {
   async publishUpdate(app, platform, { target, env = "main", channel } = {}) {
     const targets = await resolveMobileTargets(app, target);
     const nativePlatform = platform === "desktop" ? NativeApp.desktopPlatform() : platform;
+    for (const mobileTarget of targets)
+      await new NativeApp(app, mobileTarget, env).assertPublishable(nativePlatform, {
+        server: ApplicationRunner.carriesServer(mobileTarget, nativePlatform),
+        ...channel ? { channel } : {}
+      });
     const carried = await this.#stageMobile(app, nativePlatform, targets, env);
     for (const mobileTarget of targets) {
       const nativeApp = new NativeApp(app, mobileTarget, env);
@@ -2200,11 +2221,10 @@ try {
     return platform !== "ios" && platform !== "android" && config.native?.desktop?.server === true;
   }
   async#stageMobile(app, platform, targets, env) {
-    const carries = targets.some((mobileTarget) => ApplicationRunner.carriesServer(mobileTarget, platform));
-    if (carries)
-      DesktopServerStage.assertCarriable(await app.getConfig());
+    const stage = targets.some((mobileTarget) => ApplicationRunner.carriesServer(mobileTarget, platform)) ? new DesktopServerStage(app) : null;
+    await stage?.install();
     await this.#buildMobileCsr(app, env);
-    return carries ? await new DesktopServerStage(app).prepare(env) : undefined;
+    return await stage?.prepare(env);
   }
   async#buildMobileCsr(app, env) {
     const prevEnv = {
@@ -3343,12 +3363,13 @@ class ApplicationScript extends script("application", [ApplicationRunner, Librar
     const mobileTarget = await ApplicationRunner.startTarget(app, undefined, options.target);
     if (!ApplicationRunner.carriesServer(mobileTarget))
       return await this.applicationRunner.startDesktop(app, options);
+    DesktopServerStage.assertCarriable(await app.getConfig());
     const upstream = `http://localhost:${await app.getDevPort()}`;
-    if (await ApplicationRunner.answers(upstream, app.name))
-      app.log(`The desktop app follows the dev server on ${upstream}.`);
-    else
-      await this.#startDevServerFor(app, upstream);
     try {
+      if (await ApplicationRunner.answers(upstream, app.name, app.workspace.workspaceRoot))
+        app.log(`The desktop app follows the dev server on ${upstream}.`);
+      else
+        await this.#startDevServerFor(app, upstream);
       await this.applicationRunner.startDesktop(app, { ...options, interrupt: this.#interrupt });
     } finally {
       await this.#interrupt.runAll();

package/index.js

@@ -13,18 +13,18 @@ import path from "path";
 
 // pkgs/@akanjs/cli/commandModules.ts
 var commandModules = {
-  workspace: async () => (await import("./workspace.command-wypqk2zb.js")).WorkspaceCommand,
+  workspace: async () => (await import("./workspace.command-jxdm0wrb.js")).WorkspaceCommand,
   agent: async () => (await import("./agent.command-q9bmqrag.js")).AgentCommand,
-  code: async () => (await import("./code.command-fpx4gzmy.js")).CodeCommand,
-  application: async () => (await import("./application.command-xpnkyx4z.js")).ApplicationCommand,
+  code: async () => (await import("./code.command-n0c2tyzx.js")).CodeCommand,
+  application: async () => (await import("./application.command-712jd2z8.js")).ApplicationCommand,
   library: async () => (await import("./library.command-tz7vnwea.js")).LibraryCommand,
-  localRegistry: async () => (await import("./localRegistry.command-f39yk7be.js")).LocalRegistryCommand,
+  localRegistry: async () => (await import("./localRegistry.command-7dd85czz.js")).LocalRegistryCommand,
   package: async () => (await import("./package.command-z3epnvas.js")).PackageCommand,
   module: async () => (await import("./module.command-qhc9ns0s.js")).ModuleCommand,
   page: async () => (await import("./page.command-exd2vakz.js")).PageCommand,
-  context: async () => (await import("./context.command-snn1k5q3.js")).ContextCommand,
-  cloud: async () => (await import("./cloud.command-7yd624qd.js")).CloudCommand,
-  subspace: async () => (await import("./subspace.command-0e53tvxk.js")).SubspaceCommand,
+  context: async () => (await import("./context.command-vxf6d7q2.js")).ContextCommand,
+  cloud: async () => (await import("./cloud.command-8eegwcsc.js")).CloudCommand,
+  subspace: async () => (await import("./subspace.command-683qxcw9.js")).SubspaceCommand,
   guideline: async () => (await import("./guideline.command-ene55fkr.js")).GuidelineCommand,
   scalar: async () => (await import("./scalar.command-60nxfchc.js")).ScalarCommand,
   primitive: async () => (await import("./primitive.command-0w6cha4j.js")).PrimitiveCommand,

package/{localRegistry.command-f39yk7be.js → localRegistry.command-7dd85czz.js}

@@ -10,11 +10,11 @@ import {
   PkgExecutor
 } from "./index-r8gp8zk3.js";
 import"./index-48k96p55.js";
+import"./index-1hs6jrys.js";
 import"./index-qtz88kh0.js";
 import {
   ApplicationScript
-} from "./index-0ej0sr6m.js";
-import"./index-tfe3711h.js";
+} from "./index-n9gxx7bp.js";
 import"./index-7md2g9vw.js";
 import"./index-94s080qm.js";
 import {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@akanjs/cli",
-  "version": "3.0.0-beta.28",
+  "version": "3.0.0-beta.29",
   "sourceType": "module",
   "type": "module",
   "publishConfig": {
@@ -39,7 +39,7 @@
     "@earendil-works/pi-tui": "0.86.1",
     "@inquirer/prompts": "^8.4.3",
     "@tailwindcss/node": "^4.3.0",
-    "akanjs": "3.0.0-beta.28",
+    "akanjs": "3.0.0-beta.29",
     "chalk": "^5.6.2",
     "commander": "^14.0.3",
     "dayjs": "^1.11.20",
@@ -62,4 +62,4 @@
   "bun": {
     "platform": "bun"
   }
-}
+}

package/{subspace.command-0e53tvxk.js → subspace.command-683qxcw9.js}

@@ -716,7 +716,7 @@ class SubspaceRunner extends runner("subspace") {
     if (!asked)
       return { name: subspace.name, workspaceId, host, apps, libs: [], outcome: "cancelled", files: [] };
     const { libs } = await subspace.slice();
-    const { CloudScript } = await import("./cloud.script-25vzkz7b.js");
+    const { CloudScript } = await import("./cloud.script-55s1cmz9.js");
     const { files } = await CommandContainer.get(CloudScript).uploadEnv(workspace, {
       host,
       workspaceId,

package/{workspace.command-wypqk2zb.js → workspace.command-jxdm0wrb.js}

@@ -39,13 +39,13 @@ import {
   AgentScript
 } from "./index-rbeahw6j.js";
 import"./index-48k96p55.js";
+import"./index-1hs6jrys.js";
 import {
   LibraryScript
 } from "./index-qtz88kh0.js";
 import {
   ApplicationScript
-} from "./index-0ej0sr6m.js";
-import"./index-tfe3711h.js";
+} from "./index-n9gxx7bp.js";
 import"./index-7md2g9vw.js";
 import"./index-2ahj896a.js";
 import {
@@ -57,8 +57,8 @@ import {
 } from "./index-rrt9pnb4.js";
 import {
   CloudScript2
-} from "./index-9j0kykc6.js";
-import"./index-vt64c067.js";
+} from "./index-g44da4r2.js";
+import"./index-16k7m3cs.js";
 import"./index-2z30v4k5.js";
 import"./index-ss828r32.js";
 import"./index-genegfnt.js";
@@ -67,7 +67,7 @@ import"./index-2ctqegdm.js";
 import"./index-h9ed99ax.js";
 import {
   ContextScript
-} from "./index-n9704w6y.js";
+} from "./index-2yvy9ztj.js";
 import"./index-nbg9bfnr.js";
 
 // pkgs/@akanjs/cli/workspace/workspace.runner.ts

package/README.ko.md

@@ -1,72 +0,0 @@
-# @akanjs/cli
-
-[문서](https://akanjs.com/docs) | [npm](https://www.npmjs.com/package/@akanjs/cli) | [런타임](https://www.npmjs.com/package/akanjs)
-
-Akan.js 워크스페이스를 위한 command-line tooling입니다.
-
-`@akanjs/cli`는 Akan 애플리케이션, 라이브러리, 프레임워크 패키지를 생성, 빌드, 테스트, 린트,
-릴리즈, 유지보수하는 데 사용하는 `akan` 실행 파일을 제공합니다. Bun-first CLI 패키지이며 Akan
-개발 tooling을 내부에 번들링하므로, 애플리케이션 런타임은 더 작은 `akanjs` 패키지에만 의존할 수
-있습니다.
-
-## 설치
-
-새 워크스페이스를 바로 만들 수 있습니다.
-
-```bash
-bunx create-akan-workspace@latest
-```
-
-또는 CLI를 전역으로 설치할 수 있습니다.
-
-```bash
-bun install -g @akanjs/cli@latest
-akan --help
-```
-
-## 자주 쓰는 명령
-
-```bash
-akan create-workspace <workspace-name>
-akan start <app-name>
-akan build <app-name>
-akan test <app-or-lib-or-pkg>
-akan lint <app-or-lib-or-pkg>
-akan create-application <app-name>
-akan create-library <lib-name>
-akan create-module <module-name>
-akan create-scalar <scalar-name>
-```
-
-패키지 유지보수 명령도 같은 실행 파일에서 제공합니다.
-
-```bash
-akan build-package akanjs
-akan build-package @akanjs/cli
-akan build-package @akanjs/devkit
-akan build-package create-akan-workspace
-akan verify-akan-publish-packages
-akan smoke-registry --test=true --tag=rc
-```
-
-Akan framework 패키지는 반드시 `dist/pkgs/*` 산출물 기준으로 publish합니다. `verify-akan-publish-packages`는
-빌드된 패키지에 `npm pack --dry-run --json`을 실행하고, `deploy-akan` 또는 local registry smoke 전에 필요한
-metadata를 검증합니다.
-저장소 릴리즈에서는 root `akan` bootstrap script가 CLI dist를 덮어쓰지 않도록
-`bun run release:build-packages && bun run release:verify-packages`를 우선 사용합니다.
-
-## 패키지 경계
-
-- 애플리케이션과 런타임 코드는 `akanjs`를 사용합니다.
-- 사용자-facing 실행 패키지는 `@akanjs/cli`입니다.
-- `@akanjs/devkit`은 published CLI 사용을 위해 CLI 안에 번들링됩니다. 일반 CLI 사용자가 별도의
-  runtime dependency로 설치할 필요는 없습니다.
-
-## 요구사항
-
-- [Bun](https://bun.sh) `>=1.4.0`
-- TypeScript 기반 Akan 워크스페이스
-
-## 라이선스
-
-MIT

package/README.md

@@ -1,88 +0,0 @@
-# @akanjs/cli
-
-[Docs](https://akanjs.com/docs) | [npm](https://www.npmjs.com/package/@akanjs/cli) | [Runtime](https://www.npmjs.com/package/akanjs)
-
-Command-line tooling for Akan.js workspaces.
-
-`@akanjs/cli` provides the `akan` executable used to create, build, test, lint, release, and maintain Akan
-applications, libraries, and framework packages. It is a Bun-first CLI package and bundles Akan development
-tooling internally so application runtimes can depend on the smaller `akanjs` package.
-
-## Install
-
-Create a new workspace:
-
-```bash
-bunx create-akan-workspace@latest
-```
-
-Or install the CLI globally:
-
-```bash
-bun install -g @akanjs/cli@latest
-akan --help
-```
-
-## Common Commands
-
-```bash
-akan create-workspace <workspace-name>
-akan start <app-name>
-akan build <app-name>
-akan test <app-or-lib-or-pkg>
-akan lint <app-or-lib-or-pkg>
-akan create-application <app-name>
-akan create-library <lib-name>
-akan create-module <module-name>
-akan create-scalar <scalar-name>
-```
-
-## Agent And MCP Commands
-
-```bash
-akan context --format markdown
-akan context --format json --module <module-name>
-akan doctor --format json
-akan guideline list
-akan guideline show framework
-akan agent install cursor
-akan mcp
-```
-
-These commands expose Akan workspace structure, module abstracts, diagnostics, and guideline instructions for
-coding agents. The MCP server is read-only and is intended to provide context rather than edit files directly.
-
-Package maintenance commands are also exposed through the same executable:
-
-```bash
-akan build-package akanjs
-akan build-package @akanjs/cli
-akan build-package @akanjs/devkit
-akan build-package create-akan-workspace
-akan verify-akan-publish-packages
-akan smoke-registry --test=true --tag=rc
-```
-
-Publish Akan framework packages from `dist/pkgs/*` only. `verify-akan-publish-packages` runs `npm pack --dry-run --json`
-against the built packages and checks metadata that must be correct before `deploy-akan` or local registry smoke.
-For repository releases, prefer `bun run release:build-packages && bun run release:verify-packages` so the CLI package
-artifact is built last and is not overwritten by the root `akan` bootstrap script.
-
-## Package Boundary
-
-- Use `akanjs` from application and runtime code.
-- Use `@akanjs/cli` as the user-facing executable package.
-- `@akanjs/devkit` is bundled into the CLI for published CLI usage; it is not required as a separate
-  runtime dependency for ordinary CLI users.
-- The `akan code` agent follows that same split: its engine, tools and skills are a devkit facet
-  (`@akanjs/devkit/codeAgent`), and `@akanjs/cli/code` is the terminal host plus the SDK entry that
-  re-exports both.
-
-## Requirements
-
-- [Bun](https://bun.sh) `>=1.4.0`
-- A TypeScript Akan workspace
-
-## License
-
-MIT