codebase-onboarder 0.7.0 → 1.0.1

package/cli/chat/commands.js

@@ -0,0 +1,122 @@
+import { AGENT_MODES } from '../agent/contracts.js';
+export const CHAT_COMMANDS = [
+    ['help', '[command]', 'Show commands and examples'],
+    ['ask', '<question>', 'Ask about this repository'],
+    ['review', '[PR number] [task]', 'Review local changes or a GitHub PR'],
+    ['triage', '[issue number] [task]', 'Investigate issues and suggest fixes'],
+    ['implement', '<task>', 'Make changes in an isolated Git workspace'],
+    ['pr', '<task>', 'Prepare a draft PR; publish when GitHub writes are enabled'],
+    ['github', '<task>', 'Work with GitHub issues, reviews, labels, and CI'],
+    ['mode', '[ask|review|triage|implement|pr|github]', 'Choose the workflow for following messages'],
+    ['permissions', '[checks|github] [on|off]', 'Control test execution and GitHub writes'],
+    ['model', '[name] [provider]', 'Open the provider/model picker; configure opens full Hermes setup'],
+    ['limits', '[seconds] [turns]', 'Set the run timeout and tool-turn budget'],
+    ['repo', '[folder|GitHub URL]', 'Show or switch the repository; clone GitHub URLs'],
+    ['clone', '<GitHub URL>', 'Clone a repository into a saved local checkout'],
+    ['pull', '', 'Update the saved checkout without overwriting local changes'],
+    ['new', '', 'Start a fresh conversation'],
+    ['history', '', 'List saved conversations for this repository'],
+    ['resume', '<conversation ID>', 'Continue a saved conversation'],
+    ['status', '', 'Show model, permissions, workspace, and last run'],
+    ['paste', '', 'Enter a multiline message; finish with /send or /discard'],
+    ['cancel', '', 'Stop the active task (Ctrl-C also works)'],
+    ['map', '', 'Repository overview, available offline'],
+    ['tree', '[folder] [depth]', 'Browse repository files'],
+    ['find', '<query>', 'Search files, symbols, and contents'],
+    ['show', '<file> [from] [count]', 'Read a file'],
+    ['diff', '[base] [head] [file]', 'Inspect changes in the current workspace'],
+    ['health', '', 'Inspect repository health'],
+    ['rescan', '', 'Refresh the cached repository analysis'],
+    ['tour', '', 'Find the best reading order for this codebase'],
+    ['explain', '[file|folder]', 'Explain a module using local analysis'],
+    ['deps', '<file>', 'Trace imports and reverse dependencies'],
+    ['inspect', '<file>', 'Inspect role, complexity, exports, and findings'],
+    ['graph', '<file> [depth]', 'Explore the dependency graph'],
+    ['blast', '<file>', 'Show the impact of changing a file'],
+    ['symbols', '<file>', 'List functions, classes, and exports'],
+    ['hubs', '', 'Find the most depended-on modules'],
+    ['layers', '', 'Inspect architecture layers'],
+    ['patterns', '', 'Discover architecture patterns'],
+    ['stats', '', 'Inspect language and complexity statistics'],
+    ['security', '', 'Show local security findings'],
+    ['stack', '', 'Inspect frameworks and dependencies'],
+    ['entry', '', 'Locate application entry points'],
+    ['externals', '', 'Inspect external dependencies and drift'],
+    ['coupling', '', 'Explore traffic between folders'],
+    ['clusters', '', 'Find groups of related modules'],
+    ['risks', '', 'Inspect code and architecture risks'],
+    ['log', '[count]', 'Read recent Git commits'],
+    ['hotspots', '[count]', 'Find frequently changed complex files'],
+    ['blame', '<file>', 'Read line authorship'],
+    ['diagram', '[file|folder]', 'Generate Mermaid diagram source'],
+    ['layers-diagram', '', 'Generate an architecture layer diagram'],
+    ['atlas', '', 'Browse available diagrams'],
+    ['docs', '[file|folder] [--write]', 'Read or explicitly generate repository documentation'],
+    ['workflows', '', 'Inspect GitHub Actions workflows'],
+    ['sbom', '[package]', 'Inspect dependencies and licenses'],
+    ['engines', '', 'Show available optional analyzers'],
+    ['deep', '[engine|all|security|dead-code|results|explain|export|options]', 'Choose web UI analyzers, configure scans, and explain saved results'],
+    ['web', '', 'Open the repository in the web interface'],
+    ['about', '', 'Show repository and application information'],
+    ['tools', '', 'List the actual tools available to Hermes'],
+    ['skills', '', 'Discover the six built-in agent workflows'],
+    ['runs', '', 'List saved agent runs'],
+    ['run', '<run ID>', 'Read a saved result from this repository'],
+    ['export', '', 'Save this conversation as Markdown'],
+    ['send', '', 'Submit the message composed with /paste'],
+    ['discard', '', 'Discard the message composed with /paste'],
+    ['doctor', '', 'Check the Hermes runtime and profile'],
+    ['setup', '', 'Prepare the dedicated Hermes profile'],
+    ['clear', '', 'Clear the screen; keep the conversation'],
+    ['exit', '', 'Save and exit (Ctrl-D also works)'],
+];
+export const BROWSE_COMMANDS = ['map', 'tree', 'find', 'show', 'diff', 'health', 'rescan', 'tour', 'explain', 'deps', 'inspect', 'graph', 'blast', 'symbols', 'hubs', 'layers', 'patterns', 'stats', 'security', 'stack', 'entry', 'externals', 'coupling', 'clusters', 'risks', 'log', 'hotspots', 'blame', 'diagram', 'layers-diagram', 'atlas', 'docs', 'workflows', 'sbom', 'engines', 'deep', 'web', 'about'];
+export function suggestCommands(line) {
+    if (!/^\/[\w-]*$/.test(line))
+        return [];
+    const query = line.slice(1).toLowerCase();
+    return CHAT_COMMANDS.filter(([name, , summary]) => name.startsWith(query) || query.length > 1 && summary.toLowerCase().includes(query))
+        .sort((a, b) => Number(b[0].startsWith(query)) - Number(a[0].startsWith(query)));
+}
+export function slashInput(line) {
+    const match = /^\/([\w-]*)(?:\s+([\s\S]*))?$/.exec(line.trim());
+    if (!match)
+        return null;
+    const body = match[2] || '';
+    // Quotes are useful for file paths. Workflow tasks retain the original body.
+    const args = [...body.matchAll(/"([^"]*)"|'([^']*)'|(\S+)/g)].map(m => m[1] ?? m[2] ?? m[3]);
+    return { name: match[1], args, body };
+}
+export function chatHelp(topic = '') {
+    const commands = topic ? CHAT_COMMANDS.filter(c => c[0] === topic.replace(/^\//, '')) : CHAT_COMMANDS;
+    if (!commands.length)
+        return `Unknown command /${topic}. Use /help.`;
+    return ['Slash commands', '', ...commands.map(([name, args, detail]) => `  /${name}${args ? ' ' + args : ''}\n    ${detail}`), '',
+        'Type / for live suggestions. ↑/↓ select; Tab or Enter fills the command. Esc dismisses.',
+        'Alt-Enter adds a line. Bracketed paste preserves multiline text. Ctrl-C cancels a task.',
+        '/review 42   /triage 12   /implement Fix the failing test',
+        '/permissions checks on   /permissions github on',
+        'Paste a GitHub URL to clone and open it, then type your question.',
+        'Follow-ups reuse the Hermes session. Mode, target, model, or permission changes start a new session.',
+        'Use /paste for multiline text. /new resets context; /clear only clears the screen.'].join('\n');
+}
+export function completeChat(line, files = []) {
+    if (!line.startsWith('/'))
+        return [[], line];
+    if (!line.includes(' '))
+        return [CHAT_COMMANDS.map(c => '/' + c[0]).filter(c => c.startsWith(line)), line];
+    const [command, ...args] = line.split(/\s+/), fragment = args.at(-1) || '';
+    let candidates = [];
+    if (command === '/mode')
+        candidates = AGENT_MODES;
+    if (command === '/permissions')
+        candidates = args.length === 1 ? ['checks', 'github'] : ['on', 'off'];
+    if (command === '/model' && args.length === 1)
+        candidates = ['configure', 'default'];
+    if (command === '/deep')
+        candidates = args.length === 1 ? ['all', 'security', 'dead-code', 'semgrep', 'gitleaks', 'knip', 'vulture', 'depcheck', 'results', 'explain', 'export', 'options', 'help'] : args[0] === 'options' ? ['semgrep', 'gitleaks', 'knip', 'vulture', 'depcheck'] : args[0] === 'results' ? ['critical', 'high', 'medium', 'low', 'info', 'semgrep', 'gitleaks', 'knip', 'vulture', 'depcheck'] : [];
+    if (['/show', '/tree', '/repo', '/deps', '/inspect', '/graph', '/blast', '/symbols', '/explain', '/blame', '/docs', '/diagram'].includes(command))
+        candidates = files;
+    return [candidates.filter(c => c.startsWith(fragment)).slice(0, 100), fragment];
+}
+//# sourceMappingURL=commands.js.map

package/cli/chat/commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.js","sourceRoot":"","sources":["../../src/cli/chat/commands.ts"],"names":[],"mappings":"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","sourcesContent":["import { AGENT_MODES } from '../agent/contracts.js';\n\nexport const CHAT_COMMANDS = [\n  ['help', '[command]', 'Show commands and examples'],\n  ['ask', '<question>', 'Ask about this repository'],\n  ['review', '[PR number] [task]', 'Review local changes or a GitHub PR'],\n  ['triage', '[issue number] [task]', 'Investigate issues and suggest fixes'],\n  ['implement', '<task>', 'Make changes in an isolated Git workspace'],\n  ['pr', '<task>', 'Prepare a draft PR; publish when GitHub writes are enabled'],\n  ['github', '<task>', 'Work with GitHub issues, reviews, labels, and CI'],\n  ['mode', '[ask|review|triage|implement|pr|github]', 'Choose the workflow for following messages'],\n  ['permissions', '[checks|github] [on|off]', 'Control test execution and GitHub writes'],\n  ['model', '[name] [provider]', 'Open the provider/model picker; configure opens full Hermes setup'],\n  ['limits', '[seconds] [turns]', 'Set the run timeout and tool-turn budget'],\n  ['repo', '[folder|GitHub URL]', 'Show or switch the repository; clone GitHub URLs'],\n  ['clone', '<GitHub URL>', 'Clone a repository into a saved local checkout'],\n  ['pull', '', 'Update the saved checkout without overwriting local changes'],\n  ['new', '', 'Start a fresh conversation'],\n  ['history', '', 'List saved conversations for this repository'],\n  ['resume', '<conversation ID>', 'Continue a saved conversation'],\n  ['status', '', 'Show model, permissions, workspace, and last run'],\n  ['paste', '', 'Enter a multiline message; finish with /send or /discard'],\n  ['cancel', '', 'Stop the active task (Ctrl-C also works)'],\n  ['map', '', 'Repository overview, available offline'],\n  ['tree', '[folder] [depth]', 'Browse repository files'],\n  ['find', '<query>', 'Search files, symbols, and contents'],\n  ['show', '<file> [from] [count]', 'Read a file'],\n  ['diff', '[base] [head] [file]', 'Inspect changes in the current workspace'],\n  ['health', '', 'Inspect repository health'],\n  ['rescan', '', 'Refresh the cached repository analysis'],\n  ['tour', '', 'Find the best reading order for this codebase'],\n  ['explain', '[file|folder]', 'Explain a module using local analysis'],\n  ['deps', '<file>', 'Trace imports and reverse dependencies'],\n  ['inspect', '<file>', 'Inspect role, complexity, exports, and findings'],\n  ['graph', '<file> [depth]', 'Explore the dependency graph'],\n  ['blast', '<file>', 'Show the impact of changing a file'],\n  ['symbols', '<file>', 'List functions, classes, and exports'],\n  ['hubs', '', 'Find the most depended-on modules'],\n  ['layers', '', 'Inspect architecture layers'],\n  ['patterns', '', 'Discover architecture patterns'],\n  ['stats', '', 'Inspect language and complexity statistics'],\n  ['security', '', 'Show local security findings'],\n  ['stack', '', 'Inspect frameworks and dependencies'],\n  ['entry', '', 'Locate application entry points'],\n  ['externals', '', 'Inspect external dependencies and drift'],\n  ['coupling', '', 'Explore traffic between folders'],\n  ['clusters', '', 'Find groups of related modules'],\n  ['risks', '', 'Inspect code and architecture risks'],\n  ['log', '[count]', 'Read recent Git commits'],\n  ['hotspots', '[count]', 'Find frequently changed complex files'],\n  ['blame', '<file>', 'Read line authorship'],\n  ['diagram', '[file|folder]', 'Generate Mermaid diagram source'],\n  ['layers-diagram', '', 'Generate an architecture layer diagram'],\n  ['atlas', '', 'Browse available diagrams'],\n  ['docs', '[file|folder] [--write]', 'Read or explicitly generate repository documentation'],\n  ['workflows', '', 'Inspect GitHub Actions workflows'],\n  ['sbom', '[package]', 'Inspect dependencies and licenses'],\n  ['engines', '', 'Show available optional analyzers'],\n  ['deep', '[engine|all|security|dead-code|results|explain|export|options]', 'Choose web UI analyzers, configure scans, and explain saved results'],\n  ['web', '', 'Open the repository in the web interface'],\n  ['about', '', 'Show repository and application information'],\n  ['tools', '', 'List the actual tools available to Hermes'],\n  ['skills', '', 'Discover the six built-in agent workflows'],\n  ['runs', '', 'List saved agent runs'],\n  ['run', '<run ID>', 'Read a saved result from this repository'],\n  ['export', '', 'Save this conversation as Markdown'],\n  ['send', '', 'Submit the message composed with /paste'],\n  ['discard', '', 'Discard the message composed with /paste'],\n  ['doctor', '', 'Check the Hermes runtime and profile'],\n  ['setup', '', 'Prepare the dedicated Hermes profile'],\n  ['clear', '', 'Clear the screen; keep the conversation'],\n  ['exit', '', 'Save and exit (Ctrl-D also works)'],\n] as const;\nexport type ChatCommand = typeof CHAT_COMMANDS[number][0];\nexport const BROWSE_COMMANDS = ['map', 'tree', 'find', 'show', 'diff', 'health', 'rescan', 'tour', 'explain', 'deps', 'inspect', 'graph', 'blast', 'symbols', 'hubs', 'layers', 'patterns', 'stats', 'security', 'stack', 'entry', 'externals', 'coupling', 'clusters', 'risks', 'log', 'hotspots', 'blame', 'diagram', 'layers-diagram', 'atlas', 'docs', 'workflows', 'sbom', 'engines', 'deep', 'web', 'about'] as const;\n\nexport function suggestCommands(line: string): typeof CHAT_COMMANDS[number][] {\n  if (!/^\\/[\\w-]*$/.test(line)) return [];\n  const query = line.slice(1).toLowerCase();\n  return CHAT_COMMANDS.filter(([name, , summary]) => name.startsWith(query) || query.length > 1 && summary.toLowerCase().includes(query))\n    .sort((a, b) => Number(b[0].startsWith(query)) - Number(a[0].startsWith(query)));\n}\n\nexport function slashInput(line: string): { name: string; args: string[]; body: string } | null {\n  const match = /^\\/([\\w-]*)(?:\\s+([\\s\\S]*))?$/.exec(line.trim());\n  if (!match) return null;\n  const body = match[2] || '';\n  // Quotes are useful for file paths. Workflow tasks retain the original body.\n  const args = [...body.matchAll(/\"([^\"]*)\"|'([^']*)'|(\\S+)/g)].map(m => m[1] ?? m[2] ?? m[3]!);\n  return { name: match[1]!, args, body };\n}\nexport function chatHelp(topic = ''): string {\n  const commands = topic ? CHAT_COMMANDS.filter(c => c[0] === topic.replace(/^\\//, '')) : CHAT_COMMANDS;\n  if (!commands.length) return `Unknown command /${topic}. Use /help.`;\n  return ['Slash commands', '', ...commands.map(([name, args, detail]) => `  /${name}${args ? ' ' + args : ''}\\n    ${detail}`), '',\n    'Type / for live suggestions. ↑/↓ select; Tab or Enter fills the command. Esc dismisses.',\n    'Alt-Enter adds a line. Bracketed paste preserves multiline text. Ctrl-C cancels a task.',\n    '/review 42   /triage 12   /implement Fix the failing test',\n    '/permissions checks on   /permissions github on',\n    'Paste a GitHub URL to clone and open it, then type your question.',\n    'Follow-ups reuse the Hermes session. Mode, target, model, or permission changes start a new session.',\n    'Use /paste for multiline text. /new resets context; /clear only clears the screen.'].join('\\n');\n}\nexport function completeChat(line: string, files: string[] = []): [string[], string] {\n  if (!line.startsWith('/')) return [[], line];\n  if (!line.includes(' ')) return [CHAT_COMMANDS.map(c => '/' + c[0]).filter(c => c.startsWith(line)), line];\n  const [command, ...args] = line.split(/\\s+/), fragment = args.at(-1) || '';\n  let candidates: readonly string[] = [];\n  if (command === '/mode') candidates = AGENT_MODES;\n  if (command === '/permissions') candidates = args.length === 1 ? ['checks', 'github'] : ['on', 'off'];\n  if (command === '/model' && args.length === 1) candidates = ['configure', 'default'];\n  if (command === '/deep') candidates = args.length === 1 ? ['all', 'security', 'dead-code', 'semgrep', 'gitleaks', 'knip', 'vulture', 'depcheck', 'results', 'explain', 'export', 'options', 'help'] : args[0] === 'options' ? ['semgrep', 'gitleaks', 'knip', 'vulture', 'depcheck'] : args[0] === 'results' ? ['critical', 'high', 'medium', 'low', 'info', 'semgrep', 'gitleaks', 'knip', 'vulture', 'depcheck'] : [];\n  if (['/show', '/tree', '/repo', '/deps', '/inspect', '/graph', '/blast', '/symbols', '/explain', '/blame', '/docs', '/diagram'].includes(command!)) candidates = files;\n  return [candidates.filter(c => c.startsWith(fragment)).slice(0, 100), fragment];\n}\n"]}

package/cli/chat/composer.d.ts

@@ -0,0 +1,75 @@
+import readline from 'node:readline';
+import { type ChatTheme } from './render.js';
+export interface ComposerOptions {
+    input: NodeJS.ReadStream;
+    output: NodeJS.WriteStream;
+    theme?: ChatTheme;
+    state: () => {
+        mode: string;
+        status: string;
+        busy: boolean;
+        pasting: boolean;
+        files: string[];
+    };
+    submit: (message: string) => void;
+    cancel: () => void;
+    exit: () => void;
+    fullscreen?: boolean;
+    welcome?: (columns: number, rows: number) => string;
+    header?: () => string;
+}
+export interface PickerChoice {
+    value: string;
+    label: string;
+    detail?: string;
+}
+export interface PickerOptions {
+    title: string;
+    hint?: string;
+    choices: PickerChoice[];
+    selected?: string;
+    signal?: AbortSignal;
+}
+/** Raw-input composer with a full-screen viewport or an inline terminal footer. */
+export declare class TerminalComposer {
+    private options;
+    value: string;
+    private cursor;
+    private selected;
+    private dismissed;
+    private history;
+    private historyIndex;
+    private draft;
+    private paste;
+    private pasteCR;
+    private suspended;
+    private attached;
+    private drawnRows;
+    private cursorRow;
+    private timer;
+    private rawBefore;
+    private theme;
+    private screen;
+    private viewHeight;
+    private picker;
+    private onKey;
+    private onResize;
+    constructor(options: ComposerOptions);
+    get choosing(): boolean;
+    start(): void;
+    suspend(): void;
+    close(): void;
+    refresh(): void;
+    print(text: string): void;
+    clear(): void;
+    choose(options: PickerOptions): Promise<string | null>;
+    private pickerChoices;
+    private pickerKey;
+    private erase;
+    private replace;
+    private insert;
+    private suggestions;
+    key(text: string, key?: readline.Key): void;
+    private deleteNext;
+    private render;
+}