@unerr-ai/unerr 0.2.1 → 0.2.3

package/dist/config/settings.js

@@ -1,174 +0,0 @@
-/**
- * Settings Manager — user-level and project-level configuration.
- *
- * Hierarchy (last wins):
- *   1. Defaults (hardcoded)
- *   2. User settings: ~/.unerr/settings.json
- *   3. Project settings: .unerr/settings.json
- *   4. Environment variables: ANTHROPIC_API_KEY, UNERR_MODEL, etc.
- */
-import { existsSync, readFileSync } from "node:fs";
-import { homedir } from "node:os";
-import { join } from "node:path";
-import { z } from "zod";
-// ── Schema ────────────────────────────────────────────────────
-const LlmProviderEnum = z.enum([
-    "ollama",
-    "lm-studio",
-    "openai-compatible",
-    "anthropic-direct",
-]);
-const EndpointConfigSchema = z.object({
-    provider: LlmProviderEnum.optional(),
-    baseUrl: z.string().optional(),
-    model: z.string().optional(),
-    apiKey: z.string().optional(),
-});
-/**
- * BYO-LLM provider configuration for True Local Mode.
- *
- * Supports two usage patterns:
- *
- * 1. **Simple (single provider):** Set top-level `provider`, `baseUrl`, `apiKey`.
- *    Both embedding and inference use the same provider. `embeddingModel` and
- *    `chatModel` select which models to use.
- *
- * 2. **Split (different providers):** Set `embedding` and/or `inference` sub-objects.
- *    Each can have its own `provider`, `baseUrl`, `apiKey`, and `model`.
- *    Sub-object fields override top-level fields for that concern.
- *
- * Examples:
- *   - Ollama for everything: { provider: "ollama" }
- *   - Fireworks embedding + Anthropic chat:
- *     { embedding: { provider: "openai-compatible", baseUrl: "https://api.fireworks.ai/inference/v1", model: "...", apiKey: "..." },
- *       inference: { provider: "anthropic-direct", apiKey: "..." } }
- */
-export const LocalLlmConfigSchema = z.object({
-    provider: LlmProviderEnum.default("ollama"),
-    baseUrl: z.string().optional(),
-    embeddingModel: z.string().default("nomic-embed-text"),
-    chatModel: z.string().default("llama3"),
-    apiKey: z.string().optional(),
-    maxConcurrency: z.number().int().min(1).default(2),
-    embeddingDimensions: z.number().int().min(1).default(384),
-    embedding: EndpointConfigSchema.optional(),
-    inference: EndpointConfigSchema.optional(),
-});
-/**
- * Resolve the effective embedding endpoint config.
- * `config.embedding` fields override top-level `config` fields.
- */
-export function resolveEmbeddingEndpoint(config) {
-    const e = config.embedding;
-    return {
-        provider: e?.provider ?? config.provider,
-        baseUrl: e?.baseUrl ?? config.baseUrl,
-        model: e?.model ?? config.embeddingModel,
-        apiKey: e?.apiKey ?? config.apiKey,
-    };
-}
-/**
- * Resolve the effective inference (chat) endpoint config.
- * `config.inference` fields override top-level `config` fields.
- */
-export function resolveInferenceEndpoint(config) {
-    const i = config.inference;
-    return {
-        provider: i?.provider ?? config.provider,
-        baseUrl: i?.baseUrl ?? config.baseUrl,
-        model: i?.model ?? config.chatModel,
-        apiKey: i?.apiKey ?? config.apiKey,
-    };
-}
-const LlmConfigSchema = z.object({
-    provider: z
-        .enum(["anthropic", "openai", "google", "ollama", "openai-compatible"])
-        .default("anthropic"),
-    model: z.string().default("claude-sonnet-4-20250514"),
-    apiKey: z.string().optional(),
-    baseUrl: z.string().optional(),
-});
-export const SettingsSchema = z.object({
-    /** Default Claude model for interactive sessions */
-    model: z.string().default("claude-sonnet-4-20250514"),
-    /** Anthropic API key (prefer env var ANTHROPIC_API_KEY) */
-    anthropicApiKey: z.string().optional(),
-    /** Permission mode for tool execution */
-    permissionMode: z.enum(["prompt", "auto", "deny-all"]).default("prompt"),
-    /** Maximum output tokens per LLM turn */
-    maxTokens: z.number().default(8192),
-    /** Enable verbose logging */
-    verbose: z.boolean().default(false),
-    /** AI SDK LLM configuration (Sprint D — unified multi-provider) */
-    llm: LlmConfigSchema.optional(),
-    /** BYO-LLM configuration for local LLM providers */
-    localLlm: LocalLlmConfigSchema.optional(),
-});
-// ── Defaults ──────────────────────────────────────────────────
-const DEFAULTS = SettingsSchema.parse({});
-// ── Loader ────────────────────────────────────────────────────
-function loadJsonFile(filePath) {
-    if (!existsSync(filePath))
-        return {};
-    try {
-        return JSON.parse(readFileSync(filePath, "utf-8"));
-    }
-    catch {
-        return {};
-    }
-}
-/**
- * Load merged settings from all layers.
- */
-export function loadSettings(cwd) {
-    const projectDir = cwd ?? process.cwd();
-    // Layer 2: User settings
-    const userSettings = loadJsonFile(join(homedir(), ".unerr", "settings.json"));
-    // Layer 3: Project settings
-    const projectSettings = loadJsonFile(join(projectDir, ".unerr", "settings.json"));
-    // Layer 4: Environment overrides
-    const envOverrides = {};
-    if (process.env.ANTHROPIC_API_KEY)
-        envOverrides.anthropicApiKey = process.env.ANTHROPIC_API_KEY;
-    if (process.env.UNERR_MODEL)
-        envOverrides.model = process.env.UNERR_MODEL;
-    if (process.env.UNERR_VERBOSE === "true")
-        envOverrides.verbose = true;
-    // AI SDK LLM env overrides (Sprint D)
-    if (process.env.UNERR_LLM_PROVIDER) {
-        envOverrides.llm = {
-            provider: process.env.UNERR_LLM_PROVIDER,
-            ...(process.env.UNERR_MODEL && { model: process.env.UNERR_MODEL }),
-            ...(process.env.UNERR_LLM_API_KEY && {
-                apiKey: process.env.UNERR_LLM_API_KEY,
-            }),
-            ...(process.env.UNERR_LLM_BASE_URL && {
-                baseUrl: process.env.UNERR_LLM_BASE_URL,
-            }),
-        };
-    }
-    // BYO-LLM env overrides
-    if (process.env.UNERR_LOCAL_LLM_PROVIDER)
-        envOverrides.localLlm = {
-            ...projectSettings.localLlm,
-            ...userSettings.localLlm,
-            provider: process.env.UNERR_LOCAL_LLM_PROVIDER,
-            ...(process.env.UNERR_LOCAL_LLM_BASE_URL && {
-                baseUrl: process.env.UNERR_LOCAL_LLM_BASE_URL,
-            }),
-            ...(process.env.UNERR_LOCAL_LLM_EMBEDDING_MODEL && {
-                embeddingModel: process.env.UNERR_LOCAL_LLM_EMBEDDING_MODEL,
-            }),
-            ...(process.env.UNERR_LOCAL_LLM_CHAT_MODEL && {
-                chatModel: process.env.UNERR_LOCAL_LLM_CHAT_MODEL,
-            }),
-        };
-    // Merge: defaults ← user ← project ← env
-    const merged = {
-        ...DEFAULTS,
-        ...userSettings,
-        ...projectSettings,
-        ...envOverrides,
-    };
-    return SettingsSchema.parse(merged);
-}

package/dist/config/tool-detector.js

@@ -1,42 +0,0 @@
-/**
- * AI Tool Auto-Detection — detects installed AI coding tools in a project.
- *
- * Registry-driven: scans directory markers and environment variables
- * from agent-registry.ts to identify all AI tools present.
- *
- * Returns all detected tools so `unerr init` can configure each one.
- */
-import { existsSync } from "node:fs";
-import { join } from "node:path";
-import { AGENT_REGISTRY } from "./agent-registry.js";
-/**
- * Detect all AI coding tools present in the project directory.
- * Checks directory markers and environment variables from the agent registry.
- */
-export function detectTools(cwd) {
-    const detected = [];
-    for (const agent of AGENT_REGISTRY) {
-        // Check directory markers
-        const hasDirMarker = agent.dirMarkers.some((dir) => existsSync(join(cwd, dir)));
-        // Check environment variables
-        const hasEnvVar = agent.envVars.some((envVar) => !!process.env[envVar]);
-        if (hasDirMarker || hasEnvVar) {
-            const configPath = join(cwd, agent.projectConfigPath);
-            detected.push({
-                ide: agent.id,
-                configDir: join(cwd, agent.dirMarkers[0] ?? ""),
-                hasExistingConfig: existsSync(configPath),
-                agent,
-            });
-        }
-    }
-    return detected;
-}
-/**
- * Get a human-readable summary of detected tools.
- */
-export function formatDetectedTools(tools) {
-    if (tools.length === 0)
-        return "No AI tools detected";
-    return tools.map((t) => t.agent.name).join(", ");
-}

package/dist/config/value-surfacing.js

@@ -1,119 +0,0 @@
-/**
- * Value Surfacing — guard formatter, scorecard, and counterfactual explanation.
- *
- * S8.1: Guard fires when session dollar savings exceed threshold.
- * S8.3: Session scorecard formats final session metrics.
- * S8.7: Counterfactual explanation: "Without unerr: ~XK tokens -> with unerr: YK tokens"
- */
-const DEFAULT_CONFIG = {
-    guardThresholdDollars: 0.5,
-    weeklyEnabled: true,
-    scorecardEnabled: true,
-    counterfactualEnabled: true,
-    modelId: "claude-sonnet-4-20250514",
-};
-let currentConfig = { ...DEFAULT_CONFIG };
-export function getValueSurfacingConfig() {
-    return { ...currentConfig };
-}
-export function setValueSurfacingConfig(overrides) {
-    currentConfig = { ...currentConfig, ...overrides };
-}
-export function resetValueSurfacingConfig() {
-    currentConfig = { ...DEFAULT_CONFIG };
-}
-/**
- * Creates a session-scoped guard that fires once when dollar savings threshold is crossed.
- */
-export function createValueGuard(thresholdDollars) {
-    const threshold = thresholdDollars ?? currentConfig.guardThresholdDollars;
-    const state = { fired: false, lastFiredAt: 0 };
-    /**
-     * Check if the guard should fire. Returns the formatted message or null.
-     */
-    function check(sessionDollarsSaved) {
-        if (state.fired)
-            return null;
-        if (sessionDollarsSaved < threshold)
-            return null;
-        state.fired = true;
-        state.lastFiredAt = Date.now();
-        return formatGuardMessage(sessionDollarsSaved);
-    }
-    function hasFired() {
-        return state.fired;
-    }
-    function reset() {
-        state.fired = false;
-        state.lastFiredAt = 0;
-    }
-    return { check, hasFired, reset };
-}
-function formatGuardMessage(dollarsSaved) {
-    return `unerr saved $${dollarsSaved.toFixed(2)} this session`;
-}
-/**
- * Format a session scorecard from raw metrics.
- */
-export function formatScorecard(input) {
-    const intelligence = [];
-    if (input.blastRadiusComputed > 0) {
-        intelligence.push(`${input.blastRadiusComputed} blast radius computation${input.blastRadiusComputed !== 1 ? "s" : ""}`);
-    }
-    if (input.conventionsInjected > 0) {
-        intelligence.push(`${input.conventionsInjected} convention injection${input.conventionsInjected !== 1 ? "s" : ""}`);
-    }
-    if (input.outputsCompressed > 0) {
-        intelligence.push(`${input.outputsCompressed} output${input.outputsCompressed !== 1 ? "s" : ""} compressed`);
-    }
-    if (input.correctionsApplied > 0) {
-        intelligence.push(`${input.correctionsApplied} correction${input.correctionsApplied !== 1 ? "s" : ""} applied`);
-    }
-    if (input.wrongApproachesPrevented > 0) {
-        intelligence.push(`${input.wrongApproachesPrevented} wrong approach${input.wrongApproachesPrevented !== 1 ? "es" : ""} prevented`);
-    }
-    const durationMin = Math.round(input.durationMs / 60_000);
-    return {
-        toolCalls: input.toolCalls,
-        tokensSaved: formatTokens(input.tokensSaved),
-        dollarsSaved: `$${input.dollarsSaved.toFixed(2)}`,
-        efficiency: `${Math.round(input.efficiency)}%`,
-        duration: durationMin > 0 ? `${durationMin} min` : "<1 min",
-        intelligenceApplied: intelligence,
-    };
-}
-// ── S8.7: Counterfactual Explanation ────────────────────────────────
-/**
- * Build counterfactual explanation string.
- * "Without unerr: ~XK tokens -> with unerr: YK tokens (Z% reduction)"
- */
-export function formatCounterfactual(tokensWithout, tokensWith) {
-    const withoutStr = formatTokens(tokensWithout);
-    const withStr = formatTokens(tokensWith);
-    const reduction = tokensWithout > 0
-        ? Math.round(((tokensWithout - tokensWith) / tokensWithout) * 100)
-        : 0;
-    return `Without unerr: ~${withoutStr} tokens \u2192 with unerr: ${withStr} tokens (${reduction}% reduction)`;
-}
-/**
- * Assemble value meta fields for a single response.
- */
-export function assembleValueMeta(tokensSaved, dollarSavings, optimizationDescription) {
-    const meta = {
-        tokens_saved: tokensSaved,
-        dollar_savings: Math.round(dollarSavings * 1_000_000) / 1_000_000,
-        powered_by: "unerr \u2014 intelligent token optimization",
-    };
-    if (optimizationDescription) {
-        meta.optimization = optimizationDescription;
-    }
-    return meta;
-}
-// ── Shared Utilities ────────────────────────────────────────────────
-function formatTokens(n) {
-    if (n >= 1_000_000)
-        return `${(n / 1_000_000).toFixed(1)}M`;
-    if (n >= 1_000)
-        return `${(n / 1_000).toFixed(1)}K`;
-    return String(n);
-}

package/dist/core/context-assembly.js

@@ -1,108 +0,0 @@
-/**
- * Context Assembler — builds the system prompt for the interactive assistant.
- *
- * This is unerr's key differentiator: the system prompt includes graph-powered
- * intelligence about the codebase — conventions, high-risk entities, business context,
- * architecture overview — that no other coding assistant can provide without manual
- * CLAUDE.md authoring.
- *
- * Context layers:
- *   1. Environment: OS, shell, Node version, git branch
- *   2. Project: package.json, README, file structure summary
- *   3. Intelligence: conventions, risk entities, community structure (from CozoDB graph)
- *   4. Memory: .unerr/memory.md or equivalent persistent context
- */
-import { existsSync, readFileSync } from "node:fs";
-import { platform, release } from "node:os";
-import { basename, join } from "node:path";
-import { getCurrentBranch } from "../utils/git.js";
-// ── Environment Context ───────────────────────────────────────
-async function getEnvironmentContext(cwd) {
-    const os = `${platform()} ${release()}`;
-    const shell = process.env.SHELL ?? "unknown";
-    const nodeVersion = process.version;
-    const gitBranch = (await getCurrentBranch(cwd)) ?? "unknown";
-    return {
-        name: "Environment",
-        content: [
-            `OS: ${os}`,
-            `Shell: ${shell}`,
-            `Node: ${nodeVersion}`,
-            `Working directory: ${cwd}`,
-            `Git branch: ${gitBranch}`,
-        ].join("\n"),
-    };
-}
-// ── Project Context ───────────────────────────────────────────
-function getProjectContext(cwd) {
-    const lines = [];
-    // package.json
-    const pkgPath = join(cwd, "package.json");
-    if (existsSync(pkgPath)) {
-        try {
-            const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
-            lines.push(`Project: ${pkg.name ?? basename(cwd)} v${pkg.version ?? "0.0.0"}`);
-            if (pkg.description)
-                lines.push(`Description: ${pkg.description}`);
-            if (pkg.scripts)
-                lines.push(`Scripts: ${Object.keys(pkg.scripts).join(", ")}`);
-        }
-        catch {
-            // Malformed package.json
-        }
-    }
-    // README presence
-    for (const name of ["README.md", "readme.md", "README"]) {
-        if (existsSync(join(cwd, name))) {
-            lines.push(`README: ${name} exists`);
-            break;
-        }
-    }
-    return lines.length > 0
-        ? { name: "Project", content: lines.join("\n") }
-        : null;
-}
-// ── Graph Intelligence Context (the differentiator) ───────────
-/**
- * Build intelligence context from the local CozoDB graph.
- *
- * TODO: Implement graph queries for:
- * - Top conventions and adherence rates (get_conventions)
- * - High-risk entities with blast radius (fan_in > threshold)
- * - Business context for key modules
- * - Community/feature structure
- */
-async function getIntelligenceContext(_graph) {
-    // TODO: Query the graph for conventions, risk entities, architecture overview
-    // This is what makes unerr's assistant unique — the LLM starts with codebase knowledge
-    return null;
-}
-/**
- * Assemble the full system prompt from all context layers.
- */
-export async function assembleContext(opts) {
-    const sections = [];
-    // Layer 1: Environment
-    sections.push(await getEnvironmentContext(opts.cwd));
-    // Layer 2: Project
-    const project = getProjectContext(opts.cwd);
-    if (project)
-        sections.push(project);
-    // Layer 3: Graph intelligence (unerr's moat)
-    if (opts.graph) {
-        const intelligence = await getIntelligenceContext(opts.graph);
-        if (intelligence)
-            sections.push(intelligence);
-    }
-    // Layer 4: Additional instructions
-    if (opts.additionalInstructions) {
-        sections.push({
-            name: "Instructions",
-            content: opts.additionalInstructions,
-        });
-    }
-    const systemPrompt = sections
-        .map((s) => `# ${s.name}\n${s.content}`)
-        .join("\n\n---\n\n");
-    return { systemPrompt, sections };
-}

package/dist/core/conversation.js

@@ -1,33 +0,0 @@
-/**
- * Conversation Manager — in-memory conversation history with optional persistence.
- *
- * Manages the message list for the interactive REPL session.
- * Supports context window management (truncation when approaching limits).
- */
-export class Conversation {
-    messages = [];
-    maxMessages;
-    constructor(opts = {}) {
-        this.maxMessages = opts.maxMessages ?? 100;
-    }
-    /** Add a message to the conversation. */
-    add(message) {
-        this.messages.push(message);
-        // Evict oldest messages (always keep at least the last user message)
-        while (this.messages.length > this.maxMessages) {
-            this.messages.shift();
-        }
-    }
-    /** Get all messages in chronological order. */
-    getMessages() {
-        return [...this.messages];
-    }
-    /** Clear conversation history. */
-    clear() {
-        this.messages = [];
-    }
-    /** Get the number of messages. */
-    get length() {
-        return this.messages.length;
-    }
-}