@hoangsonw/forge 0.1.0

package/dist/cli/repl-commands.js

@@ -0,0 +1,508 @@
+"use strict";
+/**
+ * Slash-command catalog for the Forge REPL.
+ *
+ * Every entry declares:
+ *   - name:      canonical name without the leading slash ("status")
+ *   - aliases:   alternative names ("s")
+ *   - description: shown in the live dropdown and /help card
+ *   - category:  groups entries in /help
+ *   - kind:      how the REPL executes it — a commander passthrough, an
+ *                internal editor action, or a semantic shortcut that rewrites
+ *                the user prompt before handing off to the orchestrator.
+ *   - template:  for kind="semantic", a function (args) => { prompt, mode? }
+ *                that produces the orchestrator input.
+ *
+ * Fuzzy ranking is intentionally small and hand-tuned: exact name → prefix →
+ * substring → subsequence, with boosts for matching at the start of the
+ * command and within word boundaries.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.rankSlash = exports.findSlash = exports.SLASH_COMMANDS = void 0;
+const tpl = (prompt, opts = {}) => (args) => ({ prompt: prompt(args), ...opts });
+// ---------- Catalog ----------
+exports.SLASH_COMMANDS = [
+    // Agentic
+    {
+        name: 'run',
+        description: 'run a task (same as typing the prompt bare)',
+        category: 'Agentic',
+        kind: 'passthrough',
+        passthroughTo: 'run',
+        aliases: ['r'],
+    },
+    {
+        name: 'plan',
+        description: 'produce a plan without executing',
+        category: 'Agentic',
+        kind: 'passthrough',
+        passthroughTo: 'plan',
+        aliases: ['p'],
+    },
+    {
+        name: 'execute',
+        description: 'execute an approved plan (auto-approve)',
+        category: 'Agentic',
+        kind: 'passthrough',
+        passthroughTo: 'execute',
+    },
+    {
+        name: 'resume',
+        description: 'resume any prior task (interactive picker)',
+        category: 'Agentic',
+        kind: 'passthrough',
+        passthroughTo: 'resume',
+    },
+    {
+        name: 'spec',
+        description: 'specification workflow',
+        category: 'Agentic',
+        kind: 'passthrough',
+        passthroughTo: 'spec',
+    },
+    {
+        name: 'task',
+        description: 'task registry: list / show / cancel',
+        category: 'Agentic',
+        kind: 'passthrough',
+        passthroughTo: 'task',
+    },
+    {
+        name: 'status',
+        aliases: ['s', 'stat'],
+        description: 'compact runtime + project status',
+        category: 'Agentic',
+        kind: 'passthrough',
+        passthroughTo: 'status',
+    },
+    {
+        name: 'doctor',
+        aliases: ['d', 'health'],
+        description: 'environment + connectivity health check',
+        category: 'Agentic',
+        kind: 'passthrough',
+        passthroughTo: 'doctor',
+    },
+    // Shortcuts (semantic prompt templates)
+    {
+        name: 'ask',
+        aliases: ['a'],
+        description: 'ask a question about this codebase',
+        category: 'Shortcut',
+        kind: 'semantic',
+        template: tpl((a) => `Answer the following question about this codebase with references to specific files and line numbers. Do not change any code.\n\nQuestion: ${a}`, { mode: 'fast' }),
+        hint: '/ask how does the scheduler work?',
+    },
+    {
+        name: 'explain',
+        description: 'explain a file, function, or concept',
+        category: 'Shortcut',
+        kind: 'semantic',
+        template: tpl((a) => `Explain ${a} in detail. Reference specific lines. Highlight invariants, edge cases, and non-obvious behaviour. Read-only — do not modify code.`, { mode: 'fast' }),
+        hint: '/explain src/core/loop.ts',
+    },
+    {
+        name: 'fix',
+        description: 'diagnose and fix a bug',
+        category: 'Shortcut',
+        kind: 'semantic',
+        template: tpl((a) => `Diagnose and fix: ${a}\n\nReproduce first, then propose a minimal fix with tests that cover the regression.`, { mode: 'debug' }),
+        hint: '/fix login flow 500s on empty email',
+    },
+    {
+        name: 'test',
+        description: 'add or fix tests',
+        category: 'Shortcut',
+        kind: 'semantic',
+        template: tpl((a) => `Add or improve tests for: ${a}\n\nCover success path, edge cases, and error paths. Match existing testing conventions.`, { mode: 'balanced' }),
+    },
+    {
+        name: 'review',
+        description: 'review code quality / architecture',
+        category: 'Shortcut',
+        kind: 'semantic',
+        template: tpl((a) => `Review ${a} across correctness, readability, architecture, security, and performance. Report findings without rewriting.`, { mode: 'audit' }),
+    },
+    {
+        name: 'refactor',
+        description: 'refactor without changing behaviour',
+        category: 'Shortcut',
+        kind: 'semantic',
+        template: tpl((a) => `Refactor ${a} without changing observable behaviour. Keep tests green. Prefer minimal diffs and clearer names over clever abstractions.`, { mode: 'architect' }),
+    },
+    {
+        name: 'docs',
+        description: 'write / update documentation',
+        category: 'Shortcut',
+        kind: 'semantic',
+        template: tpl((a) => `Write or update documentation for ${a}. Match the existing style. Reference concrete examples from the code.`, { mode: 'balanced' }),
+    },
+    {
+        name: 'audit',
+        description: 'security audit of code or config',
+        category: 'Shortcut',
+        kind: 'semantic',
+        template: tpl((a) => `Security audit: ${a}\n\nReport findings by severity (critical/high/medium/low) with remediation. Focus on OWASP top 10, input validation, auth, secrets, supply chain.`, { mode: 'audit' }),
+    },
+    {
+        name: 'commit',
+        description: 'compose a git commit for pending changes',
+        category: 'Shortcut',
+        kind: 'semantic',
+        template: tpl((a) => `Review git status and pending changes. Compose an atomic commit (or multiple if needed) with clear messages. ${a ? 'Scope hint: ' + a : ''}`.trim(), { mode: 'balanced' }),
+    },
+    {
+        name: 'optimize',
+        description: 'optimize a hot path',
+        category: 'Shortcut',
+        kind: 'semantic',
+        template: tpl((a) => `Measure and optimize: ${a}\n\nProfile first. Only change what measurement says matters. Report before/after numbers.`, { mode: 'heavy' }),
+    },
+    // Session
+    {
+        name: 'help',
+        aliases: ['h', '?'],
+        description: 'show REPL command reference',
+        category: 'Session',
+        kind: 'internal',
+    },
+    {
+        name: 'exit',
+        aliases: ['quit', 'q'],
+        description: 'leave the REPL',
+        category: 'Session',
+        kind: 'internal',
+    },
+    {
+        name: 'clear',
+        aliases: ['cls'],
+        description: 'clear the screen',
+        category: 'Session',
+        kind: 'internal',
+    },
+    {
+        name: 'new',
+        aliases: ['reset'],
+        description: 'start a fresh conversation (clears turn history)',
+        category: 'Session',
+        kind: 'internal',
+    },
+    {
+        name: 'turns',
+        aliases: ['history'],
+        description: 'show turns in this session',
+        category: 'Session',
+        kind: 'internal',
+    },
+    {
+        name: 'session',
+        description: 'task session replay / list / fork',
+        category: 'Session',
+        kind: 'passthrough',
+        passthroughTo: 'session',
+    },
+    {
+        name: 'sessions',
+        aliases: ['ls'],
+        description: 'list prior conversations (REPL + web chat)',
+        category: 'Session',
+        kind: 'internal',
+    },
+    {
+        name: 'load',
+        aliases: ['switch', 'open'],
+        description: 'load a prior conversation by id',
+        category: 'Session',
+        kind: 'internal',
+    },
+    {
+        name: 'continue',
+        aliases: ['cont'],
+        description: 'continue the most recently updated conversation',
+        category: 'Session',
+        kind: 'internal',
+    },
+    {
+        name: 'rename',
+        description: 'rename the current conversation',
+        category: 'Session',
+        kind: 'internal',
+    },
+    {
+        name: 'delete',
+        aliases: ['rm'],
+        description: 'delete a conversation by id (default: current)',
+        category: 'Session',
+        kind: 'internal',
+    },
+    {
+        name: 'export',
+        description: 'export the current conversation to a JSON file',
+        category: 'Session',
+        kind: 'internal',
+    },
+    {
+        name: 'pwd',
+        aliases: ['cwd'],
+        description: 'show current working directory',
+        category: 'Session',
+        kind: 'internal',
+    },
+    {
+        name: 'cd',
+        description: 'change the working directory',
+        category: 'Session',
+        kind: 'internal',
+    },
+    { name: 'retry', description: 'retry the last turn', category: 'Session', kind: 'internal' },
+    {
+        name: 'undo',
+        description: 'undo the last turn (git stash)',
+        category: 'Session',
+        kind: 'internal',
+    },
+    // Modes / permissions
+    {
+        name: 'mode',
+        aliases: ['m'],
+        description: 'set mode: fast|balanced|heavy|plan|audit|debug|architect|offline-safe',
+        category: 'Modes',
+        kind: 'internal',
+    },
+    {
+        name: 'yes',
+        description: 'auto-approve plans for future turns (toggle)',
+        category: 'Modes',
+        kind: 'internal',
+    },
+    {
+        name: 'strict',
+        description: 'confirm every action (toggle)',
+        category: 'Modes',
+        kind: 'internal',
+    },
+    {
+        name: 'allow',
+        description: 'grant files|shell|network|web|mcp|all',
+        category: 'Modes',
+        kind: 'internal',
+    },
+    { name: 'deny', description: 'revoke a flag', category: 'Modes', kind: 'internal' },
+    {
+        name: 'permissions',
+        description: 'view / edit permission policy',
+        category: 'Modes',
+        kind: 'passthrough',
+        passthroughTo: 'permissions',
+    },
+    // Knowledge / tools
+    {
+        name: 'memory',
+        description: 'hot/warm/cold memory operations',
+        category: 'Knowledge',
+        kind: 'passthrough',
+        passthroughTo: 'memory',
+    },
+    {
+        name: 'skills',
+        description: 'skills marketplace',
+        category: 'Knowledge',
+        kind: 'passthrough',
+        passthroughTo: 'skills',
+    },
+    {
+        name: 'agents',
+        description: 'agent registry',
+        category: 'Knowledge',
+        kind: 'passthrough',
+        passthroughTo: 'agents',
+    },
+    {
+        name: 'mcp',
+        description: 'MCP server management',
+        category: 'Knowledge',
+        kind: 'passthrough',
+        passthroughTo: 'mcp',
+    },
+    {
+        name: 'web',
+        description: 'web fetch / search / browse',
+        category: 'Knowledge',
+        kind: 'passthrough',
+        passthroughTo: 'web',
+    },
+    // Models / config
+    {
+        name: 'model',
+        aliases: ['models'],
+        description: 'switch planner / executor models',
+        category: 'Models',
+        kind: 'passthrough',
+        passthroughTo: 'model',
+    },
+    {
+        name: 'config',
+        description: 'read / edit config',
+        category: 'Models',
+        kind: 'passthrough',
+        passthroughTo: 'config',
+    },
+    {
+        name: 'cost',
+        description: 'session cost summary',
+        category: 'Models',
+        kind: 'passthrough',
+        passthroughTo: 'cost',
+    },
+    // Infra
+    {
+        name: 'init',
+        description: 'initialise forge in this project',
+        category: 'Infrastructure',
+        kind: 'passthrough',
+        passthroughTo: 'init',
+    },
+    {
+        name: 'ui',
+        description: 'launch / control the web dashboard',
+        category: 'Infrastructure',
+        kind: 'passthrough',
+        passthroughTo: 'ui',
+    },
+    {
+        name: 'daemon',
+        description: 'background daemon control',
+        category: 'Infrastructure',
+        kind: 'passthrough',
+        passthroughTo: 'daemon',
+    },
+    {
+        name: 'bundle',
+        description: 'release bundling',
+        category: 'Infrastructure',
+        kind: 'passthrough',
+        passthroughTo: 'bundle',
+    },
+    {
+        name: 'container',
+        description: 'run inside a container',
+        category: 'Infrastructure',
+        kind: 'passthrough',
+        passthroughTo: 'container',
+    },
+    {
+        name: 'migrate',
+        description: 'migrate data schemas',
+        category: 'Infrastructure',
+        kind: 'passthrough',
+        passthroughTo: 'migrate',
+    },
+    {
+        name: 'update',
+        description: 'check / apply updates',
+        category: 'Infrastructure',
+        kind: 'passthrough',
+        passthroughTo: 'update',
+    },
+    {
+        name: 'changelog',
+        description: 'show recent changes',
+        category: 'Infrastructure',
+        kind: 'passthrough',
+        passthroughTo: 'changelog',
+    },
+    {
+        name: 'dev',
+        description: 'dev loop helpers',
+        category: 'Infrastructure',
+        kind: 'passthrough',
+        passthroughTo: 'dev',
+    },
+];
+// ---------- Lookups ----------
+const CMD_BY_NAME = (() => {
+    const m = new Map();
+    for (const c of exports.SLASH_COMMANDS) {
+        m.set(c.name, c);
+        for (const a of c.aliases ?? [])
+            m.set(a, c);
+    }
+    return m;
+})();
+const findSlash = (input) => CMD_BY_NAME.get(input.toLowerCase());
+exports.findSlash = findSlash;
+// ---------- Fuzzy ranking ----------
+/**
+ * Score how well `query` matches `candidate`. Higher = better. Negative = no match.
+ */
+const scoreOne = (query, candidate) => {
+    if (!query)
+        return 0;
+    const q = query.toLowerCase();
+    const c = candidate.toLowerCase();
+    if (q === c)
+        return 1000;
+    if (c.startsWith(q))
+        return 700 - (c.length - q.length);
+    const idx = c.indexOf(q);
+    if (idx >= 0)
+        return 400 - idx * 2 - (c.length - q.length);
+    // Subsequence match: q chars appear in order inside c
+    let ci = 0;
+    for (const ch of q) {
+        const found = c.indexOf(ch, ci);
+        if (found < 0)
+            return -1;
+        ci = found + 1;
+    }
+    return 120 - (c.length - q.length);
+};
+const rankSlash = (input, limit = 8) => {
+    if (!input.startsWith('/'))
+        return [];
+    const rest = input.slice(1);
+    const head = rest.split(/\s+/, 1)[0] ?? '';
+    // empty head → show a curated starter list (the most useful commands)
+    if (!head) {
+        const starter = ['ask', 'plan', 'run', 'fix', 'review', 'status', 'help', 'exit']
+            .map((n) => CMD_BY_NAME.get(n))
+            .filter((c) => Boolean(c));
+        return starter.map((c) => ({
+            label: '/' + c.name,
+            value: '/' + c.name,
+            description: c.description,
+            score: 500,
+            cmd: c,
+        }));
+    }
+    const seen = new Set();
+    const scored = [];
+    for (const c of exports.SLASH_COMMANDS) {
+        if (seen.has(c))
+            continue;
+        const names = [c.name, ...(c.aliases ?? [])];
+        let best = -1;
+        let bestName = c.name;
+        for (const n of names) {
+            const s = scoreOne(head, n);
+            if (s > best) {
+                best = s;
+                bestName = n;
+            }
+        }
+        if (best >= 0) {
+            seen.add(c);
+            scored.push({
+                label: '/' + bestName,
+                value: '/' + c.name,
+                description: c.description,
+                score: best,
+                cmd: c,
+            });
+        }
+    }
+    scored.sort((a, b) => b.score - a.score);
+    return scored.slice(0, limit);
+};
+exports.rankSlash = rankSlash;
+//# sourceMappingURL=repl-commands.js.map

package/dist/cli/repl-commands.js.map

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

package/dist/cli/repl-input.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Raw-mode line editor for the Forge REPL.
+ *
+ * Why a custom editor instead of readline? readline is one-line-at-a-time
+ * and gives no hooks for rendering below the input (live suggestions, ghost
+ * text, status line). We use Node's keypress parser (readline.emitKeypressEvents)
+ * plus raw-mode stdin to own the render loop end-to-end.
+ *
+ * Rendering model: we keep track of how many rows we drew below the input
+ * line on the last frame (`belowRows`). On each keystroke we:
+ *   1. Move cursor to column 0 of the input line.
+ *   2. Clear from here to end of screen (wipes old dropdown + status).
+ *   3. Write prompt + input + inline ghost-text suggestion.
+ *   4. Write the dropdown (if any), then the status line.
+ *   5. Move cursor back up to the input row and into position.
+ *
+ * The layout:
+ *
+ *   [1] forge ❯ /stat|        us          ← cursor; "us" is dim ghost text
+ *               ╭──────────────────────────────────────╮
+ *               │ ▸ /status      show runtime status   │
+ *               │   /spec        specification flow    │
+ *               ╰──────────────────────────────────────╯
+ *     ⚡ balanced · ollama:qwen2.5 · ~/proj · ctx 820/32k · turn 3 · $0.002
+ *
+ * The editor itself only deals with input + presentation. The REPL passes
+ * in callbacks for prompt/status/suggestions/history/onSubmit/etc.
+ */
+export interface Suggestion {
+    label: string;
+    value: string;
+    description?: string;
+    score?: number;
+}
+export interface LineEditorHooks {
+    prompt(): string;
+    statusLine(): string;
+    suggestions(input: string): Suggestion[];
+    history: string[];
+    onSubmit(line: string, picked?: Suggestion): Promise<void> | void;
+    onExit(): void;
+    onCancel(): void;
+    isRunning?: () => boolean;
+}
+export declare class LineEditor {
+    private buf;
+    private cursor;
+    private historyIdx;
+    private historyStash;
+    private sel;
+    private lastSuggestions;
+    private done;
+    private blocked;
+    private resolveDone?;
+    private readonly hooks;
+    private killRing;
+    private searchMode;
+    private searchQuery;
+    private searchCursor;
+    private searchStash;
+    private searchStashCursor;
+    private lastEsc;
+    constructor(hooks: LineEditorHooks);
+    run(): Promise<void>;
+    /** Pause input without teardown (used during task execution). */
+    suspend(): void;
+    /** Resume after task completion. */
+    resume(): void;
+    close(): void;
+    private readonly onKey;
+    private deleteAtCursor;
+    private historyPrev;
+    private historyNext;
+    private submit;
+    /** Fire a command without going through user editing — used by F-keys. */
+    private submitLiteral;
+    private enterSearchMode;
+    private exitSearchMode;
+    private findMatch;
+    private handleSearchKey;
+    private renderSearch;
+    private ghostSuffix;
+    private render;
+    private renderDropdown;
+    private eraseBelowAndPromptRow;
+}
+//# sourceMappingURL=repl-input.d.ts.map

package/dist/cli/repl-input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repl-input.d.ts","sourceRoot":"","sources":["../../src/cli/repl-input.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAOH,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,IAAI,MAAM,CAAC;IACjB,UAAU,IAAI,MAAM,CAAC;IACrB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,EAAE,CAAC;IACzC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAClE,MAAM,IAAI,IAAI,CAAC;IACf,QAAQ,IAAI,IAAI,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC;CAC3B;AAuBD,qBAAa,UAAU;IACrB,OAAO,CAAC,GAAG,CAAM;IACjB,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,UAAU,CAAM;IACxB,OAAO,CAAC,YAAY,CAAM;IAC1B,OAAO,CAAC,GAAG,CAAK;IAChB,OAAO,CAAC,eAAe,CAAoB;IAC3C,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,WAAW,CAAC,CAAa;IACjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAkB;IAIxC,OAAO,CAAC,QAAQ,CAAM;IAMtB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,WAAW,CAAM;IACzB,OAAO,CAAC,YAAY,CAAM;IAC1B,OAAO,CAAC,WAAW,CAAM;IACzB,OAAO,CAAC,iBAAiB,CAAK;IAG9B,OAAO,CAAC,OAAO,CAAK;gBAER,KAAK,EAAE,eAAe;IAI5B,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAW1B,iEAAiE;IACjE,OAAO,IAAI,IAAI;IAOf,oCAAoC;IACpC,MAAM,IAAI,IAAI;IAOd,KAAK,IAAI,IAAI;IAab,OAAO,CAAC,QAAQ,CAAC,KAAK,CAqTpB;IAEF,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,WAAW;IAUnB,OAAO,CAAC,WAAW;YAeL,MAAM;IA2CpB,0EAA0E;YAC5D,aAAa;IAU3B,OAAO,CAAC,eAAe;IAWvB,OAAO,CAAC,cAAc;IAiBtB,OAAO,CAAC,SAAS;IAWjB,OAAO,CAAC,eAAe;IAwEvB,OAAO,CAAC,YAAY;IA0BpB,OAAO,CAAC,WAAW;IASnB,OAAO,CAAC,MAAM;IA8Cd,OAAO,CAAC,cAAc;IAoDtB,OAAO,CAAC,sBAAsB;CAK/B"}