delimit-cli 3.12.0 → 3.12.1

package/bin/delimit-cli.js

@@ -1648,6 +1648,118 @@ program
         console.log(chalk.green('\nConfig imported successfully.'));
     });
 
+// Deliberate command -- entry point for cross-model deliberation
+program
+    .command('deliberate [question...]')
+    .description('Deliberate on a strategic question using cross-model consensus')
+    .option('--list', 'List pending strategy items from the ledger')
+    .option('--mode <mode>', 'Deliberation mode: quick | dialogue | debate', 'dialogue')
+    .option('--question <q>', 'Question to deliberate (alternative to positional arg)')
+    .action(async (questionParts, options) => {
+        const question = options.question || (questionParts.length > 0 ? questionParts.join(' ') : null);
+
+        if (options.list) {
+            // List pending strategy items
+            const count = crossModelHooks.countPendingStrategyItems();
+            if (count === 0) {
+                console.log(chalk.green('No pending strategy items in the ledger.'));
+            } else {
+                console.log(chalk.blue(`${count} strategic decision${count === 1 ? '' : 's'} pending deliberation.`));
+                const top = crossModelHooks.getTopStrategyItem();
+                if (top) {
+                    console.log('');
+                    console.log(chalk.bold('Highest priority:'));
+                    console.log(`  ${top.id || 'unknown'}: ${top.title || top.description || 'No title'}`);
+                    if (top.priority) console.log(`  Priority: ${top.priority}`);
+                }
+            }
+            return;
+        }
+
+        if (question) {
+            console.log(chalk.blue.bold('\nDelimit Deliberation\n'));
+            console.log(`Question: ${chalk.bold(question)}\n`);
+
+            // Try to run deliberation directly via the gateway
+            const HOME = process.env.HOME || require('os').homedir();
+            const gatewayScript = path.join(HOME, '.delimit', 'server', 'ai', 'deliberation.py');
+            const gatewayAlt = '/home/delimit/delimit-gateway/ai/deliberation.py';
+            const scriptPath = fs.existsSync(gatewayScript) ? gatewayScript : fs.existsSync(gatewayAlt) ? gatewayAlt : null;
+
+            if (scriptPath) {
+                console.log(chalk.dim('Running multi-model deliberation...\n'));
+                try {
+                    const escapedQ = question.replace(/'/g, "\\'");
+                    const pyCmd = `python3 -c "
+import sys, os, json
+sys.path.insert(0, os.path.dirname('${scriptPath}'))
+os.chdir(os.path.dirname('${scriptPath}'))
+from deliberation import run_deliberation
+result = run_deliberation('${escapedQ}', mode='${options.mode}', max_rounds=2)
+if result.get('verdict'):
+    print('VERDICT:', result['verdict'])
+if result.get('confidence'):
+    print('CONFIDENCE:', result['confidence'])
+if result.get('summary'):
+    print()
+    print(result['summary'])
+"`;
+                    const result = execSync(pyCmd, {
+                        encoding: 'utf-8',
+                        timeout: 120000,
+                        env: { ...process.env, PYTHONPATH: path.dirname(scriptPath) },
+                    });
+                    console.log(result);
+                } catch (e) {
+                    // Fallback: guide user to MCP tool
+                    console.log(chalk.yellow('Direct deliberation unavailable. Use the MCP tool instead:\n'));
+                    console.log(chalk.bold('In your AI assistant (Claude Code, Codex, or Gemini CLI):'));
+                    console.log(`   ${chalk.cyan(`delimit_deliberate: ${question}`)}\n`);
+                }
+            } else {
+                console.log('To deliberate, use one of the following approaches:\n');
+                console.log(chalk.bold('1. In your AI assistant (Claude Code, Codex, or Gemini CLI):'));
+                console.log(`   ${chalk.cyan(`delimit_deliberate: ${question}`)}\n`);
+                console.log(chalk.bold('2. Using the MCP tool directly:'));
+                console.log(`   ${chalk.cyan(`Call delimit_deliberate with question="${question}"`)}\n`);
+            }
+
+            // Save pending deliberation to file for reference
+            const deliberationDir = path.join(HOME, '.delimit', 'deliberation');
+            fs.mkdirSync(deliberationDir, { recursive: true });
+            const pending = {
+                question,
+                mode: options.mode,
+                created: new Date().toISOString(),
+                status: 'pending',
+            };
+            fs.writeFileSync(
+                path.join(deliberationDir, 'pending.json'),
+                JSON.stringify(pending, null, 2)
+            );
+            console.log(chalk.dim(`\nSaved to ~/.delimit/deliberation/pending.json`));
+        } else {
+            // No question -- check the ledger for the top strategy item
+            const top = crossModelHooks.getTopStrategyItem();
+            if (top) {
+                const topQuestion = top.title || top.description || 'No description';
+                console.log(chalk.blue.bold('\nDelimit Deliberation\n'));
+                console.log(`Top pending strategy item: ${chalk.bold(topQuestion)}\n`);
+                console.log('To deliberate on this item, use one of the following:\n');
+                console.log(chalk.bold('1. In your AI assistant:'));
+                console.log(`   ${chalk.cyan(`delimit_deliberate: ${topQuestion}`)}\n`);
+                console.log(chalk.bold('2. Using the MCP tool directly:'));
+                console.log(`   ${chalk.cyan(`Call delimit_deliberate with question="${topQuestion}"`)}\n`);
+            } else {
+                console.log(chalk.blue.bold('\nDelimit Deliberation\n'));
+                console.log('No pending strategy items in the ledger.\n');
+                console.log('To start a new deliberation:\n');
+                console.log(`  ${chalk.cyan('delimit deliberate "Should we adopt versioned API contracts?"')}\n`);
+                console.log('Or ask your AI assistant to call the delimit_deliberate MCP tool.');
+            }
+        }
+    });
+
 // Version subcommand alias (users type 'delimit version' not 'delimit -V')
 program
     .command('version')

package/lib/cross-model-hooks.js

@@ -475,6 +475,75 @@ function removeAllHooks() {
     return results;
 }
 
+// ---------------------------------------------------------------------------
+// Deliberation helpers
+// ---------------------------------------------------------------------------
+
+/**
+ * Count pending strategy items in the ledger that have priority P0.
+ * Returns the count of open/in_progress P0 strategy items.
+ */
+function countPendingStrategyItems() {
+    const ledgerDir = path.join(getDelimitHome(), 'ledger');
+    if (!fs.existsSync(ledgerDir)) return 0;
+
+    let count = 0;
+    try {
+        const files = fs.readdirSync(ledgerDir).filter(f => f.endsWith('.json'));
+        for (const f of files) {
+            try {
+                const items = JSON.parse(fs.readFileSync(path.join(ledgerDir, f), 'utf-8'));
+                if (!Array.isArray(items)) continue;
+                for (const item of items) {
+                    const isOpen = item.status === 'open' || item.status === 'in_progress';
+                    const isStrategy = item.category === 'strategy' || item.category === 'deliberation';
+                    const isP0 = item.priority === 'P0' || item.priority === 0;
+                    if (isOpen && (isStrategy || isP0)) {
+                        count++;
+                    }
+                }
+            } catch { /* ignore individual file parse errors */ }
+        }
+    } catch { /* ignore directory read errors */ }
+
+    return count;
+}
+
+/**
+ * Get the highest priority pending strategy item from the ledger.
+ * Returns the item object or null if none found.
+ */
+function getTopStrategyItem() {
+    const ledgerDir = path.join(getDelimitHome(), 'ledger');
+    if (!fs.existsSync(ledgerDir)) return null;
+
+    let best = null;
+    const priorityOrder = { P0: 0, P1: 1, P2: 2, P3: 3 };
+
+    try {
+        const files = fs.readdirSync(ledgerDir).filter(f => f.endsWith('.json'));
+        for (const f of files) {
+            try {
+                const items = JSON.parse(fs.readFileSync(path.join(ledgerDir, f), 'utf-8'));
+                if (!Array.isArray(items)) continue;
+                for (const item of items) {
+                    const isOpen = item.status === 'open' || item.status === 'in_progress';
+                    const isStrategy = item.category === 'strategy' || item.category === 'deliberation';
+                    const isP0 = item.priority === 'P0' || item.priority === 0;
+                    if (isOpen && (isStrategy || isP0)) {
+                        const rank = typeof item.priority === 'number' ? item.priority : (priorityOrder[item.priority] ?? 99);
+                        if (!best || rank < (typeof best.priority === 'number' ? best.priority : (priorityOrder[best.priority] ?? 99))) {
+                            best = item;
+                        }
+                    }
+                }
+            } catch { /* ignore */ }
+        }
+    } catch { /* ignore */ }
+
+    return best;
+}
+
 // ---------------------------------------------------------------------------
 // Hook execution commands
 // ---------------------------------------------------------------------------
@@ -557,6 +626,14 @@ async function hookSessionStart() {
         }
     }
 
+    // Check for pending strategy items that need deliberation
+    if (config.show_strategy_items) {
+        const strategyCount = countPendingStrategyItems();
+        if (strategyCount > 0) {
+            lines.push(`[delimit] ${strategyCount} strategic decision${strategyCount === 1 ? '' : 's'} pending deliberation. Run: delimit deliberate`);
+        }
+    }
+
     // Git branch info
     try {
         const branch = execSync('git branch --show-current 2>/dev/null', { encoding: 'utf-8' }).trim();
@@ -679,6 +756,44 @@ async function hookPreCommit() {
         warnings.push('[Delimit] No governance policy found. Run "delimit init" to create one.');
     }
 
+    // Deliberation on API spec commits (opt-in via deliberate_on_commit)
+    if (config.deliberate_on_commit) {
+        try {
+            const stagedFiles2 = execSync('git diff --cached --name-only 2>/dev/null', {
+                encoding: 'utf-8',
+                timeout: 2000,
+            }).split('\n').filter(Boolean);
+
+            const apiSpecFiles = stagedFiles2.filter(f =>
+                /openapi|swagger/i.test(f) && /\.(yaml|yml|json)$/.test(f)
+            );
+
+            if (apiSpecFiles.length > 0) {
+                // Auto-deliberate: call Delimit gateway directly
+                if (config.deliberate_on_commit === 'auto') {
+                    process.stderr.write('[delimit] API spec change detected — running multi-model deliberation...\n');
+                    try {
+                        const diff = execSync(`git diff --cached -- ${apiSpecFiles.join(' ')} 2>/dev/null`, {
+                            encoding: 'utf-8',
+                            timeout: 5000,
+                            maxBuffer: 50 * 1024,
+                        }).slice(0, 2000);
+                        const question = `This commit modifies API specs (${apiSpecFiles.join(', ')}). Is this change safe to ship? Are there breaking changes?\n\nDiff:\n${diff}`;
+                        const result = execSync(`npx delimit-cli deliberate --question "${question.replace(/"/g, '\\"')}" --mode quick 2>/dev/null`, {
+                            encoding: 'utf-8',
+                            timeout: 60000,
+                        });
+                        process.stderr.write(result + '\n');
+                    } catch (e) {
+                        warnings.push(`[delimit] Deliberation failed: ${e.message?.slice(0, 100) || 'timeout'}. Proceeding with commit.`);
+                    }
+                } else {
+                    warnings.push('[delimit] This commit modifies API specs. Consider running: delimit deliberate "Is this change safe?"');
+                }
+            }
+        } catch { /* not in git repo */ }
+    }
+
     if (warnings.length > 0) {
         process.stderr.write(warnings.join('\n') + '\n');
     }
@@ -703,4 +818,6 @@ module.exports = {
     hookSessionStart,
     hookPreTool,
     hookPreCommit,
+    countPendingStrategyItems,
+    getTopStrategyItem,
 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "delimit-cli",
   "mcpName": "io.github.delimit-ai/delimit-mcp-server",
-  "version": "3.12.0",
+  "version": "3.12.1",
   "description": "Unify Claude Code, Codex, Cursor, and Gemini CLI with persistent context, governance, and multi-model debate.",
   "main": "index.js",
   "files": [