@akanjs/cli 3.1.0-rc.1 → 3.1.0-rc.11

package/{cloud.command-yj6xb2a7.js → cloud.command-9cp1t0f5.js}

@@ -3,57 +3,48 @@ import {
   App,
   Workspace,
   command
-} from "./index-6jjtnhkw.js";
+} from "./index-jw1zm273.js";
 import"./index-52w0fvh8.js";
-import"./index-55mynnqs.js";
-import"./index-1w2qaee2.js";
-import"./index-pgj2rt78.js";
+import"./index-va06nr10.js";
+import"./index-cpb3nvma.js";
 import {
   PlatformTestRun
-} from "./index-8ggztp8k.js";
-import"./index-k9rrten6.js";
-import"./index-c1x0be5j.js";
-import"./index-jx4bzvwg.js";
+} from "./index-fyq1z6kt.js";
+import"./index-vk0pa0mn.js";
+import"./index-m9jj544v.js";
+import"./index-g1mbppa9.js";
+import"./index-192ha4xh.js";
+import"./index-5nd1wtkv.js";
+import"./index-pydbnfez.js";
+import"./index-d47ypebv.js";
 import"./index-7md2g9vw.js";
-import"./index-2ahj896a.js";
-import"./index-gnyf1fqy.js";
+import"./index-tvehn2sp.js";
+import"./index-j237xtew.js";
 import {
   CloudScript2
-} from "./index-rc5rwyps.js";
-import"./index-qt22xstj.js";
+} from "./index-bspm21y1.js";
 import {
-  getMobileTargetChoices
-} from "./index-q958tqqg.js";
+  writeOption,
+  oneNativeTargetOption,
+  nativeEnvs,
+  releaseEnvOption,
+  allowLocalOption,
+  publicEnvOption,
+  hostOption,
+  subspaceOption
+} from "./index-mdjc93e1.js";
+import"./index-35hc95h5.js";
+import"./index-665zp9rs.js";
 
 // pkgs/@akanjs/cli/cloud/cloud.command.ts
 var localRegistryUrl = () => process.env.AKAN_NPM_REGISTRY ?? "http://127.0.0.1:4873";
-var hostOption = {
-  desc: "host of the cloud to target (default: cloud.host of the root akan.config.ts, else Akan Cloud)",
-  nullable: true
-};
-var targetOption = {
-  desc: "native target name (a key of native.targets)",
-  ask: "Select native target",
-  enum: async ({ app }) => await getMobileTargetChoices(app)
-};
-var envOption = {
-  enum: ["debug", "develop", "main", "local"],
-  desc: "backend environment",
-  default: "main"
-};
 var resolveRegistryUrl = (registry) => registry === "local" ? localRegistryUrl() : undefined;
 
 class CloudCommand extends command("cloud", [CloudScript2], ({ public: target }) => ({
-  login: target({ desc: "Login to Akan Cloud services" }).option("host", String, {
-    desc: "host of the cloud (default: cloud.host of the root akan.config.ts, else Akan Cloud)",
-    nullable: true
-  }).with(Workspace).exec(async function(host, workspace) {
+  login: target({ desc: "Login to Akan Cloud services" }).option("host", String, hostOption).with(Workspace).exec(async function(host, workspace) {
     await this.cloudScript.login(workspace, host);
   }),
-  logout: target({ desc: "Logout from Akan Cloud services" }).option("host", String, {
-    desc: "host of the cloud (default: cloud.host of the root akan.config.ts, else Akan Cloud)",
-    nullable: true
-  }).with(Workspace).exec(async function(host, workspace) {
+  logout: target({ desc: "Logout from Akan Cloud services" }).option("host", String, hostOption).with(Workspace).exec(async function(host, workspace) {
     await this.cloudScript.logout(workspace, host);
   }),
   deployAkan: target({ devOnly: true, desc: "Deploy Akan.js framework to cloud (internal use)" }).option("test", Boolean, { desc: "test the deployment", default: true }).option("registry", String, {
@@ -105,12 +96,27 @@ class CloudCommand extends command("cloud", [CloudScript2], ({ public: target })
     await this.cloudScript.update(workspace, tag, { registryUrl: resolveRegistryUrl(registry) });
   }),
   pushUpdate: target({
-    desc: "Pack an over-the-air update of a phone's web bundle and upload it to the akasys project, which signs and publishes it"
-  }).with(App).option("platform", String, { enum: ["ios", "android"], desc: "the app it updates" }).option("target", String, targetOption).option("env", String, envOption).option("channel", String, { desc: "the channel (default: the target's updates.channel)", nullable: true }).option("notes", String, { desc: "release notes shown in the project", nullable: true }).option("subspace", String, { desc: "the subspace whose project gets it", nullable: true }).option("host", String, hostOption).option("write", Boolean, { desc: "write code generation", default: true }).option("allowLocalRelease", Boolean, { flag: "l", desc: "allow packing with --env local", default: false }).option("pack", String, {
+    desc: "Pack an over-the-air update of a phone's web bundle, or take the folder `akan pack-update` wrote, and upload it to the Akan Cloud project, which signs and publishes it. Exits 2 when the pack needs a new store build or the project rejects it, 1 on any other failure"
+  }).with(App).option("platform", String, {
+    enum: ["ios", "android"],
+    desc: "the app it updates (with --pack, default: the pack's)",
+    nullable: true
+  }).option("target", String, {
+    desc: "native target name, a key of native.targets (default: the only one; with --pack, the pack's)",
+    nullable: true
+  }).option("env", String, {
+    enum: nativeEnvs,
+    desc: "backend environment (default: main; with --pack, the pack's)",
+    nullable: true
+  }).option("channel", String, { desc: "the channel (default: the target's updates.channel)", nullable: true }).option("notes", String, { desc: "release notes shown in the project", nullable: true }).option("subspace", String, subspaceOption("gets it")).option("host", String, hostOption).option("write", Boolean, writeOption).option("allowLocalRelease", Boolean, {
+    flag: "l",
+    desc: "allow packing, or uploading a pack made, with --env local",
+    default: false
+  }).option("pack", String, {
     flag: "d",
-    desc: "a folder `akan pack-update` wrote, uploaded instead of packing",
+    desc: "a folder `akan pack-update` wrote, uploaded instead of packing; --platform, --target and --env must match it",
     nullable: true
-  }).with(Workspace).exec(async function(app, platform, target, env, channel, notes, subspace, host, write, allowLocalRelease, pack, workspace) {
+  }).option("publicEnv", String, publicEnvOption("the update")).with(Workspace).exec(async function(app, platform, target, env, channel, notes, subspace, host, write, allowLocalRelease, pack, publicEnv, workspace) {
     await this.cloudScript.pushUpdate(workspace, app, {
       platform,
       target,
@@ -121,15 +127,16 @@ class CloudCommand extends command("cloud", [CloudScript2], ({ public: target })
       host,
       write,
       allowLocalRelease,
-      pack
+      pack,
+      publicEnv
     });
   }),
   registerBinary: target({
-    desc: "Register the store build of a phone app with the akasys project, with a pack of the same commit as its embedded bundle"
+    desc: "Register the store build of a phone app with the Akan Cloud project, with a pack of the same commit as its embedded bundle. Exits 2 when the store build differs natively from this commit's pack, 1 on any other failure"
   }).with(App).option("platform", String, { enum: ["ios", "android"], desc: "the store build to register" }).option("distribution", String, {
     enum: ["appStore", "testFlight", "playStore", "playTesting", "direct"],
     desc: "where the binary ships"
-  }).option("target", String, targetOption).option("env", String, envOption).option("subspace", String, { desc: "the subspace whose project gets it", nullable: true }).option("host", String, hostOption).option("write", Boolean, { desc: "write code generation", default: true }).option("allowLocalRelease", Boolean, { flag: "l", desc: "allow packing with --env local", default: false }).with(Workspace).exec(async function(app, platform, distribution, target, env, subspace, host, write, allowLocalRelease, workspace) {
+  }).option("target", String, oneNativeTargetOption).option("env", String, releaseEnvOption).option("subspace", String, subspaceOption("gets it")).option("host", String, hostOption).option("write", Boolean, writeOption).option("allowLocalRelease", Boolean, allowLocalOption("packing")).option("publicEnv", String, publicEnvOption("the pack (default: what the store build recorded)")).with(Workspace).exec(async function(app, platform, distribution, target, env, subspace, host, write, allowLocalRelease, publicEnv, workspace) {
     await this.cloudScript.registerBinary(workspace, app, {
       platform,
       distribution,
@@ -138,51 +145,37 @@ class CloudCommand extends command("cloud", [CloudScript2], ({ public: target })
       subspace,
       host,
       write,
-      allowLocalRelease
+      allowLocalRelease,
+      publicEnv
     });
   }),
   uploadSecret: target({
-    desc: "Upload a named pipeline secret to the akasys project; write-only, it can never be read back"
+    desc: "Upload a named pipeline secret to the Akan Cloud project; write-only, it can never be read back"
   }).arg("name", String, { desc: "secret name, e.g. DISCORD_WEBHOOK" }).option("branch", String, {
     desc: "only builds of this branch use it: debug, develop or main (default: every branch)",
     nullable: true
   }).option("file", String, {
     desc: "read the value from this file instead of stdin or a hidden prompt",
     nullable: true
-  }).option("subspace", String, { desc: "the subspace whose project gets it", nullable: true }).option("host", String, {
-    desc: "host of the cloud to target (default: cloud.host of the root akan.config.ts, else Akan Cloud)",
-    nullable: true
-  }).with(Workspace).exec(async function(name, branch, file, subspace, host, workspace) {
+  }).option("subspace", String, subspaceOption("gets it")).option("host", String, hostOption).with(Workspace).exec(async function(name, branch, file, subspace, host, workspace) {
     await this.cloudScript.uploadSecret(workspace, { name, branch, file, subspace, host });
   }),
-  listSecrets: target({ desc: "List the pipeline secrets of the akasys project: names and scopes, never values" }).option("branch", String, {
+  listSecrets: target({ desc: "List the pipeline secrets of the Akan Cloud project: names and scopes, never values" }).option("branch", String, {
     desc: "only the secrets builds of this branch use: debug, develop or main",
     nullable: true
-  }).option("subspace", String, { desc: "the subspace whose project to list", nullable: true }).option("host", String, {
-    desc: "host of the cloud to target (default: cloud.host of the root akan.config.ts, else Akan Cloud)",
-    nullable: true
-  }).with(Workspace).exec(async function(branch, subspace, host, workspace) {
+  }).option("subspace", String, subspaceOption("to list")).option("host", String, hostOption).with(Workspace).exec(async function(branch, subspace, host, workspace) {
     await this.cloudScript.listSecrets(workspace, { branch, subspace, host });
   }),
-  removeSecret: target({ desc: "Remove a named pipeline secret from the akasys project" }).arg("name", String, { desc: "secret name" }).option("branch", String, {
+  removeSecret: target({ desc: "Remove a named pipeline secret from the Akan Cloud project" }).arg("name", String, { desc: "secret name" }).option("branch", String, {
     desc: "the branch override to remove: debug, develop or main (default: the every-branch value)",
     nullable: true
-  }).option("subspace", String, { desc: "the subspace whose project holds it", nullable: true }).option("host", String, {
-    desc: "host of the cloud to target (default: cloud.host of the root akan.config.ts, else Akan Cloud)",
-    nullable: true
-  }).with(Workspace).exec(async function(name, branch, subspace, host, workspace) {
+  }).option("subspace", String, subspaceOption("holds it")).option("host", String, hostOption).with(Workspace).exec(async function(name, branch, subspace, host, workspace) {
     await this.cloudScript.removeSecret(workspace, { name, branch, subspace, host });
   }),
-  downloadEnv: target({ desc: "Download environment variables from cloud or SCP server" }).option("host", String, {
-    desc: "host of the cloud to target (default: cloud.host of the root akan.config.ts, else Akan Cloud)",
-    nullable: true
-  }).with(Workspace).exec(async function(host, workspace) {
+  downloadEnv: target({ desc: "Download environment variables from cloud or SCP server" }).option("host", String, hostOption).with(Workspace).exec(async function(host, workspace) {
     await this.cloudScript.downloadEnv(workspace, undefined, { host });
   }),
-  uploadEnv: target({ desc: "Upload environment variables to cloud or SCP server" }).option("host", String, {
-    desc: "host of the cloud to target (default: cloud.host of the root akan.config.ts, else Akan Cloud)",
-    nullable: true
-  }).with(Workspace).exec(async function(host, workspace) {
+  uploadEnv: target({ desc: "Upload environment variables to cloud or SCP server" }).option("host", String, hostOption).with(Workspace).exec(async function(host, workspace) {
     await this.cloudScript.uploadEnv(workspace, { host });
   })
 })) {

package/cloud.script-dgstqt1m.js

@@ -0,0 +1,24 @@
+// @bun
+import {
+  CloudScript2
+} from "./index-bspm21y1.js";
+import"./index-fyq1z6kt.js";
+import"./index-d47ypebv.js";
+import"./index-35hc95h5.js";
+import"./index-pydbnfez.js";
+import"./index-j237xtew.js";
+import"./index-vk0pa0mn.js";
+import"./index-cpb3nvma.js";
+import"./index-g1mbppa9.js";
+import"./index-m9jj544v.js";
+import"./index-jw1zm273.js";
+import"./index-7md2g9vw.js";
+import"./index-665zp9rs.js";
+import"./index-5nd1wtkv.js";
+import"./index-192ha4xh.js";
+import"./index-va06nr10.js";
+import"./index-tvehn2sp.js";
+import"./index-52w0fvh8.js";
+export {
+  CloudScript2 as CloudScript
+};

package/{code.command-3wkn4ja5.js → code.command-0ad6gw2a.js}

@@ -4,9 +4,9 @@ import {
   runner,
   script,
   command
-} from "./index-6jjtnhkw.js";
+} from "./index-jw1zm273.js";
 import"./index-52w0fvh8.js";
-import"./index-55mynnqs.js";
+import"./index-va06nr10.js";
 import {
   akanCodeDefaultModel2,
   CodeAgentStreamPrinter2
@@ -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-kyprmy06.js"),
+      import("./CodeAgent-rkjyxgec.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-kyprmy06.js"),
-      import("./CodeTui-21mtze3j.js")
+      import("./CodeAgent-rkjyxgec.js"),
+      import("./CodeTui-h7pyj6xa.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-kyprmy06.js");
+    const { CodeAgent } = await import("./CodeAgent-rkjyxgec.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-9jjn3gcw.js → context.command-0qx447mb.js}

@@ -2,24 +2,28 @@
 import {
   Workspace,
   command
-} from "./index-6jjtnhkw.js";
+} from "./index-jw1zm273.js";
 import"./index-52w0fvh8.js";
-import"./index-55mynnqs.js";
+import"./index-va06nr10.js";
 import"./index-hj6w4ka1.js";
-import"./index-05g3jayg.js";
-import"./index-2mx692qq.js";
-import"./index-ae5pwhgs.js";
-import"./index-1w2qaee2.js";
+import"./index-trpasv9q.js";
+import"./index-5edzv8fn.js";
+import"./index-d72hfmdm.js";
+import"./index-vk0pa0mn.js";
+import"./index-m9jj544v.js";
+import"./index-g1mbppa9.js";
+import"./index-192ha4xh.js";
 import"./index-zzvvc845.js";
-import"./index-fm46xrf1.js";
-import"./index-2etcv0sc.js";
-import"./index-e0cvze1s.js";
-import"./index-ctanya41.js";
-import"./index-c76k723e.js";
-import"./index-rwq3ekqc.js";
+import"./index-j4mkhz93.js";
+import"./index-86jt2a0e.js";
+import"./index-fmzcs8v6.js";
+import"./index-awbdfcf2.js";
+import"./index-1p98exm2.js";
+import"./index-1xj2t7cb.js";
 import {
   ContextScript
-} from "./index-8r4d7cmt.js";
+} from "./index-4mhy6qme.js";
+import"./index-665zp9rs.js";
 
 // pkgs/@akanjs/cli/context/context.command.ts
 class ContextCommand extends command("context", [ContextScript], ({ public: target }) => ({

package/context.runner-1vsjztjg.js

@@ -0,0 +1,25 @@
+// @bun
+import {
+  ContextRunner2
+} from "./index-d72hfmdm.js";
+import"./index-1xj2t7cb.js";
+import"./index-1p98exm2.js";
+import"./index-awbdfcf2.js";
+import"./index-j4mkhz93.js";
+import"./index-fmzcs8v6.js";
+import"./index-86jt2a0e.js";
+import"./index-vk0pa0mn.js";
+import"./index-g1mbppa9.js";
+import"./index-m9jj544v.js";
+import"./index-5edzv8fn.js";
+import"./index-trpasv9q.js";
+import"./index-zzvvc845.js";
+import"./index-jw1zm273.js";
+import"./index-665zp9rs.js";
+import"./index-192ha4xh.js";
+import"./index-va06nr10.js";
+import"./index-hj6w4ka1.js";
+import"./index-52w0fvh8.js";
+export {
+  ContextRunner2 as ContextRunner
+};

package/{dependencyScanner-06z2dmrr.js → dependencyScanner-3afj2vt1.js}

@@ -1,7 +1,7 @@
 // @bun
 import {
   TypeScriptDependencyScanner2
-} from "./index-2ahj896a.js";
+} from "./index-tvehn2sp.js";
 import"./index-52w0fvh8.js";
 export {
   TypeScriptDependencyScanner2 as TypeScriptDependencyScanner

package/{guideline.command-dtczrqpf.js → guideline.command-cv5bmrx2.js}

@@ -2,9 +2,9 @@
 import {
   script,
   command
-} from "./index-6jjtnhkw.js";
+} from "./index-jw1zm273.js";
 import"./index-52w0fvh8.js";
-import"./index-55mynnqs.js";
+import"./index-va06nr10.js";
 import {
   Prompter2
 } from "./index-zzvvc845.js";

package/guidelines/agentRule/agentRule.instruction.md

@@ -751,9 +751,9 @@ pages declaring one name never clash, and a registry kept outside the surface re
   that matter light up with no code. An inline arrow publishes no tool, carries no annotation, and therefore
   draws nothing: one wrapper silently costs three things at once.
 - **For a control the framework did not render, spread `agentAttrs`** from `akanjs/ui`:
-  `<button {...agentAttrs(run)} onClick={run}>`, where `run` is what `st.tool(…).exec(…)` returned. It reads the
-  name off the callable, so there is nothing to keep in sync and no `ref` to thread — and it earns the same E2E
-  selector and accessibility name an `akanjs/ui` control has. Never hand-write `data-akan-*`.
+  `<button type="button" {...agentAttrs(run)} onClick={run}>`, where `run` is what `st.tool(…).exec(…)` returned.
+  It reads the name off the callable, so there is nothing to keep in sync and no `ref` to thread — and it earns the
+  same E2E selector and accessibility name an `akanjs/ui` control has. Never hand-write `data-akan-*`.
 - **A control that shares its handler with its siblings takes a key**: `agentAttrs(switchTab, menu)`, in the same
   vocabulary the call's argument uses. One tool serves a whole tab strip or a whole list, so without it every
   namesake is interchangeable in the DOM and the page can say *what* the agent did but never *where* — which the