@akanjs/cli 3.0.2 → 3.1.0-rc.0

package/{primitive.command-r4kq75qj.js → primitive.command-dyrs2fm8.js}

@@ -2,17 +2,17 @@
 import {
   Workspace,
   command
-} from "./index-q6ft9fkc.js";
+} from "./index-6jjtnhkw.js";
 import"./index-52w0fvh8.js";
-import"./index-50wb2a26.js";
+import"./index-55mynnqs.js";
 import {
   renderPrimitiveReport
-} from "./index-h9ht6s60.js";
-import"./index-g38nhv87.js";
-import"./index-f4e08ptp.js";
+} from "./index-05g3jayg.js";
+import"./index-2etcv0sc.js";
+import"./index-e0cvze1s.js";
 import {
   PrimitiveScript
-} from "./index-6keyf4sg.js";
+} from "./index-ctanya41.js";
 
 // pkgs/@akanjs/cli/primitive/primitive.command.ts
 import { Logger } from "akanjs/common";

package/projectTypecheck-cvtkrzp2.js

@@ -0,0 +1,7 @@
+// @bun
+import {
+  ProjectTypecheck2
+} from "./index-6w0rbr9d.js";
+export {
+  ProjectTypecheck2 as ProjectTypecheck
+};

package/{quality.command-f7gzh26z.js → quality.command-6emsqpbg.js}

@@ -3,15 +3,16 @@ import {
   Workspace,
   script,
   command
-} from "./index-q6ft9fkc.js";
+} from "./index-6jjtnhkw.js";
 import"./index-52w0fvh8.js";
 import {
   rootAllowedFiles,
   rootAllowedDirs,
   isAllowedLibFacetRootFile,
+  libFacetRootHintOf,
   facetIndexShadowOf,
   rootEntryHintOf
-} from "./index-50wb2a26.js";
+} from "./index-55mynnqs.js";
 
 // pkgs/@akanjs/devkit/qualityScanner.ts
 import { createHash } from "crypto";
@@ -505,7 +506,7 @@ var RULE_FIXES = {
   "akan.layout.app-root-folder": "Move the folder's contents into a conventional app folder (common, env, lib, page, private, public, script, srvkit, ui, or webkit) and delete it.",
   "akan.layout.lib-root-file": "Move the file into a conventional lib folder (common, env, lib, page, private, public, srvkit, ui, or webkit).",
   "akan.layout.lib-root-folder": "Move the folder's contents into a conventional lib folder (common, env, lib, page, private, public, srvkit, ui, or webkit) and delete it.",
-  "akan.layout.lib-facet-file": "Move the file into a domain module folder under lib/; keep the lib facet root limited to generated support facets.",
+  "akan.layout.lib-facet-file": "Move the file into a domain module folder under lib/ (a test beside the file it covers, or into srvkit/ when it drives several modules); keep the lib facet root limited to generated support facets.",
   "akan.layout.facet-index-shadow": "Delete the hand-written index file and run akan sync; move a namespace it builds into <facet>/<Folder>/index.tsx.",
   "akan.layout.module-ui-file": "Rename the file to an allowed module UI name, or move it to ui/ if it is not a module component.",
   "akan.ssr.unnecessary-use-client": 'Delete the "use client" directive so the file renders on the server. If it exists only to wrap one client child, drop the wrapper and use the child directly.',
@@ -708,7 +709,7 @@ class AkanQualityScanner {
       warnings.push(fileWarning("akan.layout.facet-index-shadow", "layout", sourceFile.file, `${path2.basename(sourceFile.file)} ${facetShadow}.`));
     const libFacetFile = getLibFacetRootFile(sourceFile.file);
     if (libFacetFile && !isAllowedLibFacetRootFile(libFacetFile))
-      warnings.push(fileWarning("akan.layout.lib-facet-file", "layout", sourceFile.file, `Unexpected lib facet root file "${libFacetFile}". Keep direct lib/ root files limited to generated support facets.`));
+      warnings.push(fileWarning("akan.layout.lib-facet-file", "layout", sourceFile.file, `Unexpected lib facet root file "${libFacetFile}". ${libFacetRootHintOf(libFacetFile) ?? "Keep direct lib/ root files limited to generated support facets."}`));
     const moduleUiWarning = getModuleUiWarning(sourceFile.file);
     if (moduleUiWarning)
       warnings.push(moduleUiWarning);

package/{repair.command-0qmyr6qa.js → repair.command-8t6aegv5.js}

@@ -3,15 +3,15 @@ import {
   Workspace,
   script,
   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-05g3jayg.js";
+import"./index-2mx692qq.js";
 import {
   RepairRunner
-} from "./index-hp3stk1m.js";
+} from "./index-fm46xrf1.js";
 
 // pkgs/@akanjs/cli/repair/repair.script.ts
 import { Logger } from "akanjs/common";

package/{scalar.command-kddn7av4.js → scalar.command-bnggy1x7.js}

@@ -2,15 +2,15 @@
 import {
   Sys,
   command
-} from "./index-q6ft9fkc.js";
+} from "./index-6jjtnhkw.js";
 import"./index-52w0fvh8.js";
-import"./index-50wb2a26.js";
+import"./index-55mynnqs.js";
 import {
   renderPrimitiveReport
-} from "./index-h9ht6s60.js";
+} from "./index-05g3jayg.js";
 import {
   ScalarScript
-} from "./index-cb6yc5mb.js";
+} from "./index-c76k723e.js";
 
 // pkgs/@akanjs/cli/scalar/scalar.command.ts
 import { Logger, lowerlize } from "akanjs/common";

package/{subspace.command-ft65qvc4.js → subspace.command-f02j5tge.js}

@@ -1,37 +1,42 @@
 // @bun
-import {
-  FileSys2
-} from "./index-52w0fvh8.js";
-import {
-  GlobalConfig
-} from "./index-94s080qm.js";
 import {
   Workspace,
   CommandContainer,
   runner,
   script,
   command
-} from "./index-q6ft9fkc.js";
+} from "./index-6jjtnhkw.js";
+import {
+  FileSys2
+} from "./index-52w0fvh8.js";
 import {
   LibSource,
   Executor,
   WorkspaceExecutor,
   AppExecutor
-} from "./index-50wb2a26.js";
+} from "./index-55mynnqs.js";
+import {
+  GlobalConfig
+} from "./index-r2tpeb3n.js";
+import {
+  SubspaceConfig
+} from "./index-ww9bhp67.js";
 import {
   SlicePlanner
-} from "./index-50jjwg8y.js";
+} from "./index-qt22xstj.js";
 
 // pkgs/@akanjs/devkit/subspace.ts
 import { mkdir, readdir, rename, rm } from "fs/promises";
 import path from "path";
 class Subspace {
   static anchorFile = "akan.subspace.json";
-  static workspaceOnlyEntries = ["akan.subspace.ts"];
+  static subspaceOwnedRootEntries = ["akan.config.ts", "Jenkinsfile"];
+  static syncSubjectPrefix = "chore(subspace): sync from ";
   static memberDirs = ["apps", "libs"];
   static subspaceOwnedDirs = ["env"];
   static secretsMarkers = ["# akan:secrets (managed by akan.config.ts \u2014 do not edit)", "# akan:secrets:end"];
   static holdDir = ".akan-subspace-hold";
+  static #loopbackRegistry = /https?:\/\/(?:127\.0\.0\.1|localhost|0\.0\.0\.0|\[::1\])(?::\d+)?/;
   #workspace;
   #config;
   #declaration;
@@ -58,6 +63,9 @@ class Subspace {
   async#git(args) {
     return await this.#workspace.spawn("git", args);
   }
+  async#cloneGit(args) {
+    return await this.#workspace.spawn("git", ["-C", this.#clonePath, ...args]);
+  }
   async branch() {
     return (await this.#git(["rev-parse", "--abbrev-ref", "HEAD"])).trim();
   }
@@ -97,6 +105,40 @@ class Subspace {
     const paths = [...this.#declaration.apps.map((app) => `apps/${app}`), ...libs.map((lib) => `libs/${lib}`)];
     return { plans, libs, paths };
   }
+  async plan(branch) {
+    const { plans, libs } = await this.slice();
+    const rootFiles = plans[0]?.rootFiles ?? [];
+    const present = new Set(rootFiles.map((file) => file.split("/")[0] ?? file));
+    const owned = Subspace.subspaceOwnedRootEntries;
+    const excluded = this.#config.exclude.filter((entry) => !owned.includes(entry));
+    const excludedTops = new Set(excluded.map((entry) => entry.replace(/\/+$/, "")));
+    const libFiles = new Map(plans.flatMap((plan) => Object.entries(plan.libFiles)));
+    const { pruned, warnings } = await SlicePlanner.pruneDependencies(this.#workspace, await this.#workspace.getPackageJson(), plans.flatMap((plan) => plan.requiredDependencies));
+    let branchRefusal = null;
+    try {
+      this.#config.assertPushable(branch);
+    } catch (error) {
+      branchRefusal = error instanceof Error ? error.message : String(error);
+    }
+    return {
+      name: this.name,
+      repo: this.#declaration.repo,
+      branch,
+      branchRefusal,
+      apps: [...this.#declaration.apps],
+      libs: libs.map((lib) => ({
+        name: lib,
+        apps: plans.filter((plan) => plan.libs.includes(lib)).map((plan) => plan.app)
+      })),
+      files: plans.reduce((sum, plan) => sum + plan.appFiles.length, 0) + [...libFiles.values()].reduce((sum, files) => sum + files.length, 0),
+      rootEntries: [...present].filter((entry) => !excludedTops.has(entry) && !owned.includes(entry)).sort((a, b) => a.localeCompare(b)),
+      excludedRootEntries: excluded,
+      subspaceOwnedRootEntries: owned.filter((entry) => present.has(entry)),
+      prunedDependencies: pruned,
+      lockProblem: rootFiles.includes("bun.lock") ? await this.#loopbackRegistryLock(this.#workspace.workspaceRoot) : null,
+      warnings: [...new Set([...plans.flatMap((plan) => plan.warnings), ...warnings])]
+    };
+  }
   #isSubspaceOwned(file) {
     const segments = file.split("/");
     if (!Subspace.memberDirs.includes(segments[0] ?? ""))
@@ -180,6 +222,34 @@ class Subspace {
       await Subspace.#copyMissing(to, from);
     await rm(path.join(this.#clonePath, Subspace.holdDir), { recursive: true, force: true });
   }
+  async#holdRootEntries() {
+    const holdRoot = path.join(this.#clonePath, Subspace.holdDir, "root");
+    const held = [];
+    for (const entry of Subspace.subspaceOwnedRootEntries) {
+      const from = path.join(this.#clonePath, entry);
+      if (!await FileSys2.entryExists(from))
+        continue;
+      if (await this.#isPushedCopy(entry))
+        continue;
+      await mkdir(holdRoot, { recursive: true });
+      await rename(from, path.join(holdRoot, entry));
+      held.push(entry);
+    }
+    return held;
+  }
+  async#restoreRootEntries(held) {
+    const holdRoot = path.join(this.#clonePath, Subspace.holdDir, "root");
+    for (const entry of Subspace.subspaceOwnedRootEntries) {
+      const target = path.join(this.#clonePath, entry);
+      await rm(target, { recursive: true, force: true });
+      if (held.includes(entry))
+        await rename(path.join(holdRoot, entry), target);
+    }
+  }
+  async#isPushedCopy(entry) {
+    const subject = await this.#cloneGit(["log", "-1", "--format=%s", "--", entry]).catch(() => "");
+    return subject.trim().startsWith(Subspace.syncSubjectPrefix);
+  }
   static async#copyMissing(from, to) {
     await mkdir(to, { recursive: true });
     for (const entry of await readdir(from, { withFileTypes: true })) {
@@ -255,13 +325,16 @@ class Subspace {
   async#applySlice(clone, branch) {
     const { libs, paths, plans } = await this.slice();
     const held = await this.#holdSubspaceOwned();
+    const heldRootEntries = await this.#holdRootEntries();
     for (const member of Subspace.memberDirs)
       await rm(path.join(this.#clonePath, member), { recursive: true, force: true });
     await this.#extract(["."], ["apps/*", "libs/*", "pkgs/*"]);
     await this.#extract(paths);
+    await this.#restoreRootEntries(heldRootEntries);
     await this.#restoreSubspaceOwned(held);
-    for (const entry of [...Subspace.workspaceOnlyEntries, ...this.#config.exclude])
-      await rm(path.join(this.#clonePath, entry), { recursive: true, force: true });
+    for (const entry of this.#config.exclude)
+      if (!Subspace.subspaceOwnedRootEntries.includes(entry))
+        await rm(path.join(this.#clonePath, entry), { recursive: true, force: true });
     await this.#rewriteGitignore();
     const pruned = await this.#rewriteManifest(plans);
     await this.#rewriteWorkspaceSection(libs);
@@ -311,9 +384,9 @@ class Subspace {
     const [hash, previous] = await Promise.all([this.#hashLib(clone, lib), this.#committedStamp(clone, lib)]);
     const manifest = await FileSys2.readJson(manifestPath);
     const akan = manifest[LibSource.manifestKey] ?? {};
-    const unchanged = previous?.origin === origin && previous.sha === sha && previous.hash === hash;
-    const syncedAt = unchanged ? previous.syncedAt : new Date().toISOString();
-    manifest[LibSource.manifestKey] = { ...akan, source: { origin, sha, hash, syncedAt } };
+    const unchanged = previous?.origin === origin && previous.hash === hash;
+    const source = unchanged ? previous : { origin, sha, hash, syncedAt: new Date().toISOString() };
+    manifest[LibSource.manifestKey] = { ...akan, source };
     await FileSys2.writeJson(manifestPath, manifest);
   }
   async#committedStamp(clone, lib) {
@@ -363,6 +436,13 @@ class Subspace {
       return { files: [], patch: "" };
     return { files, patch: await this.#git(["diff", from, "HEAD", "--", ...files]) };
   }
+  async#loopbackRegistryLock(root = this.#clonePath) {
+    const lockPath = path.join(root, "bun.lock");
+    if (!await FileSys2.fileExists(lockPath))
+      return null;
+    const registry = (await FileSys2.readText(lockPath)).match(Subspace.#loopbackRegistry)?.[0];
+    return registry ? `bun.lock resolves packages from ${registry}, a registry only this machine reaches; reinstall from a public registry and commit that lock first` : null;
+  }
   async#verify(clone) {
     const env = { ...process.env, ...this.#localEnv() };
     try {
@@ -398,9 +478,12 @@ class Subspace {
       if (failure)
         return { name: this.name, outcome: "refused", reason: failure, changedFiles };
     }
+    const lockProblem = await this.#loopbackRegistryLock();
+    if (lockProblem)
+      return { name: this.name, outcome: "refused", reason: lockProblem, changedFiles };
     await this.#writeAnchorFile(branch);
     await clone.spawn("git", ["add", "-A"]);
-    const message = `chore(subspace): sync from ${this.#workspace.repoName}@${await this.headSha()}`;
+    const message = `${Subspace.syncSubjectPrefix}${this.#workspace.repoName}@${await this.headSha()}`;
     await clone.spawn("git", ["commit", "--quiet", "-m", message]);
     await clone.spawn("git", ["push", "--quiet", "origin", branch]);
     return {
@@ -560,74 +643,37 @@ function formatSubspaceDiff(result) {
   return sections.join(`
 `);
 }
+function formatSubspacePlan(plan) {
+  const list = (entries) => entries.length ? entries.join(", ") : "(none)";
+  const blockers = [plan.branchRefusal, plan.lockProblem].filter((reason) => !!reason);
+  const sections = [
+    `Akan Subspace Plan \u2014 ${plan.name} (${plan.branch})`,
+    `repo: ${plan.repo}`,
+    "what `akan subspace push` would ship, worked out from this checkout alone",
+    "",
+    `apps: ${list(plan.apps)}`,
+    `libs: ${plan.libs.length ? "" : "(none)"}`.trimEnd(),
+    ...plan.libs.map((lib) => `  - ${lib.name} (from ${lib.apps.join(", ")})`),
+    `files under apps/ and libs/: ${plan.files}`,
+    "",
+    `root entries pushed: ${list(plan.rootEntries)}`,
+    `root entries excluded: ${list(plan.excludedRootEntries)}`,
+    `root entries the subspace keeps its own: ${list(plan.subspaceOwnedRootEntries)}`,
+    "",
+    `Root dependencies left out of package.json (${plan.prunedDependencies.length}):`,
+    ...plan.prunedDependencies.length ? plan.prunedDependencies.map((dep) => `  - ${dep}`) : ["  (none)"],
+    "",
+    blockers.length ? "A push would be refused:" : "Nothing here would make a push refuse.",
+    ...blockers.map((reason) => `  - ${reason}`),
+    ...plan.warnings.length ? ["", `Warnings (${plan.warnings.length}):`, ...plan.warnings.map((w) => `  - ${w}`)] : []
+  ];
+  return sections.join(`
+`);
+}
 
 // pkgs/@akanjs/cli/subspace/subspace.script.ts
 import { Logger } from "akanjs/common";
 
-// pkgs/@akanjs/devkit/subspaceConfig.ts
-import path2 from "path";
-class SubspaceConfig {
-  static fileName = "akan.subspace.ts";
-  static defaultPushableBranches = ["main", "develop", "debug"];
-  static async from(workspace) {
-    const configPath = path2.join(workspace.workspaceRoot, SubspaceConfig.fileName);
-    if (!await FileSys2.fileExists(configPath))
-      return null;
-    const input = await import(configPath).then((mod) => mod.default);
-    return new SubspaceConfig(input);
-  }
-  pushableBranches;
-  exclude;
-  subspaces;
-  constructor(input) {
-    this.pushableBranches = input.pushableBranches ?? SubspaceConfig.defaultPushableBranches;
-    this.exclude = input.exclude ?? [];
-    this.subspaces = input.subspaces ?? [];
-    this.#assertValid();
-  }
-  #assertValid() {
-    const seenNames = new Set;
-    const appOwners = new Map;
-    const idOwners = new Map;
-    for (const subspace of this.subspaces) {
-      if (!subspace.name || !subspace.repo)
-        throw new Error(`${SubspaceConfig.fileName}: every subspace needs a name and a repo`);
-      if (seenNames.has(subspace.name))
-        throw new Error(`${SubspaceConfig.fileName}: duplicate subspace "${subspace.name}"`);
-      seenNames.add(subspace.name);
-      if (!subspace.apps?.length)
-        throw new Error(`${SubspaceConfig.fileName}: subspace "${subspace.name}" declares no apps`);
-      for (const app of subspace.apps) {
-        const owner = appOwners.get(app);
-        if (owner)
-          throw new Error(`${SubspaceConfig.fileName}: app "${app}" is claimed by both "${owner}" and "${subspace.name}"`);
-        appOwners.set(app, subspace.name);
-      }
-      if (!subspace.workspaceId)
-        continue;
-      const idOwner = idOwners.get(subspace.workspaceId);
-      if (idOwner)
-        throw new Error(`${SubspaceConfig.fileName}: subspaces "${idOwner}" and "${subspace.name}" declare the same workspaceId`);
-      idOwners.set(subspace.workspaceId, subspace.name);
-    }
-  }
-  select(names) {
-    if (!names.length)
-      return this.subspaces;
-    return names.map((name) => {
-      const subspace = this.subspaces.find((candidate) => candidate.name === name);
-      if (!subspace)
-        throw new Error(`${SubspaceConfig.fileName}: unknown subspace "${name}"`);
-      return subspace;
-    });
-  }
-  assertPushable(branch) {
-    if (this.pushableBranches.includes(branch))
-      return;
-    throw new Error(`Branch "${branch}" is not pushable. ${SubspaceConfig.fileName} allows: ${this.pushableBranches.join(", ")}`);
-  }
-}
-
 // pkgs/@akanjs/cli/subspace/subspace.runner.ts
 var loadPrompts = async () => await import("@inquirer/prompts");
 
@@ -636,7 +682,7 @@ class SubspaceRunner extends runner("subspace") {
   async config(workspace) {
     const config = await SubspaceConfig.from(workspace);
     if (!config)
-      throw new Error(`No ${SubspaceConfig.fileName} at the workspace root. Declare the customer repos there first.`);
+      throw new Error("The workspace root akan.config.ts declares no `subspace`. Declare the customer repos there first.");
     return config;
   }
   async subspaces(workspace, names) {
@@ -655,7 +701,7 @@ class SubspaceRunner extends runner("subspace") {
   static async chooseNames(config, action, { interactive, prompts }) {
     const multiple = SubspaceRunner.multiTargetActions.includes(action);
     if (!config.subspaces.length)
-      throw new Error(`${SubspaceConfig.fileName} declares no subspaces.`);
+      throw new Error(`${SubspaceConfig.source} declares no subspaces.`);
     if (!interactive) {
       throw new Error(multiple ? `\`akan subspace ${action}\` needs a subspace name when it cannot prompt. Pass one, or run \`akan subspace ${action}-all\` for every subspace.` : `\`akan subspace ${action}\` needs a subspace name when it cannot prompt \u2014 it is reviewed one repo at a time.`);
     }
@@ -684,6 +730,13 @@ class SubspaceRunner extends runner("subspace") {
       results.push(await subspace.push(branch, { verify }));
     return results;
   }
+  async plan(workspace, name) {
+    const { subspaces, branch } = await this.subspaces(workspace, [name]);
+    const [subspace] = subspaces;
+    if (!subspace)
+      throw new Error(`Unknown subspace "${name}"`);
+    return await subspace.plan(branch);
+  }
   async diff(workspace, name, filter) {
     const { subspaces, branch } = await this.subspaces(workspace, [name]);
     const [subspace] = subspaces;
@@ -706,7 +759,7 @@ class SubspaceRunner extends runner("subspace") {
     const subspace = new Subspace(workspace, config, declaration);
     const { workspaceId } = subspace;
     if (!workspaceId)
-      throw new Error(`Subspace "${subspace.name}" declares no workspaceId. Add its cloud workspace id to ${SubspaceConfig.fileName}.`);
+      throw new Error(`Subspace "${subspace.name}" declares no workspaceId. Add its cloud workspace id to ${SubspaceConfig.source}.`);
     if (workspaceId === workspace.getWorkspaceId({ allowEmpty: true }))
       throw new Error(`Subspace "${subspace.name}" declares this workspace's own id. Uploading a slice there would replace the workspace's env archive with a subset of it.`);
     const apps = subspace.apps;
@@ -714,7 +767,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-64gzba8r.js");
+    const { CloudScript } = await import("./cloud.script-r7eyfey4.js");
     const { files } = await CommandContainer.get(CloudScript).uploadEnv(workspace, {
       host,
       workspaceId,
@@ -758,6 +811,12 @@ class SubspaceScript extends script("subspace", [SubspaceRunner]) {
     if (results.some((result) => result.outcome === "refused"))
       process.exitCode = 1;
   }
+  async plan(workspace, name, format = "text") {
+    const spinner = workspace.spinning(`Planning ${name}...`);
+    const plan = await this.subspaceRunner.plan(workspace, name);
+    spinner.succeed(`${plan.apps.length} app(s), ${plan.libs.length} librar(ies), ${plan.files} file(s)`);
+    Logger.rawLog(format === "json" ? JSON.stringify(plan, null, 2) : formatSubspacePlan(plan));
+  }
   async diff(workspace, name, filter, format = "text") {
     const spinner = workspace.spinning(`Diffing ${name}...`);
     const result = await this.subspaceRunner.diff(workspace, name, filter);
@@ -766,7 +825,10 @@ class SubspaceScript extends script("subspace", [SubspaceRunner]) {
     Logger.rawLog(format === "json" ? JSON.stringify(result, null, 2) : formatSubspaceDiff(result));
   }
   async uploadEnv(workspace, name, { host, force, format }) {
-    const result = await this.subspaceRunner.uploadEnv(workspace, name, { host, force });
+    const result = await this.subspaceRunner.uploadEnv(workspace, name, {
+      host: await GlobalConfig.hostFor(workspace, host),
+      force
+    });
     Logger.rawLog(format === "json" ? JSON.stringify(result, null, 2) : formatSubspaceEnvUpload(result));
   }
   async pull(workspace, name, { adoptLibs, format }) {
@@ -780,9 +842,9 @@ class SubspaceScript extends script("subspace", [SubspaceRunner]) {
 // pkgs/@akanjs/cli/subspace/subspace.command.ts
 class SubspaceCommand extends command("subspace", [SubspaceScript], ({ public: target }) => ({
   subspace: target({ desc: "Mirror apps and libraries between this workspace and the customer repos it serves" }).arg("action", String, {
-    desc: "subspace action; status-all and push-all take every declared subspace",
+    desc: "subspace action; plan reads this checkout alone, status-all and push-all take every declared subspace",
     default: "status",
-    enum: ["status", "status-all", "diff", "push", "push-all", "pull", "upload-env"]
+    enum: ["status", "status-all", "plan", "diff", "push", "push-all", "pull", "upload-env"]
   }).arg("subspace", String, {
     desc: "subspace name; asks which one(s) when omitted, and is refused by status-all / push-all",
     nullable: true
@@ -790,7 +852,10 @@ class SubspaceCommand extends command("subspace", [SubspaceScript], ({ public: t
     flag: "y",
     desc: "run bun install + akan sync in the subspace before committing",
     default: true
-  }).option("adoptLibs", Boolean, { desc: "pull: also apply the subspace's library edits", default: false }).option("path", String, { desc: "diff: limit to one path", nullable: true }).option("host", String, { desc: "upload-env: host of the cloud to target", default: GlobalConfig.akanCloudHost }).option("force", Boolean, {
+  }).option("adoptLibs", Boolean, { desc: "pull: also apply the subspace's library edits", default: false }).option("path", String, { desc: "diff: limit to one path", nullable: true }).option("host", String, {
+    desc: "upload-env: host of the cloud to target (default: cloud.host of the root akan.config.ts, else Akan Cloud)",
+    nullable: true
+  }).option("force", Boolean, {
     flag: "F",
     desc: "upload-env: replace the subspace's env archive without asking",
     default: false
@@ -798,8 +863,8 @@ class SubspaceCommand extends command("subspace", [SubspaceScript], ({ public: t
     const output = format;
     const all = action === "status-all" || action === "push-all";
     const base = all ? action.slice(0, -"-all".length) : action;
-    if (base !== "status" && base !== "diff" && base !== "push" && base !== "pull" && base !== "upload-env")
-      throw new Error(`Unknown subspace action: ${action}. Use status, status-all, diff, push, push-all, pull or upload-env.`);
+    if (base !== "status" && base !== "plan" && base !== "diff" && base !== "push" && base !== "pull" && base !== "upload-env")
+      throw new Error(`Unknown subspace action: ${action}. Use status, status-all, plan, diff, push, push-all, pull or upload-env.`);
     if (all && subspace)
       throw new Error(`\`akan subspace ${action}\` takes no name. Run \`akan subspace ${base} ${subspace}\` instead.`);
     const names = subspace ? [subspace] : all ? [] : await this.subspaceScript.select(workspace, base);
@@ -811,7 +876,9 @@ class SubspaceCommand extends command("subspace", [SubspaceScript], ({ public: t
       const [name] = names;
       if (!name)
         throw new Error(`\`akan subspace ${base}\` needs a name \u2014 it is reviewed one repo at a time.`);
-      if (base === "diff")
+      if (base === "plan")
+        await this.subspaceScript.plan(workspace, name, output);
+      else if (base === "diff")
         await this.subspaceScript.diff(workspace, name, filePath, output);
       else if (base === "upload-env")
         await this.subspaceScript.uploadEnv(workspace, name, { host, force, format: output });

package/templates/appSample/page/task/[taskId]/_index.tsx

@@ -11,9 +11,9 @@ import { Link } from "akanjs/ui";
 
 export default page()
   .param("taskId", ID)
-  .render(async ({ taskId }) => {
+  .render(({ taskId }) => {
     const { l } = usePage();
-    const { taskView } = await fetch.viewTask(taskId);
+    const { taskView } = fetch.viewTask(taskId);
     return (
       <main className="mx-auto max-w-4xl px-6 py-8">
         <div className="mb-6 flex items-center justify-between">

package/templates/appSample/page/task/[taskId]/edit.tsx

@@ -11,8 +11,8 @@ import { Link, Load } from "akanjs/ui";
 
 export default page()
   .param("taskId", ID)
-  .render(async ({ taskId }) => {
-    const { taskEdit } = await fetch.editTask(taskId);
+  .render(({ taskId }) => {
+    const { taskEdit } = fetch.editTask(taskId);
 
     return (
       <main className="mx-auto max-w-2xl px-6 py-8">

package/templates/appSample/page/task/_index.tsx

@@ -8,9 +8,9 @@ import { jellyButtonRecipe } from "@apps/${dict.appName}/ui";
 import { page } from "akanjs/client";
 import { Link } from "akanjs/ui";
 
-export default page().render(async () => {
+export default page().render(() => {
   const { l } = usePage();
-  const { taskInitInPublic } = await fetch.initTaskInPublic();
+  const { taskInitInPublic } = fetch.initTaskInPublic();
   return (
     <main className="mx-auto max-w-4xl px-6 py-8">
       <div className="mb-6 flex items-center justify-between">

package/templates/crudPages/[__model__Id]/edit/page.tsx

@@ -18,9 +18,9 @@ import { Load } from "akanjs/ui";
 export default page()
   .param("${dict.model}Id", ID)
   .config({ transition: "none" })
-  .render(async ({ ${dict.model}Id }) => {
+  .render(({ ${dict.model}Id }) => {
     const { l } = usePage();
-    const [{ ${dict.model}Edit }] = await Promise.all([fetch.edit${dict.Model}(${dict.model}Id)]);
+    const { ${dict.model}Edit } = fetch.edit${dict.Model}(${dict.model}Id);
     return (
       <div className="container">
         <div className="m-4 mt-8 flex justify-between">

package/templates/crudPages/[__model__Id]/page.tsx

@@ -26,14 +26,14 @@ export default page()
       <meta property="og:description" content={${dict.model}Id} />
     </>
   ))
-  .render(async ({ ${dict.model}Id }) => {
+  .render(({ ${dict.model}Id }) => {
     const { l } = usePage();
-    const [{ ${dict.model}, ${dict.model}View }] = await Promise.all([fetch.view${dict.Model}(${dict.model}Id)]);
+    const { ${dict.model}View } = fetch.view${dict.Model}(${dict.model}Id);
     return (
       <div className="container flex flex-col gap-4">
         <div className="flex items-center gap-4 font-bold text-lg">
           <${dict.Model}.Zone.View view={${dict.model}View} />
-          <Link className={buttonRecipe()} href={\`/${dict.model}/\${${dict.model}.id}/edit\`}>
+          <Link className={buttonRecipe()} href={\`/${dict.model}/\${${dict.model}Id}/edit\`}>
             {l("base.updateModel", { model: l("${dict.model}.modelName") })}
           </Link>
         </div>

package/templates/crudPages/page.tsx

@@ -16,9 +16,9 @@ import { buttonRecipe, Link } from "akanjs/ui";
 
 export default page()
   .config({ transition: "none" })
-  .render(async () => {
+  .render(() => {
     const { l } = usePage();
-    const [{ ${dict.model}InitInPublic }] = await Promise.all([fetch.init${dict.Model}InPublic()]);
+    const { ${dict.model}InitInPublic } = fetch.init${dict.Model}InPublic();
     return (
       <div className="container flex flex-col gap-4">
         <div className="mt-5 h-full w-full px-5">

package/templates/crudSinglePage/page.tsx

@@ -16,15 +16,15 @@ import { buttonRecipe, Model } from "akanjs/ui";
 
 export default page()
   .config({ transition: "none" })
-  .render(async () => {
+  .render(() => {
     const { l } = usePage();
-    const [{ ${dict.model}InitInPublic }] = await Promise.all([fetch.init${dict.Model}InPublic()]);
+    const { ${dict.model}InitInPublic } = fetch.init${dict.Model}InPublic();
     return (
       <>
         <div className="flex animate-fadeIn items-center gap-4 px-4 pt-4">
           <div className="font-bold text-lg md:text-4xl">{l("${dict.model}.modelName")}</div>
           <Model.New
-            className={buttonRecipe({ size: "sm", variant: "ghost" })}
+            trigger={<button className={buttonRecipe({ size: "sm", variant: "ghost" })}>{l("base.new")}</button>}
             slice={fetch.slice.${dict.model}InPublic}
             renderTitle="id"
           >

package/templates/lib/cnst.ts

@@ -21,9 +21,9 @@ ${databaseModules.map((module) => `export * from "./${module}/${module}.constant
 ${databaseModules
   .map((module) => {
     const names = { Module: capitalize(module) };
-    return `export const ${module} = ConstantRegistry.buildModel("${module}" as const, ${module}Cnst.${names.Module}Input, ${module}Cnst.${names.Module}Object, ${module}Cnst.${names.Module}, ${module}Cnst.Light${names.Module}, ${module}Cnst.${names.Module}Insight, ${module}Cnst);`;
+    return `export const ${module} = ConstantRegistry.buildModel("${module}" as const, ${module}Cnst.${names.Module}Input, ${module}Cnst.${names.Module}Object, ${module}Cnst.${names.Module}, ${module}Cnst.Light${names.Module}, ${module}Cnst.${names.Module}Insight, ${module}Cnst, "${scanInfo.name}");`;
   })
   .join("\n")}
-${scalarModules.map((module) => `export const ${module} = ConstantRegistry.buildScalar("${module}" as const, ${module}Cnst.${capitalize(module)}, ${module}Cnst);`).join("\n")}
+${scalarModules.map((module) => `export const ${module} = ConstantRegistry.buildScalar("${module}" as const, ${module}Cnst.${capitalize(module)}, ${module}Cnst, "${scanInfo.name}");`).join("\n")}
 `;
 }