cc-viewer 1.6.348 → 1.7.1

package/src/utils/avatarAnimationPostPass.js

@@ -0,0 +1,49 @@
+import React from 'react';
+import { shouldAnimateTeammateAvatar, pickAvatarAnimationTargets } from './teammateAvatars';
+
+/**
+ * Avatar animation loading strategy — post-pass applied at the end of
+ * ChatView.buildAllItems, once every item (and the out-of-band Last Response
+ * timestamp) is known. Teammate rows animate their one-shot draw-in only when
+ * within the 60s window of the newest item's timestamp; the single newest
+ * teammate row always animates ("welcome flourish" on historic logs). Losers
+ * get cloneElement({ animateAvatar: false }) — winners keep their original
+ * element reference so cached elements skip reconciliation entirely.
+ *
+ * The flags are frozen per build: the window is measured against the newest
+ * item's timestamp, NOT wall clock (do not "fix" with Date.now()); they
+ * refresh whenever new data rebuilds the list.
+ *
+ * @param {Array} items - freshly built ChatMessage element array; mutated in place
+ * @param {string|null} lastResponseTs - session.entryTimestamp of the Last
+ *   Response block, which lives OUTSIDE items but must count toward "newest"
+ * @returns {Array} the same array, with stale teammate rows cloned to static
+ */
+export function applyAvatarAnimationTargets(items, lastResponseTs = null) {
+  const scanEntries = items.map((item) => ({
+    ts: item?.props?.timestamp,
+    isTeammateAvatar: isTeammateAvatarItem(item?.props),
+  }));
+  if (lastResponseTs) scanEntries.push({ ts: lastResponseTs, isTeammateAvatar: false });
+  const { latestMs, newestTeammateIdx } = pickAvatarAnimationTargets(scanEntries);
+  if (newestTeammateIdx === -1) return items;
+  for (let i = 0; i < items.length; i++) {
+    if (!scanEntries[i].isTeammateAvatar) continue;
+    const animate = i === newestTeammateIdx ||
+      shouldAnimateTeammateAvatar(items[i].props.timestamp, latestMs);
+    if (!animate) items[i] = React.cloneElement(items[i], { animateAvatar: false });
+  }
+  return items;
+}
+
+// Mirrors ChatMessage.render()'s THREE teammate-avatar branches:
+// renderSubAgentChatMessage (role 'sub-agent-chat'), renderSubAgentMessage
+// (role 'sub-agent' — currently never constructed, covered defensively), and
+// renderTeammateMessage (role 'teammate-message'). If ChatMessage gains a new
+// teammate-avatar branch, add it here — rows missed by this predicate default
+// to animated forever.
+export function isTeammateAvatarItem(props) {
+  if (!props) return false;
+  return ((props.role === 'sub-agent-chat' || props.role === 'sub-agent') && props.isTeammate)
+    || props.role === 'teammate-message';
+}

package/src/utils/builtinPresets.js

@@ -0,0 +1,18 @@
+/**
+ * 内置预置快捷方式。
+ *
+ * builtinId 跨版本不变，用于追踪用户的删除/编辑。
+ * teamName / description 是 i18n key，渲染时通过 t() 解析。
+ */
+export const BUILTIN_PRESETS = [
+  {
+    builtinId: 'codereview-5',
+    teamName: 'ui.preset.codeReview5.name',
+    description: 'ui.preset.codeReview5.desc',
+  },
+  // 历史遗留 builtinId 已连同 i18n key 一并删除（用户反馈不常用）：
+  //   - 'scout-regiment'  / ui.preset.scoutRegiment.*
+  //   - 'codereview-2'    / ui.preset.codeReview2.*
+  // 若老用户的 preset 列表里已保存这些条目，i18n key 缺失时 t() 会回显原始 key，
+  // 视觉上难看但不崩；用户可在管理弹窗里手动删除。
+];

package/src/utils/clearCheckpoint.js

@@ -0,0 +1,7 @@
+// Re-export shell — the implementations moved VERBATIM to the shared client-safe
+// module server/lib/session-boundary.js in wire-v2 step S1 so the server-side
+// conversation router (S2+) and the client use ONE source of truth for session
+// boundaries (docs/refactor/WIRE_FORMAT_V2_PLAN.md). Existing client imports of
+// './clearCheckpoint.js' keep working through this shell; new code should import
+// from server/lib/session-boundary.js directly.
+export { isPostClearCheckpoint, isCompactContinuation, isSessionBoundary } from '../../server/lib/session-boundary.js';

package/src/utils/commandValidator.js

@@ -0,0 +1,45 @@
+/**
+ * File and command validation utilities.
+ */
+
+const IMAGE_EXTS = new Set(['png', 'jpg', 'jpeg', 'gif', 'svg', 'bmp', 'ico', 'icns', 'webp', 'avif']);
+
+export function isImageFile(path) {
+  const ext = (path || '').split('.').pop().toLowerCase();
+  return IMAGE_EXTS.has(ext);
+}
+
+/**
+ * Regex matching Bash commands that may mutate filesystem or git state.
+ * 命中任一即触发文件浏览器与 git 面板自动刷新（ToolFileChangeController 的 Bash 路径依赖）。
+ *
+ * 覆盖类别：
+ * - delete：rm（含 rm -rf）、rmdir（删空目录）、unlink（POSIX 单文件删除）、find ... -delete
+ * - create/move：mkdir、mv、cp、touch、ln
+ * - metadata：chmod、chown
+ * - package/archive：npm/yarn/pnpm install/uninstall、pip install、tar、unzip、curl -o、wget
+ * - redirect write：> 与 >>（排除 2>、>= 等由 [^>]>(?!>)/>> 处理）
+ * - git mutating：checkout/reset/stash/merge/rebase/cherry-pick/restore/clean/rm
+ *
+ * 设计取舍（trade-off）：
+ *   \b 单词边界不能区分"作为命令"还是"作为参数/字面量"，因此 `echo unlink` 之类
+ *   会被命中。文件浏览器额外刷新成本极低（一次 GET），宁可多刷不漏刷。
+ *
+ * find -delete 子表达式 `\bfind\b[^|;&\n]*-delete\b` 限定单条命令内，
+ * 避免 `grep find . | echo "-delete"` 之类的跨管道/分号误匹配。
+ *
+ * @example
+ *   isMutatingCommand('rm -rf node_modules')           // true
+ *   isMutatingCommand('find . -name "*.log" -delete')  // true
+ *   isMutatingCommand('git status')                    // false
+ *   isMutatingCommand('echo hello')                    // false
+ */
+const MUTATING_CMD_RE = /\b(rm|rmdir|unlink|mkdir|mv|cp|touch|chmod|chown|ln|git\s+(checkout|reset|stash|merge|rebase|cherry-pick|restore|clean|rm)|npm\s+(install|uninstall|ci)|yarn\s+(add|remove)|pnpm\s+(add|remove|install)|pip\s+install|tar|unzip|curl\s+-[^\s]*o|wget)\b|\bfind\b[^|;&\n]*-delete\b|[^>]>(?!>)|>>/;
+
+/**
+ * @param {string} cmd  Bash 命令字符串
+ * @returns {boolean}   true 表示命令可能修改文件树或 git 状态
+ */
+export function isMutatingCommand(cmd) {
+  return MUTATING_CMD_RE.test(cmd);
+}