tracetoon 1.0.0-rc.35 → 1.0.0-rc.36
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md
CHANGED
|
@@ -1,30 +1,68 @@
|
|
|
1
|
-
|
|
1
|
+
<!-- Generated by scripts/agent-surfaces.ts. Do not edit by hand. -->
|
|
2
2
|
|
|
3
|
-
Tracetoon
|
|
4
|
-
agents already keep on disk, checks every claim against that evidence, and can
|
|
5
|
-
add a one-off comic. This package runs the prebuilt `tracetoon` binary for your
|
|
6
|
-
platform and ships the Tracetoon agent skill.
|
|
3
|
+
# Tracetoon
|
|
7
4
|
|
|
8
|
-
|
|
5
|
+
**PRs with receipts. And comics.**
|
|
6
|
+
|
|
7
|
+
Your coding agent already kept the receipts: what you asked for, what it
|
|
8
|
+
changed, what actually ran. Tracetoon turns them into a pull request reviewers
|
|
9
|
+
can trust. It works with Claude Code, Codex, Antigravity, Factory Droid, Copilot, Cursor, OpenCode, Kilo CLI, Kiro, Cline, Junie, Devin, Goose, Qwen Code and Crush.
|
|
9
10
|
|
|
10
11
|
```sh
|
|
11
|
-
npx tracetoon@latest setup
|
|
12
|
-
npx tracetoon@latest doctor --json # check git, gh and the install
|
|
12
|
+
npx tracetoon@latest setup
|
|
13
13
|
```
|
|
14
14
|
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
15
|
+
That installs the Tracetoon skill into every agent it finds and adds a hook, so
|
|
16
|
+
the next time you ask your agent to open a PR, Tracetoon writes it. Restart the
|
|
17
|
+
agent afterwards.
|
|
18
18
|
|
|
19
|
-
|
|
19
|
+
## Why use it
|
|
20
|
+
|
|
21
|
+
- **Written from what happened.** Your agent already logged what you asked for, what it changed and which commands ran; Tracetoon writes the description from that record, so it can say why the change was made and what was tested, not just what the diff shows.
|
|
22
|
+
- **Every claim checked.** Each factual sentence has to trace back to the session evidence, independent reviewers check the draft, and the Validation section comes from recorded test and build runs instead of being typed by the model.
|
|
23
|
+
- **Cheaper to write.** A compact, cited evidence brief built in an embedded graph database lets the agent draft without rereading raw logs.
|
|
24
|
+
- **Safe to post.** Private paths and secrets are redacted from the evidence, a leak scan runs before anything is posted, and you approve the PR first.
|
|
25
|
+
- **Follows the house rules.** It reads the repository's PR template, contribution guide and AI-disclosure policy and writes to them.
|
|
26
|
+
- **Works with your agents.** Claude Code, Codex, Antigravity, Factory Droid, Copilot, Cursor, OpenCode, Kilo CLI, Kiro, Cline, Junie, Devin, Goose, Qwen Code and Crush, as an agent skill, a CLI or an MCP server.
|
|
27
|
+
- **A comic on top.** An optional one-off comic about the change, which reviewers actually read.
|
|
20
28
|
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
29
|
+
## Results
|
|
30
|
+
|
|
31
|
+
| | |
|
|
32
|
+
| --- | --- |
|
|
33
|
+
| **83–34** | judges preferred the evidence-graph PR on Codex |
|
|
34
|
+
| **69–17** | judges preferred it on Claude Code |
|
|
35
|
+
| **−46% / −31%** | cost per PR on Codex / Claude Code |
|
|
36
|
+
|
|
37
|
+
prbench: 61 real PRs from 12 repositories, each written 3 times by each workflow, 2 AI judges per provider in both orders (732 judgments per provider), factual errors checked by two expert models. Compared with Tracetoon's earlier multi-agent workflow. Full results, methods and caveats: https://tracetoon.ai/evidence-graph-61.html
|
|
38
|
+
|
|
39
|
+
## Install for good
|
|
40
|
+
|
|
41
|
+
For a lasting `tracetoon` command (and a PR hook that outlives the npx cache):
|
|
42
|
+
`npm install -g tracetoon`, then `tracetoon setup`. Other routes (the curl
|
|
43
|
+
and PowerShell installers, plugin marketplaces):
|
|
44
|
+
https://github.com/Tracetoon/tracetoon#-quick-start
|
|
25
45
|
|
|
26
46
|
Needs `git` and the GitHub CLI (`gh`), signed in. Prebuilt binaries: Linux and
|
|
27
47
|
macOS (x64, arm64), Windows x64. The binary comes from an optional dependency
|
|
28
48
|
(`@tracetoon/cli-<platform>-<arch>`), so don't install with `--omit=optional`.
|
|
29
49
|
|
|
30
|
-
|
|
50
|
+
## For agents
|
|
51
|
+
|
|
52
|
+
```sh
|
|
53
|
+
npx tracetoon@latest setup --json # install the skill into every agent found, add the PR hook
|
|
54
|
+
npx tracetoon@latest doctor --json # check git, gh and the install
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
Every command accepts `--json`; `tracetoon commands --json` lists them all.
|
|
58
|
+
`tracetoon mcp` serves the same flow over MCP on stdio.
|
|
59
|
+
|
|
60
|
+
- How agents use Tracetoon: https://github.com/Tracetoon/tracetoon/blob/main/AGENTS.md
|
|
61
|
+
- Install routes for each agent host: https://github.com/Tracetoon/tracetoon/blob/main/docs/agents/install.md
|
|
62
|
+
|
|
63
|
+
## Links
|
|
64
|
+
|
|
65
|
+
- Website: https://tracetoon.ai
|
|
66
|
+
- Source, issues and releases: https://github.com/Tracetoon/tracetoon
|
|
67
|
+
|
|
68
|
+
Apache-2.0.
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "tracetoon",
|
|
3
|
-
"version": "1.0.0-rc.
|
|
4
|
-
"description": "
|
|
3
|
+
"version": "1.0.0-rc.36",
|
|
4
|
+
"description": "Pull request descriptions written from your AI coding agent’s session logs, with every claim checked against the evidence. Better PRs at lower cost. Run: npx tracetoon@latest setup",
|
|
5
5
|
"license": "Apache-2.0",
|
|
6
6
|
"homepage": "https://tracetoon.ai",
|
|
7
7
|
"repository": {
|
|
@@ -30,10 +30,10 @@
|
|
|
30
30
|
"node": ">=18"
|
|
31
31
|
},
|
|
32
32
|
"optionalDependencies": {
|
|
33
|
-
"@tracetoon/cli-linux-x64": "1.0.0-rc.
|
|
34
|
-
"@tracetoon/cli-linux-arm64": "1.0.0-rc.
|
|
35
|
-
"@tracetoon/cli-darwin-x64": "1.0.0-rc.
|
|
36
|
-
"@tracetoon/cli-darwin-arm64": "1.0.0-rc.
|
|
37
|
-
"@tracetoon/cli-win32-x64": "1.0.0-rc.
|
|
33
|
+
"@tracetoon/cli-linux-x64": "1.0.0-rc.36",
|
|
34
|
+
"@tracetoon/cli-linux-arm64": "1.0.0-rc.36",
|
|
35
|
+
"@tracetoon/cli-darwin-x64": "1.0.0-rc.36",
|
|
36
|
+
"@tracetoon/cli-darwin-arm64": "1.0.0-rc.36",
|
|
37
|
+
"@tracetoon/cli-win32-x64": "1.0.0-rc.36"
|
|
38
38
|
}
|
|
39
39
|
}
|
package/skill/tracetoon/VERSION
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
1.0.0-rc.
|
|
1
|
+
1.0.0-rc.36
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
|
-
"version": "1.0.0-rc.
|
|
3
|
-
"buildId": "
|
|
4
|
-
"revision": "
|
|
2
|
+
"version": "1.0.0-rc.36",
|
|
3
|
+
"buildId": "c0045bdb8cb1f52c58c604c7bd047ac4c859905d3aec5133bacde214faa8372e",
|
|
4
|
+
"revision": "c549db768d317db8dfdc3ee7bbec625428e7b35a",
|
|
5
5
|
"protocol": 2,
|
|
6
6
|
"dependencies": [
|
|
7
7
|
{
|