luna-agents 2.0.1

package/commands/ll-api.md

@@ -0,0 +1,99 @@
+---
+name: ll-api
+displayName: Luna API Generator
+description: Generate a complete API from a description — routes, validation, auth, tests, docs, deployment config
+version: 1.0.0
+category: creation
+agent: luna-api-generator
+parameters:
+  - name: spec
+    type: string
+    description: API description in plain English, or path to OpenAPI spec
+    required: true
+    prompt: true
+  - name: framework
+    type: string
+    description: "Framework: hono (default), express, fastify, nest, flask, fastapi"
+    required: false
+    default: hono
+  - name: deploy
+    type: string
+    description: "Deploy target: cloudflare (default), vercel, aws-lambda, docker"
+    required: false
+    default: cloudflare
+mcp_servers:
+  - sequential-thinking
+  - memory
+  - git
+  - fetch
+---
+
+# /api — From Description to Production API
+
+Describe your API in English. Luna generates everything: routes, middleware, validation, auth, database schema, tests, docs, and deployment config.
+
+## What Gets Generated
+
+```
+/api "User management API with auth, profiles, team invites, and admin panel"
+                    │
+                    ▼
+┌─────────────────────────────────────────────┐
+│  SCHEMA                                      │
+│  ├── Prisma/Drizzle data model               │
+│  ├── Zod validation schemas                  │
+│  ├── TypeScript interfaces                   │
+│  └── Database migration files                │
+├─────────────────────────────────────────────┤
+│  ROUTES                                      │
+│  ├── CRUD endpoints for each entity          │
+│  ├── Auth routes (register, login, refresh)  │
+│  ├── Admin routes (users, roles, audit)      │
+│  ├── Webhook endpoints                       │
+│  └── Health check endpoint                   │
+├─────────────────────────────────────────────┤
+│  MIDDLEWARE                                  │
+│  ├── JWT auth + API key auth                 │
+│  ├── Role-based access control (RBAC)        │
+│  ├── Rate limiting                           │
+│  ├── CORS configuration                      │
+│  ├── Request logging with correlation IDs    │
+│  └── Error handling with structured responses│
+├─────────────────────────────────────────────┤
+│  TESTS                                       │
+│  ├── Unit tests for every service            │
+│  ├── Integration tests for every route       │
+│  ├── Auth flow tests                         │
+│  ├── Rate limit tests                        │
+│  └── 90%+ coverage                           │
+├─────────────────────────────────────────────┤
+│  DOCS                                        │
+│  ├── OpenAPI 3.1 spec                        │
+│  ├── Interactive Swagger UI                  │
+│  ├── Postman collection                      │
+│  └── cURL examples for every endpoint        │
+├─────────────────────────────────────────────┤
+│  DEPLOY                                      │
+│  ├── wrangler.toml (Cloudflare)              │
+│  ├── Dockerfile                              │
+│  ├── CI/CD pipeline                          │
+│  └── Environment configuration               │
+└─────────────────────────────────────────────┘
+```
+
+## Usage
+
+```bash
+/api "E-commerce API with products, cart, checkout, and order tracking"
+/api "Real-time chat API with rooms, messages, typing indicators, and file sharing"
+/api ./openapi.yaml --framework fastify --deploy docker
+/api "Webhook relay service that receives, queues, and retries webhook deliveries"
+```
+
+## In Pipes
+
+```bash
+/pipe api "my API" >> test >> guard >> launch staging >> docs
+/pipe idea "my product" >> api "$idea.api_spec" >> go *5 >> test >> ship
+/pipe api "my API" >> morph to "GraphQL" >> test >> deploy
+```

package/commands/ll-assert.md

@@ -0,0 +1,73 @@
+---
+name: ll-assert
+displayName: Luna Assert
+description: Validate project constraints — file size, coverage, security, accessibility thresholds
+version: 1.0.0
+category: quality
+agent: luna-code-review
+parameters:
+  - name: checks
+    type: string
+    description: Assertions to validate (coverage, file-size, security, a11y, deps, all)
+    required: false
+    prompt: true
+workflow:
+  - run_assertions
+  - report_results
+output:
+  - .luna/{current-project}/assert-report.md
+prerequisites: []
+---
+
+# Luna Assert
+
+Validate project constraints and fail fast if thresholds aren't met.
+
+## Built-in Assertions
+
+| Assertion | What It Checks |
+|-----------|---------------|
+| `files.max_lines <= 100` | No source file exceeds 100 lines |
+| `test.coverage >= 90` | Test coverage at or above 90% |
+| `test.pass` | All tests passing |
+| `security.critical == 0` | No critical vulnerabilities |
+| `security.high == 0` | No high vulnerabilities |
+| `a11y.critical == 0` | No critical accessibility issues |
+| `deps.outdated <= 5` | Max 5 outdated dependencies |
+| `deps.vulnerable == 0` | No vulnerable dependencies |
+
+## Usage
+
+### Standalone
+```
+/assert all                          # Run all assertions
+/assert coverage                     # Coverage only
+/assert file-size                    # File size only
+/assert security                     # Security only
+```
+
+### In Pipes
+```
+/pipe go *5 >> assert files.max_lines <= 100 >> test
+/pipe test >> assert $test.coverage >= 90 >> ship
+/pipe sec >> assert security.critical == 0 >> ship
+/pipe go >> assert files.max_lines <= 100 >> assert test.pass >> pr
+```
+
+### As Quality Gate
+```
+/pipe go *5 >> (
+  assert files.max_lines <= 100 ~~
+  assert test.coverage >= 90 ~~
+  assert security.critical == 0 ~~
+  assert a11y.critical == 0
+) >> ship
+```
+
+## Custom Assertions
+
+```
+/pipe go >> assert $test.coverage >= 95    # Stricter coverage
+/pipe go >> assert files.max_lines <= 80   # Stricter file size
+/pipe go >> assert deps.vulnerable == 0    # Zero vulnerabilities
+```

package/commands/ll-audience.md

@@ -0,0 +1,308 @@
+---
+name: ll-audience
+displayName: Luna Audience
+description: Deep customer intelligence — analyze who uses your app, predict behavior, detect churn, identify upsell opportunities, and generate growth strategies
+version: 1.0.0
+category: strategy
+agent: luna-analytics
+parameters:
+  - name: action
+    type: string
+    description: "Action: profile (who are they), predict (what will they do), churn (who's leaving), growth (how to grow), cohort (group analysis), health (customer health score), ideal (ideal customer profile)"
+    required: true
+    prompt: true
+  - name: source
+    type: string
+    description: "Data source: codebase (from code), api (live data), mock (simulated), csv (import file)"
+    required: false
+    default: codebase
+mcp_servers:
+  - sequential-thinking
+  - memory
+  - fetch
+  - git
+  - jupyter
+  - notebooklm
+  - playwright
+---
+
+# /audience — Customer Intelligence Engine
+
+Understand every customer segment. Predict behavior. Detect churn before it happens. Find your best growth opportunities. All from your codebase or real data.
+
+## Actions
+
+### /audience profile
+```
+Customer Profile Analysis:
+├── WHO uses your product?
+│   ├── Company sizes (startup/SMB/enterprise)
+│   ├── Industries and verticals
+│   ├── Technical roles (developer/PM/designer/exec)
+│   ├── Geographic distribution
+│   └── How they found you
+│
+├── HOW do they use it?
+│   ├── Most-used features (from route analytics)
+│   ├── Average session length
+│   ├── Peak usage times
+│   ├── Mobile vs desktop ratio
+│   ├── API vs UI usage split
+│   └── Integration patterns
+│
+├── WHY do they stay?
+│   ├── Core value drivers per segment
+│   ├── Feature stickiness scores
+│   ├── Network effects (team size growth)
+│   └── Switching cost analysis
+│
+└── WHAT do they pay?
+    ├── Revenue distribution by segment
+    ├── ARPU by plan tier
+    ├── Expansion revenue patterns
+    └── Price sensitivity indicators
+```
+
+### /audience predict
+```
+Behavioral Prediction:
+├── UPGRADE LIKELIHOOD
+│   ├── Users approaching plan limits
+│   ├── Feature usage patterns that precede upgrades
+│   ├── Team growth signals
+│   └── Ranked list of upgrade-ready users
+│
+├── CHURN RISK
+│   ├── Declining engagement patterns
+│   ├── Support ticket sentiment analysis
+│   ├── Feature abandonment signals
+│   ├── Payment failure correlation
+│   └── Risk score per customer (1-100)
+│
+├── EXPANSION OPPORTUNITIES
+│   ├── Users who'd benefit from higher tier
+│   ├── Teams ready for enterprise features
+│   ├── API-heavy users who need custom plans
+│   └── Revenue impact if converted
+│
+└── VIRAL POTENTIAL
+    ├── Users most likely to refer
+    ├── Social proof candidates (public companies, influencers)
+    ├── Community contribution likelihood
+    └── Case study candidates
+```
+
+### /audience churn
+```
+Churn Analysis & Prevention:
+├── EARLY WARNING SIGNALS
+│   ├── Login frequency dropping
+│   ├── Feature usage declining
+│   ├── Support tickets increasing
+│   ├── Team members being removed
+│   ├── API calls decreasing
+│   └── Billing payment failures
+│
+├── CHURN REASONS (from your product)
+│   ├── Missing features (what they tried but couldn't do)
+│   ├── Complexity (features they never discovered)
+│   ├── Performance (slow workflows, timeouts)
+│   ├── Competition (features competitors have)
+│   ├── Price (approaching budget limits)
+│   └── Fit (wrong product for their use case)
+│
+├── SAVE PLAYBOOKS (auto-generated)
+│   ├── For price-sensitive churners → offer annual discount
+│   ├── For complexity churners → trigger onboarding replay
+│   ├── For missing-feature churners → show roadmap
+│   ├── For performance churners → escalate to engineering
+│   └── For fit churners → suggest alternatives gracefully
+│
+└── PREVENTION ACTIONS
+    ├── Automated re-engagement emails
+    ├── In-app nudges for underused features
+    ├── Personal outreach triggers
+    └── Win-back campaigns for churned users
+```
+
+### /audience growth
+```
+Growth Strategy Generation:
+├── ACQUISITION
+│   ├── Best channels by persona type
+│   ├── Content topics that attract each segment
+│   ├── SEO keywords by customer intent
+│   ├── Community platforms where users hang out
+│   └── Partnership opportunities
+│
+├── ACTIVATION
+│   ├── Onboarding optimization per persona
+│   ├── Time-to-first-value benchmarks
+│   ├── Activation rate by signup source
+│   └── A/B test suggestions for onboarding
+│
+├── RETENTION
+│   ├── Feature adoption playbooks
+│   ├── Engagement loop design
+│   ├── Community building strategy
+│   └── Loyalty program design
+│
+├── REVENUE
+│   ├── Pricing optimization opportunities
+│   ├── Upsell trigger automation
+│   ├── Annual plan conversion strategy
+│   └── Enterprise sales playbook
+│
+└── REFERRAL
+    ├── Viral loop design
+    ├── Referral program structure
+    ├── Ambassador program
+    └── Case study pipeline
+```
+
+### /audience cohort
+```
+Cohort Analysis:
+├── By signup date (monthly cohorts)
+│   ├── Retention curves per cohort
+│   ├── Revenue per cohort over time
+│   └── Feature adoption by cohort
+│
+├── By acquisition source
+│   ├── Organic vs paid vs referral
+│   ├── LTV by source
+│   └── Best-performing channels
+│
+├── By plan tier
+│   ├── Free→Pro conversion rates
+│   ├── Pro→Team upgrade patterns
+│   ├── Enterprise adoption timeline
+│   └── Revenue concentration risk
+│
+└── By behavior
+    ├── Power users vs casual
+    ├── API-first vs UI-first
+    ├── Solo vs team users
+    └── Feature-specific cohorts
+```
+
+### /audience health
+```
+Customer Health Score (per account):
+┌──────────────────────────────────────┐
+│  CUSTOMER: Acme Corp                  │
+│  HEALTH SCORE: 72/100 ⚠️             │
+│                                       │
+│  ENGAGEMENT    ████████░░  78%        │
+│  ├── Login frequency: daily           │
+│  ├── Feature breadth: 6/12 features   │
+│  └── API calls: 1,200/day            │
+│                                       │
+│  ADOPTION      ██████░░░░  62%        │
+│  ├── Team seats used: 4/10           │
+│  ├── Integrations: 2 active          │
+│  └── Advanced features: 3/8 used     │
+│                                       │
+│  SATISFACTION  █████████░  85%        │
+│  ├── Support tickets: 1 (resolved)   │
+│  ├── NPS response: 8/10             │
+│  └── Last feedback: positive         │
+│                                       │
+│  GROWTH        ██████████  95%        │
+│  ├── Team growing (2 invites pending)│
+│  ├── Approaching tier limit          │
+│  └── Expansion revenue likely        │
+│                                       │
+│  ⚠️  ACTION: Low adoption score      │
+│  → Trigger feature discovery email   │
+│  → Schedule success call             │
+└──────────────────────────────────────┘
+```
+
+### /audience ideal
+```
+Ideal Customer Profile (ICP):
+├── FIRMOGRAPHICS
+│   ├── Company size: 10-100 employees
+│   ├── Industry: SaaS, fintech, developer tools
+│   ├── Revenue: $1M-$50M ARR
+│   ├── Funding: Series A-B
+│   └── Tech stack: React, Node, Cloudflare/AWS
+│
+├── BUYER PERSONA
+│   ├── Title: CTO, VP Engineering, Lead Developer
+│   ├── Reports to: CEO or CPO
+│   ├── Budget authority: $500-$5000/mo
+│   ├── Decision timeline: 2-4 weeks
+│   └── Evaluation criteria: speed, reliability, DX
+│
+├── BEHAVIORAL SIGNALS
+│   ├── Uses CI/CD (GitHub Actions, CircleCI)
+│   ├── Has 5+ developers
+│   ├── Ships weekly or faster
+│   ├── Already uses AI tools
+│   └── Active on GitHub/Twitter/Discord
+│
+├── DISQUALIFIERS
+│   ├── Less than 3 developers
+│   ├── No cloud infrastructure
+│   ├── Waterfall development process
+│   └── Regulated industry needing on-prem only
+│
+└── LOOK-ALIKE TARGETING
+    ├── Companies similar to best customers
+    ├── GitHub repos with matching tech stacks
+    ├── Job postings mentioning your stack
+    └── Conference attendees in your space
+```
+
+## Usage
+
+```bash
+/audience profile                                          # Who uses your product
+/audience predict                                          # Behavioral predictions
+/audience churn                                            # Churn analysis + prevention
+/audience growth                                           # Growth strategy
+/audience cohort                                           # Cohort analysis
+/audience health                                           # Customer health scores
+/audience ideal                                            # Ideal customer profile
+```
+
+## In Pipes
+
+```bash
+# Full customer intelligence
+/pipe audience profile >> audience predict >> audience growth >> present "growth strategy"
+
+# Churn prevention workflow
+/pipe audience churn >> ghost email "win-back campaign" >> publish
+
+# Persona-driven product development
+/pipe persona generate >> audience ideal >> compete "top 3" >> idea "what to build next"
+
+# Data-driven pricing
+/pipe audience cohort >> audience predict >> money >> persona interview "test new pricing"
+
+# Customer success automation
+/pipe audience health >> if $health < 70 >> ghost email "re-engagement" >> notify cs-team
+
+# Growth experiment design
+/pipe audience growth >> plan >> go *5 >> test >> audience predict >> pulse
+```
+
+## Output
+
+```
+.luna/{project}/audience/
+  profile.md                     # Customer profile analysis
+  predictions.json               # Behavioral predictions
+  churn-analysis.md              # Churn risks and playbooks
+  growth-strategy.md             # Growth recommendations
+  cohorts/                       # Cohort analysis
+    by-date.md
+    by-source.md
+    by-tier.md
+  health-scores.json             # Per-customer health scores
+  ideal-customer-profile.md      # ICP definition
+  summary.md                     # Executive summary
+```

package/commands/ll-auth.md

@@ -0,0 +1,145 @@
+---
+name: ll-auth
+displayName: Luna Auth Builder
+description: Build complete Auth.js authentication with social providers, setup guides, and LinkedIn company page
+version: 1.0.0
+category: authentication
+agent: luna-auth
+parameters:
+  - name: scope
+    type: string
+    description: Project or feature scope for authentication setup
+    required: true
+    prompt: true
+  - name: providers
+    type: string
+    description: Comma-separated OAuth providers (google,github,microsoft,linkedin,apple,discord,twitter)
+    required: false
+    prompt: true
+workflow:
+  - analyze_codebase_and_framework
+  - generate_auth_configuration
+  - implement_social_providers
+  - create_rbac_and_middleware
+  - generate_provider_setup_guide
+  - generate_linkedin_company_page
+  - generate_logo_prompt
+  - create_auth_report
+output:
+  - .luna/{current-project}/auth/
+  - .luna/{current-project}/auth/auth-setup-guide.html
+  - .luna/{current-project}/auth/linkedin-company-page.md
+  - .luna/{current-project}/auth/auth-report.md
+prerequisites:
+  - .luna/{current-project}/requirements.md
+  - .luna/{current-project}/design.md
+---
+
+# Luna Auth Builder
+
+Build a complete Auth.js (NextAuth v5) authentication system with social OAuth providers, comprehensive HTML setup guides, LinkedIn company page content, and brand-matched logo prompts.
+
+## What This Command Does
+
+1. **Analyzes your codebase** to detect framework (Next.js, SvelteKit, Express, etc.) and existing auth patterns
+2. **Generates full Auth.js configuration** with selected social providers:
+   - Google OAuth 2.0
+   - GitHub OAuth App
+   - Microsoft Entra ID (Azure AD)
+   - LinkedIn OpenID Connect
+   - Apple Sign-In
+   - Discord OAuth2
+   - Twitter/X OAuth 2.0
+   - Custom credentials (email/password)
+3. **Implements RBAC** with role-based access control, protected routes, and middleware
+4. **Creates a standalone HTML setup guide** with step-by-step instructions for each provider's developer console, including screenshots placeholders, callback URLs, and env var configuration
+5. **Generates LinkedIn company page** content with description, tagline, about section, and product showcase text
+6. **Creates a logo generation prompt** that matches your brand identity for use with AI image generators (DALL-E, Midjourney, etc.)
+
+## Prerequisites
+
+Requires in your current project:
+- `.luna/{current-project}/requirements.md`
+- `.luna/{current-project}/design.md`
+
+If missing, run:
+```bash
+/luna-requirements
+/luna-design
+```
+
+## Usage Instructions
+
+When you run this command:
+- **Scope**: Press ENTER for project-level or type feature name
+- **Providers**: Enter comma-separated list (e.g., `google,github,microsoft,linkedin`) or press ENTER for all
+
+## Execution Steps
+
+1. **Codebase Analysis**: Detects framework, database, existing auth patterns, and package manager
+2. **Auth.js Setup**: Generates `auth.ts` config, provider configs, Prisma adapter schema, env template
+3. **Social Providers**: Configures each selected OAuth provider with proper scopes and profile mapping
+4. **RBAC & Middleware**: Creates role enum, permission matrix, auth middleware, protected route helpers
+5. **React/UI Components**: Generates sign-in page, sign-out button, session provider, avatar component
+6. **HTML Setup Guide**: Creates a beautiful standalone HTML page with:
+   - Google Cloud Console setup (OAuth consent screen, credentials)
+   - GitHub Developer Settings (OAuth App creation)
+   - Microsoft Entra ID (App registration, redirect URIs)
+   - LinkedIn Developer Portal (app creation, OpenID Connect)
+   - Apple Developer (Services ID, Sign-In configuration)
+   - Discord Developer Portal (application setup)
+   - Twitter/X Developer Portal (OAuth 2.0 setup)
+   - Environment variable reference table
+   - Callback URL reference for each provider
+   - Troubleshooting section
+7. **LinkedIn Company Page**: Generates ready-to-paste content:
+   - Company name, tagline, industry, size
+   - About section (2000 char max)
+   - Product description
+   - Specialties and hashtags
+8. **Logo Prompt**: Creates an AI image generation prompt matching your brand for company logo
+9. **Auth Report**: Summary of everything generated with next steps
+
+## Output Files
+
+Creates in your current project:
+```
+.luna/{current-project}/auth/
+  src/
+    auth.ts                    # Auth.js configuration
+    auth.config.ts             # Provider configs
+    middleware.ts              # Auth middleware
+    lib/
+      rbac.ts                  # Role-based access control
+      auth-helpers.ts          # Server-side auth utilities
+    components/
+      auth-provider.tsx        # Session provider wrapper
+      sign-in-form.tsx         # Sign-in page with social buttons
+      user-avatar.tsx          # Authenticated user avatar
+      protected-route.tsx      # Client-side route protection
+    prisma/
+      auth-schema.prisma       # User, Account, Session models
+  .env.auth.example            # Environment variable template
+  auth-setup-guide.html        # Standalone HTML setup guide
+  linkedin-company-page.md     # LinkedIn company page content
+  logo-prompt.md               # AI logo generation prompt
+  auth-report.md               # Implementation summary
+```
+
+## Next Steps in Workflow
+
+After auth setup:
+```bash
+/luna-execute     # Integrate generated auth files into your project
+/luna-test        # Validate auth flows with integration tests
+/luna-deploy      # Deploy with OAuth callback URLs configured
+```
+
+## Tips
+
+- Run with all providers first, then remove unused ones from config
+- The HTML guide can be shared with team members who need to set up developer accounts
+- LinkedIn company page content is optimized for SEO and discoverability
+- Logo prompt is tuned for consistent brand identity across platforms
+- Always set `AUTH_SECRET` with `npx auth secret` before deploying
+- Test OAuth flows in development with `AUTH_URL=http://localhost:3000`