@gguf/coder 0.3.0 → 0.3.1

package/.editorconfig

@@ -0,0 +1,16 @@
+root = true
+
+[*]
+indent_style = tab
+end_of_line = lf
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true
+
+[*.yml]
+indent_style = space
+indent_size = 2
+
+[*.nix]
+indent_style = space
+indent_size = 2

package/.env.example

@@ -0,0 +1,63 @@
+# Environment Variables for Coder
+#
+# 1. Copy this file to .env and fill in your actual values
+# 2. Reference variables in agents.config.json using $VAR_NAME syntax
+#
+# Example in agents.config.json:
+# {
+#   "coder": {
+#     "providers": [{
+#       "apiKey": "$OPENROUTER_API_KEY",
+#       "models": ["$FALLBACK_MODEL"]
+#     }]
+#   }
+# }
+
+# API Keys for AI Providers
+OPENROUTER_API_KEY=your-openrouter-api-key-here
+ZAI_AUTH_TOKEN=your-zai-api-key-here
+ZAI_CODING_AUTH_TOKEN=your-zai-coding-api-key-here
+OPENAI_API_KEY=your-openai-api-key-here
+
+# Installation method override (npm, homebrew, nix, unknown)
+# Used for testing and debugging installation detection
+# CODER_INSTALL_METHOD=npm
+
+# Model Names (optional)
+FALLBACK_MODEL=your-fallback-model-name
+
+# Custom Directory Locations (optional)
+# Override default config directory location
+# Default: macOS: ~/Library/Preferences/coder
+#          Linux: ~/.config/coder
+#          Windows: %APPDATA%\coder
+CODER_CONFIG_DIR=/custom/path/to/config
+
+# Override default app data directory location
+# Default: macOS: ~/Library/Application Support/coder
+#          Linux: ~/.local/share/coder (or $XDG_DATA_HOME/coder)
+#          Windows: %APPDATA%\coder
+CODER_DATA_DIR=/custom/path/to/data
+
+# Cross-platform data directory override (mainly for testing)
+# Takes precedence over platform-specific defaults
+XDG_DATA_HOME=/custom/xdg/data
+
+# Logging Configuration (optional)
+CODER_LOG_LEVEL=debug
+CODER_LOG_TO_FILE=true
+CODER_LOG_TO_CONSOLE=true
+CODER_LOG_DIR=/custom/path/to/logs
+CODER_LOG_TRANSPORTS=default
+
+# Disable file logging entirely (optional)
+# CODER_LOG_DISABLE_FILE=true
+
+# Correlation Configuration (optional)
+CODER_CORRELATION_DEBUG=false
+CODER_CORRELATION_ENABLED=true
+CODER_CORRELATION_LEGACY_FALLBACK=false
+
+# MCP Server Environment Variables
+GITHUB_TOKEN=your-github-token
+GITHUB_PAT=your-github-personal-access-token

package/.gitattributes

@@ -0,0 +1 @@
+* text=auto eol=lf

package/.semgrepignore

@@ -0,0 +1,19 @@
+# Exclude test files from security scanning (not production code)
+**/*.spec.ts
+**/*.spec.tsx
+**/*.test.ts
+**/*.test.tsx
+
+# Exclude test directories
+**/test/**
+**/tests/**
+**/__tests__/**
+
+# Exclude configuration and build files
+**/.husky/**
+**/dist/**
+**/build/**
+**/node_modules/**
+
+# Exclude TypeScript declaration files
+**/*.d.ts

package/coder-dummy-file.ts

@@ -0,0 +1,52 @@
+// A simple file to give to models to test Coder's functionality
+
+export function greet(name: string): string {
+	return `Hello ${name}!`;
+}
+
+export function add(a: number, b: number): number {
+	return a + b;
+}
+
+export function multiply(x: number, y: number): number {
+	return x * y;
+}
+
+// More functions to make a medium-sized file
+
+export function subtract(a: number, b: number): number {
+	return a - b;
+}
+
+export function divide(a: number, b: number): number {
+	if (b === 0) {
+		throw new Error('Division by zero');
+	}
+	return a / b;
+}
+
+export function power(base: number, exponent: number): number {
+	return Math.pow(base, exponent);
+}
+
+export function sqrt(n: number): number {
+	return Math.sqrt(n);
+}
+
+export function abs(n: number): number {
+	return Math.abs(n);
+}
+
+export function round(n: number): number {
+	return Math.round(n);
+}
+
+export function floor(n: number): number {
+	return Math.floor(n);
+}
+
+export function ceil(n: number): number {
+	return Math.ceil(n);
+}
+
+// End of test file

package/coder.config.example.json

@@ -0,0 +1,59 @@
+{
+	"coder": {
+		"providers": [
+			{
+				"name": "OpenRouter",
+				"baseUrl": "https://openrouter.ai/api/v1",
+				"apiKey": "your-openrouter-api-key-here",
+				"models": ["openai/gpt-4o-mini", "anthropic/claude-3-haiku"]
+			},
+			{
+				"name": "GitHub Models",
+				"baseUrl": "https://models.github.ai/inference",
+				"apiKey": "your-github-token-here",
+				"models": ["openai/gpt-4o-mini", "openai/gpt-4o"]
+			},
+			{
+				"name": "Local Ollama",
+				"baseUrl": "http://localhost:11434/v1",
+				"models": ["llama3.2", "qwen2.5-coder"]
+			},
+			{
+				"name": "OpenAI Compatible",
+				"baseUrl": "http://localhost:1234/v1",
+				"apiKey": "optional-api-key-if-needed",
+				"models": ["local-model-1", "local-model-2"]
+			},
+			{
+				"name": "Z.ai",
+				"baseUrl": "https://api.z.ai/api/paas/v4/",
+				"apiKey": "your-z.ai-api-key",
+				"models": ["glm-4.7", "glm-4.5", "glm-4.5-air"]
+			},
+			{
+				"name": "Z.ai Coding Subscription",
+				"baseUrl": "https://api.z.ai/api/coding/paas/v4/",
+				"apiKey": "your-z.ai-coding-api-key",
+				"models": ["glm-4.7", "glm-4.5", "glm-4.5-air"]
+			}
+		],
+		"mcpServers": [
+			{
+				"name": "filesystem",
+				"command": "npx",
+				"args": [
+					"@modelcontextprotocol/server-filesystem",
+					"/path/to/allowed/directory"
+				]
+			},
+			{
+				"name": "github",
+				"command": "npx",
+				"args": ["@modelcontextprotocol/server-github"],
+				"env": {
+					"GITHUB_TOKEN": "your-github-token"
+				}
+			}
+		]
+	}
+}

package/coder.config.json

@@ -0,0 +1,13 @@
+{
+  "coder": {
+    "providers": [
+      {
+        "name": "lmstudio",
+        "models": [
+          "openai/gpt-oss-20b"
+        ],
+        "baseUrl": "http://localhost:1234/v1"
+      }
+    ]
+  }
+}

package/color_picker.html

@@ -0,0 +1,36 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8" />
+    <title>Random Color Picker</title>
+    <style>
+        body {
+            transition: background-color 0.5s;
+            font-family: Arial, sans-serif;
+            display: flex;
+            justify-content: center;
+            align-items: center;
+            height: 100vh;
+            margin: 0;
+        }
+        button {
+            padding: 1rem 2rem;
+            font-size: 1.2rem;
+            cursor: pointer;
+        }
+    </style>
+</head>
+<body>
+    <button id="pick">Pick Random Color</button>
+    <script>
+        function randomHex() {
+            const hex = Math.floor(Math.random()*0xFFFFFF).toString(16);
+            return '#' + ('000000' + hex).slice(-6);
+        }
+
+        document.getElementById('pick').addEventListener('click', () => {
+            document.body.style.backgroundColor = randomHex();
+        });
+    </script>
+</body>
+</html>

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "@gguf/coder",
 	"main": "dist/cli.js",
-	"version": "0.3.0",
+	"version": "0.3.1",
 	"description": "Coder",
 	"keywords": [
 		"ai",
@@ -21,13 +21,9 @@
 		"build": "tsc && tsc-alias",
 		"dev": "tsc --watch",
 		"start": "node dist/cli.js",
-		"prepublishOnly": "pnpm run build",
+		"prepublishOnly": "npm run build",
 		"prepare": "husky"
 	},
-	"files": [
-		"dist",
-		"source/app/prompts/main-prompt.md"
-	],
 	"dependencies": {
 		"@ai-sdk/openai-compatible": "2.0.0-beta.57",
 		"@anthropic-ai/tokenizer": "^0.0.4",
@@ -70,13 +66,5 @@
 		"tsc-alias": "^1.8.16",
 		"tsx": "^4.20.6",
 		"typescript": "^5.0.3"
-	},
-	"pnpm": {
-		"overrides": {
-			"glob@>=10.2.0 <10.5.0": ">=10.5.0",
-			"js-yaml@<3.14.2": ">=3.14.2",
-			"js-yaml@>=4.0.0 <4.1.1": ">=4.1.1",
-			"jws@<3.2.3": ">=3.2.3"
-		}
 	}
 }

package/scripts/extract-changelog.js

@@ -0,0 +1,73 @@
+#!/usr/bin/env node
+
+/**
+ * Extract changelog section for a specific version from CHANGELOG.md
+ * Usage: node scripts/extract-changelog.js [version]
+ * If no version is provided, reads from package.json
+ */
+
+import {readFileSync} from 'fs';
+import {dirname, join} from 'path';
+import {fileURLToPath} from 'url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const rootDir = join(__dirname, '..');
+
+// Get version from command line arg or package.json
+let version = process.argv[2];
+if (!version) {
+	const packageJson = JSON.parse(
+		readFileSync(join(rootDir, 'package.json'), 'utf-8'),
+	);
+	version = packageJson.version;
+}
+
+// Read CHANGELOG.md
+let changelogContent;
+try {
+	changelogContent = readFileSync(join(rootDir, 'CHANGELOG.md'), 'utf-8');
+} catch (error) {
+	console.error('Error reading CHANGELOG.md:', error.message);
+	process.exit(1);
+}
+
+// Extract section for this version
+// Support multiple formats:
+// 1. ## [version] - date (Keep a Changelog format)
+// 2. ## version (simple heading)
+// 3. # version (simple heading with single #)
+const versionPatterns = [
+	// Pattern 1: ## [version] or ## version
+	new RegExp(
+		`##+ \\[?${version.replace(
+			/\./g,
+			'\\.',
+		)}\\]?.*?\\n([\\s\\S]*?)(?=\\n##+ |$)`,
+	),
+	// Pattern 2: # version
+	new RegExp(
+		`#+ ${version.replace(/\./g, '\\.')}.*?\\n([\\s\\S]*?)(?=\\n#+ |$)`,
+	),
+];
+
+let match = null;
+for (const pattern of versionPatterns) {
+	match = changelogContent.match(pattern);
+	if (match) break;
+}
+
+if (!match) {
+	console.error(`No changelog entry found for version ${version}`);
+	console.error(
+		'Please add a changelog entry in CHANGELOG.md with one of these formats:',
+	);
+	console.error(`## [${version}] - ${new Date().toISOString().split('T')[0]}`);
+	console.error(`or`);
+	console.error(`# ${version}`);
+	process.exit(1);
+}
+
+// Output the changelog section (trim leading/trailing whitespace)
+const changelogSection = match[1].trim();
+console.log(changelogSection);

package/scripts/fetch-models.js

@@ -0,0 +1,143 @@
+#!/usr/bin/env node
+
+/**
+ * Post-install script to fetch and cache models.dev data
+ * This script runs after npm/pnpm install to ensure fresh model metadata
+ */
+
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import {request} from 'undici';
+import {xdgCache} from 'xdg-basedir';
+
+const MODELS_DEV_API_URL = 'https://models.dev/api.json';
+const CACHE_EXPIRATION_MS = 7 * 24 * 60 * 60 * 1000; // 7 days
+
+// Get cache directory
+const DEFAULT_CACHE_DIR =
+	process.platform === 'darwin'
+		? path.join(process.env.HOME || '~', 'Library', 'Caches')
+		: path.join(process.env.HOME || '~', '.cache');
+
+const cacheBase = xdgCache || DEFAULT_CACHE_DIR;
+const cacheDir = path.join(cacheBase, 'coder');
+const cacheFilePath = path.join(cacheDir, 'models.json');
+
+/**
+ * Fetch models data from models.dev
+ */
+async function fetchModels() {
+	console.log('Fetching model metadata from models.dev...');
+
+	try {
+		const response = await request(MODELS_DEV_API_URL, {
+			method: 'GET',
+			headersTimeout: 10000,
+			bodyTimeout: 30000,
+		});
+
+		if (response.statusCode !== 200) {
+			throw new Error(`HTTP ${response.statusCode}`);
+		}
+
+		const data = await response.body.json();
+
+		// Count models for logging
+		let totalModels = 0;
+		for (const provider of Object.values(data)) {
+			totalModels += Object.keys(provider.models).length;
+		}
+
+		console.log(
+			`✅ Successfully fetched ${totalModels} models from ${
+				Object.keys(data).length
+			} providers`,
+		);
+
+		return data;
+	} catch (error) {
+		console.warn('⚠️  Failed to fetch models.dev data:', error.message);
+		return null;
+	}
+}
+
+/**
+ * Ensure cache directory exists
+ */
+function ensureCacheDir() {
+	if (!fs.existsSync(cacheDir)) {
+		fs.mkdirSync(cacheDir, {recursive: true});
+	}
+}
+
+/**
+ * Write data to cache
+ */
+function writeCache(data) {
+	try {
+		ensureCacheDir();
+
+		const cached = {
+			data,
+			fetchedAt: Date.now(),
+			expiresAt: Date.now() + CACHE_EXPIRATION_MS,
+		};
+
+		fs.writeFileSync(cacheFilePath, JSON.stringify(cached, null, 2), 'utf-8');
+		console.log(`💾 Cached to: ${cacheFilePath}`);
+	} catch (error) {
+		console.warn('⚠️  Failed to write cache:', error.message);
+	}
+}
+
+/**
+ * Check if existing cache is valid
+ */
+function isCacheValid() {
+	try {
+		if (!fs.existsSync(cacheFilePath)) {
+			return false;
+		}
+
+		const content = fs.readFileSync(cacheFilePath, 'utf-8');
+		const cached = JSON.parse(content);
+
+		return Date.now() < cached.expiresAt;
+	} catch {
+		return false;
+	}
+}
+
+/**
+ * Main execution
+ */
+async function main() {
+	// Skip if in CI environment (don't spam models.dev API)
+	if (process.env.CI === 'true') {
+		console.log('ℹ️  Skipping models.dev fetch in CI environment');
+		return;
+	}
+
+	// Check if cache is still valid
+	if (isCacheValid()) {
+		console.log('✅ Models cache is still valid, skipping fetch');
+		return;
+	}
+
+	// Fetch and cache models data
+	const data = await fetchModels();
+
+	if (data) {
+		writeCache(data);
+	} else {
+		console.log('ℹ️  Installation will continue without model metadata cache');
+		console.log('ℹ️  Model metadata will be fetched on first use');
+	}
+}
+
+// Run the script
+main().catch(error => {
+	// Don't fail the installation if this script fails
+	console.error('⚠️  Post-install script error:', error.message);
+	process.exit(0); // Exit with success to not break installation
+});

package/scripts/test.sh

@@ -0,0 +1,40 @@
+#!/usr/bin/env bash
+
+# Test script that runs all test:all commands
+# Exit on first error
+set -e
+
+echo "🧪 Running all tests..."
+echo ""
+
+echo "📝 Checking code formatting..."
+pnpm test:format
+echo ""
+echo "✅ Format check passed"
+echo ""
+
+echo "🔍 Checking TypeScript types..."
+pnpm test:types
+echo ""
+echo "✅ Type check passed"
+echo ""
+
+echo "🔎 Running linter..."
+pnpm test:lint
+echo ""
+echo "✅ Lint check passed"
+echo ""
+
+echo "🧩 Running AVA tests..."
+pnpm test:ava
+echo ""
+echo "✅ AVA tests passed"
+echo ""
+
+echo "🗑️  Checking for unused code..."
+pnpm test:knip
+echo ""
+echo "✅ Knip check passed"
+echo ""
+
+echo "✅ Everything passes!"

package/scripts/update-homebrew-formula.sh

@@ -0,0 +1,125 @@
+#!/usr/bin/env bash
+# Update Homebrew formula version and SHA256 hash for a new release
+# Usage: ./scripts/update-homebrew-formula.sh <version>
+# Example: ./scripts/update-homebrew-formula.sh 1.15.0
+
+set -e
+
+VERSION=$1
+# FORMULA_FILE="Formula/coder.rb"
+NPM_PACKAGE="@gguf/coder"
+
+# Color codes for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+NC='\033[0m' # No Color
+
+if [ -z "$VERSION" ]; then
+  echo -e "${RED}Error: Version number required${NC}"
+  echo "Usage: $0 <version>"
+  echo "Example: $0 1.15.0"
+  exit 1
+fi
+
+echo -e "${YELLOW}Updating Homebrew formula to version ${VERSION}...${NC}"
+echo ""
+
+# Step 1: Update version in formula file
+echo "Step 1: Updating version number in ${FORMULA_FILE}..."
+NPM_URL="https://registry.npmjs.org/${NPM_PACKAGE}/-/coder-${VERSION}.tgz"
+
+if [[ "$OSTYPE" == "darwin"* ]]; then
+  # macOS requires -i '' for in-place editing
+  sed -i '' "s|url \"https://registry.npmjs.org/${NPM_PACKAGE}/-/coder-.*\.tgz\"|url \"${NPM_URL}\"|" "$FORMULA_FILE"
+else
+  # Linux
+  sed -i "s|url \"https://registry.npmjs.org/${NPM_PACKAGE}/-/coder-.*\.tgz\"|url \"${NPM_URL}\"|" "$FORMULA_FILE"
+fi
+
+# Step 2: Download tarball and calculate SHA256
+echo "Step 2: Downloading tarball from NPM..."
+echo "URL: ${NPM_URL}"
+
+TEMP_FILE=$(mktemp)
+trap "rm -f ${TEMP_FILE}" EXIT
+
+if ! curl -sSL "${NPM_URL}" -o "${TEMP_FILE}"; then
+  echo -e "${RED}Error: Failed to download tarball from NPM${NC}"
+  echo "Please verify that version ${VERSION} has been published to NPM"
+  echo "Check: https://www.npmjs.com/package/${NPM_PACKAGE}"
+  exit 1
+fi
+
+echo "Step 3: Calculating SHA256 hash..."
+if command -v shasum >/dev/null 2>&1; then
+  # macOS and some Linux systems
+  SHA256=$(shasum -a 256 "${TEMP_FILE}" | awk '{print $1}')
+elif command -v sha256sum >/dev/null 2>&1; then
+  # Most Linux systems
+  SHA256=$(sha256sum "${TEMP_FILE}" | awk '{print $1}')
+else
+  echo -e "${RED}Error: Neither shasum nor sha256sum found${NC}"
+  echo "Please install one of these tools to calculate SHA256 hashes"
+  exit 1
+fi
+
+if [ -z "$SHA256" ]; then
+  echo -e "${RED}Error: Failed to calculate SHA256 hash${NC}"
+  exit 1
+fi
+
+echo -e "${GREEN}Found hash: ${SHA256}${NC}"
+echo ""
+
+# Step 4: Update formula with real hash
+echo "Step 4: Updating formula with calculated hash..."
+if [[ "$OSTYPE" == "darwin"* ]]; then
+  sed -i '' "s/sha256 \".*\"/sha256 \"${SHA256}\"/" "$FORMULA_FILE"
+else
+  sed -i "s/sha256 \".*\"/sha256 \"${SHA256}\"/" "$FORMULA_FILE"
+fi
+
+# Step 5: Validate formula syntax
+echo "Step 5: Validating formula syntax..."
+if ! ruby -c "$FORMULA_FILE" > /dev/null 2>&1; then
+  echo -e "${RED}✗ Formula has syntax errors${NC}"
+  ruby -c "$FORMULA_FILE"
+  exit 1
+fi
+
+echo -e "${GREEN}✓ Formula syntax is valid${NC}"
+
+# Step 6: Audit formula (if brew is available)
+if command -v brew >/dev/null 2>&1; then
+  echo "Step 6: Auditing formula with Homebrew..."
+  # Note: brew audit with path doesn't work in current Homebrew versions
+  # This is a known limitation, so we skip it for now
+  echo -e "${YELLOW}Note: Automated brew audit is not available for local formulae${NC}"
+  echo -e "${YELLOW}Manual audit will be required after pushing to repository${NC}"
+else
+  echo -e "${YELLOW}Step 6: Skipping brew audit (brew not installed)${NC}"
+fi
+
+echo ""
+echo -e "${GREEN}════════════════════════════════════════════════${NC}"
+echo -e "${GREEN}Success! Homebrew formula updated to v${VERSION}${NC}"
+echo -e "${GREEN}════════════════════════════════════════════════${NC}"
+echo ""
+echo "Changes made to: ${FORMULA_FILE}"
+echo ""
+echo "Formula details:"
+echo "  Version: ${VERSION}"
+echo "  URL: ${NPM_URL}"
+echo "  SHA256: ${SHA256}"
+echo ""
+echo "Next steps:"
+echo "  1. Review the changes: git diff ${FORMULA_FILE}"
+echo "  2. Commit: git add ${FORMULA_FILE}"
+echo "  3. Commit: git commit -m 'chore: update homebrew formula to v${VERSION}'"
+echo "  4. Push: git push"
+echo ""
+echo "To test the formula locally:"
+echo "  1. brew tap mochiyaki/coder https://github.com/mochiyaki/coder"
+echo "  2. brew install coder"
+echo "  3. coder --help"