Add execution trace recording

Author: whut09

.agent-context/architecture.md

@@ -9,8 +9,8 @@ This document is generated from static repository signals. Treat it as a startin
 - Internal modules: 25
 
 ## Important Modules
-- `outputs`: outputs contains 21 files and depends on core.
-- `test`: test contains 25 files and depends on analyzers, benchmarks, cli, config, core, mcp, outputs, retrievers.
+- `outputs`: outputs contains 22 files and depends on core.
+- `test`: test contains 26 files and depends on analyzers, benchmarks, cli, config, core, mcp, outputs, retrievers.
 - `core`: core contains 17 files and depends on analyzers, config, llm, outputs.
 - `retrievers`: retrievers contains 6 files and depends on core, outputs.
 - `analyzers`: analyzers contains 6 files and depends on core.

.agent-context/contracts/architecture.contract.json

@@ -113,7 +113,7 @@
       "imports": [
         "core"
       ],
-      "summary": "outputs contains 21 files and depends on core."
+      "summary": "outputs contains 22 files and depends on core."
     },
     {
       "name": "test",
@@ -130,7 +130,7 @@
         "outputs",
         "retrievers"
       ],
-      "summary": "test contains 25 files and depends on analyzers, benchmarks, cli, config, core, mcp, outputs, retrievers."
+      "summary": "test contains 26 files and depends on analyzers, benchmarks, cli, config, core, mcp, outputs, retrievers."
     },
     {
       "name": "core",

.agent-context/contracts/module-boundaries.json

@@ -34,6 +34,7 @@
         "src/outputs/contract-validator.ts",
         "src/outputs/contracts.ts",
         "src/outputs/dependency-graph.ts",
+        "src/outputs/execution-trace.ts",
         "src/outputs/impact.ts",
         "src/outputs/key-files.ts",
         "src/outputs/loop-controller.ts",

.agent-context/contracts/test.contract.json

@@ -11,6 +11,7 @@
     "test/cache.test.ts",
     "test/config.test.ts",
     "test/contract-validator.test.ts",
+    "test/execution-trace.test.ts",
     "test/fixtures.test.ts",
     "test/freshness.test.ts",
     "test/impact.test.ts",
@@ -91,6 +92,7 @@
     "src/cli/task-args.ts": [
       "test/task-args.test.ts"
     ],
+    "src/llm/provider.ts": [],
     "src/config/defaults.ts": [
       "test/config.test.ts",
       "test/scanner.test.ts",
@@ -113,13 +115,17 @@
       "benchmarks/fixtures/monorepo/packages/config/test/loader.test.ts",
       "test/fixtures/monorepo/packages/api/src/config.ts"
     ],
+    "src/mcp/server.ts": [
+      "test/mcp.test.ts"
+    ],
     "src/core/cache.ts": [
       "test/cache.test.ts"
     ],
     "src/core/context-builder.ts": [
       "test/agents-md.test.ts",
       "test/cache.test.ts",
       "test/contract-validator.test.ts",
+      "test/execution-trace.test.ts",
       "test/fixtures.test.ts",
       "test/freshness.test.ts",
       "test/impact.test.ts",
@@ -138,6 +144,7 @@
     ],
     "src/core/git.ts": [
       "test/contract-validator.test.ts",
+      "test/execution-trace.test.ts",
       "test/freshness.test.ts",
       "test/impact.test.ts",
       "test/loop-controller.test.ts",
@@ -170,30 +177,6 @@
       "test/contract-validator.test.ts",
       "test/validator.test.ts"
     ],
-    "src/llm/provider.ts": [],
-    "src/mcp/server.ts": [
-      "test/mcp.test.ts"
-    ],
-    "src/retrievers/external.ts": [
-      "test/retrievers.test.ts"
-    ],
-    "src/retrievers/hybrid.ts": [
-      "test/retrievers.test.ts"
-    ],
-    "src/retrievers/index.ts": [
-      "test/retrievers.test.ts",
-      "test/fixtures/monorepo/packages/api/src/index.ts",
-      "test/fixtures/monorepo/packages/web/src/index.ts"
-    ],
-    "src/retrievers/ripgrep.ts": [
-      "test/retrievers.test.ts"
-    ],
-    "src/retrievers/static.ts": [
-      "test/retrievers.test.ts"
-    ],
-    "src/retrievers/types.ts": [
-      "test/retrievers.test.ts"
-    ],
     "src/outputs/agents-md.ts": [
       "test/agents-md.test.ts"
     ],
@@ -204,6 +187,9 @@
     ],
     "src/outputs/contracts.ts": [],
     "src/outputs/dependency-graph.ts": [],
+    "src/outputs/execution-trace.ts": [
+      "test/execution-trace.test.ts"
+    ],
     "src/outputs/impact.ts": [
       "test/impact.test.ts"
     ],
@@ -227,6 +213,7 @@
       "test/task-harness.test.ts"
     ],
     "src/outputs/task-run.ts": [
+      "test/execution-trace.test.ts",
       "test/task-harness.test.ts"
     ],
     "src/outputs/test-selector.ts": [
@@ -242,6 +229,26 @@
       "test/validator.test.ts",
       "test/writer.test.ts"
     ],
+    "src/retrievers/external.ts": [
+      "test/retrievers.test.ts"
+    ],
+    "src/retrievers/hybrid.ts": [
+      "test/retrievers.test.ts"
+    ],
+    "src/retrievers/index.ts": [
+      "test/retrievers.test.ts",
+      "test/fixtures/monorepo/packages/api/src/index.ts",
+      "test/fixtures/monorepo/packages/web/src/index.ts"
+    ],
+    "src/retrievers/ripgrep.ts": [
+      "test/retrievers.test.ts"
+    ],
+    "src/retrievers/static.ts": [
+      "test/retrievers.test.ts"
+    ],
+    "src/retrievers/types.ts": [
+      "test/retrievers.test.ts"
+    ],
     "benchmarks/fixtures/fastapi-app/app/admin.py": [
       "test/fixtures.test.ts",
       "test/fixtures/monorepo/package.json",
@@ -718,8 +725,7 @@
       "test/fixtures/monorepo/packages/web/src/index.ts",
       "test/fixtures/next-app/src/app/api/login/route.ts"
     ],
-    "benchmarks/fixtures/monorepo/packages/config/src/loader.ts": [
-      "test/config.test.ts",
+    "benchmarks/fixtures/monorepo/packages/shared/src/metrics.ts": [
       "test/fixtures.test.ts",
       "test/fixtures/monorepo/package.json",
       "test/fixtures/monorepo/pnpm-workspace.yaml",
@@ -744,7 +750,8 @@
       "test/fixtures/monorepo/packages/web/src/index.ts",
       "test/fixtures/next-app/src/app/api/login/route.ts"
     ],
-    "benchmarks/fixtures/monorepo/packages/shared/src/metrics.ts": [
+    "benchmarks/fixtures/monorepo/packages/config/src/loader.ts": [
+      "test/config.test.ts",
       "test/fixtures.test.ts",
       "test/fixtures/monorepo/package.json",
       "test/fixtures/monorepo/pnpm-workspace.yaml",

.agent-context/dependency-graph.md

@@ -47,7 +47,7 @@ graph TD
 | cli | benchmarks | 1 |
 | cli | config | 1 |
 | cli | core | 8 |
-| cli | outputs | 10 |
+| cli | outputs | 11 |
 | cli | retrievers | 1 |
 | config | core | 2 |
 | core | analyzers | 4 |
@@ -65,8 +65,8 @@ graph TD
 | test | benchmarks | 1 |
 | test | cli | 1 |
 | test | config | 3 |
-| test | core | 29 |
+| test | core | 31 |
 | test | mcp | 1 |
-| test | outputs | 14 |
+| test | outputs | 16 |
 | test | retrievers | 1 |
 | test/fixtures/monorepo/packages/web | test/fixtures/monorepo/packages/api | 1 |