berget 1.3.1 → 2.0.0

package/.env.example

@@ -0,0 +1,5 @@
+# OpenCode Configuration
+# Copy this file to .env and adjust values as needed
+
+# Berget AI API Key - Required for authentication
+BERGET_API_KEY=your_api_key_here

package/.github/workflows/publish.yml

@@ -0,0 +1,56 @@
+name: Publish to NPM
+
+on:
+  push:
+    branches:
+      - main
+  release:
+    types: [published]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '18'
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run tests
+        run: npm run test:run
+
+      - name: Build project
+        run: npm run build
+
+  publish:
+    needs: test
+    runs-on: ubuntu-latest
+    if: github.ref == 'refs/heads/main' || github.event_name == 'release'
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '18'
+          registry-url: 'https://registry.npmjs.org'
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build project
+        run: npm run build
+
+      - name: Publish to NPM
+        run: npm publish
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

package/.github/workflows/test.yml

@@ -0,0 +1,38 @@
+name: Test
+
+on:
+  pull_request:
+    branches:
+      - main
+  push:
+    branches:
+      - main
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        node-version: [18, 20]
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node-version }}
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run tests
+        run: npm run test:run
+
+      - name: Build project
+        run: npm run build
+
+      - name: Check TypeScript
+        run: npx tsc --noEmit

package/AGENTS.md

@@ -0,0 +1,184 @@
+# Berget Code Agents
+
+This document describes the specialized agents available in this project for use with OpenCode.
+
+## Available Agents
+
+### Primary Agents
+
+#### fullstack
+
+Router/coordinator agent for full-stack development with schema-driven architecture. Handles routing between different personas based on file paths and task requirements.
+
+**Use when:**
+
+- Working across multiple parts of a monorepo
+- Need to coordinate between frontend, backend, devops, and app
+- Starting new projects and need to determine tech stack
+
+**Key features:**
+
+- Schema-driven development (database → OpenAPI → types)
+- Automatic routing to appropriate persona
+- Tech stack discovery and recommendations
+
+#### frontend
+
+Builds Scandinavian, type-safe UIs with React, Tailwind, and Shadcn.
+
+**Use when:**
+
+- Working with React components (.tsx files)
+- Frontend development in /apps/frontend
+- UI/UX implementation
+
+**Key features:**
+
+- Design system integration
+- Semantic tokens and accessibility
+- Props-first component architecture
+
+#### backend
+
+Functional, modular Koa + TypeScript services with schema-first approach and code quality focus.
+
+**Use when:**
+
+- Working with Koa routers and services
+- Backend development in /services
+- API development and database work
+
+**Key features:**
+
+- Zod validation and OpenAPI generation
+- Code quality and refactoring principles
+- PR workflow integration
+
+#### devops
+
+Declarative GitOps infrastructure with FluxCD, Kustomize, Helm, and operators.
+
+**Use when:**
+
+- Working with Kubernetes manifests
+- Infrastructure in /infra or /k8s
+- CI/CD and deployment configurations
+
+**Key features:**
+
+- GitOps workflows
+- Operator-first approach
+- SemVer with release candidates
+
+#### app
+
+Expo + React Native applications with props-first architecture and offline awareness.
+
+**Use when:**
+
+- Mobile app development with Expo
+- React Native projects in /apps/app
+- Cross-platform mobile development
+
+**Key features:**
+
+- Shared design tokens with frontend
+- Offline-first architecture
+- Expo integration
+
+### Subagents
+
+#### security
+
+Security specialist for penetration testing, OWASP compliance, and vulnerability assessments.
+
+**Use when:**
+
+- Need security review of code changes
+- OWASP Top 10 compliance checks
+- Vulnerability assessments
+
+**Key features:**
+
+- OWASP standards compliance
+- Security best practices
+- Actionable remediation strategies
+
+#### quality
+
+Quality assurance specialist for testing, building, and PR management.
+
+**Use when:**
+
+- Need to run test suites and build processes
+- Creating or updating pull requests
+- Monitoring GitHub for reviewer comments
+- Ensuring code quality standards
+
+**Key features:**
+
+- Comprehensive testing and building workflows
+- PR creation and management
+- GitHub integration for reviewer feedback
+- CLI command expertise for quality assurance
+
+## Usage
+
+### Switching Agents
+
+Use the `<tab>` key to cycle through primary agents during a session.
+
+### Manual Agent Selection
+
+Use commands to switch to specific agents:
+
+- `/fullstack` - Switch to Fullstack agent
+- `/frontend` - Switch to Frontend agent
+- `/backend` - Switch to Backend agent
+- `/devops` - Switch to DevOps agent
+- `/app` - Switch to App agent
+- `/quality` - Switch to Quality agent for testing and PR management
+
+### Using Subagents
+
+Mention subagents with `@` symbol:
+
+```
+@security review this authentication implementation
+@quality run tests and create PR for these changes
+```
+
+## Routing Rules
+
+The fullstack agent automatically routes tasks based on file patterns:
+
+- `/apps/frontend` or `.tsx` files → frontend
+- `/apps/app` or Expo/React Native → app
+- `/infra`, `/k8s`, FluxCD, Helm → devops
+- `/services`, Koa routers → backend
+
+## Configuration
+
+All agents are configured in `opencode.json` with:
+
+- Specialized prompts and temperature settings
+- Appropriate tool permissions
+- Model optimizations for their specific tasks
+
+## Environment Setup
+
+Copy `.env.example` to `.env` and configure:
+
+```
+BERGET_API_KEY=your_api_key_here
+```
+
+## Workflow
+
+All agents follow these principles:
+
+- Never work directly in main branch
+- Follow branch strategy and commit conventions
+- Create PRs for new functionality
+- Run tests before committing
+- Address reviewer feedback promptly

package/README.md

@@ -1,33 +1,193 @@
 # Berget CLI
 
-A command-line interface for interacting with the Berget AI infrastructure.
+A command-line tool for interacting with Berget AI's infrastructure and AI models.
 
 ## Installation
 
 ```bash
 npm install -g berget
+# or use directly with npx
+npx berget --help
 ```
 
 ## Authentication
 
-The CLI uses OAuth-based authentication with automatic token refresh.
+Before you can use the CLI, you need to authenticate:
 
-### Login
+```bash
+# Login with OAuth
+npx berget auth login
+
+# Create an API key
+npx berget api-keys create --name "My CLI Key"
+
+# Or use environment variable
+export BERGET_API_KEY=sk_ber_your_api_key_here
+```
+
+## Chat Command
+
+### Basic Usage
+
+```bash
+# Interactive chat session
+npx berget chat run
+
+# Use specific model
+npx berget chat run openai/gpt-oss
+
+# Send direct message
+npx berget chat run openai/gpt-oss "Explain what Docker is"
+
+# Use pipe for input
+echo "What is Kubernetes?" | npx berget chat run openai/gpt-oss
+```
+
+### Practical Use Cases
+
+#### 1. Git Commit Messages
 
 ```bash
-berget auth login
+# Generate commit message from git diff
+git diff | npx berget chat run openai/gpt-oss "Create a conventional commit message for this diff. Reply with only the message:"
+
+# Use as alias
+alias gitcommit='git diff | npx berget chat run openai/gpt-oss "Generate a conventional commit message for this diff. Reply with only the commit message, nothing else:"'
 ```
 
-This will open a browser window to authenticate with Berget. After successful authentication, your access token and refresh token will be stored securely in `~/.berget/auth.json`.
+#### 2. Code Review and Explanations
 
-### Token Refresh
+```bash
+# Explain code
+cat src/main.js | npx berget chat run openai/gpt-oss "Explain what this code does:"
 
-The CLI automatically handles token refresh when:
+# Find bugs
+cat problematic-file.py | npx berget chat run openai/gpt-oss "Analyze this code and find potential bugs:"
 
-1. The access token is about to expire (within 10 minutes of expiration)
-2. A request returns a 401 Unauthorized error
+# Improvement suggestions
+git diff | npx berget chat run openai/gpt-oss "Give suggestions for improvements to this code change:"
+```
 
-The refresh mechanism uses the stored refresh token to obtain a new access token without requiring you to log in again. If the refresh token itself is expired or invalid, you'll be prompted to log in again.
+#### 3. Documentation
+
+```bash
+# Generate README
+ls -la | npx berget chat run openai/gpt-oss "Create a README.md for this project based on the file structure:"
+
+# Comment code
+cat uncommented-code.js | npx berget chat run openai/gpt-oss "Add JSDoc comments to this code:"
+```
+
+#### 4. System Administration
+
+```bash
+# Analyze logs
+tail -n 100 /var/log/nginx/error.log | npx berget chat run openai/gpt-oss "Analyze these error logs and suggest solutions:"
+
+# Explain commands
+npx berget chat run openai/gpt-oss "Explain what this bash command does: find . -name '*.js' -exec grep -l 'TODO' {} \;"
+```
+
+## Useful Bash/Zsh Aliases
+
+Add these to your `~/.bashrc`, `~/.zshrc` or similar:
+
+```bash
+# Git-related aliases
+alias gai='git diff | npx berget chat run openai/gpt-oss "Generate a conventional commit message for this diff. Reply with only the commit message, nothing else:"'
+alias gexplain='git log --oneline -10 | npx berget chat run openai/gpt-oss "Explain what these commits do:"'
+alias gsec='~/bin/security-check'
+
+# Code-related aliases
+alias explain='npx berget chat run openai/gpt-oss "Explain this code:"'
+alias review='npx berget chat run openai/gpt-oss "Review this code and give improvement suggestions:"'
+alias debug='npx berget chat run openai/gpt-oss "Find and explain potential bugs in this code:"'
+
+# Documentation aliases
+alias docgen='npx berget chat run openai/gpt-oss "Generate documentation for this code:"'
+alias readme='ls -la | npx berget chat run openai/gpt-oss "Create a README.md for this project:"'
+
+# System aliases
+alias loganalyze='npx berget chat run openai/gpt-oss "Analyze these logs and suggest solutions:"'
+alias cmdexplain='npx berget chat run openai/gpt-oss "Explain this command:"'
+
+# Quick AI assistant
+alias ai='npx berget chat run openai/gpt-oss'
+alias ask='npx berget chat run openai/gpt-oss'
+```
+
+## Advanced Examples
+
+See the `examples/` folder for complete scripts:
+
+- **smart-commit.sh** - Automatic generation of conventional commit messages
+- **ai-review.sh** - AI-driven code review
+- **security-check.sh** - Security review of commits
+
+```bash
+# Copy example scripts
+cp examples/*.sh ~/bin/
+chmod +x ~/bin/*.sh
+
+# Use them
+~/bin/smart-commit.sh
+~/bin/ai-review.sh src/main.js
+~/bin/security-check.sh
+```
+
+## Environment Variables
+
+```bash
+# API key (recommended)
+export BERGET_API_KEY=sk_ber_your_api_key_here
+
+# Debug mode
+export LOG_LEVEL=debug
+
+# Custom API base URL (if using your own instance)
+export API_BASE_URL=https://your-custom-api.example.com
+```
+
+## Tips and Tricks
+
+1. **Use pipes**: Combine with other Unix tools for powerful workflows
+2. **Short prompts**: Be specific but concise in your prompts for best results
+3. **Streaming**: Streaming is enabled by default for faster responses
+4. **Model selection**: Experiment with different models for different tasks
+5. **Aliases**: Create aliases for common use cases to save time
+
+## Command Reference
+
+- `auth login` - Login to Berget
+- `auth logout` - Logout from Berget
+- `auth whoami` - Show current user information
+- `api-keys list` - List API keys
+- `api-keys create` - Create a new API key
+- `models list` - List available AI models
+- `chat run` - Start a chat session with an AI model
+- `chat list` - List available chat models
+
+For a complete list of commands, run:
+
+```bash
+npx berget --help
+```
+
+## Troubleshooting
+
+```bash
+# Enable debug mode
+npx berget --debug chat run openai/gpt-oss "test"
+
+# Check authentication
+npx berget auth whoami
+
+# List available models
+npx berget chat list
+
+# Check API key status
+npx berget api-keys list
+```
 
 ## Development
 
@@ -36,12 +196,12 @@ The refresh mechanism uses the stored refresh token to obtain a new access token
 Clone the repository and install dependencies:
 
 ```bash
-git clone https://github.com/berget/cli.git
+git clone https://github.com/berget-ai/cli.git
 cd cli
 npm install
 ```
 
-### Testing Locally
+### Test Locally
 
 Use the `start` script to test the CLI locally with the `--local` flag:
 
@@ -62,31 +222,10 @@ npm start -- auth whoami
 npm start -- auth whoami --debug
 ```
 
-The `--debug` flag provides detailed information about token refresh attempts and API responses.
-
-### Testing Token Refresh
-
-To test the token refresh mechanism:
+## Contributing
 
-1. Log in with `npm start -- auth login`
-2. Make a request that requires authentication, like `npm start -- auth whoami`
-3. To force a token refresh, you can:
-   - Wait until the token is close to expiration
-   - Manually edit `~/.berget/auth.json` and set `expires_at` to a past timestamp
-   - Use the `--debug` flag to see the token refresh process in action
+Berget CLI is open source. Contributions are welcome!
 
-## Commands
-
-- `auth login` - Log in to Berget
-- `auth logout` - Log out from Berget
-- `auth whoami` - Show current user information
-- `api-keys list` - List API keys
-- `api-keys create` - Create a new API key
-- `models list` - List available AI models
-- `chat run` - Start a chat session with an AI model
-
-For a complete list of commands, run:
-
-```bash
-berget --help
-```
+- GitHub: [berget-ai/cli](https://github.com/berget-ai/cli)
+- Issues: [Report bugs](https://github.com/berget-ai/cli/issues)
+- Documentation: [docs.berget.ai](https://docs.berget.ai)

package/TODO.md

@@ -1,10 +1,12 @@
 # Berget CLI - TODO
 
 ## Implementerade funktioner
+
 - [x] Inloggning med BankID
 - [x] Skapa och hantera API-nycklar
 
 ## Kommande funktioner
+
 - [ ] Implementera riktiga API-anrop för klusterhantering
 - [ ] Implementera riktiga API-anrop för Flux-integration
 - [ ] Implementera riktiga API-anrop för Helm-kommandon