berget 2.2.6 → 2.2.8

package/.github/workflows/publish.yml

@@ -22,7 +22,7 @@ jobs:
       - name: Setup Node.js
         uses: actions/setup-node@v4
         with:
-          node-version: '18'
+          node-version: '22'
           cache: 'npm'
 
       - name: Install dependencies
@@ -47,7 +47,7 @@ jobs:
       - name: Setup Node.js
         uses: actions/setup-node@v4
         with:
-          node-version: '18'
+          node-version: '22'
           registry-url: 'https://registry.npmjs.org'
           cache: 'npm'
 

package/.github/workflows/test.yml

@@ -13,7 +13,7 @@ jobs:
     runs-on: [infra-runner-set]
     strategy:
       matrix:
-        node-version: [18, 20]
+        node-version: [22]
 
     steps:
       - name: Checkout code
@@ -28,11 +28,17 @@ jobs:
       - name: Install dependencies
         run: npm ci
 
+      - name: Check TypeScript
+        run: npm run typecheck
+
+      - name: Run ESLint
+        run: npm run lint
+
+      - name: Check formatting with Prettier
+        run: npm run format:check
+
       - name: Run tests
         run: npm run test:run
 
       - name: Build project
         run: npm run build
-
-      - name: Check TypeScript
-        run: npx tsc --noEmit

package/.husky/pre-commit

@@ -0,0 +1 @@
+npx lint-staged

package/.prettierignore

@@ -0,0 +1,15 @@
+node_modules
+dist
+build
+*.lock
+package-lock.json
+.lockfile
+.husky
+coverage
+.nyc_output
+test-results
+playwright-report
+.pi
+env
+.aider*
+.env

package/.prettierrc

@@ -1,6 +1,10 @@
 {
+  "semi": true,
+  "singleQuote": true,
   "tabWidth": 2,
-  "useTabs": false,
-  "semi": false,
-  "singleQuote": true
+  "trailingComma": "all",
+  "printWidth": 100,
+  "arrowParens": "always",
+  "bracketSpacing": true,
+  "endOfLine": "lf"
 }

package/CONTRIBUTING.md

@@ -0,0 +1,38 @@
+# Contributing to Berget CLI
+
+Berget CLI is open source. Contributions are welcome!
+
+- 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)
+
+## Development Setup
+
+Clone the repository and install dependencies:
+
+```bash
+git clone https://github.com/berget-ai/cli.git
+cd cli
+npm install
+```
+
+## Testing Locally
+
+Use the `start` script to test the CLI locally with the `--local` flag:
+
+```bash
+npm start -- <command> [options]
+```
+
+For example:
+
+```bash
+# Test login
+npm start -- auth login
+
+# Test whoami
+npm start -- auth whoami
+
+# Test with debug output
+npm start -- auth whoami --debug
+```

package/README.md

@@ -1,6 +1,6 @@
 # Berget CLI
 
-A command-line tool for interacting with Berget AI's infrastructure and AI models.
+A command-line tool for interacting with [Berget AI](https://berget.ai).
 
 ## Installation
 
@@ -43,98 +43,6 @@ npx berget chat run openai/gpt-oss "Explain what Docker is"
 echo "What is Kubernetes?" | npx berget chat run openai/gpt-oss
 ```
 
-### Practical Use Cases
-
-#### 1. Git Commit Messages
-
-```bash
-# 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:"'
-```
-
-#### 2. Code Review and Explanations
-
-```bash
-# Explain code
-cat src/main.js | npx berget chat run openai/gpt-oss "Explain what this code does:"
-
-# Find bugs
-cat problematic-file.py | npx berget chat run openai/gpt-oss "Analyze this code and find potential bugs:"
-
-# Improvement suggestions
-git diff | npx berget chat run openai/gpt-oss "Give suggestions for improvements to this code change:"
-```
-
-#### 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
@@ -148,25 +56,8 @@ export LOG_LEVEL=debug
 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
@@ -189,43 +80,6 @@ npx berget chat list
 npx berget api-keys list
 ```
 
-## Development
-
-### Setup
-
-Clone the repository and install dependencies:
-
-```bash
-git clone https://github.com/berget-ai/cli.git
-cd cli
-npm install
-```
-
-### Test Locally
-
-Use the `start` script to test the CLI locally with the `--local` flag:
-
-```bash
-npm start -- <command> [options]
-```
-
-For example:
-
-```bash
-# Test login
-npm start -- auth login
-
-# Test whoami
-npm start -- auth whoami
-
-# Test with debug output
-npm start -- auth whoami --debug
-```
-
 ## Contributing
 
-Berget CLI is open source. Contributions are welcome!
-
-- 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)
+See [CONTRIBUTING.md](CONTRIBUTING.md) for development instructions.

package/dist/index.js

@@ -1,14 +1,13 @@
-#!/usr/bin/env node
 "use strict";
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+const chalk_1 = __importDefault(require("chalk"));
 const commander_1 = require("commander");
+const package_json_1 = require("./package.json");
 const commands_1 = require("./src/commands");
 const config_checker_1 = require("./src/utils/config-checker");
-const chalk_1 = __importDefault(require("chalk"));
-const package_json_1 = require("./package.json");
 process.env.DOTENV_CONFIG_OVERRIDE = 'true';
 require("dotenv/config");
 // Set version and description
@@ -38,15 +37,15 @@ if (process.argv.length <= 2) {
 }
 // Add helpful suggestions for common command mistakes
 const commonMistakes = {
-    login: 'auth login',
-    logout: 'auth logout',
-    whoami: 'auth whoami',
-    'list-models': 'models list',
-    'list-keys': 'api-keys list',
     'create-key': 'api-keys create',
+    init: 'code init',
     'list-clusters': 'clusters list',
+    'list-keys': 'api-keys list',
+    'list-models': 'models list',
+    login: 'auth login',
+    logout: 'auth logout',
     usage: 'billing usage',
-    init: 'code init',
+    whoami: 'auth whoami',
 };
 // Add error handler for unknown commands
 commander_1.program.on('command:*', (operands) => {
@@ -62,9 +61,9 @@ commander_1.program.on('command:*', (operands) => {
         const similarCommands = availableCommands.filter((cmd) => cmd.includes(unknownCommand) || unknownCommand.includes(cmd));
         if (similarCommands.length > 0) {
             console.log(chalk_1.default.yellow('Similar commands:'));
-            similarCommands.forEach((cmd) => {
+            for (const cmd of similarCommands) {
                 console.log(chalk_1.default.yellow(`  ${chalk_1.default.bold(`berget ${cmd}`)}`));
-            });
+            }
         }
         console.log(chalk_1.default.blue('\nRun `berget --help` for a list of available commands.'));
     }

package/dist/package.json

@@ -1,11 +1,14 @@
 {
     "name": "berget",
-    "version": "2.2.6",
+    "version": "2.2.8",
     "main": "dist/index.js",
     "bin": {
         "berget": "dist/index.js"
     },
     "private": false,
+    "engines": {
+        "node": ">=20.0.0"
+    },
     "publishConfig": {
         "access": "public"
     },
@@ -17,8 +20,14 @@
         "build": "tsc",
         "test": "vitest",
         "test:run": "vitest run",
+        "typecheck": "tsc --noEmit",
+        "lint": "eslint . --ext .ts,.tsx,.js",
+        "lint:fix": "eslint . --ext .ts,.tsx,.js --fix",
+        "format": "prettier --write .",
+        "format:check": "prettier --check .",
         "prepublishOnly": "npm run build",
-        "generate-types": "openapi-typescript https://api.berget.ai/openapi.json -o src/types/api.d.ts"
+        "generate-types": "openapi-typescript https://api.berget.ai/openapi.json -o src/types/api.d.ts",
+        "prepare": "husky"
     },
     "author": "Berget AI AB",
     "license": "MIT",
@@ -28,8 +37,18 @@
         "@types/marked": "^5.0.2",
         "@types/marked-terminal": "^6.1.1",
         "@types/node": "^20.11.20",
+        "@vitest/eslint-plugin": "^1.6.17",
+        "eslint": "^10.3.0",
+        "eslint-config-prettier": "^10.1.8",
+        "eslint-plugin-perfectionist": "^5.9.0",
+        "eslint-plugin-prettier": "^5.5.5",
+        "eslint-plugin-promise": "^7.3.0",
+        "husky": "^9.1.7",
+        "lint-staged": "^17.0.4",
+        "prettier": "^3.8.3",
         "tsx": "^4.19.3",
         "typescript": "^5.3.3",
+        "typescript-eslint": "^8.59.3",
         "vitest": "^1.0.0"
     },
     "dependencies": {
@@ -48,5 +67,14 @@
         "openapi-typescript": "^6.7.4",
         "readline": "^1.3.0",
         "zod": "^4.1.12"
+    },
+    "lint-staged": {
+        "*.{ts,tsx}": [
+            "eslint --fix",
+            "prettier --write"
+        ],
+        "*.{json,yml,yaml,md}": [
+            "prettier --write"
+        ]
     }
 }

package/dist/src/agents/app.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.agent = void 0;
+exports.agent = {
+    config: {
+        description: 'Expo + React Native apps; props-first, offline-aware, shared tokens.',
+        mode: 'primary',
+        name: 'app',
+        permission: {
+            bash: 'deny',
+            edit: 'allow',
+            webfetch: 'allow',
+        },
+        temperature: 0.4,
+        top_p: 0.9,
+    },
+    systemPrompt: `You are Berget Code App agent. Voice: Scandinavian calm—precise, concise, confident. Expo + React Native + TypeScript. Structure by components/hooks/services/navigation. Components are pure; data via props; refactor shared logic into hooks/stores. Share tokens with frontend. Mock data in /data via typed hooks; later replace with live APIs. Offline via SQLite/MMKV; notifications via Expo. Request permissions only when needed. Subtle, meaningful motion; light/dark parity.
+
+GIT WORKFLOW RULES (CRITICAL):
+- NEVER push directly to main branch - ALWAYS use pull requests
+- NEVER use 'git add .' - ALWAYS add specific files with 'git add path/to/file'
+- ALWAYS clean up test files, documentation files, and temporary artifacts before committing
+- ALWAYS ensure git history maintains production quality - no test commits, no debugging code
+- ALWAYS create descriptive commit messages following project conventions
+- ALWAYS run tests and build before creating PR
+
+CRITICAL: When all app implementation tasks are complete and ready for merge, ALWAYS invoke @quality subagent to handle testing, building, and complete PR management including URL provision.`,
+};

package/dist/src/agents/backend.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.agent = void 0;
+exports.agent = {
+    config: {
+        description: 'Functional, modular Koa + TypeScript services',
+        mode: 'primary',
+        name: 'backend',
+    },
+    systemPrompt: `# Backend Agent
+
+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`,
+};

package/dist/src/agents/devops.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.agent = void 0;
+exports.agent = {
+    config: {
+        description: 'Declarative GitOps infra with FluxCD, Kustomize, Helm, operators.',
+        mode: 'primary',
+        name: 'devops',
+        permission: {
+            bash: 'allow',
+            edit: 'allow',
+            webfetch: 'allow',
+        },
+        temperature: 0.3,
+        top_p: 0.8,
+    },
+    systemPrompt: `You are Berget Code DevOps agent. Voice: Scandinavian calm—precise, concise, confident. Start simple: k8s/{deployment,service,ingress}. Add FluxCD sync to repo and image automation. Use Kustomize bases/overlays (staging, production). Add dependencies via Helm from upstream sources; prefer native operators when available (CloudNativePG, cert-manager, external-dns). SemVer with -rc tags keeps CI environments current. Observability with Prometheus/Grafana. No manual kubectl in production—Git is the source of truth.
+
+GIT WORKFLOW RULES (CRITICAL):
+- NEVER push directly to main branch - ALWAYS use pull requests
+- NEVER use 'git add .' - ALWAYS add specific files with 'git add path/to/file'
+- ALWAYS clean up test files, documentation files, and temporary artifacts before committing
+- ALWAYS ensure git history maintains production quality - no test commits, no debugging code
+- ALWAYS create descriptive commit messages following project conventions
+- ALWAYS run tests and build before creating PR
+
+Helm Values Configuration Process:
+1. Documentation First Approach: Always fetch official documentation from Artifact Hub/GitHub for the specific chart version before writing values. Search Artifact Hub for exact chart version documentation, check the chart's GitHub repository for official docs and examples, verify the exact version being used in the deployment.
+2. Validation Requirements: Check for available validation schemas before committing YAML files. Use Helm's built-in validation tools (helm lint, helm template). Validate against JSON schema if available for the chart. Ensure YAML syntax correctness with linters.
+3. Standard Workflow: Identify chart name and exact version. Fetch official documentation from Artifact Hub/GitHub. Check for available schemas and validation tools. Write values according to official documentation. Validate against schema (if available). Test with helm template or helm lint. Commit validated YAML files.
+4. Quality Assurance: Never commit unvalidated Helm values. Use helm dependency update when adding new charts. Test rendering with helm template --dry-run before deployment. Document any custom values with comments referencing official docs.
+
+CRITICAL: When all devops implementation tasks are complete and ready for merge, ALWAYS invoke @quality subagent to handle testing, building, and complete PR management including URL provision.`,
+};

package/dist/src/agents/frontend.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.agent = void 0;
+exports.agent = {
+    config: {
+        description: 'Scandinavian, type-safe UIs with React, Tailwind, and Shadcn',
+        mode: 'primary',
+        name: 'frontend',
+    },
+    systemPrompt: `# Frontend Agent
+
+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`,
+};

package/dist/src/agents/fullstack.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.agent = void 0;
+exports.agent = {
+    config: {
+        description: 'Router/coordinator agent for full-stack development',
+        mode: 'primary',
+        name: 'fullstack',
+    },
+    systemPrompt: `# Fullstack Agent
+
+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`,
+};

package/dist/src/agents/index.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toPiPrompt = exports.toMarkdown = exports.toAgentTemplate = exports.getAllAgents = exports.getAgent = exports.agents = void 0;
+const app_js_1 = require("./app.js");
+const backend_js_1 = require("./backend.js");
+const devops_js_1 = require("./devops.js");
+const frontend_js_1 = require("./frontend.js");
+const fullstack_js_1 = require("./fullstack.js");
+const quality_js_1 = require("./quality.js");
+const security_js_1 = require("./security.js");
+const agents = {
+    app: app_js_1.agent,
+    backend: backend_js_1.agent,
+    devops: devops_js_1.agent,
+    frontend: frontend_js_1.agent,
+    fullstack: fullstack_js_1.agent,
+    quality: quality_js_1.agent,
+    security: security_js_1.agent,
+};
+exports.agents = agents;
+function getAgent(name) {
+    return agents[name];
+}
+exports.getAgent = getAgent;
+function getAllAgents() {
+    return Object.values(agents);
+}
+exports.getAllAgents = getAllAgents;
+function toAgentTemplate(agent) {
+    return {
+        content: agent.systemPrompt,
+        description: agent.config.description,
+        name: agent.config.name,
+    };
+}
+exports.toAgentTemplate = toAgentTemplate;
+function toMarkdown(agent) {
+    const { config, systemPrompt } = agent;
+    let frontmatter = `---\nname: ${config.name}\ndescription: ${config.description}\n`;
+    if (config.mode) {
+        frontmatter += `mode: ${config.mode}\n`;
+    }
+    if (config.temperature) {
+        frontmatter += `temperature: ${config.temperature}\n`;
+    }
+    if (config.top_p) {
+        frontmatter += `top_p: ${config.top_p}\n`;
+    }
+    if (config.permission) {
+        frontmatter += `permission:\n`;
+        for (const [key, value] of Object.entries(config.permission)) {
+            frontmatter += `  ${key}: ${value}\n`;
+        }
+    }
+    return `${frontmatter}---\n\n${systemPrompt}`;
+}
+exports.toMarkdown = toMarkdown;
+function toPiPrompt(agent) {
+    return agent.systemPrompt;
+}
+exports.toPiPrompt = toPiPrompt;