@akanjs/cli 3.0.0-beta.8 → 3.0.0

package/README.ko.md

@@ -1,44 +1,98 @@
 # @akanjs/cli
 
-[문서](https://akanjs.com/docs) | [npm](https://www.npmjs.com/package/@akanjs/cli) | [런타임](https://www.npmjs.com/package/akanjs)
+[English](https://github.com/akan-team/akanjs/blob/main/pkgs/@akanjs/cli/README.md) | [문서](https://akanjs.com/docs) | [npm](https://www.npmjs.com/package/@akanjs/cli) | [런타임](https://www.npmjs.com/package/akanjs)
 
-Akan.js 워크스페이스를 위한 command-line tooling입니다.
+에이전트까지 들어 있는 TypeScript 프레임워크 [Akan.js](https://akanjs.com)의 `akan` 명령입니다.
 
-`@akanjs/cli`는 Akan 애플리케이션, 라이브러리, 프레임워크 패키지를 생성, 빌드, 테스트, 린트,
-릴리즈, 유지보수하는 데 사용하는 `akan` 실행 파일을 제공합니다. Bun-first CLI 패키지이며 Akan
-개발 tooling을 내부에 번들링하므로, 애플리케이션 런타임은 더 작은 `akanjs` 패키지에만 의존할 수
-있습니다.
+`akan`은 Akan 워크스페이스를 만들고, 실행하고, 빌드하고, 테스트하고, 배포합니다. 하나의 코드베이스에서 웹,
+iOS, Android, 데스크톱 앱이 나오고, 코딩 에이전트에게는 따라야 할 규칙과 도구를 줍니다. Bun-first 패키지이며 Akan
+개발 도구를 내부에 번들하므로, 애플리케이션 런타임은 더 작은 `akanjs` 패키지에만 의존합니다.
 
 ## 설치
 
-새 워크스페이스를 바로 만들 수 있습니다.
+Claude Code나 Codex로 시작한다면 [시작하기](https://akanjs.com/docs/intro/quickstart)의 프롬프트를 붙여 넣으세요.
+에이전트가 워크스페이스를 만들어 줍니다.
+
+터미널에서는 이렇게 시작합니다.
 
 ```bash
 bunx create-akan-workspace@latest
 ```
 
-또는 CLI를 전역으로 설치할 수 있습니다.
+또는 CLI를 전역으로 설치합니다.
 
 ```bash
-bun install -g @akanjs/cli@latest
+bun install -g @akanjs/cli
 akan --help
 ```
 
 ## 자주 쓰는 명령
 
 ```bash
-akan create-workspace <workspace-name>
-akan start <app-name>
-akan build <app-name>
-akan test <app-or-lib-or-pkg>
+akan create-workspace <workspace> --app <app>
+akan create-application <app>
+akan create-library <lib>
+akan create-module <module>
+akan create-scalar <scalar>
+akan start <app> --open
+akan build <app>
+akan typecheck <app>
 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>
+akan test <app-or-lib-or-pkg>
+akan logs <app>
+akan update
+```
+
+- `akan start`는 여러 앱을 한 번에 받습니다(`akan start a,b`, 또는 `all`). 앱마다 로그를 나눠 보여 주는 전체
+  화면으로 열리고, `--plain`은 접두어가 붙은 줄 출력으로, `--kill`은 개발 포트를 먼저 비우고, `--share`는 앱마다
+  공개 URL을 붙입니다. 모든 세션은 `local/apps/<app>/runtime/dev.log`에도 기록됩니다.
+- `akan logs <app>`은 실행 중인 서버의 로그를 `--level`, `--grep`, `--endpoint`, `--trace`, `--origin`으로 걸러
+  따라갑니다.
+
+## 네이티브 앱
+
+```bash
+akan start-ios <app>        # start-android, start-desktop도 있습니다
+akan build-ios <app>        # build-android, build-desktop도 있습니다
+akan release-ios <app>      # release-android도 있습니다
+akan update-keygen <app>
+akan publish-update <app>
 ```
 
-패키지 유지보수 명령도 같은 실행 파일에서 제공합니다.
+iOS, Android, macOS, Windows, Linux 앱은 앱의 CSR 번들을 Akan 네이티브 런타임에 올려 만들고,
+`akan.config.ts`의 `native` 섹션에서 설정합니다.
+
+## 코딩 에이전트를 위한 명령
+
+```bash
+akan code "작업에 마감일을 추가해 줘"   # 터미널 코딩 에이전트
+akan agent install all                # AGENTS.md, CLAUDE.md, Cursor 규칙
+akan mcp-install all                  # Cursor, Claude Code, Codex에 Akan MCP 서버 등록
+akan mcp --mode plan                  # stdio MCP 서버: readonly, plan, apply
+akan workflow list                    # MCP 없이 같은 워크플로: list, explain, plan, apply
+akan guideline show ssrRule
+akan context --format json
+akan doctor --strict --format json
+akan quality ssr
+akan repair generated
+```
+
+새 워크스페이스에는 규칙과 MCP 서버가 이미 설치돼 있습니다. MCP 서버는 `readonly` 모드에서 읽기만 하고, `plan`
+모드에서 워크플로를 계획하며, `mcp-install`이 등록하는 `apply` 모드에서는 계획을 적용하고 검증과 수리 도구까지
+실행합니다. 에이전트는 워크플로를 거쳐 코드를 고치므로 워크스페이스 규칙을 우회하지 않고 따릅니다. `akan code`는
+같은 규칙, 워크플로, 스킬 위에서 일하는 터미널 에이전트입니다.
+
+## Akan Cloud
+
+```bash
+akan login           # Akan Cloud에 로그인
+akan tunnel <app>    # 실행 중인 앱을 공개 URL로 공유
+akan build <app>     # Akan Cloud가 돌릴 프로덕션 결과물 빌드
+```
+
+## 패키지 유지보수
+
+프레임워크 메인테이너는 같은 실행 파일로 Akan 패키지를 빌드하고 검증합니다.
 
 ```bash
 akan build-package akanjs
@@ -49,23 +103,24 @@ 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`를 우선 사용합니다.
+Akan 프레임워크 패키지는 `dist/pkgs/*`에서만 배포합니다. `verify-akan-publish-packages`는 빌드된 패키지에
+`npm pack --dry-run --json`을 실행해 `deploy-akan`이나 로컬 레지스트리 스모크 전에 맞아야 하는 메타데이터를
+확인합니다. 저장소 릴리스에서는 `bun run release:build-packages && bun run release:verify-packages`를 쓰세요. CLI
+패키지 결과물이 마지막에 빌드되어 루트 `akan` 부트스트랩 스크립트가 덮어쓰지 않습니다.
 
 ## 패키지 경계
 
-- 애플리케이션과 런타임 코드는 `akanjs`를 사용합니다.
-- 사용자-facing 실행 패키지는 `@akanjs/cli`입니다.
-- `@akanjs/devkit`은 published CLI 사용을 위해 CLI 안에 번들링됩니다. 일반 CLI 사용자가 별도의
-  runtime dependency로 설치할 필요는 없습니다.
+- 애플리케이션과 런타임 코드에서는 `akanjs`를 사용합니다.
+- 사용자용 실행 파일 패키지는 `@akanjs/cli`입니다.
+- `@akanjs/devkit`은 배포된 CLI 안에 번들되므로, 일반 CLI 사용자는 따로 설치할 필요가 없습니다.
+- `akan code` 에이전트도 같은 경계를 따릅니다. 엔진, 도구, 스킬은 devkit facet(`@akanjs/devkit/codeAgent`)이고,
+  `@akanjs/cli/code`는 터미널 호스트이자 둘을 다시 내보내는 SDK 진입점입니다.
 
 ## 요구사항
 
 - [Bun](https://bun.sh) `>=1.4.0`
-- TypeScript 기반 Akan 워크스페이스
+- TypeScript Akan 워크스페이스
+- 네이티브 빌드: Xcode(iOS), Android SDK와 JDK 21(Android), Rust(데스크톱)
 
 ## 라이선스
 

package/README.md

@@ -1,16 +1,19 @@
 # @akanjs/cli
 
-[Docs](https://akanjs.com/docs) | [npm](https://www.npmjs.com/package/@akanjs/cli) | [Runtime](https://www.npmjs.com/package/akanjs)
+[한국어](https://github.com/akan-team/akanjs/blob/main/pkgs/@akanjs/cli/README.ko.md) | [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.
+The `akan` command for [Akan.js](https://akanjs.com), the TypeScript framework with agents included.
 
-`@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.
+`akan` creates, runs, builds, tests and ships Akan workspaces — web, iOS, Android and desktop apps from one
+codebase — and gives coding agents the rules and tools they work through. It is Bun-first and bundles the Akan
+development tooling, so application runtimes depend only on the smaller `akanjs` package.
 
 ## Install
 
-Create a new workspace:
+Starting with Claude Code or Codex? Paste the prompt from the
+[quick start](https://akanjs.com/docs/intro/quickstart) and the agent sets the workspace up for you.
+
+From a terminal:
 
 ```bash
 bunx create-akan-workspace@latest
@@ -19,40 +22,76 @@ bunx create-akan-workspace@latest
 Or install the CLI globally:
 
 ```bash
-bun install -g @akanjs/cli@latest
+bun install -g @akanjs/cli
 akan --help
 ```
 
-## Common Commands
+## Everyday Commands
 
 ```bash
-akan create-workspace <workspace-name>
-akan start <app-name>
-akan build <app-name>
-akan test <app-or-lib-or-pkg>
+akan create-workspace <workspace> --app <app>
+akan create-application <app>
+akan create-library <lib>
+akan create-module <module>
+akan create-scalar <scalar>
+akan start <app> --open
+akan build <app>
+akan typecheck <app>
 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>
+akan test <app-or-lib-or-pkg>
+akan logs <app>
+akan update
+```
+
+- `akan start` takes several apps (`akan start a,b`, or `all`) and opens a full-screen view with a log per app.
+  `--plain` prints prefixed lines instead, `--kill` frees the dev ports first, and `--share` puts each app on a
+  public URL. Every session also writes `local/apps/<app>/runtime/dev.log`.
+- `akan logs <app>` tails a running server, filtered by `--level`, `--grep`, `--endpoint`, `--trace` or `--origin`.
+
+## Native Apps
+
+```bash
+akan start-ios <app>        # also start-android, start-desktop
+akan build-ios <app>        # also build-android, build-desktop
+akan release-ios <app>      # also release-android
+akan update-keygen <app>
+akan publish-update <app>
 ```
 
-## Agent And MCP Commands
+iOS, Android, macOS, Windows and Linux apps are built from the app's CSR bundle on the Akan native runtime,
+configured in the `native` section of `akan.config.ts`.
+
+## For Coding Agents
+
+```bash
+akan code "add a due date to tasks"   # the terminal coding agent
+akan agent install all                # AGENTS.md, CLAUDE.md and Cursor rules
+akan mcp-install all                  # register the Akan MCP server for Cursor, Claude Code and Codex
+akan mcp --mode plan                  # the MCP server over stdio: readonly, plan or apply
+akan workflow list                    # the same workflows without MCP: list, explain, plan, apply
+akan guideline show ssrRule
+akan context --format json
+akan doctor --strict --format json
+akan quality ssr
+akan repair generated
+```
+
+A new workspace already has the rules and the MCP server installed. The MCP server reads in `readonly` mode,
+plans workflows in `plan` mode, and in `apply` mode — the mode `mcp-install` registers — applies a plan, runs
+validation and the repair tools. An agent changes code through the workflows, so it follows the workspace's rules
+instead of routing around them. `akan code` is a terminal agent built on the same rules, workflows and skills.
+
+## Akan Cloud
 
 ```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
+akan login           # sign in to Akan Cloud
+akan tunnel <app>    # share a running app on a public URL
+akan build <app>     # build the production artifact Akan Cloud runs
 ```
 
-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
 
-Package maintenance commands are also exposed through the same executable:
+Framework maintainers build and verify the Akan packages through the same executable:
 
 ```bash
 akan build-package akanjs
@@ -74,11 +113,15 @@ artifact is built last and is not overwritten by the root `akan` bootstrap scrip
 - 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
+- For native builds: Xcode (iOS), the Android SDK and JDK 21 (Android), or Rust (desktop)
 
 ## License
 

package/TunnelShare-cwh9ezsm.js

@@ -0,0 +1,9 @@
+// @bun
+import {
+  TunnelShare2
+} from "./index-2wc41k5w.js";
+import"./index-94s080qm.js";
+import"./index-52w0fvh8.js";
+export {
+  TunnelShare2 as TunnelShare
+};

package/{agent.command-0q17pnrs.js → agent.command-gn73rhe7.js}

@@ -2,17 +2,16 @@
 import {
   Workspace,
   command
-} from "./index-0g7r8xz3.js";
-import"./index-q0y2jq9j.js";
-import"./index-2tv3fdx4.js";
-import"./index-6wwzs1bc.js";
-import"./index-by5gpp8x.js";
-import"./index-gyd220p2.js";
-import"./index-ktb5njgy.js";
-import"./index-h7yw2z9n.js";
+} from "./index-vpj42xwt.js";
+import"./index-52w0fvh8.js";
+import"./index-3w94e7n3.js";
+import"./index-hj6w4ka1.js";
+import"./index-y3mphr1m.js";
+import"./index-9z771ptz.js";
+import"./index-zzvvc845.js";
 import {
   AgentScript
-} from "./index-k2j1hc4r.js";
+} from "./index-wprnsjms.js";
 
 // pkgs/@akanjs/cli/agent/agent.command.ts
 class AgentCommand extends command("agent", [AgentScript], ({ public: target }) => ({

package/akanCode.js

@@ -0,0 +1,102 @@
+// @bun
+import {
+  AkanEditScope2,
+  DevLogFeedback2,
+  PreviewChrome2,
+  PreviewView2,
+  PreviewFeedback2,
+  TurnFeedback2,
+  AkanCli2,
+  AkanVerifier2,
+  VerifyFeedback2,
+  AkanToolPack2,
+  MailToolPack2,
+  McpUnauthorized2,
+  McpClient2,
+  McpToolPack2,
+  SessionToolPack2,
+  WebToolPack2,
+  AkanCodePlugins2,
+  AkanEnvKeys2,
+  akanSystemPrompt2,
+  CodeSessionIndex2,
+  AkanCodeServices2,
+  CodeAgentAsks2,
+  CodeAgentEventMapper2,
+  CodeAgentGate2,
+  CodeAgentUi2,
+  CodeMailbox2,
+  CodeSessionFork2,
+  CodeAgent2
+} from "./index-0wpybxtr.js";
+import {
+  akanCodeDefaultModel2,
+  akanCodeModel2,
+  akanCodeModelSupportsImages2,
+  akanCodeModelWarnings2,
+  CodeAgentStreamPrinter2
+} from "./index-c6eggbee.js";
+import {
+  SubagentPool2,
+  akanCodePaths2
+} from "./index-tqm7jjcn.js";
+import"./index-7md2g9vw.js";
+import {
+  CodeAgentRpcHost2
+} from "./index-d2242ksy.js";
+import {
+  CodeTuiLines2,
+  CodeTuiAgents2,
+  CodeTuiClipboard2,
+  CodeTuiCommands2,
+  CodeTuiEditor2,
+  CodeTuiFiles2,
+  CodeTuiMarkdown2,
+  CodeTuiParts2
+} from "./index-wa5jbxj1.js";
+export {
+  AkanCli2 as AkanCli,
+  AkanCodePlugins2 as AkanCodePlugins,
+  AkanCodeServices2 as AkanCodeServices,
+  AkanEditScope2 as AkanEditScope,
+  AkanEnvKeys2 as AkanEnvKeys,
+  AkanToolPack2 as AkanToolPack,
+  AkanVerifier2 as AkanVerifier,
+  CodeAgent2 as CodeAgent,
+  CodeAgentAsks2 as CodeAgentAsks,
+  CodeAgentEventMapper2 as CodeAgentEventMapper,
+  CodeAgentGate2 as CodeAgentGate,
+  CodeAgentRpcHost2 as CodeAgentRpcHost,
+  CodeAgentStreamPrinter2 as CodeAgentStreamPrinter,
+  CodeAgentUi2 as CodeAgentUi,
+  CodeMailbox2 as CodeMailbox,
+  CodeSessionFork2 as CodeSessionFork,
+  CodeSessionIndex2 as CodeSessionIndex,
+  CodeTuiAgents2 as CodeTuiAgents,
+  CodeTuiClipboard2 as CodeTuiClipboard,
+  CodeTuiCommands2 as CodeTuiCommands,
+  CodeTuiEditor2 as CodeTuiEditor,
+  CodeTuiFiles2 as CodeTuiFiles,
+  CodeTuiLines2 as CodeTuiLines,
+  CodeTuiMarkdown2 as CodeTuiMarkdown,
+  CodeTuiParts2 as CodeTuiParts,
+  DevLogFeedback2 as DevLogFeedback,
+  MailToolPack2 as MailToolPack,
+  McpClient2 as McpClient,
+  McpToolPack2 as McpToolPack,
+  McpUnauthorized2 as McpUnauthorized,
+  PreviewChrome2 as PreviewChrome,
+  PreviewFeedback2 as PreviewFeedback,
+  PreviewView2 as PreviewView,
+  SessionToolPack2 as SessionToolPack,
+  SubagentPool2 as SubagentPool,
+  TurnFeedback2 as TurnFeedback,
+  VerifyFeedback2 as VerifyFeedback,
+  WebToolPack2 as WebToolPack,
+  akanCodeDefaultModel2 as akanCodeDefaultModel,
+  akanCodeModel2 as akanCodeModel,
+  akanCodeModelSupportsImages2 as akanCodeModelSupportsImages,
+  akanCodeModelWarnings2 as akanCodeModelWarnings,
+  akanCodePaths2 as akanCodePaths,
+  akanSystemPrompt2 as akanSystemPrompt
+};