@hoangsonw/forge 0.1.0

package/dist/cli/help.js

@@ -0,0 +1,216 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.applyBrandedHelp = void 0;
+/**
+ * Branded help + error formatter for commander.
+ *
+ * Default commander help is a plain ASCII table. We replace it with a small
+ * header, categorised command groups, and colored options so that `forge
+ * --help` and `forge <cmd> --help` feel consistent with the rest of the CLI.
+ *
+ * Usage (in src/cli/index.ts):
+ *
+ *   import { applyBrandedHelp } from './help';
+ *   applyBrandedHelp(program, pkg.version ?? '0.1.0');
+ *
+ * The formatter:
+ *   • delegates option/argument line generation to commander's Help helper
+ *   • groups commands by category using COMMAND_CATEGORIES below
+ *   • highlights primary commands and shortcuts
+ *   • writes errors with a red prefix, and routes help to stdout not stderr.
+ */
+const commander_1 = require("commander");
+const chalk_1 = __importDefault(require("chalk"));
+const banners_1 = require("./banners");
+const COMMAND_CATEGORIES = {
+    init: 'Project',
+    run: 'Agentic',
+    plan: 'Agentic',
+    execute: 'Agentic',
+    resume: 'Agentic',
+    spec: 'Agentic',
+    task: 'Agentic',
+    repl: 'Agentic',
+    status: 'Runtime',
+    doctor: 'Runtime',
+    daemon: 'Runtime',
+    ui: 'Runtime',
+    cost: 'Runtime',
+    session: 'Runtime',
+    model: 'Models',
+    models: 'Models',
+    mcp: 'Integrations',
+    skills: 'Integrations',
+    agents: 'Integrations',
+    web: 'Integrations',
+    memory: 'Knowledge',
+    config: 'Config',
+    permissions: 'Config',
+    bundle: 'Operations',
+    container: 'Operations',
+    migrate: 'Operations',
+    update: 'Operations',
+    changelog: 'Operations',
+    dev: 'Operations',
+    help: 'Help',
+};
+const CATEGORY_ORDER = [
+    'Project',
+    'Agentic',
+    'Runtime',
+    'Models',
+    'Integrations',
+    'Knowledge',
+    'Config',
+    'Operations',
+    'Help',
+];
+const c = {
+    title: chalk_1.default.bold.rgb(...banners_1.PALETTE.teal),
+    sub: chalk_1.default.rgb(...banners_1.PALETTE.muted),
+    key: chalk_1.default.bold.rgb(...banners_1.PALETTE.teal),
+    arg: chalk_1.default.rgb(...banners_1.PALETTE.amber),
+    opt: chalk_1.default.rgb(...banners_1.PALETTE.cyan),
+    dim: chalk_1.default.rgb(...banners_1.PALETTE.muted),
+    accent: chalk_1.default.rgb(...banners_1.PALETTE.violet),
+    err: chalk_1.default.bold.rgb(...banners_1.PALETTE.red),
+};
+const headerFor = (cmd, version) => {
+    const name = cmd.name() === 'forge' ? 'forge' : `forge ${cmd.name()}`;
+    const isRoot = cmd.name() === 'forge' || cmd.parent === null || cmd.parent?.name() === 'forge';
+    const tagline = isRoot && cmd.name() === 'forge'
+        ? 'local-first agentic coding runtime'
+        : cmd.description() || '';
+    const lines = [
+        '',
+        '  ' + c.title(name) + c.sub(`  v${version}`),
+        ...(tagline ? ['  ' + c.sub(tagline)] : []),
+        '',
+    ];
+    return lines.join('\n');
+};
+const padRight = (s, width) => {
+    // eslint-disable-next-line no-control-regex -- strip ANSI CSI escape sequences
+    const visible = s.replace(/\x1b\[[0-9;]*m/g, '');
+    const gap = Math.max(1, width - visible.length);
+    return s + ' '.repeat(gap);
+};
+const buildHelper = (version) => {
+    const helper = new commander_1.Help();
+    helper.formatHelp = (cmd, h) => {
+        const pad = 26;
+        const lines = [];
+        lines.push(headerFor(cmd, version));
+        // Usage
+        const usage = h.commandUsage(cmd);
+        lines.push(c.accent('Usage'));
+        lines.push('  ' + c.dim(usage));
+        lines.push('');
+        // Arguments
+        const args = cmd.registeredArguments ?? [];
+        if (args.length) {
+            lines.push(c.accent('Arguments'));
+            for (const a of args) {
+                const name = h.argumentTerm(a);
+                const desc = h.argumentDescription(a);
+                lines.push('  ' + padRight(c.arg(name), pad) + c.dim(desc));
+            }
+            lines.push('');
+        }
+        // Options
+        const visibleOpts = h.visibleOptions(cmd);
+        if (visibleOpts.length) {
+            lines.push(c.accent('Options'));
+            for (const o of visibleOpts) {
+                const term = h.optionTerm(o);
+                const desc = h.optionDescription(o);
+                lines.push('  ' + padRight(c.opt(term), pad) + c.dim(desc));
+            }
+            lines.push('');
+        }
+        // Subcommands grouped by category
+        const cmds = h.visibleCommands(cmd);
+        if (cmds.length) {
+            const isRoot = cmd.name() === 'forge';
+            if (isRoot) {
+                const groups = new Map();
+                for (const sub of cmds) {
+                    const cat = COMMAND_CATEGORIES[sub.name()] ?? 'Other';
+                    const arr = groups.get(cat) ?? [];
+                    arr.push(sub);
+                    groups.set(cat, arr);
+                }
+                lines.push(c.accent('Commands'));
+                for (const cat of CATEGORY_ORDER) {
+                    const grp = groups.get(cat);
+                    if (!grp)
+                        continue;
+                    lines.push('  ' + c.sub(cat));
+                    for (const sub of grp) {
+                        const term = h.subcommandTerm(sub).replace(/\[options\]/g, '');
+                        const desc = h.subcommandDescription(sub);
+                        lines.push('    ' + padRight(c.key(term.trim()), pad - 2) + c.dim(desc));
+                    }
+                }
+                // Other (uncategorised)
+                const other = groups.get('Other');
+                if (other) {
+                    lines.push('  ' + c.sub('Other'));
+                    for (const sub of other) {
+                        const term = h.subcommandTerm(sub).replace(/\[options\]/g, '');
+                        const desc = h.subcommandDescription(sub);
+                        lines.push('    ' + padRight(c.key(term.trim()), pad - 2) + c.dim(desc));
+                    }
+                }
+            }
+            else {
+                lines.push(c.accent('Commands'));
+                for (const sub of cmds) {
+                    const term = h.subcommandTerm(sub);
+                    const desc = h.subcommandDescription(sub);
+                    lines.push('  ' + padRight(c.key(term), pad) + c.dim(desc));
+                }
+            }
+            lines.push('');
+        }
+        // Hint line
+        if (cmd.name() === 'forge') {
+            lines.push('  ' +
+                c.dim('tip: run ') +
+                c.accent('forge') +
+                c.dim(' (no args) on a TTY to drop into the interactive REPL.'));
+            lines.push('');
+        }
+        return lines.join('\n');
+    };
+    return helper;
+};
+const applyBrandedHelp = (program, version) => {
+    program.configureHelp({}); // reset any prior customisation
+    program._helpInstance = buildHelper(version);
+    // commander 12 exposes .createHelp — return our tuned instance for every cmd
+    program.createHelp = () => buildHelper(version);
+    for (const sub of program.commands) {
+        sub.createHelp = () => buildHelper(version);
+    }
+    program.configureOutput({
+        writeOut: (s) => process.stdout.write(s),
+        writeErr: (s) => {
+            if (s.startsWith('error:')) {
+                process.stderr.write(c.err('✖ ') + chalk_1.default.white(s.replace(/^error:\s*/, '')));
+                return;
+            }
+            process.stderr.write(s);
+        },
+        outputError: (s, write) => {
+            const msg = s.replace(/^error:\s*/, '');
+            write(c.err('✖ ') + chalk_1.default.white(msg) + '\n');
+        },
+    });
+    program.showHelpAfterError(c.dim('  (run ') + c.accent('forge help') + c.dim(' for the command surface)'));
+};
+exports.applyBrandedHelp = applyBrandedHelp;
+//# sourceMappingURL=help.js.map

package/dist/cli/help.js.map

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

package/dist/cli/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":""}

package/dist/cli/index.js

@@ -0,0 +1,154 @@
+#!/usr/bin/env node
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const chalk_1 = __importDefault(require("chalk"));
+const ui_1 = require("./ui");
+const init_1 = require("./commands/init");
+const run_1 = require("./commands/run");
+const status_1 = require("./commands/status");
+const task_1 = require("./commands/task");
+const session_1 = require("./commands/session");
+const model_1 = require("./commands/model");
+const mcp_1 = require("./commands/mcp");
+const skills_1 = require("./commands/skills");
+const config_1 = require("./commands/config");
+const doctor_1 = require("./commands/doctor");
+const update_1 = require("./commands/update");
+const daemon_1 = require("./commands/daemon");
+const permissions_1 = require("./commands/permissions");
+const ui_2 = require("./commands/ui");
+const bundle_1 = require("./commands/bundle");
+const container_1 = require("./commands/container");
+const migrate_1 = require("./commands/migrate");
+const memory_1 = require("./commands/memory");
+const web_1 = require("./commands/web");
+const spec_1 = require("./commands/spec");
+const resume_1 = require("./commands/resume");
+const changelog_1 = require("./commands/changelog");
+const dev_1 = require("./commands/dev");
+const cost_1 = require("./commands/cost");
+const logger_1 = require("../logging/logger");
+const help_1 = require("./help");
+const pkg = __importStar(require("../../package.json"));
+const program = new commander_1.Command();
+program
+    .name('forge')
+    .description('Forge — local-first agentic coding runtime')
+    .version(pkg.version ?? '0.1.0')
+    .option('--debug', 'enable debug logging', false)
+    .option('--no-repl', 'on bare invocation, print splash and exit instead of opening the REPL', false)
+    .hook('preAction', (thisCmd) => {
+    const opts = thisCmd.opts();
+    if (opts.debug)
+        (0, logger_1.setLevel)('debug');
+});
+program.addCommand(init_1.initCommand);
+program.addCommand(run_1.runCommand);
+program.addCommand(run_1.planCommand);
+program.addCommand(run_1.executeCommand);
+program.addCommand(status_1.statusCommand);
+program.addCommand(task_1.taskCommand);
+program.addCommand(session_1.sessionCommand);
+program.addCommand(model_1.modelCommand);
+program.addCommand(mcp_1.mcpCommand);
+program.addCommand(skills_1.skillsCommand);
+program.addCommand(skills_1.agentsCommand);
+program.addCommand(config_1.configCommand);
+program.addCommand(doctor_1.doctorCommand);
+program.addCommand(update_1.updateCommand);
+program.addCommand(daemon_1.daemonCommand);
+program.addCommand(permissions_1.permissionsCommand);
+program.addCommand(ui_2.uiCommand);
+program.addCommand(bundle_1.bundleCommand);
+program.addCommand(container_1.containerCommand);
+program.addCommand(migrate_1.migrateCommand);
+program.addCommand(memory_1.memoryCommand);
+program.addCommand(web_1.webCommand);
+program.addCommand(spec_1.specCommand);
+program.addCommand(resume_1.resumeCommand);
+program.addCommand(changelog_1.changelogCommand);
+program.addCommand(dev_1.devCommand);
+program.addCommand(cost_1.costCommand);
+// Explicit REPL subcommand: `forge repl` (works even when stdin isn't a TTY
+// for developers who know what they're asking for, and useful as a stable
+// entry point for integrations).
+program
+    .command('repl')
+    .description('Open the interactive Forge shell (multi-turn conversation).')
+    .option('--resume <sessionId>', 'resume an existing REPL session by id', undefined)
+    .option('--no-banner', 'skip the opening splash', false)
+    .action(async (opts) => {
+    if (opts.banner !== false) {
+        const { revealLines } = await Promise.resolve().then(() => __importStar(require('./animations')));
+        await revealLines((0, ui_1.welcome)(pkg.version ?? '0.1.0'), 30);
+    }
+    const { startRepl } = await Promise.resolve().then(() => __importStar(require('./repl')));
+    await startRepl(program, { resumeSessionId: opts.resume });
+});
+(0, help_1.applyBrandedHelp)(program, pkg.version ?? '0.1.0');
+const main = async () => {
+    const hasArgs = process.argv.length > 2;
+    const wantsNoRepl = process.argv.includes('--no-repl') ||
+        process.env.FORGE_NO_REPL === '1' ||
+        process.env.FORGE_NO_REPL === 'true';
+    const isTty = Boolean(process.stdin.isTTY && process.stdout.isTTY);
+    if (!hasArgs || (process.argv.length === 3 && process.argv[2] === '--no-repl')) {
+        const { revealLines, typeWriter } = await Promise.resolve().then(() => __importStar(require('./animations')));
+        await revealLines((0, ui_1.welcome)(pkg.version ?? '0.1.0'), 30);
+        if (!wantsNoRepl && isTty) {
+            const { startRepl } = await Promise.resolve().then(() => __importStar(require('./repl')));
+            await startRepl(program);
+            return;
+        }
+        // non-TTY or explicitly disabled → print the hint and leave cleanly
+        await typeWriter(chalk_1.default.dim('    run ') + chalk_1.default.bold('forge help') + chalk_1.default.dim(' for the command surface\n\n'), { perCharMs: 10, capMs: 600 });
+        return;
+    }
+    if (process.argv[2] === 'help' && process.argv.length === 3) {
+        process.stdout.write((0, ui_1.banner)());
+    }
+    await program.parseAsync(process.argv);
+};
+main().catch((err) => {
+    logger_1.log.error('cli crashed', { err: String(err) });
+    process.stderr.write(`\nError: ${err instanceof Error ? err.message : String(err)}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

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

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

@@ -0,0 +1,47 @@
+/**
+ * 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.
+ */
+import { Mode } from '../types';
+export type SlashKind = 'passthrough' | 'internal' | 'semantic';
+export interface SemanticExpansion {
+    prompt: string;
+    mode?: Mode;
+    autoApprove?: boolean;
+    planOnly?: boolean;
+}
+export interface SlashCommand {
+    name: string;
+    aliases?: string[];
+    description: string;
+    category: 'Agentic' | 'Session' | 'Modes' | 'Knowledge' | 'Models' | 'Infrastructure' | 'Shortcut';
+    kind: SlashKind;
+    passthroughTo?: string;
+    template?: (args: string) => SemanticExpansion;
+    hint?: string;
+}
+export declare const SLASH_COMMANDS: SlashCommand[];
+export declare const findSlash: (input: string) => SlashCommand | undefined;
+export interface SlashSuggestion {
+    label: string;
+    value: string;
+    description?: string;
+    score: number;
+    cmd: SlashCommand;
+}
+export declare const rankSlash: (input: string, limit?: number) => SlashSuggestion[];
+//# sourceMappingURL=repl-commands.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"repl-commands.d.ts","sourceRoot":"","sources":["../../src/cli/repl-commands.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAEhC,MAAM,MAAM,SAAS,GAAG,aAAa,GAAG,UAAU,GAAG,UAAU,CAAC;AAEhE,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EACJ,SAAS,GACT,SAAS,GACT,OAAO,GACP,WAAW,GACX,QAAQ,GACR,gBAAgB,GAChB,UAAU,CAAC;IACf,IAAI,EAAE,SAAS,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,iBAAiB,CAAC;IAC/C,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAWD,eAAO,MAAM,cAAc,EAAE,YAAY,EA2bxC,CAAC;AAaF,eAAO,MAAM,SAAS,GAAI,OAAO,MAAM,KAAG,YAAY,GAAG,SACnB,CAAC;AAyBvC,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,YAAY,CAAC;CACnB;AAED,eAAO,MAAM,SAAS,GAAI,OAAO,MAAM,EAAE,cAAS,KAAG,eAAe,EA4CnE,CAAC"}