@akanjs/cli 3.0.2 → 3.1.0-rc.1

package/cloud.command-yj6xb2a7.js

@@ -0,0 +1,192 @@
+// @bun
+import {
+  App,
+  Workspace,
+  command
+} from "./index-6jjtnhkw.js";
+import"./index-52w0fvh8.js";
+import"./index-55mynnqs.js";
+import"./index-1w2qaee2.js";
+import"./index-pgj2rt78.js";
+import {
+  PlatformTestRun
+} from "./index-8ggztp8k.js";
+import"./index-k9rrten6.js";
+import"./index-c1x0be5j.js";
+import"./index-jx4bzvwg.js";
+import"./index-7md2g9vw.js";
+import"./index-2ahj896a.js";
+import"./index-gnyf1fqy.js";
+import {
+  CloudScript2
+} from "./index-rc5rwyps.js";
+import"./index-qt22xstj.js";
+import {
+  getMobileTargetChoices
+} from "./index-q958tqqg.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) {
+    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) {
+    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, {
+    desc: "registry target for publishing Akan packages",
+    ask: "Select a registry target",
+    enum: [
+      { label: "local", value: "local" },
+      { label: "npm", value: "npm" }
+    ]
+  }).option("platforms", String, {
+    desc: "platforms to test on besides this machine, comma-separated: linux, windows (none to skip)",
+    default: "linux,windows"
+  }).with(Workspace).exec(async function(test, registry, platforms, workspace) {
+    await this.cloudScript.deployAkan(workspace, {
+      test,
+      registryUrl: resolveRegistryUrl(registry),
+      platforms: PlatformTestRun.parsePlatforms(platforms)
+    });
+  }),
+  testPlatforms: target({
+    devOnly: true,
+    desc: "Run the Akan package suites on Linux (Docker) and Windows (SSH) against a snapshot of this tree"
+  }).option("platforms", String, {
+    desc: "platforms to test on, comma-separated: linux, windows",
+    default: "linux,windows"
+  }).option("pkgs", String, {
+    flag: "k",
+    desc: "packages to test, comma-separated (default: every Akan package)",
+    nullable: true
+  }).with(Workspace).exec(async function(platforms, pkgs, workspace) {
+    await this.cloudScript.testPlatforms(workspace, {
+      platforms: PlatformTestRun.parsePlatforms(platforms),
+      pkgs: pkgs?.split(",").map((pkg) => pkg.trim()).filter(Boolean)
+    });
+  }),
+  update: target({ desc: "Update Akan.js framework to the latest version" }).with(Workspace).option("tag", String, {
+    desc: "tag of the update",
+    default: "latest",
+    enum: ["latest", "dev", "canary", "beta", "rc", "alpha"]
+  }).option("registry", String, {
+    desc: "registry target for resolving Akan packages",
+    ask: "Select a registry target",
+    enum: [
+      { label: "npm", value: "npm" },
+      { label: "local", value: "local" }
+    ],
+    default: process.env.USE_AKANJS_PKGS === "true" ? undefined : "npm"
+  }).exec(async function(workspace, tag, registry) {
+    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, {
+    flag: "d",
+    desc: "a folder `akan pack-update` wrote, uploaded instead of packing",
+    nullable: true
+  }).with(Workspace).exec(async function(app, platform, target, env, channel, notes, subspace, host, write, allowLocalRelease, pack, workspace) {
+    await this.cloudScript.pushUpdate(workspace, app, {
+      platform,
+      target,
+      env,
+      channel,
+      notes,
+      subspace,
+      host,
+      write,
+      allowLocalRelease,
+      pack
+    });
+  }),
+  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"
+  }).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) {
+    await this.cloudScript.registerBinary(workspace, app, {
+      platform,
+      distribution,
+      target,
+      env,
+      subspace,
+      host,
+      write,
+      allowLocalRelease
+    });
+  }),
+  uploadSecret: target({
+    desc: "Upload a named pipeline secret to the akasys 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) {
+    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, {
+    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) {
+    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, {
+    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) {
+    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) {
+    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) {
+    await this.cloudScript.uploadEnv(workspace, { host });
+  })
+})) {
+}
+export {
+  CloudCommand
+};

package/cloud.script-h6pvcpa2.js

@@ -0,0 +1,20 @@
+// @bun
+import {
+  CloudScript2
+} from "./index-rc5rwyps.js";
+import"./index-8ggztp8k.js";
+import"./index-jx4bzvwg.js";
+import"./index-qt22xstj.js";
+import"./index-c1x0be5j.js";
+import"./index-gnyf1fqy.js";
+import"./index-1w2qaee2.js";
+import"./index-pgj2rt78.js";
+import"./index-6jjtnhkw.js";
+import"./index-7md2g9vw.js";
+import"./index-k9rrten6.js";
+import"./index-55mynnqs.js";
+import"./index-2ahj896a.js";
+import"./index-52w0fvh8.js";
+export {
+  CloudScript2 as CloudScript
+};

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

@@ -4,9 +4,9 @@ import {
   runner,
   script,
   command
-} from "./index-q6ft9fkc.js";
+} from "./index-6jjtnhkw.js";
 import"./index-52w0fvh8.js";
-import"./index-50wb2a26.js";
+import"./index-55mynnqs.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-szbjv4gv.js"),
+      import("./CodeAgent-kyprmy06.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-szbjv4gv.js"),
-      import("./CodeTui-5nw86ab6.js")
+      import("./CodeAgent-kyprmy06.js"),
+      import("./CodeTui-21mtze3j.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-szbjv4gv.js");
+    const { CodeAgent } = await import("./CodeAgent-kyprmy06.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/commandManifest.json

@@ -1 +1 @@
-{"byCommand":{"create-workspace":"workspace","generate-agent-rules":"workspace","lint":"workspace","lint-all":"workspace","sync-all":"workspace","init":"workspace","agent":"agent","code":"code","create-application":"application","remove-application":"application","plan-slice":"application","sync":"application","script":"application","console":"application","logs":"application","build":"application","b":"application","typecheck":"application","t":"application","test":"application","build-ios":"application","bi":"application","build-android":"application","ba":"application","build-desktop":"application","bd":"application","start":"application","s":"application","start-ios":"application","si":"application","start-android":"application","sa":"application","start-desktop":"application","sd":"application","release-ios":"application","release-android":"application","pack-update":"application","update-keygen":"application","publish-update":"application","dbup":"application","db-export":"application","db-import":"application","dbdown":"application","create-library":"library","remove-library":"library","sync-library":"library","library-status":"library","install-library":"library","start-registry":"localRegistry","reset-registry":"localRegistry","smoke-registry":"localRegistry","version":"package","create-package":"package","remove-package":"package","sync-package":"package","build-package":"package","verify-dist-package":"package","verify-akan-publish-packages":"package","create-module":"module","remove-module":"module","create-service":"module","create-view":"module","create-unit":"module","create-template":"module","create-crud-page":"page","context":"context","doctor":"context","mcp-install":"context","mcp":"context","mcp-call":"context","login":"cloud","logout":"cloud","deploy-akan":"cloud","test-platforms":"cloud","update":"cloud","download-env":"cloud","upload-env":"cloud","subspace":"subspace","guideline":"guideline","create-scalar":"scalar","remove-scalar":"scalar","create-ui":"primitive","add-field":"primitive","add-enum-field":"primitive","quality":"quality","repair":"repair","workflow":"workflow","tunnel":"tunnel"}}
+{"byCommand":{"create-workspace":"workspace","generate-agent-rules":"workspace","lint":"workspace","lint-all":"workspace","machine-keygen":"workspace","sync-all":"workspace","init":"workspace","agent":"agent","code":"code","create-application":"application","remove-application":"application","plan-slice":"application","sync":"application","script":"application","console":"application","logs":"application","build":"application","b":"application","typecheck":"application","t":"application","test":"application","build-ios":"application","bi":"application","build-android":"application","ba":"application","build-desktop":"application","bd":"application","start":"application","s":"application","start-ios":"application","si":"application","start-android":"application","sa":"application","start-desktop":"application","sd":"application","release-ios":"application","release-android":"application","pack-update":"application","update-keygen":"application","publish-update":"application","dbup":"application","db-export":"application","db-import":"application","dbdown":"application","create-library":"library","remove-library":"library","sync-library":"library","library-status":"library","install-library":"library","start-registry":"localRegistry","reset-registry":"localRegistry","smoke-registry":"localRegistry","version":"package","create-package":"package","remove-package":"package","sync-package":"package","build-package":"package","verify-dist-package":"package","verify-akan-publish-packages":"package","create-module":"module","remove-module":"module","create-service":"module","create-view":"module","create-unit":"module","create-template":"module","create-crud-page":"page","context":"context","doctor":"context","mcp-install":"context","mcp":"context","mcp-call":"context","login":"cloud","logout":"cloud","deploy-akan":"cloud","test-platforms":"cloud","update":"cloud","push-update":"cloud","register-binary":"cloud","upload-secret":"cloud","list-secrets":"cloud","remove-secret":"cloud","download-env":"cloud","upload-env":"cloud","subspace":"subspace","guideline":"guideline","create-scalar":"scalar","remove-scalar":"scalar","create-ui":"primitive","add-field":"primitive","add-enum-field":"primitive","quality":"quality","repair":"repair","workflow":"workflow","pipeline":"pipeline","tunnel":"tunnel"}}

package/{context.command-6aqvdx43.js → context.command-9jjn3gcw.js}

@@ -2,24 +2,24 @@
 import {
   Workspace,
   command
-} from "./index-q6ft9fkc.js";
+} from "./index-6jjtnhkw.js";
 import"./index-52w0fvh8.js";
-import"./index-50wb2a26.js";
+import"./index-55mynnqs.js";
 import"./index-hj6w4ka1.js";
-import"./index-h9ht6s60.js";
-import"./index-zyw622y1.js";
-import"./index-j38qkvkk.js";
-import"./index-jk9xnck6.js";
+import"./index-05g3jayg.js";
+import"./index-2mx692qq.js";
+import"./index-ae5pwhgs.js";
+import"./index-1w2qaee2.js";
 import"./index-zzvvc845.js";
-import"./index-hp3stk1m.js";
-import"./index-g38nhv87.js";
-import"./index-f4e08ptp.js";
-import"./index-6keyf4sg.js";
-import"./index-cb6yc5mb.js";
-import"./index-bsv901fd.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 {
   ContextScript
-} from "./index-zwd84m0w.js";
+} from "./index-8r4d7cmt.js";
 
 // pkgs/@akanjs/cli/context/context.command.ts
 class ContextCommand extends command("context", [ContextScript], ({ public: target }) => ({

package/context.runner-atcrzz5b.js

@@ -0,0 +1,21 @@
+// @bun
+import {
+  ContextRunner2
+} from "./index-ae5pwhgs.js";
+import"./index-rwq3ekqc.js";
+import"./index-c76k723e.js";
+import"./index-ctanya41.js";
+import"./index-fm46xrf1.js";
+import"./index-e0cvze1s.js";
+import"./index-2etcv0sc.js";
+import"./index-1w2qaee2.js";
+import"./index-2mx692qq.js";
+import"./index-05g3jayg.js";
+import"./index-zzvvc845.js";
+import"./index-6jjtnhkw.js";
+import"./index-55mynnqs.js";
+import"./index-hj6w4ka1.js";
+import"./index-52w0fvh8.js";
+export {
+  ContextRunner2 as ContextRunner
+};

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

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

package/guidelines/agentRule/agentRule.instruction.md

@@ -47,7 +47,9 @@ pages declaring one name never clash, and a registry kept outside the surface re
   `AgentProvider` or an `Agent.Zone` belongs to whoever provided it.
 - **The panel is customized in three widening steps, and most designs stop at the first.** Props first:
   `open` / `onOpenChange` drive it from the app's own control (`launcher={false}` then draws no launcher of its
-  own), `launcherClassName` / `panelClassName` reach one surface each where `className` reaches both, `intro`
+  own), `launcherPlacement` / `hideLauncherBelow` place the launcher — which sits above the page's bottom chrome
+  and under every menu and modal — `launcherClassName` / `panelClassName` reach one surface each where
+  `className` reaches both, `intro`
   replaces the empty-state line — where starter questions go — and `header` adds controls beside the built-in
   clear and close. `chrome={false}` drops the header bar whole, for an `inline` chat inside a panel the app
   already titles, and `defaultDraft` opens the composer with text in it without sending it. A panel driven by a
@@ -306,7 +308,9 @@ pages declaring one name never clash, and a registry kept outside the surface re
   an inline arrow can be clicked by a person and by nobody else. `.desc()` is required and comes first, `.arg()`
   is an argument the caller must pass and `.opt()` one it may leave out (the `exec` parameter is then `| null`),
   and `.exec()` is the only hook, so the chain completes in one unconditional statement and the callable carries
-  `data-akan-action` like a store setter does. A `remove*` name defaults to a confirm gate. Reach a store action
+  `data-akan-action` like a store setter does. A `remove*` name defaults to a confirm gate. `st.tool("x", { label:
+  l("ticket.archive") })` gives the action a name a person reads — `Agent.useScreenActions()` hands it to a command
+  palette, and the model never sees it. Reach a store action
   from the body — `.exec((id) => st.do.removeX(id))` — which is how an agent gets CRUD; `st.do` on its own
   reaches nobody.
 - **`.card()` is the other way the chain ends, for an answer that is the user's to give.** Where `.exec()` runs a
@@ -357,6 +361,10 @@ pages declaring one name never clash, and a registry kept outside the surface re
   (a different `modal`, a different redirect) cannot honestly share a description, and that pair wants a
   `namespace` or nothing at all. The ids come from the `<slice>.items` resource `Load.Units` and
   `Data.ListContainer` already expose.
+- **A command palette lists the same declarations.** `Agent.useScreenActions()` returns the screen's published
+  tools that take no required argument, each with a `run` that calls the control's own handler (guard included,
+  not logged as an agent call) and `needsConfirm` for the ones a person should confirm — so ⌘K offers exactly
+  what the agent can do here, with nothing declared twice.
 
 ## What `akanjs/ui` Publishes For You
 - **`akanjs/ui` publishes its own controls, so an app writes nothing for them.** `Data.ListContainer` (and every