create-lego-one 2.0.12 → 2.0.14

package/template/docs/framework/plans/01-infrastructure-setup.md

@@ -0,0 +1,855 @@
+# Infrastructure Setup
+
+> **For AI:** This is the first implementation document. Complete all tasks in order before proceeding to `02-pocketbase-setup.md`.
+
+**Goal:** Set up the monorepo structure, configure tooling (pnpm, TypeScript, ESLint, Prettier), and create base package configurations.
+
+**Architecture:** Monorepo with pnpm workspaces. Root manages shared dev dependencies. Host app and plugins are separate workspaces.
+
+**Tech Stack:** pnpm, TypeScript, ESLint, Prettier, Turbo (optional), Husky not needed (keeping it simple per decision)
+
+---
+
+## Task 1: Initialize Root Package
+
+**Files:**
+- Create: `package.json`
+- Create: `pnpm-workspace.yaml`
+- Create: `pnpm-lock.yaml` (auto-generated)
+- Create: `.gitignore`
+- Create: `.npmrc`
+
+**Step 1: Create package.json**
+
+Create `package.json`:
+
+```json
+{
+  "name": "lego-one",
+  "version": "1.0.0",
+  "private": true,
+  "description": "Microkernel SaaS OS with Modern.js + Garfish + PocketBase",
+  "type": "module",
+  "scripts": {
+    "dev": "pnpm --filter './host' dev",
+    "dev:host": "pnpm --filter './host' dev",
+    "dev:plugins": "pnpm -r --filter './packages/plugins/@lego/*' dev",
+    "dev:all": "pnpm --filter './host' dev & pnpm -r --filter './packages/plugins/@lego/*' dev",
+    "build": "pnpm --filter './host' build && pnpm -r --filter './packages/plugins/@lego/*' build",
+    "lint": "pnpm -r lint",
+    "lint:fix": "pnpm -r lint:fix",
+    "format": "prettier --write \"**/*.{ts,tsx,js,jsx,json,md}\"",
+    "format:check": "prettier --check \"**/*.{ts,tsx,js,jsx,json,md}\"",
+    "typecheck": "pnpm -r typecheck",
+    "test": "pnpm -r test",
+    "test:e2e": "pnpm --filter './host' test:e2e",
+    "clean": "pnpm -r exec rm -rf dist node_modules",
+    "create-plugin": "node scripts/create-plugin.js"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "@typescript-eslint/eslint-plugin": "^7.0.0",
+    "@typescript-eslint/parser": "^7.0.0",
+    "eslint": "^8.57.0",
+    "eslint-config-prettier": "^9.1.0",
+    "prettier": "^3.2.0",
+    "prettier-plugin-tailwindcss": "^0.5.0",
+    "typescript": "^5.3.0"
+  },
+  "engines": {
+    "node": ">=18.0.0",
+    "pnpm": ">=8.0.0"
+  }
+}
+```
+
+**Step 2: Create pnpm-workspace.yaml**
+
+Create `pnpm-workspace.yaml`:
+
+```yaml
+packages:
+  - 'host'
+  - 'packages/plugins/@lego/*'
+```
+
+**Step 3: Create .npmrc**
+
+Create `.npmrc`:
+
+```
+shamefully-hoist=false
+strict-peer-dependencies=false
+```
+
+**Step 4: Create .gitignore**
+
+Create `.gitignore`:
+
+```
+# Dependencies
+node_modules/
+.pnp*
+
+# Build outputs
+dist/
+build/
+*.tsbuildinfo
+
+# Environment
+.env
+.env.local
+.env.production
+.env.development
+*.log
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+.DS_Store
+
+# Testing
+coverage/
+.nyc_output/
+playwright-report/
+test-results/
+
+# PocketBase
+pocketbase/pb_data/
+pocketbase/pb_public/
+pocketbase/pb_hooks/
+*.pb
+
+# Temporary
+*.tmp
+.cache/
+```
+
+**Step 5: Verify setup**
+
+Run:
+```bash
+pnpm install
+```
+
+Expected: No errors, `node_modules` created, `pnpm-lock.yaml` generated.
+
+**Step 6: Commit**
+
+```bash
+git add .
+git commit -m "chore: initialize monorepo with pnpm workspaces"
+```
+
+---
+
+## Task 2: Configure TypeScript
+
+**Files:**
+- Create: `tsconfig.json`
+- Create: `tsconfig.base.json`
+
+**Step 1: Create base TypeScript config**
+
+Create `tsconfig.base.json`:
+
+```json
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "lib": ["ES2020", "DOM", "DOM.Iterable"],
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "allowJs": true,
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "isolatedModules": true,
+    "jsx": "react-jsx",
+    "jsxImportSource": "react",
+    "allowImportingTsExtensions": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noFallthroughCasesInSwitch": true,
+    "baseUrl": ".",
+    "paths": {
+      "@/*": ["./src/*"]
+    }
+  }
+}
+```
+
+**Step 2: Create root TypeScript config**
+
+Create `tsconfig.json`:
+
+```json
+{
+  "files": [],
+  "references": [
+    { "path": "./host" },
+    { "path": "./packages/plugins/@lego/plugin-dashboard" },
+    { "path": "./packages/plugins/@lego/plugin-todo" }
+  ]
+}
+```
+
+**Step 3: Commit**
+
+```bash
+git add tsconfig.*
+git commit -m "chore: add TypeScript configuration"
+```
+
+---
+
+## Task 3: Configure ESLint
+
+**Files:**
+- Create: `.eslintrc.js`
+- Create: `.eslintignore`
+
+**Step 1: Create ESLint config**
+
+Create `.eslintrc.js`:
+
+```javascript
+module.exports = {
+  root: true,
+  env: {
+    browser: true,
+    es2022: true,
+    node: true,
+  },
+  extends: [
+    'eslint:recommended',
+    '@typescript-eslint/recommended',
+    'prettier',
+  ],
+  parser: '@typescript-eslint/parser',
+  parserOptions: {
+    ecmaVersion: 'latest',
+    sourceType: 'module',
+    ecmaFeatures: {
+      jsx: true,
+    },
+  },
+  plugins: ['@typescript-eslint'],
+  rules: {
+    '@typescript-eslint/no-unused-vars': ['error', { argsIgnorePattern: '^_' }],
+    '@typescript-eslint/no-explicit-any': 'warn',
+    'no-console': ['warn', { allow: ['warn', 'error'] }],
+  },
+  ignorePatterns: ['dist', 'node_modules', '*.config.js'],
+};
+```
+
+**Step 2: Create .eslintignore**
+
+Create `.eslintignore`:
+
+```
+dist
+node_modules
+*.config.js
+coverage
+playwright-report
+```
+
+**Step 3: Add lint script to each workspace** (will be done when creating host/plugins)
+
+**Step 4: Commit**
+
+```bash
+git add .eslintrc* .eslintignore
+git commit -m "chore: add ESLint configuration"
+```
+
+---
+
+## Task 4: Configure Prettier
+
+**Files:**
+- Create: `.prettierrc`
+- Create: `.prettierignore`
+
+**Step 1: Create Prettier config**
+
+Create `.prettierrc`:
+
+```json
+{
+  "semi": true,
+  "trailingComma": "es5",
+  "singleQuote": true,
+  "printWidth": 100,
+  "tabWidth": 2,
+  "useTabs": false,
+  "arrowParens": "always",
+  "endOfLine": "lf",
+  "plugins": ["prettier-plugin-tailwindcss"]
+}
+```
+
+**Step 2: Create .prettierignore**
+
+Create `.prettierignore`:
+
+```
+dist
+node_modules
+pnpm-lock.yaml
+package-lock.json
+coverage
+playwright-report
+```
+
+**Step 3: Commit**
+
+```bash
+git add .prettierrc*
+git commit -m "chore: add Prettier configuration"
+```
+
+---
+
+## Task 5: Create Root Scripts Directory
+
+**Files:**
+- Create: `scripts/create-plugin.js`
+
+**Step 1: Create plugin scaffolding script**
+
+Create `scripts/create-plugin.js`:
+
+```javascript
+#!/usr/bin/env node
+
+const fs = require('fs');
+const path = require('path');
+
+const args = process.argv.slice(2);
+
+if (args.length === 0) {
+  console.error('Usage: node scripts/create-plugin.js <plugin-name>');
+  process.exit(1);
+}
+
+const pluginName = args[0].startsWith('plugin-')
+  ? args[0]
+  : `plugin-${args[0]}`;
+const pluginPascal = pluginName
+  .split('-')
+  .map((part) => part.charAt(0).toUpperCase() + part.slice(1))
+  .join('');
+
+const pluginDir = path.join(process.cwd(), 'packages/plugins/@lego', pluginName);
+
+// Create plugin directory
+fs.mkdirSync(pluginDir, { recursive: true });
+fs.mkdirSync(path.join(pluginDir, 'src'));
+fs.mkdirSync(path.join(pluginDir, 'src/pages'));
+fs.mkdirSync(path.join(pluginDir, 'src/components'));
+fs.mkdirSync(path.join(pluginDir, 'src/hooks'));
+fs.mkdirSync(path.join(pluginDir, 'src/lib'));
+
+// Create package.json
+const packageJson = {
+  name: `@lego/${pluginName}`,
+  version: '1.0.0',
+  private: true,
+  type: 'module',
+  exports: {
+    '.': './src/main.tsx',
+    './plugin.config': './plugin.config.ts',
+  },
+  scripts: {
+    dev: 'modern dev',
+    build: 'modern build',
+    preview: 'modern preview',
+    lint: 'eslint src',
+    typecheck: 'tsc --noEmit',
+  },
+  dependencies: {
+    '@modern-js/runtime': '^2.0.0',
+    'react': '^18.3.0',
+    'react-dom': '^18.3.0',
+  },
+  devDependencies: {
+    '@modern-js/app-tools': '^2.0.0',
+    '@modern-js/plugin-garfish': '^2.0.0',
+    '@types/react': '^18.3.0',
+    '@types/react-dom': '^18.3.0',
+    typescript: '^5.3.0',
+  },
+};
+
+fs.writeFileSync(
+  path.join(pluginDir, 'package.json'),
+  JSON.stringify(packageJson, null, 2)
+);
+
+// Create plugin.config.ts
+const pluginConfig = `import { definePluginConfig } from '@lego/kernel/plugin-config';
+
+export default definePluginConfig({
+  name: '@lego/${pluginName}',
+  version: '1.0.0',
+  displayName: '${pluginPascal}',
+  description: 'A plugin for ${pluginName}',
+
+  slots: {
+    'sidebar:nav': {
+      component: './src/components/SidebarLink',
+      order: 100,
+    },
+  },
+});
+`;
+
+fs.writeFileSync(path.join(pluginDir, 'plugin.config.ts'), pluginConfig);
+
+// Create modern.config.ts
+const modernConfig = `import { appTools, defineConfig } from '@modern-js/app-tools';
+import { garfishPlugin } from '@modern-js/plugin-garfish';
+
+// Get next available port starting from 3001
+const basePort = 3001 + parseInt(process.env.PLUGIN_INDEX || '0');
+
+export default defineConfig({
+  dev: {
+    port: basePort,
+  },
+  runtime: {
+    router: true,
+  },
+  deploy: {
+    microFrontend: true,
+  },
+  plugins: [appTools(), garfishPlugin()],
+  source: {
+    alias: {
+      '@': './src',
+    },
+  },
+});
+`;
+
+fs.writeFileSync(path.join(pluginDir, 'modern.config.ts'), modernConfig);
+
+// Create tsconfig.json
+const tsconfig = {
+  extends: '../../tsconfig.base.json',
+  compilerOptions: {
+    composite: true,
+    outDir: './dist',
+    rootDir: './src',
+  },
+  include: ['src'],
+};
+
+fs.writeFileSync(path.join(pluginDir, 'tsconfig.json'), JSON.stringify(tsconfig, null, 2));
+
+// Create main App.tsx
+const appTsx = `import { BrowserRouter, Routes, Route } from '@modern-js/runtime/router';
+
+interface PluginAppProps {
+  basename?: string;
+}
+
+export default function PluginApp({ basename }: PluginAppProps) {
+  const routerBasename = basename || '/';
+
+  return (
+    <BrowserRouter basename={routerBasename}>
+      <Routes>
+        <Route index element={<div>TODO: Implement ${pluginPascal}</div>} />
+      </Routes>
+    </BrowserRouter>
+  );
+}
+`;
+
+fs.writeFileSync(path.join(pluginDir, 'src/App.tsx'), appTsx);
+
+// Create main.tsx entry point
+const mainTsx = `import React from 'react';
+import ReactDOM from 'react-dom/client';
+import App from './App';
+
+ReactDOM.createRoot(document.getElementById('root')!).render(
+  <React.StrictMode>
+    <App />
+  </React.StrictMode>
+);
+`;
+
+fs.writeFileSync(path.join(pluginDir, 'src/main.tsx'), mainTsx);
+
+// Create basic SidebarLink component
+const sidebarLink = `import { Link } from '@modern-js/runtime/router';
+
+export function SidebarLink() {
+  return (
+    <Link
+      to="/${pluginName.replace('plugin-', '')}"
+      className="flex items-center gap-2 px-3 py-2 text-sm rounded-md hover:bg-accent hover:text-accent-foreground"
+    >
+      <span>${pluginPascal}</span>
+    </Link>
+  );
+}
+`;
+
+fs.writeFileSync(path.join(pluginDir, 'src/components/SidebarLink.tsx'), sidebarLink);
+
+// Create HTML template
+const html = `<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8" />
+  <link rel="icon" type="image/svg+xml" href="/vite.svg" />
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>${pluginPascal}</title>
+</head>
+<body>
+  <div id="root"></div>
+  <script type="module" src="/src/main.tsx"></script>
+</body>
+</html>
+`;
+
+fs.writeFileSync(path.join(pluginDir, 'src/index.html'), html);
+
+console.log(`✅ Plugin created: packages/plugins/@lego/${pluginName}`);
+console.log(``);
+console.log(`Next steps:`);
+console.log(`  1. cd packages/plugins/@lego/${pluginName}`);
+console.log(`  2. pnpm install`);
+console.log(`  3. pnpm run dev`);
+`;
+
+// Update root tsconfig.json to include new plugin
+const rootTsconfig = JSON.parse(fs.readFileSync('tsconfig.json', 'utf8'));
+rootTsconfig.references.push({
+  path: `./packages/plugins/@lego/${pluginName}`,
+});
+fs.writeFileSync('tsconfig.json', JSON.stringify(rootTsconfig, null, 2));
+
+// Update pnpm-workspace.yaml
+const workspaceContent = fs.readFileSync('pnpm-workspace.yaml', 'utf8');
+if (!workspaceContent.includes(pluginName)) {
+  const newWorkspace = workspaceContent.replace(
+    /(packages:\/\s*@lego\/\*)/,
+    `$1\n      - '${pluginName}'`
+  );
+  fs.writeFileSync('pnpm-workspace.yaml', newWorkspace);
+}
+`;
+
+**Step 2: Make script executable**
+
+```bash
+chmod +x scripts/create-plugin.js
+```
+
+**Step 3: Commit**
+
+```bash
+git add scripts/
+git commit -m "chore: add plugin scaffolding CLI script"
+```
+
+---
+
+## Task 6: Create Environment Configuration Structure
+
+**Files:**
+- Create: `.env.development`
+- Create: `.env.production`
+- Create: `.env.example`
+- Create: `src/env/env.schema.ts`
+
+**Step 1: Create development environment**
+
+Create `.env.development`:
+
+```bash
+# App
+VITE_APP_NAME=Lego-One
+VITE_APP_URL=http://localhost:8080
+
+# PocketBase
+VITE_POCKETBASE_URL=http://localhost:8090
+VITE_POCKETBASE_ADMIN_EMAIL=admin@lego-one.dev
+VITE_POCKETBASE_ADMIN_PASSWORD=admin123456
+
+# Seed Admin (for development)
+VITE_SEED_ADMIN_EMAIL=admin@lego-one.dev
+VITE_SEED_ADMIN_PASSWORD=admin123456
+VITE_SEED_ADMIN_NAME=Super Admin
+VITE_SEED_ORG_NAME=Demo Organization
+
+# Plugin Ports
+VITE_DEV_HOST_PORT=8080
+VITE_DEV_DASHBOARD_PORT=3001
+VITE_DEV_TODO_PORT=3002
+```
+
+**Step 2: Create production environment**
+
+Create `.env.production`:
+
+```bash
+# App
+VITE_APP_NAME=Lego-One
+VITE_APP_URL=https://your-domain.com
+
+# PocketBase (configure for production)
+VITE_POCKETBASE_URL=https://your-pocketbase-url.com
+VITE_POCKETBASE_ADMIN_EMAIL=
+VITE_POCKETBASE_ADMIN_PASSWORD=
+
+# No seed admin in production
+```
+
+**Step 3: Create environment example**
+
+Create `.env.example`:
+
+```bash
+# Copy this file to .env.development or .env.production
+
+# App Configuration
+VITE_APP_NAME=Lego-One
+VITE_APP_URL=http://localhost:8080
+
+# PocketBase Configuration
+VITE_POCKETBASE_URL=http://localhost:8090
+VITE_POCKETBASE_ADMIN_EMAIL=admin@example.com
+VITE_POCKETBASE_ADMIN_PASSWORD=change-me
+
+# Seed Admin (development only)
+VITE_SEED_ADMIN_EMAIL=admin@lego-one.dev
+VITE_SEED_ADMIN_PASSWORD=admin123456
+VITE_SEED_ADMIN_NAME=Super Admin
+VITE_SEED_ORG_NAME=Demo Organization
+
+# Plugin Development Ports
+VITE_DEV_HOST_PORT=8080
+VITE_DEV_DASHBOARD_PORT=3001
+VITE_DEV_TODO_PORT=3002
+```
+
+**Step 4: Create zod validation schema**
+
+Create `src/env/env.schema.ts`:
+
+```typescript
+import { z } from 'zod';
+
+const envSchema = z.object({
+  // App
+  VITE_APP_NAME: z.string().default('Lego-One'),
+  VITE_APP_URL: z.string().url(),
+
+  // PocketBase
+  VITE_POCKETBASE_URL: z.string().url(),
+  VITE_POCKETBASE_ADMIN_EMAIL: z.string().email(),
+  VITE_POCKETBASE_ADMIN_PASSWORD: z.string().min(8),
+
+  // Seed Admin (development only)
+  VITE_SEED_ADMIN_EMAIL: z.string().email().optional(),
+  VITE_SEED_ADMIN_PASSWORD: z.string().min(8).optional(),
+  VITE_SEED_ADMIN_NAME: z.string().optional(),
+  VITE_SEED_ORG_NAME: z.string().optional(),
+
+  // Plugin Ports
+  VITE_DEV_HOST_PORT: z.string().transform(Number).default(8080),
+  VITE_DEV_DASHBOARD_PORT: z.string().transform(Number).default(3001),
+  VITE_DEV_TODO_PORT: z.string().transform(Number).default(3002),
+});
+
+export type Env = z.infer<typeof envSchema>;
+
+export function validateEnv(): Env {
+  const env = {
+    VITE_APP_NAME: import.meta.env.VITE_APP_NAME,
+    VITE_APP_URL: import.meta.env.VITE_APP_URL,
+    VITE_POCKETBASE_URL: import.meta.env.VITE_POCKETBASE_URL,
+    VITE_POCKETBASE_ADMIN_EMAIL: import.meta.env.VITE_POCKETBASE_ADMIN_EMAIL,
+    VITE_POCKETBASE_ADMIN_PASSWORD: import.meta.env.VITE_POCKETBASE_ADMIN_PASSWORD,
+    VITE_SEED_ADMIN_EMAIL: import.meta.env.VITE_SEED_ADMIN_EMAIL,
+    VITE_SEED_ADMIN_PASSWORD: import.meta.env.VITE_SEED_ADMIN_PASSWORD,
+    VITE_SEED_ADMIN_NAME: import.meta.env.VITE_SEED_ADMIN_NAME,
+    VITE_SEED_ORG_NAME: import.meta.env.VITE_SEED_ORG_NAME,
+    VITE_DEV_HOST_PORT: import.meta.env.VITE_DEV_HOST_PORT,
+    VITE_DEV_DASHBOARD_PORT: import.meta.env.VITE_DEV_DASHBOARD_PORT,
+    VITE_DEV_TODO_PORT: import.meta.env.VITE_DEV_TODO_PORT,
+  };
+
+  const result = envSchema.safeParse(env);
+
+  if (!result.success) {
+    const errors = result.error.flatten().fieldErrors;
+    console.error('❌ Invalid environment variables:');
+    for (const [field, error] of Object.entries(errors)) {
+      console.error(`  ${field}: ${error?.join(', ')}`);
+    }
+    throw new Error('Environment validation failed');
+  }
+
+  return result.data;
+}
+
+export const env = validateEnv();
+```
+
+**Step 5: Commit**
+
+```bash
+git add .env* src/env/
+git commit -m "chore: add environment configuration with zod validation"
+```
+
+---
+
+## Task 7: Create README
+
+**Files:**
+- Create: `README.md`
+
+**Step 1: Create README**
+
+Create `README.md`:
+
+```markdown
+# Lego-One
+
+> **Microkernel SaaS OS** - A modular boilerplate for building SaaS applications with Modern.js, Garfish, and PocketBase.
+
+## Features
+
+- 🏗️ **Microkernel Architecture** - Host (Kernel) + Plugins (Features)
+- 🔐 **Multi-Tenancy** - Multiple organizations with RBAC
+- 🔌 **Plugin System** - Enable/disable plugins via config or UI
+- 🎨 **Modern UI** - Tailwind CSS + Shadcn components
+- ⚡ **Performance** - Rspack bundler, code-splitting, lazy loading
+- 🧪 **Tested** - Vitest + Playwright
+- 🔒 **Type-Safe** - TypeScript strict mode
+
+## Quick Start
+
+### Prerequisites
+
+- Node.js >= 18.0.0
+- pnpm >= 8.0.0
+
+### Installation
+
+```bash
+# Install dependencies
+pnpm install
+
+# Start development (host + all plugins)
+pnpm run dev:all
+
+# Or start individually
+pnpm run dev:host    # :8080
+pnpm run dev:plugins # All plugins
+```
+
+### First Run
+
+1. PocketBase will auto-initialize with seed admin
+2. Login with: `admin@lego-one.dev` / `admin123456`
+3. Explore the Dashboard and Todo plugins
+
+## Project Structure
+
+```
+lego-one/
+├── host/                    # Kernel application
+├── packages/
+│   └── plugins/
+│       └── @lego/
+│           ├── plugin-dashboard
+│           └── plugin-todo
+├── docs/
+│   ├── research/           # Architecture research
+│   ├── plans/               # Implementation plans
+│   └── setup/               # User guides
+└── pocketbase/              # Backend data
+```
+
+## Documentation
+
+- [Implementation Plans](./docs/plans/00-index.md) - Complete implementation guide
+- [Setup Guides](./docs/setup/) - How to create plugins, configure, etc.
+- [Research](./docs/research/) - Architecture research documents
+
+## License
+
+MIT
+```
+
+**Step 2: Commit**
+
+```bash
+git add README.md
+git commit -m "docs: add project README"
+```
+
+---
+
+## Verification
+
+After completing all tasks:
+
+**Step 1: Verify file structure**
+
+Run:
+```bash
+ls -la
+```
+
+Expected: `package.json`, `pnpm-workspace.yaml`, `.npmrc`, `.gitignore`, `tsconfig*`, `.eslintrc*`, `.prettierrc*`, `.env*`, `scripts/`, `src/env/`, `README.md`
+
+**Step 2: Verify dependencies install**
+
+Run:
+```bash
+pnpm install
+```
+
+Expected: No errors, `node_modules` created.
+
+**Step 3: Verify TypeScript**
+
+Run:
+```bash
+pnpm typecheck
+```
+
+Expected: No errors (some "cannot find module" is OK since we haven't created workspaces yet).
+
+---
+
+## Summary
+
+After completing this document, you have:
+
+✅ Monorepo structure with pnpm workspaces
+✅ TypeScript configuration (root + base)
+✅ ESLint + Prettier configured
+✅ Environment variables with zod validation
+✅ Plugin scaffolding CLI script
+✅ README documentation
+
+**Next:** → [`02-pocketbase-setup.md`](./02-pocketbase-setup.md)