@aiti-ai/aiti-git-trace 0.0.0-stage → 0.2.12

package/trace-files-row.test.mjs

@@ -0,0 +1,66 @@
+/**
+ * trace-files-row 纯函数矩阵测试（方案 docs/aiti-git-trace-message-files-ext-plan.md §3.3）。
+ *
+ * 覆盖：增量口径、entryId 聚合、跨 store/op 去重、相对→绝对路径、writtenFiles 差集、
+ * 空态（无命中/全无增量/空 id 集合）。组件层（取数/渲染）在 trace-files-row.tsx，不在此覆盖。
+ */
+import assert from "node:assert/strict";
+import test from "node:test";
+import { rowHasDelta, toAbsPath, aggregateTraceTurnFiles, diffAgainstWritten } from "./client/src/trace-files-row.pure.ts";
+
+const store = (over = {}) => ({
+  root: "/repo",
+  before: "aaa",
+  files: { M: 1, A: 0, D: 0 },
+  paths: ["a.ts"],
+  ...over,
+});
+
+test("rowHasDelta：纯基线 op（before=null）且无 leaks → false（与徽标/时间线口径一致）", () => {
+  assert.equal(rowHasDelta({ stores: [{ root: "/r", before: null, files: { M: 1 } }], leaks: [] }), false);
+  assert.equal(rowHasDelta({ stores: [store()], leaks: [] }), true);
+  assert.equal(rowHasDelta({ stores: [{ root: "/r", before: null }], leaks: [{}] }), true);
+  assert.equal(rowHasDelta({ stores: [store({ files: { M: 0, A: 0, D: 0 } })], leaks: [] }), false);
+});
+
+test("toAbsPath：相对拼 root，绝对原样，Windows 盘符原样", () => {
+  assert.equal(toAbsPath("/repo", "src/a.ts"), "/repo/src/a.ts");
+  assert.equal(toAbsPath("/repo/", "src/a.ts"), "/repo/src/a.ts");
+  assert.equal(toAbsPath("/repo", "/abs/a.ts"), "/abs/a.ts");
+  assert.equal(toAbsPath(undefined, "C:\\repo\\a.ts"), "C:\\repo\\a.ts");
+  assert.equal(toAbsPath("/repo", ""), "");
+});
+
+test("aggregateTraceTurnFiles：按 entryId 聚合本轮，跨 op/store 去重保首见序", () => {
+  const rows = [
+    { entryId: "e1", stores: [store({ paths: ["a.ts", "b.ts"] })] },
+    { entryId: "e2", stores: [store({ paths: ["b.ts", "c.ts"] }), store({ root: "/repo2", paths: ["d.ts"] })] },
+    { entryId: "e9", stores: [store({ paths: ["x.ts"] })] }, // 不在本轮
+  ];
+  const info = aggregateTraceTurnFiles(rows, ["e1", "e2"]);
+  assert.deepEqual(info.absPaths, ["/repo/a.ts", "/repo/b.ts", "/repo/c.ts", "/repo2/d.ts"]);
+  assert.equal(info.ops, 2);
+  assert.equal(info.truncated, false);
+});
+
+test("aggregateTraceTurnFiles：无命中 / 全无增量 / 空 id 集合 → null", () => {
+  assert.equal(aggregateTraceTurnFiles([{ entryId: "e1", stores: [store()] }], []), null);
+  assert.equal(aggregateTraceTurnFiles([{ entryId: "e2", stores: [store()] }], ["e1"]), null);
+  assert.equal(aggregateTraceTurnFiles([{ entryId: "e1", stores: [{ root: "/r", before: null, paths: ["a.ts"] }] }], ["e1"]), null);
+  assert.equal(aggregateTraceTurnFiles(null, ["e1"]), null);
+});
+
+test("aggregateTraceTurnFiles：pathsTruncated 任一 store 命中即置位", () => {
+  const info = aggregateTraceTurnFiles([{ entryId: "e1", stores: [store({ pathsTruncated: true, paths: ["a.ts"] })] }], ["e1"]);
+  assert.equal(info.truncated, true);
+});
+
+test("diffAgainstWritten：归一分隔符后求差集，保 trace 首见序", () => {
+  const extra = diffAgainstWritten(
+    ["/repo/a.ts", "/repo/b.ts", "/repo/sub/c.ts"],
+    ["/repo/b.ts", "/repo/sub/c.ts".replace(/\//g, "\\")],
+  );
+  assert.deepEqual(extra, ["/repo/a.ts"]);
+  assert.deepEqual(diffAgainstWritten(["/repo/a.ts"], []), ["/repo/a.ts"]);
+  assert.deepEqual(diffAgainstWritten([], ["/repo/a.ts"]), []);
+});

package/tsconfig.check.json

@@ -0,0 +1,21 @@
+{
+  "compilerOptions": {
+    "target": "es2020",
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "jsx": "react-jsx",
+    "jsxImportSource": "react",
+    "strict": false,
+    "noImplicitAny": false,
+    "noEmit": true,
+    "skipLibCheck": true,
+    "allowJs": false,
+    "baseUrl": ".",
+    "paths": {
+      "react": ["client/src/host-shim.ts"],
+      "react/jsx-runtime": ["client/src/jsx-runtime.ts"],
+      "react/jsx-dev-runtime": ["client/src/jsx-runtime.ts"]
+    }
+  },
+  "include": ["client/src/**/*.ts", "client/src/**/*.tsx"]
+}

package/version-mention.test.mjs

@@ -0,0 +1,76 @@
+/**
+ * version-mention 纯函数单测（docs/aiti-git-trace-timeline-file-actions-plan.md §3 / E4）。
+ *
+ * 覆盖：@ token 纯路径、边路仓 show/diff 命令、无 target 回退、base==target 去重、
+ * 行号映射（hunk 头 / +/−/ctx 行、hunk 前内容）。
+ */
+import assert from "node:assert/strict";
+import test from "node:test";
+import { buildVersionMention, resolveDiffLineInfo } from "./client/src/version-mention.ts";
+
+test("buildVersionMention：有 base/target + 行号 → @ token + 边路仓 show+diff 命令", () => {
+  const s = buildVersionMention({ path: "src/a.ts", root: "/repo", base: "aaa111", target: "bbb222", line: 120, lineKind: "new" });
+  assert.ok(s.startsWith("@src/a.ts "), "at token 纯路径（带尾空格）");
+  assert.ok(s.includes("after=bbb222"), "短 hash 摘要");
+  assert.ok(s.includes("base=aaa111"), "base 短 hash");
+  assert.ok(s.includes("行120(新文件)"), "行号+新文件标注");
+  assert.ok(s.includes("git --git-dir=/repo/.aiti-trace --work-tree=/repo show bbb222:src/a.ts"), "完整 hash show 命令");
+  assert.ok(s.includes("diff aaa111..bbb222 -- src/a.ts"), "区间 diff 命令");
+});
+
+test("buildVersionMention：无 base → 只 show 命令，无 diff", () => {
+  const s = buildVersionMention({ path: "a.ts", root: "/r", target: "ccc333" });
+  assert.ok(s.includes("after=ccc333"));
+  assert.ok(s.includes("show ccc333:a.ts"));
+  assert.ok(!s.includes("diff "), "无 base 不出 diff 命令");
+});
+
+test("buildVersionMention：无 target（loose 工作区）→ 回退工作区版本附文", () => {
+  const s = buildVersionMention({ path: "a.ts", root: "/r" });
+  assert.ok(s.startsWith("@a.ts "));
+  assert.ok(s.includes("无边路 commit"), "回退提示");
+  assert.ok(!s.includes("git --git-dir"));
+});
+
+test("buildVersionMention：base==target → 不重复 base 段", () => {
+  const s = buildVersionMention({ path: "a.ts", root: "/r", base: "xxx", target: "xxx" });
+  assert.ok(!s.includes("base="), "base==target 去重");
+  assert.ok(s.includes("after=xxx"));
+  assert.ok(!s.includes("diff "), "base==target 不出 diff");
+});
+
+test("buildVersionMention：root 尾斜杠归一", () => {
+  const s = buildVersionMention({ path: "a.ts", root: "/r/", target: "ddd" });
+  assert.ok(s.includes("--git-dir=/r/.aiti-trace"), "尾斜杠被去");
+  assert.ok(s.includes("--work-tree=/r "), "work-tree 无重复斜杠");
+});
+
+test("resolveDiffLineInfo：hunk 头 + +/−/ctx 行号映射", () => {
+  const lines = ["diff --git a b", "index 123..456", "@@ -10,3 +20,3 @@", " ctx", "+add", "-del"];
+  // hunk 前内容 → other
+  assert.equal(resolveDiffLineInfo(lines, 0).lineKind, "other");
+  assert.equal(resolveDiffLineInfo(lines, 0).line, null);
+  // hunk 头
+  assert.deepEqual(resolveDiffLineInfo(lines, 2), { line: null, lineKind: "hunk" });
+  // ctx 行 → new line 20（上下文 old/new 同步推进，但返回 new）
+  assert.equal(resolveDiffLineInfo(lines, 3).line, 20);
+  assert.equal(resolveDiffLineInfo(lines, 3).lineKind, "context");
+  // +add 行 → new line 21
+  assert.equal(resolveDiffLineInfo(lines, 4).line, 21);
+  assert.equal(resolveDiffLineInfo(lines, 4).lineKind, "new");
+  // -del 行 → old line 11（ctx 推进 old 10→11）
+  assert.equal(resolveDiffLineInfo(lines, 5).line, 11);
+  assert.equal(resolveDiffLineInfo(lines, 5).lineKind, "old");
+});
+
+test("resolveDiffLineInfo：多 hunk 跳转后行号正确重置", () => {
+  const lines = [
+    "@@ -10,2 +20,2 @@",
+    " ctx1",      // ctx: new=20,old=10 → 推进 new=21,old=11
+    "+add1",      // +: new=21 → 推进 new=22
+    "@@ -50,1 +60,1 @@",
+    "+add2",      // +: new=60
+  ];
+  assert.equal(resolveDiffLineInfo(lines, 4).line, 60);
+  assert.equal(resolveDiffLineInfo(lines, 4).lineKind, "new");
+});

package/vite.config.ts

@@ -0,0 +1,43 @@
+/**
+ * aiti-git-trace client 构建配置（Vite lib mode）——JSX 模板实例。
+ *
+ * client/src/entry.tsx（JSX + TS）→ 单个 ESM bundle：client/aiti-git-trace-client.mjs
+ * （与 index.ts 的 client 字段一致；产物覆盖原手写版，源码在 git 历史可回溯）。
+ *
+ * 模板与原理：pi-web-ext/templates/ext-jsx-client/ + docs/aiti-ext-jsx-vite-plan.md
+ * 三个必踩的坑（模板已修好，勿回退）：jsx automatic / 正则 alias / external []。
+ */
+import { defineConfig } from "vite";
+import { fileURLToPath } from "node:url";
+
+export default defineConfig({
+  esbuild: {
+    jsx: "automatic",
+    jsxImportSource: "react",
+  },
+  resolve: {
+    alias: [
+      // 正则精确匹配（字符串 alias 是前缀匹配，find 'react' 会吞掉 'react/jsx-runtime'）
+      { find: /^react\/jsx-dev-runtime$/, replacement: fileURLToPath(new URL("client/src/jsx-runtime.ts", import.meta.url)) },
+      { find: /^react\/jsx-runtime$/, replacement: fileURLToPath(new URL("client/src/jsx-runtime.ts", import.meta.url)) },
+      { find: /^react$/, replacement: fileURLToPath(new URL("client/src/host-shim.ts", import.meta.url)) },
+    ],
+  },
+  build: {
+    lib: {
+      entry: fileURLToPath(new URL("client/src/entry.tsx", import.meta.url)),
+      formats: ["es"],
+      fileName: () => "aiti-git-trace-client.mjs",
+    },
+    outDir: "dist",
+    emptyOutDir: true,
+    target: "es2020",
+    // 薄壳拆分（2026-09-13）：panels chunk 由浏览器按需直接拉取（不再经宿主批量包二次
+    // minify），必须自身压缩；entry 顺带压缩（批量包再压一次无罩）。
+    minify: true,
+    sourcemap: false,
+    rollupOptions: {
+      external: [], // npm 包全部内联进单个 .mjs
+    },
+  },
+});