hamster-wheel-cli 0.1.0 → 0.2.0-beta.1

package/src/global-config.ts

@@ -11,6 +11,15 @@ export interface ShortcutConfig {
   readonly command: string;
 }
 
+/**
+ * 全局 alias 配置条目。
+ */
+export interface AliasEntry {
+  readonly name: string;
+  readonly command: string;
+  readonly source: 'alias' | 'shortcut';
+}
+
 /**
  * 全局配置结构。
  */
@@ -140,6 +149,20 @@ function parseTomlString(raw: string): string | null {
   return null;
 }
 
+function parseTomlKeyValue(line: string): { key: string; value: string } | null {
+  const equalIndex = findUnquotedIndex(line, '=');
+  if (equalIndex <= 0) return null;
+
+  const key = line.slice(0, equalIndex).trim();
+  const valuePart = line.slice(equalIndex + 1).trim();
+  if (!key || !valuePart) return null;
+
+  const parsedValue = parseTomlString(valuePart);
+  if (parsedValue === null) return null;
+
+  return { key, value: parsedValue };
+}
+
 function normalizeShortcutName(name: string): string | null {
   const trimmed = name.trim();
   if (!trimmed) return null;
@@ -147,6 +170,81 @@ function normalizeShortcutName(name: string): string | null {
   return trimmed;
 }
 
+/**
+ * 规范化 alias 名称。
+ */
+export function normalizeAliasName(name: string): string | null {
+  return normalizeShortcutName(name);
+}
+
+function formatTomlString(value: string): string {
+  const escaped = value
+    .replace(/\\/g, '\\\\')
+    .replace(/"/g, '\\"')
+    .replace(/\n/g, '\\n')
+    .replace(/\r/g, '\\r')
+    .replace(/\t/g, '\\t');
+  return `"${escaped}"`;
+}
+
+/**
+ * 更新 alias 配置内容，返回新文本。
+ */
+export function updateAliasContent(content: string, name: string, command: string): string {
+  const lines = content.split(/\r?\n/);
+  const entryLine = `${name} = ${formatTomlString(command)}`;
+  let currentSection: string | null = null;
+  let aliasStart = -1;
+  let aliasEnd = lines.length;
+
+  for (let i = 0; i < lines.length; i += 1) {
+    const match = /^\s*\[(.+?)\]\s*$/.exec(lines[i]);
+    if (!match) continue;
+    if (currentSection === 'alias' && aliasStart >= 0 && aliasEnd === lines.length) {
+      aliasEnd = i;
+    }
+    currentSection = match[1].trim();
+    if (currentSection === 'alias') {
+      aliasStart = i;
+    }
+  }
+
+  if (aliasStart < 0) {
+    const trimmed = content.trimEnd();
+    const prefix = trimmed.length > 0 ? `${trimmed}\n\n` : '';
+    return `${prefix}[alias]\n${entryLine}\n`;
+  }
+
+  let replaced = false;
+  for (let i = aliasStart + 1; i < aliasEnd; i += 1) {
+    const parsed = parseTomlKeyValue(stripTomlComment(lines[i]).trim());
+    if (!parsed) continue;
+    if (parsed.key === name) {
+      lines[i] = entryLine;
+      replaced = true;
+      break;
+    }
+  }
+
+  if (!replaced) {
+    lines.splice(aliasEnd, 0, entryLine);
+  }
+
+  const output = lines.join('\n');
+  return output.endsWith('\n') ? output : `${output}\n`;
+}
+
+/**
+ * 写入或更新 alias 配置。
+ */
+export async function upsertAliasEntry(name: string, command: string, filePath: string = getGlobalConfigPath()): Promise<void> {
+  const exists = await fs.pathExists(filePath);
+  const content = exists ? await fs.readFile(filePath, 'utf8') : '';
+  const nextContent = updateAliasContent(content, name, command);
+  await fs.mkdirp(path.dirname(filePath));
+  await fs.writeFile(filePath, nextContent, 'utf8');
+}
+
 /**
  * 解析全局 TOML 配置文本。
  */
@@ -166,18 +264,10 @@ export function parseGlobalConfig(content: string): GlobalConfig {
     }
 
     if (currentSection !== 'shortcut') continue;
+    const parsed = parseTomlKeyValue(line);
+    if (!parsed) continue;
 
-    const equalIndex = findUnquotedIndex(line, '=');
-    if (equalIndex <= 0) continue;
-
-    const key = line.slice(0, equalIndex).trim();
-    const valuePart = line.slice(equalIndex + 1).trim();
-    if (!key || !valuePart) continue;
-
-    const parsedValue = parseTomlString(valuePart);
-    if (parsedValue === null) continue;
-
-    shortcut[key] = parsedValue;
+    shortcut[parsed.key] = parsed.value;
   }
 
   const name = normalizeShortcutName(shortcut.name ?? '');
@@ -194,6 +284,54 @@ export function parseGlobalConfig(content: string): GlobalConfig {
   };
 }
 
+/**
+ * 解析 alias 配置条目（含 shortcut 作为补充来源）。
+ */
+export function parseAliasEntries(content: string): AliasEntry[] {
+  const lines = content.split(/\r?\n/);
+  let currentSection: string | null = null;
+  const entries: AliasEntry[] = [];
+  const names = new Set<string>();
+
+  for (const rawLine of lines) {
+    const line = stripTomlComment(rawLine).trim();
+    if (!line) continue;
+
+    const sectionMatch = /^\[(.+)\]$/.exec(line);
+    if (sectionMatch) {
+      currentSection = sectionMatch[1].trim();
+      continue;
+    }
+
+    if (currentSection !== 'alias') continue;
+    const parsed = parseTomlKeyValue(line);
+    if (!parsed) continue;
+
+    const name = normalizeShortcutName(parsed.key);
+    const command = parsed.value.trim();
+    if (!name || !command) continue;
+    if (names.has(name)) continue;
+
+    names.add(name);
+    entries.push({
+      name,
+      command,
+      source: 'alias'
+    });
+  }
+
+  const shortcut = parseGlobalConfig(content).shortcut;
+  if (shortcut && !names.has(shortcut.name)) {
+    entries.push({
+      name: shortcut.name,
+      command: shortcut.command,
+      source: 'shortcut'
+    });
+  }
+
+  return entries;
+}
+
 /**
  * 读取用户目录下的全局配置。
  */

package/src/log-tailer.ts

@@ -0,0 +1,103 @@
+import { open as openFile } from 'node:fs/promises';
+import fs from 'fs-extra';
+
+export interface LogTailOptions {
+  readonly filePath: string;
+  readonly startFromEnd?: boolean;
+  readonly pollIntervalMs?: number;
+  readonly onLine: (line: string) => void;
+  readonly onError?: (message: string) => void;
+}
+
+export interface LogTailHandle {
+  stop: () => Promise<void>;
+}
+
+function normalizeChunk(chunk: string): string {
+  return chunk.replace(/\r\n?/g, '\n');
+}
+
+/**
+ * 轮询尾读日志文件，按行输出。
+ */
+export async function tailLogFile(options: LogTailOptions): Promise<LogTailHandle> {
+  const intervalMs = options.pollIntervalMs ?? 200;
+  let offset = 0;
+  let buffer = '';
+  let reading = false;
+  let stopped = false;
+
+  if (options.startFromEnd) {
+    try {
+      const stat = await fs.stat(options.filePath);
+      offset = stat.size;
+    } catch {
+      offset = 0;
+    }
+  }
+
+  const flushBuffer = (): void => {
+    if (!buffer) return;
+    options.onLine(buffer);
+    buffer = '';
+  };
+
+  const emitChunk = (chunk: string): void => {
+    buffer += normalizeChunk(chunk);
+    const parts = buffer.split('\n');
+    buffer = parts.pop() ?? '';
+    for (const line of parts) {
+      options.onLine(line);
+    }
+  };
+
+  const readNew = async (): Promise<void> => {
+    if (reading || stopped) return;
+    reading = true;
+    try {
+      const stat = await fs.stat(options.filePath);
+      if (stat.size < offset) {
+        offset = stat.size;
+        buffer = '';
+      }
+      if (stat.size > offset) {
+        const length = stat.size - offset;
+        const handle = await openFile(options.filePath, 'r');
+        try {
+          const payload = Buffer.alloc(length);
+          const result = await handle.read(payload, 0, length, offset);
+          offset += result.bytesRead;
+          if (result.bytesRead > 0) {
+            const text = payload.subarray(0, result.bytesRead).toString('utf8');
+            emitChunk(text);
+          }
+        } finally {
+          await handle.close();
+        }
+      }
+    } catch (error) {
+      const err = error as NodeJS.ErrnoException;
+      if (err?.code !== 'ENOENT') {
+        const message = err instanceof Error ? err.message : String(err);
+        options.onError?.(message);
+      }
+    } finally {
+      reading = false;
+    }
+  };
+
+  const timer = setInterval(() => {
+    void readNew();
+  }, intervalMs);
+
+  await readNew();
+
+  return {
+    stop: async () => {
+      if (stopped) return;
+      stopped = true;
+      clearInterval(timer);
+      flushBuffer();
+    }
+  };
+}

package/src/logs-viewer.ts

@@ -14,7 +14,7 @@ export interface LogEntry {
 interface ViewState {
   entry: LogEntry;
   lines: string[];
-  pageOffset: number;
+  lineOffset: number;
 }
 
 interface LogsViewerState {
@@ -170,7 +170,7 @@ function buildListLine(entry: LogEntry, selected: boolean, columns: number): str
 }
 
 function buildViewHeader(entry: LogEntry, columns: number): string {
-  const title = `日志查看｜${entry.fileName}｜↑/↓ 翻页  b 返回  q 退出`;
+  const title = `日志查看｜${entry.fileName}｜↑/↓ 上下 1 行  PageUp/PageDown 翻页  b 返回  q 退出`;
   return truncateLine(title, columns);
 }
 
@@ -232,16 +232,18 @@ function renderView(view: ViewState): void {
   const { rows, columns } = getTerminalSize();
   const pageSize = getPageSize(rows);
   const header = buildViewHeader(view.entry, columns);
-  const maxOffset = Math.max(0, Math.ceil(view.lines.length / pageSize) - 1);
-  view.pageOffset = Math.min(Math.max(view.pageOffset, 0), maxOffset);
+  const maxOffset = Math.max(0, view.lines.length - pageSize);
+  view.lineOffset = Math.min(Math.max(view.lineOffset, 0), maxOffset);
 
-  const start = view.pageOffset * pageSize;
+  const start = view.lineOffset;
   const pageLines = view.lines.slice(start, start + pageSize).map(line => truncateLine(line, columns));
   while (pageLines.length < pageSize) {
     pageLines.push('');
   }
 
-  const status = buildViewStatus(view.entry, { current: view.pageOffset + 1, total: Math.max(1, maxOffset + 1) }, columns);
+  const totalPages = Math.max(1, Math.ceil(view.lines.length / pageSize));
+  const currentPage = Math.min(totalPages, Math.floor(view.lineOffset / pageSize) + 1);
+  const status = buildViewStatus(view.entry, { current: currentPage, total: totalPages }, columns);
   const content = [header, ...pageLines, status].join('\n');
   process.stdout.write(`\u001b[2J\u001b[H${content}`);
 }
@@ -272,6 +274,14 @@ function isArrowDown(input: string): boolean {
   return input.includes('\u001b[B');
 }
 
+function isPageUp(input: string): boolean {
+  return input.includes('\u001b[5~');
+}
+
+function isPageDown(input: string): boolean {
+  return input.includes('\u001b[6~');
+}
+
 function isEscape(input: string): boolean {
   return input === '\u001b';
 }
@@ -351,16 +361,16 @@ export async function runLogsViewer(): Promise<void> {
     state.view = {
       entry,
       lines: ['加载中…'],
-      pageOffset: 0
+      lineOffset: 0
     };
     render(state);
     const lines = await readLogLines(entry.filePath);
     const pageSize = getPageSize(getTerminalSize().rows);
-    const maxOffset = Math.max(0, Math.ceil(lines.length / pageSize) - 1);
+    const maxOffset = Math.max(0, lines.length - pageSize);
     state.view = {
       entry,
       lines,
-      pageOffset: maxOffset
+      lineOffset: maxOffset
     };
     loading = false;
     render(state);
@@ -396,12 +406,24 @@ export async function runLogsViewer(): Promise<void> {
 
     if (state.mode === 'view' && state.view) {
       if (isArrowUp(input)) {
-        state.view.pageOffset -= 1;
+        state.view.lineOffset -= 1;
         render(state);
         return;
       }
       if (isArrowDown(input)) {
-        state.view.pageOffset += 1;
+        state.view.lineOffset += 1;
+        render(state);
+        return;
+      }
+      if (isPageUp(input)) {
+        const pageSize = getPageSize(getTerminalSize().rows);
+        state.view.lineOffset -= pageSize;
+        render(state);
+        return;
+      }
+      if (isPageDown(input)) {
+        const pageSize = getPageSize(getTerminalSize().rows);
+        state.view.lineOffset += pageSize;
         render(state);
         return;
       }

package/src/logs.ts

@@ -8,6 +8,7 @@ export interface RunMetadata {
   readonly round: number;
   readonly tokenUsed: number;
   readonly path: string;
+  readonly pid?: number;
 }
 
 export interface CurrentRegistryEntry extends RunMetadata {