@chrisluyi/daas-cli 1.0.0

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@chrisluyi/daas-cli",
+  "version": "1.0.0",
+  "type": "module",
+  "bin": {
+    "daas": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "files": [
+    "dist",
+    "templates",
+    "skill.md"
+  ],
+  "scripts": {
+    "build": "bun build src/index.ts --outfile dist/index.js.tmp --target bun --external @rspack/core --external @rspack/lite-tapable --external @rsbuild/core --external @rsbuild/plugin-react --external @module-federation/rsbuild-plugin --external vitest --external @vitest/browser --external @vitest/ui --external tapable --external react-router-dom --external lightningcss && printf '%s\\n' '#!/usr/bin/env bun' | cat - dist/index.js.tmp > dist/index.js && rm dist/index.js.tmp && chmod +x dist/index.js",
+    "test": "bun test --ignore 'templates/**'"
+  },
+  "dependencies": {
+    "@clack/prompts": "^0.7.0",
+    "@chrisluyi/rsbuild-config": "workspace:*",
+    "@rsbuild/core": "^1.0.0",
+    "citty": "^0.1.6",
+    "consola": "^3.2.3",
+    "vitest": "^2.0.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.5.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/skill.md

@@ -0,0 +1,89 @@
+---
+name: daas-cli
+description: Use when working in an MFE project that uses daas-cli. Covers all commands, config schema, error codes, and AI agent workflows.
+---
+
+# daas-cli — Claude Code Skill
+
+`daas` is the build/dev/test CLI for React micro-frontend (MFE) apps using rsbuild + Module Federation 2.
+
+## MFE App Has No Build Config Files
+
+MFE apps intentionally have NO `rsbuild.config.ts`, NO `vitest.config.ts`. The CLI owns all configuration. Do not create these files.
+
+## Commands
+
+| Command | Purpose |
+|---|---|
+| `daas init [--template <name>]` | Interactive scaffold: creates App.tsx, App.test.tsx, tsconfig.json, updates package.json |
+| `daas dev [--port <n>] [--json]` | Start rsbuild dev server |
+| `daas build [--json]` | Production build to ./dist |
+| `daas test [--json]` | Run Vitest tests |
+| `daas info [--json]` | Show resolved project state (best first step for diagnosis) |
+
+**All commands except `init` support `--json`** — always pass `--json` when running as an AI agent.
+
+## AI Agent Workflow
+
+**Always start with:** `daas info --json` to understand the current project state before taking action.
+
+**Check results:**
+```bash
+daas build --json
+# parse stdout: { "ok": true, ... } or { "ok": false, "exitCode": N, "error": "...", "suggestion": "..." }
+```
+
+**Exit codes:**
+| Code | Meaning | Action |
+|---|---|---|
+| 0 | Success | — |
+| 1 | General error | Check rsbuild/vitest output above JSON |
+| 2 | Config error | Run `daas init` or fix `package.json#daas` |
+| 3 | CLI too old | Update `daas-cli` version per `releaseNotesUrl` in error |
+| 4 | Remote fetch failed | Check network/VPN; only fatal in build |
+| 5 | Config version mismatch | Update `daas-cli` |
+
+## Per-App Config (`package.json#daas`)
+
+```json
+{
+  "daas": {
+    "configUrl": "https://your-org.example.com/daas-config.json",
+    "port": 3001,
+    "coverage": { "lines": 80, "branches": 80 }
+  }
+}
+```
+
+- `configUrl` — required, URL of central remote JSON config
+- `port` — required, dev server port (must be unique per MFE in a monorepo)
+- `coverage` — optional, Vitest thresholds
+
+## Optional Manifest (`mf.manifest.json`)
+
+Only needed when exposing more than the default `./App`:
+
+```json
+{
+  "name": "mfe-auth",
+  "exposes": {
+    "./App": "./src/App",
+    "./Button": "./src/Button"
+  }
+}
+```
+
+If absent, name derives from `package.json#name` (scope stripped) and exposes defaults to `{ "./App": "./src/App" }`.
+
+## Remote URLs
+
+Remote URLs are **not configured here** — they are resolved dynamically at runtime by the host app via MF2's dynamic federation. Do not add `remotes` to the manifest.
+
+## What daas-cli Installs for You
+
+`daas-cli` is the only `devDependency` needed. It brings rsbuild, vitest, @testing-library/react, happy-dom, and all tooling as its own dependencies. Do not install these separately.
+
+## Roadmap (do not suggest these — not yet implemented)
+
+- v1.5: `daas dev sg-foo-mb-dev` target strings for multi-region builds
+- v2: `@daas/template` with src/services, src/containers, src/components conventions

package/templates/mfe/App.test.tsx.tmpl

@@ -0,0 +1,10 @@
+import { render, screen } from "@testing-library/react"
+import { describe, test, expect } from "vitest"
+import App from "./App"
+
+describe("App", () => {
+  test("renders without crashing", () => {
+    render(<App />)
+    expect(screen.getByText("Hello from MFE")).toBeInTheDocument()
+  })
+})

package/templates/mfe/App.tsx

@@ -0,0 +1,3 @@
+export default function App() {
+  return <div>Hello from MFE</div>
+}

package/templates/mfe/tsconfig.json

@@ -0,0 +1,13 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "lib": ["ES2020", "DOM"],
+    "jsx": "react-jsx",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "strict": true,
+    "skipLibCheck": true,
+    "types": ["@testing-library/jest-dom"]
+  },
+  "include": ["src"]
+}