codekin 0.4.1 → 0.5.0

package/server/dist/native-permissions.js.map

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

package/server/dist/orchestrator-children.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Orchestrator child session manager — spawns, monitors, and reports on
+ * implementation sessions created by the orchestrator.
+ *
+ * Follows the same patterns as workflow-loader.ts for session creation
+ * and result polling.
+ */
+import type { SessionManager } from './session-manager.js';
+export interface ChildSessionRequest {
+    /** Target repository path. */
+    repo: string;
+    /** Human-readable task description. */
+    task: string;
+    /** Branch name for the fix. */
+    branchName: string;
+    /** How changes should land. */
+    completionPolicy: 'pr' | 'merge' | 'commit-only';
+    /** Whether to deploy after merge. */
+    deployAfter: boolean;
+    /** Use a git worktree for isolation. */
+    useWorktree: boolean;
+    /** Timeout in ms (default 10 minutes). */
+    timeoutMs?: number;
+    /** Optional model override. */
+    model?: string;
+}
+export type ChildStatus = 'starting' | 'running' | 'completed' | 'failed' | 'timed_out';
+export interface ChildSession {
+    id: string;
+    request: ChildSessionRequest;
+    status: ChildStatus;
+    startedAt: string;
+    completedAt: string | null;
+    result: string | null;
+    error: string | null;
+}
+export declare class OrchestratorChildManager {
+    private children;
+    private sessions;
+    constructor(sessions: SessionManager);
+    /** Get all active/recent child sessions. */
+    list(): ChildSession[];
+    /** Get a child session by ID. */
+    get(id: string): ChildSession | null;
+    /** Purge completed/failed children older than the retention period. */
+    private purgeStaleChildren;
+    /** Count currently active (non-terminal) child sessions. */
+    activeCount(): number;
+    /**
+     * Spawn a child session to implement a task in a target repo.
+     * Returns the child session info or throws if at capacity.
+     */
+    spawn(request: ChildSessionRequest): Promise<ChildSession>;
+    /**
+     * Build a focused task prompt for a child session.
+     */
+    private buildPrompt;
+    /**
+     * Monitor a child session until completion or timeout using event hooks.
+     * Replaces the old polling loop with SessionManager's onSessionResult and
+     * onSessionExit hooks for lower latency and no wasted CPU.
+     */
+    private monitorChild;
+    /**
+     * Check whether the session completed the expected final step (PR, push, deploy).
+     * If not, send a follow-up instruction and return true so monitoring continues.
+     * Only nudges once per child to avoid infinite loops.
+     */
+    private ensureFinalStep;
+    /**
+     * Extract assistant text from session output history.
+     */
+    private extractText;
+}

package/server/dist/orchestrator-children.js

@@ -0,0 +1,281 @@
+/**
+ * Orchestrator child session manager — spawns, monitors, and reports on
+ * implementation sessions created by the orchestrator.
+ *
+ * Follows the same patterns as workflow-loader.ts for session creation
+ * and result polling.
+ */
+import { randomUUID } from 'crypto';
+import { getAgentDisplayName } from './config.js';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const MAX_CONCURRENT = 5;
+const DEFAULT_TIMEOUT_MS = 600_000; // 10 minutes
+const CHILD_RETENTION_MS = 3_600_000; // keep completed/failed children for 1 hour
+const MAX_RETAINED_CHILDREN = 100; // hard cap on total entries
+// ---------------------------------------------------------------------------
+// Manager
+// ---------------------------------------------------------------------------
+export class OrchestratorChildManager {
+    children = new Map();
+    sessions;
+    constructor(sessions) {
+        this.sessions = sessions;
+    }
+    /** Get all active/recent child sessions. */
+    list() {
+        this.purgeStaleChildren();
+        return Array.from(this.children.values())
+            .sort((a, b) => b.startedAt.localeCompare(a.startedAt));
+    }
+    /** Get a child session by ID. */
+    get(id) {
+        return this.children.get(id) ?? null;
+    }
+    /** Purge completed/failed children older than the retention period. */
+    purgeStaleChildren() {
+        const now = Date.now();
+        for (const [id, child] of this.children) {
+            if (child.status === 'starting' || child.status === 'running')
+                continue;
+            if (child.completedAt && now - new Date(child.completedAt).getTime() > CHILD_RETENTION_MS) {
+                this.children.delete(id);
+            }
+        }
+        // Hard cap: if still over limit, remove oldest completed entries
+        if (this.children.size > MAX_RETAINED_CHILDREN) {
+            const completed = Array.from(this.children.entries())
+                .filter(([, c]) => c.status !== 'starting' && c.status !== 'running')
+                .sort((a, b) => (a[1].completedAt ?? '').localeCompare(b[1].completedAt ?? ''));
+            while (this.children.size > MAX_RETAINED_CHILDREN && completed.length > 0) {
+                const [id] = completed.shift();
+                this.children.delete(id);
+            }
+        }
+    }
+    /** Count currently active (non-terminal) child sessions. */
+    activeCount() {
+        return Array.from(this.children.values())
+            .filter(c => c.status === 'starting' || c.status === 'running')
+            .length;
+    }
+    /**
+     * Spawn a child session to implement a task in a target repo.
+     * Returns the child session info or throws if at capacity.
+     */
+    async spawn(request) {
+        this.purgeStaleChildren();
+        if (this.activeCount() >= MAX_CONCURRENT) {
+            throw new Error(`Cannot spawn child session: ${MAX_CONCURRENT} concurrent sessions already running`);
+        }
+        const sessionId = randomUUID();
+        const sessionName = `${getAgentDisplayName().toLowerCase()}:${request.branchName}`;
+        const now = new Date().toISOString();
+        const child = {
+            id: sessionId,
+            request,
+            status: 'starting',
+            startedAt: now,
+            completedAt: null,
+            result: null,
+            error: null,
+        };
+        this.children.set(sessionId, child);
+        try {
+            // Create the session
+            this.sessions.create(sessionName, request.repo, {
+                source: 'agent',
+                id: sessionId,
+                groupDir: request.repo,
+                model: request.model,
+                permissionMode: 'acceptEdits',
+                allowedTools: ['Bash(curl:*)'],
+            });
+            // Create a git worktree for isolation if requested (default for Joe children).
+            // This must happen BEFORE startClaude so Claude runs in the worktree directory.
+            if (request.useWorktree) {
+                const wtPath = await this.sessions.createWorktree(sessionId, request.repo);
+                if (!wtPath) {
+                    console.warn(`[orchestrator-child] Failed to create worktree for ${sessionId}, falling back to main directory`);
+                }
+            }
+            // Start Claude
+            this.sessions.startClaude(sessionId);
+            child.status = 'running';
+            // Build and send the task prompt
+            const prompt = this.buildPrompt(request);
+            this.sessions.sendInput(sessionId, prompt);
+            // Monitor completion asynchronously
+            void this.monitorChild(child);
+            return child;
+        }
+        catch (err) {
+            child.status = 'failed';
+            child.error = err instanceof Error ? err.message : String(err);
+            child.completedAt = new Date().toISOString();
+            return child;
+        }
+    }
+    /**
+     * Build a focused task prompt for a child session.
+     */
+    buildPrompt(request) {
+        const lines = [
+            `# Task: ${request.task}`,
+            '',
+            '## Instructions',
+            '',
+            `You have been spawned by Agent ${getAgentDisplayName()} (the Codekin orchestrator) to implement a specific task in this repository.`,
+            '',
+            `**Task**: ${request.task}`,
+            `**Branch**: Create your changes on branch \`${request.branchName}\``,
+            '',
+        ];
+        if (request.completionPolicy === 'pr') {
+            lines.push('## Completion', '', '1. Create a new branch with the name specified above', '2. Make the necessary changes', '3. Commit your changes with a clear commit message', '4. Push the branch and create a Pull Request', '5. Include a clear PR description explaining what was changed and why', '');
+        }
+        else if (request.completionPolicy === 'merge') {
+            lines.push('## Completion', '', '1. Make the necessary changes on the current branch', '2. Commit your changes with a clear commit message', '3. Push directly to the current branch', '');
+        }
+        else {
+            lines.push('## Completion', '', '1. Make the necessary changes', '2. Commit your changes with a clear commit message', '3. Do NOT push — just commit locally', '');
+        }
+        lines.push('## Guidelines', '', '- Keep changes minimal and focused on the task', '- Do not refactor unrelated code', '- If you encounter issues that block the task, explain what went wrong', '- When done, provide a brief summary of what you changed');
+        return lines.join('\n');
+    }
+    /**
+     * Monitor a child session until completion or timeout using event hooks.
+     * Replaces the old polling loop with SessionManager's onSessionResult and
+     * onSessionExit hooks for lower latency and no wasted CPU.
+     */
+    async monitorChild(child) {
+        const timeoutMs = child.request.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+        try {
+            await new Promise((resolve) => {
+                let settled = false;
+                const settle = () => { if (!settled) {
+                    settled = true;
+                    resolve();
+                } };
+                // Timeout handler
+                const timer = setTimeout(() => {
+                    if (settled)
+                        return;
+                    child.status = 'timed_out';
+                    child.error = `Timed out after ${timeoutMs}ms`;
+                    child.completedAt = new Date().toISOString();
+                    const session = this.sessions.get(child.id);
+                    if (session?.claudeProcess?.isAlive()) {
+                        session.claudeProcess.stop();
+                    }
+                    settle();
+                }, timeoutMs);
+                // Result hook: Claude completed a turn
+                const onResult = (sessionId, isError) => {
+                    if (sessionId !== child.id || settled)
+                        return;
+                    const session = this.sessions.get(child.id);
+                    if (!session) {
+                        child.status = 'failed';
+                        child.error = 'Session was deleted';
+                        child.completedAt = new Date().toISOString();
+                        clearTimeout(timer);
+                        settle();
+                        return;
+                    }
+                    const text = this.extractText(session.outputHistory);
+                    // Check if the final step was done; if not, nudge (keep listening)
+                    if (this.ensureFinalStep(child, session, text))
+                        return;
+                    // Don't mark as completed while the session still has pending
+                    // tool approvals or control requests — the Claude process may
+                    // still be alive and blocked on an approval (e.g. git push).
+                    // Keep monitoring; the next result/exit event will re-evaluate.
+                    if (session.pendingToolApprovals.size > 0 || session.pendingControlRequests.size > 0)
+                        return;
+                    child.status = isError ? 'failed' : 'completed';
+                    child.result = text || null;
+                    child.error = isError ? 'Claude returned an error' : null;
+                    child.completedAt = new Date().toISOString();
+                    clearTimeout(timer);
+                    settle();
+                };
+                // Exit hook: Claude process exited
+                const onExit = (sessionId, _code, _signal, willRestart) => {
+                    if (sessionId !== child.id || settled)
+                        return;
+                    if (willRestart)
+                        return; // Will auto-restart, keep monitoring
+                    const session = this.sessions.get(child.id);
+                    const text = session ? this.extractText(session.outputHistory) : '';
+                    child.status = text.length > 100 ? 'completed' : 'failed';
+                    child.result = text || null;
+                    child.error = text.length <= 100 ? 'Claude exited without sufficient output' : null;
+                    child.completedAt = new Date().toISOString();
+                    clearTimeout(timer);
+                    settle();
+                };
+                this.sessions.onSessionResult(onResult);
+                this.sessions.onSessionExit(onExit);
+            });
+        }
+        finally {
+            // Safety net: ensure isProcessing is cleared when monitoring ends.
+            // handleClaudeResult should have already done this, but edge cases
+            // (nudge race, missed result event) can leave the flag stuck.
+            this.sessions.clearProcessingFlag(child.id);
+        }
+    }
+    /**
+     * Check whether the session completed the expected final step (PR, push, deploy).
+     * If not, send a follow-up instruction and return true so monitoring continues.
+     * Only nudges once per child to avoid infinite loops.
+     */
+    ensureFinalStep(child, session, text) {
+        // Only nudge once
+        if (child._nudged)
+            return false;
+        const policy = child.request.completionPolicy;
+        const lowerText = text.toLowerCase();
+        let missing = false;
+        let instruction = '';
+        if (policy === 'pr') {
+            // Check if a PR was created
+            const prCreated = lowerText.includes('pull request') || lowerText.includes('created a pr') || lowerText.includes('gh pr create');
+            if (!prCreated) {
+                missing = true;
+                instruction = 'You completed the code changes but did not create a Pull Request. Please push your branch and create a PR now with a clear description of what was changed and why.';
+            }
+        }
+        else if (policy === 'merge') {
+            // Check if changes were pushed
+            const pushed = lowerText.includes('git push') || lowerText.includes('pushed');
+            if (!pushed) {
+                missing = true;
+                instruction = 'You completed the code changes but did not push them. Please push your changes to the remote now.';
+            }
+        }
+        if (missing && instruction && session.claudeProcess?.isAlive()) {
+            child._nudged = true;
+            // Mark the result message as superseded so monitoring can ignore it
+            // without mutating the outputHistory array (which would break replay)
+            const resultMsg = session.outputHistory.find(m => m.type === 'result');
+            if (resultMsg)
+                resultMsg._superseded = true;
+            this.sessions.sendInput(child.id, instruction);
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Extract assistant text from session output history.
+     */
+    extractText(history) {
+        return history
+            .filter((m) => m.type === 'output')
+            .map(m => m.data)
+            .join('');
+    }
+}
+//# sourceMappingURL=orchestrator-children.js.map

package/server/dist/orchestrator-children.js.map

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

package/server/dist/orchestrator-learning.d.ts

@@ -0,0 +1,134 @@
+/**
+ * Orchestrator self-improving memory — extraction, deduplication, aging,
+ * pattern learning, and user skill modeling.
+ *
+ * This module adds the intelligence layer on top of OrchestratorMemory:
+ * - Extracts memory candidates from session interactions
+ * - Deduplicates against existing memories using FTS similarity
+ * - Ages and decays stale items on a schedule
+ * - Tracks finding outcomes to improve future triage
+ * - Maintains a user skill model that adapts guidance
+ * - Records decisions with outcome tracking
+ */
+import { OrchestratorMemory, type MemoryType, type MemoryItem } from './orchestrator-memory.js';
+/** A candidate extracted from a session interaction. */
+export interface MemoryCandidate {
+    memoryType: MemoryType;
+    title: string;
+    content: string;
+    scope: string | null;
+    tags: string[];
+    confidence: number;
+}
+/** Finding outcome — tracks what happened when a finding was acted on or skipped. */
+export interface FindingOutcome {
+    findingId: string;
+    repo: string;
+    category: string;
+    severity: string;
+    action: 'implemented' | 'skipped' | 'deferred';
+    reason: string;
+    sessionId: string | null;
+    outcome: 'success' | 'failure' | 'pending' | null;
+    timestamp: string;
+}
+/** User skill assessment per domain. */
+export interface SkillLevel {
+    domain: string;
+    level: 'beginner' | 'intermediate' | 'advanced' | 'expert';
+    confidence: number;
+    signals: string[];
+    lastUpdated: string;
+}
+/** A decision record with outcome tracking. */
+export interface DecisionRecord {
+    id: string;
+    decision: string;
+    rationale: string;
+    repo: string | null;
+    relatedFinding: string | null;
+    expectedOutcome: string;
+    actualOutcome: string | null;
+    outcomeAssessedAt: string | null;
+    timestamp: string;
+}
+/**
+ * Extract memory candidates from an interaction transcript.
+ *
+ * This is a rule-based extractor that looks for patterns indicating
+ * durable information worth remembering. In future, this could be
+ * enhanced with an LLM call for richer extraction.
+ */
+export declare function extractMemoryCandidates(userMessage: string, assistantResponse: string, currentRepo: string | null): MemoryCandidate[];
+/**
+ * Check if a candidate is a duplicate of an existing memory item.
+ * Uses FTS search to find similar items, then compares content overlap.
+ */
+export declare function findDuplicate(memory: OrchestratorMemory, candidate: MemoryCandidate, threshold?: number): MemoryItem | null;
+/**
+ * Smart upsert: insert candidate if no duplicate exists, update if similar.
+ * Returns the memory item ID and whether it was new or updated.
+ */
+export declare function smartUpsert(memory: OrchestratorMemory, candidate: MemoryCandidate, sourceRef?: string | null): {
+    id: string;
+    action: 'inserted' | 'updated' | 'skipped';
+};
+/**
+ * Run the aging/decay cycle:
+ * 1. Expire items past their TTL
+ * 2. Compact old journal entries into monthly summaries
+ * 3. Decay confidence of items that haven't been accessed recently
+ */
+export declare function runAgingCycle(memory: OrchestratorMemory): {
+    expired: number;
+    compacted: number;
+    decayed: number;
+};
+/**
+ * Record the outcome of a finding triage decision.
+ */
+export declare function recordFindingOutcome(memory: OrchestratorMemory, outcome: FindingOutcome): string;
+/**
+ * Analyze past finding outcomes to compute a triage recommendation.
+ * Returns the likely action and confidence based on historical patterns.
+ */
+export declare function getTriageRecommendation(memory: OrchestratorMemory, category: string, severity: string, repo: string | null): {
+    action: 'implement' | 'skip' | 'defer' | 'unknown';
+    confidence: number;
+    reason: string;
+};
+/** Load the user's skill profile from disk. */
+export declare function loadSkillProfile(): SkillLevel[];
+/** Save the skill profile to disk. */
+export declare function saveSkillProfile(profile: SkillLevel[]): void;
+/**
+ * Update the user's skill level for a domain based on observed signals.
+ * Signals are things like: "used advanced git rebase", "asked basic TypeScript question",
+ * "configured CI pipeline without help".
+ */
+export declare function updateSkillLevel(domain: string, signal: string, indicatedLevel: 'beginner' | 'intermediate' | 'advanced' | 'expert'): SkillLevel;
+/**
+ * Get the user's assessed skill level for a domain.
+ * Returns null if we have no data for this domain.
+ */
+export declare function getSkillLevel(domain: string): SkillLevel | null;
+/**
+ * Get a guidance style recommendation based on the user's overall skill profile.
+ */
+export declare function getGuidanceStyle(): {
+    tone: 'tutorial' | 'collaborative' | 'concise';
+    explainLevel: 'detailed' | 'moderate' | 'minimal';
+    domains: Record<string, SkillLevel['level']>;
+};
+/**
+ * Record a decision with expected outcome.
+ */
+export declare function recordDecision(memory: OrchestratorMemory, decision: Omit<DecisionRecord, 'id' | 'timestamp' | 'actualOutcome' | 'outcomeAssessedAt'>): string;
+/**
+ * Update a decision's actual outcome.
+ */
+export declare function assessDecisionOutcome(memory: OrchestratorMemory, decisionId: string, actualOutcome: string): boolean;
+/**
+ * Get decisions that need outcome assessment (older than 7 days, no outcome yet).
+ */
+export declare function getPendingOutcomeAssessments(memory: OrchestratorMemory): DecisionRecord[];