codebase-onboarder 0.7.0 → 1.0.1

package/cli/chat/screen.js

@@ -0,0 +1,117 @@
+import { graphemes, clusterCells } from './text.js';
+import { terminalText } from '../agent/process.js';
+/** Keep only our text styling; wrap by terminal cells, including emoji and CJK. */
+export function wrapScreenLine(text, columns) {
+    const room = Math.max(1, columns), rows = [];
+    let row = '', used = 0, style = '';
+    for (const token of text.split(/(\x1b\[[\d;]*m)/g)) {
+        if (/^\x1b\[[\d;]*m$/.test(token)) {
+            row += token;
+            style = token === '\x1b[0m' || token === '\x1b[m' ? '' : (style + token).slice(-512);
+            continue;
+        }
+        for (const cluster of graphemes(terminalText(token).replace(/\t/g, '  ').replace(/[\r\n]/g, ' '))) {
+            const size = clusterCells(cluster);
+            if (used + size > room && used) {
+                rows.push(row + (style ? '\x1b[0m' : ''));
+                row = style;
+                used = 0;
+            }
+            row += size > room ? '?' : cluster;
+            used += Math.min(size, room);
+        }
+    }
+    rows.push(row + (style ? '\x1b[0m' : ''));
+    return rows;
+}
+/** Alternate-screen ownership, bounded transcript and updates of changed rows only. */
+export class TerminalScreen {
+    output;
+    lines = [];
+    bytes = 0;
+    width = 0;
+    wrapped = [];
+    dirty = true;
+    offset = 0;
+    frame = [];
+    columns = 0;
+    active = false;
+    pendingRows = 0;
+    constructor(output) {
+        this.output = output;
+    }
+    get scrolled() { return this.offset > 0; }
+    enter() {
+        if (this.active)
+            return;
+        this.active = true;
+        this.frame = [];
+        this.columns = 0;
+        this.output.write('\x1b[?1049h\x1b[2J\x1b[H');
+    }
+    leave() {
+        if (!this.active)
+            return;
+        this.active = false;
+        this.frame = [];
+        this.output.write('\x1b[0m\x1b[?25h\x1b[?1049l');
+    }
+    append(text) {
+        // Keep source and code whitespace, while bounding the in-memory viewport.
+        // Complete conversations are still persisted by the controller.
+        const lines = text.split(/\r?\n/);
+        if (this.offset && this.width)
+            this.pendingRows += lines.reduce((n, line) => n + wrapScreenLine(line, this.width).length, 0);
+        for (const line of lines) {
+            this.lines.push(line);
+            this.bytes += Buffer.byteLength(line);
+        }
+        while (this.lines.length > 4000 || this.bytes > 2 * 1024 * 1024)
+            this.bytes -= Buffer.byteLength(this.lines.shift());
+        this.dirty = true;
+    }
+    clear() { this.lines = []; this.bytes = 0; this.offset = 0; this.pendingRows = 0; this.dirty = true; }
+    reflow(columns) {
+        if (!this.dirty && this.width === columns)
+            return;
+        this.wrapped = this.lines.flatMap(line => wrapScreenLine(line, columns));
+        this.width = columns;
+        this.dirty = false;
+        this.offset += this.pendingRows;
+        this.pendingRows = 0;
+    }
+    scroll(direction, columns, height) {
+        this.reflow(columns);
+        this.offset = Math.min(Math.max(0, this.wrapped.length - height), Math.max(0, this.offset + direction * Math.max(1, height - 2)));
+    }
+    view(columns, height, welcome) {
+        this.reflow(columns);
+        this.offset = Math.min(this.offset, Math.max(0, this.wrapped.length - height));
+        if (!this.lines.length)
+            return welcome.split('\n').flatMap(line => wrapScreenLine(line, columns)).slice(0, height);
+        const end = Math.max(0, this.wrapped.length - this.offset);
+        return this.wrapped.slice(Math.max(0, end - height), end);
+    }
+    draw(rows, columns, cursorRow, cursorColumn) {
+        if (!this.active)
+            return;
+        let write = '';
+        const resized = columns !== this.columns || rows.length !== this.frame.length;
+        if (resized) {
+            write += '\x1b[2J';
+            this.frame = [];
+            this.columns = columns;
+        }
+        rows.forEach((row, i) => {
+            if (row !== this.frame[i])
+                write += `\x1b[${i + 1};1H\x1b[2K` + row;
+        });
+        // Cursor placement remains stable through resizing, streamed output and menus.
+        if (write)
+            this.output.write('\x1b[?25l' + write + `\x1b[${cursorRow + 1};${cursorColumn + 1}H\x1b[?25h`);
+        else
+            this.output.write(`\x1b[${cursorRow + 1};${cursorColumn + 1}H`);
+        this.frame = rows;
+    }
+}
+//# sourceMappingURL=screen.js.map

package/cli/chat/screen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"screen.js","sourceRoot":"","sources":["../../src/cli/chat/screen.ts"],"names":[],"mappings":"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","sourcesContent":["import { graphemes, clusterCells } from './text.js';\nimport { terminalText } from '../agent/process.js';\n\n/** Keep only our text styling; wrap by terminal cells, including emoji and CJK. */\nexport function wrapScreenLine(text: string, columns: number): string[] {\n  const room = Math.max(1, columns), rows: string[] = [];\n  let row = '', used = 0, style = '';\n  for (const token of text.split(/(\\x1b\\[[\\d;]*m)/g)) {\n    if (/^\\x1b\\[[\\d;]*m$/.test(token)) {\n      row += token;\n      style = token === '\\x1b[0m' || token === '\\x1b[m' ? '' : (style + token).slice(-512);\n      continue;\n    }\n    for (const cluster of graphemes(terminalText(token).replace(/\\t/g, '  ').replace(/[\\r\\n]/g, ' '))) {\n      const size = clusterCells(cluster);\n      if (used + size > room && used) { rows.push(row + (style ? '\\x1b[0m' : '')); row = style; used = 0; }\n      row += size > room ? '?' : cluster; used += Math.min(size, room);\n    }\n  }\n  rows.push(row + (style ? '\\x1b[0m' : ''));\n  return rows;\n}\n\n/** Alternate-screen ownership, bounded transcript and updates of changed rows only. */\nexport class TerminalScreen {\n  private lines: string[] = [];\n  private bytes = 0;\n  private width = 0;\n  private wrapped: string[] = [];\n  private dirty = true;\n  private offset = 0;\n  private frame: string[] = [];\n  private columns = 0;\n  private active = false;\n  private pendingRows = 0;\n  constructor(private output: NodeJS.WriteStream) {}\n  get scrolled() { return this.offset > 0; }\n  enter() {\n    if (this.active) return;\n    this.active = true; this.frame = []; this.columns = 0;\n    this.output.write('\\x1b[?1049h\\x1b[2J\\x1b[H');\n  }\n  leave() {\n    if (!this.active) return;\n    this.active = false; this.frame = [];\n    this.output.write('\\x1b[0m\\x1b[?25h\\x1b[?1049l');\n  }\n  append(text: string) {\n    // Keep source and code whitespace, while bounding the in-memory viewport.\n    // Complete conversations are still persisted by the controller.\n    const lines = text.split(/\\r?\\n/);\n    if (this.offset && this.width) this.pendingRows += lines.reduce((n, line) => n + wrapScreenLine(line, this.width).length, 0);\n    for (const line of lines) { this.lines.push(line); this.bytes += Buffer.byteLength(line); }\n    while (this.lines.length > 4000 || this.bytes > 2 * 1024 * 1024) this.bytes -= Buffer.byteLength(this.lines.shift()!);\n    this.dirty = true;\n  }\n  clear() { this.lines = []; this.bytes = 0; this.offset = 0; this.pendingRows = 0; this.dirty = true; }\n  private reflow(columns: number) {\n    if (!this.dirty && this.width === columns) return;\n    this.wrapped = this.lines.flatMap(line => wrapScreenLine(line, columns));\n    this.width = columns; this.dirty = false;\n    this.offset += this.pendingRows; this.pendingRows = 0;\n  }\n  scroll(direction: number, columns: number, height: number) {\n    this.reflow(columns);\n    this.offset = Math.min(Math.max(0, this.wrapped.length - height), Math.max(0, this.offset + direction * Math.max(1, height - 2)));\n  }\n  view(columns: number, height: number, welcome: string): string[] {\n    this.reflow(columns);\n    this.offset = Math.min(this.offset, Math.max(0, this.wrapped.length - height));\n    if (!this.lines.length) return welcome.split('\\n').flatMap(line => wrapScreenLine(line, columns)).slice(0, height);\n    const end = Math.max(0, this.wrapped.length - this.offset);\n    return this.wrapped.slice(Math.max(0, end - height), end);\n  }\n  draw(rows: string[], columns: number, cursorRow: number, cursorColumn: number) {\n    if (!this.active) return;\n    let write = '';\n    const resized = columns !== this.columns || rows.length !== this.frame.length;\n    if (resized) { write += '\\x1b[2J'; this.frame = []; this.columns = columns; }\n    rows.forEach((row, i) => {\n      if (row !== this.frame[i]) write += `\\x1b[${i + 1};1H\\x1b[2K` + row;\n    });\n    // Cursor placement remains stable through resizing, streamed output and menus.\n    if (write) this.output.write('\\x1b[?25l' + write + `\\x1b[${cursorRow + 1};${cursorColumn + 1}H\\x1b[?25h`);\n    else this.output.write(`\\x1b[${cursorRow + 1};${cursorColumn + 1}H`);\n    this.frame = rows;\n  }\n}\n"]}

package/cli/chat/source.d.ts

@@ -0,0 +1,29 @@
+import { runProcess } from '../agent/process.js';
+export interface ChatSource {
+    root: string;
+    sourceUrl?: string;
+    reused: boolean;
+}
+interface SourceOptions {
+    env?: NodeJS.ProcessEnv;
+    execute?: typeof runProcess;
+}
+export declare function isRemoteSource(value: string): boolean;
+export declare function githubSource(value: string): {
+    repository: string;
+    url: string;
+    gitUrl: string;
+};
+/** Persistent checkouts keep conversations and agent worktrees usable after exit. */
+export declare class ChatSources {
+    readonly home: string;
+    private options;
+    constructor(home?: string, options?: SourceOptions);
+    get directory(): string;
+    private target;
+    private git;
+    private verify;
+    open(target: string, from?: string, signal?: AbortSignal, progress?: (text: string) => void): Promise<ChatSource>;
+    pull(root: string, signal?: AbortSignal, progress?: (text: string) => void): Promise<string>;
+}
+export {};

package/cli/chat/source.js

@@ -0,0 +1,116 @@
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import { createHash, randomUUID } from 'node:crypto';
+import { agentHome } from '../agent/config.js';
+import { repositoryFromRemote } from '../agent/github.js';
+import { runProcess } from '../agent/process.js';
+export function isRemoteSource(value) { return /^(?:https?:\/\/|ssh:\/\/|git@)/i.test(value); }
+export function githubSource(value) {
+    const raw = value.trim(), repository = repositoryFromRemote(raw);
+    if (!repository)
+        throw new Error('Enter a GitHub repository URL: https://github.com/owner/repo or git@github.com:owner/repo.git.');
+    const url = `https://github.com/${repository}`;
+    const gitUrl = /^https:/i.test(raw) ? url + '.git' : `git@github.com:${repository}.git`;
+    return { repository, url, gitUrl };
+}
+/** Persistent checkouts keep conversations and agent worktrees usable after exit. */
+export class ChatSources {
+    home;
+    options;
+    constructor(home = agentHome(), options = {}) {
+        this.home = home;
+        this.options = options;
+    }
+    get directory() { return path.join(this.home, 'repositories'); }
+    target(repository) {
+        const key = repository.toLowerCase();
+        return path.join(this.directory, key.split('/')[1].slice(0, 40) + '-' + createHash('sha256').update(key).digest('hex').slice(0, 16));
+    }
+    async git(args, signal, hooks) {
+        const env = this.options.env || process.env;
+        const result = await (this.options.execute || runProcess)('git', [
+            ...(hooks ? ['-c', `core.hooksPath=${hooks}`] : []), '-c', 'submodule.recurse=false', ...args,
+        ], { env: { ...env, GIT_TERMINAL_PROMPT: '0', GIT_SSH_COMMAND: env.GIT_SSH_COMMAND || 'ssh -oBatchMode=yes' }, signal, timeoutMs: 180000, maxBytes: 1024 * 1024 });
+        if (result.code !== 0)
+            throw new Error(`Could not open/update the repository. ${result.stderr.trim().slice(-1200) || 'Git exited with ' + result.code}. Private repositories require your existing Git credentials.`);
+        return result.stdout.trim();
+    }
+    async verify(target, repository, signal) {
+        const stat = await fs.lstat(target);
+        if (!stat.isDirectory() || stat.isSymbolicLink())
+            throw new Error('The saved repository path is not a regular directory.');
+        const root = await fs.realpath(target);
+        if (await fs.realpath(await this.git(['-C', root, 'rev-parse', '--show-toplevel'], signal)) !== root)
+            throw new Error('The saved checkout does not belong to this repository.');
+        const origin = await this.git(['-C', root, 'remote', 'get-url', 'origin'], signal);
+        if (repositoryFromRemote(origin)?.toLowerCase() !== repository.toLowerCase())
+            throw new Error('The saved checkout origin changed. Its files were preserved.');
+        return root;
+    }
+    async open(target, from = process.cwd(), signal, progress = () => { }) {
+        signal?.throwIfAborted();
+        if (!isRemoteSource(target)) {
+            const folder = target.replace(/^~(?=\/|$)/, os.homedir());
+            const root = await fs.realpath(path.resolve(from, folder));
+            if (!(await fs.stat(root)).isDirectory())
+                throw new Error('Choose a repository folder or GitHub URL.');
+            signal?.throwIfAborted();
+            return { root, reused: false };
+        }
+        const source = githubSource(target), destination = this.target(source.repository);
+        const existing = await fs.lstat(destination).then(() => true).catch(e => { if (e.code !== 'ENOENT')
+            throw e; return false; });
+        if (existing) {
+            const root = await this.verify(destination, source.repository, signal);
+            progress(`Using saved checkout of ${source.repository}. Use /pull to fetch the latest changes.`);
+            return { root, sourceUrl: source.url, reused: true };
+        }
+        await fs.mkdir(this.directory, { recursive: true, mode: 0o700 });
+        const staging = await fs.mkdtemp(path.join(this.directory, '.clone-'));
+        const hooks = path.join(staging, 'empty-hooks'), checkout = path.join(staging, 'checkout');
+        await fs.mkdir(hooks, { mode: 0o700 });
+        try {
+            progress(`Cloning ${source.repository}… Ctrl-C to stop.`);
+            await this.git(['clone', '--filter=blob:none', '--single-branch', '--', source.gitUrl, checkout], signal, hooks);
+            signal?.throwIfAborted();
+            await this.verify(checkout, source.repository, signal);
+            await fs.chmod(checkout, 0o700);
+            try {
+                await fs.rename(checkout, destination);
+            }
+            catch (e) {
+                // Two chats may clone the same URL concurrently. Reuse the complete
+                // winner, preserving it rather than replacing its existing contents.
+                if (!['EEXIST', 'ENOTEMPTY'].includes(e.code || ''))
+                    throw e;
+            }
+            const root = await this.verify(destination, source.repository, signal);
+            progress(`Ready: ${source.repository}\nSaved checkout: ${root}\nAsk a question, or use /map to explore.`);
+            return { root, sourceUrl: source.url, reused: false };
+        }
+        finally {
+            await fs.rm(staging, { recursive: true, force: true });
+        }
+    }
+    async pull(root, signal, progress = () => { }) {
+        const origin = await this.git(['-C', root, 'remote', 'get-url', 'origin'], signal);
+        const repository = repositoryFromRemote(origin);
+        if (!repository || await fs.realpath(this.target(repository)).catch(() => null) !== root)
+            throw new Error('/pull updates a saved GitHub checkout. Open one with /repo <GitHub URL> first.');
+        await this.verify(root, repository, signal);
+        if (await this.git(['-C', root, 'status', '--porcelain', '--untracked-files=all'], signal))
+            throw new Error('The checkout has local changes. Preserve or commit them before /pull.');
+        const hooks = path.join(this.directory, '.pull-hooks-' + randomUUID());
+        await fs.mkdir(hooks, { mode: 0o700 });
+        try {
+            progress(`Pulling latest changes for ${repository}…`);
+            const result = await this.git(['-C', root, 'pull', '--ff-only', '--no-rebase'], signal, hooks);
+            return result || 'Repository is up to date.';
+        }
+        finally {
+            await fs.rm(hooks, { recursive: true, force: true });
+        }
+    }
+}
+//# sourceMappingURL=source.js.map

package/cli/chat/source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source.js","sourceRoot":"","sources":["../../src/cli/chat/source.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAIjD,MAAM,UAAU,cAAc,CAAC,KAAa,IAAa,OAAO,iCAAiC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAChH,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,EAAE,EAAE,UAAU,GAAG,oBAAoB,CAAC,GAAG,CAAC,CAAC;IACjE,IAAI,CAAC,UAAU;QAAE,MAAM,IAAI,KAAK,CAAC,gGAAgG,CAAC,CAAC;IACnI,MAAM,GAAG,GAAG,sBAAsB,UAAU,EAAE,CAAC;IAC/C,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,kBAAkB,UAAU,MAAM,CAAC;IACxF,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC;AACrC,CAAC;AAED,qFAAqF;AACrF,MAAM,OAAO,WAAW;IACD,IAAI;IAAwB,OAAO;IAAxD,YAAqB,IAAI,GAAG,SAAS,EAAE,EAAU,OAAO,GAAkB,EAAE;oBAAvD,IAAI;uBAAwB,OAAO;IAAuB,CAAC;IAChF,IAAI,SAAS,KAAK,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC;IACxD,MAAM,CAAC,UAAkB;QAC/B,MAAM,GAAG,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC;QACrC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;IACxI,CAAC;IACO,KAAK,CAAC,GAAG,CAAC,IAAc,EAAE,MAAoB,EAAE,KAAc;QACpE,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;QAC5C,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,UAAU,CAAC,CAAC,KAAK,EAAE;YAC/D,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,kBAAkB,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,yBAAyB,EAAE,GAAG,IAAI;SAC9F,EAAE,EAAE,GAAG,EAAE,EAAE,GAAG,GAAG,EAAE,mBAAmB,EAAE,GAAG,EAAE,eAAe,EAAE,GAAG,CAAC,eAAe,IAAI,qBAAqB,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,GAAG,IAAI,EAAE,CAAC,CAAC;QACnK,IAAI,MAAM,CAAC,IAAI,KAAK,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,yCAAyC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,kBAAkB,GAAG,MAAM,CAAC,IAAI,+DAA+D,CAAC,CAAC;QACtN,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IAC9B,CAAC;IACO,KAAK,CAAC,MAAM,CAAC,MAAc,EAAE,UAAkB,EAAE,MAAoB;QAC3E,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACpC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,IAAI,CAAC,cAAc,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;QAC3H,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QACvC,IAAI,MAAM,EAAE,CAAC,QAAQ,CAAC,MAAM,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,iBAAiB,CAAC,EAAE,MAAM,CAAC,CAAC,KAAK,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;QAChL,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,CAAC;QACnF,IAAI,oBAAoB,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,KAAK,UAAU,CAAC,WAAW,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;QAC9J,OAAO,IAAI,CAAC;IACd,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,MAAc,EAAE,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE,EAAE,MAAoB,EAAE,QAAQ,GAA2B,GAAG,EAAE,GAAE,CAAC;QAChH,MAAM,EAAE,cAAc,EAAE,CAAC;QACzB,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC;YAC5B,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;YAC1D,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;YAC3D,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,EAAE;gBAAE,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;YACvG,MAAM,EAAE,cAAc,EAAE,CAAC;YACzB,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;QACjC,CAAC;QACD,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAClF,MAAM,QAAQ,GAAG,MAAM,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ;YAAE,MAAM,CAAC,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAC9H,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;YACvE,QAAQ,CAAC,2BAA2B,MAAM,CAAC,UAAU,0CAA0C,CAAC,CAAC;YACjG,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;QACvD,CAAC;QACD,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QACjE,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC;QACvE,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;QAC3F,MAAM,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QACvC,IAAI,CAAC;YACH,QAAQ,CAAC,WAAW,MAAM,CAAC,UAAU,mBAAmB,CAAC,CAAC;YAC1D,MAAM,IAAI,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;YACjH,MAAM,EAAE,cAAc,EAAE,CAAC;YACzB,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;YACvD,MAAM,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;YAChC,IAAI,CAAC;gBAAC,MAAM,EAAE,CAAC,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;YAAC,CAAC;YAC/C,OAAO,CAAC,EAAE,CAAC;gBACT,oEAAoE;gBACpE,qEAAqE;gBACrE,IAAI,CAAC,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAE,CAA2B,CAAC,IAAI,IAAI,EAAE,CAAC;oBAAE,MAAM,CAAC,CAAC;YAC1F,CAAC;YACD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;YACvE,QAAQ,CAAC,UAAU,MAAM,CAAC,UAAU,qBAAqB,IAAI,2CAA2C,CAAC,CAAC;YAC1G,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;QACxD,CAAC;gBAAS,CAAC;YAAC,MAAM,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAAC,CAAC;IACvE,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,IAAY,EAAE,MAAoB,EAAE,QAAQ,GAA2B,GAAG,EAAE,GAAE,CAAC;QACxF,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,CAAC;QACnF,MAAM,UAAU,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAAC;QAChD,IAAI,CAAC,UAAU,IAAI,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,gFAAgF,CAAC,CAAC;QAC5L,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;QAC5C,IAAI,MAAM,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,aAAa,EAAE,uBAAuB,CAAC,EAAE,MAAM,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,uEAAuE,CAAC,CAAC;QACrL,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,cAAc,GAAG,UAAU,EAAE,CAAC,CAAC;QACvE,MAAM,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QACvC,IAAI,CAAC;YACH,QAAQ,CAAC,8BAA8B,UAAU,GAAG,CAAC,CAAC;YACtD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,aAAa,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;YAC/F,OAAO,MAAM,IAAI,2BAA2B,CAAC;QAC/C,CAAC;gBAAS,CAAC;YAAC,MAAM,EAAE,CAAC,EAAE,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAAC,CAAC;IACrE,CAAC;CACF","sourcesContent":["import { promises as fs } from 'node:fs';\nimport path from 'node:path';\nimport os from 'node:os';\nimport { createHash, randomUUID } from 'node:crypto';\nimport { agentHome } from '../agent/config.js';\nimport { repositoryFromRemote } from '../agent/github.js';\nimport { runProcess } from '../agent/process.js';\n\nexport interface ChatSource { root: string; sourceUrl?: string; reused: boolean }\ninterface SourceOptions { env?: NodeJS.ProcessEnv; execute?: typeof runProcess }\nexport function isRemoteSource(value: string): boolean { return /^(?:https?:\\/\\/|ssh:\\/\\/|git@)/i.test(value); }\nexport function githubSource(value: string): { repository: string; url: string; gitUrl: string } {\n  const raw = value.trim(), repository = repositoryFromRemote(raw);\n  if (!repository) throw new Error('Enter a GitHub repository URL: https://github.com/owner/repo or git@github.com:owner/repo.git.');\n  const url = `https://github.com/${repository}`;\n  const gitUrl = /^https:/i.test(raw) ? url + '.git' : `git@github.com:${repository}.git`;\n  return { repository, url, gitUrl };\n}\n\n/** Persistent checkouts keep conversations and agent worktrees usable after exit. */\nexport class ChatSources {\n  constructor(readonly home = agentHome(), private options: SourceOptions = {}) {}\n  get directory() { return path.join(this.home, 'repositories'); }\n  private target(repository: string) {\n    const key = repository.toLowerCase();\n    return path.join(this.directory, key.split('/')[1]!.slice(0, 40) + '-' + createHash('sha256').update(key).digest('hex').slice(0, 16));\n  }\n  private async git(args: string[], signal?: AbortSignal, hooks?: string) {\n    const env = this.options.env || process.env;\n    const result = await (this.options.execute || runProcess)('git', [\n      ...(hooks ? ['-c', `core.hooksPath=${hooks}`] : []), '-c', 'submodule.recurse=false', ...args,\n    ], { env: { ...env, GIT_TERMINAL_PROMPT: '0', GIT_SSH_COMMAND: env.GIT_SSH_COMMAND || 'ssh -oBatchMode=yes' }, signal, timeoutMs: 180000, maxBytes: 1024 * 1024 });\n    if (result.code !== 0) throw new Error(`Could not open/update the repository. ${result.stderr.trim().slice(-1200) || 'Git exited with ' + result.code}. Private repositories require your existing Git credentials.`);\n    return result.stdout.trim();\n  }\n  private async verify(target: string, repository: string, signal?: AbortSignal) {\n    const stat = await fs.lstat(target);\n    if (!stat.isDirectory() || stat.isSymbolicLink()) throw new Error('The saved repository path is not a regular directory.');\n    const root = await fs.realpath(target);\n    if (await fs.realpath(await this.git(['-C', root, 'rev-parse', '--show-toplevel'], signal)) !== root) throw new Error('The saved checkout does not belong to this repository.');\n    const origin = await this.git(['-C', root, 'remote', 'get-url', 'origin'], signal);\n    if (repositoryFromRemote(origin)?.toLowerCase() !== repository.toLowerCase()) throw new Error('The saved checkout origin changed. Its files were preserved.');\n    return root;\n  }\n  async open(target: string, from = process.cwd(), signal?: AbortSignal, progress: (text: string) => void = () => {}): Promise<ChatSource> {\n    signal?.throwIfAborted();\n    if (!isRemoteSource(target)) {\n      const folder = target.replace(/^~(?=\\/|$)/, os.homedir());\n      const root = await fs.realpath(path.resolve(from, folder));\n      if (!(await fs.stat(root)).isDirectory()) throw new Error('Choose a repository folder or GitHub URL.');\n      signal?.throwIfAborted();\n      return { root, reused: false };\n    }\n    const source = githubSource(target), destination = this.target(source.repository);\n    const existing = await fs.lstat(destination).then(() => true).catch(e => { if (e.code !== 'ENOENT') throw e; return false; });\n    if (existing) {\n      const root = await this.verify(destination, source.repository, signal);\n      progress(`Using saved checkout of ${source.repository}. Use /pull to fetch the latest changes.`);\n      return { root, sourceUrl: source.url, reused: true };\n    }\n    await fs.mkdir(this.directory, { recursive: true, mode: 0o700 });\n    const staging = await fs.mkdtemp(path.join(this.directory, '.clone-'));\n    const hooks = path.join(staging, 'empty-hooks'), checkout = path.join(staging, 'checkout');\n    await fs.mkdir(hooks, { mode: 0o700 });\n    try {\n      progress(`Cloning ${source.repository}… Ctrl-C to stop.`);\n      await this.git(['clone', '--filter=blob:none', '--single-branch', '--', source.gitUrl, checkout], signal, hooks);\n      signal?.throwIfAborted();\n      await this.verify(checkout, source.repository, signal);\n      await fs.chmod(checkout, 0o700);\n      try { await fs.rename(checkout, destination); }\n      catch (e) {\n        // Two chats may clone the same URL concurrently. Reuse the complete\n        // winner, preserving it rather than replacing its existing contents.\n        if (!['EEXIST', 'ENOTEMPTY'].includes((e as NodeJS.ErrnoException).code || '')) throw e;\n      }\n      const root = await this.verify(destination, source.repository, signal);\n      progress(`Ready: ${source.repository}\\nSaved checkout: ${root}\\nAsk a question, or use /map to explore.`);\n      return { root, sourceUrl: source.url, reused: false };\n    } finally { await fs.rm(staging, { recursive: true, force: true }); }\n  }\n  async pull(root: string, signal?: AbortSignal, progress: (text: string) => void = () => {}) {\n    const origin = await this.git(['-C', root, 'remote', 'get-url', 'origin'], signal);\n    const repository = repositoryFromRemote(origin);\n    if (!repository || await fs.realpath(this.target(repository)).catch(() => null) !== root) throw new Error('/pull updates a saved GitHub checkout. Open one with /repo <GitHub URL> first.');\n    await this.verify(root, repository, signal);\n    if (await this.git(['-C', root, 'status', '--porcelain', '--untracked-files=all'], signal)) throw new Error('The checkout has local changes. Preserve or commit them before /pull.');\n    const hooks = path.join(this.directory, '.pull-hooks-' + randomUUID());\n    await fs.mkdir(hooks, { mode: 0o700 });\n    try {\n      progress(`Pulling latest changes for ${repository}…`);\n      const result = await this.git(['-C', root, 'pull', '--ff-only', '--no-rebase'], signal, hooks);\n      return result || 'Repository is up to date.';\n    } finally { await fs.rm(hooks, { recursive: true, force: true }); }\n  }\n}\n"]}

package/cli/chat/store.d.ts

@@ -0,0 +1,43 @@
+import { type AgentMode, type AgentResult } from '../agent/contracts.js';
+export interface ChatSettings {
+    root: string;
+    sourceUrl?: string;
+    mode: AgentMode;
+    model?: string;
+    provider?: string;
+    checks: boolean;
+    github: boolean;
+    timeout: number;
+    maxTurns: number;
+    pr?: number;
+    issue?: number;
+    base?: string;
+}
+export interface ChatTurn {
+    at: string;
+    prompt: string;
+    answer: string;
+    run: string;
+    status: AgentResult['status'];
+}
+export interface ChatRecord {
+    schemaVersion: 1;
+    id: string;
+    createdAt: string;
+    updatedAt: string;
+    settings: ChatSettings;
+    lastRun: string | null;
+    turns: ChatTurn[];
+}
+export declare function newChat(settings: ChatSettings): ChatRecord;
+export declare class ChatStore {
+    readonly home: string;
+    private env;
+    constructor(home?: string, env?: NodeJS.ProcessEnv);
+    get directory(): string;
+    save(record: ChatRecord): Promise<void>;
+    load(id: string): Promise<ChatRecord>;
+    list(root: string): Promise<ChatRecord[]>;
+    export(record: ChatRecord): Promise<string>;
+}
+export declare function historySummary(records: ChatRecord[]): string;

package/cli/chat/store.js

@@ -0,0 +1,94 @@
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { randomUUID } from 'node:crypto';
+import { AGENT_MODES } from '../agent/contracts.js';
+import { agentHome } from '../agent/config.js';
+import { runId } from '../agent/runner.js';
+import { redact, terminalText } from '../agent/process.js';
+import { repositoryFromRemote } from '../agent/github.js';
+export function newChat(settings) {
+    const now = new Date().toISOString();
+    return { schemaVersion: 1, id: randomUUID(), createdAt: now, updatedAt: now, settings: { ...settings }, lastRun: null, turns: [] };
+}
+function validSettings(s) {
+    return !!s && typeof s.root === 'string' && path.isAbsolute(s.root) && AGENT_MODES.includes(s.mode) &&
+        typeof s.checks === 'boolean' && typeof s.github === 'boolean' && Number.isInteger(s.timeout) && s.timeout >= 15 && s.timeout <= 3600 &&
+        Number.isInteger(s.maxTurns) && s.maxTurns >= 1 && s.maxTurns <= 100 &&
+        [s.model, s.provider, s.base].every(v => v === undefined || typeof v === 'string' && v.length <= 512) &&
+        [s.pr, s.issue].every(v => v === undefined || Number.isSafeInteger(v) && v > 0) &&
+        (s.sourceUrl === undefined || typeof s.sourceUrl === 'string' && repositoryFromRemote(s.sourceUrl) !== null);
+}
+export class ChatStore {
+    home;
+    env;
+    constructor(home = agentHome(), env = process.env) {
+        this.home = home;
+        this.env = env;
+    }
+    get directory() { return path.join(this.home, 'chats'); }
+    async save(record) {
+        await fs.mkdir(this.directory, { recursive: true, mode: 0o700 });
+        const target = path.join(this.directory, runId(record.id) + '.json'), temp = target + '.' + randomUUID() + '.tmp';
+        const safe = { ...record, turns: record.turns.slice(-100).map(t => ({ ...t, prompt: redact(t.prompt, this.env), answer: redact(t.answer, this.env).slice(0, 32000) })) };
+        let encoded = JSON.stringify(safe, null, 2) + '\n';
+        // UTF-8 transcripts can use several bytes per character. Bound the stored
+        // bytes, rather than producing a conversation our own loader cannot read.
+        while (Buffer.byteLength(encoded) > 5 * 1024 * 1024 && safe.turns.length > 1) {
+            safe.turns.shift();
+            encoded = JSON.stringify(safe, null, 2) + '\n';
+        }
+        try {
+            await fs.writeFile(temp, encoded, { mode: 0o600, flag: 'wx' });
+            await fs.rename(temp, target);
+        }
+        finally {
+            await fs.rm(temp, { force: true });
+        }
+    }
+    async load(id) {
+        const file = path.join(this.directory, runId(id) + '.json');
+        if ((await fs.stat(file)).size > 6 * 1024 * 1024)
+            throw new Error('The saved conversation exceeds the size limit.');
+        const record = JSON.parse(await fs.readFile(file, 'utf8'));
+        if (record.schemaVersion !== 1 || record.id !== id || !validSettings(record.settings) ||
+            typeof record.createdAt !== 'string' || typeof record.updatedAt !== 'string' || !Array.isArray(record.turns) || record.turns.length > 100 ||
+            !(record.lastRun === null || typeof record.lastRun === 'string') || record.turns.some(t => !t || typeof t.at !== 'string' ||
+            typeof t.prompt !== 'string' || t.prompt.length > 16000 || typeof t.answer !== 'string' || t.answer.length > 32000 ||
+            typeof t.run !== 'string' || !['completed', 'failed', 'cancelled'].includes(t.status)))
+            throw new Error('The saved conversation is invalid.');
+        if (record.lastRun)
+            runId(record.lastRun);
+        for (const turn of record.turns)
+            runId(turn.run);
+        return record;
+    }
+    async list(root) {
+        const entries = await fs.readdir(this.directory, { withFileTypes: true }).catch(e => { if (e.code !== 'ENOENT')
+            throw e; return []; });
+        const records = [];
+        for (const entry of entries) {
+            if (!entry.isFile() || !/^[a-f\d-]{36}\.json$/i.test(entry.name))
+                continue;
+            try {
+                const record = await this.load(entry.name.slice(0, -5));
+                if (record.settings.root === root)
+                    records.push(record);
+            }
+            catch { /* A damaged entry must not hide the others. */ }
+        }
+        return records.sort((a, b) => b.updatedAt.localeCompare(a.updatedAt)).slice(0, 30);
+    }
+    async export(record) {
+        const directory = path.join(this.home, 'exports');
+        await fs.mkdir(directory, { recursive: true, mode: 0o700 });
+        const file = path.join(directory, record.id + '-' + randomUUID().slice(0, 8) + '.md');
+        const text = ['# Onboarder conversation', '', `Repository: ${record.settings.sourceUrl || record.settings.root}`, `Conversation: ${record.id}`, '',
+            ...record.turns.flatMap(turn => ['## You', '', turn.prompt, '', `## Hermes (${turn.status})`, '', turn.answer, '', `Run: ${turn.run}`, ''])].join('\n');
+        await fs.writeFile(file, redact(text, this.env), { flag: 'wx', mode: 0o600 });
+        return file;
+    }
+}
+export function historySummary(records) {
+    return records.length ? records.map(r => `${r.id}  ${r.settings.mode}  ${r.turns.length} turns\n  ${r.updatedAt}  ${terminalText(r.turns[0]?.prompt || 'Empty conversation').replace(/\s+/g, ' ').slice(0, 100)}`).join('\n\n') : 'No saved conversations for this repository yet.';
+}
+//# sourceMappingURL=store.js.map

package/cli/chat/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../src/cli/chat/store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,WAAW,EAAoC,MAAM,uBAAuB,CAAC;AACtF,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAW1D,MAAM,UAAU,OAAO,CAAC,QAAsB;IAC5C,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrC,OAAO,EAAE,aAAa,EAAE,CAAC,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,EAAE,QAAQ,EAAE,EAAE,GAAG,QAAQ,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;AACrI,CAAC;AACD,SAAS,aAAa,CAAC,CAAe;IACpC,OAAO,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC;QACjG,OAAO,CAAC,CAAC,MAAM,KAAK,SAAS,IAAI,OAAO,CAAC,CAAC,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,IAAI,EAAE,IAAI,CAAC,CAAC,OAAO,IAAI,IAAI;QACrI,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,CAAC,QAAQ,IAAI,GAAG;QACpE,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,SAAS,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,IAAI,GAAG,CAAC;QACrG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,SAAS,IAAI,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC/E,CAAC,CAAC,CAAC,SAAS,KAAK,SAAS,IAAI,OAAO,CAAC,CAAC,SAAS,KAAK,QAAQ,IAAI,oBAAoB,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,IAAI,CAAC,CAAC;AACjH,CAAC;AACD,MAAM,OAAO,SAAS;IACC,IAAI;IAAwB,GAAG;IAApD,YAAqB,IAAI,GAAG,SAAS,EAAE,EAAU,GAAG,GAAsB,OAAO,CAAC,GAAG;oBAAhE,IAAI;mBAAwB,GAAG;IAAoC,CAAC;IACzF,IAAI,SAAS,KAAK,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IACzD,KAAK,CAAC,IAAI,CAAC,MAAkB;QAC3B,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QACjE,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,GAAG,GAAG,UAAU,EAAE,GAAG,MAAM,CAAC;QAClH,MAAM,IAAI,GAAG,EAAE,GAAG,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;QACzK,IAAI,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC;QACnD,0EAA0E;QAC1E,0EAA0E;QAC1E,OAAO,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7E,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;YAAC,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC;QACrE,CAAC;QACD,IAAI,CAAC;YAAC,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YAAC,MAAM,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAAC,CAAC;gBAC9F,CAAC;YAAC,MAAM,EAAE,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAAC,CAAC;IACjD,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,EAAU;QACnB,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC;QAC5D,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;QACpH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAe,CAAC;QACzE,IAAI,MAAM,CAAC,aAAa,KAAK,CAAC,IAAI,MAAM,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,QAAQ,CAAC;YACnF,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ,IAAI,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,GAAG;YACzI,CAAC,CAAC,MAAM,CAAC,OAAO,KAAK,IAAI,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,EAAE,KAAK,QAAQ;YACvH,OAAO,CAAC,CAAC,MAAM,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,CAAC,MAAM,GAAG,KAAK,IAAI,OAAO,CAAC,CAAC,MAAM,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,CAAC,MAAM,GAAG,KAAK;YAClH,OAAO,CAAC,CAAC,GAAG,KAAK,QAAQ,IAAI,CAAC,CAAC,WAAW,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;QAClJ,IAAI,MAAM,CAAC,OAAO;YAAE,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC1C,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK;YAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACjD,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,IAAY;QACrB,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ;YAAE,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QACvI,MAAM,OAAO,GAAiB,EAAE,CAAC;QACjC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,uBAAuB,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;gBAAE,SAAS;YAC3E,IAAI,CAAC;gBAAC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;gBAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,KAAK,IAAI;oBAAE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC,CAAC,+CAA+C,CAAC,CAAC;QACrL,CAAC;QACD,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACrF,CAAC;IACD,KAAK,CAAC,MAAM,CAAC,MAAkB;QAC7B,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QAAC,MAAM,EAAE,CAAC,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QAC/G,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,EAAE,GAAG,GAAG,GAAG,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC;QACtF,MAAM,IAAI,GAAG,CAAC,0BAA0B,EAAE,EAAE,EAAE,eAAe,MAAM,CAAC,QAAQ,CAAC,SAAS,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,iBAAiB,MAAM,CAAC,EAAE,EAAE,EAAE,EAAE;YAChJ,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,EAAE,EAAE,IAAI,CAAC,MAAM,EAAE,EAAE,EAAE,cAAc,IAAI,CAAC,MAAM,GAAG,EAAE,EAAE,EAAE,IAAI,CAAC,MAAM,EAAE,EAAE,EAAE,QAAQ,IAAI,CAAC,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1J,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QAAC,OAAO,IAAI,CAAC;IAC7F,CAAC;CACF;AACD,MAAM,UAAU,cAAc,CAAC,OAAqB;IAClD,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC,CAAC,KAAK,CAAC,MAAM,aAAa,CAAC,CAAC,SAAS,KAAK,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,MAAM,IAAI,oBAAoB,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,iDAAiD,CAAC;AACtR,CAAC","sourcesContent":["import { promises as fs } from 'node:fs';\nimport path from 'node:path';\nimport { randomUUID } from 'node:crypto';\nimport { AGENT_MODES, type AgentMode, type AgentResult } from '../agent/contracts.js';\nimport { agentHome } from '../agent/config.js';\nimport { runId } from '../agent/runner.js';\nimport { redact, terminalText } from '../agent/process.js';\nimport { repositoryFromRemote } from '../agent/github.js';\n\nexport interface ChatSettings {\n  root: string; sourceUrl?: string; mode: AgentMode; model?: string; provider?: string;\n  checks: boolean; github: boolean; timeout: number; maxTurns: number; pr?: number; issue?: number; base?: string;\n}\nexport interface ChatTurn { at: string; prompt: string; answer: string; run: string; status: AgentResult['status'] }\nexport interface ChatRecord {\n  schemaVersion: 1; id: string; createdAt: string; updatedAt: string;\n  settings: ChatSettings; lastRun: string | null; turns: ChatTurn[];\n}\nexport function newChat(settings: ChatSettings): ChatRecord {\n  const now = new Date().toISOString();\n  return { schemaVersion: 1, id: randomUUID(), createdAt: now, updatedAt: now, settings: { ...settings }, lastRun: null, turns: [] };\n}\nfunction validSettings(s: ChatSettings): boolean {\n  return !!s && typeof s.root === 'string' && path.isAbsolute(s.root) && AGENT_MODES.includes(s.mode) &&\n    typeof s.checks === 'boolean' && typeof s.github === 'boolean' && Number.isInteger(s.timeout) && s.timeout >= 15 && s.timeout <= 3600 &&\n    Number.isInteger(s.maxTurns) && s.maxTurns >= 1 && s.maxTurns <= 100 &&\n    [s.model, s.provider, s.base].every(v => v === undefined || typeof v === 'string' && v.length <= 512) &&\n    [s.pr, s.issue].every(v => v === undefined || Number.isSafeInteger(v) && v > 0) &&\n    (s.sourceUrl === undefined || typeof s.sourceUrl === 'string' && repositoryFromRemote(s.sourceUrl) !== null);\n}\nexport class ChatStore {\n  constructor(readonly home = agentHome(), private env: NodeJS.ProcessEnv = process.env) {}\n  get directory() { return path.join(this.home, 'chats'); }\n  async save(record: ChatRecord) {\n    await fs.mkdir(this.directory, { recursive: true, mode: 0o700 });\n    const target = path.join(this.directory, runId(record.id) + '.json'), temp = target + '.' + randomUUID() + '.tmp';\n    const safe = { ...record, turns: record.turns.slice(-100).map(t => ({ ...t, prompt: redact(t.prompt, this.env), answer: redact(t.answer, this.env).slice(0, 32000) })) };\n    let encoded = JSON.stringify(safe, null, 2) + '\\n';\n    // UTF-8 transcripts can use several bytes per character. Bound the stored\n    // bytes, rather than producing a conversation our own loader cannot read.\n    while (Buffer.byteLength(encoded) > 5 * 1024 * 1024 && safe.turns.length > 1) {\n      safe.turns.shift(); encoded = JSON.stringify(safe, null, 2) + '\\n';\n    }\n    try { await fs.writeFile(temp, encoded, { mode: 0o600, flag: 'wx' }); await fs.rename(temp, target); }\n    finally { await fs.rm(temp, { force: true }); }\n  }\n  async load(id: string): Promise<ChatRecord> {\n    const file = path.join(this.directory, runId(id) + '.json');\n    if ((await fs.stat(file)).size > 6 * 1024 * 1024) throw new Error('The saved conversation exceeds the size limit.');\n    const record = JSON.parse(await fs.readFile(file, 'utf8')) as ChatRecord;\n    if (record.schemaVersion !== 1 || record.id !== id || !validSettings(record.settings) ||\n      typeof record.createdAt !== 'string' || typeof record.updatedAt !== 'string' || !Array.isArray(record.turns) || record.turns.length > 100 ||\n      !(record.lastRun === null || typeof record.lastRun === 'string') || record.turns.some(t => !t || typeof t.at !== 'string' ||\n        typeof t.prompt !== 'string' || t.prompt.length > 16000 || typeof t.answer !== 'string' || t.answer.length > 32000 ||\n        typeof t.run !== 'string' || !['completed', 'failed', 'cancelled'].includes(t.status))) throw new Error('The saved conversation is invalid.');\n    if (record.lastRun) runId(record.lastRun);\n    for (const turn of record.turns) runId(turn.run);\n    return record;\n  }\n  async list(root: string): Promise<ChatRecord[]> {\n    const entries = await fs.readdir(this.directory, { withFileTypes: true }).catch(e => { if (e.code !== 'ENOENT') throw e; return []; });\n    const records: ChatRecord[] = [];\n    for (const entry of entries) {\n      if (!entry.isFile() || !/^[a-f\\d-]{36}\\.json$/i.test(entry.name)) continue;\n      try { const record = await this.load(entry.name.slice(0, -5)); if (record.settings.root === root) records.push(record); } catch { /* A damaged entry must not hide the others. */ }\n    }\n    return records.sort((a, b) => b.updatedAt.localeCompare(a.updatedAt)).slice(0, 30);\n  }\n  async export(record: ChatRecord): Promise<string> {\n    const directory = path.join(this.home, 'exports'); await fs.mkdir(directory, { recursive: true, mode: 0o700 });\n    const file = path.join(directory, record.id + '-' + randomUUID().slice(0, 8) + '.md');\n    const text = ['# Onboarder conversation', '', `Repository: ${record.settings.sourceUrl || record.settings.root}`, `Conversation: ${record.id}`, '',\n      ...record.turns.flatMap(turn => ['## You', '', turn.prompt, '', `## Hermes (${turn.status})`, '', turn.answer, '', `Run: ${turn.run}`, ''])].join('\\n');\n    await fs.writeFile(file, redact(text, this.env), { flag: 'wx', mode: 0o600 }); return file;\n  }\n}\nexport function historySummary(records: ChatRecord[]): string {\n  return records.length ? records.map(r => `${r.id}  ${r.settings.mode}  ${r.turns.length} turns\\n  ${r.updatedAt}  ${terminalText(r.turns[0]?.prompt || 'Empty conversation').replace(/\\s+/g, ' ').slice(0, 100)}`).join('\\n\\n') : 'No saved conversations for this repository yet.';\n}\n"]}

package/cli/chat/text.d.ts

@@ -0,0 +1,4 @@
+export declare function graphemes(value: string): string[];
+export declare function clusterCells(cluster: string): number;
+export declare function cells(value: string): number;
+export declare function clip(value: string, room: number, ellipsis?: boolean): string;

package/cli/chat/text.js

@@ -0,0 +1,27 @@
+import { terminalText } from '../agent/process.js';
+const segmenter = new Intl.Segmenter(undefined, { granularity: 'grapheme' });
+export function graphemes(value) { return [...segmenter.segment(value)].map(s => s.segment); }
+export function clusterCells(cluster) {
+    if (/^[\p{Mark}\u200d\ufe0f]+$/u.test(cluster))
+        return 0;
+    return /\p{Extended_Pictographic}|[\u1100-\u115f\u2329\u232a\u2e80-\ua4cf\uac00-\ud7a3\uf900-\ufaff\ufe10-\ufe19\ufe30-\ufe6f\uff01-\uff60\uffe0-\uffe6\u{1f1e6}-\u{1f1ff}]/u.test(cluster) ? 2 : 1;
+}
+export function cells(value) {
+    return graphemes(terminalText(value)).reduce((total, cluster) => total + clusterCells(cluster), 0);
+}
+export function clip(value, room, ellipsis = true) {
+    const safe = terminalText(value).replace(/[\r\n\t]/g, ' ');
+    if (cells(safe) <= room)
+        return safe;
+    const limit = Math.max(0, room - (ellipsis && room > 0 ? 1 : 0));
+    let result = '', used = 0;
+    for (const g of graphemes(safe)) {
+        const size = clusterCells(g);
+        if (used + size > limit)
+            break;
+        result += g;
+        used += size;
+    }
+    return result + (ellipsis && room > 0 ? '…' : '');
+}
+//# sourceMappingURL=text.js.map

package/cli/chat/text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.js","sourceRoot":"","sources":["../../src/cli/chat/text.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC,CAAC;AAC7E,MAAM,UAAU,SAAS,CAAC,KAAa,IAAc,OAAO,CAAC,GAAG,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AAChH,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,IAAI,4BAA4B,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,CAAC,CAAC;IACzD,OAAO,sKAAsK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACtM,CAAC;AACD,MAAM,UAAU,KAAK,CAAC,KAAa;IACjC,OAAO,SAAS,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,KAAK,GAAG,YAAY,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC;AACrG,CAAC;AACD,MAAM,UAAU,IAAI,CAAC,KAAa,EAAE,IAAY,EAAE,QAAQ,GAAG,IAAI;IAC/D,MAAM,IAAI,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;IAC3D,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI;QAAE,OAAO,IAAI,CAAC;IACrC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,GAAG,CAAC,QAAQ,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACjE,IAAI,MAAM,GAAG,EAAE,EAAE,IAAI,GAAG,CAAC,CAAC;IAC1B,KAAK,MAAM,CAAC,IAAI,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;QAAC,MAAM,IAAI,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;QAAC,IAAI,IAAI,GAAG,IAAI,GAAG,KAAK;YAAE,MAAM;QAAC,MAAM,IAAI,CAAC,CAAC;QAAC,IAAI,IAAI,IAAI,CAAC;IAAC,CAAC;IAC7H,OAAO,MAAM,GAAG,CAAC,QAAQ,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AACpD,CAAC","sourcesContent":["import { terminalText } from '../agent/process.js';\n\nconst segmenter = new Intl.Segmenter(undefined, { granularity: 'grapheme' });\nexport function graphemes(value: string): string[] { return [...segmenter.segment(value)].map(s => s.segment); }\nexport function clusterCells(cluster: string): number {\n  if (/^[\\p{Mark}\\u200d\\ufe0f]+$/u.test(cluster)) return 0;\n  return /\\p{Extended_Pictographic}|[\\u1100-\\u115f\\u2329\\u232a\\u2e80-\\ua4cf\\uac00-\\ud7a3\\uf900-\\ufaff\\ufe10-\\ufe19\\ufe30-\\ufe6f\\uff01-\\uff60\\uffe0-\\uffe6\\u{1f1e6}-\\u{1f1ff}]/u.test(cluster) ? 2 : 1;\n}\nexport function cells(value: string): number {\n  return graphemes(terminalText(value)).reduce((total, cluster) => total + clusterCells(cluster), 0);\n}\nexport function clip(value: string, room: number, ellipsis = true): string {\n  const safe = terminalText(value).replace(/[\\r\\n\\t]/g, ' ');\n  if (cells(safe) <= room) return safe;\n  const limit = Math.max(0, room - (ellipsis && room > 0 ? 1 : 0));\n  let result = '', used = 0;\n  for (const g of graphemes(safe)) { const size = clusterCells(g); if (used + size > limit) break; result += g; used += size; }\n  return result + (ellipsis && room > 0 ? '…' : '');\n}\n"]}

package/cli/explorer/app.d.ts

@@ -1 +1,2 @@
 export declare function runExplore({ target, flags, out, err, version }?: Record<string, any>): Promise<unknown>;
+export declare function startWeb(ctx: any): Promise<string>;

package/cli/explorer/app.js

@@ -16,6 +16,7 @@ import { scanOptionsFromFlags } from '../scanOptions.js';
 //   * Flags → env → config precedence. `NO_COLOR` and `COLUMNS` are honored
 //     before anything is drawn, so a redirect gets plain, fitted text.
 import readline from 'node:readline';
+import { explorerAgent } from '../agent/command.js';
 import readlinePromises from 'node:readline/promises';
 import fs from 'node:fs';
 import path from 'node:path';
@@ -140,6 +141,7 @@ async function shouldShowHint(flags) {
 // interleaved `cd`s would leave the session pointing at a repo nobody asked
 // for.
 function session({ repo, flags, out, err, version }) {
+    let agentAbort = null;
     const ctx = {
         picker: null,
         repo,
@@ -153,6 +155,17 @@ function session({ repo, flags, out, err, version }) {
             return ctx.picker.view();
         },
         github: () => askGithub(ctx),
+        agent: async (args) => {
+            if (ctx.repo.cloneDir && ['implement', 'pr'].includes(args[0]))
+                throw new Error('Open a persistent local checkout before implementing changes or creating a PR. This explorer clone is removed when the session ends.');
+            agentAbort = new AbortController();
+            try {
+                return await explorerAgent(args, ctx.repo.root, agentAbort.signal, out, err);
+            }
+            finally {
+                agentAbort = null;
+            }
+        },
         web: () => startWeb(ctx),
         diff: async (base = 'HEAD', head = '', file = '') => formatDiff(await getGitDiff(ctx.repo.root, { base, head, file }), ctx.repo.facts.importers || {}, ctx.repo.scan.files.length, file),
         engines: () => formatEngines(toolsStatus()),
@@ -226,6 +239,7 @@ function session({ repo, flags, out, err, version }) {
     // its input is followed immediately by `exit`. The exit waits on the queue.
     rl.on('close', () => {
         closed = true;
+        agentAbort?.abort();
         // The listener is removed on every exit path, including the interval one
         // below, so a session that ends by any route leaves stdout as it found it.
         if (onResize)
@@ -236,6 +250,11 @@ function session({ repo, flags, out, err, version }) {
     rl.on('SIGINT', () => {
         if (closed)
             return;
+        if (agentAbort) {
+            agentAbort.abort();
+            out(dim('\n  Cancelling agent…'));
+            return;
+        }
         if (ctx.picker) {
             ctx.picker = null;
             out(dim('\n  Selection cancelled.'));
@@ -403,7 +422,7 @@ async function askGithub(ctx) {
 // prints where it is; if not, it starts it detached, so the person keeps their
 // session. The URL is the same one `onboarder start` would print, because it
 // comes from the same `serverUrls` the CLI and the banner use.
-async function startWeb(ctx) {
+export async function startWeb(ctx) {
     const file = ctx.flags.config || configPath();
     const settings = await readSettings(file).catch(() => null);
     const urls = serverUrls(settings || undefined);