@akanjs/cli 3.0.0-beta.25 → 3.0.0-beta.26

package/.build-stamp

@@ -1 +1 @@
-ebb85e20e2ce0664a89d89b8a4118186e1277010b003f7c8a8222101af0c5263
+2c02e63aa5466798c5de1ca1a641b776ce09e613629d2e311bae25a91063f81a

package/README.ko.md

@@ -0,0 +1,72 @@
+# @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

@@ -0,0 +1,88 @@
+# @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

package/{application.command-2x9jqy0k.js → application.command-afajz1m5.js}

@@ -16,7 +16,7 @@ import"./index-48k96p55.js";
 import"./index-5mm3g24t.js";
 import {
   ApplicationScript
-} from "./index-pb10njz7.js";
+} from "./index-cfj73ck1.js";
 import"./index-7md2g9vw.js";
 import"./index-860zjnr1.js";
 

package/{applicationBuildRunner-tm0vba5t.js → applicationBuildRunner-412y0345.js}

@@ -2,14 +2,14 @@
 import {
   Spinner
 } from "./index-0n9q1f23.js";
-import"./index-dt1x62ec.js";
+import"./index-cd9qt2t6.js";
 import {
   AllRoutesBuilder,
   CsrArtifactBuilder,
   FontPruner,
   precompressArtifacts,
   SsrBaseArtifactBuilder
-} from "./index-4mgbzgb5.js";
+} from "./index-wvebzf0y.js";
 import"./index-52w0fvh8.js";
 import"./index-n68jx79w.js";
 

package/buildBatch.proc.js

@@ -14,14 +14,14 @@ import {
   PagesBundleBuilder,
   CsrDevBundler,
   SsrDevBundler
-} from "./index-dt1x62ec.js";
+} from "./index-cd9qt2t6.js";
 import"./index-52w0fvh8.js";
 import {
   CsrArtifactBuilder,
   CssCompiler,
   FontOptimizer,
   SsrBaseArtifactBuilder
-} from "./index-4mgbzgb5.js";
+} from "./index-wvebzf0y.js";
 import"./index-n68jx79w.js";
 
 // pkgs/@akanjs/devkit/incrementalBuilder/buildBatch.proc.ts

package/{cloud.command-j6m607bp.js → cloud.command-yz0h8a2e.js}

@@ -13,14 +13,14 @@ import {
 } from "./index-56xwsgyn.js";
 import"./index-48k96p55.js";
 import"./index-5mm3g24t.js";
-import"./index-pb10njz7.js";
+import"./index-cfj73ck1.js";
 import"./index-ys6f0bvh.js";
 import"./index-7md2g9vw.js";
 import"./index-2ahj896a.js";
 import"./index-per2kqy9.js";
 import {
   CloudScript2
-} from "./index-8k93esfr.js";
+} from "./index-mq74nzf8.js";
 import"./index-860zjnr1.js";
 
 // pkgs/@akanjs/cli/cloud/cloud.command.ts

package/{cloud.script-r5t7nhee.js → cloud.script-zez2b8am.js}

@@ -1,10 +1,10 @@
 // @bun
 import {
   CloudScript2
-} from "./index-8k93esfr.js";
+} from "./index-mq74nzf8.js";
 import"./index-56xwsgyn.js";
 import"./index-per2kqy9.js";
-import"./index-pb10njz7.js";
+import"./index-cfj73ck1.js";
 import"./index-860zjnr1.js";
 import"./index-5mm3g24t.js";
 import"./index-ys6f0bvh.js";

package/incrementalBuilder.proc.js

@@ -20,7 +20,7 @@ import {
   DevChangePlanner,
   DevGeneratedIndexSync,
   SsrDevBundler
-} from "./index-dt1x62ec.js";
+} from "./index-cd9qt2t6.js";
 import {
   prepareDevWatchBatch
 } from "./index-a5vmm6x4.js";

package/{index-dt1x62ec.js → index-cd9qt2t6.js}

@@ -3477,11 +3477,13 @@ class CsrDevModuleCompiler {
   static #factory(id, code) {
     const prefix = CsrDevPaths.modulePrefix;
     let patched = code.replaceAll(`import("${prefix}`, `__akanImport("${prefix}`).replace(/^\/\/# debugId=.*$/m, "");
+    const marker = patched.search(/^\/\/ /m);
+    const body = marker < 0 ? "" : patched.slice(marker);
     for (const [name, params, method] of CsrDevModuleCompiler.#helperPatches) {
       const definition = `var ${name} = ${params} => {`;
       if (patched.includes(definition))
         patched = patched.replace(definition, `var ${name} = __akan.${method}, __bun${name} = ${params} => {`);
-      else if (patched.includes(`${name}(`))
+      else if (patched.includes(`${name}(`) && !new RegExp(`\\b(?:var|let|const|function)\\s+${name}\\b`).test(body))
         throw new Error(`[csr-dev] ${id}: Bun's ${name} helper no longer reads "${definition}"; CsrDevModuleCompiler must follow`);
     }
     if (CsrDevModuleCompiler.#storeRoot.test(id))

package/{index-pb10njz7.js → index-cfj73ck1.js}

@@ -244,17 +244,29 @@ class IncrementalBuilderHost {
   #manualStop = false;
   #inFlight = new Map;
   #startOptions = {};
-  constructor({ app, entry, env, stdio = "inherit", onMessage, onOutput }) {
+  constructor({
+    app,
+    entry,
+    env,
+    stdio = "inherit",
+    onMessage,
+    onOutput,
+    patcherOff = false
+  }) {
     this.app = app;
     this.entry = entry;
     this.env = env;
     this.#stdio = stdio;
     this.#onMessage = onMessage;
     this.#onOutput = onOutput ?? null;
+    this.#patcherOff = patcherOff;
   }
   get status() {
     return this.#status;
   }
+  get patcherOff() {
+    return this.#patcherOff;
+  }
   get pid() {
     return this.#proc?.pid ?? null;
   }
@@ -452,7 +464,8 @@ class IncrementalBuilderHost {
   }
   static async create(app, env, onMessage, {
     stdio = "inherit",
-    onOutput
+    onOutput,
+    patcherOff = false
   } = {}) {
     const candidates = [
       path.join(app.workspace.workspaceRoot, "pkgs/@akanjs/devkit/incrementalBuilder/incrementalBuilder.proc.ts"),
@@ -462,7 +475,7 @@ class IncrementalBuilderHost {
     ];
     for (const c of candidates)
       if (await Bun.file(c).exists())
-        return new IncrementalBuilderHost({ app, entry: c, env, stdio, onMessage, onOutput });
+        return new IncrementalBuilderHost({ app, entry: c, env, stdio, onMessage, onOutput, patcherOff });
     throw new Error(`[cli] frontend builder entry not found; looked in: ${candidates.join(", ")}`);
   }
 }
@@ -703,6 +716,7 @@ class AkanAppHost {
   #bootLatch = new DevBootLatch(() => this.#onDevEvent?.({ app: this.app.name, booted: true }));
   #backend = null;
   #builder = null;
+  #patcherOff = false;
   #backendReady = false;
   #plannedBackendStops = new WeakSet;
   #restartTimer = null;
@@ -1600,6 +1614,7 @@ ${this.#backendStderrTail.join(`
     this.#pendingBuildStatusReplay = [];
     await this.#stopBackend();
     this.#stopBuilder();
+    this.#patcherOff = false;
     if (refreshConfig) {
       await this.app.getConfig({ refresh: true });
       const { env } = await this.app.prepareCommand("start");
@@ -1715,7 +1730,8 @@ ${this.#backendStderrTail.join(`
         this.#enqueueBuilderMessage(msg);
       }, {
         stdio: this.stdio,
-        onOutput: (kind, text) => void (kind === "stderr" ? process.stderr : process.stdout).write(text)
+        onOutput: (kind, text) => void (kind === "stderr" ? process.stderr : process.stdout).write(text),
+        patcherOff: this.#patcherOff
       });
       try {
         await this.#waitForBuilderReady(attempt, { announceBootState });
@@ -1801,6 +1817,8 @@ ${this.#backendStderrTail.join(`
     this.#cancelRssRecycle();
     if (!this.#builder)
       return;
+    if (this.#builder.patcherOff)
+      this.#patcherOff = true;
     this.#builder.stop();
     this.#builder = null;
   }
@@ -1828,7 +1846,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-tm0vba5t.js")).ApplicationBuildRunner;
+var loadBuildRunner = async () => (await import("./applicationBuildRunner-412y0345.js")).ApplicationBuildRunner;
 var loadPrompts = async () => await import("@inquirer/prompts");
 
 class ApplicationRunner extends runner("application") {

package/{index-8k93esfr.js → index-mq74nzf8.js}

@@ -11,7 +11,7 @@ import {
 } from "./index-0n9q1f23.js";
 import {
   ApplicationScript
-} from "./index-pb10njz7.js";
+} from "./index-cfj73ck1.js";
 import {
   PackageScript
 } from "./index-per2kqy9.js";

package/{index-4mgbzgb5.js → index-wvebzf0y.js}

@@ -16,7 +16,7 @@ import {
   CsrEntryFiles,
   PagesEntrySourceGenerator,
   PagesBundleBuilder
-} from "./index-dt1x62ec.js";
+} from "./index-cd9qt2t6.js";
 import {
   SOURCE_EXTS
 } from "./index-48k96p55.js";

package/index.js

@@ -13,18 +13,18 @@ import path from "path";
 
 // pkgs/@akanjs/cli/commandModules.ts
 var commandModules = {
-  workspace: async () => (await import("./workspace.command-p44d21qf.js")).WorkspaceCommand,
+  workspace: async () => (await import("./workspace.command-d8he10tv.js")).WorkspaceCommand,
   agent: async () => (await import("./agent.command-rp505zxa.js")).AgentCommand,
   code: async () => (await import("./code.command-jhrjttm1.js")).CodeCommand,
-  application: async () => (await import("./application.command-2x9jqy0k.js")).ApplicationCommand,
+  application: async () => (await import("./application.command-afajz1m5.js")).ApplicationCommand,
   library: async () => (await import("./library.command-sv6g1h2g.js")).LibraryCommand,
-  localRegistry: async () => (await import("./localRegistry.command-4kj56531.js")).LocalRegistryCommand,
+  localRegistry: async () => (await import("./localRegistry.command-fm41vdtw.js")).LocalRegistryCommand,
   package: async () => (await import("./package.command-xmw605b1.js")).PackageCommand,
   module: async () => (await import("./module.command-ccdeder9.js")).ModuleCommand,
   page: async () => (await import("./page.command-ky7vafsn.js")).PageCommand,
   context: async () => (await import("./context.command-xncdvv7n.js")).ContextCommand,
-  cloud: async () => (await import("./cloud.command-j6m607bp.js")).CloudCommand,
-  subspace: async () => (await import("./subspace.command-ygfdqpbj.js")).SubspaceCommand,
+  cloud: async () => (await import("./cloud.command-yz0h8a2e.js")).CloudCommand,
+  subspace: async () => (await import("./subspace.command-y1p56wyv.js")).SubspaceCommand,
   guideline: async () => (await import("./guideline.command-d5qmxx29.js")).GuidelineCommand,
   scalar: async () => (await import("./scalar.command-t09gmck8.js")).ScalarCommand,
   primitive: async () => (await import("./primitive.command-bh6j8nfs.js")).PrimitiveCommand,

package/{localRegistry.command-4kj56531.js → localRegistry.command-fm41vdtw.js}

@@ -13,7 +13,7 @@ import"./index-48k96p55.js";
 import"./index-5mm3g24t.js";
 import {
   ApplicationScript
-} from "./index-pb10njz7.js";
+} from "./index-cfj73ck1.js";
 import"./index-ys6f0bvh.js";
 import"./index-7md2g9vw.js";
 import"./index-94s080qm.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@akanjs/cli",
-  "version": "3.0.0-beta.25",
+  "version": "3.0.0-beta.26",
   "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.25",
+    "akanjs": "3.0.0-beta.26",
     "chalk": "^5.6.2",
     "commander": "^14.0.3",
     "dayjs": "^1.11.20",
@@ -62,4 +62,4 @@
   "bun": {
     "platform": "bun"
   }
-}
+}

package/{subspace.command-ygfdqpbj.js → subspace.command-y1p56wyv.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-r5t7nhee.js");
+    const { CloudScript } = await import("./cloud.script-zez2b8am.js");
     const { files } = await CommandContainer.get(CloudScript).uploadEnv(workspace, {
       host,
       workspaceId,

package/{workspace.command-p44d21qf.js → workspace.command-d8he10tv.js}

@@ -44,7 +44,7 @@ import {
 } from "./index-5mm3g24t.js";
 import {
   ApplicationScript
-} from "./index-pb10njz7.js";
+} from "./index-cfj73ck1.js";
 import"./index-ys6f0bvh.js";
 import"./index-7md2g9vw.js";
 import"./index-2ahj896a.js";
@@ -57,7 +57,7 @@ import {
 } from "./index-56xwsgyn.js";
 import {
   CloudScript2
-} from "./index-8k93esfr.js";
+} from "./index-mq74nzf8.js";
 import"./index-7yxndzea.js";
 import"./index-t02g6dpn.js";
 import"./index-v4hnkqz9.js";