helloagents 2.3.8 → 3.0.2-beta.1

package/scripts/notify-context.mjs

@@ -0,0 +1,123 @@
+import { join } from 'node:path';
+import { existsSync, readFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+
+function buildPackageRootBlock(pkgRoot) {
+  if (!pkgRoot) return '';
+  return `## 当前 HelloAGENTS 包根目录\n\`\`\`text\n${pkgRoot}\n\`\`\``;
+}
+
+function resolveStandbyHostRoot(host) {
+  const home = homedir();
+  const map = {
+    claude: join(home, '.claude', 'helloagents'),
+    codex: join(home, '.codex', 'helloagents'),
+    gemini: join(home, '.gemini', 'helloagents'),
+  };
+  return map[host] || '';
+}
+
+function resolveReadRoot({ cwd, pkgRoot, host, settings }) {
+  const projectRoot = join(cwd, 'skills', 'helloagents');
+  if (existsSync(projectRoot)) {
+    return { source: 'project', root: projectRoot };
+  }
+
+  if (settings.install_mode === 'standby') {
+    const standbyRoot = resolveStandbyHostRoot(host);
+    if (standbyRoot && existsSync(standbyRoot)) {
+      return { source: 'standby-home', root: standbyRoot };
+    }
+  }
+
+  return { source: 'package', root: pkgRoot };
+}
+
+function buildReadRootBlock(readRoot) {
+  if (!readRoot?.root) return '';
+  return `## 当前 HelloAGENTS 读取根目录\n\`\`\`json\n${JSON.stringify(readRoot, null, 2)}\n\`\`\``;
+}
+
+export function buildCompactionContext({ payload, pkgRoot, settings, bootstrapFile, host }) {
+  const summaryParts = [];
+  summaryParts.push('## HelloAGENTS 压缩摘要');
+  summaryParts.push('以下信息在上下文压缩前保存，确保压缩后不丢失关键状态。');
+
+  const cwd = payload.cwd || process.cwd();
+  const statePath = join(cwd, '.helloagents', 'STATE.md');
+  if (existsSync(statePath)) {
+    try {
+      const stateContent = readFileSync(statePath, 'utf-8');
+      summaryParts.push('');
+      summaryParts.push('## 恢复快照（从 STATE.md 读取，读完即可接上工作）');
+      summaryParts.push(stateContent);
+    } catch {}
+  }
+
+  let bootstrap = '';
+  try {
+    bootstrap = readFileSync(join(pkgRoot, bootstrapFile), 'utf-8');
+  } catch {}
+  if (bootstrap) {
+    summaryParts.push('');
+    summaryParts.push('## 核心规则（从 bootstrap 重新注入）');
+    summaryParts.push(bootstrap);
+  }
+
+  const packageRootBlock = buildPackageRootBlock(pkgRoot);
+  if (packageRootBlock) {
+    summaryParts.push('');
+    summaryParts.push(packageRootBlock);
+  }
+
+  const readRootBlock = buildReadRootBlock(resolveReadRoot({ cwd, pkgRoot, host, settings }));
+  if (readRootBlock) {
+    summaryParts.push('');
+    summaryParts.push(readRootBlock);
+  }
+
+  if (Object.keys(settings).length) {
+    summaryParts.push('');
+    summaryParts.push(`## 当前用户设置\n\`\`\`json\n${JSON.stringify(settings, null, 2)}\n\`\`\``);
+  }
+
+  return summaryParts.join('\n');
+}
+
+export function buildInjectContext({ source, bootstrap, settings, pkgRoot, host, cwd }) {
+  const packageRootBlock = buildPackageRootBlock(pkgRoot);
+  const readRootBlock = buildReadRootBlock(resolveReadRoot({ cwd, pkgRoot, host, settings }));
+  const settingsBlock = Object.keys(settings).length
+    ? `\n\n## 当前用户设置\n\`\`\`json\n${JSON.stringify(settings, null, 2)}\n\`\`\``
+    : '';
+
+  let context = bootstrap;
+  if (packageRootBlock) context += `\n\n${packageRootBlock}`;
+  if (readRootBlock) context += `\n\n${readRootBlock}`;
+  context += settingsBlock;
+  if (source === 'resume' || source === 'compact') {
+    context += '\n\n> ⚠️ 会话已恢复/压缩，请先读取 .helloagents/STATE.md 恢复工作状态。';
+  }
+  return context;
+}
+
+export function buildRouteInstruction({ skillName, extraRules = '', cwd, pkgRoot, host, settings }) {
+  const readRoot = resolveReadRoot({ cwd, pkgRoot, host, settings });
+  const skillPath = join(readRoot.root, 'skills', 'commands', skillName, 'SKILL.md');
+  return `用户使用了 ~${skillName} 命令。当前命令技能文件已解析为：${skillPath}。请直接读取这个 SKILL.md；本轮不要再为同一个命令 skill 重复 Test-Path / Get-Content，也不要探测其他 helloagents 路径。${extraRules}`;
+}
+
+export function detectNewProjectRoute(prompt) {
+  const newProjectPatterns = [
+    /(?:创建|新建|从零|搭建).*(?:项目|应用|系统|网站|游戏|工具|平台|小程序|APP)/,
+    /(?:做|写|开发|实现)[一个]*.*(?:项目|应用|系统|网站|游戏|工具|平台|小程序|APP)/,
+    /\b(build|create|design|make|new|start|init)\b.*\b(app|game|project|site|website|tool|system|platform)\b/i,
+  ];
+
+  for (const pattern of newProjectPatterns) {
+    if (pattern.test(prompt)) {
+      return '检测到可能是新项目/新应用任务。根据 HelloAGENTS 路由规则，新项目必须进入 ~design 设计流程。请引导用户进入 ~design。';
+    }
+  }
+  return '';
+}

package/scripts/notify-events.mjs

@@ -0,0 +1,11 @@
+export function shouldIgnoreCodexNotifyClient(client) {
+  return !!client && client !== 'codex-tui';
+}
+
+export function shouldIgnoreFormattedSubagent(lastMsg, outputFormatEnabled) {
+  return outputFormatEnabled && !lastMsg.includes('【HelloAGENTS】');
+}
+
+export function claimsTaskComplete(lastMsg) {
+  return /✅|完成|已修复|done|fixed|completed|finished/i.test(lastMsg);
+}

package/scripts/notify-shared.mjs

@@ -0,0 +1,47 @@
+import { readFileSync, readSync } from 'node:fs';
+
+export function readSettings(configFile) {
+  try {
+    return JSON.parse(readFileSync(configFile, 'utf-8'));
+  } catch {
+    return {};
+  }
+}
+
+export function readStdinJson() {
+  try {
+    const chunks = [];
+    const buf = Buffer.alloc(4096);
+    let n;
+    const fd = process.stdin.fd;
+    try {
+      while ((n = readSync(fd, buf, 0, buf.length)) > 0) {
+        chunks.push(buf.slice(0, n));
+      }
+    } catch {}
+    const raw = Buffer.concat(chunks).toString('utf-8').trim();
+    return raw ? JSON.parse(raw) : {};
+  } catch {
+    return {};
+  }
+}
+
+export function output(obj) {
+  process.stdout.write(JSON.stringify(obj));
+}
+
+export function suppressedOutput(hookEventName, additionalContext) {
+  output({
+    hookSpecificOutput: {
+      hookEventName,
+      ...(additionalContext != null ? { additionalContext } : {}),
+    },
+    suppressOutput: true,
+  });
+}
+
+export function emptySuppress() {
+  output({ suppressOutput: true });
+}
+
+export function versionCheckBackground() {}

package/scripts/notify-ui.mjs

@@ -0,0 +1,92 @@
+/**
+ * Sound playback and desktop notification for HelloAGENTS.
+ * Cross-platform: Windows (PowerShell), macOS (afplay/osascript), Linux (aplay/notify-send).
+ */
+import { platform } from 'node:os';
+import { join } from 'node:path';
+import { existsSync } from 'node:fs';
+import { spawnSync } from 'node:child_process';
+
+const PLAT = platform();
+
+const NOTIFY_MESSAGES = {
+  complete: '任务完成',
+  confirm: '需要确认',
+  warning: '出现问题',
+  error:   '执行出错',
+  idle:    '等待输入',
+};
+
+const WIN_APPID = 'HelloAgents.Notification';
+
+function resolveWav(pkgRoot, event) {
+  const p = join(pkgRoot, 'assets', 'sounds', `${event}.wav`);
+  return existsSync(p) ? p : null;
+}
+
+export function playSound(pkgRoot, event) {
+  const wav = resolveWav(pkgRoot, event);
+  if (!wav) { process.stderr.write('\x07'); return; }
+  try {
+    if (PLAT === 'win32') {
+      spawnSync('powershell', ['-NoProfile', '-c',
+        `(New-Object Media.SoundPlayer '${wav.replace(/'/g, "''")}').PlaySync()`],
+        { stdio: 'ignore', windowsHide: true });
+    } else if (PLAT === 'darwin') {
+      spawnSync('afplay', [wav], { stdio: 'ignore' });
+    } else {
+      const result = spawnSync('aplay', ['-q', wav], { stdio: 'ignore' });
+      if (result.status !== 0) {
+        const pa = spawnSync('paplay', [wav], { stdio: 'ignore' });
+        if (pa.status !== 0) process.stderr.write('\x07');
+      }
+    }
+  } catch { process.stderr.write('\x07'); }
+}
+
+function ensureWinAppId(pkgRoot) {
+  if (PLAT !== 'win32') return;
+  const regKey = `HKCU:\\Software\\Classes\\AppUserModelId\\${WIN_APPID}`;
+  spawnSync('powershell', ['-NoProfile', '-c',
+    `if (-not (Test-Path '${regKey}')) { New-Item -Path '${regKey}' -Force | Out-Null; Set-ItemProperty -Path '${regKey}' -Name 'DisplayName' -Value 'HelloAgents 通知' -Force }`],
+    { stdio: 'ignore', windowsHide: true });
+}
+
+export function desktopNotify(pkgRoot, event, extra) {
+  const msg = extra || NOTIFY_MESSAGES[event] || event;
+  const title = 'HelloAgents 通知';
+  try {
+    if (PLAT === 'win32') {
+      ensureWinAppId(pkgRoot);
+      const safeMsg = msg.replace(/'/g, "''");
+      const iconPath = join(pkgRoot, 'assets', 'icons', 'icon.png').replace(/\//g, '\\');
+      const iconXml = existsSync(iconPath) ? `<image placement="appLogoOverride" src="${iconPath}" />` : '';
+      const ps = `
+[Windows.UI.Notifications.ToastNotificationManager, Windows.UI.Notifications, ContentType = WindowsRuntime] | Out-Null
+[Windows.Data.Xml.Dom.XmlDocument, Windows.Data.Xml.Dom, ContentType = WindowsRuntime] | Out-Null
+$xml = @"
+<toast>
+  <visual>
+    <binding template="ToastGeneric">
+      ${iconXml}
+      <text>${safeMsg}</text>
+    </binding>
+  </visual>
+</toast>
+"@
+$doc = New-Object Windows.Data.Xml.Dom.XmlDocument
+$doc.LoadXml($xml)
+$toast = [Windows.UI.Notifications.ToastNotification]::new($doc)
+[Windows.UI.Notifications.ToastNotificationManager]::CreateToastNotifier('${WIN_APPID}').Show($toast)
+`.trim();
+      spawnSync('powershell', ['-NoProfile', '-c', ps], { stdio: 'ignore', windowsHide: true });
+    } else if (PLAT === 'darwin') {
+      spawnSync('osascript', ['-e',
+        `display notification "${msg.replace(/"/g, '\\"')}" with title "${title}"`],
+        { stdio: 'ignore' });
+    } else {
+      const result = spawnSync('notify-send', [title, msg], { stdio: 'ignore' });
+      if (result.status !== 0) process.stderr.write('\x07');
+    }
+  } catch { process.stderr.write('\x07'); }
+}

package/scripts/notify.mjs

@@ -0,0 +1,219 @@
+#!/usr/bin/env node
+// notify.mjs — Unified notification & bootstrap injection for HelloAGENTS
+// Zero external dependencies, ES module, cross-platform
+
+import { join, dirname } from 'node:path';
+import { existsSync, readFileSync } from 'node:fs';
+import { spawnSync } from 'node:child_process';
+import { fileURLToPath } from 'node:url';
+import { homedir } from 'node:os';
+import { playSound as _playSound, desktopNotify as _desktopNotify } from './notify-ui.mjs';
+import { buildCompactionContext, buildInjectContext, buildRouteInstruction, detectNewProjectRoute } from './notify-context.mjs';
+import { claimsTaskComplete, shouldIgnoreCodexNotifyClient, shouldIgnoreFormattedSubagent } from './notify-events.mjs';
+import { readSettings, readStdinJson, output, suppressedOutput, emptySuppress, versionCheckBackground } from './notify-shared.mjs';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const PKG_ROOT = join(__dirname, '..');
+const CONFIG_FILE = join(homedir(), '.helloagents', 'helloagents.json');
+const HOST = process.argv.includes('--gemini')
+  ? 'gemini'
+  : process.argv.includes('--codex')
+    ? 'codex'
+    : 'claude';
+const IS_GEMINI = HOST === 'gemini';
+const EVENT_NAME = {
+  SessionStart: 'SessionStart',
+  UserPromptSubmit: IS_GEMINI ? 'BeforeAgent' : 'UserPromptSubmit',
+  PreCompact: IS_GEMINI ? 'BeforeAgent' : 'PreCompact',
+};
+
+const playSound = (event) => _playSound(PKG_ROOT, event);
+const desktopNotify = (event, extra) => _desktopNotify(PKG_ROOT, event, extra);
+
+function getSettings() {
+  return readSettings(CONFIG_FILE);
+}
+
+function runRalphLoop(payload) {
+  const settings = getSettings();
+  if (settings.ralph_loop_enabled === false) return false;
+  try {
+    const rlPath = join(__dirname, 'ralph-loop.mjs');
+    if (!existsSync(rlPath)) return false;
+    const result = spawnSync(process.execPath, [rlPath, ...(IS_GEMINI ? ['--gemini'] : [])], {
+      input: JSON.stringify(payload),
+      encoding: 'utf-8',
+      timeout: 120_000,
+    });
+    if (result.stdout) {
+      const rlOut = JSON.parse(result.stdout);
+      if (rlOut.decision === 'block') {
+        output(rlOut);
+        return true;
+      }
+    }
+  } catch {}
+  return false;
+}
+
+function resolveBootstrapFile(cwd, settings) {
+  const isGlobal = settings.install_mode === 'global';
+  const isActivated = existsSync(join(cwd, '.helloagents'));
+  return (isGlobal || isActivated) ? 'bootstrap.md' : 'bootstrap-lite.md';
+}
+
+function cmdPreCompact() {
+  const payload = readStdinJson();
+  const cwd = payload.cwd || process.cwd();
+  const settings = getSettings();
+  const bootstrapFile = resolveBootstrapFile(cwd, settings);
+  const context = buildCompactionContext({
+    payload,
+    pkgRoot: PKG_ROOT,
+    settings,
+    bootstrapFile,
+    host: HOST,
+  });
+  suppressedOutput(EVENT_NAME.PreCompact, context);
+}
+
+function cmdRoute() {
+  const payload = readStdinJson();
+  const prompt = (payload.prompt || '').trim();
+  const cwd = payload.cwd || process.cwd();
+  const settings = getSettings();
+  if (!prompt) {
+    emptySuppress();
+    return;
+  }
+  if (/^\[子代理任务\]/.test(prompt)) {
+    emptySuppress();
+    return;
+  }
+
+  const cmdMatch = prompt.match(/^~(\w+)/);
+  if (cmdMatch) {
+    const skillName = cmdMatch[1];
+    const extraRules = skillName === 'help'
+      ? ' 这是 HelloAGENTS 的帮助命令，不是宿主 CLI 的内置帮助。适用条件：仅显示 HelloAGENTS 的帮助和当前设置；优先使用当前上下文中已注入的“当前用户设置”，只有上下文不存在该信息时才尝试读取 ~/.helloagents/helloagents.json；自动激活技能说明仅在全局模式或当前项目已通过 ~init 激活后生效。排除条件：不要调用宿主 CLI 的帮助工具（如 cli_help 或 /help），不要使用子代理，不要读取项目文件；若受工作区限制无法读取配置，必须明确说明并按已知默认值或已注入设置展示；纯标准模式未激活项目不会自动触发。'
+      : '';
+    suppressedOutput(EVENT_NAME.UserPromptSubmit, buildRouteInstruction({
+      skillName,
+      extraRules,
+      cwd,
+      pkgRoot: PKG_ROOT,
+      host: HOST,
+      settings,
+    }));
+    return;
+  }
+
+  const bootstrapFile = resolveBootstrapFile(cwd, settings);
+  if (bootstrapFile === 'bootstrap.md') {
+    const routeMessage = detectNewProjectRoute(prompt);
+    if (routeMessage) {
+      suppressedOutput(EVENT_NAME.UserPromptSubmit, routeMessage);
+      return;
+    }
+  }
+
+  emptySuppress();
+}
+
+function cmdInject() {
+  const payload = readStdinJson();
+  const source = payload.source || 'startup';
+  const cwd = payload.cwd || process.cwd();
+  const settings = getSettings();
+  const bootstrapFile = resolveBootstrapFile(cwd, settings);
+
+  let bootstrap = '';
+  try {
+    bootstrap = readFileSync(join(PKG_ROOT, bootstrapFile), 'utf-8');
+  } catch {}
+
+  const context = buildInjectContext({
+    source,
+    bootstrap,
+    settings,
+    pkgRoot: PKG_ROOT,
+    host: HOST,
+    cwd,
+  });
+  suppressedOutput(EVENT_NAME.SessionStart, context || undefined);
+  versionCheckBackground();
+}
+
+function cmdStop() {
+  const payload = readStdinJson();
+  if (runRalphLoop(payload)) {
+    playSound('warning');
+    desktopNotify('warning');
+    return;
+  }
+
+  const settings = getSettings();
+  const level = settings.notify_level ?? 0;
+  if (level === 2 || level === 3) playSound('complete');
+  if (level === 1 || level === 3) desktopNotify('complete');
+  emptySuppress();
+}
+
+function cmdSound() {
+  playSound(process.argv[3] || 'complete');
+}
+
+function cmdDesktop() {
+  desktopNotify(process.argv[3] || 'complete');
+}
+
+function cmdCodexNotify() {
+  let data = {};
+  try { data = JSON.parse(process.argv[3] || '{}'); } catch {}
+
+  const type = data.type || '';
+  const client = data.client || '';
+  if (shouldIgnoreCodexNotifyClient(client)) return;
+
+  if (type === 'approval-requested') {
+    playSound('confirm');
+    desktopNotify('confirm');
+    return;
+  }
+  if (type !== 'agent-turn-complete') return;
+
+  const lastMsg = data['last-assistant-message'] || '';
+  const settings = getSettings();
+  if (shouldIgnoreFormattedSubagent(lastMsg, settings.output_format !== false)) return;
+
+  const cwd = data.cwd || process.cwd();
+  if (claimsTaskComplete(lastMsg) && runRalphLoop({ cwd })) {
+    playSound('warning');
+    desktopNotify('warning');
+    return;
+  }
+
+  const level = settings.notify_level ?? 0;
+  if (level === 2 || level === 3) playSound('complete');
+  if (level === 1 || level === 3) desktopNotify('complete');
+  versionCheckBackground();
+}
+
+function cmdVersionCheck() {}
+
+const cmd = process.argv[2] || '';
+
+switch (cmd) {
+  case 'inject':        cmdInject(); break;
+  case 'stop':          cmdStop(); break;
+  case 'pre-compact':   cmdPreCompact(); break;
+  case 'route':         cmdRoute(); break;
+  case 'sound':         cmdSound(); break;
+  case 'desktop':       cmdDesktop(); break;
+  case 'codex-notify':  cmdCodexNotify(); break;
+  case 'version-check': cmdVersionCheck(); break;
+  default:
+    process.stderr.write(`notify.mjs: unknown command "${cmd}"\n`);
+    process.exit(1);
+}