codegrunt 0.1.0

package/dist/cli/skills.js

@@ -0,0 +1,299 @@
+import { readdir, readFile, writeFile, access, mkdir, rm, unlink } from 'fs/promises';
+import { join, resolve, basename } from 'path';
+import { homedir } from 'os';
+import AdmZip from 'adm-zip';
+/** Parse YAML-style frontmatter from a markdown file.
+ *  Supports both simple `key: value` pairs and multi-line literal blocks
+ *  (`key: |` followed by indented content). */
+function parseFrontmatter(raw) {
+    const meta = {};
+    if (!raw.startsWith('---'))
+        return { meta, body: raw };
+    const end = raw.indexOf('\n---', 3);
+    if (end === -1)
+        return { meta, body: raw };
+    const fm = raw.slice(3, end);
+    const lines = fm.split('\n');
+    let i = 0;
+    while (i < lines.length) {
+        const line = lines[i];
+        const colon = line.indexOf(':');
+        if (colon === -1) {
+            i++;
+            continue;
+        }
+        const key = line.slice(0, colon).trim();
+        const rest = line.slice(colon + 1).trim();
+        if (rest === '|' || rest === '|-' || rest === '>') {
+            // Multi-line literal / folded block scalar
+            i++;
+            const valueLines = [];
+            let baseIndent = null;
+            while (i < lines.length) {
+                const nl = lines[i];
+                if (nl.trim() === '') {
+                    valueLines.push('');
+                    i++;
+                    continue;
+                }
+                const indent = nl.length - nl.trimStart().length;
+                if (baseIndent === null)
+                    baseIndent = indent;
+                // Stop when we hit a non-empty line at lower indentation than the block base
+                if (indent < (baseIndent ?? 0))
+                    break;
+                valueLines.push(nl.slice(baseIndent ?? indent));
+                i++;
+            }
+            meta[key] = valueLines.join('\n').trim();
+        }
+        else {
+            // Simple key: value
+            meta[key] = rest.replace(/^["']|["']$/g, '');
+            i++;
+        }
+    }
+    return { meta, body: raw.slice(end + 4).trim() };
+}
+async function loadSkillsFromDir(dir, source) {
+    try {
+        await access(dir);
+    }
+    catch {
+        return [];
+    }
+    const skills = [];
+    let entries;
+    try {
+        entries = await readdir(dir, { withFileTypes: true });
+    }
+    catch {
+        return [];
+    }
+    for (const entry of entries) {
+        // Flat .md file directly in the skills dir
+        if (entry.isFile() && entry.name.endsWith('.md')) {
+            try {
+                const raw = await readFile(join(dir, entry.name), 'utf-8');
+                const { meta, body } = parseFrontmatter(raw);
+                const skillName = meta['name'] ?? entry.name.replace(/\.md$/, '');
+                skills.push({
+                    name: skillName,
+                    description: meta['description'],
+                    system: meta['system'],
+                    content: body,
+                    source,
+                    file: entry.name,
+                });
+            }
+            catch {
+                // skip unreadable files
+            }
+            continue;
+        }
+        // Subdirectory = a skill package (e.g. installed from zip)
+        if (entry.isDirectory() && !entry.name.startsWith('.')) {
+            const subDir = join(dir, entry.name);
+            try {
+                const subEntries = await readdir(subDir, { withFileTypes: true });
+                const mdFiles = subEntries.filter((e) => e.isFile() && e.name.endsWith('.md'));
+                if (mdFiles.length === 0)
+                    continue;
+                // Concatenate all .md contents; prefer frontmatter name, fallback to directory name
+                const parts = [];
+                let description;
+                let system;
+                let frontmatterName;
+                for (const md of mdFiles) {
+                    const raw = await readFile(join(subDir, md.name), 'utf-8');
+                    const { meta, body } = parseFrontmatter(raw);
+                    if (!description && meta['description'])
+                        description = meta['description'];
+                    if (!system && meta['system'])
+                        system = meta['system'];
+                    if (!frontmatterName && meta['name'])
+                        frontmatterName = meta['name'];
+                    parts.push(body);
+                }
+                skills.push({
+                    name: frontmatterName ?? entry.name,
+                    description,
+                    system,
+                    content: parts.join('\n\n'),
+                    source,
+                    file: entry.name + '/',
+                });
+            }
+            catch {
+                // skip unreadable directories
+            }
+        }
+    }
+    return skills;
+}
+/** Global skills directory: ~/.codegrunt/skills/ */
+export function getGlobalSkillsDir() {
+    return join(homedir(), '.codegrunt', 'skills');
+}
+/** Project skills directory: .codegrunt/skills/ */
+export function getProjectSkillsDir(cwd) {
+    return resolve(cwd, '.codegrunt', 'skills');
+}
+/** Load skills from project (.codegrunt/skills/) and global (~/.codegrunt/skills/) directories */
+export async function loadSkills(cwd) {
+    const projectDir = getProjectSkillsDir(cwd);
+    const globalDir = getGlobalSkillsDir();
+    const [projectSkills, globalSkills] = await Promise.all([
+        loadSkillsFromDir(projectDir, 'project'),
+        loadSkillsFromDir(globalDir, 'global'),
+    ]);
+    // Project skills take precedence over global ones with the same name
+    const seen = new Set();
+    const result = [];
+    for (const skill of [...projectSkills, ...globalSkills]) {
+        if (!seen.has(skill.name)) {
+            seen.add(skill.name);
+            result.push(skill);
+        }
+    }
+    return result;
+}
+/** Create a new skill file in the global skills directory */
+export async function createSkill(name, description, content, system) {
+    const dir = getGlobalSkillsDir();
+    await mkdir(dir, { recursive: true });
+    // Sanitize the skill name to a safe filename: only allow alphanumerics, hyphens,
+    // and underscores.  This prevents path traversal (e.g. "../evil") and reserved
+    // Windows filenames (e.g. "con", "prn") from causing silent failures.
+    const safeName = name.replace(/[^a-z0-9_-]/gi, '-').toLowerCase();
+    // After sanitization, reject names that are empty or consist only of hyphens
+    // (which means the original name had no valid characters at all).
+    if (!safeName || /^-+$/.test(safeName)) {
+        throw new Error(`Invalid skill name "${name}". Use letters, numbers, hyphens, or underscores.`);
+    }
+    const fileName = safeName + '.md';
+    const filePath = join(dir, fileName);
+    const frontmatterLines = [
+        '---',
+        `name: ${name}`,
+        `description: ${description}`,
+    ];
+    if (system) {
+        // Use YAML literal block scalar for multi-line system prompts
+        frontmatterLines.push('system: |');
+        for (const line of system.split('\n')) {
+            frontmatterLines.push('  ' + line);
+        }
+    }
+    frontmatterLines.push('---', '', content);
+    await writeFile(filePath, frontmatterLines.join('\n'), 'utf-8');
+    return fileName;
+}
+/** Install a skill from a .zip file into the global skills directory.
+ *  Supports Claude Code skill zip format: one directory with .md files inside. */
+export async function installSkillFromZip(zipPath) {
+    const dir = getGlobalSkillsDir();
+    await mkdir(dir, { recursive: true });
+    let zip;
+    try {
+        zip = new AdmZip(zipPath);
+    }
+    catch (err) {
+        throw new Error(`Failed to read zip file: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    const entries = zip.getEntries();
+    if (entries.length === 0) {
+        throw new Error('Zip file is empty');
+    }
+    // Collect all .md files and their paths
+    const mdEntries = entries.filter((e) => e.entryName.endsWith('.md') && !e.isDirectory);
+    if (mdEntries.length === 0) {
+        throw new Error('No .md skill files found in zip');
+    }
+    // Determine the skill name from the common root directory, or use the first .md filename
+    let skillName;
+    // If all .md files are under a single root directory, use that directory name
+    const rootDirs = new Set();
+    for (const e of mdEntries) {
+        const parts = e.entryName.split('/');
+        if (parts.length > 1) {
+            rootDirs.add(parts[0]);
+        }
+    }
+    if (rootDirs.size === 1) {
+        skillName = [...rootDirs][0];
+    }
+    else {
+        // No common root — use the zip filename (without extension)
+        skillName = basename(zipPath).replace(/\.zip$/i, '');
+    }
+    // Extract all files into ~/.codegrunt/skills/<skillName>/
+    const skillDir = join(dir, skillName);
+    await mkdir(skillDir, { recursive: true });
+    // Extract all non-directory entries
+    let fileCount = 0;
+    for (const entry of entries) {
+        if (entry.isDirectory)
+            continue;
+        // Determine the relative path within the skill directory
+        let relPath = entry.entryName;
+        // Strip the common root prefix if there is one
+        if (rootDirs.size === 1) {
+            const prefix = skillName + '/';
+            if (relPath.startsWith(prefix)) {
+                relPath = relPath.slice(prefix.length);
+            }
+        }
+        if (!relPath)
+            continue;
+        // Guard against path traversal: a malicious zip could contain entries like
+        // "../../.bashrc" which would resolve outside skillDir after join().
+        // Reject any entry whose normalized path escapes the skill directory.
+        const destPath = join(skillDir, relPath);
+        if (!destPath.startsWith(skillDir + '/') && !destPath.startsWith(skillDir + '\\')) {
+            // Skip silently — don't throw, so a single bad entry doesn't abort the whole install
+            continue;
+        }
+        // Ensure parent directory exists
+        const destDir = resolve(destPath, '..');
+        if (destDir !== skillDir) {
+            await mkdir(destDir, { recursive: true });
+        }
+        try {
+            const content = entry.getData();
+            await writeFile(destPath, content);
+            fileCount++;
+        }
+        catch {
+            // skip files that can't be written
+        }
+    }
+    return { name: skillName, fileCount };
+}
+/** Remove a skill from the global skills directory.
+ *  Tries directory (zip-installed) first, then flat .md file. */
+export async function removeSkill(name) {
+    const dir = getGlobalSkillsDir();
+    const skillDir = join(dir, name);
+    const skillFile = join(dir, name + '.md');
+    // Try removing a subdirectory first (zip-installed skill)
+    try {
+        await access(skillDir);
+        await rm(skillDir, { recursive: true });
+        return name;
+    }
+    catch {
+        // Not a directory
+    }
+    // Try removing a flat .md file
+    try {
+        await access(skillFile);
+        await unlink(skillFile);
+        return name;
+    }
+    catch {
+        // Not a file either
+    }
+    throw new Error(`Skill "${name}" not found in ${dir}`);
+}
+//# sourceMappingURL=skills.js.map

package/dist/cli/skills.js.map

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

package/dist/cli/update.d.ts

@@ -0,0 +1,7 @@
+export interface UpdateOptions {
+    /** Skip confirmation prompt */
+    confirm: boolean;
+    /** Only check for updates, do not install */
+    checkOnly: boolean;
+}
+export declare function runUpdate(opts: UpdateOptions): Promise<void>;

package/dist/cli/update.js

@@ -0,0 +1,135 @@
+import { spawn } from 'child_process';
+import { readFileSync } from 'fs';
+import { dirname, resolve } from 'path';
+import { fileURLToPath } from 'url';
+import chalk from 'chalk';
+import ora from 'ora';
+import { printError } from '../utils/display.js';
+// ── Version utilities ────────────────────────────────────────────────────────
+/**
+ * Parse a semver string into [major, minor, patch].
+ * Returns [0,0,0] for non-standard formats.
+ */
+function parseSemver(v) {
+    const parts = v.split('.');
+    return [
+        parseInt(parts[0], 10) || 0,
+        parseInt(parts[1], 10) || 0,
+        parseInt(parts[2], 10) || 0,
+    ];
+}
+/** Returns true if version `a` is strictly newer than `b` */
+function isNewer(a, b) {
+    const [a1, a2, a3] = parseSemver(a);
+    const [b1, b2, b3] = parseSemver(b);
+    if (a1 !== b1)
+        return a1 > b1;
+    if (a2 !== b2)
+        return a2 > b2;
+    return a3 > b3;
+}
+// ── Current version ──────────────────────────────────────────────────────────
+function getCurrentVersion() {
+    try {
+        // dist/cli/update.js → go up 2 levels to project root → package.json
+        const pkgPath = resolve(dirname(fileURLToPath(import.meta.url)), '..', '..', 'package.json');
+        const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
+        return pkg.version || '0.0.0';
+    }
+    catch {
+        return '0.0.0';
+    }
+}
+// ── Fetch latest ─────────────────────────────────────────────────────────────
+const NPM_REGISTRY = 'https://registry.npmjs.org/codegrunt/latest';
+async function fetchLatestVersion() {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), 5000);
+    try {
+        const response = await fetch(NPM_REGISTRY, {
+            signal: controller.signal,
+            headers: { 'Accept': 'application/json' },
+        });
+        if (!response.ok)
+            return null;
+        const data = (await response.json());
+        return data.version || null;
+    }
+    catch {
+        return null;
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+}
+// ── Install ──────────────────────────────────────────────────────────────────
+function runNpmInstall(version) {
+    return new Promise((resolve_p) => {
+        const child = spawn('npm', ['install', '-g', `codegrunt@${version}`], {
+            stdio: 'inherit',
+            // shell:true on Windows so .cmd wrappers work
+            shell: process.platform === 'win32',
+        });
+        child.on('close', (code) => {
+            resolve_p(code === 0);
+        });
+        child.on('error', () => {
+            resolve_p(false);
+        });
+    });
+}
+// ── Main entry ───────────────────────────────────────────────────────────────
+export async function runUpdate(opts) {
+    const currentVersion = getCurrentVersion();
+    const spinner = ora('Checking for updates...').start();
+    const latestVersion = await fetchLatestVersion();
+    if (!latestVersion) {
+        spinner.fail('Unable to reach npm registry');
+        console.log(chalk.gray('  Check your network connection and try again.'));
+        process.exit(1);
+    }
+    spinner.stop();
+    // ── Already up to date ──
+    if (!isNewer(latestVersion, currentVersion)) {
+        console.log(chalk.green('✓ codegrunt is up to date') +
+            chalk.gray(`  (v${currentVersion})`));
+        return;
+    }
+    // ── Update available ──
+    console.log();
+    console.log(chalk.gray('  codegrunt  ') +
+        chalk.yellow(`v${currentVersion}`) +
+        chalk.gray('  →  ') +
+        chalk.green(`v${latestVersion}`));
+    console.log();
+    if (opts.checkOnly) {
+        console.log(chalk.gray(`  Run ${chalk.cyan('codegrunt update')} to upgrade.`));
+        return;
+    }
+    // ── Confirm ──
+    if (!opts.confirm) {
+        const readline = await import('readline');
+        const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+        const answer = await new Promise((resolve) => {
+            rl.question(chalk.bold('Upgrade now? [y/N] '), resolve);
+        });
+        rl.close();
+        if (!answer.toLowerCase().startsWith('y')) {
+            console.log(chalk.gray('Update cancelled.'));
+            return;
+        }
+    }
+    // ── Install ──
+    console.log(chalk.gray(`\nRunning ${chalk.cyan(`npm install -g codegrunt@${latestVersion}`)}...\n`));
+    const success = await runNpmInstall(latestVersion);
+    if (success) {
+        console.log();
+        console.log(chalk.green(`✓ Upgraded to codegrunt@${latestVersion}`));
+    }
+    else {
+        console.log();
+        printError(`Upgrade failed. Try manually: ${chalk.cyan('npm install -g codegrunt@latest')}`);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=update.js.map

package/dist/cli/update.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,19 @@
+import type { CodeGruntConfig } from './types.js';
+export declare function loadConfig(): Promise<CodeGruntConfig>;
+export declare function saveConfig(config: CodeGruntConfig): Promise<void>;
+/**
+ * Detect whether the current model is a DeepSeek "pure" reasoner (R1) model.
+ * R1 models do NOT support `temperature`, reject the `system` role, and
+ * require the system prompt to be embedded in the first user message.
+ */
+export declare function isReasonerModel(model: string): boolean;
+/**
+ * Detect whether the model supports reasoning/thinking capabilities
+ * (emits reasoning_content, supports reasoning_effort parameter).
+ * This includes R1 reasoner models AND V4 Pro models.
+ */
+export declare function supportsReasoning(model: string): boolean;
+/** Reasoner models have a huge context (1M tokens) — give them more room */
+export declare const CONTEXT_BUDGET = 100000;
+/** Chat model context window is 128K — budget for conversation history */
+export declare const CHAT_CONTEXT_BUDGET = 90000;

package/dist/config.js

@@ -0,0 +1,93 @@
+import { readFile, writeFile, mkdir } from 'fs/promises';
+import { homedir } from 'os';
+import { join } from 'path';
+const CONFIG_DIR = join(homedir(), '.codegrunt');
+const CONFIG_PATH = join(CONFIG_DIR, 'config.json');
+const DEFAULTS = {
+    provider: 'deepseek',
+    model: 'deepseek-v4-pro',
+    maxTokens: 8192,
+    temperature: 0.2,
+    apiKey: '',
+    baseURL: 'https://api.deepseek.com',
+    reasoningEffort: 'medium',
+};
+async function loadConfigFile() {
+    try {
+        const raw = await readFile(CONFIG_PATH, 'utf-8');
+        return JSON.parse(raw);
+    }
+    catch {
+        return {};
+    }
+}
+/** Parse an integer env var, returning the fallback if the value is missing or NaN. */
+function envInt(name, fallback) {
+    const raw = process.env[name];
+    if (!raw)
+        return fallback;
+    const n = parseInt(raw, 10);
+    return isNaN(n) ? fallback : n;
+}
+function envFloat(name, fallback) {
+    const raw = process.env[name];
+    if (!raw)
+        return fallback;
+    const n = parseFloat(raw);
+    return isNaN(n) ? fallback : n;
+}
+export async function loadConfig() {
+    const fileConfig = await loadConfigFile();
+    return {
+        provider: process.env.CODEGRUNT_PROVIDER ?? fileConfig.provider ?? DEFAULTS.provider,
+        model: process.env.CODEGRUNT_MODEL ?? fileConfig.model ?? DEFAULTS.model,
+        maxTokens: envInt('CODEGRUNT_MAX_TOKENS', fileConfig.maxTokens ?? DEFAULTS.maxTokens),
+        temperature: envFloat('CODEGRUNT_TEMPERATURE', fileConfig.temperature ?? DEFAULTS.temperature),
+        apiKey: process.env.DEEPSEEK_API_KEY ?? fileConfig.apiKey ?? '',
+        baseURL: process.env.CODEGRUNT_BASE_URL ?? fileConfig.baseURL ?? DEFAULTS.baseURL,
+        reasoningEffort: process.env.CODEGRUNT_REASONING_EFFORT
+            ?? fileConfig.reasoningEffort
+            ?? DEFAULTS.reasoningEffort,
+        topP: envFloat('CODEGRUNT_TOP_P', fileConfig.topP ?? DEFAULTS.topP),
+        frequencyPenalty: envFloat('CODEGRUNT_FREQUENCY_PENALTY', fileConfig.frequencyPenalty ?? DEFAULTS.frequencyPenalty),
+        presencePenalty: envFloat('CODEGRUNT_PRESENCE_PENALTY', fileConfig.presencePenalty ?? DEFAULTS.presencePenalty),
+    };
+}
+export async function saveConfig(config) {
+    await mkdir(CONFIG_DIR, { recursive: true });
+    await writeFile(CONFIG_PATH, JSON.stringify({
+        apiKey: config.apiKey,
+        model: config.model,
+        maxTokens: config.maxTokens,
+        temperature: config.temperature,
+        reasoningEffort: config.reasoningEffort,
+        topP: config.topP,
+        frequencyPenalty: config.frequencyPenalty,
+        presencePenalty: config.presencePenalty,
+    }, null, 2), 'utf-8');
+}
+/**
+ * Detect whether the current model is a DeepSeek "pure" reasoner (R1) model.
+ * R1 models do NOT support `temperature`, reject the `system` role, and
+ * require the system prompt to be embedded in the first user message.
+ */
+export function isReasonerModel(model) {
+    const lower = model.toLowerCase();
+    return lower.includes('reasoner') || lower.includes('r1');
+}
+/**
+ * Detect whether the model supports reasoning/thinking capabilities
+ * (emits reasoning_content, supports reasoning_effort parameter).
+ * This includes R1 reasoner models AND V4 Pro models.
+ */
+export function supportsReasoning(model) {
+    const lower = model.toLowerCase();
+    return isReasonerModel(model)
+        || lower.includes('v4')
+        || lower.includes('pro');
+}
+/** Reasoner models have a huge context (1M tokens) — give them more room */
+export const CONTEXT_BUDGET = 100_000;
+/** Chat model context window is 128K — budget for conversation history */
+export const CHAT_CONTEXT_BUDGET = 90_000;
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/core/agent/loop.d.ts

@@ -0,0 +1,17 @@
+import type { AgentRunOptions } from '../../types.js';
+declare const sessionUsage: {
+    inputTokens: number;
+    outputTokens: number;
+    cacheHitTokens: number;
+    cacheMissTokens: number;
+};
+export declare function addUsage(u: {
+    inputTokens: number;
+    outputTokens: number;
+    cacheHitTokens: number;
+    cacheMissTokens: number;
+}): void;
+export declare function getSessionUsage(): typeof sessionUsage;
+export declare function resetSessionUsage(): void;
+export declare function runAgentLoop(options: AgentRunOptions): Promise<void>;
+export {};