@opensaas/stack-cli 0.4.0 → 0.6.0

package/dist/migration/introspectors/prisma-introspector.js

@@ -0,0 +1,190 @@
+/**
+ * Prisma Schema Introspector
+ *
+ * Parses prisma/schema.prisma and extracts structured information
+ * about models, fields, relationships, and enums.
+ */
+import fs from 'fs-extra';
+import path from 'path';
+export class PrismaIntrospector {
+    /**
+     * Introspect a Prisma schema file
+     */
+    async introspect(cwd, schemaPath = 'prisma/schema.prisma') {
+        const fullPath = path.isAbsolute(schemaPath) ? schemaPath : path.join(cwd, schemaPath);
+        if (!(await fs.pathExists(fullPath))) {
+            throw new Error(`Schema file not found: ${fullPath}`);
+        }
+        const schema = await fs.readFile(fullPath, 'utf-8');
+        return {
+            provider: this.extractProvider(schema),
+            models: this.extractModels(schema),
+            enums: this.extractEnums(schema),
+        };
+    }
+    /**
+     * Extract database provider from datasource block
+     */
+    extractProvider(schema) {
+        const match = schema.match(/datasource\s+\w+\s*\{[^}]*provider\s*=\s*"(\w+)"/);
+        return match ? match[1] : 'unknown';
+    }
+    /**
+     * Extract all model definitions
+     */
+    extractModels(schema) {
+        const models = [];
+        // Match model blocks
+        const modelRegex = /model\s+(\w+)\s*\{([^}]+)\}/g;
+        let match;
+        while ((match = modelRegex.exec(schema)) !== null) {
+            const name = match[1];
+            const body = match[2];
+            const fields = this.extractFields(body);
+            const primaryKey = fields.find((f) => f.isId)?.name || 'id';
+            models.push({
+                name,
+                fields,
+                hasRelations: fields.some((f) => f.relation !== undefined),
+                primaryKey,
+            });
+        }
+        return models;
+    }
+    /**
+     * Extract fields from a model body
+     */
+    extractFields(body) {
+        const fields = [];
+        const lines = body.split('\n');
+        for (const line of lines) {
+            const trimmed = line.trim();
+            // Skip empty lines, comments, and model-level attributes
+            if (!trimmed || trimmed.startsWith('//') || trimmed.startsWith('@@')) {
+                continue;
+            }
+            const field = this.parseFieldLine(trimmed);
+            if (field) {
+                fields.push(field);
+            }
+        }
+        return fields;
+    }
+    /**
+     * Parse a single field line
+     */
+    parseFieldLine(line) {
+        // Basic field pattern: name Type modifiers attributes
+        // Examples:
+        //   id        String   @id @default(cuid())
+        //   title     String
+        //   isActive  Boolean? @default(true)
+        //   posts     Post[]
+        //   author    User     @relation(fields: [authorId], references: [id])
+        // Remove comments
+        const withoutComment = line.split('//')[0].trim();
+        // Match field name and type
+        const fieldMatch = withoutComment.match(/^(\w+)\s+(\w+)(\?)?(\[\])?(.*)$/);
+        if (!fieldMatch)
+            return null;
+        const [, name, rawType, optional, isList, rest] = fieldMatch;
+        // Skip if this looks like an index or other non-field line
+        if (['@@', 'index', 'unique'].some((kw) => name.startsWith(kw))) {
+            return null;
+        }
+        const field = {
+            name,
+            type: rawType,
+            isRequired: !optional,
+            isUnique: rest.includes('@unique'),
+            isId: rest.includes('@id'),
+            isList: !!isList,
+        };
+        // Extract default value (handle nested parentheses)
+        const defaultMatch = rest.match(/@default\(/);
+        if (defaultMatch) {
+            const startIdx = rest.indexOf('@default(') + '@default('.length;
+            let depth = 1;
+            let endIdx = startIdx;
+            while (depth > 0 && endIdx < rest.length) {
+                if (rest[endIdx] === '(')
+                    depth++;
+                else if (rest[endIdx] === ')')
+                    depth--;
+                if (depth > 0)
+                    endIdx++;
+            }
+            field.defaultValue = rest.substring(startIdx, endIdx);
+        }
+        // Extract relation
+        const relationMatch = rest.match(/@relation\(([^)]+)\)/);
+        if (relationMatch) {
+            const relationBody = relationMatch[1];
+            // Parse relation parts
+            const fieldsMatch = relationBody.match(/fields:\s*\[([^\]]+)\]/);
+            const referencesMatch = relationBody.match(/references:\s*\[([^\]]+)\]/);
+            const nameMatch = relationBody.match(/name:\s*"([^"]+)"/) || relationBody.match(/"([^"]+)"/);
+            field.relation = {
+                name: nameMatch ? nameMatch[1] : '',
+                model: rawType,
+                fields: fieldsMatch ? fieldsMatch[1].split(',').map((f) => f.trim()) : [],
+                references: referencesMatch ? referencesMatch[1].split(',').map((r) => r.trim()) : [],
+            };
+        }
+        return field;
+    }
+    /**
+     * Extract enum definitions
+     */
+    extractEnums(schema) {
+        const enums = [];
+        // Match enum blocks
+        const enumRegex = /enum\s+(\w+)\s*\{([^}]+)\}/g;
+        let match;
+        while ((match = enumRegex.exec(schema)) !== null) {
+            const name = match[1];
+            const body = match[2];
+            const values = body
+                .split('\n')
+                .map((line) => line.trim())
+                .filter((line) => line && !line.startsWith('//'));
+            enums.push({ name, values });
+        }
+        return enums;
+    }
+    /**
+     * Map Prisma type to OpenSaaS field type
+     */
+    mapPrismaTypeToOpenSaas(prismaType) {
+        const mappings = {
+            String: { type: 'text', import: 'text' },
+            Int: { type: 'integer', import: 'integer' },
+            Float: { type: 'float', import: 'float' },
+            Boolean: { type: 'checkbox', import: 'checkbox' },
+            DateTime: { type: 'timestamp', import: 'timestamp' },
+            Json: { type: 'json', import: 'json' },
+            BigInt: { type: 'text', import: 'text' }, // No native support
+            Decimal: { type: 'text', import: 'text' }, // No native support
+            Bytes: { type: 'text', import: 'text' }, // No native support
+        };
+        return mappings[prismaType] || { type: 'text', import: 'text' };
+    }
+    /**
+     * Get warnings for unsupported features
+     */
+    getWarnings(schema) {
+        const warnings = [];
+        // Check for unsupported types
+        for (const model of schema.models) {
+            for (const field of model.fields) {
+                if (['BigInt', 'Decimal', 'Bytes'].includes(field.type)) {
+                    warnings.push(`Field "${model.name}.${field.name}" uses unsupported type "${field.type}" - will be mapped to text()`);
+                }
+            }
+        }
+        // Check for composite IDs
+        // This would require checking for @@id in the original schema
+        return warnings;
+    }
+}
+//# sourceMappingURL=prisma-introspector.js.map

package/dist/migration/introspectors/prisma-introspector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prisma-introspector.js","sourceRoot":"","sources":["../../../src/migration/introspectors/prisma-introspector.ts"],"names":[],"mappings":"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"}

package/dist/migration/types.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Migration types - Shared types for the migration system
+ */
+export type ProjectType = 'prisma' | 'nextjs' | 'keystone';
+export interface ModelInfo {
+    name: string;
+    fieldCount: number;
+}
+export interface ProjectAnalysis {
+    projectTypes: ProjectType[];
+    cwd: string;
+    models?: ModelInfo[];
+    provider?: string;
+    hasAuth?: boolean;
+    authLibrary?: string;
+}
+export interface FieldMapping {
+    prismaType: string;
+    opensaasType: string;
+    opensaasImport: string;
+}
+export interface MigrationQuestion {
+    id: string;
+    text: string;
+    type: 'text' | 'select' | 'boolean' | 'multiselect';
+    options?: string[];
+    defaultValue?: string | boolean | string[];
+    required?: boolean;
+    dependsOn?: {
+        questionId: string;
+        value: string | boolean;
+    };
+}
+export interface MigrationSession {
+    id: string;
+    projectType: ProjectType;
+    analysis: ProjectAnalysis;
+    currentQuestionIndex: number;
+    answers: Record<string, string | boolean | string[]>;
+    generatedConfig?: string;
+    isComplete: boolean;
+    createdAt: Date;
+    updatedAt: Date;
+}
+export interface MigrationOutput {
+    configContent: string;
+    dependencies: string[];
+    files: Array<{
+        path: string;
+        content: string;
+        language: string;
+        description: string;
+    }>;
+    steps: string[];
+    warnings: string[];
+}
+export interface IntrospectedModel {
+    name: string;
+    fields: IntrospectedField[];
+    hasRelations: boolean;
+    primaryKey: string;
+}
+export interface IntrospectedField {
+    name: string;
+    type: string;
+    isRequired: boolean;
+    isUnique: boolean;
+    isId: boolean;
+    isList: boolean;
+    defaultValue?: string;
+    relation?: {
+        name: string;
+        model: string;
+        fields: string[];
+        references: string[];
+    };
+}
+export interface IntrospectedSchema {
+    provider: string;
+    models: IntrospectedModel[];
+    enums: Array<{
+        name: string;
+        values: string[];
+    }>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/migration/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/migration/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,CAAA;AAE1D,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,WAAW,EAAE,CAAA;IAC3B,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,CAAC,EAAE,SAAS,EAAE,CAAA;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAA;IAClB,YAAY,EAAE,MAAM,CAAA;IACpB,cAAc,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,aAAa,CAAA;IACnD,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAClB,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,CAAA;IAC1C,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,SAAS,CAAC,EAAE;QACV,UAAU,EAAE,MAAM,CAAA;QAClB,KAAK,EAAE,MAAM,GAAG,OAAO,CAAA;KACxB,CAAA;CACF;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAA;IACV,WAAW,EAAE,WAAW,CAAA;IACxB,QAAQ,EAAE,eAAe,CAAA;IACzB,oBAAoB,EAAE,MAAM,CAAA;IAC5B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,CAAC,CAAA;IACpD,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,UAAU,EAAE,OAAO,CAAA;IACnB,SAAS,EAAE,IAAI,CAAA;IACf,SAAS,EAAE,IAAI,CAAA;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE,MAAM,CAAA;IACrB,YAAY,EAAE,MAAM,EAAE,CAAA;IACtB,KAAK,EAAE,KAAK,CAAC;QACX,IAAI,EAAE,MAAM,CAAA;QACZ,OAAO,EAAE,MAAM,CAAA;QACf,QAAQ,EAAE,MAAM,CAAA;QAChB,WAAW,EAAE,MAAM,CAAA;KACpB,CAAC,CAAA;IACF,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,QAAQ,EAAE,MAAM,EAAE,CAAA;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,iBAAiB,EAAE,CAAA;IAC3B,YAAY,EAAE,OAAO,CAAA;IACrB,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,OAAO,CAAA;IACnB,QAAQ,EAAE,OAAO,CAAA;IACjB,IAAI,EAAE,OAAO,CAAA;IACb,MAAM,EAAE,OAAO,CAAA;IACf,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,EAAE;QACT,IAAI,EAAE,MAAM,CAAA;QACZ,KAAK,EAAE,MAAM,CAAA;QACb,MAAM,EAAE,MAAM,EAAE,CAAA;QAChB,UAAU,EAAE,MAAM,EAAE,CAAA;KACrB,CAAA;CACF;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,iBAAiB,EAAE,CAAA;IAC3B,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAA;CACjD"}

package/dist/migration/types.js

@@ -0,0 +1,5 @@
+/**
+ * Migration types - Shared types for the migration system
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/migration/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/migration/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opensaas/stack-cli",
-  "version": "0.4.0",
+  "version": "0.6.0",
   "description": "CLI tools for OpenSaas Stack",
   "type": "module",
   "main": "./dist/index.js",
@@ -18,6 +18,11 @@
   "bin": {
     "opensaas": "./bin/opensaas.js"
   },
+  "files": [
+    "dist",
+    "bin",
+    "plugin"
+  ],
   "keywords": [
     "opensaas",
     "cli",
@@ -40,13 +45,16 @@
     "chalk": "^5.6.2",
     "chokidar": "^5.0.0",
     "commander": "^14.0.2",
+    "fs-extra": "^11.3.2",
+    "glob": "^13.0.0",
     "jiti": "^2.6.1",
     "ora": "^9.0.0",
     "prompts": "^2.4.2",
     "zod": "^4.1.13",
-    "@opensaas/stack-core": "0.4.0"
+    "@opensaas/stack-core": "0.6.0"
   },
   "devDependencies": {
+    "@types/fs-extra": "^11.0.4",
     "@types/node": "^24.10.1",
     "@types/prompts": "^2.4.9",
     "@vitest/coverage-v8": "^4.0.15",

package/plugin/.claude-plugin/plugin.json

@@ -0,0 +1,15 @@
+{
+  "name": "opensaas-migration",
+  "description": "OpenSaaS Stack migration assistant with AI-guided configuration, schema analysis, and code generation support",
+  "version": "1.0.0",
+  "author": {
+    "name": "OpenSaaS Team",
+    "url": "https://github.com/OpenSaasAU/stack"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/OpenSaasAU/stack",
+    "directory": "packages/cli/plugin"
+  },
+  "keywords": ["migration", "opensaas", "prisma", "keystone", "nextjs", "code-generation"]
+}

package/plugin/README.md

@@ -0,0 +1,112 @@
+# OpenSaaS Migration Assistant Plugin
+
+A Claude Code plugin that provides AI-guided migration assistance for converting existing Prisma, KeystoneJS, or Next.js projects to OpenSaaS Stack.
+
+## Features
+
+- **Migration Assistant Agent**: Contextual agent that guides you through the migration process
+- **Interactive Commands**: Slash commands for schema analysis, config generation, and validation
+- **Migration Skill**: Expert knowledge about migration patterns and best practices
+- **MCP Integration**: Works with the OpenSaaS MCP server for advanced tooling
+
+## Installation
+
+This plugin is automatically set up when you run:
+
+```bash
+npx @opensaas/stack-cli migrate --with-ai
+```
+
+The CLI will:
+
+1. Install this plugin to your project
+2. Create `.claude/opensaas-project.json` with your project metadata
+3. Configure `.claude/settings.json` to enable the plugin
+4. Set up `.mcp.json` for MCP server integration
+
+## What's Included
+
+### Migration Assistant Agent
+
+A specialized agent that:
+
+- Reads your project metadata from `.claude/opensaas-project.json`
+- Guides you through the migration wizard
+- Explains access control patterns
+- Generates `opensaas.config.ts`
+
+### Slash Commands
+
+- `/analyze-schema` - Detailed schema analysis with recommendations
+- `/generate-config` - Generate opensaas.config.ts
+- `/validate-migration` - Validate generated configuration
+
+### Migration Skill
+
+Expert knowledge including:
+
+- Access control patterns
+- Field type mappings
+- Database configuration examples
+- Common challenges and solutions
+
+## Usage
+
+Once installed, simply ask Claude:
+
+```
+Help me migrate to OpenSaaS Stack
+```
+
+The migration assistant will:
+
+1. Read your project details
+2. Start the interactive wizard
+3. Guide you through configuration
+4. Generate your opensaas.config.ts
+
+## Project Metadata
+
+The CLI creates `.claude/opensaas-project.json` with information about your project:
+
+```json
+{
+  "projectTypes": ["prisma"],
+  "provider": "sqlite",
+  "models": [
+    { "name": "User", "fieldCount": 5 },
+    { "name": "Post", "fieldCount": 7 }
+  ],
+  "hasAuth": true
+}
+```
+
+The plugin reads this file to provide contextual assistance.
+
+## Development
+
+This plugin is part of the `@opensaas/stack-cli` package and is distributed with it.
+
+**Directory structure:**
+
+```
+plugin/
+├── .claude-plugin/
+│   └── plugin.json          # Plugin manifest
+├── agents/
+│   └── migration-assistant.md   # Migration agent
+├── commands/
+│   ├── analyze-schema.md
+│   ├── generate-config.md
+│   └── validate-migration.md
+├── skills/
+│   └── opensaas-migration/
+│       └── SKILL.md
+└── README.md
+```
+
+## Links
+
+- [OpenSaaS Stack Documentation](https://stack.opensaas.au/)
+- [Migration Guide](https://stack.opensaas.au/guides/migration)
+- [GitHub Repository](https://github.com/OpenSaasAU/stack)

package/plugin/agents/migration-assistant.md

@@ -0,0 +1,150 @@
+---
+name: migration-assistant
+description: OpenSaaS Stack migration expert. Use when helping users migrate from Prisma, KeystoneJS, or Next.js projects to OpenSaaS Stack. Proactively helps with schema analysis, access control configuration, and opensaas.config.ts generation.
+model: sonnet
+skills: opensaas-migration
+---
+
+You are the OpenSaaS Stack Migration Assistant, helping users migrate their existing projects to OpenSaaS Stack.
+
+## Getting Project Context
+
+**IMPORTANT**: Before starting, read the project metadata from `.claude/opensaas-project.json` to understand:
+
+- Project type (Prisma, KeystoneJS, Next.js)
+- Database provider
+- Detected models and their structure
+- Whether authentication is already present
+
+This file is created by `npx @opensaas/stack-cli migrate --with-ai` and contains essential project information.
+
+## Your Role
+
+Guide the user through a complete migration to OpenSaaS Stack:
+
+1. **Analyze** their current project structure
+2. **Explain** what OpenSaaS Stack offers (access control, admin UI, type safety)
+3. **Guide** them through the migration wizard
+4. **Generate** a working `opensaas.config.ts`
+5. **Validate** the generated configuration
+6. **Provide** clear next steps
+
+## Available MCP Tools
+
+### Schema Analysis
+
+- `opensaas_introspect_prisma` - Analyze Prisma schema in detail
+- `opensaas_introspect_keystone` - Analyze KeystoneJS config
+
+### Migration Wizard
+
+- `opensaas_start_migration` - Start the interactive wizard
+- `opensaas_answer_migration` - Answer wizard questions
+
+### Documentation
+
+- `opensaas_search_migration_docs` - Search migration documentation
+- `opensaas_get_example` - Get example code patterns
+
+### Validation
+
+- `opensaas_validate_feature` - Validate implementation
+
+## Conversation Guidelines
+
+### When the user says "help me migrate" or similar:
+
+1. **Read project metadata** from `.claude/opensaas-project.json`:
+
+   ```
+   Use the Read tool to read .claude/opensaas-project.json
+   ```
+
+2. **Acknowledge** their project based on the metadata:
+
+   > "I can see you have a [PROJECT_TYPE] project with [MODEL_COUNT] models. Let me help you migrate to OpenSaaS Stack!"
+
+3. **Start the wizard** by calling:
+
+   ```
+   opensaas_start_migration({ projectType: "[project_type]" })
+   ```
+
+4. **Present questions naturally** - don't mention session IDs or technical details to the user
+
+5. **Explain choices** - help them understand what each option means:
+   - Access control patterns
+   - Authentication options
+   - Database configuration
+
+6. **Show progress** - let them know how far along they are
+
+7. **Generate the config** when complete and explain what was created
+
+### When explaining OpenSaaS Stack:
+
+Highlight these benefits:
+
+- **Built-in access control** - Secure by default
+- **Admin UI** - Auto-generated from your schema
+- **Type safety** - Full TypeScript support
+- **Prisma integration** - Uses familiar ORM
+- **Plugin system** - Easy to extend
+
+### When answering questions:
+
+- Use `opensaas_search_migration_docs` to find accurate information
+- Use `opensaas_get_example` to show code patterns
+- Be honest if something isn't supported
+
+### Tone
+
+- Be encouraging and helpful
+- Explain technical concepts simply
+- Celebrate progress ("Great choice!", "Almost there!")
+- Don't overwhelm with information
+
+## Example Conversation
+
+**User:** Help me migrate to OpenSaaS Stack
+
+**You:** Let me check your project details...
+
+[Read .claude/opensaas-project.json]
+
+I can see you have a Prisma project with 5 models. OpenSaaS Stack will give you:
+
+- Automatic admin UI for managing your data
+- Built-in access control to secure your API
+- Type-safe database operations
+
+Let me start the migration wizard to configure your project...
+
+[Call opensaas_start_migration]
+
+**User:** [answers questions]
+
+**You:** [Continue through wizard, explain each choice, generate final config]
+
+## Error Handling
+
+If something goes wrong:
+
+1. Explain what happened in simple terms
+2. Suggest alternatives or manual steps
+3. Link to documentation for more help
+
+If `.claude/opensaas-project.json` doesn't exist:
+
+- Explain that `npx @opensaas/stack-cli migrate --with-ai` should be run first
+- Offer to help them run it
+
+## After Migration
+
+Once the config is generated, guide them through:
+
+1. Installing dependencies
+2. Running `opensaas generate`
+3. Running `prisma db push`
+4. Starting their dev server
+5. Visiting the admin UI

package/plugin/commands/analyze-schema.md

@@ -0,0 +1,34 @@
+---
+description: Analyze the current project schema and provide a detailed breakdown
+---
+
+Analyze the current project schema and provide a detailed breakdown.
+
+## Instructions
+
+1. Read `.claude/opensaas-project.json` to determine the project type
+2. Use `opensaas_introspect_prisma` or `opensaas_introspect_keystone` based on project type
+3. Present the results in a clear, organized format
+4. Highlight:
+   - All models and their fields
+   - Relationships between models
+   - Potential access control patterns
+   - Any issues or warnings
+
+## Output Format
+
+Present like this:
+
+### Models Summary
+
+| Model | Fields | Has Relations | Suggested Access |
+| ----- | ------ | ------------- | ---------------- |
+| ...   | ...    | ...           | ...              |
+
+### Detailed Analysis
+
+[For each model, show fields and relationships]
+
+### Recommendations
+
+[Based on the schema, suggest access control patterns]

package/plugin/commands/generate-config.md

@@ -0,0 +1,33 @@
+---
+description: Generate the opensaas.config.ts file for this project
+---
+
+Generate the opensaas.config.ts file for this project.
+
+## Instructions
+
+1. Read `.claude/opensaas-project.json` to get project details
+2. If migration wizard hasn't been started, start it:
+
+   ```
+   opensaas_start_migration({ projectType: "<project_type>" })
+   ```
+
+3. Guide the user through any remaining questions
+
+4. When complete, display:
+   - The generated config file
+   - Dependencies to install
+   - Next steps to run
+
+5. Offer to explain any part of the generated config
+
+## Quick Mode
+
+If the user wants defaults, use these answers based on the project metadata:
+
+- preserve_database: true
+- db_provider: [from project metadata]
+- enable_auth: [from project metadata]
+- default_access: "public-read-auth-write"
+- admin_base_path: "/admin"