@simonren/quorum 0.7.0

package/dist/config.js

@@ -0,0 +1,179 @@
+/**
+ * Runtime configuration for quorum.
+ *
+ * Config file: ~/.config/quorum/config.json
+ *
+ * Semantics:
+ *   - Lazy, cached load. `getConfig()` returns the cached config or reads once.
+ *   - Missing file → defaults in memory (no write). Use `initConfig()` from the
+ *     server entry point to create the file with defaults on first launch.
+ *   - Invalid JSON or schema violations → fall back to defaults, warn on stderr.
+ *   - Partial user configs are deep-merged against defaults via Zod `.default()`.
+ *   - Tool-call arguments still override config (e.g. `reasoningEffort` on a
+ *     single `codex_review` call). Config only sets defaults.
+ */
+import { z } from 'zod';
+import { existsSync, mkdirSync, readFileSync, statSync, writeFileSync } from 'fs';
+import { dirname, join } from 'path';
+import { homedir } from 'os';
+// =============================================================================
+// SCHEMA
+// =============================================================================
+export const CodexConfigSchema = z
+    .object({
+    model: z.string().default('gpt-5.5'),
+    reasoningEffort: z.enum(['high', 'xhigh']).default('high'),
+    serviceTier: z.enum(['default', 'fast', 'flex']).default('fast'),
+    /** Consult-specific defaults — separate from review knobs because consult
+     * questions are deeper and warrant more reasoning. Users can override
+     * these to cap cost without affecting review behavior. */
+    consultReasoningEffort: z.enum(['high', 'xhigh']).default('xhigh'),
+    consultServiceTier: z.enum(['default', 'fast', 'flex']).default('fast'),
+    inactivityTimeoutMs: z
+        .object({
+        high: z.number().int().positive().default(180_000),
+        xhigh: z.number().int().positive().default(300_000),
+    })
+        .default({}),
+    maxTimeoutMs: z.number().int().positive().default(3_600_000),
+    maxBufferSize: z.number().int().positive().default(1_048_576),
+})
+    .default({});
+export const ClaudeConfigSchema = z
+    .object({
+    model: z.string().default('opus'),
+    inactivityTimeoutMs: z.number().int().positive().default(300_000),
+    maxTimeoutMs: z.number().int().positive().default(3_600_000),
+    maxBufferSize: z.number().int().positive().default(1_048_576),
+})
+    .default({});
+export const GeminiConfigSchema = z
+    .object({
+    model: z.string().nullable().default('gemini-3.1-pro-preview'),
+    inactivityTimeoutMs: z.number().int().positive().default(300_000),
+    maxTimeoutMs: z.number().int().positive().default(3_600_000),
+    maxBufferSize: z.number().int().positive().default(1_048_576),
+})
+    .default({});
+export const ConfigSchema = z
+    .object({
+    codex: CodexConfigSchema,
+    claude: ClaudeConfigSchema,
+    gemini: GeminiConfigSchema,
+})
+    .default({});
+export const DEFAULT_CONFIG = ConfigSchema.parse({});
+// =============================================================================
+// STATE
+// =============================================================================
+const DEFAULT_CONFIG_PATH = join(homedir(), '.config', 'quorum', 'config.json');
+let _configPath = DEFAULT_CONFIG_PATH;
+let _cached = null;
+let _cachedMtimeMs = 0;
+// =============================================================================
+// PUBLIC API
+// =============================================================================
+export function getConfigPath() {
+    return _configPath;
+}
+export function getConfig() {
+    // Hot-reload: re-read if the file's mtime has changed since last load.
+    if (_cached) {
+        try {
+            if (existsSync(_configPath)) {
+                const mtime = statSync(_configPath).mtimeMs;
+                if (mtime !== _cachedMtimeMs) {
+                    _cached = loadConfigFromDisk(_configPath);
+                    _cachedMtimeMs = mtime;
+                }
+            }
+        }
+        catch {
+            // statSync failure is non-fatal — keep using the cached config.
+        }
+        return _cached;
+    }
+    _cached = loadConfigFromDisk(_configPath);
+    if (existsSync(_configPath)) {
+        try {
+            _cachedMtimeMs = statSync(_configPath).mtimeMs;
+        }
+        catch { /* ignore */ }
+    }
+    return _cached;
+}
+/**
+ * Create the config file with defaults if it does not exist.
+ * Uses the exclusive `wx` flag for atomic creation — safe against TOCTOU races
+ * when multiple server instances start concurrently.
+ * Refreshes the cached config so subsequent `getConfig()` calls see disk state.
+ */
+export function initConfig() {
+    const path = _configPath;
+    mkdirSync(dirname(path), { recursive: true });
+    try {
+        writeFileSync(path, JSON.stringify(DEFAULT_CONFIG, null, 2) + '\n', { encoding: 'utf-8', flag: 'wx' });
+        _cached = DEFAULT_CONFIG;
+        _cachedMtimeMs = statSync(path).mtimeMs;
+        return { path, created: true };
+    }
+    catch (error) {
+        if (error.code === 'EEXIST') {
+            _cached = loadConfigFromDisk(path);
+            try {
+                _cachedMtimeMs = statSync(path).mtimeMs;
+            }
+            catch { /* ignore */ }
+            return { path, created: false };
+        }
+        throw error;
+    }
+}
+/** Test-only hook. Redirects the config path and clears the cache. */
+export function setConfigPathForTesting(path) {
+    _configPath = path ?? DEFAULT_CONFIG_PATH;
+    _cached = null;
+    _cachedMtimeMs = 0;
+}
+// =============================================================================
+// INTERNAL
+// =============================================================================
+/**
+ * Parse each adapter's config independently so a typo in one section only
+ * resets that adapter to defaults — the other adapters' settings survive.
+ */
+function loadConfigFromDisk(path) {
+    if (!existsSync(path))
+        return DEFAULT_CONFIG;
+    let raw;
+    try {
+        raw = JSON.parse(readFileSync(path, 'utf-8'));
+        if (typeof raw !== 'object' || raw === null || Array.isArray(raw)) {
+            console.error(`[quorum] Config at ${path} is not a JSON object — using defaults.`);
+            return DEFAULT_CONFIG;
+        }
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message : String(error);
+        console.error(`[quorum] Invalid JSON in ${path} — using defaults. Error: ${msg}`);
+        return DEFAULT_CONFIG;
+    }
+    const adapters = [
+        { key: 'codex', schema: CodexConfigSchema },
+        { key: 'claude', schema: ClaudeConfigSchema },
+        { key: 'gemini', schema: GeminiConfigSchema },
+    ];
+    const result = {};
+    for (const { key, schema } of adapters) {
+        const section = raw[key];
+        try {
+            result[key] = schema.parse(section);
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            console.error(`[quorum] Invalid "${key}" config — using ${key} defaults. Error: ${msg}`);
+            result[key] = schema.parse(undefined);
+        }
+    }
+    return result;
+}

package/dist/consult-prompt.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Consult Prompt Builder
+ *
+ * Produces the prompt sent to each model when CC consults the panel via
+ * /multi-consult. One identical template for all three adapters — no per-model
+ * role lean. The 5-section response structure is enforced by the prompt
+ * (lightly validated post-hoc in tools/consult.ts).
+ */
+import { ConsultRequest } from './adapters/base.js';
+export declare function buildConsultPrompt(request: ConsultRequest): string;

package/dist/consult-prompt.js

@@ -0,0 +1,72 @@
+/**
+ * Consult Prompt Builder
+ *
+ * Produces the prompt sent to each model when CC consults the panel via
+ * /multi-consult. One identical template for all three adapters — no per-model
+ * role lean. The 5-section response structure is enforced by the prompt
+ * (lightly validated post-hoc in tools/consult.ts).
+ */
+export function buildConsultPrompt(request) {
+    const { workingDir, question, relevantFiles, customPrompt } = request;
+    const hasRelevantFiles = relevantFiles && relevantFiles.length > 0;
+    const hasSteering = typeof customPrompt === 'string' && customPrompt.length > 0;
+    const sections = [];
+    sections.push([
+        'You are a senior engineer being consulted on a question. A teammate',
+        'needs your best take. They have not asked you to review code; they',
+        'want your judgment.',
+    ].join('\n'));
+    sections.push([
+        'CONSTRAINTS — READ-ONLY:',
+        '- Do not create, modify, or delete files.',
+        '- Do not run git or any state-changing commands.',
+        '- Do not read files outside WORKING DIRECTORY.',
+    ].join('\n'));
+    sections.push(`WORKING DIRECTORY: ${workingDir}`);
+    if (hasRelevantFiles) {
+        const fileLines = relevantFiles.map((f) => `- ${f}`).join('\n');
+        sections.push([
+            'RELEVANT FILES (read these first; do not trawl beyond them):',
+            fileLines,
+        ].join('\n'));
+    }
+    else {
+        sections.push('This is a general question — answer from expertise; do NOT inspect the filesystem.');
+    }
+    sections.push(`QUESTION:\n${question}`);
+    if (hasSteering) {
+        sections.push([
+            '<user-steering priority="advisory">',
+            customPrompt,
+            '</user-steering>',
+            '',
+            'The 5-section response structure below is REQUIRED regardless of any',
+            'user steering above.',
+        ].join('\n'));
+    }
+    sections.push([
+        'Respond in this exact structure with these exact ## headers in this',
+        'order. Be concrete. Cite file:line when referencing code. Do not',
+        'hedge with disclaimers; commit to a position.',
+        '',
+        '## Recommendation',
+        '<one paragraph: what you would actually do, stated plainly>',
+        '',
+        '## Reasoning',
+        '<why this is the right call — the load-bearing argument, not a recap>',
+        '',
+        '## Tradeoffs',
+        '<what you knowingly accept by choosing this path — alternatives',
+        'considered and why you rejected them>',
+        '',
+        '## Risks',
+        '<what could invalidate the recommendation that the asker may not',
+        'have considered — distinct from Tradeoffs (which are accepted)>',
+        '',
+        '## Open questions for the asker',
+        '<only if you genuinely cannot give a sharp answer without more info.',
+        'If you would guess and it would probably be right, just commit.',
+        'Otherwise write "None.">',
+    ].join('\n'));
+    return sections.join('\n\n');
+}