Skip to content

Solution for long term memory for agent coding CLIs and to facilitate handoff between different agent vendors

Rust

fix(cli): find Claude backfill transcripts by real path

AkitaOnRails00b5c307ed01
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 04b3829d..b7e8d725 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -11,6 +11,13 @@ version in [`docs/changelog/`](docs/changelog/):
## [Unreleased]
+### Fixed
+
+- Claude Code backfill-close now finds transcripts for project paths that
+ contain dots, underscores, spaces, or non-ASCII characters, so an abandoned
+ session's token usage is retained when its synthetic `session-end` is
+ captured (#1858).
+
## [3.3.0] - 2026-10-29
### Added
diff --git a/crates/ai-memory-cli/src/commands/session_usage.rs b/crates/ai-memory-cli/src/commands/session_usage.rs
index 4199a9ae..f8103c3a 100644
--- a/crates/ai-memory-cli/src/commands/session_usage.rs
+++ b/crates/ai-memory-cli/src/commands/session_usage.rs
@@ -540,9 +540,8 @@ pub fn locate_codex_rollout(codex_home: &Path, session_id: &str) -> Option<PathB
/// `session-end` payload already carries `transcript_path` directly, so
/// this is only needed for a *different*, earlier session). Claude Code
/// stores each session at `<claude_config_dir>/projects/<flattened
-/// cwd>/<session_id>.jsonl`, flattening `cwd` by turning every `/`, `\`,
-/// and `:` into `-` — verified against real transcript directories on a
-/// live install (`C:\Users\...\ai-memory` → `C--Users-...-ai-memory`).
+/// cwd>/<session_id>.jsonl`, flattening `cwd` by turning every character
+/// outside `[A-Za-z0-9]` into `-`.
#[must_use]
pub fn locate_claude_code_transcript(
claude_config_dir: &Path,
@@ -556,16 +555,7 @@ pub fn locate_claude_code_transcript(
{
return None;
}
- let flattened: String = cwd
- .chars()
- .map(|c| {
- if matches!(c, '/' | '\\' | ':') {
- '-'
- } else {
- c
- }
- })
- .collect();
+ let flattened = ai_memory_workstream::claude_project_dir_name(Path::new(cwd));
let path = claude_config_dir
.join("projects")
.join(flattened)
@@ -1015,34 +1005,30 @@ mod tests {
}
#[test]
- fn locate_claude_code_transcript_flattens_windows_and_posix_cwd() {
+ fn locate_claude_code_transcript_uses_claudes_project_folder_rule() {
let tmp = tempfile::tempdir().unwrap();
- let windows_dir = tmp
- .path()
- .join("projects")
- .join("C--Users-alice-Projects-app");
- std::fs::create_dir_all(&windows_dir).unwrap();
- let windows_target = windows_dir.join("9fc72c68-53ac-4d50-82aa-135f7ab03b7d.jsonl");
- std::fs::write(&windows_target, "").unwrap();
- let found = locate_claude_code_transcript(
- tmp.path(),
- r"C:\Users\alice\Projects\app",
- "9fc72c68-53ac-4d50-82aa-135f7ab03b7d",
- )
- .unwrap();
- assert_eq!(found, windows_target);
+ let session_id = "9fc72c68-53ac-4d50-82aa-135f7ab03b7d";
+ for (cwd, folder) in [
+ (
+ "/home/me/src/github.com/acme/api",
+ "-home-me-src-github-com-acme-api",
+ ),
+ ("/home/me/my_app", "-home-me-my-app"),
+ ("/home/me/my repo", "-home-me-my-repo"),
+ ("/home/me/café", "-home-me-caf-"),
+ (r"C:\Users\me\my.repo", "C--Users-me-my-repo"),
+ ] {
+ let project_dir = tmp.path().join("projects").join(folder);
+ std::fs::create_dir_all(&project_dir).unwrap();
+ let target = project_dir.join(format!("{session_id}.jsonl"));
+ std::fs::write(&target, "").unwrap();
- let posix_dir = tmp.path().join("projects").join("-home-alice-proj");
- std::fs::create_dir_all(&posix_dir).unwrap();
- let posix_target = posix_dir.join("deadbeef-0000-0000-0000-000000000000.jsonl");
- std::fs::write(&posix_target, "").unwrap();
- let found = locate_claude_code_transcript(
- tmp.path(),
- "/home/alice/proj",
- "deadbeef-0000-0000-0000-000000000000",
- )
- .unwrap();
- assert_eq!(found, posix_target);
+ assert_eq!(
+ locate_claude_code_transcript(tmp.path(), cwd, session_id),
+ Some(target),
+ "{cwd}"
+ );
+ }
}
#[test]
diff --git a/crates/ai-memory-workstream/src/lib.rs b/crates/ai-memory-workstream/src/lib.rs
index 75390bae..9f4d0548 100644
--- a/crates/ai-memory-workstream/src/lib.rs
+++ b/crates/ai-memory-workstream/src/lib.rs
@@ -27,9 +27,10 @@ pub use repository::{
pub use transcript::{
AmbiguousNativeSession, ClaudeContinuation, ExportedTranscript, NativeSessionCandidate,
OVERSIZED_RECORD_LOSS, RECORD_CWD_KEY, SKIPPED_RECORD_KEY, claude_continued_session,
- claude_continued_sessions, claude_live_background_attach_id, claude_session_ran_in_background,
- discover_native_session, export_transcript, export_transcript_delta, export_transcript_range,
- kiro_harness_from_source_cursor, kiro_v3_resume_uses_default_store, list_native_sessions,
- native_memory_dir, native_session_exists, native_session_in_checkout, native_store_root,
- transcript_baseline, transcript_interval_digests, wait_for_transcript_flush,
+ claude_continued_sessions, claude_live_background_attach_id, claude_project_dir_name,
+ claude_session_ran_in_background, discover_native_session, export_transcript,
+ export_transcript_delta, export_transcript_range, kiro_harness_from_source_cursor,
+ kiro_v3_resume_uses_default_store, list_native_sessions, native_memory_dir,
+ native_session_exists, native_session_in_checkout, native_store_root, transcript_baseline,
+ transcript_interval_digests, wait_for_transcript_flush,
};
diff --git a/crates/ai-memory-workstream/src/transcript.rs b/crates/ai-memory-workstream/src/transcript.rs
index 4823877a..4c33d95a 100644
--- a/crates/ai-memory-workstream/src/transcript.rs
+++ b/crates/ai-memory-workstream/src/transcript.rs
@@ -3874,7 +3874,8 @@ fn names_session(path: &Path, id: &str) -> bool {
/// The folder Claude Code keeps a project's transcripts in: the cwd with
/// every character outside `[A-Za-z0-9]` replaced by `-`, so `/a/b.c_d` is
/// `-a-b-c-d` and `C:\\Users\\me` is `C--Users-me`.
-fn claude_project_dir_name(cwd: &Path) -> String {
+#[must_use]
+pub fn claude_project_dir_name(cwd: &Path) -> String {
cwd.to_string_lossy()
.chars()
.map(|c| if c.is_ascii_alphanumeric() { c } else { '-' })