codebase-onboarder 0.6.0 → 1.0.0

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":"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","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":"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","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/commands.d.ts

@@ -0,0 +1,26 @@
+export declare function runSetup({ flags, out, err, version }?: Record<string, any>): any;
+export declare function serverDetails(started: any, { configFile, pid, mode, logFile }?: Record<string, any>): {
+    rows: {
+        label: string;
+        value: string;
+    }[];
+    urls: import("../shared/contracts.js").ServerUrls;
+    mode: any;
+};
+export declare function watchResize(render: any, stream?: NodeJS.WriteStream & {
+    fd: 1;
+}): (..._args: unknown[]) => void;
+export declare function runStart({ flags, out, err }?: Record<string, any>): any;
+export declare function runStartBackground({ flags, out, err }?: Record<string, any>): any;
+export declare function runStatus({ flags, out }?: Record<string, any>): Promise<number>;
+export declare function humanDuration(ms: any): string;
+export declare function runStop({ flags, out, err }?: Record<string, any>): Promise<0 | 1>;
+export declare function runRestart(options?: Record<string, any>): Promise<any>;
+export declare function runLogs({ flags, out, err }?: Record<string, any>): Promise<0 | 1 | 2>;
+export declare function runStartup(action?: string, { flags, out, err }?: Record<string, any>): Promise<0 | 1>;
+export declare function runConfig(sub: any, args: any, { flags, out }?: Record<string, any>): Promise<number>;
+export declare function runConfigKey(action: any, args: any, { flags, out, err }?: Record<string, any>): Promise<number>;
+export declare function runConfigReset({ flags, out, err }?: Record<string, any>): Promise<0 | 1>;
+export declare function runDoctor({ flags, out }?: Record<string, any>): Promise<0 | 1>;
+export declare function runHttps(action?: string, { flags, out, err }?: Record<string, any>): Promise<0 | 1>;
+export declare function runTunnel(kind: any, { flags, out, err }?: Record<string, any>): Promise<unknown>;