codehere 1.0.1 → 1.0.3

package/dist/infrastructure/config/config-manager.js

@@ -1,174 +0,0 @@
-import { writeFileAtomic } from '../storage/atomic-write.js';
-/**
- * Configuration Manager
- * Manages user preferences and settings for Codehere
- * Stores configuration in data/config.json
- */
-import { readFileSync, existsSync, mkdirSync } from 'fs';
-import { join } from 'path';
-import { getVersion } from '../../utils/version.js';
-function detectDefaultProvider() {
-    if (process.env.ANTHROPIC_API_KEY)
-        return { provider: 'anthropic', model: 'claude-fable-5' };
-    if (process.env.OPENAI_API_KEY)
-        return { provider: 'openai', model: 'gpt-4o-mini' };
-    if (process.env.COHERE_API_KEY)
-        return { provider: 'cohere', model: 'command-r-08-2024' };
-    if (process.env.CODEHERE_AI_PROVIDER === 'local')
-        return { provider: 'local', model: 'llama3' };
-    return { provider: 'auto', model: 'auto' };
-}
-const DEFAULT_CONFIG = {
-    version: getVersion(),
-    preferences: {
-        autoCommit: false,
-        askBeforeDestructive: true,
-        enableCrossTeamLearning: false,
-        defaultModel: detectDefaultProvider().model,
-        maxTokens: 4096,
-        temperature: 0.3,
-        enableStreaming: true,
-    },
-    codebase: {},
-    api: {
-        provider: detectDefaultProvider().provider,
-        model: detectDefaultProvider().model,
-        rateLimitHandling: 'retry',
-    },
-    ui: {
-        showProgress: true,
-        showSummary: true,
-        outputFormat: 'full',
-    },
-};
-export class ConfigManager {
-    configPath;
-    config;
-    constructor(configDir) {
-        const baseDir = configDir || process.cwd();
-        this.configPath = join(baseDir, 'data', 'config.json');
-        this.config = this.loadConfig();
-    }
-    /**
-     * Load configuration from file, creating defaults if not exists
-     */
-    loadConfig() {
-        // Ensure data directory exists
-        const dataDir = join(process.cwd(), 'data');
-        if (!existsSync(dataDir)) {
-            mkdirSync(dataDir, { recursive: true });
-        }
-        // Load existing config or use defaults
-        if (existsSync(this.configPath)) {
-            try {
-                const fileContent = readFileSync(this.configPath, 'utf-8');
-                const loaded = JSON.parse(fileContent);
-                // Merge with defaults to ensure all fields exist
-                return {
-                    ...DEFAULT_CONFIG,
-                    ...loaded,
-                    preferences: {
-                        ...DEFAULT_CONFIG.preferences,
-                        ...loaded.preferences,
-                    },
-                    codebase: {
-                        ...DEFAULT_CONFIG.codebase,
-                        ...loaded.codebase,
-                    },
-                    api: {
-                        ...DEFAULT_CONFIG.api,
-                        ...loaded.api,
-                    },
-                    ui: {
-                        ...DEFAULT_CONFIG.ui,
-                        ...loaded.ui,
-                    },
-                };
-            }
-            catch (error) {
-                console.warn(`Failed to load config from ${this.configPath}, using defaults:`, error);
-                return DEFAULT_CONFIG;
-            }
-        }
-        return DEFAULT_CONFIG;
-    }
-    /**
-     * Save configuration to file
-     */
-    saveConfig() {
-        try {
-            const dataDir = join(process.cwd(), 'data');
-            if (!existsSync(dataDir)) {
-                mkdirSync(dataDir, { recursive: true });
-            }
-            writeFileAtomic(this.configPath, JSON.stringify(this.config, null, 2));
-        }
-        catch (error) {
-            throw new Error(`Failed to save config to ${this.configPath}: ${error instanceof Error ? error.message : String(error)}`, { cause: error });
-        }
-    }
-    /**
-     * Get configuration value
-     */
-    get(key) {
-        return this.config[key];
-    }
-    /**
-     * Get preference value
-     */
-    getPreference(key) {
-        return this.config.preferences[key];
-    }
-    /**
-     * Set configuration value
-     */
-    set(key, value) {
-        this.config[key] = value;
-    }
-    /**
-     * Set preference value
-     */
-    setPreference(key, value) {
-        this.config.preferences[key] = value;
-    }
-    /**
-     * Update codebase information
-     */
-    updateCodebase(root, indexedAt) {
-        this.config.codebase.root = root;
-        if (indexedAt) {
-            this.config.codebase.indexedAt = indexedAt;
-        }
-        this.config.codebase.lastIndexed = new Date().toISOString();
-    }
-    /**
-     * Get full configuration
-     */
-    getAll() {
-        return { ...this.config };
-    }
-    /**
-     * Reset to defaults
-     */
-    reset() {
-        this.config = DEFAULT_CONFIG;
-        this.saveConfig();
-    }
-    /**
-     * Get config file path
-     */
-    getConfigPath() {
-        return this.configPath;
-    }
-}
-/**
- * Get global config manager instance
- */
-let globalConfigManager = null;
-export function getConfigManager(configDir) {
-    if (!globalConfigManager) {
-        globalConfigManager = new ConfigManager(configDir);
-    }
-    return globalConfigManager;
-}
-//# sourceMappingURL=config-manager.js.map

package/dist/infrastructure/config/product-context.js

@@ -1,49 +0,0 @@
-/**
- * Product Context
- *
- * Stores a lightweight "product brain" for the current project.
- * Written by `codehere product init`, read by trust/report/router
- * to give context-aware recommendations.
- *
- * Stored in: .codehere/product.json (per-project, gitignore-friendly)
- */
-import { readFileSync, existsSync } from 'fs';
-import { join } from 'path';
-const CONFIG_DIR = '.codehere';
-const CONFIG_FILE = 'product.json';
-function getConfigPath(cwd) {
-    return join(cwd, CONFIG_DIR, CONFIG_FILE);
-}
-export function loadProductContext(cwd = process.cwd()) {
-    const path = getConfigPath(cwd);
-    if (!existsSync(path))
-        return null;
-    try {
-        return JSON.parse(readFileSync(path, 'utf-8'));
-    }
-    catch {
-        return null;
-    }
-}
-/**
- * Adjusts a trust recommendation based on product context.
- * If no context is available, returns the base recommendation unchanged.
- */
-export function adjustRecommendation(base, criticalCount, highCount, score, ctx) {
-    if (!ctx)
-        return base;
-    const prefix = ctx.productionApp ? `${ctx.name || 'Production app'} · ` : '';
-    if (criticalCount > 0) {
-        return `${prefix}${criticalCount} critical issue${criticalCount !== 1 ? 's' : ''} — fix before this goes to production.`;
-    }
-    if (ctx.riskLevel === 'critical' || ctx.riskLevel === 'high') {
-        if (highCount > 0) {
-            return `${prefix}${highCount} high-severity pattern${highCount !== 1 ? 's' : ''} — worth fixing before merge given the risk level.`;
-        }
-        if (score >= 75) {
-            return `${prefix}Clean scan. Good to merge — double-check ${ctx.sensitiveAreas.slice(0, 2).join(' and ') || 'sensitive areas'} manually.`;
-        }
-    }
-    return base;
-}
-//# sourceMappingURL=product-context.js.map

package/dist/infrastructure/context/adapters/drawio-source.js

@@ -1,157 +0,0 @@
-/**
- * draw.io context-source adapter (v0.8 S5 · third reference adapter).
- *
- * URL shapes accepted (we route both via the same scheme to keep the
- * agent prompt forgiving):
- *   - `drawio://<gist-or-raw-url-base64>`   · base64url-encoded source URL
- *   - `drawio://gh/<owner>/<repo>/<path>`   · raw GitHub-hosted .drawio XML
- *   - `drawio://url/<urlencoded-https-url>` · arbitrary HTTPS-hosted .drawio
- *
- * No OAuth · draw.io is a client-side editor, the file itself is the
- * payload. We fetch the raw XML, summarize node + edge counts, and emit
- * the first ~3KB of the XML so the agent can read structure without us
- * doing graphviz-style parsing here. Bigger diagrams get a `...truncated`
- * suffix; agents can ask the human for a screenshot if they need pixels.
- *
- * Local-first: no codehere endpoint is contacted. Network call goes
- * directly to GitHub-raw / the supplied HTTPS host. Audit chain records
- * fetch + byte count, never content.
- */
-import { ContextSourceError, estimateTokens, } from '../context-source.js';
-const MAX_XML_CHARS = 3000;
-const MAX_RESPONSE_BYTES = 1_500_000; // 1.5MB · refuse anything bigger to protect prompt budget
-/** Turn the codehere drawio:// URL into a concrete HTTPS fetch target. */
-function resolveTarget(url) {
-    const raw = url.toString();
-    const after = raw.slice('drawio://'.length).replace(/^\/+/, '');
-    if (!after) {
-        throw new ContextSourceError('drawio', 'invalid_url', 'drawio URL missing path');
-    }
-    // gh/<owner>/<repo>/<path...>
-    if (after.startsWith('gh/')) {
-        const parts = after.slice('gh/'.length).split('/');
-        if (parts.length < 3) {
-            throw new ContextSourceError('drawio', 'invalid_url', 'gh/ path needs <owner>/<repo>/<path>');
-        }
-        const [owner, repo, ...rest] = parts;
-        const path = rest.join('/');
-        if (!/^[A-Za-z0-9._-]+$/.test(owner) || !/^[A-Za-z0-9._-]+$/.test(repo)) {
-            throw new ContextSourceError('drawio', 'invalid_url', 'gh/ owner/repo must be alphanumeric');
-        }
-        return {
-            fetchUrl: `https://raw.githubusercontent.com/${owner}/${repo}/HEAD/${path}`,
-            label: `github.com/${owner}/${repo}/${path}`,
-        };
-    }
-    // url/<urlencoded-https-url>
-    if (after.startsWith('url/')) {
-        const encoded = after.slice('url/'.length);
-        const decoded = safeDecode(encoded);
-        if (!/^https:\/\//.test(decoded)) {
-            throw new ContextSourceError('drawio', 'invalid_url', 'url/ target must be https://');
-        }
-        return { fetchUrl: decoded, label: decoded };
-    }
-    // base64url-encoded full URL
-    const decoded = safeBase64UrlDecode(after);
-    if (decoded && /^https:\/\//.test(decoded)) {
-        return { fetchUrl: decoded, label: decoded };
-    }
-    throw new ContextSourceError('drawio', 'invalid_url', 'use drawio://gh/<owner>/<repo>/<path> · drawio://url/<urlencoded-https> · or drawio://<base64url-https>');
-}
-function safeDecode(s) {
-    try {
-        return decodeURIComponent(s);
-    }
-    catch {
-        return '';
-    }
-}
-function safeBase64UrlDecode(s) {
-    try {
-        const pad = '='.repeat((4 - (s.length % 4)) % 4);
-        return Buffer.from(s.replace(/-/g, '+').replace(/_/g, '/') + pad, 'base64').toString('utf-8');
-    }
-    catch {
-        return '';
-    }
-}
-export const drawioSource = {
-    id: 'drawio',
-    label: 'draw.io',
-    scheme: 'drawio',
-    description: 'Fetch a draw.io / diagrams.net diagram XML (architecture, flowchart, etc.)',
-    isConfigured() {
-        // Public-by-URL · no auth needed. Always available.
-        return true;
-    },
-    async fetch(url, ctx) {
-        const target = resolveTarget(url);
-        const res = await ctx.httpGet(target.fetchUrl, { 'User-Agent': 'codehere/0.8' });
-        if (res.status === 404) {
-            throw new ContextSourceError('drawio', 'not_found', `diagram not found at ${target.label}`);
-        }
-        if (res.status === 429) {
-            throw new ContextSourceError('drawio', 'rate_limit', `host returned 429 for ${target.label}`);
-        }
-        if (res.status !== 200) {
-            throw new ContextSourceError('drawio', 'network', `host returned ${res.status} for ${target.label}: ${res.body.slice(0, 200)}`);
-        }
-        if (res.body.length > MAX_RESPONSE_BYTES) {
-            throw new ContextSourceError('drawio', 'parse', `diagram too big (${res.body.length} bytes · limit ${MAX_RESPONSE_BYTES})`);
-        }
-        if (!looksLikeDrawio(res.body)) {
-            throw new ContextSourceError('drawio', 'parse', 'response does not look like a draw.io XML or SVG file');
-        }
-        const stats = quickStats(res.body);
-        const text = renderDiagramAsPlainText(target, res.body, stats);
-        return {
-            url: url.toString(),
-            source: 'drawio',
-            fetchedAt: new Date(ctx.now ? ctx.now() : Date.now()).toISOString(),
-            text,
-            estimatedTokens: estimateTokens(text),
-            metadata: {
-                label: target.label,
-                bytes: res.body.length,
-                cellCount: stats.cellCount,
-                edgeCount: stats.edgeCount,
-                pageCount: stats.pageCount,
-            },
-        };
-    },
-};
-/** Does this payload look like a draw.io diagram (XML) or SVG export?
- *  Accept any prolog (whitespace, BOM, `<?xml ...?>`) before the first
- *  meaningful tag · `<mxfile`, `<mxGraphModel`, or `<svg`. */
-function looksLikeDrawio(body) {
-    const trimmed = body.replace(/^\uFEFF/, '').trimStart();
-    const stripped = trimmed.startsWith('<?') ? trimmed.slice(trimmed.indexOf('?>') + 2).trimStart() : trimmed;
-    return /^<(mxfile|mxGraphModel|svg)\b/i.test(stripped);
-}
-/** Cheap regex stats · we don't ship a real XML parser. */
-function quickStats(xml) {
-    const cellMatches = xml.match(/<mxCell\b/g);
-    const edgeMatches = xml.match(/<mxCell\b[^>]*\bedge="1"/g);
-    const pageMatches = xml.match(/<diagram\b/g);
-    return {
-        cellCount: cellMatches ? cellMatches.length : 0,
-        edgeCount: edgeMatches ? edgeMatches.length : 0,
-        pageCount: pageMatches ? pageMatches.length : 1,
-    };
-}
-function renderDiagramAsPlainText(target, xml, stats) {
-    const lines = [];
-    lines.push(`draw.io diagram · ${target.label}`);
-    lines.push('');
-    lines.push(`structure: ${stats.cellCount} cells · ${stats.edgeCount} edges · ${stats.pageCount} page${stats.pageCount === 1 ? '' : 's'}`);
-    lines.push(`bytes: ${xml.length}`);
-    lines.push('');
-    lines.push('--- raw xml (truncated) ---');
-    lines.push(xml.slice(0, MAX_XML_CHARS));
-    if (xml.length > MAX_XML_CHARS) {
-        lines.push(`...[truncated · diagram is ${xml.length} chars · ask the human for a screenshot if structure isn't clear]`);
-    }
-    return lines.join('\n');
-}
-//# sourceMappingURL=drawio-source.js.map

package/dist/infrastructure/context/adapters/figma-source.js

@@ -1,198 +0,0 @@
-/**
- * Figma context-source adapter (v0.8 S1 · second reference adapter).
- *
- * URL shapes:
- *   figma://file/<file-key>                  · whole-file metadata + top-level frames
- *   figma://file/<file-key>/node/<node-id>   · one node + its children, flattened
- *
- * Returns the design tree as indented plain text: frame names, types,
- * dimensions, text content of TEXT nodes, fill colors when they're solid.
- * Generated previews + raster bytes are skipped · agents read text, not
- * pixels (overlay-renderer in v0.9 will surface raw frames separately).
- *
- * Auth: ctx.config['figma'] = { token: '<personal-access-token>' }
- * Token comes from figma.com/developers/api · personal access token.
- */
-import { ContextSourceError, estimateTokens, } from '../context-source.js';
-const FIGMA_API = 'https://api.figma.com/v1';
-const MAX_TREE_NODES = 200;
-const MAX_TEXT_PER_NODE = 240;
-function parsePath(url) {
-    // figma://file/<key> · hostname = 'file', pathname = '/<key>'
-    // figma://file/<key>/node/<id>
-    const host = url.host || url.hostname; // 'file'
-    if (host !== 'file') {
-        throw new ContextSourceError('figma', 'invalid_url', `URL must start with figma://file/<key>; got host='${host}'`);
-    }
-    const parts = url.pathname.split('/').filter(Boolean);
-    if (!parts.length) {
-        throw new ContextSourceError('figma', 'invalid_url', 'missing file key in figma:// URL');
-    }
-    const fileKey = parts[0];
-    let nodeId = null;
-    if (parts.length >= 3 && parts[1] === 'node') {
-        nodeId = decodeURIComponent(parts.slice(2).join('/'));
-    }
-    return { fileKey, nodeId };
-}
-export const figmaSource = {
-    id: 'figma',
-    label: 'Figma',
-    scheme: 'figma',
-    description: 'Fetch a Figma file or single node (tree, dimensions, text content)',
-    isConfigured(ctx) {
-        const cfg = ctx.config['figma'];
-        if (!cfg)
-            return false;
-        if (cfg.oauth?.accessToken)
-            return true;
-        return typeof cfg.token === 'string' && cfg.token.length > 8;
-    },
-    async fetch(url, ctx) {
-        const cfg = ctx.config['figma'] ?? {};
-        // Figma supports BOTH a personal-access token (X-Figma-Token header) AND
-        // an OAuth bearer (Authorization: Bearer ...) · pick whichever is set.
-        let headers;
-        if (cfg.oauth?.accessToken) {
-            headers = { Authorization: `Bearer ${cfg.oauth.accessToken}` };
-        }
-        else if (cfg.token) {
-            headers = { 'X-Figma-Token': cfg.token };
-        }
-        else {
-            throw new ContextSourceError('figma', 'auth', 'no token or OAuth in ctx.config["figma"]');
-        }
-        const { fileKey, nodeId } = parsePath(url);
-        const endpoint = cfg.endpoint ?? FIGMA_API;
-        let res;
-        if (nodeId) {
-            const target = `${endpoint}/files/${encodeURIComponent(fileKey)}/nodes?ids=${encodeURIComponent(nodeId)}`;
-            res = await ctx.httpGet(target, headers);
-        }
-        else {
-            const target = `${endpoint}/files/${encodeURIComponent(fileKey)}?depth=2`;
-            res = await ctx.httpGet(target, headers);
-        }
-        if (res.status === 401 || res.status === 403) {
-            throw new ContextSourceError('figma', 'auth', `Figma returned ${res.status}`);
-        }
-        if (res.status === 404) {
-            throw new ContextSourceError('figma', 'not_found', `file ${fileKey} not found`);
-        }
-        if (res.status === 429) {
-            throw new ContextSourceError('figma', 'rate_limit', 'Figma rate limit hit');
-        }
-        if (res.status !== 200) {
-            throw new ContextSourceError('figma', 'network', `Figma returned ${res.status}: ${res.body.slice(0, 200)}`);
-        }
-        let text;
-        let metadata;
-        if (nodeId) {
-            const parsed = JSON.parse(res.body);
-            if (parsed.err)
-                throw new ContextSourceError('figma', 'parse', `Figma error: ${parsed.err}`);
-            const node = parsed.nodes?.[nodeId]?.document;
-            if (!node)
-                throw new ContextSourceError('figma', 'not_found', `node ${nodeId} not in response`);
-            text = renderNodeAsTree(node, fileKey, nodeId);
-            metadata = { fileKey, nodeId, type: node.type, name: node.name, frames: collectFrames(node) };
-        }
-        else {
-            const parsed = JSON.parse(res.body);
-            if (parsed.err)
-                throw new ContextSourceError('figma', 'parse', `Figma error: ${parsed.err}`);
-            if (!parsed.document)
-                throw new ContextSourceError('figma', 'parse', 'Figma response missing document');
-            text = renderFile(parsed, fileKey);
-            metadata = {
-                fileKey,
-                name: parsed.name ?? null,
-                lastModified: parsed.lastModified ?? null,
-                frames: collectFrames(parsed.document),
-            };
-        }
-        return {
-            url: url.toString(),
-            source: 'figma',
-            fetchedAt: new Date(ctx.now ? ctx.now() : Date.now()).toISOString(),
-            text,
-            estimatedTokens: estimateTokens(text),
-            metadata,
-        };
-    },
-};
-function collectFrames(root, limit = 12) {
-    const frames = [];
-    const visit = (node) => {
-        if (frames.length >= limit)
-            return;
-        if (node.type === 'FRAME') {
-            const bb = node.absoluteBoundingBox;
-            frames.push({
-                name: node.name,
-                width: bb ? Math.round(bb.width) : null,
-                height: bb ? Math.round(bb.height) : null,
-                text: firstText(node),
-            });
-        }
-        for (const child of node.children ?? [])
-            visit(child);
-    };
-    visit(root);
-    return frames;
-}
-function firstText(node) {
-    if (node.characters)
-        return node.characters.replace(/\s+/g, ' ').slice(0, MAX_TEXT_PER_NODE);
-    for (const child of node.children ?? []) {
-        const t = firstText(child);
-        if (t)
-            return t;
-    }
-    return null;
-}
-function renderFile(file, fileKey) {
-    const lines = [];
-    lines.push(`Figma file · ${file.name ?? '(unnamed)'}`);
-    lines.push(`https://www.figma.com/file/${fileKey}`);
-    if (file.lastModified)
-        lines.push(`updated: ${file.lastModified}`);
-    lines.push('');
-    if (file.document) {
-        lines.push('--- top-level tree (depth 2) ---');
-        renderInto(lines, file.document, 0, { remaining: MAX_TREE_NODES });
-    }
-    return lines.join('\n');
-}
-function renderNodeAsTree(node, fileKey, nodeId) {
-    const lines = [];
-    lines.push(`Figma node · ${node.name} (${node.type})`);
-    lines.push(`https://www.figma.com/file/${fileKey}?node-id=${encodeURIComponent(nodeId)}`);
-    lines.push('');
-    renderInto(lines, node, 0, { remaining: MAX_TREE_NODES });
-    return lines.join('\n');
-}
-function renderInto(out, node, depth, budget) {
-    if (budget.remaining <= 0) {
-        if (budget.remaining === 0) {
-            out.push('...[tree truncated · node budget reached]');
-            budget.remaining = -1;
-        }
-        return;
-    }
-    budget.remaining -= 1;
-    const indent = '  '.repeat(depth);
-    const bb = node.absoluteBoundingBox;
-    const dim = bb ? ` ${Math.round(bb.width)}×${Math.round(bb.height)}` : '';
-    const visible = node.visible === false ? ' [hidden]' : '';
-    let line = `${indent}${node.type} · ${node.name}${dim}${visible}`;
-    if (node.characters) {
-        const t = node.characters.replace(/\s+/g, ' ').slice(0, MAX_TEXT_PER_NODE);
-        line += ` · "${t}${node.characters.length > MAX_TEXT_PER_NODE ? '…' : ''}"`;
-    }
-    out.push(line);
-    for (const child of node.children ?? []) {
-        renderInto(out, child, depth + 1, budget);
-    }
-}
-//# sourceMappingURL=figma-source.js.map