@chrisluyi/daas-cli 1.2.0 → 1.3.0

package/README.md

@@ -0,0 +1,405 @@
+# daas-cli
+
+Zero-config build/dev/test CLI for React micro-frontend (MFE) apps using [rsbuild](https://rsbuild.dev) + [Module Federation 2](https://module-federation.io).
+
+MFE apps have **no build config files** — no `rsbuild.config.ts`, no `vitest.config.ts`. The CLI owns all of it.
+
+---
+
+## Packages
+
+| Package | Version | Description |
+|---|---|---|
+| [`@chrisluyi/daas-cli`](https://www.npmjs.com/package/@chrisluyi/daas-cli) | 1.1.0 | CLI binary — install this as your only devDependency |
+| [`@chrisluyi/rsbuild-config`](https://www.npmjs.com/package/@chrisluyi/rsbuild-config) | 1.1.0 | rsbuild config factory + vitest config — arrives transitively |
+| [`@chrisluyi/template`](https://www.npmjs.com/package/@chrisluyi/template) | 1.0.0 | MFE scaffold templates (services / containers / components structure) |
+
+---
+
+## Quickstart (3 commands)
+
+```bash
+mkdir my-mfe && cd my-mfe
+echo '{"name":"my-mfe"}' > package.json
+npx @chrisluyi/daas-cli init
+bun install
+daas dev
+```
+
+Your MFE is now running at `http://localhost:3000` with Module Federation 2, React, hot-reload, and Vitest — zero config required.
+
+---
+
+## Installation
+
+```bash
+# In your MFE project
+bun add -D @chrisluyi/daas-cli
+
+# or npm
+npm install -D @chrisluyi/daas-cli
+```
+
+`daas-cli` is the **only** devDependency you need. It ships rsbuild, vitest, @testing-library/react, happy-dom, and all tooling as its own dependencies. Do not install these separately.
+
+---
+
+## Commands
+
+```
+daas init [--template default]
+daas dev  [target] [--port <n>] [--json]
+daas build [target] [--json]
+daas test  [--json]
+daas info  [--json]
+```
+
+### `daas init`
+
+Interactive scaffold powered by `@clack/prompts`. Prompts for remote config URL, port, and app name, then writes starter files.
+
+```
+┌  daas-cli — scaffold new MFE
+│
+◇  Remote config URL?
+│  https://your-org.example.com/daas-config.json
+│
+◇  Dev server port?
+│  3001
+│
+◇  App name? (leave blank to use package.json name)
+│  mfe-auth
+│
+◇  Does this app expose additional components beyond ./App?
+│  No
+│
+◆  Scaffolding mfe-auth...
+│  ✓ Created src/App.tsx
+│  ✓ Created src/App.test.tsx
+│  ✓ Created tsconfig.json
+│  ✓ Updated package.json
+│
+└  Done! Run: bun install && daas dev
+```
+
+**What gets created (minimal scaffold):**
+
+```
+src/
+├── App.tsx           # minimal React component
+└── App.test.tsx      # smoke test
+tsconfig.json         # jsx: react-jsx, strict mode
+package.json          # scripts + daas config injected
+```
+
+**`--template default`** scaffolds the full opinionated structure:
+
+```
+src/
+├── App.tsx                         # entry — renders AppContainer
+├── containers/
+│   └── AppContainer.tsx            # data-fetching component
+├── components/
+│   └── App.tsx                     # presentational component
+├── services/
+│   └── index.ts                    # service layer stub
+└── config/
+    ├── regions/                    # per-region config (for v1.5 targets)
+    ├── platforms/                  # per-platform config
+    └── products/                   # per-product config
+```
+
+### `daas dev`
+
+Starts the rsbuild dev server with HMR and Module Federation 2 in remote mode.
+
+```bash
+daas dev                  # uses port from package.json#daas
+daas dev --port 3002      # override port at runtime
+daas dev sg-foo-mb-dev    # v1.5: activate region/product/platform target
+```
+
+### `daas build`
+
+Production build to `./dist`. Always fetches fresh remote config — fatal if network unavailable.
+
+```bash
+daas build
+daas build sg-foo-mb-prod   # v1.5: build for a specific target
+daas build --json           # machine-readable output (for CI / AI agents)
+```
+
+### `daas test`
+
+Runs Vitest with `happy-dom`, `@testing-library/react`, and `@testing-library/jest-dom` pre-configured. The following browser APIs are mocked automatically so MFE tests work without any extra setup:
+
+- `window.matchMedia`
+- `ResizeObserver`
+- `IntersectionObserver`
+- `window.scrollTo` / `scrollBy`
+- `URL.createObjectURL` / `revokeObjectURL`
+
+```bash
+daas test
+daas test --json
+```
+
+**Writing tests** — import everything from `@chrisluyi/daas-cli/test` (no direct vitest or `@testing-library` imports needed):
+
+```tsx
+import { render, screen, describe, test, expect, userEvent } from "@chrisluyi/daas-cli/test"
+import MyComponent from "./MyComponent"
+
+describe("MyComponent", () => {
+  test("renders a button", async () => {
+    render(<MyComponent />)
+    await userEvent.click(screen.getByRole("button"))
+    expect(screen.getByText("Clicked!")).toBeInTheDocument()
+  })
+})
+```
+
+**Adding extra setup** — append your own setup files after the built-in mocks via `package.json#daas.setupFiles`:
+
+```json
+{
+  "daas": {
+    "configUrl": "...",
+    "port": 3001,
+    "setupFiles": ["./src/test-setup.ts"]
+  }
+}
+```
+
+Your setup file can override any of the default mocks or add new ones.
+
+### `daas info`
+
+Prints the fully resolved project state — useful for debugging and AI agent diagnosis.
+
+```bash
+daas info --json
+```
+
+Example output:
+
+```json
+{
+  "ok": true,
+  "command": "info",
+  "cliVersion": "1.1.0",
+  "appName": "mfe-auth",
+  "port": 3001,
+  "configUrl": "https://your-org.example.com/daas-config.json",
+  "manifest": {
+    "name": "mfe-auth",
+    "exposes": { "./App": "./src/App" }
+  },
+  "remoteJson": {
+    "version": "1.0.0",
+    "minCliVersion": "1.0.0",
+    "shared": { "react": "18.3.1", "react-dom": "18.3.1" },
+    "rsbuildConfigVersion": 1
+  },
+  "isMonorepo": false
+}
+```
+
+---
+
+## Per-App Config (`package.json#daas`)
+
+All MFE-specific configuration lives in `package.json`:
+
+```json
+{
+  "name": "mfe-auth",
+  "scripts": {
+    "dev": "daas dev",
+    "build": "daas build",
+    "test": "daas test"
+  },
+  "devDependencies": {
+    "@chrisluyi/daas-cli": "^1.1.0"
+  },
+  "daas": {
+    "configUrl": "https://your-org.example.com/daas-config.json",
+    "port": 3001,
+    "coverage": {
+      "lines": 80,
+      "branches": 80
+    }
+  }
+}
+```
+
+| Field | Required | Description |
+|---|---|---|
+| `configUrl` | Yes | URL of the remote JSON config owned by your platform team |
+| `port` | Yes | Dev server port — must be unique per MFE in a monorepo |
+| `coverage` | No | Vitest coverage thresholds |
+| `setupFiles` | No | Extra Vitest setup files appended after the built-in browser mocks |
+
+---
+
+## Optional Manifest (`mf.manifest.json`)
+
+Only needed when exposing more than just `./App`:
+
+```json
+{
+  "name": "mfe-auth",
+  "exposes": {
+    "./App": "./src/App",
+    "./LoginButton": "./src/components/LoginButton"
+  }
+}
+```
+
+If absent, `name` derives from `package.json#name` (scope stripped), and `exposes` defaults to `{ "./App": "./src/App" }`.
+
+---
+
+## Remote JSON (served by your platform team)
+
+The URL in `configUrl` must serve a JSON file like this:
+
+```json
+{
+  "version": "1.0.0",
+  "minCliVersion": "1.0.0",
+  "releaseNotesUrl": "https://your-org.example.com/daas-cli/releases",
+  "shared": {
+    "react": "18.3.1",
+    "react-dom": "18.3.1"
+  },
+  "rsbuildConfigVersion": 1
+}
+```
+
+This controls which version of shared dependencies all your MFEs use via Module Federation 2's singleton negotiation. The CLI fetches this at dev startup (5-min cache) and always fresh at build time.
+
+---
+
+## Monorepo Support
+
+`daas init` detects monorepos by walking parent directories for `bun.lockb` or `package.json#workspaces`. In a monorepo:
+
+- `daas-cli` is **not** added to the app's `devDependencies` (it's resolved from the workspace root)
+- Each MFE has its own `port` in `package.json#daas`
+
+```
+my-monorepo/
+├── package.json          # workspaces: ["packages/*"]
+├── bun.lockb
+└── packages/
+    ├── mfe-auth/         # daas dev → port 3001
+    │   └── package.json  # { "daas": { "port": 3001, ... } }
+    └── mfe-dashboard/    # daas dev → port 3002
+        └── package.json  # { "daas": { "port": 3002, ... } }
+```
+
+---
+
+## v1.5 — Multi-Region Target System
+
+Target strings let you select region/product/platform/environment at dev and build time:
+
+```
+daas dev sg-foo-mb-dev
+         │   │   │  └─ environment (dev / staging / prod)
+         │   │   └──── platform    (mb = mobile, wb = web, etc.)
+         │   └──────── product     (may contain hyphens)
+         └──────────── region      (sg, us, eu, …)
+```
+
+When a target is provided:
+1. The CLI resolves a `TargetContext` from the string
+2. `tsconfig.daas.json` is generated (gitignored) with path aliases:
+   - `@region-config` → `./src/config/regions/<region>`
+   - `@platform-config` → `./src/config/platforms/<platform>`
+   - `@product-config` → `./src/config/products/<product>`
+3. Environment variables are injected at build time: `DAAS_REGION`, `DAAS_PRODUCT`, `DAAS_PLATFORM`, `DAAS_ENV`
+
+Use `daas init --template default` to scaffold the config layer folder structure.
+
+---
+
+## Exit Codes
+
+| Code | Meaning | What to do |
+|---|---|---|
+| `0` | Success | — |
+| `1` | General error (build/test failure) | Check output above the JSON |
+| `2` | Config error (missing `configUrl`, bad manifest) | Run `daas init` or fix `package.json#daas` |
+| `3` | CLI too old (`minCliVersion` not met) | Upgrade `@chrisluyi/daas-cli` |
+| `4` | Remote JSON fetch failed | Check network / VPN (only fatal in `build`) |
+| `5` | Config version mismatch | Upgrade `@chrisluyi/daas-cli` |
+
+---
+
+## `--json` Output Contract
+
+All commands except `init` support `--json` — always use this in CI and AI agent workflows.
+
+**Success:**
+```json
+{
+  "ok": true,
+  "command": "build",
+  "appName": "mfe-auth",
+  "output": "./dist",
+  "cliVersion": "1.1.0"
+}
+```
+
+**Error:**
+```json
+{
+  "ok": false,
+  "command": "build",
+  "exitCode": 4,
+  "error": "Could not fetch remote config: HTTP 503",
+  "suggestion": "Check network connectivity or VPN.",
+  "cliVersion": "1.1.0"
+}
+```
+
+---
+
+## AI Agent Support (Claude Code)
+
+Register the bundled skill so Claude Code understands `daas-cli` without hallucinating commands:
+
+```bash
+# Per-project
+mkdir -p .claude/skills
+cp node_modules/@chrisluyi/daas-cli/skill.md .claude/skills/daas-cli.md
+
+# Or globally
+cp node_modules/@chrisluyi/daas-cli/skill.md ~/.claude/skills/daas-cli.md
+```
+
+**AI agent workflow:**
+
+```bash
+# 1. Always start here to understand current state
+daas info --json
+
+# 2. Run commands and parse stdout JSON
+daas build --json
+# { "ok": true, ... }  or  { "ok": false, "exitCode": N, "error": "...", "suggestion": "..." }
+```
+
+---
+
+## Development (this repo)
+
+```bash
+bun install
+bun test          # run all tests
+bun run build     # build both packages to dist/
+bun run lint      # biome check
+```
+
+See [`docs/DEVELOPMENT.md`](docs/DEVELOPMENT.md) for the full release workflow.

package/dist/index.js

@@ -2311,12 +2311,12 @@ async function runMain(cmd, opts = {}) {
   }
 }
 
-// src/commands/dev.ts
-import { createRsbuild } from "@rsbuild/core";
+// src/commands/build.ts
 import { createConfig } from "@chrisluyi/rsbuild-config";
+import { createRsbuild } from "@rsbuild/core";
 
 // src/daas-config.ts
-import { readFileSync, existsSync } from "fs";
+import { existsSync, readFileSync } from "fs";
 import { resolve } from "path";
 
 class ConfigError extends Error {
@@ -2344,7 +2344,7 @@ function readDaasConfig(cwd = process.cwd()) {
 }
 
 // src/manifest.ts
-import { readFileSync as readFileSync2, existsSync as existsSync2 } from "fs";
+import { existsSync as existsSync2, readFileSync as readFileSync2 } from "fs";
 import { resolve as resolve2 } from "path";
 
 class ManifestError extends Error {
@@ -2387,6 +2387,33 @@ function stripScope(name) {
   return name.replace(/^@[^/]+\//, "");
 }
 
+// src/output.ts
+function formatSuccess(command, data) {
+  return { ok: true, command, cliVersion: getCliVersion(), ...data };
+}
+function formatError(command, exitCode, error, suggestion) {
+  return {
+    ok: false,
+    command,
+    exitCode,
+    error,
+    suggestion,
+    cliVersion: getCliVersion()
+  };
+}
+function writeJsonSuccess(command, data) {
+  process.stdout.write(`${JSON.stringify(formatSuccess(command, data))}
+`);
+}
+function writeJsonError(command, exitCode, error, suggestion) {
+  process.stdout.write(`${JSON.stringify(formatError(command, exitCode, error, suggestion))}
+`);
+  process.exit(exitCode);
+}
+function getCliVersion() {
+  return process.env.DAAS_CLI_VERSION ?? "0.0.0";
+}
+
 // src/remote-config.ts
 import { SUPPORTED_CONFIG_VERSION } from "@chrisluyi/rsbuild-config";
 // src/fallback-config.json
@@ -2498,34 +2525,15 @@ function generateTsconfigDaas(cwd, target) {
     extends: "./tsconfig.json",
     compilerOptions: {
       paths: {
-        "@region-config": [`./src/config/regions/${target.region}`],
+        "@region-config": [`./src/config/regions/${target.region}/config`],
         "@platform-config": [`./src/config/platforms/${target.platform}`],
-        "@product-config": [`./src/config/products/${target.product}`]
+        "@product-config": [`./src/config/products/${target.product}`],
+        "@regional": [`./src/config/regions/${target.region}/index`]
       }
     }
   };
-  writeFileSync(resolve3(cwd, "tsconfig.daas.json"), JSON.stringify(content, null, 2) + `
-`);
-}
-
-// src/output.ts
-function formatSuccess(command, data) {
-  return { ok: true, command, cliVersion: getCliVersion(), ...data };
-}
-function formatError(command, exitCode, error, suggestion) {
-  return { ok: false, command, exitCode, error, suggestion, cliVersion: getCliVersion() };
-}
-function writeJsonSuccess(command, data) {
-  process.stdout.write(JSON.stringify(formatSuccess(command, data)) + `
-`);
-}
-function writeJsonError(command, exitCode, error, suggestion) {
-  process.stdout.write(JSON.stringify(formatError(command, exitCode, error, suggestion)) + `
+  writeFileSync(resolve3(cwd, "tsconfig.daas.json"), `${JSON.stringify(content, null, 2)}
 `);
-  process.exit(exitCode);
-}
-function getCliVersion() {
-  return process.env.DAAS_CLI_VERSION ?? "0.0.0";
 }
 
 // src/types.ts
@@ -2538,78 +2546,20 @@ var EXIT_CODES = {
   CONFIG_VERSION_MISMATCH: 5
 };
 
-// src/commands/dev.ts
-var devCommand = defineCommand({
-  meta: { name: "dev", description: "Start MFE dev server" },
-  args: {
-    target: { type: "positional", description: "Build target (e.g. sg-foo-mb-dev)", required: false },
-    port: { type: "string", description: "Override dev server port" },
-    json: { type: "boolean", default: false, description: "Machine-readable JSON output" }
-  },
-  async run({ args }) {
-    try {
-      const daasConfig = readDaasConfig();
-      const manifest = readManifest();
-      const remoteMeta = await fetchRemoteConfig(daasConfig.configUrl, false);
-      checkCliVersion(remoteMeta);
-      const versionOk = checkConfigVersion(remoteMeta, false);
-      if (!versionOk) {
-        consola.warn("Config version mismatch \u2014 update daas-cli for full compatibility");
-      }
-      const port = args.port ? Number(args.port) : daasConfig.port;
-      const target = args.target ? parseTarget(args.target) : undefined;
-      if (target) {
-        generateTsconfigDaas(process.cwd(), target);
-        consola.info(`Target: ${args.target} (region=${target.region}, product=${target.product}, platform=${target.platform}, env=${target.environment})`);
-      }
-      const config = createConfig(manifest, remoteMeta, { mode: "development", port, target });
-      consola.start(`Starting ${manifest.name} dev server...`);
-      const rsbuild = await createRsbuild({ rsbuildConfig: config });
-      const server = await rsbuild.createDevServer();
-      await server.listen();
-      consola.success(`Ready on http://localhost:${port}`);
-    } catch (e2) {
-      handleError("dev", e2, args.json);
-    }
-  }
-});
-function handleError(command, e2, json) {
-  if (e2 instanceof CliVersionError) {
-    if (json)
-      writeJsonError(command, EXIT_CODES.CLI_TOO_OLD, e2.message, "Update daas-cli to the required version.");
-    consola.fatal(e2.message);
-    process.exit(EXIT_CODES.CLI_TOO_OLD);
-  }
-  if (e2 instanceof FetchError) {
-    if (json)
-      writeJsonError(command, EXIT_CODES.REMOTE_FETCH_FAILED, e2.message, "Check network or VPN.");
-    consola.warn(`Remote config unavailable \u2014 using fallback. ${e2.message}`);
-    process.exit(EXIT_CODES.REMOTE_FETCH_FAILED);
-  }
-  if (e2 instanceof TargetParseError) {
-    if (json)
-      writeJsonError(command, EXIT_CODES.CONFIG_ERROR, e2.message, "Check target format: {region}-{product}-{platform}-{environment}");
-    consola.fatal(e2.message);
-    process.exit(EXIT_CODES.CONFIG_ERROR);
-  }
-  if (e2 instanceof ConfigError || e2 instanceof ManifestError) {
-    if (json)
-      writeJsonError(command, EXIT_CODES.CONFIG_ERROR, e2.message, "Run daas init first.");
-    consola.fatal(e2.message);
-    process.exit(EXIT_CODES.CONFIG_ERROR);
-  }
-  consola.fatal(e2);
-  process.exit(EXIT_CODES.GENERAL_ERROR);
-}
-
 // src/commands/build.ts
-import { createRsbuild as createRsbuild2 } from "@rsbuild/core";
-import { createConfig as createConfig2 } from "@chrisluyi/rsbuild-config";
 var buildCommand = defineCommand({
   meta: { name: "build", description: "Build MFE for production" },
   args: {
-    target: { type: "positional", description: "Build target (e.g. sg-foo-mb-prod)", required: false },
-    json: { type: "boolean", default: false, description: "Machine-readable JSON output" }
+    target: {
+      type: "positional",
+      description: "Build target (e.g. sg-foo-mb-prod)",
+      required: false
+    },
+    json: {
+      type: "boolean",
+      default: false,
+      description: "Machine-readable JSON output"
+    }
   },
   async run({ args }) {
     const json = args.json;
@@ -2624,8 +2574,11 @@ var buildCommand = defineCommand({
       const target = args.target ? parseTarget(args.target) : undefined;
       if (target)
         generateTsconfigDaas(process.cwd(), target);
-      const config = createConfig2(manifest, remoteMeta, { mode: "production", target });
-      const rsbuild = await createRsbuild2({ rsbuildConfig: config });
+      const config = createConfig(manifest, remoteMeta, {
+        mode: "production",
+        target
+      });
+      const rsbuild = await createRsbuild({ rsbuildConfig: config });
       await rsbuild.build();
       if (json)
         writeJsonSuccess("build", { appName: manifest.name, output: "./dist" });
@@ -2667,41 +2620,87 @@ var buildCommand = defineCommand({
   }
 });
 
-// src/commands/test.ts
-import { startVitest } from "vitest/node";
-import { createVitestConfig } from "@chrisluyi/rsbuild-config/vitest";
-var testCommand = defineCommand({
-  meta: { name: "test", description: "Run MFE tests" },
+// src/commands/dev.ts
+import { createConfig as createConfig2 } from "@chrisluyi/rsbuild-config";
+import { createRsbuild as createRsbuild2 } from "@rsbuild/core";
+var devCommand = defineCommand({
+  meta: { name: "dev", description: "Start MFE dev server" },
   args: {
-    json: { type: "boolean", default: false, description: "Machine-readable JSON output" }
+    target: {
+      type: "positional",
+      description: "Build target (e.g. sg-foo-mb-dev)",
+      required: false
+    },
+    port: { type: "string", description: "Override dev server port" },
+    json: {
+      type: "boolean",
+      default: false,
+      description: "Machine-readable JSON output"
+    }
   },
   async run({ args }) {
-    const json = args.json;
     try {
-      const manifest = readManifest();
       const daasConfig = readDaasConfig();
-      const config = createVitestConfig(manifest, { coverage: daasConfig.coverage, setupFiles: daasConfig.setupFiles });
-      const vitest = await startVitest("test", [], config);
-      const failed = vitest?.state.getFiles().some((f3) => f3.result?.state === "fail") ?? false;
-      if (json) {
-        if (failed)
-          writeJsonError("test", EXIT_CODES.GENERAL_ERROR, "Tests failed", "Check test output above");
-        writeJsonSuccess("test", { appName: manifest.name, passed: !failed });
+      const manifest = readManifest();
+      const remoteMeta = await fetchRemoteConfig(daasConfig.configUrl, false);
+      checkCliVersion(remoteMeta);
+      const versionOk = checkConfigVersion(remoteMeta, false);
+      if (!versionOk) {
+        consola.warn("Config version mismatch \u2014 update daas-cli for full compatibility");
       }
-      if (failed)
-        process.exit(EXIT_CODES.GENERAL_ERROR);
+      const port = args.port ? Number(args.port) : daasConfig.port;
+      const target = args.target ? parseTarget(args.target) : undefined;
+      if (target) {
+        generateTsconfigDaas(process.cwd(), target);
+        consola.info(`Target: ${args.target} (region=${target.region}, product=${target.product}, platform=${target.platform}, env=${target.environment})`);
+      }
+      const config = createConfig2(manifest, remoteMeta, {
+        mode: "development",
+        port,
+        target
+      });
+      consola.start(`Starting ${manifest.name} dev server...`);
+      const rsbuild = await createRsbuild2({ rsbuildConfig: config });
+      const server = await rsbuild.createDevServer();
+      await server.listen();
+      consola.success(`Ready on http://localhost:${port}`);
     } catch (e2) {
-      if (json)
-        writeJsonError("test", EXIT_CODES.GENERAL_ERROR, e2.message, "Check test configuration");
-      consola.fatal(e2);
-      process.exit(EXIT_CODES.GENERAL_ERROR);
+      handleError("dev", e2, args.json);
     }
   }
 });
+function handleError(command, e2, json) {
+  if (e2 instanceof CliVersionError) {
+    if (json)
+      writeJsonError(command, EXIT_CODES.CLI_TOO_OLD, e2.message, "Update daas-cli to the required version.");
+    consola.fatal(e2.message);
+    process.exit(EXIT_CODES.CLI_TOO_OLD);
+  }
+  if (e2 instanceof FetchError) {
+    if (json)
+      writeJsonError(command, EXIT_CODES.REMOTE_FETCH_FAILED, e2.message, "Check network or VPN.");
+    consola.warn(`Remote config unavailable \u2014 using fallback. ${e2.message}`);
+    process.exit(EXIT_CODES.REMOTE_FETCH_FAILED);
+  }
+  if (e2 instanceof TargetParseError) {
+    if (json)
+      writeJsonError(command, EXIT_CODES.CONFIG_ERROR, e2.message, "Check target format: {region}-{product}-{platform}-{environment}");
+    consola.fatal(e2.message);
+    process.exit(EXIT_CODES.CONFIG_ERROR);
+  }
+  if (e2 instanceof ConfigError || e2 instanceof ManifestError) {
+    if (json)
+      writeJsonError(command, EXIT_CODES.CONFIG_ERROR, e2.message, "Run daas init first.");
+    consola.fatal(e2.message);
+    process.exit(EXIT_CODES.CONFIG_ERROR);
+  }
+  consola.fatal(e2);
+  process.exit(EXIT_CODES.GENERAL_ERROR);
+}
 
 // src/init/monorepo.ts
 import { existsSync as existsSync3, readFileSync as readFileSync3 } from "fs";
-import { resolve as resolve4, dirname } from "path";
+import { dirname, resolve as resolve4 } from "path";
 function detectMonorepo(startDir) {
   let dir = startDir;
   for (let i2 = 0;i2 < 10; i2++) {
@@ -2727,7 +2726,11 @@ function detectMonorepo(startDir) {
 var infoCommand = defineCommand({
   meta: { name: "info", description: "Show resolved MFE project state" },
   args: {
-    json: { type: "boolean", default: false, description: "Machine-readable JSON output" }
+    json: {
+      type: "boolean",
+      default: false,
+      description: "Machine-readable JSON output"
+    }
   },
   async run({ args }) {
     const json = args.json;
@@ -2766,6 +2769,9 @@ var infoCommand = defineCommand({
 });
 
 // src/commands/init.ts
+import { existsSync as existsSync6, readFileSync as readFileSync5, writeFileSync as writeFileSync3 } from "fs";
+import { createRequire } from "module";
+import { resolve as resolve6 } from "path";
 import { scaffold } from "@chrisluyi/template";
 
 // ../../node_modules/.bun/@clack+core@0.3.5/node_modules/@clack/core/dist/index.mjs
@@ -3258,12 +3264,8 @@ var de = () => {
   return process.on("uncaughtExceptionMonitor", () => $2(2)), process.on("unhandledRejection", () => $2(2)), process.on("SIGINT", () => $2(1)), process.on("SIGTERM", () => $2(1)), process.on("exit", $2), { start: l3, stop: u3, message: m3 };
 };
 
-// src/commands/init.ts
-import { existsSync as existsSync6, readFileSync as readFileSync5, writeFileSync as writeFileSync3 } from "fs";
-import { resolve as resolve6 } from "path";
-
 // src/init/copy-template.ts
-import { existsSync as existsSync4, copyFileSync, mkdirSync, readdirSync } from "fs";
+import { copyFileSync, existsSync as existsSync4, mkdirSync, readdirSync } from "fs";
 import { dirname as dirname2, join } from "path";
 import { fileURLToPath } from "url";
 var __dirname2 = dirname2(fileURLToPath(import.meta.url));
@@ -3280,7 +3282,9 @@ async function copyTemplate(destDir) {
       mkdirSync(join(destDir, "src"), { recursive: true });
     }
     if (existsSync4(dest)) {
-      const overwrite = await se({ message: `${destFile} already exists. Overwrite?` });
+      const overwrite = await se({
+        message: `${destFile} already exists. Overwrite?`
+      });
       if (!overwrite) {
         result.skipped.push(destFile);
         continue;
@@ -3293,7 +3297,7 @@ async function copyTemplate(destDir) {
 }
 
 // src/init/package-json.ts
-import { readFileSync as readFileSync4, writeFileSync as writeFileSync2, existsSync as existsSync5 } from "fs";
+import { existsSync as existsSync5, readFileSync as readFileSync4, writeFileSync as writeFileSync2 } from "fs";
 import { resolve as resolve5 } from "path";
 function updatePackageJson(cwd, opts) {
   const pkgPath = resolve5(cwd, "package.json");
@@ -3304,6 +3308,17 @@ function updatePackageJson(cwd, opts) {
     build: "daas build",
     test: "daas test"
   };
+  pkg.dependencies = {
+    ...pkg.dependencies ?? {},
+    "@radix-ui/react-tabs": "^1.1.0",
+    ...opts.isFullTemplate ? {
+      "@chrisluyi/template": `^${opts.templateVersion ?? opts.cliVersion ?? "1.0.0"}`,
+      "@tanstack/react-query": "^5.0.0",
+      zustand: "^5.0.0",
+      immer: "^10.0.0",
+      zod: "^3.23.0"
+    } : {}
+  };
   if (!opts.isMonorepo) {
     pkg.devDependencies = {
       ...pkg.devDependencies ?? {},
@@ -3311,7 +3326,7 @@ function updatePackageJson(cwd, opts) {
     };
   }
   pkg.daas = { configUrl: opts.configUrl, port: opts.port };
-  writeFileSync2(pkgPath, JSON.stringify(pkg, null, 2) + `
+  writeFileSync2(pkgPath, `${JSON.stringify(pkg, null, 2)}
 `);
 }
 
@@ -3320,7 +3335,10 @@ var KNOWN_TEMPLATES = ["default"];
 var initCommand = defineCommand({
   meta: { name: "init", description: "Scaffold a new MFE app" },
   args: {
-    template: { type: "string", description: "Template name. Use 'default' for the full services/containers/components structure." }
+    template: {
+      type: "string",
+      description: "Template name. Use 'default' for the full services/containers/components structure."
+    }
   },
   async run({ args }) {
     if (!process.stdin.isTTY) {
@@ -3364,7 +3382,9 @@ var initCommand = defineCommand({
         appName,
         onConflict: async (relPath) => {
           s2.stop("");
-          const overwrite = await se({ message: `${relPath} already exists. Overwrite?` });
+          const overwrite = await se({
+            message: `${relPath} already exists. Overwrite?`
+          });
           s2.start(`Scaffolding ${appName}...`);
           return overwrite;
         }
@@ -3380,11 +3400,17 @@ var initCommand = defineCommand({
       s2.message(`\u2713 Created ${f4}`);
     for (const f4 of skipped)
       s2.message(`\u2014 Skipped ${f4} (kept existing)`);
-    updatePackageJson(cwd, { configUrl, port, isMonorepo });
+    updatePackageJson(cwd, {
+      configUrl,
+      port,
+      isMonorepo,
+      isFullTemplate: useFullTemplate,
+      templateVersion: getTemplateVersion()
+    });
     s2.message("\u2713 Updated package.json");
     if (hasExtraExposes) {
       const manifest = { name: appName, exposes: { "./App": "./src/App" } };
-      writeFileSync3(resolve6(cwd, "mf.manifest.json"), JSON.stringify(manifest, null, 2) + `
+      writeFileSync3(resolve6(cwd, "mf.manifest.json"), `${JSON.stringify(manifest, null, 2)}
 `);
       s2.message("\u2713 Created mf.manifest.json (add extra exposes as needed)");
     }
@@ -3392,6 +3418,15 @@ var initCommand = defineCommand({
     $e(isMonorepo ? "Run: daas dev" : "Run: bun install && daas dev");
   }
 });
+function getTemplateVersion() {
+  try {
+    const req = createRequire(import.meta.url);
+    const pkg = req("@chrisluyi/template/package.json");
+    return pkg.version ?? "1.0.0";
+  } catch {
+    return "1.0.0";
+  }
+}
 function getPackageName(cwd) {
   const pkgPath = resolve6(cwd, "package.json");
   if (!existsSync6(pkgPath))
@@ -3404,6 +3439,45 @@ function getPackageName(cwd) {
   }
 }
 
+// src/commands/test.ts
+import { createVitestConfig } from "@chrisluyi/rsbuild-config/vitest";
+import { startVitest } from "vitest/node";
+var testCommand = defineCommand({
+  meta: { name: "test", description: "Run MFE tests" },
+  args: {
+    json: {
+      type: "boolean",
+      default: false,
+      description: "Machine-readable JSON output"
+    }
+  },
+  async run({ args }) {
+    const json = args.json;
+    try {
+      const manifest = readManifest();
+      const daasConfig = readDaasConfig();
+      const config = createVitestConfig(manifest, {
+        coverage: daasConfig.coverage,
+        setupFiles: daasConfig.setupFiles
+      });
+      const vitest = await startVitest("test", [], config);
+      const failed = vitest?.state.getFiles().some((f4) => f4.result?.state === "fail") ?? false;
+      if (json) {
+        if (failed)
+          writeJsonError("test", EXIT_CODES.GENERAL_ERROR, "Tests failed", "Check test output above");
+        writeJsonSuccess("test", { appName: manifest.name, passed: !failed });
+      }
+      if (failed)
+        process.exit(EXIT_CODES.GENERAL_ERROR);
+    } catch (e3) {
+      if (json)
+        writeJsonError("test", EXIT_CODES.GENERAL_ERROR, e3.message, "Check test configuration");
+      consola.fatal(e3);
+      process.exit(EXIT_CODES.GENERAL_ERROR);
+    }
+  }
+});
+
 // src/index.ts
 var main = defineCommand({
   meta: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chrisluyi/daas-cli",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "type": "module",
   "bin": {
     "daas": "./dist/index.js"
@@ -31,6 +31,11 @@
   "devDependencies": {
     "typescript": "^5.5.0"
   },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Chris-LuYi/daas-cli",
+    "directory": "packages/cli"
+  },
   "publishConfig": {
     "access": "public"
   }