Turbocharge Claude Code, Cursor, Codex, Gemini & every coding agent: faster, cheaper, with contextual understanding specific to your codebase.
TypeScript ai-agentsanthropicclaude-codeclicode-graphcodexcontext-engineeringcursordeveloper-toolsgeminiknowledge-graphllmmcpmcp-serveropen-sourceopenaitree-sitter
/**
* The activation count: at session start, a `learnings_committed` event when
* more learnings are committed on HEAD than at the last session in that clone,
* and nothing when the count is the same.
*/
import { test } from "node:test";
import assert from "node:assert/strict";
import { spawnSync } from "node:child_process";
import { mkdirSync, mkdtempSync, readFileSync, writeFileSync } from "node:fs";
import { tmpdir } from "node:os";
import { join } from "node:path";
import { trackLearningsCommitted } from "../src/claude/hooks.js";
import { queuePath } from "../src/telemetry/queue.js";
import { CI_ENV_VARS } from "../src/telemetry/gate.js";
import { tmpRepo } from "./helpers.js";
// A scratch home with telemetry on, so the queue can be read back.
const HOME = mkdtempSync(join(tmpdir(), "learnings-committed-home-"));
process.env.HOME = HOME;
process.env.USERPROFILE = HOME;
process.env.TRAIL_HOME = join(HOME, ".trail");
process.env.GRAFT_POSTHOG_KEY = "phc_test_key";
for (const k of ["DO_NOT_TRACK", ...CI_ENV_VARS]) delete process.env[k];
function git(d: string, args: string[]) {
spawnSync("git", ["-c", "commit.gpgsign=false", "-c", "user.name=Priya", "-c", "[email protected]", ...args], { cwd: d });
}
function commitLearning(d: string, name: string) {
mkdirSync(join(d, ".trail", "learnings"), { recursive: true });
writeFileSync(join(d, ".trail", "learnings", name), "---\ntitle: x\n---\n## Decided\ny\n");
git(d, ["add", "."]);
git(d, ["commit", "-qm", name]);
}
function sent(): { event: string; properties: Record<string, string> }[] {
try {
return readFileSync(queuePath(HOME), "utf8")
.split("\n")
.filter(Boolean)
.map((l) => JSON.parse(l))
.filter((e) => e.event === "learnings_committed");
} catch {
return [];
}
}
test("counted when committed learnings go up, not when they stay the same", () => {
const d = tmpRepo("learnings-committed");
git(d, ["init", "-q", "-b", "main"]);
commitLearning(d, "a.md");
trackLearningsCommitted(d);
assert.equal(sent().length, 1);
assert.equal(sent()[0]!.properties.first_look, "true", "a clone's first look is marked, so existing learnings aren't counted as new");
trackLearningsCommitted(d);
assert.equal(sent().length, 1, "the same count sends nothing");
// Written but not committed yet: not counted.
writeFileSync(join(d, ".trail", "learnings", "b.md"), "x");
trackLearningsCommitted(d);
assert.equal(sent().length, 1);
commitLearning(d, "b.md");
trackLearningsCommitted(d);
assert.equal(sent().length, 2);
assert.equal(sent()[1]!.properties.first_look, "false");
assert.ok(sent()[1]!.properties.added_bucket);
assert.ok(sent()[1]!.properties.total_bucket);
});
test("uncommitted repo learnings are mentioned once a day, naming who'd get them", async () => {
const { uncommittedDirective } = await import("../src/claude/hooks.js");
const d = tmpRepo("uncommitted");
git(d, ["init", "-q", "-b", "main"]);
writeFileSync(join(d, "a.go"), "package a\n");
git(d, ["add", "."]);
spawnSync("git", ["-c", "commit.gpgsign=false", "-c", "user.name=Anay Shah", "-c", "[email protected]", "commit", "-qm", "a"], { cwd: d });
spawnSync("git", ["config", "user.name", "Priya"], { cwd: d });
spawnSync("git", ["config", "user.email", "[email protected]"], { cwd: d });
assert.equal(uncommittedDirective(d), "", "nothing waiting");
mkdirSync(join(d, ".trail", "learnings"), { recursive: true });
writeFileSync(join(d, ".trail", "learnings", "x.md"), "---\ntitle: x\n---\n");
const said = uncommittedDirective(d);
assert.match(said, /1 learning added to this repo \(in \.trail\/learnings\/\) isn't committed yet, so no teammate's agent has it/);
assert.doesNotMatch(said, /team learning/, "learnings in .trail/learnings are repo learnings, added to this repo");
assert.match(said, /🌱 Anay works in this repo\. Commit what you learned and their agents get to a PR 3x faster$/m);
assert.equal(uncommittedDirective(d), "", "once a day");
const nextDay = Date.now() + 25 * 3600_000;
writeFileSync(join(d, ".trail", "learnings", "y.md"), "---\ntitle: y\n---\n");
assert.match(uncommittedDirective(d, nextDay), /2 learnings added to this repo \(in \.trail\/learnings\/\) aren't committed yet, so no teammate's agent has them/, "and again the next day while they're still waiting");
});