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

package/{index-gnyf1fqy.js → index-j237xtew.js}

@@ -2,16 +2,16 @@
 import {
   runner,
   script
-} from "./index-6jjtnhkw.js";
+} from "./index-jw1zm273.js";
 import {
   FileSys2
 } from "./index-52w0fvh8.js";
 import {
   PkgExecutor
-} from "./index-55mynnqs.js";
+} from "./index-va06nr10.js";
 import {
   TypeScriptDependencyScanner2
-} from "./index-2ahj896a.js";
+} from "./index-tvehn2sp.js";
 
 // pkgs/@akanjs/cli/package/package.runner.ts
 import path2 from "path";
@@ -159,10 +159,10 @@ class PackageRunner extends runner("package") {
     const packageRuntimeDependencies = {
       "@akanjs/devkit": [
         "tailwind-scrollbar",
-        "@earendil-works/chord",
         "@earendil-works/pi-agent-core",
         "@earendil-works/pi-ai",
-        "@earendil-works/pi-telemetry",
+        "@earendil-works/pi-codemode",
+        "@earendil-works/pi-mcp",
         "@earendil-works/pi-tui"
       ]
     };
@@ -273,7 +273,7 @@ class PackageRunner extends runner("package") {
     if (!failures.length)
       return;
     throw new Error(`[package] ${pkg.name} dist imports ${failures.length} subpath(s) no consumer can resolve:
-` + `${failures.sort().join(`
+` + `${failures.sort((a, b) => a < b ? -1 : a > b ? 1 : 0).join(`
 `)}
 ` + `Add the missing "exports" entries: a bare file facet needs "./*": "./*.ts", a directory facet ` + `needs its own "./name": "./name/index.ts", and "./*.ts": "./*.ts" keeps an already-suffixed ` + `specifier from gaining a second extension.`);
   }

package/{index-fm46xrf1.js → index-j4mkhz93.js}

@@ -5,13 +5,13 @@ import {
   writeGeneratedSyncState,
   createRepairReport,
   renderRepairReport
-} from "./index-05g3jayg.js";
+} from "./index-trpasv9q.js";
 import {
   AkanContextAnalyzer
-} from "./index-2mx692qq.js";
+} from "./index-5edzv8fn.js";
 import {
   runner
-} from "./index-6jjtnhkw.js";
+} from "./index-jw1zm273.js";
 
 // pkgs/@akanjs/cli/repair/repair.runner.ts
 var spawnShell = async (workspace, command) => await workspace.spawn("bash", ["-lc", command.startsWith("akan ") ? `bun run ${command}` : command], {

package/{index-6jjtnhkw.js → index-jw1zm273.js}

@@ -10,7 +10,7 @@ import {
   LibExecutor,
   PkgExecutor,
   ModuleExecutor
-} from "./index-55mynnqs.js";
+} from "./index-va06nr10.js";
 
 // pkgs/@akanjs/devkit/commandDecorators/camelToKebabCase.ts
 var camelToKebabCase = (str) => str.replace(/([A-Z])/g, "-$1").toLowerCase();
@@ -40,7 +40,7 @@ var getArgMetas = (command, key) => {
   const internalArgMetas = allArgMetas.filter((argMeta) => argMeta.type !== "Option");
   return [allArgMetas, argMetas, internalArgMetas];
 };
-var createInternalArgToken = (type) => ({ type });
+var createInternalArgToken = (type, option) => option ? { type, option } : { type };
 var normalizePrimitiveArgType = (type) => {
   if (type === String)
     return "string";
@@ -54,10 +54,34 @@ var App = createInternalArgToken("App");
 var Apps = createInternalArgToken("Apps");
 var Lib = createInternalArgToken("Lib");
 var Sys = createInternalArgToken("Sys");
+var SysOrOnlyApp = createInternalArgToken("Sys", { onlyApp: true });
 var Exec = createInternalArgToken("Exec");
 var Pkg = createInternalArgToken("Pkg");
 var Module = createInternalArgToken("Module");
 var Workspace = createInternalArgToken("Workspace");
+// pkgs/@akanjs/devkit/commandDecorators/command.ts
+import path2 from "path";
+import { Logger } from "akanjs/common";
+import chalk2 from "chalk";
+import { program } from "commander";
+
+// pkgs/@akanjs/devkit/appSelectionMemory.ts
+import path from "path";
+class AppSelectionMemory {
+  static pathIn(workspaceRoot) {
+    return path.join(workspaceRoot, "local", ".akan", "lastStart.json");
+  }
+  static async read(workspaceRoot) {
+    const stored = await Bun.file(AppSelectionMemory.pathIn(workspaceRoot)).json().catch(() => null);
+    const apps = stored?.apps;
+    return Array.isArray(apps) ? apps.filter((name) => typeof name === "string") : [];
+  }
+  static async write(workspaceRoot, apps) {
+    await FileSys2.writeJson(AppSelectionMemory.pathIn(workspaceRoot), { apps }).catch(() => {
+      return;
+    });
+  }
+}
 
 // pkgs/@akanjs/devkit/commandDecorators/dependencyBuilder.ts
 var capitalize = (value) => value.slice(0, 1).toUpperCase() + value.slice(1);
@@ -136,27 +160,16 @@ var script = (refName, deps = []) => {
   return ScriptBase;
 };
 
-// pkgs/@akanjs/devkit/commandDecorators/command.ts
-import path2 from "path";
-import { Logger } from "akanjs/common";
-import chalk2 from "chalk";
-import { program } from "commander";
-
-// pkgs/@akanjs/devkit/appSelectionMemory.ts
-import path from "path";
-class AppSelectionMemory {
-  static pathIn(workspaceRoot) {
-    return path.join(workspaceRoot, "local", ".akan", "lastStart.json");
+// pkgs/@akanjs/devkit/commandDecorators/exitCodeError.ts
+class ExitCodeError extends Error {
+  exitCode;
+  name = "ExitCodeError";
+  constructor(message, exitCode) {
+    super(message);
+    this.exitCode = exitCode;
   }
-  static async read(workspaceRoot) {
-    const stored = await Bun.file(AppSelectionMemory.pathIn(workspaceRoot)).json().catch(() => null);
-    const apps = stored?.apps;
-    return Array.isArray(apps) ? apps.filter((name) => typeof name === "string") : [];
-  }
-  static async write(workspaceRoot, apps) {
-    await FileSys2.writeJson(AppSelectionMemory.pathIn(workspaceRoot), { apps }).catch(() => {
-      return;
-    });
+  static codeOf(error) {
+    return error instanceof ExitCodeError ? error.exitCode : null;
   }
 }
 
@@ -352,6 +365,7 @@ var select = (config, context) => prompts().then((m) => m.select(config, context
 var confirm = (config, context) => prompts().then((m) => m.confirm(config, context));
 var input = (config, context) => prompts().then((m) => m.input(config, context));
 var checkbox = (config, context) => prompts().then((m) => m.checkbox(config, context));
+var argLabelOf = (argMeta) => argMeta.type === "Option" ? `option '--${camelToKebabCase(argMeta.name)}'` : `argument '${argMeta.name}'`;
 var assertEnumChoice = (argMeta, value) => {
   const enumChoices = argMeta.argsOption.enum;
   if (!enumChoices || typeof enumChoices === "function")
@@ -359,8 +373,12 @@ var assertEnumChoice = (argMeta, value) => {
   const choices = normalizeEnumChoices(enumChoices);
   if (choices.some((choice) => String(choice.value) === String(value)))
     return;
-  const label = argMeta.type === "Option" ? `option '--${camelToKebabCase(argMeta.name)}'` : `argument '${argMeta.name}'`;
-  throw new Error(`${label} argument '${String(value)}' is invalid. Allowed choices are ${choices.map((choice) => choice.name).join(", ")}.`);
+  throw new Error(`${argLabelOf(argMeta)} argument '${String(value)}' is invalid. Allowed choices are ${choices.map((choice) => choice.name).join(", ")}.`);
+};
+var assertPromptable = (problem, { choices = [], remedy = "pass it on the command line" } = {}) => {
+  if (process.stdin.isTTY)
+    return;
+  throw new Error(`${problem}: stdin is not a terminal to prompt on, so ${remedy}${choices.length ? ` (choices: ${choices.join(", ")})` : ""}.`);
 };
 var inputMessageOf = ({ name, argsOption: { desc, example, ask } }) => ask ? `${ask}: ` : desc ? `${desc}: ` : `Enter the ${name} value${example ? ` (example: ${example})` : ""}: `;
 var getOptionValue = async (argMeta, opt, context) => {
@@ -379,8 +397,11 @@ var getOptionValue = async (argMeta, opt, context) => {
     const choices = normalizeEnumChoices((typeof enumChoices === "function" ? await enumChoices(context) : enumChoices) ?? []);
     if (choices.length === 1)
       return choices[0]?.value;
+    assertPromptable(`Missing ${argLabelOf(argMeta)}`, { choices: choices.map((choice) => choice.value) });
     return await select({ message: ask ?? desc ?? `Select the ${name} value`, choices });
-  } else if (type === "boolean") {
+  }
+  assertPromptable(`Missing ${argLabelOf(argMeta)}`);
+  if (type === "boolean") {
     const message = ask ?? desc ?? `Do you want to set ${name}? ${desc ? ` (${desc})` : ""}: `;
     return await confirm({ message });
   } else
@@ -395,6 +416,10 @@ var getArgumentValue = async (argMeta, value) => {
     return defaultValue;
   else if (nullable)
     return null;
+  const { enum: enumChoices } = argMeta.argsOption;
+  assertPromptable(`Missing ${argLabelOf(argMeta)}`, {
+    choices: enumChoices && typeof enumChoices !== "function" ? normalizeEnumChoices(enumChoices).map(({ value }) => value) : []
+  });
   return convertArgValue(await input({ message: inputMessageOf(argMeta) }), type ?? "string");
 };
 var assignCommandContext = (context, argMeta, value) => {
@@ -415,17 +440,17 @@ var assignCommandContext = (context, argMeta, value) => {
 };
 var assertCurrentDirectoryIsWorkspaceRoot = async () => {
   const cwd = process.cwd();
-  const [hasPackageJson, hasTsConfig, hasEnv] = await Promise.all([
+  const [hasPackageJson, hasTsConfig, ...hasMemberDirs] = await Promise.all([
     FileSys2.fileExists(`${cwd}/package.json`),
     FileSys2.fileExists(`${cwd}/tsconfig.json`),
-    FileSys2.fileExists(`${cwd}/.env`)
+    ...["apps", "libs", "pkgs"].map((dir) => FileSys2.dirExists(`${cwd}/${dir}`))
   ]);
-  if (hasPackageJson && hasTsConfig && hasEnv)
+  if (hasPackageJson && hasTsConfig && hasMemberDirs.some(Boolean))
     return;
   throw new Error([
     "Akan CLI commands must be run from the workspace root.",
     `Current directory: ${cwd}`,
-    "Move to the directory that contains package.json, tsconfig.json, and .env, then run the command again."
+    "Move to the directory that contains package.json, tsconfig.json, and an apps/, libs/ or pkgs/ folder, then run the command again."
   ].join(`
 `));
 };
@@ -445,6 +470,7 @@ var getAppsArgumentValue = async (value, workspace) => {
   }
   if (appNames.length === 1 && appNames[0])
     return [AppExecutor.from(workspace, appNames[0])];
+  assertPromptable("Missing apps", { choices: [...appNames, "all"] });
   const remembered = new Set(await AppSelectionMemory.read(workspace.workspaceRoot));
   const picked = await checkbox({
     message: "Select the apps to run (space to toggle, enter to confirm)",
@@ -459,6 +485,7 @@ var getInternalArgumentValue = async (argMeta, value, workspace) => {
     return workspace;
   const sysType = argMeta.type.toLowerCase();
   const [appNames, libNames, pkgNames] = await workspace.getExecs();
+  const problemOf = (kind) => value ? `Unknown ${kind} '${value}'` : `Missing ${kind}`;
   if (sysType === "sys" || sysType === "exec") {
     const pkgChoices = sysType === "exec" ? pkgNames : [];
     const execOf = (name) => {
@@ -473,6 +500,11 @@ var getInternalArgumentValue = async (argMeta, value, workspace) => {
     const found = value ? execOf(value) : null;
     if (found)
       return found;
+    if (!value && argMeta.option?.onlyApp && appNames.length === 1 && appNames[0])
+      return AppExecutor.from(workspace, appNames[0]);
+    assertPromptable(problemOf(sysType === "exec" ? "app, lib or pkg" : "app or lib"), {
+      choices: [...appNames, ...libNames, ...pkgChoices]
+    });
     const name = await select({
       message: sysType === "exec" ? `Select the App or Lib or Pkg name` : `Select the App or Lib name`,
       choices: [...appNames, ...libNames, ...pkgChoices]
@@ -486,17 +518,20 @@ var getInternalArgumentValue = async (argMeta, value, workspace) => {
       return AppExecutor.from(workspace, value);
     if (!value && appNames.length === 1 && appNames[0])
       return AppExecutor.from(workspace, appNames[0]);
+    assertPromptable(problemOf("app"), { choices: appNames });
     const appName = await select({ message: `Select the ${sysType} name`, choices: appNames });
     return AppExecutor.from(workspace, appName);
   } else if (sysType === "lib") {
     if (value && libNames.includes(value))
       return LibExecutor.from(workspace, value);
+    assertPromptable(problemOf("lib"), { choices: libNames });
     const libName = await select({ message: `Select the ${sysType} name`, choices: libNames });
     return LibExecutor.from(workspace, libName);
   } else if (sysType === "pkg") {
     const pkgs = await workspace.getPkgs();
     if (value && pkgs.includes(value))
       return PkgExecutor.from(workspace, value);
+    assertPromptable(problemOf("pkg"), { choices: pkgs });
     const pkgName = await select({ message: `Select the ${sysType} name`, choices: pkgs });
     return PkgExecutor.from(workspace, pkgName);
   } else if (sysType === "module") {
@@ -519,6 +554,7 @@ var getInternalArgumentValue = async (argMeta, value, workspace) => {
       } else
         throw new Error(`Invalid system name: ${sysName}`);
     }
+    assertPromptable(problemOf("module"));
     const { type, name } = await select({
       message: `select the App or Lib name`,
       choices: [
@@ -540,7 +576,7 @@ var runCommands = async (...commands) => {
   let failureExitCode = 1;
   process.on("unhandledRejection", (error) => {
     printCliError(error);
-    process.exit(failureExitCode);
+    process.exit(ExitCodeError.codeOf(error) ?? failureExitCode);
   });
   const __dirname2 = getDirname2(import.meta.url);
   const packageJsonCandidates = [`${path2.dirname(Bun.main)}/package.json`, `${__dirname2}/../package.json`];
@@ -647,10 +683,9 @@ It may cause unexpected behavior. Run \`akan update\` to update latest akanjs.`)
   }
   await program.parseAsync(process.argv).catch((error) => {
     printCliError(error);
-    process.exit(failureExitCode);
+    process.exit(ExitCodeError.codeOf(error) ?? failureExitCode);
   });
 };
-
 // pkgs/@akanjs/devkit/commandDecorators/commandBuilder.ts
 var argMetaOf = (type, name, primitive, argsOption, idx) => ({ name, argsOption: { ...argsOption, type: normalizePrimitiveArgType(primitive) }, key: "", idx, type });
 
@@ -671,7 +706,12 @@ class TargetBuilder {
     return this.#add(argMetaOf("Option", name, type, argsOption, this.#args.length));
   }
   with(...tokens) {
-    return this.#add(...tokens.map((token, offset) => ({ key: "", idx: this.#args.length + offset, type: token.type })));
+    return this.#add(...tokens.map((token, offset) => ({
+      key: "",
+      idx: this.#args.length + offset,
+      type: token.type,
+      ...token.option ? { option: token.option } : {}
+    })));
   }
   exec(handler) {
     return {
@@ -718,4 +758,4 @@ function command(refName, depsOrBuilder, builder) {
   }
   return CommandBase;
 }
-export { getTargetMetas, getTargetCommandNames, App, Apps, Lib, Sys, Exec, Pkg, Module, Workspace, CommandContainer, runner, script, runCommands, command };
+export { getTargetMetas, getTargetCommandNames, App, Apps, Lib, Sys, SysOrOnlyApp, Exec, Pkg, Module, Workspace, CommandContainer, runner, script, ExitCodeError, assertPromptable, runCommands, command };

package/{index-q958tqqg.js → index-m9jj544v.js}

@@ -1,6 +1,6 @@
 // @bun
 // pkgs/@akanjs/devkit/mobile/mobileTarget.ts
-var trimSlashes = (value) => value.replace(/^\/+|\/+$/g, "");
+import { trimSlashes } from "akanjs/common";
 var getMobileTargets = async (app) => {
   const config = await app.getConfig();
   return Object.entries(config.native.targets).map(([name, target]) => ({ name, config: target }));

package/index-mdjc93e1.js

@@ -0,0 +1,33 @@
+// @bun
+import {
+  getMobileTargetChoices
+} from "./index-m9jj544v.js";
+
+// pkgs/@akanjs/cli/application/commandOptions.ts
+var targetChoices = async ({ app }) => await getMobileTargetChoices(app);
+var writeOption = { desc: "write code generation", default: true };
+var nativeTargetOption = {
+  desc: "native target name (a key of native.targets) or all",
+  ask: "Select native target",
+  enum: targetChoices
+};
+var oneNativeTargetOption = {
+  desc: "native target name (a key of native.targets)",
+  ask: "Select native target",
+  enum: targetChoices
+};
+var nativeEnvs = ["debug", "develop", "main", "local"];
+var releaseEnvOption = { enum: nativeEnvs, desc: "backend environment", default: "main" };
+var allowLocalOption = (what) => ({ flag: "l", desc: `allow ${what} with --env local`, default: false });
+var publicEnvOption = (what) => ({
+  flag: "u",
+  desc: `the AKAN_PUBLIC_* ${what} inlines, exactly: a JSON map of them, or a store build's bundle.json that recorded them`,
+  nullable: true
+});
+var hostOption = {
+  desc: "host of the cloud to target (default: cloud.host of the root akan.config.ts, else Akan Cloud)",
+  nullable: true
+};
+var subspaceOption = (whose) => ({ desc: `the subspace whose project ${whose}`, nullable: true });
+
+export { writeOption, nativeTargetOption, oneNativeTargetOption, nativeEnvs, releaseEnvOption, allowLocalOption, publicEnvOption, hostOption, subspaceOption };

package/{index-c1x0be5j.js → index-pydbnfez.js}

@@ -2,12 +2,12 @@
 import {
   runner,
   script
-} from "./index-6jjtnhkw.js";
+} from "./index-jw1zm273.js";
 import {
   LibSource,
   formatLibStatuses,
   LibExecutor
-} from "./index-55mynnqs.js";
+} from "./index-va06nr10.js";
 
 // pkgs/@akanjs/cli/library/library.script.ts
 import { Logger } from "akanjs/common";

package/{index-56d2g8ms.js → index-qwa5k1j8.js}

@@ -2,7 +2,7 @@
 import {
   GlobalConfig,
   CloudApi
-} from "./index-pgj2rt78.js";
+} from "./index-cpb3nvma.js";
 
 // pkgs/@akanjs/cli/tunnel/TunnelShare.ts
 import { TunnelAgent } from "akanjs/server/tunnel";

package/{index-v29746vb.js → index-tamvyvj3.js}

@@ -2,7 +2,7 @@
 import {
   runner,
   script
-} from "./index-6jjtnhkw.js";
+} from "./index-jw1zm273.js";
 import {
   AGENT_BLOCK_START,
   AGENT_BLOCK_END,
@@ -13,14 +13,14 @@ import {
   CLAUDE_COMMENT_RULE,
   AppExecutor,
   LibExecutor
-} from "./index-55mynnqs.js";
+} from "./index-va06nr10.js";
 import {
   collectRecipeSources2,
   scanRecipes2
 } from "./index-hj6w4ka1.js";
 import {
   AkanContextAnalyzer
-} from "./index-2mx692qq.js";
+} from "./index-5edzv8fn.js";
 import {
   Prompter2
 } from "./index-zzvvc845.js";