@kernel.chat/kbot 2.7.0 → 2.8.0

package/dist/architect.js

@@ -0,0 +1,403 @@
+// K:BOT Architect Mode — Dual-Agent Plan-Review-Implement Loop
+//
+// Splits complex tasks between two roles:
+//   Architect: plans, reviews, approves/rejects
+//   Editor:    implements one step at a time using tools
+//
+// Similar to Aider's architect mode. The architect never writes code directly;
+// the editor never makes architectural decisions.
+//
+// Activation (to be wired in cli.ts):
+//   $ kbot --architect "refactor the auth system"
+//   > /architect refactor the auth system
+import { runAgent } from './agent.js';
+import { gatherContext, formatContextForPrompt } from './context.js';
+import { getRepoMapForContext } from './repo-map.js';
+import { createSpinner, printInfo, printSuccess, printError, printWarn } from './ui.js';
+import chalk from 'chalk';
+const AMETHYST = chalk.hex('#6B5B95');
+// ── Safety Limits ──
+const MAX_PLAN_STEPS = 10;
+const MAX_RETRIES_PER_STEP = 2;
+// ── System Prompts ──
+const ARCHITECT_PLAN_PROMPT = `You are the Architect in a dual-agent coding system. Your job is to PLAN, not implement.
+
+Given a task and project context, produce a structured JSON plan. You must output ONLY valid JSON matching this schema:
+
+{
+  "summary": "One-sentence summary of the overall change",
+  "files_to_modify": ["list of existing files that will be edited"],
+  "files_to_create": ["list of new files to create"],
+  "steps": [
+    {
+      "description": "Precise description of what to do in this step",
+      "file": "path/to/file.ts",
+      "action": "create | edit | delete"
+    }
+  ],
+  "constraints": [
+    "Things the editor must NOT do (e.g., 'do not change the public API', 'preserve backward compatibility')"
+  ],
+  "test_strategy": "How to verify the changes work (e.g., 'run npx tsc --noEmit', 'run npm test')"
+}
+
+Rules:
+- Maximum ${MAX_PLAN_STEPS} steps. Break large changes into focused, atomic steps.
+- Each step targets exactly ONE file with ONE action.
+- Order steps by dependency — if step 3 depends on step 1, step 1 comes first.
+- For edits, describe WHAT to change specifically (function names, line ranges, logic changes).
+- For creates, describe the full purpose, exports, and structure of the new file.
+- Include constraints that prevent the editor from making unintended changes.
+- The test_strategy should be a concrete command, not a vague suggestion.
+- Output ONLY the JSON object. No markdown fences, no explanation.`;
+const ARCHITECT_REVIEW_PROMPT = `You are the Architect reviewing an Editor's implementation of one step in your plan.
+
+You will see:
+1. The original step description
+2. The file and action
+3. The editor's output (what they did)
+
+Evaluate whether the implementation:
+- Correctly implements the step as described
+- Does not violate any constraints
+- Does not introduce bugs, type errors, or security issues
+- Is clean, idiomatic code
+
+Respond with ONLY valid JSON:
+{
+  "approved": true | false,
+  "feedback": "If rejected: specific, actionable feedback for the editor to fix. If approved: brief confirmation."
+}
+
+Be strict but fair. Approve good-enough work. Reject only if there are real problems.`;
+const EDITOR_SYSTEM_PROMPT = `You are the Editor in a dual-agent coding system. You IMPLEMENT, you do not plan.
+
+You receive a single step to execute. Use your tools to implement it precisely.
+
+Rules:
+- Follow the step description exactly. Do not add unrequested features.
+- Do not make architectural decisions. If something is ambiguous, implement the simplest version.
+- Use edit_file for existing files, write_file for new files, bash for commands.
+- After implementing, briefly describe what you did (1-2 sentences).
+- If the Architect gave you feedback on a previous attempt, address ALL of the feedback points.
+- Do not modify files outside the scope of your current step.`;
+// ── Utility: chatOnce ──
+// A simplified single-turn call. Uses runAgent under the hood but with a
+// specific system prompt injected via the agent message itself (since runAgent
+// builds its own system context, we prepend our role instructions).
+async function chatOnce(systemPrompt, userMessage, agentOpts) {
+    // Combine our role-specific system prompt with the user message so
+    // runAgent processes it through the full provider pipeline (including tools
+    // for the editor). The system prompt goes first as context framing.
+    const combined = `${systemPrompt}\n\n---\n\n${userMessage}`;
+    const response = await runAgent(combined, {
+        ...agentOpts,
+        agent: agentOpts.agent || 'coder',
+    });
+    return response.content;
+}
+// ── Phase 1: Architect Creates Plan ──
+async function createPlan(task, agentOpts) {
+    const spinner = createSpinner('Architect analyzing task...');
+    spinner.start();
+    // Gather project context and repo map for the architect
+    let contextStr = '';
+    try {
+        const context = gatherContext();
+        contextStr = formatContextForPrompt(context);
+    }
+    catch { /* context is non-critical */ }
+    let repoMap = '';
+    try {
+        repoMap = await getRepoMapForContext();
+    }
+    catch { /* repo map is non-critical */ }
+    const userMessage = `Project context:
+${contextStr}
+
+Repository structure:
+${repoMap || '(unavailable)'}
+
+Task: ${task}
+
+Output your plan as JSON:`;
+    spinner.stop();
+    const raw = await chatOnce(ARCHITECT_PLAN_PROMPT, userMessage, agentOpts);
+    // Parse the JSON plan from the response
+    let plan;
+    try {
+        // Extract JSON — AI might wrap it in markdown fences
+        const jsonMatch = raw.match(/\{[\s\S]*\}/);
+        if (!jsonMatch)
+            throw new Error('No JSON found in architect response');
+        const parsed = JSON.parse(jsonMatch[0]);
+        plan = {
+            summary: parsed.summary || task,
+            files_to_modify: parsed.files_to_modify || [],
+            files_to_create: parsed.files_to_create || [],
+            steps: (parsed.steps || []).slice(0, MAX_PLAN_STEPS).map((s) => ({
+                description: s.description || '',
+                file: s.file || '',
+                action: (['create', 'edit', 'delete'].includes(s.action) ? s.action : 'edit'),
+            })),
+            constraints: parsed.constraints || [],
+            test_strategy: parsed.test_strategy || 'npx tsc --noEmit',
+        };
+    }
+    catch {
+        // Fallback: single-step plan if AI didn't return valid JSON
+        plan = {
+            summary: task,
+            files_to_modify: [],
+            files_to_create: [],
+            steps: [{
+                    description: task,
+                    file: '',
+                    action: 'edit',
+                }],
+            constraints: [],
+            test_strategy: 'npx tsc --noEmit',
+        };
+        printWarn('Architect produced non-JSON response. Using simplified plan.');
+    }
+    // Safety: enforce step limit
+    if (plan.steps.length > MAX_PLAN_STEPS) {
+        plan.steps = plan.steps.slice(0, MAX_PLAN_STEPS);
+        printWarn(`Plan truncated to ${MAX_PLAN_STEPS} steps (safety limit).`);
+    }
+    return plan;
+}
+// ── Phase 2: Editor Implements a Step ──
+async function editorImplement(step, stepIndex, totalSteps, plan, feedback, agentOpts) {
+    const feedbackSection = feedback
+        ? `\n\nPREVIOUS ATTEMPT REJECTED. Architect feedback:\n${feedback}\n\nAddress ALL feedback points in this attempt.`
+        : '';
+    const constraintsSection = plan.constraints.length > 0
+        ? `\nConstraints (do NOT violate these):\n${plan.constraints.map(c => `- ${c}`).join('\n')}`
+        : '';
+    const userMessage = `Step ${stepIndex + 1} of ${totalSteps}:
+
+Action: ${step.action.toUpperCase()} file: ${step.file}
+Description: ${step.description}
+${constraintsSection}
+${feedbackSection}
+
+Implement this step now using your tools. Be precise.`;
+    return chatOnce(EDITOR_SYSTEM_PROMPT, userMessage, agentOpts);
+}
+// ── Phase 3: Architect Reviews Editor Output ──
+async function architectReview(step, editorOutput, plan, agentOpts) {
+    const constraintsSection = plan.constraints.length > 0
+        ? `\nConstraints that must be respected:\n${plan.constraints.map(c => `- ${c}`).join('\n')}`
+        : '';
+    const userMessage = `Step under review:
+Action: ${step.action.toUpperCase()} file: ${step.file}
+Description: ${step.description}
+${constraintsSection}
+
+Editor's output:
+${editorOutput.slice(0, 4000)}
+
+Evaluate and respond with JSON (approved: true/false, feedback: string):`;
+    const raw = await chatOnce(ARCHITECT_REVIEW_PROMPT, userMessage, agentOpts);
+    try {
+        const jsonMatch = raw.match(/\{[\s\S]*\}/);
+        if (!jsonMatch)
+            throw new Error('No JSON in review');
+        const parsed = JSON.parse(jsonMatch[0]);
+        return {
+            approved: !!parsed.approved,
+            feedback: parsed.feedback || '',
+        };
+    }
+    catch {
+        // If review parsing fails, approve by default to avoid blocking
+        printWarn('Architect review returned non-JSON. Auto-approving step.');
+        return { approved: true, feedback: 'Auto-approved (review parse failure).' };
+    }
+}
+// ── Phase 4: Verification ──
+async function runVerification(plan, agentOpts) {
+    const spinner = createSpinner('Running verification...');
+    spinner.start();
+    try {
+        // Use the editor agent to run the test strategy command
+        const verifyMessage = `Run this verification command and report the results:\n\n${plan.test_strategy}\n\nIf there are errors, list them. If everything passes, say so.`;
+        const result = await chatOnce(EDITOR_SYSTEM_PROMPT, verifyMessage, agentOpts);
+        spinner.stop();
+        return result;
+    }
+    catch (err) {
+        spinner.stop();
+        const errMsg = err instanceof Error ? err.message : String(err);
+        return `Verification failed: ${errMsg}`;
+    }
+}
+// ── Display Helpers ──
+function displayPlan(plan) {
+    console.log();
+    console.log(`  ${AMETHYST('◆ Architect Plan')}: ${plan.summary}`);
+    console.log(`  ${chalk.dim('─'.repeat(60))}`);
+    console.log();
+    if (plan.files_to_modify.length > 0) {
+        console.log(`  ${chalk.dim('Modify:')} ${plan.files_to_modify.join(', ')}`);
+    }
+    if (plan.files_to_create.length > 0) {
+        console.log(`  ${chalk.dim('Create:')} ${plan.files_to_create.join(', ')}`);
+    }
+    if (plan.files_to_modify.length > 0 || plan.files_to_create.length > 0) {
+        console.log();
+    }
+    for (let i = 0; i < plan.steps.length; i++) {
+        const step = plan.steps[i];
+        const actionIcon = { create: chalk.green('+'), edit: chalk.yellow('~'), delete: chalk.red('-') }[step.action];
+        console.log(`  ${chalk.dim(`${i + 1}.`)} ${actionIcon} ${chalk.cyan(step.file)} ${chalk.dim('—')} ${step.description}`);
+    }
+    if (plan.constraints.length > 0) {
+        console.log();
+        console.log(`  ${chalk.dim('Constraints:')}`);
+        for (const c of plan.constraints) {
+            console.log(`    ${chalk.red('!')} ${c}`);
+        }
+    }
+    console.log();
+    console.log(`  ${chalk.dim('Verify:')} ${plan.test_strategy}`);
+    console.log(`  ${chalk.dim(`${plan.steps.length} steps`)}`);
+    console.log();
+}
+function displayStepResult(stepIndex, total, step, approved, attempt) {
+    const prefix = `Step ${stepIndex + 1}/${total}`;
+    if (approved) {
+        printSuccess(`${prefix}: ${step.description}`);
+    }
+    else {
+        printWarn(`${prefix}: rejected (attempt ${attempt}/${MAX_RETRIES_PER_STEP + 1})`);
+    }
+}
+function displayReport(report) {
+    console.log();
+    console.log(`  ${AMETHYST('◆ Architect Report')}`);
+    console.log(`  ${chalk.dim('─'.repeat(60))}`);
+    console.log();
+    console.log(`  ${chalk.dim('Summary:')} ${report.plan.summary}`);
+    console.log(`  ${chalk.dim('Status:')}  ${report.status === 'completed' ? chalk.green(report.status) : report.status === 'partial' ? chalk.yellow(report.status) : chalk.red(report.status)}`);
+    console.log();
+    for (const outcome of report.outcomes) {
+        const icon = outcome.status === 'approved' ? chalk.green('✓') : chalk.red('✗');
+        const retries = outcome.attempts > 1 ? chalk.dim(` (${outcome.attempts} attempts)`) : '';
+        console.log(`  ${icon} ${outcome.step.description}${retries}`);
+        if (outcome.status === 'failed' && outcome.reviewFeedback) {
+            console.log(`    ${chalk.dim('Last feedback:')} ${outcome.reviewFeedback.slice(0, 120)}`);
+        }
+    }
+    if (report.verification) {
+        console.log();
+        console.log(`  ${chalk.dim('Verification:')}`);
+        // Show first few lines of verification output
+        const lines = report.verification.split('\n').slice(0, 8);
+        for (const line of lines) {
+            console.log(`    ${line}`);
+        }
+        if (report.verification.split('\n').length > 8) {
+            console.log(`    ${chalk.dim(`... (${report.verification.split('\n').length - 8} more lines)`)}`);
+        }
+    }
+    console.log();
+}
+// ── Main Entry Point ──
+/**
+ * Run architect mode: a dual-agent loop where the Architect plans and reviews
+ * while the Editor implements each step.
+ *
+ * Flow:
+ *   1. Architect analyzes the task and creates a structured plan
+ *   2. For each step: Editor implements -> Architect reviews -> approve or redo
+ *   3. After all steps: Architect runs verification (type check, tests)
+ *   4. Returns a full report
+ *
+ * @param task - The user's task description
+ * @param options - Agent options (model, streaming, etc.)
+ * @returns Full report of the architect session
+ */
+export async function runArchitectMode(task, options = {}) {
+    printInfo('Entering architect mode...');
+    console.log();
+    // Phase 1: Architect creates plan
+    printInfo('Phase 1: Architect planning...');
+    const plan = await createPlan(task, options);
+    displayPlan(plan);
+    // Phase 2: Editor implements each step with architect review
+    printInfo('Phase 2: Editor implementing...');
+    console.log();
+    const outcomes = [];
+    for (let i = 0; i < plan.steps.length; i++) {
+        const step = plan.steps[i];
+        let approved = false;
+        let attempts = 0;
+        let lastEditorOutput = '';
+        let lastFeedback = null;
+        while (!approved && attempts <= MAX_RETRIES_PER_STEP) {
+            attempts++;
+            // Editor implements
+            const spinner = createSpinner(`Step ${i + 1}/${plan.steps.length}: ${step.description}`);
+            spinner.start();
+            try {
+                lastEditorOutput = await editorImplement(step, i, plan.steps.length, plan, lastFeedback, options);
+                spinner.stop();
+            }
+            catch (err) {
+                spinner.stop();
+                const errMsg = err instanceof Error ? err.message : String(err);
+                printError(`Editor failed on step ${i + 1}: ${errMsg}`);
+                lastEditorOutput = `Error: ${errMsg}`;
+                break;
+            }
+            // Architect reviews
+            const review = await architectReview(step, lastEditorOutput, plan, options);
+            approved = review.approved;
+            lastFeedback = review.feedback;
+            displayStepResult(i, plan.steps.length, step, approved, attempts);
+            if (!approved && attempts <= MAX_RETRIES_PER_STEP) {
+                printInfo(`Architect feedback: ${review.feedback.slice(0, 200)}`);
+            }
+        }
+        outcomes.push({
+            step,
+            status: approved ? 'approved' : 'failed',
+            attempts,
+            editorOutput: lastEditorOutput,
+            reviewFeedback: lastFeedback || undefined,
+        });
+        // If a step fails after all retries, continue with remaining steps
+        // (the architect plan may have independent steps that can still succeed)
+        if (!approved) {
+            printWarn(`Step ${i + 1} failed after ${attempts} attempts. Continuing with remaining steps.`);
+        }
+    }
+    // Phase 3: Verification
+    const approvedCount = outcomes.filter(o => o.status === 'approved').length;
+    let verification = null;
+    if (approvedCount > 0) {
+        printInfo('Phase 3: Running verification...');
+        verification = await runVerification(plan, options);
+    }
+    else {
+        printWarn('All steps failed. Skipping verification.');
+    }
+    // Determine overall status
+    const failedCount = outcomes.filter(o => o.status === 'failed').length;
+    let status;
+    if (failedCount === 0) {
+        status = 'completed';
+    }
+    else if (approvedCount > 0) {
+        status = 'partial';
+    }
+    else {
+        status = 'failed';
+    }
+    const report = { plan, outcomes, verification, status };
+    displayReport(report);
+    return report;
+}
+//# sourceMappingURL=architect.js.map

package/dist/architect.js.map

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

package/dist/cli.js

@@ -22,7 +22,7 @@ import { banner, bannerCompact, bannerAuth, prompt as kbotPrompt, printError, pr
 import { checkForUpdate, selfUpdate } from './updater.js';
 import { syncOnStartup, schedulePush, flushCloudSync, isCloudSyncEnabled, setCloudToken, getCloudToken } from './cloud-sync.js';
 import chalk from 'chalk';
-const VERSION = '2.7.0';
+const VERSION = '2.8.0';
 async function main() {
     const program = new Command();
     program
@@ -41,6 +41,7 @@ async function main() {
         .option('-t, --thinking', 'Show AI reasoning steps')
         .option('--thinking-budget <tokens>', 'Thinking token budget (default: 10000)')
         .option('--self-eval', 'Enable self-evaluation loop (score and retry low-quality responses)')
+        .option('--architect', 'Architect mode — plan-review-implement with dual agents')
         .option('--safe', 'Confirm destructive operations')
         .option('--strict', 'Confirm ALL operations')
         .argument('[prompt...]', 'One-shot prompt')
@@ -371,7 +372,7 @@ async function main() {
     });
     program
         .command('serve')
-        .description('Start HTTP server — expose all 93 tools for kernel.chat or any client')
+        .description('Start HTTP server — expose all 119 tools for kernel.chat or any client')
         .option('-p, --port <port>', 'Port to listen on', '7437')
         .option('--token <token>', 'Require auth token for all requests')
         .option('--computer-use', 'Enable computer use tools')
@@ -700,6 +701,12 @@ async function main() {
             }) + '\n');
             return;
         }
+        // Architect mode: plan-review-implement with dual agents
+        if (opts.architect) {
+            const { runArchitectMode } = await import('./architect.js');
+            await runArchitectMode(message, agentOpts);
+            return;
+        }
         agentOpts.stream = true; // Force streaming for faster one-shot
         await runAndPrint(message, agentOpts);
         return;
@@ -1425,6 +1432,43 @@ async function handleSlashCommand(input, opts, rl) {
             }
             break;
         }
+        case 'architect': {
+            const archTask = args.join(' ');
+            if (!archTask) {
+                printError('Usage: /architect <task description>');
+                printInfo('Example: /architect refactor the auth system to use JWT');
+            }
+            else {
+                const { runArchitectMode } = await import('./architect.js');
+                await runArchitectMode(archTask, opts);
+            }
+            break;
+        }
+        case 'graph': {
+            const graphArgs = args.join(' ');
+            if (!graphArgs) {
+                const { getGraph } = await import('./graph-memory.js');
+                const graph = getGraph();
+                printInfo(`Graph: ${graph.nodes.size} nodes, ${graph.edges.length} edges`);
+                if (graph.nodes.size > 0) {
+                    const { toContext } = await import('./graph-memory.js');
+                    printInfo(toContext(500));
+                }
+            }
+            else {
+                const { findNode } = await import('./graph-memory.js');
+                const results = findNode(graphArgs);
+                if (results.length === 0) {
+                    printInfo('No matching nodes found.');
+                }
+                else {
+                    for (const n of results.slice(0, 10)) {
+                        printInfo(`  [${n.type}:${n.name}] (${n.accessCount} accesses)`);
+                    }
+                }
+            }
+            break;
+        }
         case 'plan': {
             const planTask = args.join(' ');
             if (!planTask) {