tracetoon 1.0.0-rc.35 → 1.0.0-rc.37

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
- # tracetoon
1
+ <!-- Generated by scripts/agent-surfaces.ts. Do not edit by hand. -->
2
2
 
3
- Tracetoon writes GitHub pull request descriptions from the session logs coding
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
- ## For agents
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 # install the skill into every agent found, add the PR hook
12
- npx tracetoon@latest doctor --json # check git, gh and the install
12
+ npx tracetoon@latest setup
13
13
  ```
14
14
 
15
- `setup --json` reports what it installed; restart the agent afterwards. For a
16
- lasting `tracetoon` command (and a PR hook that outlives the npx cache), install
17
- it globally: `npm install -g tracetoon`, then `tracetoon setup`.
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
- Every command accepts `--json`; `tracetoon commands --json` lists them all.
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
- - Install routes for each agent host:
22
- https://github.com/Tracetoon/tracetoon/blob/main/docs/agents/install.md
23
- - How agents use Tracetoon:
24
- https://github.com/Tracetoon/tracetoon/blob/main/AGENTS.md
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
- Apache-2.0. Source and releases: https://github.com/Tracetoon/tracetoon
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.35",
4
- "description": "Write pull request descriptions from the AI agent session logs already on your machine. Run: npx tracetoon@latest setup",
3
+ "version": "1.0.0-rc.37",
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.35",
34
- "@tracetoon/cli-linux-arm64": "1.0.0-rc.35",
35
- "@tracetoon/cli-darwin-x64": "1.0.0-rc.35",
36
- "@tracetoon/cli-darwin-arm64": "1.0.0-rc.35",
37
- "@tracetoon/cli-win32-x64": "1.0.0-rc.35"
33
+ "@tracetoon/cli-linux-x64": "1.0.0-rc.37",
34
+ "@tracetoon/cli-linux-arm64": "1.0.0-rc.37",
35
+ "@tracetoon/cli-darwin-x64": "1.0.0-rc.37",
36
+ "@tracetoon/cli-darwin-arm64": "1.0.0-rc.37",
37
+ "@tracetoon/cli-win32-x64": "1.0.0-rc.37"
38
38
  }
39
39
  }
@@ -1 +1 @@
1
- 1.0.0-rc.35
1
+ 1.0.0-rc.37
@@ -1,7 +1,7 @@
1
1
  {
2
- "version": "1.0.0-rc.35",
3
- "buildId": "424332ac238a5a6270a70ce51488734868cabfe8381f7efb9198f2e31a387dae",
4
- "revision": "d8f854709196b05d9dec172ea6c1889cd24b68ca",
2
+ "version": "1.0.0-rc.37",
3
+ "buildId": "060da6295acdf20495efada145899bce6c74a6c045f797b4544abc4b0596a645",
4
+ "revision": "a6320f5ab507e10d6bc1f8c0c15c00fc76a82883",
5
5
  "protocol": 2,
6
6
  "dependencies": [
7
7
  {