@kernel.chat/kbot 2.10.1 → 2.12.0

package/dist/evolution.d.ts

@@ -0,0 +1,112 @@
+export interface Weakness {
+    /** Which subsystem is weak (e.g. 'streaming', 'tool-execution', 'routing') */
+    area: string;
+    /** What's wrong — human-readable */
+    description: string;
+    /** Severity: how much this hurts overall quality */
+    severity: 'low' | 'medium' | 'high';
+    /** Evidence — metric name, sample count, etc. */
+    evidence: string;
+    /** Suggested file to improve */
+    targetFile?: string;
+}
+export interface Proposal {
+    /** File path relative to packages/kbot/ */
+    file: string;
+    /** Description of the change */
+    description: string;
+    /** The weakness this addresses */
+    weakness: Weakness;
+    /** Full proposed file content (or diff instructions) */
+    patch: string;
+    /** Original file content for rollback reference */
+    original: string;
+}
+export interface EvolutionResult {
+    /** Whether the change was applied or rolled back */
+    status: 'applied' | 'rolled-back' | 'skipped';
+    /** Why this status */
+    reason: string;
+    /** Weakness that was targeted */
+    weakness: Weakness;
+    /** Score improvement (positive = better) */
+    delta: number;
+    /** Timestamp */
+    timestamp: string;
+}
+export interface EvolutionCycle {
+    /** Unique ID for this cycle */
+    id: string;
+    /** When the cycle started */
+    startedAt: string;
+    /** When the cycle ended */
+    endedAt?: string;
+    /** Weaknesses found */
+    weaknesses: Weakness[];
+    /** Proposals generated */
+    proposals: Proposal[];
+    /** Results of applying proposals */
+    results: EvolutionResult[];
+    /** Overall cycle status */
+    status: 'running' | 'completed' | 'failed' | 'aborted';
+    /** Error message if failed */
+    error?: string;
+}
+/**
+ * Analyze kbot's performance data to find areas for improvement.
+ * Uses the confidence engine's skill profile + learning stats.
+ */
+export declare function diagnose(): Weakness[];
+/**
+ * Ask the LLM to propose a code improvement for a weakness.
+ * Reuses the auth/provider pattern from self-eval.ts.
+ */
+export declare function proposeImprovement(weakness: Weakness): Promise<Proposal | null>;
+/**
+ * Apply a proposal temporarily and run validation (tsc + vitest).
+ * Returns true if the change passes, false otherwise.
+ */
+export declare function validate(proposal: Proposal): {
+    passes: boolean;
+    errors: string;
+};
+export interface Metrics {
+    /** Lines of code in the file */
+    loc: number;
+    /** Cyclomatic complexity estimate (branches + loops) */
+    complexity: number;
+    /** Number of TODO/FIXME/HACK markers */
+    todoCount: number;
+    /** Number of exported functions */
+    exportCount: number;
+}
+export declare function scoreMetrics(source: string): Metrics;
+/**
+ * Compute a delta score between before/after metrics.
+ * Positive = improvement, negative = regression.
+ */
+export declare function computeDelta(before: Metrics, after: Metrics): number;
+/**
+ * Run one evolution cycle:
+ * 1. Check for clean working tree
+ * 2. Diagnose weaknesses
+ * 3. For each weakness (max 3): propose → validate → score → apply/rollback
+ * 4. Log everything
+ */
+export declare function runEvolutionCycle(): Promise<EvolutionCycle>;
+/** Get the full evolution log */
+export declare function getEvolutionLog(): EvolutionCycle[];
+/** Get a summary of evolution activity */
+export declare function getEvolutionStats(): {
+    totalCycles: number;
+    totalApplied: number;
+    totalRolledBack: number;
+    totalSkipped: number;
+    avgDelta: number;
+    lastCycle: string | null;
+};
+/** Format evolution status for terminal display */
+export declare function formatEvolutionStatus(): string;
+/** Format diagnosis output for terminal display */
+export declare function formatDiagnosis(weaknesses: Weakness[]): string;
+//# sourceMappingURL=evolution.d.ts.map

package/dist/evolution.d.ts.map

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