@qwickapps/qwickbrain-proxy 1.0.0

package/src/types/mcp.ts

@@ -0,0 +1,97 @@
+import { z } from 'zod';
+
+// Base MCP request schema
+export const MCPRequestSchema = z.object({
+  operation: z.string(),
+  arguments: z.record(z.unknown()).optional(),
+});
+
+export type MCPRequest = z.infer<typeof MCPRequestSchema>;
+
+// Document operations
+export const GetWorkflowArgsSchema = z.object({
+  name: z.string(),
+});
+
+export const GetDocumentArgsSchema = z.object({
+  name: z.string(),
+  doc_type: z.string(),
+  project: z.string().optional(),
+});
+
+export const CreateDocumentArgsSchema = z.object({
+  doc_type: z.string(),
+  name: z.string(),
+  content: z.string(),
+  project: z.string().optional(),
+  metadata: z.record(z.unknown()).optional(),
+});
+
+export const UpdateDocumentArgsSchema = z.object({
+  doc_type: z.string(),
+  name: z.string(),
+  project: z.string().optional(),
+  content: z.string().optional(),
+  metadata: z.record(z.unknown()).optional(),
+});
+
+export const ListDocumentsArgsSchema = z.object({
+  doc_type: z.string().optional(),
+  project: z.string().optional(),
+  limit: z.number().default(100),
+});
+
+export const SearchDocumentsArgsSchema = z.object({
+  query: z.string(),
+  doc_type: z.string().optional(),
+  project: z.string().optional(),
+  limit: z.number().default(10),
+  min_score: z.number().default(0.3),
+});
+
+// Memory operations
+export const GetMemoryArgsSchema = z.object({
+  name: z.string(),
+  project: z.string().optional(),
+});
+
+export const SetMemoryArgsSchema = z.object({
+  name: z.string(),
+  content: z.string(),
+  project: z.string().optional(),
+  metadata: z.record(z.unknown()).optional(),
+});
+
+// MCP Response with metadata
+export const MCPResponseMetadataSchema = z.object({
+  source: z.enum(['live', 'cache', 'stale_cache']),
+  age_seconds: z.number().optional(),
+  status: z.enum(['connected', 'disconnected', 'reconnecting', 'offline']),
+  warning: z.string().optional(),
+  cached_at: z.string().optional(),
+  latency_ms: z.number().optional(),
+});
+
+export type MCPResponseMetadata = z.infer<typeof MCPResponseMetadataSchema>;
+
+export const MCPResponseSchema = z.object({
+  data: z.unknown().optional(),
+  error: z.object({
+    code: z.string(),
+    message: z.string(),
+    suggestions: z.array(z.string()).optional(),
+  }).optional(),
+  _metadata: MCPResponseMetadataSchema,
+});
+
+export type MCPResponse = z.infer<typeof MCPResponseSchema>;
+
+// Connection states
+export const ConnectionState = z.enum([
+  'connected',
+  'disconnected',
+  'reconnecting',
+  'offline',
+]);
+
+export type ConnectionState = z.infer<typeof ConnectionState>;

package/src/version.ts

@@ -0,0 +1,11 @@
+import { readFileSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+const packageJsonPath = join(__dirname, '../package.json');
+const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
+
+export const VERSION = packageJson.version as string;

package/test/fixtures/test-mcp.json

@@ -0,0 +1,5 @@
+{
+  "jsonrpc": "2.0",
+  "id": 1,
+  "method": "tools/list"
+}

package/test-mcp-client.js

@@ -0,0 +1,67 @@
+#!/usr/bin/env node
+/**
+ * Test MCP client to verify the proxy works correctly
+ * Simulates how Claude Code communicates with the proxy
+ */
+
+import { spawn } from 'child_process';
+import { createInterface } from 'readline';
+
+const proxy = spawn('node', ['dist/bin/cli.js', 'serve'], {
+  stdio: ['pipe', 'pipe', 'pipe']
+});
+
+let messageId = 1;
+
+// Handle stderr (connection logs)
+const rl = createInterface({ input: proxy.stderr });
+rl.on('line', (line) => {
+  console.error('[PROXY]', line);
+});
+
+// Handle stdout (MCP responses)
+const responseReader = createInterface({ input: proxy.stdout });
+responseReader.on('line', (line) => {
+  console.log('[RESPONSE]', line);
+  try {
+    const response = JSON.parse(line);
+    console.log(JSON.stringify(response, null, 2));
+  } catch (e) {
+    // Not JSON, ignore
+  }
+});
+
+function sendRequest(method, params = {}) {
+  const request = {
+    jsonrpc: '2.0',
+    id: messageId++,
+    method,
+    params
+  };
+  console.log('[REQUEST]', JSON.stringify(request));
+  proxy.stdin.write(JSON.stringify(request) + '\n');
+}
+
+// Wait for proxy to start
+setTimeout(() => {
+  console.log('\n=== Testing tools/list ===');
+  sendRequest('tools/list');
+}, 2000);
+
+setTimeout(() => {
+  console.log('\n=== Testing get_workflow ===');
+  sendRequest('tools/call', {
+    name: 'get_workflow',
+    arguments: { name: 'feature' }
+  });
+}, 4000);
+
+setTimeout(() => {
+  console.log('\n=== Cleanup ===');
+  proxy.kill();
+  process.exit(0);
+}, 8000);
+
+proxy.on('exit', (code) => {
+  console.log(`Proxy exited with code ${code}`);
+});

package/test-proxy.sh

@@ -0,0 +1,25 @@
+#!/bin/bash
+# Test the QwickBrain proxy MCP server
+
+echo "Starting proxy server..."
+node dist/bin/cli.js serve &
+PROXY_PID=$!
+sleep 2
+
+echo "Testing tools/list..."
+echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | node dist/bin/cli.js serve 2>/dev/null &
+TEST_PID=$!
+sleep 1
+
+echo "Testing get_workflow..."
+echo '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"get_workflow","arguments":{"name":"feature"}}}' | node dist/bin/cli.js serve 2>/dev/null &
+TEST_PID2=$!
+sleep 2
+
+echo "Checking cache..."
+sqlite3 ~/.qwickbrain/cache/qwickbrain.db "SELECT doc_type, name FROM documents;"
+
+echo "Cleanup..."
+kill $PROXY_PID $TEST_PID $TEST_PID2 2>/dev/null || true
+
+echo "Done!"

package/tsconfig.json

@@ -0,0 +1,22 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "lib": ["ES2022"],
+    "moduleResolution": "bundler",
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "allowSyntheticDefaultImports": true,
+    "types": ["node"]
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist", "tests"]
+}