clevermation-cli 0.3.2

package/.github/workflows/publish.yml

@@ -0,0 +1,46 @@
+name: Publish to npm
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@v2
+        with:
+          bun-version: latest
+
+      - name: Install dependencies
+        run: bun install
+
+      - name: Run tests
+        run: bun test || echo "No tests found, skipping..."
+
+      - name: Setup Node for NPM publish
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          registry-url: 'https://registry.npmjs.org'
+
+      - name: Update version from release tag
+        run: |
+          VERSION=${GITHUB_REF#refs/tags/v}
+          echo "Updating version to $VERSION"
+          # Update package.json
+          jq --arg v "$VERSION" '.version = $v' package.json > tmp.json && mv tmp.json package.json
+          # Update src/index.ts
+          sed -i "s/const VERSION = '[^']*'/const VERSION = '$VERSION'/" src/index.ts
+
+      - name: Publish to npm
+        run: npm publish --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

package/CLAUDE.md

@@ -0,0 +1,167 @@
+# Clevermation CLI
+
+## Projektziel
+
+Interne CLI für das Clevermation-Team zur standardisierten Einrichtung und Verwaltung von Claude Code Projekten. Die CLI ermöglicht Teammitgliedern, schnell und konsistent Projekte aufzusetzen, ohne manuell Tools konfigurieren zu müssen.
+
+## Warum dieses Projekt?
+
+- **Konsistenz**: Alle Projekte haben die gleiche Struktur und Konfiguration
+- **Onboarding**: Neue Teammitglieder können sofort produktiv arbeiten
+- **Automatisierung**: Authentifizierung, GitHub-Repos, Claude Code Plugins - alles automatisch
+- **Best Practices**: Clevermation-Standards sind eingebaut (Naming, Struktur, Tools)
+
+## Tech-Stack
+
+| Technologie | Zweck |
+|-------------|-------|
+| **Bun** | Runtime (TypeScript) |
+| **Commander.js** | CLI Framework |
+| **@inquirer/prompts** | Interaktive Prompts (Checkboxen, Selects) |
+| **chalk** | Farbige Konsolen-Ausgabe |
+| **ora** | Spinner für async Operationen |
+| **execa** | Externe CLI-Aufrufe (git, gh, supabase) |
+| **Zod** | Config-Schema Validierung |
+| **GitHub Packages** | Distribution (privates NPM) |
+
+## Projektstruktur
+
+```
+clevermation-cli/
+├── bin/
+│   ├── cl.ts              # Entry Point (Alias: cl)
+│   └── clever.ts          # Entry Point (Alias: clever)
+├── src/
+│   ├── index.ts           # CLI Setup, Command-Registration
+│   ├── commands/
+│   │   ├── init.ts        # Projekt initialisieren
+│   │   ├── sync.ts        # GitHub synchronisieren
+│   │   ├── auth.ts        # Service-Authentifizierung
+│   │   ├── doctor.ts      # System-Check
+│   │   ├── open.ts        # IDE öffnen
+│   │   ├── config.ts      # Konfiguration verwalten
+│   │   ├── explain.ts     # Projekt erklären
+│   │   └── update.ts      # CLI/Plugins updaten
+│   ├── utils/
+│   │   ├── logger.ts      # Farbige Konsolen-Ausgabe
+│   │   ├── config.ts      # Config laden/speichern
+│   │   ├── prerequisites.ts # System-Voraussetzungen prüfen/installieren
+│   │   └── auto-update.ts # Update-Check im Hintergrund
+│   └── types/
+│       └── config.ts      # Zod Schemas für Configs
+├── scripts/
+│   └── setup-team-member.sh # Onboarding-Script
+├── .github/workflows/
+│   └── publish.yml        # Auto-Publish bei Release
+└── package.json
+```
+
+## Commands
+
+| Command | Beschreibung |
+|---------|-------------|
+| `cl init` | Neues Projekt mit interaktivem Setup |
+| `cl sync` | GitHub Repo erstellen und synchronisieren |
+| `cl auth` | Service-Authentifizierung (GitHub, Supabase, N8N, ElevenLabs) |
+| `cl doctor` | System-Voraussetzungen prüfen |
+| `cl open` | Projekt in IDE öffnen (VS Code default) |
+| `cl config` | Konfiguration anzeigen/bearbeiten |
+| `cl explain` | Projektstruktur erklären |
+| `cl update` | CLI und Plugins aktualisieren |
+
+## Konfigurationsdateien
+
+### Global: `~/.clevermation/config.json`
+```json
+{
+  "auth": { "github": {...}, "supabase": {...}, "n8n": {...} },
+  "preferences": { "defaultModel": "sonnet", "defaultIDE": "code" }
+}
+```
+
+### Projekt: `.clevermation/config.json`
+```json
+{
+  "project": { "name": "...", "type": "customer", "customer": "..." },
+  "services": { "github": {...}, "supabase": {...} },
+  "claudeCode": { "plugins": [...], "model": "sonnet" }
+}
+```
+
+## Konventionen
+
+### Repository-Namen
+- **Kundenprojekte**: `kunde-projekt` (z.B. `acme-webshop`)
+- **Interne Projekte**: `clevermation-projekt` (z.B. `clevermation-cli`)
+- **Alle Repos**: Privat in Clevermation Organisation
+
+### Code-Style
+- TypeScript strict mode
+- Deutsche Kommentare
+- Bun statt npm/yarn/pnpm
+
+---
+
+## TODO
+
+### Kurzfristig
+- [ ] CLAUDE.md Template für "Optimale Einstellungen" mit User verfeinern
+- [ ] `cl new <name>` Shortcut (mkdir + cd + init)
+- [ ] `cl plugins` Command für Plugin-Verwaltung
+
+### Claude Code Plugins (Marketplace)
+- [ ] **Supabase Plugin** - Datenbank, Auth, Storage, Edge Functions, RLS
+- [ ] **N8N Plugin** - Workflow Automation, Trigger, Nodes
+- [ ] **ElevenLabs Plugin** - Voice AI, Text-to-Speech, Voice Cloning
+- [ ] **Mermaid/Planning Plugin** - Diagramme, Flowcharts, Architektur
+
+### Future Features
+- [ ] **Projekt-Templates** - Web-App, Automation, API vorkonfiguriert
+- [ ] **Team-Settings Sync** - Globale Clevermation-Settings synchronisieren
+- [ ] **Erweiterte CLAUDE.md** - Manager-Rolle, Subagenten-Orchestrierung, Testing-Workflow
+- [ ] **`cl deploy`** - Deployment zu Vercel/Supabase/etc.
+
+---
+
+## Distribution
+
+### Installation
+```bash
+# Mit Bun (empfohlen)
+bun add -g clevermation-cli
+
+# Mit npm
+npm install -g clevermation-cli
+
+# Mit pnpm
+pnpm add -g clevermation-cli
+```
+
+### Release-Prozess
+1. Version in `package.json` und `src/index.ts` erhöhen
+2. Commit und Push
+3. `gh release create v0.x.0`
+4. GitHub Action published automatisch zu GitHub Packages
+
+---
+
+## Entwicklung
+
+```bash
+# Lokal ausführen
+bun run dev init
+bun run dev doctor
+bun run dev auth
+
+# TypeScript prüfen
+bun run typecheck
+
+# Tests
+bun test
+```
+
+## Links
+
+- **Repository**: https://github.com/Clevermation/clevermation-cli
+- **Releases**: https://github.com/Clevermation/clevermation-cli/releases
+- **npm Package**: https://www.npmjs.com/package/clevermation-cli

package/README.md

@@ -0,0 +1,211 @@
+# Clevermation CLI
+
+Tool für das Clevermation-Team zur standardisierten Einrichtung von Claude Code Projekten.
+
+## Installation
+
+```bash
+# Mit Bun (empfohlen)
+bun add -g clevermation-cli
+
+# Mit npm
+npm install -g clevermation-cli
+
+# Mit pnpm
+pnpm add -g clevermation-cli
+```
+
+Danach stehen die Commands `cl` und `clever` zur Verfügung.
+
+## Commands
+
+### `cl init`
+
+Initialisiert ein neues Projekt mit interaktivem Setup.
+
+```bash
+cl init
+```
+
+**Fragt ab:**
+- Projekt-Typ (Kunde oder Intern)
+- Projektname
+- Services (Supabase, N8N, ElevenLabs)
+- Claude Model Präferenz
+- Optimale Projekt-Einstellungen
+
+### `cl sync`
+
+Synchronisiert das Projekt mit GitHub.
+
+```bash
+cl sync
+```
+
+**Funktionen:**
+- Prüft GitHub CLI Authentifizierung
+- Erstellt privates Repo in Clevermation Org (falls nicht vorhanden)
+- Pusht Änderungen
+
+### `cl auth`
+
+Verwaltet Authentifizierung für alle Services.
+
+```bash
+# Status aller Services anzeigen
+cl auth
+
+# Bei einem Service anmelden
+cl auth login github
+cl auth login supabase
+cl auth login n8n
+cl auth login elevenlabs
+cl auth login all  # Alle Services
+
+# Von einem Service abmelden
+cl auth logout github
+```
+
+### `cl doctor`
+
+Prüft System-Voraussetzungen und zeigt Probleme.
+
+```bash
+cl doctor
+```
+
+**Prüft:**
+- Bun, Git, GitHub CLI, Claude Code
+- Supabase CLI (optional)
+- Auth-Status aller Services
+
+### `cl open`
+
+Öffnet das Projekt in deiner IDE.
+
+```bash
+# Im Standard-Editor öffnen (VS Code)
+cl open
+
+# In spezifischer IDE öffnen
+cl open -i cursor
+cl open -i webstorm
+cl open -i zed
+
+# Standard-IDE setzen
+cl open --set-default cursor
+```
+
+### `cl config`
+
+Zeigt und verwaltet Konfiguration.
+
+```bash
+cl config
+```
+
+### `cl explain`
+
+Erklärt die aktuelle Projektstruktur.
+
+```bash
+cl explain
+cl explain -v  # Verbose mit Verzeichnisbaum
+```
+
+### `cl update`
+
+Aktualisiert CLI und Plugins.
+
+```bash
+cl update
+cl update --cli-only      # Nur CLI
+cl update --plugins-only  # Nur Plugins
+```
+
+## Features
+
+### Auto-Update
+Die CLI prüft automatisch auf Updates (max. 1x pro 24h) und zeigt eine Benachrichtigung wenn eine neue Version verfügbar ist.
+
+### Auto-Install
+Fehlende Voraussetzungen (Bun, Git, GitHub CLI) werden automatisch im Hintergrund installiert.
+
+### Optimale Einstellungen
+Bei `cl init` kann optional eine globale `~/.claude/CLAUDE.md` erstellt werden mit Clevermation-spezifischen Einstellungen.
+
+## Projekt-Struktur nach `cl init`
+
+```
+mein-projekt/
+├── .clevermation/
+│   └── config.json       # Projekt-Konfiguration
+├── .claude/
+│   ├── settings.json     # Claude Code Settings
+│   └── settings.local.json  # API Keys (gitignored)
+├── .mcp.json             # MCP Server Konfiguration
+├── src/
+├── docs/
+└── .gitignore
+```
+
+## Naming Conventions
+
+| Projekt-Typ | Format | Beispiel |
+|-------------|--------|----------|
+| Kunde | `kunde-projekt` | `acme-webshop` |
+| Intern | `clevermation-projekt` | `clevermation-cli` |
+
+Alle Repositories werden als **privat** in der Clevermation Organisation erstellt.
+
+---
+
+## Claude Code Plugins (TODO)
+
+Folgende Plugins sollen für den Marketplace erstellt werden:
+
+- [ ] **Supabase Plugin** - Datenbank, Auth, Storage, Edge Functions, RLS
+- [ ] **N8N Plugin** - Workflow Automation, Trigger, Nodes
+- [ ] **ElevenLabs Plugin** - Voice AI, Text-to-Speech, Voice Cloning
+- [ ] **Mermaid/Planning Plugin** - Diagramme, Flowcharts, Architektur-Planung
+
+## Future Features
+
+- [ ] **Projekt-Templates** - Vorkonfigurierte Setups (Web-App, Automation, API)
+- [ ] **`cl new <name>`** - Shortcut für mkdir + cd + init
+- [ ] **`cl plugins`** - Claude Code Plugins verwalten
+- [ ] **Erweiterte CLAUDE.md** - Manager-Rolle, Subagenten-Orchestrierung, Testing-Workflow
+- [ ] **Team-Einstellungen sync** - Globale Clevermation-Settings synchronisieren
+
+---
+
+## Entwicklung
+
+```bash
+# Repository klonen
+git clone https://github.com/Clevermation/clevermation-cli.git
+cd clevermation-cli
+
+# Dependencies installieren
+bun install
+
+# Lokal ausführen
+bun run dev init
+bun run dev --help
+
+# Tests
+bun test
+```
+
+## Release erstellen
+
+Releases werden automatisch über GitHub Actions veröffentlicht:
+
+1. Version in `package.json` und `src/index.ts` erhöhen
+2. Commit und Push
+3. GitHub Release erstellen: `gh release create v0.2.0`
+4. GitHub Action published automatisch zu GitHub Packages
+
+## Support
+
+Bei Fragen: #dev-tools Slack Channel

package/bin/cl

@@ -0,0 +1,2 @@
+#!/usr/bin/env bun
+import '../src/index.js';

package/bin/clever

@@ -0,0 +1,2 @@
+#!/usr/bin/env bun
+import '../src/index.js';