aerocoding 0.0.3 → 0.1.0

package/README.md

@@ -0,0 +1,136 @@
+# AeroCoding CLI
+
+Generate production-ready code from your UML diagrams via command line.
+
+## Installation
+
+```bash
+npm install -g aerocoding
+```
+
+## Quick Start
+
+### 1. Login
+
+Authenticate with your AeroCoding account:
+
+```bash
+aerocoding login
+```
+
+This will open your browser for OAuth Device Flow authentication.
+
+### 2. Generate Code
+
+Generate code from your project:
+
+```bash
+aerocoding generate --project <project-id> --targets dotnet-entity typescript-interface
+```
+
+## Commands
+
+### Authentication
+
+- `aerocoding login` - Authenticate with AeroCoding (OAuth Device Flow)
+- `aerocoding logout` - Clear stored credentials
+- `aerocoding whoami` - Show current authenticated user
+
+### Code Generation
+
+- `aerocoding generate` - Generate code from project schema
+
+  Options:
+  - `--project <id>` - Project ID (required)
+  - `--targets <targets...>` - Generation targets (e.g., `dotnet-entity typescript-interface`)
+  - `--entities <entities...>` - Filter by specific entities
+  - `--preset <preset>` - Architecture preset
+  - `--layers <layers...>` - Specific layers to generate
+  - `--output <dir>` - Output directory (default: `./generated`)
+  - `--preview` - Preview without writing files
+
+### Project Management
+
+- `aerocoding init` - Initialize config in current directory (coming soon)
+- `aerocoding pull` - Pull schema from cloud (coming soon)
+- `aerocoding status` - Show local schema status (coming soon)
+
+## Examples
+
+### Generate .NET entities only
+
+```bash
+aerocoding gen --project abc123 --targets dotnet-entity
+```
+
+### Generate full stack (backend + frontend)
+
+```bash
+aerocoding gen --project abc123 \
+  --targets dotnet-entity dotnet-repository typescript-interface
+```
+
+### Generate for specific entities
+
+```bash
+aerocoding gen --project abc123 \
+  --targets dotnet-entity \
+  --entities User Product Order
+```
+
+### Preview without writing files
+
+```bash
+aerocoding gen --project abc123 --targets dotnet-entity --preview
+```
+
+## Configuration
+
+The CLI uses environment variables for configuration. Create a `.env` file:
+
+```env
+API_URL=https://aerocoding.dev
+SUPABASE_URL=https://your-project.supabase.co
+SUPABASE_ANON_KEY=your-anon-key
+```
+
+## Security
+
+Tokens are stored securely using your operating system's credential manager:
+
+- **macOS**: Keychain
+- **Windows**: Credential Manager
+- **Linux**: Secret Service API (libsecret)
+
+## Troubleshooting
+
+### Not authenticated
+
+If you see "Not authenticated", run:
+
+```bash
+aerocoding logout
+aerocoding login
+```
+
+### Token expired
+
+Tokens are automatically refreshed. If refresh fails:
+
+```bash
+aerocoding login
+```
+
+### Network errors
+
+Check your API URL configuration and internet connection.
+
+## Links
+
+- [Documentation](https://docs.aerocoding.dev)
+- [GitHub](https://github.com/aerocoding/aerocoding)
+- [Website](https://aerocoding.dev)
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node