@phuetz/code-buddy 0.1.24 → 0.1.26

package/dist/agent/repo-profiler.js

@@ -0,0 +1,295 @@
+/**
+ * RepoProfiler
+ *
+ * Scans the current repository to detect language, framework, package manager,
+ * and build/test commands. Produces a compact contextPack string injected into
+ * the agent system prompt to give it awareness of project conventions.
+ *
+ * Result is cached in .codebuddy/repoProfile.json and invalidated when
+ * package.json (or equivalent) changes.
+ */
+import fs from 'fs';
+import path from 'path';
+import { logger } from '../utils/logger.js';
+const CACHE_FILENAME = '.codebuddy/repoProfile.json';
+/**
+ * Profiles a repository to produce structured metadata.
+ */
+export class RepoProfiler {
+    cwd;
+    cachePath;
+    constructor(cwd) {
+        this.cwd = cwd || process.cwd();
+        this.cachePath = path.join(this.cwd, CACHE_FILENAME);
+    }
+    /**
+     * Get or compute the repo profile.
+     * Uses cached result if the primary config file hasn't changed.
+     */
+    async getProfile() {
+        const cached = this.loadCache();
+        if (cached && !this.isCacheStale(cached)) {
+            return cached;
+        }
+        const profile = await this.computeProfile();
+        this.saveCache(profile);
+        return profile;
+    }
+    /**
+     * Force recompute (ignores cache).
+     */
+    async refresh() {
+        const profile = await this.computeProfile();
+        this.saveCache(profile);
+        return profile;
+    }
+    // ──────────────────────────────────────────────────────────────
+    // Private implementation
+    // ──────────────────────────────────────────────────────────────
+    async computeProfile() {
+        const languages = [];
+        let framework;
+        let packageManager;
+        const commands = {};
+        const directories = {};
+        const conventions = {};
+        let configMtime;
+        // ── Node / TypeScript ──────────────────────────────────────
+        const pkgJsonPath = path.join(this.cwd, 'package.json');
+        if (this.exists(pkgJsonPath)) {
+            configMtime = this.mtime(pkgJsonPath);
+            languages.push('TypeScript', 'JavaScript');
+            try {
+                const pkg = JSON.parse(fs.readFileSync(pkgJsonPath, 'utf-8'));
+                // Package manager
+                if (this.exists(path.join(this.cwd, 'pnpm-lock.yaml'))) {
+                    packageManager = 'pnpm';
+                }
+                else if (this.exists(path.join(this.cwd, 'yarn.lock'))) {
+                    packageManager = 'yarn';
+                }
+                else {
+                    packageManager = 'npm';
+                }
+                const pm = packageManager;
+                const run = pm === 'npm' ? 'npm run' : pm;
+                // Scripts
+                const scripts = pkg.scripts || {};
+                if (scripts.test)
+                    commands.test = `${run} test`;
+                if (scripts.lint)
+                    commands.lint = `${run} lint`;
+                if (scripts.format)
+                    commands.format = `${run} format`;
+                if (scripts.build)
+                    commands.build = `${run} build`;
+                // Framework detection from dependencies
+                const allDeps = {
+                    ...pkg.dependencies,
+                    ...pkg.devDependencies,
+                    ...pkg.peerDependencies,
+                };
+                if (allDeps['react'] || allDeps['react-dom'])
+                    framework = 'React';
+                else if (allDeps['next'])
+                    framework = 'Next.js';
+                else if (allDeps['vue'])
+                    framework = 'Vue';
+                else if (allDeps['@angular/core'])
+                    framework = 'Angular';
+                else if (allDeps['express'])
+                    framework = 'Express';
+                else if (allDeps['fastify'])
+                    framework = 'Fastify';
+                else if (allDeps['ink'])
+                    framework = 'Ink (terminal UI)';
+                // Naming convention hint
+                if (allDeps['eslint'] || pkg.eslintConfig) {
+                    conventions.naming = 'camelCase (JS/TS)';
+                    conventions.lintRules = ['eslint'];
+                }
+            }
+            catch {
+                // Malformed package.json — ignore
+            }
+        }
+        // ── Python ────────────────────────────────────────────────
+        const pyprojectPath = path.join(this.cwd, 'pyproject.toml');
+        const requirementsPath = path.join(this.cwd, 'requirements.txt');
+        if (this.exists(pyprojectPath) || this.exists(requirementsPath)) {
+            languages.push('Python');
+            if (this.exists(pyprojectPath)) {
+                packageManager = 'poetry';
+                configMtime = configMtime || this.mtime(pyprojectPath);
+                commands.test = commands.test || 'poetry run pytest';
+                commands.lint = commands.lint || 'poetry run ruff check .';
+                commands.format = commands.format || 'poetry run black .';
+            }
+            else {
+                packageManager = 'pip';
+                configMtime = configMtime || this.mtime(requirementsPath);
+                commands.test = commands.test || 'python -m pytest';
+            }
+        }
+        // ── Rust ─────────────────────────────────────────────────
+        const cargoPath = path.join(this.cwd, 'Cargo.toml');
+        if (this.exists(cargoPath)) {
+            languages.push('Rust');
+            packageManager = 'cargo';
+            configMtime = configMtime || this.mtime(cargoPath);
+            commands.test = commands.test || 'cargo test';
+            commands.build = commands.build || 'cargo build --release';
+            commands.lint = commands.lint || 'cargo clippy';
+            commands.format = commands.format || 'cargo fmt';
+        }
+        // ── Go ────────────────────────────────────────────────────
+        const goModPath = path.join(this.cwd, 'go.mod');
+        if (this.exists(goModPath)) {
+            languages.push('Go');
+            packageManager = 'go';
+            configMtime = configMtime || this.mtime(goModPath);
+            commands.test = commands.test || 'go test ./...';
+            commands.build = commands.build || 'go build ./...';
+            commands.lint = commands.lint || 'golangci-lint run';
+            commands.format = commands.format || 'gofmt -w .';
+        }
+        // ── .NET ─────────────────────────────────────────────────
+        const hasCsproj = this.glob('*.csproj').length > 0 || this.glob('*.sln').length > 0;
+        if (hasCsproj) {
+            languages.push('C#');
+            packageManager = 'dotnet';
+            commands.test = commands.test || 'dotnet test';
+            commands.build = commands.build || 'dotnet build';
+            commands.format = commands.format || 'dotnet format';
+        }
+        // ── Common directory detection ────────────────────────────
+        for (const candidate of ['src', 'lib', 'app']) {
+            if (this.exists(path.join(this.cwd, candidate))) {
+                directories.src = candidate;
+                break;
+            }
+        }
+        for (const candidate of ['tests', 'test', '__tests__', 'spec']) {
+            if (this.exists(path.join(this.cwd, candidate))) {
+                directories.tests = candidate;
+                break;
+            }
+        }
+        for (const candidate of ['docs', 'documentation', 'doc']) {
+            if (this.exists(path.join(this.cwd, candidate))) {
+                directories.docs = candidate;
+                break;
+            }
+        }
+        // ── Build contextPack ─────────────────────────────────────
+        const profile = {
+            detectedAt: new Date().toISOString(),
+            languages,
+            framework,
+            packageManager,
+            commands,
+            directories,
+            conventions,
+            contextPack: '',
+            _configMtime: configMtime,
+        };
+        profile.contextPack = this.buildContextPack(profile);
+        return profile;
+    }
+    buildContextPack(p) {
+        const parts = [];
+        if (p.languages.length > 0) {
+            parts.push(`Language: ${p.languages.join(', ')}`);
+        }
+        if (p.framework) {
+            parts.push(`Framework: ${p.framework}`);
+        }
+        if (p.packageManager) {
+            parts.push(`Package manager: ${p.packageManager}`);
+        }
+        const cmds = Object.entries(p.commands)
+            .map(([k, v]) => `${k}="${v}"`)
+            .join(', ');
+        if (cmds) {
+            parts.push(`Commands: ${cmds}`);
+        }
+        const dirs = Object.entries(p.directories)
+            .map(([k, v]) => `${k}=${v}`)
+            .join(', ');
+        if (dirs) {
+            parts.push(`Dirs: ${dirs}`);
+        }
+        if (p.conventions.naming) {
+            parts.push(`Naming: ${p.conventions.naming}`);
+        }
+        return parts.join(' | ');
+    }
+    loadCache() {
+        try {
+            if (!fs.existsSync(this.cachePath))
+                return null;
+            const raw = fs.readFileSync(this.cachePath, 'utf-8');
+            return JSON.parse(raw);
+        }
+        catch {
+            return null;
+        }
+    }
+    isCacheStale(cached) {
+        if (!cached._configMtime)
+            return true;
+        // Check if primary config file has changed
+        const pkgJsonPath = path.join(this.cwd, 'package.json');
+        for (const candidate of [pkgJsonPath, 'pyproject.toml', 'Cargo.toml', 'go.mod'].map((f) => (path.isAbsolute(f) ? f : path.join(this.cwd, f)))) {
+            if (fs.existsSync(candidate)) {
+                const currentMtime = this.mtime(candidate);
+                if (currentMtime !== cached._configMtime)
+                    return true;
+                break;
+            }
+        }
+        return false;
+    }
+    saveCache(profile) {
+        try {
+            const dir = path.dirname(this.cachePath);
+            if (!fs.existsSync(dir)) {
+                fs.mkdirSync(dir, { recursive: true });
+            }
+            fs.writeFileSync(this.cachePath, JSON.stringify(profile, null, 2));
+        }
+        catch (err) {
+            logger.debug('RepoProfiler: failed to save cache', { err });
+        }
+    }
+    exists(p) {
+        return fs.existsSync(p);
+    }
+    mtime(p) {
+        try {
+            return fs.statSync(p).mtimeMs;
+        }
+        catch {
+            return 0;
+        }
+    }
+    glob(pattern) {
+        try {
+            // Simple glob: look for files matching *.ext in cwd
+            const ext = pattern.replace('*', '');
+            return fs.readdirSync(this.cwd).filter((f) => f.endsWith(ext));
+        }
+        catch {
+            return [];
+        }
+    }
+}
+/** Singleton instance */
+let _instance = null;
+export function getRepoProfiler(cwd) {
+    if (!_instance || cwd) {
+        _instance = new RepoProfiler(cwd);
+    }
+    return _instance;
+}
+//# sourceMappingURL=repo-profiler.js.map

package/dist/agent/repo-profiler.js.map

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

package/dist/agent/response-constraint.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Response Prefill Modes — Manus AI tool call space restriction
+ *
+ * Instead of dynamically removing tools from the tool list (which would cause
+ * a different prompt hash → KV-cache miss → 10× higher cost), Manus restricts
+ * the action space by controlling `tool_choice` on each model call.
+ *
+ * Three modes:
+ * - 'auto'      → model chooses freely (default; maps to tool_choice: "auto")
+ * - 'required'  → model MUST make a tool call (maps to tool_choice: "required")
+ * - 'specified' → model MUST call a specific tool or tool-group prefix
+ *                 (maps to tool_choice: {type: "function", function: {name: exactName}}
+ *                  or the first tool whose name starts with namePrefix)
+ *
+ * Preserves the full tool list so KV-cache hits are maintained.
+ * Use for state-machine-like sequencing: "first call must be plan_update,
+ * then shell_exec, then file_write".
+ */
+export type ResponsePrefillMode = 'auto' | 'required' | 'specified';
+export interface ResponseConstraint {
+    /** Prefill mode controlling what the model is allowed to respond with */
+    mode: ResponsePrefillMode;
+    /**
+     * For 'specified' mode: exact tool name or prefix ending in '_'.
+     * If a prefix (e.g. "plan_"), the first matching tool is selected.
+     */
+    nameOrPrefix?: string;
+}
+export type ToolChoiceValue = 'auto' | 'required' | 'none' | {
+    type: 'function';
+    function: {
+        name: string;
+    };
+};
+/**
+ * Resolve a `ResponseConstraint` to a concrete `tool_choice` value.
+ *
+ * @param constraint  - The desired constraint
+ * @param availableToolNames - Names of tools in the current call (for prefix resolution)
+ * @returns OpenAI-compatible `tool_choice` value
+ */
+export declare function resolveToolChoice(constraint: ResponseConstraint, availableToolNames?: string[]): ToolChoiceValue;
+/**
+ * A simple per-session constraint stack. Push constraints for specific turns,
+ * pop after the turn completes. The top of the stack is the active constraint.
+ *
+ * Usage in agent-executor:
+ *   constraintStack.push({ mode: 'required' });  // force tool call
+ *   ... run LLM turn ...
+ *   constraintStack.pop();
+ */
+export declare class ResponseConstraintStack {
+    private stack;
+    push(constraint: ResponseConstraint): void;
+    pop(): ResponseConstraint | undefined;
+    /** Current active constraint (top of stack), or default 'auto' */
+    current(): ResponseConstraint;
+    clear(): void;
+    isEmpty(): boolean;
+}
+export declare function getResponseConstraintStack(): ResponseConstraintStack;

package/dist/agent/response-constraint.js

@@ -0,0 +1,91 @@
+/**
+ * Response Prefill Modes — Manus AI tool call space restriction
+ *
+ * Instead of dynamically removing tools from the tool list (which would cause
+ * a different prompt hash → KV-cache miss → 10× higher cost), Manus restricts
+ * the action space by controlling `tool_choice` on each model call.
+ *
+ * Three modes:
+ * - 'auto'      → model chooses freely (default; maps to tool_choice: "auto")
+ * - 'required'  → model MUST make a tool call (maps to tool_choice: "required")
+ * - 'specified' → model MUST call a specific tool or tool-group prefix
+ *                 (maps to tool_choice: {type: "function", function: {name: exactName}}
+ *                  or the first tool whose name starts with namePrefix)
+ *
+ * Preserves the full tool list so KV-cache hits are maintained.
+ * Use for state-machine-like sequencing: "first call must be plan_update,
+ * then shell_exec, then file_write".
+ */
+/**
+ * Resolve a `ResponseConstraint` to a concrete `tool_choice` value.
+ *
+ * @param constraint  - The desired constraint
+ * @param availableToolNames - Names of tools in the current call (for prefix resolution)
+ * @returns OpenAI-compatible `tool_choice` value
+ */
+export function resolveToolChoice(constraint, availableToolNames = []) {
+    switch (constraint.mode) {
+        case 'auto':
+            return 'auto';
+        case 'required':
+            return 'required';
+        case 'specified': {
+            const target = constraint.nameOrPrefix;
+            if (!target)
+                return 'auto';
+            // Exact match first
+            if (availableToolNames.includes(target)) {
+                return { type: 'function', function: { name: target } };
+            }
+            // Prefix match (e.g. "plan_" matches "plan_update", "plan_read")
+            if (target.endsWith('_')) {
+                const match = availableToolNames.find(n => n.startsWith(target));
+                if (match) {
+                    return { type: 'function', function: { name: match } };
+                }
+            }
+            // Fallback: 'required' so at least some tool call is forced
+            return 'required';
+        }
+        default:
+            return 'auto';
+    }
+}
+// ============================================================================
+// Session-level constraint registry
+// ============================================================================
+/**
+ * A simple per-session constraint stack. Push constraints for specific turns,
+ * pop after the turn completes. The top of the stack is the active constraint.
+ *
+ * Usage in agent-executor:
+ *   constraintStack.push({ mode: 'required' });  // force tool call
+ *   ... run LLM turn ...
+ *   constraintStack.pop();
+ */
+export class ResponseConstraintStack {
+    stack = [];
+    push(constraint) {
+        this.stack.push(constraint);
+    }
+    pop() {
+        return this.stack.pop();
+    }
+    /** Current active constraint (top of stack), or default 'auto' */
+    current() {
+        return this.stack[this.stack.length - 1] ?? { mode: 'auto' };
+    }
+    clear() {
+        this.stack = [];
+    }
+    isEmpty() {
+        return this.stack.length === 0;
+    }
+}
+let _globalConstraintStack = null;
+export function getResponseConstraintStack() {
+    if (!_globalConstraintStack)
+        _globalConstraintStack = new ResponseConstraintStack();
+    return _globalConstraintStack;
+}
+//# sourceMappingURL=response-constraint.js.map

package/dist/agent/response-constraint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-constraint.js","sourceRoot":"","sources":["../../src/agent/response-constraint.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AA4BH;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAC/B,UAA8B,EAC9B,qBAA+B,EAAE;IAEjC,QAAQ,UAAU,CAAC,IAAI,EAAE,CAAC;QACxB,KAAK,MAAM;YACT,OAAO,MAAM,CAAC;QAEhB,KAAK,UAAU;YACb,OAAO,UAAU,CAAC;QAEpB,KAAK,WAAW,CAAC,CAAC,CAAC;YACjB,MAAM,MAAM,GAAG,UAAU,CAAC,YAAY,CAAC;YACvC,IAAI,CAAC,MAAM;gBAAE,OAAO,MAAM,CAAC;YAE3B,oBAAoB;YACpB,IAAI,kBAAkB,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;gBACxC,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC;YAC1D,CAAC;YAED,iEAAiE;YACjE,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBACzB,MAAM,KAAK,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;gBACjE,IAAI,KAAK,EAAE,CAAC;oBACV,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;gBACzD,CAAC;YACH,CAAC;YAED,4DAA4D;YAC5D,OAAO,UAAU,CAAC;QACpB,CAAC;QAED;YACE,OAAO,MAAM,CAAC;IAClB,CAAC;AACH,CAAC;AAED,+EAA+E;AAC/E,oCAAoC;AACpC,+EAA+E;AAE/E;;;;;;;;GAQG;AACH,MAAM,OAAO,uBAAuB;IAC1B,KAAK,GAAyB,EAAE,CAAC;IAEzC,IAAI,CAAC,UAA8B;QACjC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC9B,CAAC;IAED,GAAG;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;IAC1B,CAAC;IAED,kEAAkE;IAClE,OAAO;QACL,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAC/D,CAAC;IAED,KAAK;QACH,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;IAClB,CAAC;IAED,OAAO;QACL,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC;IACjC,CAAC;CACF;AAED,IAAI,sBAAsB,GAAmC,IAAI,CAAC;AAElE,MAAM,UAAU,0BAA0B;IACxC,IAAI,CAAC,sBAAsB;QAAE,sBAAsB,GAAG,IAAI,uBAAuB,EAAE,CAAC;IACpF,OAAO,sBAAsB,CAAC;AAChC,CAAC"}

package/dist/agent/todo-tracker.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Todo Tracker — Manus AI-inspired attention bias
+ *
+ * Maintains a persistent `todo.md` in the working directory.
+ * On every agent turn the current task list is appended at the END of
+ * the LLM context, exploiting recency bias to keep objectives in focus
+ * across long sessions ("lost-in-the-middle" mitigation).
+ *
+ * The agent calls `todo_update` to mutate the list; a thin hook in
+ * AgentExecutor re-injects the latest block before each LLM call.
+ *
+ * Ref: "Context Engineering for AI Agents: Lessons from Building Manus"
+ * https://manus.im/blog/Context-Engineering-for-AI-Agents-Lessons-from-Building-Manus
+ */
+export type TodoStatus = 'pending' | 'in_progress' | 'done' | 'blocked';
+export type TodoPriority = 'high' | 'medium' | 'low';
+export interface TodoItem {
+    id: string;
+    text: string;
+    status: TodoStatus;
+    priority: TodoPriority;
+    subtasks: TodoItem[];
+    createdAt: number;
+    updatedAt: number;
+}
+export interface TodoUpdateInput {
+    /** Action to perform */
+    action: 'add' | 'complete' | 'update' | 'remove' | 'clear_done';
+    /** For add/update: item text */
+    text?: string;
+    /** For complete/update/remove: item id */
+    id?: string;
+    /** For update: new status */
+    status?: TodoStatus;
+    /** For add/update: priority (default 'medium') */
+    priority?: TodoPriority;
+}
+export declare function getTodoTracker(workDir?: string): TodoTracker;
+export declare class TodoTracker {
+    private workDir;
+    private todoPath;
+    private items;
+    private loaded;
+    constructor(workDir: string);
+    load(): void;
+    save(): void;
+    add(text: string, priority?: TodoPriority): TodoItem;
+    complete(id: string): boolean;
+    update(id: string, updates: {
+        text?: string;
+        status?: TodoStatus;
+        priority?: TodoPriority;
+    }): boolean;
+    remove(id: string): boolean;
+    clearDone(): number;
+    getAll(): TodoItem[];
+    getPending(): TodoItem[];
+    hasPending(): boolean;
+    /**
+     * Build the context suffix injected at the END of the LLM context each turn.
+     * Returns null when there are no pending items (avoids noisy injections).
+     */
+    buildContextSuffix(): string | null;
+    private serialise;
+    private parseMd;
+    private findById;
+}