chatccc 0.2.251 → 0.2.253

package/src/git-command.ts

@@ -1,202 +0,0 @@
-// =============================================================================
-// git-command.ts — /git 命令的执行与结果格式化
-// =============================================================================
-// 解析自 /git 后的原始字符串作为 shell 参数，在指定 cwd 下通过 shell 调起
-// `git ...`，收集 stdout/stderr 与退出码。带超时（kill）与逐路输出字节上限
-// （超过即截断），避免长输出撑爆内存或刷屏。
-//
-// 抽成独立模块是为了便于在不依赖飞书 SDK / 网络的前提下跑单元测试。
-// =============================================================================
-
-import { spawn } from "node:child_process";
-
-import { truncateContent } from "./cards.ts";
-
-// ---------------------------------------------------------------------------
-// 类型
-// ---------------------------------------------------------------------------
-
-export interface GitCommandResult {
-  /** 进程退出码；spawn 失败或被 kill 时为 null */
-  exitCode: number | null;
-  stdout: string;
-  stderr: string;
-  durationMs: number;
-  /** 任意一路输出超过 maxBytes 上限，已被截断 */
-  truncated: boolean;
-  /** 命令超过 timeoutMs 被强制终止 */
-  timedOut: boolean;
-  /** spawn 自身错误（如 git 不在 PATH）；正常退出（含非 0）时为 undefined */
-  spawnError?: string;
-}
-
-export interface RunGitOptions {
-  /** 命令最大允许执行毫秒数；超过则 SIGKILL，默认 60_000 */
-  timeoutMs?: number;
-  /** stdout 与 stderr 各自最多采集多少字节；默认 64 KiB */
-  maxBytes?: number;
-  /** 注入测试桩用：自定义 spawn 函数；默认使用 node:child_process 的 spawn */
-  spawnImpl?: typeof spawn;
-}
-
-// ---------------------------------------------------------------------------
-// runGitCommand —— 在 cwd 下执行 `git <args>`
-// ---------------------------------------------------------------------------
-
-/**
- * 在 `cwd` 目录下执行 `git <args>`。
- * - 通过 shell 执行（`shell: true`），允许用户使用引号、管道等 shell 语法
- * - stdout/stderr 各自最多采集 `maxBytes` 字节，超过则置 truncated=true 并丢弃后续片段
- * - 超时则 SIGKILL 并置 timedOut=true，仍返回已收集的部分输出
- *
- * 注意：本函数 **不会抛错**——任何失败都通过返回值传递（退出码、spawnError 等），
- * 调用方需通过 exitCode/spawnError/timedOut/truncated 判断结果。
- */
-export function runGitCommand(
-  args: string,
-  cwd: string,
-  opts: RunGitOptions = {},
-): Promise<GitCommandResult> {
-  const timeoutMs = opts.timeoutMs ?? 60_000;
-  const maxBytes = opts.maxBytes ?? 64 * 1024;
-  const spawnImpl = opts.spawnImpl ?? spawn;
-  const startTime = Date.now();
-
-  return new Promise<GitCommandResult>((resolve) => {
-    let child: ReturnType<typeof spawn>;
-    try {
-      child = spawnImpl(`git ${args}`, {
-        cwd,
-        shell: true,
-        windowsHide: true,
-      });
-    } catch (err) {
-      resolve({
-        exitCode: null,
-        stdout: "",
-        stderr: "",
-        durationMs: Date.now() - startTime,
-        truncated: false,
-        timedOut: false,
-        spawnError: err instanceof Error ? err.message : String(err),
-      });
-      return;
-    }
-
-    let stdout = "";
-    let stderr = "";
-    let stdoutBytes = 0;
-    let stderrBytes = 0;
-    let truncated = false;
-    let timedOut = false;
-    let spawnError: string | undefined;
-
-    const collect = (chunk: Buffer, current: { bytes: number; text: string }): void => {
-      const room = maxBytes - current.bytes;
-      if (room <= 0) {
-        truncated = true;
-        return;
-      }
-      const slice = chunk.length <= room ? chunk : chunk.subarray(0, room);
-      current.text += slice.toString("utf-8");
-      current.bytes += slice.length;
-      if (chunk.length > room) truncated = true;
-    };
-
-    const stdoutState = { bytes: 0, text: "" };
-    const stderrState = { bytes: 0, text: "" };
-
-    child.stdout?.on("data", (chunk: Buffer) => {
-      collect(chunk, stdoutState);
-      stdout = stdoutState.text;
-      stdoutBytes = stdoutState.bytes;
-    });
-    child.stderr?.on("data", (chunk: Buffer) => {
-      collect(chunk, stderrState);
-      stderr = stderrState.text;
-      stderrBytes = stderrState.bytes;
-    });
-
-    const killTimer = setTimeout(() => {
-      timedOut = true;
-      try {
-        child.kill("SIGKILL");
-      } catch {
-        // ignore: 进程可能已退出
-      }
-    }, timeoutMs);
-
-    child.on("error", (err: Error) => {
-      spawnError = err.message;
-    });
-
-    child.on("close", (code: number | null) => {
-      clearTimeout(killTimer);
-      // 仅引用未直接使用的字节计数变量以避免编译告警
-      void stdoutBytes; void stderrBytes;
-      resolve({
-        exitCode: code,
-        stdout,
-        stderr,
-        durationMs: Date.now() - startTime,
-        truncated,
-        timedOut,
-        spawnError,
-      });
-    });
-  });
-}
-
-// ---------------------------------------------------------------------------
-// formatGitResult —— 把执行结果渲染为飞书卡片用的 markdown
-// ---------------------------------------------------------------------------
-
-/**
- * 渲染 `/git` 执行结果为发送给用户的 markdown 字符串。
- * stdout/stderr 单路各最多保留 `maxLines` 行 / `maxChars` 字符（沿用 truncateContent），
- * 命令本身的截断状态（truncated/timedOut/spawnError）也会在头部说明。
- */
-export function formatGitResult(
-  args: string,
-  cwd: string,
-  result: GitCommandResult,
-  opts: { maxLines?: number; maxChars?: number } = {},
-): string {
-  const maxLines = opts.maxLines ?? 50;
-  const maxChars = opts.maxChars ?? 6000;
-  const sec = (result.durationMs / 1000).toFixed(2);
-  const lines: string[] = [];
-
-  lines.push(`**\$ git ${args}**`);
-  lines.push(`工作目录: \`${cwd}\``);
-  const exitDisplay = result.exitCode === null ? "(无)" : String(result.exitCode);
-  lines.push(`退出码: \`${exitDisplay}\` | 用时: \`${sec}s\``);
-  if (result.timedOut) lines.push(`⏱️ 命令超时被强制终止`);
-  if (result.truncated) lines.push(`⚠️ 输出超出采集上限，已截断`);
-  if (result.spawnError) lines.push(`❌ 启动失败: ${result.spawnError}`);
-
-  const stdoutTrim = result.stdout.trim();
-  const stderrTrim = result.stderr.trim();
-
-  if (stdoutTrim) {
-    lines.push("", "**stdout:**", "```", truncateContent(stdoutTrim, maxLines, maxChars), "```");
-  }
-  if (stderrTrim) {
-    lines.push("", "**stderr:**", "```", truncateContent(stderrTrim, maxLines, maxChars), "```");
-  }
-  if (!stdoutTrim && !stderrTrim && !result.spawnError) {
-    lines.push("", "_(命令无输出)_");
-  }
-
-  return lines.join("\n");
-}
-
-// ---------------------------------------------------------------------------
-// 头部颜色：成功绿色，失败红色，超时黄色
-// ---------------------------------------------------------------------------
-
-export function gitResultHeaderTemplate(result: GitCommandResult): string {
-  if (result.timedOut || result.spawnError) return "yellow";
-  if (result.exitCode === 0) return "green";
-  return "red";
-}

package/src/im-skills.ts

@@ -1,149 +0,0 @@
-import { readdir, readFile, mkdir, writeFile } from "node:fs/promises";
-import { join, dirname } from "node:path";
-
-import { PROJECT_ROOT } from "./config.ts";
-
-export const DEFAULT_IM_SKILLS_DIR = join(PROJECT_ROOT, "im-skills");
-
-export interface ImSkillVariableMap {
-  [key: string]: string | undefined;
-}
-
-export interface BuildImSkillsPromptInput {
-  skillsDir?: string;
-  enabledSkillNames?: readonly string[];
-  variables: ImSkillVariableMap;
-}
-
-interface ImSkillDoc {
-  name: string;
-  content: string;
-}
-
-function renderTemplate(template: string, variables: ImSkillVariableMap): string {
-  return template.replace(/\{\{\s*([a-zA-Z0-9_]+)\s*\}\}/g, (_match, key: string) => {
-    return variables[key] ?? "";
-  });
-}
-
-async function loadSkillDocs(skillsDir: string): Promise<ImSkillDoc[]> {
-  let entries;
-  try {
-    entries = await readdir(skillsDir, { withFileTypes: true });
-  } catch {
-    return [];
-  }
-
-  const docs = await Promise.all(
-    entries
-      .filter((entry) => entry.isDirectory())
-      .sort((a, b) => a.name.localeCompare(b.name))
-      .map(async (entry): Promise<ImSkillDoc | null> => {
-        const skillPath = join(skillsDir, entry.name, "skill.md");
-        try {
-          const content = await readFile(skillPath, "utf-8");
-          return { name: entry.name, content };
-        } catch {
-          return null;
-        }
-      }),
-  );
-  return docs.filter((doc): doc is ImSkillDoc => doc !== null);
-}
-
-export async function buildImSkillsPrompt(input: BuildImSkillsPromptInput): Promise<string> {
-  const skillsDir = input.skillsDir ?? DEFAULT_IM_SKILLS_DIR;
-  const enabledSkillNames = input.enabledSkillNames
-    ? new Set(input.enabledSkillNames)
-    : null;
-  const docs = await loadSkillDocs(skillsDir);
-  return docs
-    .filter((doc) => !enabledSkillNames || enabledSkillNames.has(doc.name))
-    .map((doc) => {
-      const rendered = renderTemplate(doc.content, input.variables).trim();
-      return [
-        `[ChatCCC IM skill: ${doc.name}]`,
-        rendered,
-        `[/ChatCCC IM skill: ${doc.name}]`,
-      ].join("\n");
-    })
-    .join("\n\n");
-}
-
-// ---------------------------------------------------------------------------
-// 会话级缓存：相同 session_id + cwd 的渲染结果完全相同，避免每轮重复读文件+渲染
-// ---------------------------------------------------------------------------
-
-const promptCache = new Map<string, string>();
-
-function promptCacheKey(input: BuildImSkillsPromptInput): string {
-  const names = input.enabledSkillNames
-    ? [...input.enabledSkillNames].sort().join(",")
-    : "*";
-  const { session_id, cwd } = input.variables;
-  return `${input.skillsDir ?? DEFAULT_IM_SKILLS_DIR}|${names}|${session_id}|${cwd}`;
-}
-
-/** 带会话级缓存的 buildImSkillsPrompt。同 session + 同 cwd 时直接返回缓存的渲染结果。 */
-export async function buildImSkillsPromptCached(input: BuildImSkillsPromptInput): Promise<string> {
-  const key = promptCacheKey(input);
-  const cached = promptCache.get(key);
-  if (cached !== undefined) return cached;
-  const result = await buildImSkillsPrompt(input);
-  promptCache.set(key, result);
-  return result;
-}
-
-/** 清除指定会话的缓存（如 /cd 后 cwd 变了，旧 key 不再需要） */
-export function clearImSkillsPromptCache(sessionId: string): void {
-  for (const key of promptCache.keys()) {
-    if (key.includes(`|${sessionId}|`)) promptCache.delete(key);
-  }
-}
-
-/**
- * 渲染技能目录下的子文档（skill.md 除外）并写入 outputDir。
- * 返回写入的文件路径列表。通常在会话初始化时调用，写入的文档供 Agent 按需读取。
- */
-export async function exportSkillSubDocs(
-  input: BuildImSkillsPromptInput,
-  outputDir: string,
-): Promise<string[]> {
-  const skillsDir = input.skillsDir ?? DEFAULT_IM_SKILLS_DIR;
-  const enabledSkillNames = input.enabledSkillNames
-    ? new Set(input.enabledSkillNames)
-    : null;
-  const files: string[] = [];
-
-  let entries;
-  try {
-    entries = await readdir(skillsDir, { withFileTypes: true });
-  } catch {
-    return files;
-  }
-
-  for (const entry of entries) {
-    if (!entry.isDirectory()) continue;
-    if (enabledSkillNames && !enabledSkillNames.has(entry.name)) continue;
-    const skillPath = join(skillsDir, entry.name);
-
-    let subFiles;
-    try {
-      subFiles = await readdir(skillPath);
-    } catch {
-      continue;
-    }
-
-    for (const sf of subFiles) {
-      if (sf === "skill.md" || !sf.endsWith(".md")) continue;
-      const content = await readFile(join(skillPath, sf), "utf-8");
-      const rendered = renderTemplate(content, input.variables);
-      const outPath = join(outputDir, entry.name, sf);
-      await mkdir(dirname(outPath), { recursive: true });
-      await writeFile(outPath, rendered, "utf-8");
-      files.push(outPath);
-    }
-  }
-
-  return files;
-}