@qwickapps/qwickbrain-proxy 1.0.0

package/.github/workflows/publish.yml

@@ -0,0 +1,92 @@
+# NPM Publish Workflow for Public Repos
+# Copy this file to .github/workflows/publish.yml in each public repo
+#
+# Required secrets:
+#   NPM_TOKEN - npm automation token with publish permissions
+
+name: Publish to npm
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - 'package.json'
+      - 'src/**'
+
+  # Allow manual publish
+  workflow_dispatch:
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          registry-url: 'https://registry.npmjs.org'
+
+      - name: Install dependencies
+        run: npm install --legacy-peer-deps
+
+      - name: Build
+        run: npm run build
+
+      - name: Run validation
+        run: |
+          if grep -q '"validate"' package.json; then
+            echo "Running validation..."
+            npm run validate
+          else
+            echo "No validation script found, skipping"
+          fi
+
+      - name: Check if version changed
+        id: version
+        run: |
+          PACKAGE_NAME=$(node -p "require('./package.json').name")
+          LOCAL_VERSION=$(node -p "require('./package.json').version")
+
+          # Get published version (returns empty if not published)
+          PUBLISHED_VERSION=$(npm view "$PACKAGE_NAME" version 2>/dev/null || echo "")
+
+          echo "Package: $PACKAGE_NAME"
+          echo "Local version: $LOCAL_VERSION"
+          echo "Published version: $PUBLISHED_VERSION"
+
+          if [ "$LOCAL_VERSION" != "$PUBLISHED_VERSION" ]; then
+            echo "should_publish=true" >> $GITHUB_OUTPUT
+            echo "version=$LOCAL_VERSION" >> $GITHUB_OUTPUT
+          else
+            echo "should_publish=false" >> $GITHUB_OUTPUT
+            echo "Version $LOCAL_VERSION already published"
+          fi
+
+      - name: Publish to npm
+        if: steps.version.outputs.should_publish == 'true'
+        run: npm publish --access public --ignore-scripts
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+
+      - name: Create GitHub Release
+        if: steps.version.outputs.should_publish == 'true'
+        uses: actions/create-release@v1
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        with:
+          tag_name: v${{ steps.version.outputs.version }}
+          release_name: v${{ steps.version.outputs.version }}
+          body: |
+            Published to npm: https://www.npmjs.com/package/${{ github.repository }}
+
+            Install:
+            ```bash
+            npm install @qwickapps/${{ github.event.repository.name }}@${{ steps.version.outputs.version }}
+            ```
+          draft: false
+          prerelease: false

package/CHANGELOG.md

@@ -0,0 +1,47 @@
+# Changelog
+
+All notable changes to the QwickBrain MCP Proxy will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.0.0] - 2025-01-08
+
+### Added
+
+- **MCP Proxy Server**: Local MCP proxy server for QwickBrain with stdio communication
+- **SQLite Cache**: Local caching for workflows, rules, documents, and memories with configurable TTL
+- **Multi-Transport Support**: Three connection modes - SSE (Server-Sent Events), MCP (stdio), and HTTP (REST API)
+- **Auto-Reconnect**: Automatic reconnection to QwickBrain server with exponential backoff
+- **Graceful Degradation**: Serves stale cached data when QwickBrain server is unavailable
+- **Write Queue**: Queues write operations when offline, syncs when reconnected
+- **Health Monitoring**: Continuous health checks and connection state management
+- **CLI Commands**:
+  - `init` - Initialize configuration
+  - `serve` - Start the proxy server
+  - `status` - Check current configuration and cache
+  - `config show/get/set` - Configuration management
+- **Cache Strategy**: Intelligent caching with different TTL for different content types:
+  - Workflows: 24h (global, rarely changes)
+  - Rules: 24h (global, rarely changes)
+  - Documents: 6h (project-scoped FRDs, designs)
+  - Memories: 1h (project context, updated frequently)
+- **Configuration Management**: JSON-based configuration at `~/.qwickbrain/config.json`
+- **Database Migrations**: Drizzle ORM-based schema migrations
+
+### Changed
+
+- **License**: Updated from MIT to PolyForm Shield 1.0.0
+- **Package Location**: Moved to `packages/qwickbrain-proxy` for public publishing
+
+### Technical Details
+
+- TypeScript implementation with full type safety
+- MCP SDK integration for Model Context Protocol compliance
+- Better-SQLite3 for high-performance local caching
+- Commander.js for CLI interface
+- Drizzle ORM for database schema management
+- Zod for configuration validation
+- Comprehensive test suite with Vitest
+
+[1.0.0]: https://github.com/qwickapps/qwickbrain-proxy/releases/tag/v1.0.0

package/LICENSE

@@ -0,0 +1,45 @@
+# QwickBrain Proxy License
+
+This software is licensed under the **PolyForm Shield License 1.0.0**.
+
+## Summary
+
+- **Free to use** for non-competitive purposes
+- **Source code available** for learning and development
+- **Cannot be used** to compete with QwickApps
+- **Cannot be reverse engineered** for competitive purposes
+- **Cannot be redistributed** in competitive products
+
+## Full License Text
+
+See https://polyformproject.org/licenses/shield/1.0.0/ for complete terms.
+
+## What This Means
+
+### Permitted Uses:
+- Internal business applications
+- Learning and educational projects
+- Non-competitive commercial applications
+- Academic research and teaching
+- Contributing to this project
+- Building applications that use this proxy
+
+### Prohibited Uses:
+- Creating competing MCP proxy solutions
+- Building competing developer tools or AI infrastructure
+- Reselling or redistributing as a competing product
+- Reverse engineering to create competitive products
+
+## Commercial Licensing
+
+If your use case might be competitive or you need different terms, contact us at **legal@qwickapps.com** for commercial licensing options.
+
+## Questions?
+
+- Email: legal@qwickapps.com
+- Website: https://qwickapps.com
+- Repository: https://github.com/qwickapps/qwickbrain-proxy
+
+---
+
+Copyright (c) 2025 QwickApps. All rights reserved.

package/README.md

@@ -0,0 +1,165 @@
+# QwickBrain MCP Proxy
+
+Local MCP proxy for QwickBrain with caching and resilience features.
+
+## Features
+
+- **Local caching**: SQLite-based cache for workflows, rules, documents, and memories
+- **Auto-reconnect**: Automatic reconnection to QwickBrain server with exponential backoff
+- **Graceful degradation**: Serves stale cached data when QwickBrain is unavailable
+- **Write queue**: Queues write operations when offline, syncs when reconnected
+- **Health monitoring**: Continuous health checks and connection state management
+
+## Installation
+
+```bash
+npm install -g @qwickapps/qwickbrain-proxy
+```
+
+## Configuration
+
+### Initialize
+
+```bash
+qwickbrain-proxy init
+```
+
+This creates a default configuration at `~/.qwickbrain/config.json` with:
+- QwickBrain URL: `http://macmini-devserver.local:3000`
+- Connection mode: `sse` (Server-Sent Events)
+- Cache directory: `~/.qwickbrain/cache`
+
+### Connection Modes
+
+The proxy supports three connection modes:
+
+1. **SSE (Server-Sent Events)** - Default, for remote QwickBrain servers
+2. **MCP (stdio)** - For local MCP server processes
+3. **HTTP** - Direct HTTP REST API calls
+
+Configure mode:
+```bash
+# SSE mode (default)
+qwickbrain-proxy config set qwickbrain.mode sse
+qwickbrain-proxy config set qwickbrain.url http://macmini-devserver.local:3000
+
+# MCP stdio mode
+qwickbrain-proxy config set qwickbrain.mode mcp
+qwickbrain-proxy config set qwickbrain.command npx
+qwickbrain-proxy config set qwickbrain.args '["@qwickapps/qwickbrain-server"]'
+
+# HTTP mode
+qwickbrain-proxy config set qwickbrain.mode http
+qwickbrain-proxy config set qwickbrain.url http://qwickbrain.qwickapps.com
+```
+
+### View Configuration
+
+```bash
+# Show all configuration
+qwickbrain-proxy config show
+
+# Get specific value
+qwickbrain-proxy config get qwickbrain.url
+```
+
+## Usage
+
+### Start the Proxy
+
+```bash
+# Start the proxy server (runs in stdio mode for MCP)
+qwickbrain-proxy serve
+```
+
+The proxy runs in stdio mode, communicating via standard input/output with the MCP client (Claude Code).
+
+### Check Status
+
+```bash
+qwickbrain-proxy status
+```
+
+Shows current configuration and cache location.
+
+## Claude Code Configuration
+
+Add to your Claude Code MCP configuration:
+
+```json
+{
+  "mcpServers": {
+    "qwickbrain": {
+      "command": "qwickbrain-proxy",
+      "args": ["serve"]
+    }
+  }
+}
+```
+
+## Cache Strategy
+
+| Content Type | Default TTL | Offline | Notes |
+|--------------|-------------|---------|-------|
+| workflows | 24h (86400s) | ✓ | Global, rarely changes |
+| rules | 24h (86400s) | ✓ | Global, rarely changes |
+| documents | 6h (21600s) | ✓ | Project-scoped FRDs, designs |
+| memories | 1h (3600s) | ✓ | Project context, updated frequently |
+
+Cache is automatically populated on first access and refreshed when TTL expires.
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Run in development mode (with watch)
+npm run dev
+
+# Run tests
+npm test
+
+# Format code
+npm run format
+```
+
+## Architecture
+
+```
+Claude Code (MCP Client)
+    ↓ (stdio)
+qwickbrain-proxy (MCP Server)
+    ├─ Local Cache (SQLite)
+    │  ├─ Documents (workflows, rules, FRDs, designs)
+    │  ├─ Memories (project context)
+    │  └─ Sync Queue (offline writes)
+    ├─ Connection Manager
+    │  ├─ Health checks
+    │  ├─ Auto-reconnect with exponential backoff
+    │  └─ Graceful degradation
+    └─ QwickBrain Client (multi-mode)
+       ├─ SSE (Server-Sent Events) → QwickBrain Server
+       ├─ MCP (stdio) → Local QwickBrain Server
+       └─ HTTP (REST API) → Cloud QwickBrain Server
+```
+
+**Connection Flow:**
+1. Claude Code requests document via MCP
+2. Proxy checks local cache (SQLite)
+3. If cached and fresh, returns immediately
+4. If expired or missing, fetches from QwickBrain (if connected)
+5. Updates cache and returns data
+6. If offline, serves stale cache with metadata indicating age
+
+## License
+
+This project is licensed under the [PolyForm Shield License 1.0.0](LICENSE).
+
+**Summary:**
+- Free to use for non-competitive purposes
+- Source code available for learning and development
+- Cannot be used to compete with QwickApps
+- Commercial licensing available for competitive use cases
+
+For questions about licensing, contact legal@qwickapps.com

package/dist/bin/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/bin/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/bin/cli.ts"],"names":[],"mappings":""}

package/dist/bin/cli.js

@@ -0,0 +1,142 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { createDatabase, runMigrations } from '../db/client.js';
+import { ProxyServer } from '../lib/proxy-server.js';
+import { ConfigSchema } from '../types/config.js';
+import { join } from 'path';
+import { homedir } from 'os';
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'fs';
+import { VERSION } from '../version.js';
+const DEFAULT_CONFIG_DIR = join(homedir(), '.qwickbrain');
+const DEFAULT_CONFIG_PATH = join(DEFAULT_CONFIG_DIR, 'config.json');
+function loadConfig() {
+    if (!existsSync(DEFAULT_CONFIG_PATH)) {
+        return ConfigSchema.parse({});
+    }
+    try {
+        const raw = readFileSync(DEFAULT_CONFIG_PATH, 'utf-8');
+        const parsed = JSON.parse(raw);
+        return ConfigSchema.parse(parsed);
+    }
+    catch (error) {
+        console.error('Failed to load config:', error);
+        return ConfigSchema.parse({});
+    }
+}
+function saveConfig(config) {
+    mkdirSync(DEFAULT_CONFIG_DIR, { recursive: true });
+    writeFileSync(DEFAULT_CONFIG_PATH, JSON.stringify(config, null, 2), 'utf-8');
+}
+const program = new Command();
+program
+    .name('qwickbrain-proxy')
+    .description('Local MCP proxy for QwickBrain with caching and resilience')
+    .version(VERSION);
+program
+    .command('serve')
+    .description('Start the MCP proxy server (stdio mode)')
+    .action(async () => {
+    try {
+        const config = loadConfig();
+        const { db } = createDatabase(config.cache.dir);
+        // Run migrations to ensure database schema is up to date
+        try {
+            runMigrations(db);
+        }
+        catch (migrationError) {
+            console.error('Failed to run database migrations:', migrationError);
+            console.error('Please ensure the database directory is writable and try again.');
+            process.exit(1);
+        }
+        const server = new ProxyServer(db, config);
+        process.on('SIGINT', async () => {
+            console.error('\nShutting down...');
+            await server.stop();
+            process.exit(0);
+        });
+        await server.start();
+    }
+    catch (error) {
+        console.error('Failed to start server:', error);
+        process.exit(1);
+    }
+});
+program
+    .command('init')
+    .description('Initialize configuration')
+    .action(async () => {
+    console.log('QwickBrain Proxy Configuration');
+    console.log('==============================\n');
+    // Simple init - create default config
+    const config = ConfigSchema.parse({
+        qwickbrain: {
+            url: 'http://macmini-devserver.local:3000',
+        },
+    });
+    saveConfig(config);
+    console.log(`Configuration saved to: ${DEFAULT_CONFIG_PATH}`);
+    console.log('\nDefault settings:');
+    console.log(`  QwickBrain URL: ${config.qwickbrain.url}`);
+    console.log(`  Cache directory: ${join(homedir(), '.qwickbrain', 'cache')}`);
+    console.log('\nTo customize, edit the config file or use "qwickbrain-proxy config" commands.');
+});
+const configCmd = program.command('config').description('Manage configuration');
+configCmd
+    .command('get <key>')
+    .description('Get a configuration value')
+    .action((key) => {
+    const config = loadConfig();
+    const value = key.split('.').reduce((obj, k) => obj?.[k], config);
+    console.log(value !== undefined ? value : 'Not set');
+});
+configCmd
+    .command('set <key> <value>')
+    .description('Set a configuration value')
+    .action((key, value) => {
+    const config = loadConfig();
+    const keys = key.split('.');
+    const lastKey = keys.pop();
+    const target = keys.reduce((obj, k) => {
+        if (!obj[k])
+            obj[k] = {};
+        return obj[k];
+    }, config);
+    // Try to parse as JSON, otherwise use as string
+    try {
+        target[lastKey] = JSON.parse(value);
+    }
+    catch {
+        target[lastKey] = value;
+    }
+    // Validate against schema to prevent bypassing validation
+    try {
+        const validatedConfig = ConfigSchema.parse(config);
+        saveConfig(validatedConfig);
+        console.log(`Updated ${key} = ${value}`);
+    }
+    catch (error) {
+        console.error('Configuration validation failed:', error instanceof Error ? error.message : String(error));
+        process.exit(1);
+    }
+});
+configCmd
+    .command('show')
+    .description('Show current configuration')
+    .action(() => {
+    const config = loadConfig();
+    console.log(JSON.stringify(config, null, 2));
+});
+program
+    .command('status')
+    .description('Show proxy status')
+    .action(() => {
+    const config = loadConfig();
+    console.log('QwickBrain Proxy Status');
+    console.log('======================\n');
+    console.log(`Config file: ${DEFAULT_CONFIG_PATH}`);
+    console.log(`Config exists: ${existsSync(DEFAULT_CONFIG_PATH) ? 'Yes' : 'No'}`);
+    console.log(`QwickBrain URL: ${config.qwickbrain.url}`);
+    console.log(`Cache directory: ${config.cache.dir || join(homedir(), '.qwickbrain', 'cache')}`);
+});
+program.parse();
+//# sourceMappingURL=cli.js.map

package/dist/bin/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/bin/cli.ts"],"names":[],"mappings":"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"}

package/dist/db/client.d.ts

@@ -0,0 +1,10 @@
+import Database from 'better-sqlite3';
+import { drizzle } from 'drizzle-orm/better-sqlite3';
+import * as schema from './schema.js';
+export declare function createDatabase(cacheDir?: string): {
+    db: ReturnType<typeof drizzle<typeof schema>>;
+    sqlite: Database.Database;
+};
+export declare function runMigrations(db: ReturnType<typeof drizzle>): void;
+export type DB = ReturnType<typeof createDatabase>['db'];
+//# sourceMappingURL=client.d.ts.map

package/dist/db/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/db/client.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAErD,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AAOtC,wBAAgB,cAAc,CAAC,QAAQ,GAAE,MAA0B,GAAG;IACpE,EAAE,EAAE,UAAU,CAAC,OAAO,OAAO,CAAC,OAAO,MAAM,CAAC,CAAC,CAAC;IAC9C,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAA;CAC1B,CAaA;AAED,wBAAgB,aAAa,CAAC,EAAE,EAAE,UAAU,CAAC,OAAO,OAAO,CAAC,QAG3D;AAED,MAAM,MAAM,EAAE,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,IAAI,CAAC,CAAC"}

package/dist/db/client.js

@@ -0,0 +1,23 @@
+import Database from 'better-sqlite3';
+import { drizzle } from 'drizzle-orm/better-sqlite3';
+import { migrate } from 'drizzle-orm/better-sqlite3/migrator';
+import * as schema from './schema.js';
+import { join } from 'path';
+import { homedir } from 'os';
+import { mkdirSync } from 'fs';
+const DEFAULT_CACHE_DIR = join(homedir(), '.qwickbrain', 'cache');
+export function createDatabase(cacheDir = DEFAULT_CACHE_DIR) {
+    // Ensure cache directory exists
+    mkdirSync(cacheDir, { recursive: true });
+    const dbPath = join(cacheDir, 'qwickbrain.db');
+    const sqlite = new Database(dbPath);
+    // Enable WAL mode for better concurrency
+    sqlite.pragma('journal_mode = WAL');
+    const db = drizzle(sqlite, { schema });
+    return { db, sqlite };
+}
+export function runMigrations(db) {
+    // Drizzle will look for migrations in drizzle/ directory
+    migrate(db, { migrationsFolder: './drizzle' });
+}
+//# sourceMappingURL=client.js.map

package/dist/db/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/db/client.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AACrD,OAAO,EAAE,OAAO,EAAE,MAAM,qCAAqC,CAAC;AAC9D,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAC7B,OAAO,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAE/B,MAAM,iBAAiB,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,aAAa,EAAE,OAAO,CAAC,CAAC;AAElE,MAAM,UAAU,cAAc,CAAC,WAAmB,iBAAiB;IAIjE,gCAAgC;IAChC,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEzC,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC;IAC/C,MAAM,MAAM,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC;IAEpC,yCAAyC;IACzC,MAAM,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;IAEpC,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IAEvC,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,EAA8B;IAC1D,yDAAyD;IACzD,OAAO,CAAC,EAAE,EAAE,EAAE,gBAAgB,EAAE,WAAW,EAAE,CAAC,CAAC;AACjD,CAAC"}