hillclimb 0.5.2 → 0.5.3

package/README.md

@@ -1,43 +1,32 @@
 # hillclimb
 
-Extract AI coding tool sessions (Claude Code, Cursor, Codex, opencode, GitHub Copilot Chat) and upload them to a Hillclimb project.
+Capture AI coding sessions and upload agent traces, ATIF traces, git traces, and
+debug logs to Hillclimb.
 
-## Quickstart
+Supported tools: Claude Code, Cursor, Codex, opencode, and GitHub Copilot Chat.
 
-```sh
-npx hillclimb
-```
+## Quickstart
 
-Run in any git repo. Sessions auto-upload when they end.
+Run once from a git repo:
 
 ```sh
-npx hillclimb status
+npx hillclimb
 ```
 
-Shows login and hook status for the current repo.
-
-## Hooks
-
-`hillclimb` detects which tools you use (`~/.claude`, `~/.cursor`, `~/.codex`, `~/.local/share/opencode`, VS Code GitHub Copilot Chat storage) and installs upload + git-trace hooks for each. You might want to gitignore the respective directories for the tools you use in your repo.
-
-To manually export historical logs instead of configuring auto-upload, run:
-
-```sh
-npx hillclimb export
-```
+Hillclimb signs you in, connects the repo to a project, installs local hooks for
+detected tools, and uploads future sessions automatically.
 
 ## Logs
 
-Hillclimb writes one log file per day to `~/.hillclimb/logs/YYYY-MM-DD.log`. Timestamps and the daily filename are in Pacific Time, so logs line up with Hillclimb's internal clock regardless of your timezone.
-
-Each hook firing tags every line it writes (parent + worker) with a short correlation ID, e.g. `[a1b2c3]`. To follow one flow across interleaved hook runs:
+Daily logs are written to:
 
 ```sh
-grep '\[a1b2c3\]' ~/.hillclimb/logs/$(TZ=America/Los_Angeles date +%F).log
+~/.hillclimb/logs/YYYY-MM-DD.log
 ```
 
-HTTP calls log method, path, status, and latency. Auth codes and presigned-URL signatures are deliberately omitted.
+If a hook reports `npx: command not found`, install Node/npm or make sure `npx`
+is available to the agent hook shell.
 
 ## License
 
-MIT — see [LICENSE](LICENSE).
+MIT - see [LICENSE](LICENSE).

package/dist/cli.js

@@ -14080,7 +14080,11 @@ var EXEC_OPTS = {
 };
 var MAX_ERROR_OUTPUT_CHARS = 2e3;
 var MAX_SNAPSHOT_FILE_BYTES = 10 * 1024 * 1024;
+var EXCLUDED_SNAPSHOT_EXTENSIONS = /* @__PURE__ */ new Set([".pdf"]);
 var EMPTY_TREE_SHA = "4b825dc642cb6eb9a060e54bf8d69288fbee4904";
+function hasExcludedSnapshotExtension(filePath) {
+  return EXCLUDED_SNAPSHOT_EXTENSIONS.has(path16.extname(filePath).toLowerCase());
+}
 function quoteGitArg(arg) {
   if (/^[A-Za-z0-9_./:=@%+,-]+$/.test(arg)) return arg;
   return JSON.stringify(arg);
@@ -14184,10 +14188,8 @@ function recordOmittedSnapshotFile(omittedFiles, file, options = {}) {
   omittedFiles?.push(file);
   if (options.log === false) return;
   const action = file.tracked ? "omitting tracked" : "skipping untracked";
-  appendLog(
-    "warn",
-    `git-traces: ${action} ${file.path} (${file.sizeBytes} bytes > ${MAX_SNAPSHOT_FILE_BYTES} limit)`
-  );
+  const reason = file.reason === "file-over-limit" ? `${file.sizeBytes} bytes > ${MAX_SNAPSHOT_FILE_BYTES} limit` : "excluded extension";
+  appendLog("warn", `git-traces: ${action} ${file.path} (${reason})`);
 }
 function parseLsTreeLongZ(output) {
   const entries = [];
@@ -14205,24 +14207,25 @@ function parseLsTreeLongZ(output) {
   }
   return entries;
 }
-function listOversizedTreeFiles(repoRoot, treeSha, options = {}) {
+function listOmittedTreeFiles(repoRoot, treeSha, options = {}) {
   const output = gitBuffer(repoRoot, ["ls-tree", "-r", "-l", "-z", treeSha]);
-  const oversized = [];
+  const omitted = [];
   for (const entry of parseLsTreeLongZ(output)) {
-    if (entry.sizeBytes <= MAX_SNAPSHOT_FILE_BYTES) continue;
+    const reason = hasExcludedSnapshotExtension(entry.path) ? "excluded-extension" : entry.sizeBytes > MAX_SNAPSHOT_FILE_BYTES ? "file-over-limit" : null;
+    if (!reason) continue;
     const file = {
       path: entry.path,
       sizeBytes: entry.sizeBytes,
       tracked: true,
-      reason: "file-over-limit",
+      reason,
       gitObjectSha: entry.sha
     };
-    oversized.push(file);
+    omitted.push(file);
     recordOmittedSnapshotFile(options.omittedFiles, file, {
       log: options.log
     });
   }
-  return oversized;
+  return omitted;
 }
 function removePathsFromIndex(repoRoot, env, paths) {
   if (paths.length === 0) return;
@@ -14231,9 +14234,9 @@ function removePathsFromIndex(repoRoot, env, paths) {
     env
   });
 }
-function filterOversizedFilesFromTree(repoRoot, treeSha, options = {}) {
-  const oversizedFiles = listOversizedTreeFiles(repoRoot, treeSha, options);
-  if (oversizedFiles.length === 0) return treeSha;
+function filterOmittedFilesFromTree(repoRoot, treeSha, options = {}) {
+  const omittedFiles = listOmittedTreeFiles(repoRoot, treeSha, options);
+  if (omittedFiles.length === 0) return treeSha;
   const tmpIndex = path16.join(
     os7.tmpdir(),
     `hillclimb-filter-${Date.now()}-${process.pid}`
@@ -14244,7 +14247,7 @@ function filterOversizedFilesFromTree(repoRoot, treeSha, options = {}) {
     removePathsFromIndex(
       repoRoot,
       env,
-      oversizedFiles.map((file) => file.path)
+      omittedFiles.map((file) => file.path)
     );
     return gitWithEnv(repoRoot, ["write-tree"], env);
   } finally {
@@ -14267,12 +14270,13 @@ function buildUntrackedTree(repoRoot, omittedFiles) {
     if (!relPath) continue;
     try {
       const stat = fs12.lstatSync(path16.join(repoRoot, relPath));
-      if (stat.size > MAX_SNAPSHOT_FILE_BYTES) {
+      const reason = hasExcludedSnapshotExtension(relPath) ? "excluded-extension" : stat.size > MAX_SNAPSHOT_FILE_BYTES ? "file-over-limit" : null;
+      if (reason) {
         recordOmittedSnapshotFile(omittedFiles, {
           path: relPath,
           sizeBytes: stat.size,
           tracked: false,
-          reason: "file-over-limit"
+          reason
         });
         continue;
       }
@@ -14301,7 +14305,7 @@ function buildUntrackedTree(repoRoot, omittedFiles) {
 }
 function buildSnapshotTree(repoRoot, stashSha, options = {}) {
   const trackedTree = git(repoRoot, ["rev-parse", `${stashSha}^{tree}`]);
-  const filteredTrackedTree = filterOversizedFilesFromTree(
+  const filteredTrackedTree = filterOmittedFilesFromTree(
     repoRoot,
     trackedTree,
     {
@@ -14373,14 +14377,14 @@ function createBundleFromTree(repoRoot, treeSha, sessionId, label) {
 }
 function createTreeDiffPatchGz(repoRoot, fromTreeSha, toTreeSha) {
   if (fromTreeSha === toTreeSha) return null;
-  const filteredFromTreeSha = filterOversizedFilesFromTree(
+  const filteredFromTreeSha = filterOmittedFilesFromTree(
     repoRoot,
     fromTreeSha,
     {
       log: false
     }
   );
-  const filteredToTreeSha = filterOversizedFilesFromTree(repoRoot, toTreeSha, {
+  const filteredToTreeSha = filterOmittedFilesFromTree(repoRoot, toTreeSha, {
     log: false
   });
   if (filteredFromTreeSha === filteredToTreeSha) return null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hillclimb",
-  "version": "0.5.2",
+  "version": "0.5.3",
   "description": "Extract and export AI coding tool logs grouped by repo",
   "license": "MIT",
   "type": "module",