ineedcodes 0.1.0

package/packages/core/dist/skills/loader.js

@@ -0,0 +1,163 @@
+import { promises as fs } from 'node:fs';
+import * as path from 'node:path';
+import * as os from 'node:os';
+import { parse as parseYaml } from 'yaml';
+import { pathExists } from '../util/fs.js';
+/**
+ * Portable SKILL.md-based skills with YAML frontmatter.
+ *
+ * Discovery locations (plan §16):
+ *   1. <project>/.ineedcodes/skills/<name>/SKILL.md   (project)
+ *   2. <project>/skills/<name>/SKILL.md                (project, alternate)
+ *   3. ~/.ineedcodes/skills/<name>/SKILL.md            (global user)
+ *   4. built-in skills shipped with iNeedCodes          (builtin)
+ *
+ * Resolution priority (plan §17): project > global > builtin.
+ */
+const SKILL_DIRS = [
+    { scope: 'project', relative: '.ineedcodes/skills' },
+    { scope: 'project', relative: 'skills' },
+    { scope: 'global', relative: '' }
+];
+export class SkillLoader {
+    projectRoot;
+    constructor(projectRoot) {
+        this.projectRoot = projectRoot;
+    }
+    async list() {
+        const byName = new Map();
+        for (const { scope, relative } of SKILL_DIRS) {
+            const base = scope === 'global'
+                ? path.join(os.homedir(), '.ineedcodes', 'skills')
+                : path.join(this.projectRoot, relative);
+            if (!(await pathExists(base)))
+                continue;
+            let entries;
+            try {
+                entries = await fs.readdir(base, { withFileTypes: true });
+            }
+            catch {
+                continue;
+            }
+            for (const entry of entries) {
+                if (!entry.isDirectory())
+                    continue;
+                const skill = await this.loadFrom(path.join(base, entry.name), scope);
+                if (skill)
+                    byName.set(skill.name, skill); // project wins by load order
+            }
+        }
+        // Built-in skills ship last so real dirs can override them.
+        for (const skill of await builtinSkills()) {
+            if (!byName.has(skill.name))
+                byName.set(skill.name, skill);
+        }
+        return [...byName.values()];
+    }
+    async find(name) {
+        const all = await this.list();
+        return all.find((s) => s.name.toLowerCase() === name.toLowerCase());
+    }
+    async loadFrom(dir, scope) {
+        const file = path.join(dir, 'SKILL.md');
+        let raw;
+        try {
+            raw = await fs.readFile(file, 'utf8');
+        }
+        catch {
+            return undefined;
+        }
+        return parseSkillMd(raw, scope, file);
+    }
+}
+export function parseSkillMd(raw, scope, source) {
+    const match = raw.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n?([\s\S]*)$/);
+    if (!match) {
+        const name = path.basename(source, path.extname(source));
+        return { name, description: raw.slice(0, 200), instructions: raw, scope, source };
+    }
+    let front;
+    try {
+        front = parseYaml(match[1] ?? '');
+    }
+    catch {
+        return undefined;
+    }
+    if (!front || typeof front.name !== 'string')
+        return undefined;
+    return {
+        name: front.name,
+        description: typeof front.description === 'string' ? front.description : '',
+        instructions: (match[2] ?? '').trim(),
+        allowedTools: Array.isArray(front['allowed-tools'])
+            ? front['allowed-tools'].map(String)
+            : Array.isArray(front['allowed_tools'])
+                ? front['allowed_tools'].map(String)
+                : undefined,
+        version: typeof front.version === 'string' ? front.version : undefined,
+        scope,
+        source
+    };
+}
+async function builtinSkills() {
+    const builtins = [
+        {
+            name: 'boost',
+            description: 'Run an isolated Boost cycle: create a worktree, investigate, implement, test, and independently verify before merging.',
+            version: '0.1.0',
+            instructions: BOOST_INSTRUCTIONS
+        },
+        {
+            name: 'humanizer',
+            description: 'Rewrite prose (README, docs, release notes, explanations) so it sounds natural and human while preserving technical facts.',
+            version: '0.1.0',
+            instructions: HUMANIZER_INSTRUCTIONS
+        }
+    ];
+    return builtins.map((b) => ({
+        ...b,
+        scope: 'builtin',
+        source: 'builtin'
+    }));
+}
+const BOOST_INSTRUCTIONS = `# Boost: Advanced Execution and Verification Protocol
+
+Boost runs ON TOP of the multi-agent runtime. When this skill is invoked:
+
+1. **Isolate**: If the project is a Git repo, create a worktree:
+   - git_worktree(mode="add", path=".ineedcodes/boost-<timestamp>", branch="boost/<timestamp>")
+   - All experimental work happens in that worktree. The user's active tree stays clean.
+2. **Investigation**: Read code, search, run diagnostics. Understand root causes before editing.
+3. **Implementation**: Make the changes. Prefer apply_patch over full rewrites.
+4. **Testing**: Run the project's build + tests. Collect real evidence (exit codes, output).
+5. **Verification**: Independently re-check the objective. A pass only counts with real evidence.
+6. **Reconcile**:
+   - Success: report and merge back (git checkout + copy, or git merge of the boost branch) with user approval.
+   - Failure: report what was tried, why it failed, and abort. Never merge unverified changes.
+7. **Cleanup**: git_worktree(mode="remove") the boost worktree either way.
+
+Phases to report: start → investigate → implement → test → verify → reconcile → cleanup.
+
+A failed Boost run must never silently merge broken changes.`;
+const HUMANIZER_INSTRUCTIONS = `# Humanizer: Natural Prose Rewriting
+
+Rewrite prose so it reads like a thoughtful human wrote it.
+
+## Applies to
+README files, documentation, release notes, PR descriptions, explanations,
+articles, normal prose comments, website copy, Markdown prose.
+
+## Never apply to
+Source code, JSON, YAML, config values, API payloads, identifiers,
+commands, code blocks, technical values.
+
+## Rules
+1. Preserve meaning and technical facts exactly.
+2. Remove AI-flavored padding: "In the world of...", "It's important to note...",
+   "delve", "leverage", "seamless", "robust", "cutting-edge", "elevate",
+   "unleash", "furthermore", "moreover", "In conclusion".
+3. Prefer short, direct sentences. Use contractions.
+4. Keep lists as lists; don't turn structure into paragraphs.
+5. Don't add claims that weren't there.
+6. Don't over-edit: if a sentence is already natural, leave it alone.`;
+//# sourceMappingURL=loader.js.map

package/packages/core/dist/skills/loader.js.map

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

package/packages/core/dist/tools/fs.d.ts

@@ -0,0 +1,10 @@
+import type { JsonValue, Tool, ToolContext, ToolResult } from '../types.js';
+declare function str(input: JsonValue, key: string, fallback?: string): string;
+declare function num(input: JsonValue, key: string, fallback: number): number;
+declare function bool(input: JsonValue, key: string, fallback?: boolean): boolean;
+declare function resolvePath(ctx: ToolContext, p: string): string;
+declare function fail(summary: string, error: string): ToolResult;
+/** Guard: path must be inside the workspace unless outside-workspace is approved. */
+declare function guardPath(ctx: ToolContext, target: string, writing: boolean): Promise<ToolResult | null>;
+export declare function createFilesystemTools(): Tool[];
+export { str, num, bool, resolvePath, fail, guardPath };

package/packages/core/dist/tools/fs.js

@@ -0,0 +1,409 @@
+import { promises as fs } from 'node:fs';
+import * as path from 'node:path';
+import { isInsideRoot } from '../util/fs.js';
+import { isLikelySecretFile, secretFileNotice } from '../security/secrets.js';
+function str(input, key, fallback = '') {
+    if (input && typeof input === 'object' && !Array.isArray(input)) {
+        const v = input[key];
+        if (typeof v === 'string')
+            return v;
+        if (typeof v === 'number' || typeof v === 'boolean')
+            return String(v);
+    }
+    return fallback;
+}
+function num(input, key, fallback) {
+    if (input && typeof input === 'object' && !Array.isArray(input)) {
+        const v = input[key];
+        if (typeof v === 'number' && Number.isFinite(v))
+            return v;
+    }
+    return fallback;
+}
+function bool(input, key, fallback = false) {
+    if (input && typeof input === 'object' && !Array.isArray(input)) {
+        const v = input[key];
+        if (typeof v === 'boolean')
+            return v;
+    }
+    return fallback;
+}
+function resolvePath(ctx, p) {
+    return path.resolve(ctx.cwd, p);
+}
+function fail(summary, error) {
+    return { ok: false, summary, error };
+}
+/** Guard: path must be inside the workspace unless outside-workspace is approved. */
+async function guardPath(ctx, target, writing) {
+    if (isInsideRoot(ctx.workspaceRoot, target))
+        return null;
+    const decision = await ctx.permissions.check(['outside_workspace'], `access ${target}`);
+    if (!decision.allowed)
+        return fail(decision.reason, 'outside_workspace_denied');
+    void writing;
+    return null;
+}
+export function createFilesystemTools() {
+    const read_file = {
+        name: 'read_file',
+        description: 'Read a text file. Returns the file contents with line numbers. Refuses likely secret files.',
+        permissions: ['read'],
+        readonly: true,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                path: { type: 'string', description: 'File path, relative to the working directory.' },
+                maxBytes: { type: 'number', description: 'Optional size cap in bytes.' }
+            },
+            required: ['path']
+        },
+        async execute(input, ctx) {
+            const target = resolvePath(ctx, str(input, 'path'));
+            const guard = await guardPath(ctx, target, false);
+            if (guard)
+                return guard;
+            if (isLikelySecretFile(target)) {
+                return { ok: false, summary: secretFileNotice(target), error: 'secret_file' };
+            }
+            const maxBytes = num(input, 'maxBytes', 256 * 1024);
+            try {
+                const stat = await fs.stat(target);
+                if (stat.size > maxBytes) {
+                    return { ok: false, summary: `File is ${stat.size} bytes; over the ${maxBytes}-byte read cap. Use read_file_range.`, error: 'too_large' };
+                }
+                const text = await fs.readFile(target, 'utf8');
+                const lines = text.split('\n');
+                const numbered = lines.map((l, i) => `${String(i + 1).padStart(5)}: ${l}`).join('\n');
+                return { ok: true, summary: `Read ${path.basename(target)} (${lines.length} lines).`, data: numbered };
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                return fail(`Could not read ${target}: ${message}`, 'read_failed');
+            }
+        }
+    };
+    const read_file_range = {
+        name: 'read_file_range',
+        description: 'Read a slice of a file by line numbers (1-based, inclusive).',
+        permissions: ['read'],
+        readonly: true,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                path: { type: 'string' },
+                startLine: { type: 'number' },
+                endLine: { type: 'number' }
+            },
+            required: ['path', 'startLine', 'endLine']
+        },
+        async execute(input, ctx) {
+            const target = resolvePath(ctx, str(input, 'path'));
+            const guard = await guardPath(ctx, target, false);
+            if (guard)
+                return guard;
+            if (isLikelySecretFile(target)) {
+                return { ok: false, summary: secretFileNotice(target), error: 'secret_file' };
+            }
+            try {
+                const text = await fs.readFile(target, 'utf8');
+                const lines = text.split('\n');
+                const start = Math.max(1, Math.floor(num(input, 'startLine', 1)));
+                const end = Math.min(lines.length, Math.floor(num(input, 'endLine', start + 99)));
+                const slice = lines.slice(start - 1, end);
+                const numbered = slice
+                    .map((l, i) => `${String(start + i).padStart(5)}: ${l}`)
+                    .join('\n');
+                return { ok: true, summary: `Read lines ${start}-${end} of ${path.basename(target)} (file has ${lines.length} lines).`, data: numbered };
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                return fail(`Could not read ${target}: ${message}`, 'read_failed');
+            }
+        }
+    };
+    const write_file = {
+        name: 'write_file',
+        description: 'Create or overwrite a file with the given content. Parent directories are created automatically.',
+        permissions: ['write'],
+        readonly: false,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                path: { type: 'string' },
+                content: { type: 'string' }
+            },
+            required: ['path', 'content']
+        },
+        async execute(input, ctx) {
+            const target = resolvePath(ctx, str(input, 'path'));
+            const guard = await guardPath(ctx, target, true);
+            if (guard)
+                return guard;
+            if (isLikelySecretFile(target)) {
+                const decision = await ctx.permissions.check(['secret_access'], `write ${target}`);
+                if (!decision.allowed)
+                    return fail(decision.reason, 'secret_write_denied');
+            }
+            const content = str(input, 'content');
+            try {
+                await fs.mkdir(path.dirname(target), { recursive: true });
+                await fs.writeFile(target, content, 'utf8');
+                return {
+                    ok: true,
+                    summary: `Wrote ${target} (${content.split('\n').length} lines, ${content.length} bytes).`
+                };
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                return fail(`Could not write ${target}: ${message}`, 'write_failed');
+            }
+        }
+    };
+    const apply_patch = {
+        name: 'apply_patch',
+        description: 'Replace an exact text snippet inside an existing file. The old string must match exactly and be unique. Prefer this over rewriting whole files.',
+        permissions: ['write'],
+        readonly: false,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                path: { type: 'string' },
+                oldText: { type: 'string', description: 'Exact existing text to replace.' },
+                newText: { type: 'string', description: 'Replacement text.' },
+                replaceAll: { type: 'boolean', description: 'Replace every occurrence (default: false).' }
+            },
+            required: ['path', 'oldText', 'newText']
+        },
+        async execute(input, ctx) {
+            const target = resolvePath(ctx, str(input, 'path'));
+            const guard = await guardPath(ctx, target, true);
+            if (guard)
+                return guard;
+            const oldText = str(input, 'oldText');
+            const newText = str(input, 'newText');
+            if (!oldText)
+                return fail('oldText must not be empty.', 'empty_patch');
+            try {
+                const text = await fs.readFile(target, 'utf8');
+                const count = text.split(oldText).length - 1;
+                if (count === 0)
+                    return fail('oldText not found in file.', 'patch_not_found');
+                if (count > 1 && !bool(input, 'replaceAll')) {
+                    return fail(`oldText matches ${count} times; provide more context or set replaceAll.`, 'ambiguous_patch');
+                }
+                const updated = bool(input, 'replaceAll') ? text.replaceAll(oldText, newText) : text.replace(oldText, newText);
+                await fs.writeFile(target, updated, 'utf8');
+                return {
+                    ok: true,
+                    summary: `Patched ${target}: replaced ${bool(input, 'replaceAll') ? count : 1} occurrence(s).`
+                };
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                return fail(`Could not patch ${target}: ${message}`, 'patch_failed');
+            }
+        }
+    };
+    const delete_file = {
+        name: 'delete_file',
+        description: 'Delete a file or directory. Requires approval when deleting many files.',
+        permissions: ['write', 'destructive'],
+        readonly: false,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                path: { type: 'string' },
+                recursive: { type: 'boolean' }
+            },
+            required: ['path']
+        },
+        async execute(input, ctx) {
+            const target = resolvePath(ctx, str(input, 'path'));
+            const guard = await guardPath(ctx, target, true);
+            if (guard)
+                return guard;
+            try {
+                const stat = await fs.stat(target);
+                const recursive = bool(input, 'recursive');
+                if (stat.isDirectory() && !recursive) {
+                    return fail('Target is a directory; pass recursive=true to delete it.', 'needs_recursive');
+                }
+                await fs.rm(target, { recursive });
+                return { ok: true, summary: `Deleted ${target}.` };
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                return fail(`Could not delete ${target}: ${message}`, 'delete_failed');
+            }
+        }
+    };
+    const move_file = {
+        name: 'move_file',
+        description: 'Move or rename a file or directory.',
+        permissions: ['write'],
+        readonly: false,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                from: { type: 'string' },
+                to: { type: 'string' }
+            },
+            required: ['from', 'to']
+        },
+        async execute(input, ctx) {
+            const from = resolvePath(ctx, str(input, 'from'));
+            const to = resolvePath(ctx, str(input, 'to'));
+            for (const [target, label] of [[from, 'from'], [to, 'to']]) {
+                const guard = await guardPath(ctx, target, true);
+                if (guard)
+                    return fail(guard.summary ?? 'outside workspace', `outside_workspace_${label}`);
+            }
+            try {
+                await fs.mkdir(path.dirname(to), { recursive: true });
+                await fs.rename(from, to);
+                return { ok: true, summary: `Moved ${from} → ${to}.` };
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                return fail(`Could not move: ${message}`, 'move_failed');
+            }
+        }
+    };
+    const copy_file = {
+        name: 'copy_file',
+        description: 'Copy a file. Directories are copied recursively.',
+        permissions: ['write'],
+        readonly: false,
+        inputSchema: {
+            type: 'object',
+            properties: { from: { type: 'string' }, to: { type: 'string' } },
+            required: ['from', 'to']
+        },
+        async execute(input, ctx) {
+            const from = resolvePath(ctx, str(input, 'from'));
+            const to = resolvePath(ctx, str(input, 'to'));
+            for (const target of [from, to]) {
+                const guard = await guardPath(ctx, target, true);
+                if (guard)
+                    return guard;
+            }
+            try {
+                await fs.mkdir(path.dirname(to), { recursive: true });
+                await fs.cp(from, to, { recursive: true });
+                return { ok: true, summary: `Copied ${from} → ${to}.` };
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                return fail(`Could not copy: ${message}`, 'copy_failed');
+            }
+        }
+    };
+    const list_directory = {
+        name: 'list_directory',
+        description: 'List the entries of a directory.',
+        permissions: ['read'],
+        readonly: true,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                path: { type: 'string', description: 'Defaults to the working directory.' },
+                recursive: { type: 'boolean', description: 'List recursively (max depth 4). Default false.' }
+            }
+        },
+        async execute(input, ctx) {
+            const target = resolvePath(ctx, str(input, 'path') || '.');
+            const guard = await guardPath(ctx, target, false);
+            if (guard)
+                return guard;
+            const recursive = bool(input, 'recursive');
+            const out = [];
+            const walk = async (dir, depth) => {
+                if (out.length > 500 || (recursive && depth > 4))
+                    return;
+                let entries;
+                try {
+                    entries = await fs.readdir(dir, { withFileTypes: true });
+                }
+                catch {
+                    return;
+                }
+                for (const entry of entries) {
+                    if (['node_modules', '.git', 'dist', '.next'].includes(entry.name))
+                        continue;
+                    const marker = entry.isDirectory() ? '/' : '';
+                    out.push(`${path.relative(target, path.join(dir, entry.name))}${marker}`);
+                    if (entry.isDirectory() && recursive) {
+                        await walk(path.join(dir, entry.name), depth + 1);
+                    }
+                }
+            };
+            await walk(target, 1);
+            return {
+                ok: true,
+                summary: `Listed ${out.length} entries in ${target}${recursive ? ' (recursive)' : ''}.`,
+                data: out
+            };
+        }
+    };
+    const file_exists = {
+        name: 'file_exists',
+        description: 'Check whether a file or directory exists.',
+        permissions: ['read'],
+        readonly: true,
+        inputSchema: { type: 'object', properties: { path: { type: 'string' } }, required: ['path'] },
+        async execute(input, ctx) {
+            const target = resolvePath(ctx, str(input, 'path'));
+            const guard = await guardPath(ctx, target, false);
+            if (guard)
+                return guard;
+            try {
+                const stat = await fs.stat(target);
+                return {
+                    ok: true,
+                    summary: `${target} exists (${stat.isDirectory() ? 'directory' : 'file'}).`
+                };
+            }
+            catch {
+                return { ok: true, summary: `${target} does not exist.` };
+            }
+        }
+    };
+    const file_metadata = {
+        name: 'file_metadata',
+        description: 'Get size, timestamps, and type for a file or directory.',
+        permissions: ['read'],
+        readonly: true,
+        inputSchema: { type: 'object', properties: { path: { type: 'string' } }, required: ['path'] },
+        async execute(input, ctx) {
+            const target = resolvePath(ctx, str(input, 'path'));
+            const guard = await guardPath(ctx, target, false);
+            if (guard)
+                return guard;
+            try {
+                const stat = await fs.stat(target);
+                return {
+                    ok: true,
+                    summary: `Metadata for ${target}.`,
+                    data: {
+                        size: stat.size,
+                        isDirectory: stat.isDirectory(),
+                        isFile: stat.isFile(),
+                        createdAt: stat.birthtime.toISOString(),
+                        modifiedAt: stat.mtime.toISOString()
+                    }
+                };
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                return fail(`Could not stat ${target}: ${message}`, 'stat_failed');
+            }
+        }
+    };
+    return [
+        read_file, read_file_range, write_file, apply_patch, delete_file,
+        move_file, copy_file, list_directory, file_exists, file_metadata
+    ];
+}
+export { str, num, bool, resolvePath, fail, guardPath };
+//# sourceMappingURL=fs.js.map

package/packages/core/dist/tools/fs.js.map

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

package/packages/core/dist/tools/git.d.ts

@@ -0,0 +1,7 @@
+import type { Tool } from '../types.js';
+/**
+ * First-class Git tools. These are structured wrappers: the model does not
+ * need to build raw Git command lines for common operations. Raw Git still
+ * works through shell_exec when needed.
+ */
+export declare function createGitTools(): Tool[];