@yancyyu/openhermit 1.5.8

package/src/renderer/utils/bootstrapPromptSanitizer.ts

@@ -0,0 +1,225 @@
+import { displayMemberName } from '@renderer/utils/memberHelpers';
+import {
+  doesTeamModelCarryProviderBrand,
+  getTeamModelLabel,
+  getTeamProviderLabel,
+} from '@renderer/utils/teamModelCatalog';
+
+import type { InboxMessage, TeamProviderId } from '@shared/types';
+
+const BOOTSTRAP_REQUIRED_MARKER_SETS = [
+  [
+    'Your FIRST action: call MCP tool member_briefing',
+    'Do NOT start work, claim tasks, or improvise workflow/task/process rules before member_briefing succeeds.',
+  ],
+  [
+    'Your FIRST action: call MCP tool member_briefing',
+    'The team has already been created and you are being attached as a persistent teammate.',
+  ],
+  [
+    'Your FIRST action: call MCP tool member_briefing',
+    'The team has already been reconnected and you are being re-attached as a persistent teammate.',
+  ],
+] as const;
+
+const BOOTSTRAP_SUPPORTING_MARKERS = [
+  'If member_briefing fails, send',
+  'member_briefing is expected to be available in your initial MCP tool list.',
+  'IMPORTANT: When sending messages to the team lead',
+  'Call member_briefing directly yourself. Do NOT use Agent',
+  'wait for instructions from the lead and use team mailbox/task tools normally',
+  'resume your queue normally and prioritize already-assigned board work',
+] as const;
+
+function parseProviderId(value: string | undefined): TeamProviderId | null {
+  const normalized = value?.trim().toLowerCase();
+  if (
+    normalized === 'anthropic' ||
+    normalized === 'codex' ||
+    normalized === 'gemini' ||
+    normalized === 'opencode'
+  ) {
+    return normalized;
+  }
+  return null;
+}
+
+function getTeamEffortLabel(effort: string | undefined): string {
+  const trimmed = effort?.trim() ?? '';
+  if (!trimmed) return '默认';
+  if (trimmed === 'low') return '低';
+  if (trimmed === 'medium') return '中';
+  if (trimmed === 'high') return '高';
+  return trimmed.charAt(0).toUpperCase() + trimmed.slice(1);
+}
+
+function matchField(text: string, pattern: RegExp): string | undefined {
+  const match = pattern.exec(text);
+  const value = match?.[1]?.trim();
+  return value ? value : undefined;
+}
+
+function matchOverrideField(
+  text: string,
+  fieldName: 'Provider override' | 'Model override' | 'Effort override'
+): string | undefined {
+  const fieldPattern = new RegExp(`${fieldName}(?: for this teammate)?:\\s*`, 'i');
+  const fieldMatch = fieldPattern.exec(text);
+  if (!fieldMatch) {
+    return undefined;
+  }
+
+  const rest = text.slice(fieldMatch.index + fieldMatch[0].length);
+  const nextOverrideMatch =
+    /\.\s+(?:Provider override|Model override|Effort override)(?: for this teammate)?:/i.exec(rest);
+  const newlineIndex = rest.indexOf('\n');
+  const stopCandidates = [
+    nextOverrideMatch?.index,
+    newlineIndex >= 0 ? newlineIndex : undefined,
+  ].filter((index): index is number => typeof index === 'number' && index >= 0);
+  const end = stopCandidates.length > 0 ? Math.min(...stopCandidates) : rest.length;
+  const value = rest.slice(0, end).trim().replace(/\.$/, '').trim();
+  return value ? value : undefined;
+}
+
+function buildRuntimeSummary(
+  providerId: TeamProviderId | null,
+  model: string | undefined,
+  effort: string | undefined
+): string | undefined {
+  if (providerId) {
+    const providerLabel = getTeamProviderLabel(providerId) ?? 'Anthropic';
+    const modelLabel = model ? (getTeamModelLabel(model) ?? model) : '默认';
+    const effortLabel = effort ? getTeamEffortLabel(effort) : undefined;
+    const modelAlreadyCarriesProviderBrand = doesTeamModelCarryProviderBrand(
+      providerId,
+      modelLabel
+    );
+
+    const providerActsAsBackendOnly =
+      providerId !== 'anthropic' && modelLabel !== '默认' && !modelAlreadyCarriesProviderBrand;
+
+    const parts = modelAlreadyCarriesProviderBrand
+      ? [modelLabel, effortLabel]
+      : providerActsAsBackendOnly
+        ? [modelLabel, `经由 ${providerLabel}`, effortLabel]
+        : [providerLabel, modelLabel, effortLabel];
+    return parts.filter(Boolean).join(' · ');
+  }
+
+  const modelLabel = model ? (getTeamModelLabel(model) ?? model) : '';
+  const effortLabel = effort ? getTeamEffortLabel(effort) : '';
+  const providerLabel = providerId ? (getTeamProviderLabel(providerId) ?? '') : '';
+  return [providerLabel, modelLabel, effortLabel].filter(Boolean).join(' · ') || undefined;
+}
+
+export interface BootstrapPromptDisplay {
+  teammateName?: string;
+  teamName?: string;
+  runtime?: string;
+  summary: string;
+  body: string;
+}
+
+export interface BootstrapAcknowledgementDisplay {
+  teammateName?: string;
+  teamName?: string;
+  summary: string;
+  body: string;
+}
+
+export function getBootstrapPromptDisplay(
+  message: Pick<InboxMessage, 'text' | 'to'>
+): BootstrapPromptDisplay | null {
+  const text = typeof message.text === 'string' ? message.text.trim() : '';
+  const hasRequiredMarkers = BOOTSTRAP_REQUIRED_MARKER_SETS.some((markerSet) =>
+    markerSet.every((marker) => text.includes(marker))
+  );
+  const hasSupportingMarker = BOOTSTRAP_SUPPORTING_MARKERS.some((marker) => text.includes(marker));
+  if (!text.startsWith('You are ') || !hasRequiredMarkers || !hasSupportingMarker) {
+    return null;
+  }
+
+  const teammateName =
+    matchField(text, /^You are\s+([^,\n]+),/m) ??
+    (typeof message.to === 'string' ? message.to.trim() : undefined);
+  const teamName = matchField(text, /on team "([^"]+)"/);
+  const providerId = parseProviderId(matchOverrideField(text, 'Provider override'));
+  const model = matchOverrideField(text, 'Model override');
+  const effort = matchOverrideField(text, 'Effort override');
+  const runtime = buildRuntimeSummary(providerId, model, effort);
+  const displayName = teammateName ? displayMemberName(teammateName) : 'teammate';
+  const summary = `Starting ${displayName}`;
+  const bodyLines = [`Lead is starting \`${displayName}\` as a teammate.`];
+
+  if (runtime) {
+    bodyLines.push(`Runtime: ${runtime}`);
+  } else if (teamName) {
+    bodyLines.push(`Team: \`${teamName}\``);
+  }
+
+  bodyLines.push('Startup instructions are hidden in the UI.');
+
+  return {
+    teammateName,
+    teamName,
+    runtime,
+    summary,
+    body: bodyLines.join('\n\n'),
+  };
+}
+
+export function getBootstrapAcknowledgementDisplay(
+  message: Pick<InboxMessage, 'text' | 'from'>
+): BootstrapAcknowledgementDisplay | null {
+  const text = typeof message.text === 'string' ? message.text.trim() : '';
+  if (!text.startsWith('{') || !text.endsWith('}')) {
+    return null;
+  }
+
+  const markers = [
+    "'concerns':",
+    "'existingRelationships':",
+    "'hasBootstrapGuidance':",
+    "'hasAcknowledged':",
+    "'isTeamLead':",
+    "'memberName':",
+    "'teamName':",
+  ];
+  if (!markers.every((marker) => text.includes(marker))) {
+    return null;
+  }
+
+  const teammateName =
+    matchField(text, /'memberName':\s*'([^']+)'/) ??
+    (typeof message.from === 'string' ? message.from.trim() : undefined);
+  const teamName = matchField(text, /'teamName':\s*'([^']+)'/);
+  const displayName = teammateName ? displayMemberName(teammateName) : 'teammate';
+
+  return {
+    teammateName,
+    teamName,
+    summary: `${displayName} acknowledged bootstrap`,
+    body: `${displayName} acknowledged bootstrap.`,
+  };
+}
+
+export function getSanitizedInboxMessageText(message: Pick<InboxMessage, 'text' | 'to'>): string {
+  return (
+    getBootstrapPromptDisplay(message)?.body ??
+    getBootstrapAcknowledgementDisplay(message as Pick<InboxMessage, 'text' | 'from'>)?.body ??
+    message.text ??
+    ''
+  );
+}
+
+export function getSanitizedInboxMessageSummary(
+  message: Pick<InboxMessage, 'text' | 'to' | 'from' | 'summary'>
+): string {
+  return (
+    getBootstrapPromptDisplay(message)?.summary ??
+    getBootstrapAcknowledgementDisplay(message)?.summary ??
+    message.summary ??
+    ''
+  );
+}

package/src/renderer/utils/bugReportUtils.ts

@@ -0,0 +1,157 @@
+import packageJson from '../../../package.json';
+
+const GITHUB_BUG_REPORT_URL = 'https://github.com/yancyuu/Hermit/issues/new';
+const MAX_TITLE_LENGTH = 120;
+const URL_MAX_STACK_LENGTH = 1800;
+const URL_MAX_COMPONENT_STACK_LENGTH = 1200;
+const COPY_MAX_STACK_LENGTH = 12000;
+const COPY_MAX_COMPONENT_STACK_LENGTH = 8000;
+
+export interface BugReportContext {
+  activeTabType?: string | null;
+  activeTabLabel?: string | null;
+  activeTeamName?: string | null;
+  selectedTeamName?: string | null;
+  taskId?: string | null;
+  sessionId?: string | null;
+  projectId?: string | null;
+}
+
+export interface BugReportOptions {
+  error: Error | null;
+  componentStack?: string | null;
+  context?: BugReportContext;
+}
+
+const truncate = (value: string, maxLength: number): string => {
+  if (value.length <= maxLength) {
+    return value;
+  }
+
+  return `${value.slice(0, maxLength)}\n...[truncated]`;
+};
+
+const buildIssueTitle = (error: Error | null): string => {
+  const baseTitle = error ? `[BUG] ${error.name}: ${error.message}` : '[BUG] Application crash';
+  return truncate(baseTitle, MAX_TITLE_LENGTH);
+};
+
+const getRuntimeLabel = (): string => 'Web browser';
+
+const formatOptional = (value: string | null | undefined): string => {
+  if (!value) {
+    return 'Not available';
+  }
+
+  const trimmed = value.trim();
+  return trimmed.length > 0 ? trimmed : 'Not available';
+};
+
+const getOperatingSystemLabel = (): string => {
+  const { userAgent } = window.navigator;
+
+  if (userAgent.includes('Mac OS X')) return 'macOS';
+  if (userAgent.includes('Windows')) return 'Windows';
+  if (userAgent.includes('Linux')) return 'Linux';
+
+  return 'Unknown';
+};
+
+const formatActiveTab = (context?: BugReportContext): string => {
+  if (!context?.activeTabType) {
+    return 'Not available';
+  }
+
+  if (!context.activeTabLabel) {
+    return context.activeTabType;
+  }
+
+  return `${context.activeTabType} (${context.activeTabLabel})`;
+};
+
+const buildBugReportMarkdown = (
+  { error, componentStack, context }: BugReportOptions,
+  stackLimits: { js: number; react: number }
+): string => {
+  const message = error?.message ?? 'Unknown application crash';
+  const jsStack = error?.stack ? truncate(error.stack, stackLimits.js) : 'Not available';
+  const reactComponentStack = componentStack
+    ? truncate(componentStack, stackLimits.react)
+    : 'Not available';
+
+  return [
+    '**Describe the bug**',
+    'The app crashed and showed the global error screen.',
+    '',
+    '**What happened**',
+    `- Error: \`${message}\``,
+    `- Error type: \`${error?.name ?? 'UnknownError'}\``,
+    `- Active tab: ${formatActiveTab(context)}`,
+    `- Active team tab: ${formatOptional(context?.activeTeamName)}`,
+    `- Selected team: ${formatOptional(context?.selectedTeamName)}`,
+    `- Current task: ${formatOptional(context?.taskId)}`,
+    `- Session ID: ${formatOptional(context?.sessionId)}`,
+    `- Project ID: ${formatOptional(context?.projectId)}`,
+    '',
+    '**Steps to reproduce**',
+    '1. Open the app and navigate to the screen where the crash happened.',
+    '2. Repeat the action that triggered the error.',
+    '3. Observe the global error screen.',
+    '',
+    '**Expected behavior**',
+    'The app should continue working instead of crashing.',
+    '',
+    '**Screenshots**',
+    'Attach a screenshot if you have one.',
+    '',
+    '**Environment**',
+    `- OS: ${getOperatingSystemLabel()}`,
+    `- Runtime: ${getRuntimeLabel()}`,
+    `- App version: ${packageJson.version}`,
+    '',
+    '**Diagnostics**',
+    '```text',
+    `Timestamp: ${new Date().toISOString()}`,
+    `Current URL: ${window.location.href}`,
+    `User Agent: ${window.navigator.userAgent}`,
+    `Error name: ${error?.name ?? 'UnknownError'}`,
+    `Error message: ${message}`,
+    `Active tab: ${formatActiveTab(context)}`,
+    `Active team tab: ${formatOptional(context?.activeTeamName)}`,
+    `Selected team: ${formatOptional(context?.selectedTeamName)}`,
+    `Current task: ${formatOptional(context?.taskId)}`,
+    `Session ID: ${formatOptional(context?.sessionId)}`,
+    `Project ID: ${formatOptional(context?.projectId)}`,
+    '```',
+    '',
+    '**JavaScript stack trace**',
+    '```text',
+    jsStack,
+    '```',
+    '',
+    '**React component stack**',
+    '```text',
+    reactComponentStack,
+    '```',
+  ].join('\n');
+};
+
+export const buildBugReportText = (options: BugReportOptions): string =>
+  buildBugReportMarkdown(options, {
+    js: COPY_MAX_STACK_LENGTH,
+    react: COPY_MAX_COMPONENT_STACK_LENGTH,
+  });
+
+export const buildGitHubBugReportUrl = (options: BugReportOptions): string => {
+  const params = new URLSearchParams({
+    template: 'bug_report.md',
+    labels: 'bug',
+    title: buildIssueTitle(options.error),
+    body: buildBugReportMarkdown(options, {
+      js: URL_MAX_STACK_LENGTH,
+      react: URL_MAX_COMPONENT_STACK_LENGTH,
+    }),
+  });
+
+  return `${GITHUB_BUG_REPORT_URL}?${params.toString()}`;
+};

package/src/renderer/utils/buildSelectionAction.ts

@@ -0,0 +1,116 @@
+/**
+ * Builds an EditorSelectionAction from a selection info + action type.
+ *
+ * Extracted as a utility so it can be imported in tests
+ * without pulling in CodeMirror dependencies.
+ */
+
+import { getBasename, isWindowsishPath, splitPath } from '@shared/utils/platformPath';
+
+import type { EditorSelectionAction, EditorSelectionInfo } from '@shared/types/editor';
+
+// =============================================================================
+// Code fence language map (lowercase identifiers for markdown)
+// =============================================================================
+
+const CODE_FENCE_LANG: Record<string, string> = {
+  ts: 'typescript',
+  tsx: 'tsx',
+  js: 'javascript',
+  jsx: 'jsx',
+  mjs: 'javascript',
+  cjs: 'javascript',
+  py: 'python',
+  json: 'json',
+  jsonl: 'json',
+  css: 'css',
+  scss: 'scss',
+  sass: 'sass',
+  less: 'less',
+  html: 'html',
+  htm: 'html',
+  xml: 'xml',
+  svg: 'xml',
+  md: 'markdown',
+  mdx: 'markdown',
+  yaml: 'yaml',
+  yml: 'yaml',
+  rs: 'rust',
+  go: 'go',
+  java: 'java',
+  c: 'c',
+  h: 'c',
+  cpp: 'cpp',
+  cxx: 'cpp',
+  cc: 'cpp',
+  hpp: 'cpp',
+  php: 'php',
+  sql: 'sql',
+  sh: 'bash',
+  bash: 'bash',
+  zsh: 'bash',
+  toml: 'toml',
+  ini: 'ini',
+};
+
+/** Maps file extension to a code fence language identifier (lowercase). */
+export function getCodeFenceLanguage(fileName: string): string {
+  const ext = fileName.split('.').pop()?.toLowerCase() ?? '';
+  return CODE_FENCE_LANG[ext] ?? '';
+}
+
+/**
+ * Builds a file-mention action (no code selection, just the file reference).
+ * Used when triggering "Create Task" / "Write Teammate" from the file tree context menu.
+ */
+export function buildFileAction(
+  type: EditorSelectionAction['type'],
+  filePath: string,
+  projectPath?: string | null
+): EditorSelectionAction {
+  const fileName = getBasename(filePath) || 'file';
+  let displayPath = filePath;
+  if (projectPath) {
+    const fullParts = splitPath(filePath);
+    const rootParts = splitPath(projectPath);
+    const win = isWindowsishPath(projectPath);
+    const eq = (a: string, b: string): boolean =>
+      win ? a.toLowerCase() === b.toLowerCase() : a === b;
+    const hasPrefix =
+      fullParts.length >= rootParts.length && rootParts.every((seg, i) => eq(seg, fullParts[i]));
+    if (hasPrefix) {
+      displayPath = fullParts.slice(rootParts.length).join('/');
+    }
+  }
+  return {
+    type,
+    filePath,
+    fromLine: null,
+    toLine: null,
+    selectedText: '',
+    formattedContext: `**${fileName}** (\`${displayPath}\`)`,
+    displayPath,
+  };
+}
+
+/** Builds a selection action with a formatted markdown code fence context. */
+export function buildSelectionAction(
+  type: EditorSelectionAction['type'],
+  info: EditorSelectionInfo
+): EditorSelectionAction {
+  const fileName = getBasename(info.filePath) || 'file';
+  const lang = getCodeFenceLanguage(fileName);
+  const lineRef =
+    info.fromLine === info.toLine
+      ? `line ${info.fromLine}`
+      : `lines ${info.fromLine}-${info.toLine}`;
+  const formattedContext = `**${fileName}** (${lineRef}):\n\`\`\`${lang}\n${info.text}\n\`\`\``;
+  return {
+    type,
+    filePath: info.filePath,
+    fromLine: info.fromLine,
+    toLine: info.toLine,
+    selectedText: info.text,
+    formattedContext,
+  };
+}