agent-session-analytics 0.2.0__tar.gz → 0.2.1__tar.gz

{agent_session_analytics-0.2.0 → agent_session_analytics-0.2.1}/.gitignore

@@ -13,6 +13,9 @@ __pycache__/
 .cheese/
 .context/
 
+# Skill archives: build output. `just build` writes them; CI publishes them on dist (ADR-012).
+skills/*/scripts/*.pyz
+
 # Skill-creator iteration workspaces (eval runs, benchmarks, viewer HTML)
 skills/*-workspace/
 

{agent_session_analytics-0.2.0 → agent_session_analytics-0.2.1}/CHANGELOG.md

@@ -13,6 +13,12 @@ Push a `agent-session-analytics-v<version>` tag after the release commit merges.
 
 ## [Unreleased]
 
+## [0.2.1] - 2026-10-25
+
+### Changed
+
+- The default database path is now `<cache>/agent-session-analytics/sessions.duckdb`, not `<cache>/dotfiles/session-analytics/sessions.duckdb`. If the new file does not exist and the legacy file exists, the package keeps using the legacy file. It never moves, copies, or deletes the legacy file. `SESSIONS_DB` still overrides both.
+
 ## [0.2.0] - 2026-10-24
 
 ### Changed
@@ -61,6 +67,7 @@ Push a `agent-session-analytics-v<version>` tag after the release commit merges.
 
 - The canned `query.sh` reports. Callers write their own SQL with `sql`.
 
-[Unreleased]: https://github.com/paulnsorensen/skillz-that-grillz/compare/agent-session-analytics-v0.2.0...HEAD
+[Unreleased]: https://github.com/paulnsorensen/skillz-that-grillz/compare/agent-session-analytics-v0.2.1...HEAD
+[0.2.1]: https://github.com/paulnsorensen/skillz-that-grillz/compare/agent-session-analytics-v0.2.0...agent-session-analytics-v0.2.1
 [0.2.0]: https://github.com/paulnsorensen/skillz-that-grillz/compare/agent-session-analytics-v0.1.0...agent-session-analytics-v0.2.0
 [0.1.0]: https://github.com/paulnsorensen/skillz-that-grillz/releases/tag/agent-session-analytics-v0.1.0

{agent_session_analytics-0.2.0 → agent_session_analytics-0.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: agent-session-analytics
-Version: 0.2.0
+Version: 0.2.1
 Summary: Ingest coding-agent session logs into DuckDB and query them read-only.
 Project-URL: Homepage, https://github.com/paulnsorensen/skillz-that-grillz/tree/main/packages/agent-session-analytics
 Project-URL: Source, https://github.com/paulnsorensen/skillz-that-grillz/tree/main/packages/agent-session-analytics
@@ -96,8 +96,10 @@ A consumer that queries the database directly runs
 - `SESSIONS_DB` names the database. A relative value joins the current
   directory. The package does not expand `~` in a set value.
 - Otherwise an absolute `XDG_CACHE_HOME` selects
-  `<cache>/dotfiles/session-analytics/sessions.duckdb`. A relative or unset
-  value uses `~/.cache`.
+  `<cache>/agent-session-analytics/sessions.duckdb`. A relative or unset
+  value uses `~/.cache`. If that file does not exist and the legacy
+  `<cache>/dotfiles/session-analytics/sessions.duckdb` exists, the package uses
+  the legacy file. It never moves, copies, or deletes the legacy file.
 - `SESSIONS_DUCKDB_MEMORY_LIMIT` sets the DuckDB memory limit, from 16MiB up to
   but not including 16EiB. The default is `4GB`.
 - `SESSIONS_DUCKDB_THREADS` sets the DuckDB thread count, from 1 to 256. The

{agent_session_analytics-0.2.0 → agent_session_analytics-0.2.1}/README.md

@@ -73,8 +73,10 @@ A consumer that queries the database directly runs
 - `SESSIONS_DB` names the database. A relative value joins the current
   directory. The package does not expand `~` in a set value.
 - Otherwise an absolute `XDG_CACHE_HOME` selects
-  `<cache>/dotfiles/session-analytics/sessions.duckdb`. A relative or unset
-  value uses `~/.cache`.
+  `<cache>/agent-session-analytics/sessions.duckdb`. A relative or unset
+  value uses `~/.cache`. If that file does not exist and the legacy
+  `<cache>/dotfiles/session-analytics/sessions.duckdb` exists, the package uses
+  the legacy file. It never moves, copies, or deletes the legacy file.
 - `SESSIONS_DUCKDB_MEMORY_LIMIT` sets the DuckDB memory limit, from 16MiB up to
   but not including 16EiB. The default is `4GB`.
 - `SESSIONS_DUCKDB_THREADS` sets the DuckDB thread count, from 1 to 256. The

{agent_session_analytics-0.2.0 → agent_session_analytics-0.2.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "agent-session-analytics"
-version = "0.2.0"
+version = "0.2.1"
 description = "Ingest coding-agent session logs into DuckDB and query them read-only."
 readme = "README.md"
 requires-python = ">=3.11"

{agent_session_analytics-0.2.0 → agent_session_analytics-0.2.1}/src/agent_session_analytics/_adapters/cursor.py

@@ -52,7 +52,7 @@ def _cursor_resolve_slug(slug: str, fs_root: str = "/") -> str:
     """Decode a dash-encoded absolute path, preferring the longest existing dir.
 
     Cursor project slugs replace path separators with dashes
-    (``Users-paul-Dev-easy-cheese``). A directory whose own name contains a
+    (``Users-alex-src-app``). A directory whose own name contains a
     dash is ambiguous if every dash is treated as a separator. Walk
     left-to-right and at each step take the longest prefix of remaining
     segments that exists under ``fs_root``; fall back to a naive split for

{agent_session_analytics-0.2.0 → agent_session_analytics-0.2.1}/src/agent_session_analytics/_db.py

@@ -36,8 +36,18 @@ def _xdg_cache_home() -> str:
     return os.path.abspath(os.path.expanduser("~/.cache"))
 
 
-DEFAULT_DB_DIR = os.path.join(_xdg_cache_home(), "dotfiles", "session-analytics")
-DB_PATH = configured_path("SESSIONS_DB", os.path.join(DEFAULT_DB_DIR, "sessions.duckdb"))
+def _default_db_path() -> str:
+    # The legacy `dotfiles/` cache keeps working when it is the only one that
+    # exists. Nothing moves, copies, or deletes it; another tool may share it.
+    cache = _xdg_cache_home()
+    path = os.path.join(cache, "agent-session-analytics", "sessions.duckdb")
+    legacy = os.path.join(cache, "dotfiles", "session-analytics", "sessions.duckdb")
+    if not os.path.exists(path) and os.path.exists(legacy):
+        return legacy
+    return path
+
+
+DB_PATH = configured_path("SESSIONS_DB", _default_db_path())
 DB_DIR = os.path.dirname(DB_PATH)
 DB_TMP_PATH = f"{DB_PATH}.tmp"
 # Derived from the database file name, not DB_DIR, so a SESSIONS_DB pointed

{agent_session_analytics-0.2.0 → agent_session_analytics-0.2.1}/src/agent_session_analytics/references/canonical-schema.md

@@ -4,8 +4,9 @@ Contents: [tool_uses](#tool_uses), [tool_results](#tool_results), [stop_events](
 
 The shape every harness adapter normalizes into and every analytics pack queries
 against. `agent-session-analytics ingest` loads one canonical row shape (the Claude envelope plus a
-`harness` tag) into `${XDG_CACHE_HOME:-$HOME/.cache}/dotfiles/session-analytics/sessions.duckdb` by default, then flattens it into
-the tables below. **Pack authors: write SQL against these tables; never reach
+`harness` tag) into `${XDG_CACHE_HOME:-$HOME/.cache}/agent-session-analytics/sessions.duckdb` by default, then flattens it into
+the tables below. If that file is absent, an existing legacy `dotfiles/session-analytics/` database is used.
+**Pack authors: write SQL against these tables; never reach
 into a harness's native format.**
 
 Every session-scoped table carries a `harness` column

{agent_session_analytics-0.2.0 → agent_session_analytics-0.2.1}/src/agent_session_analytics/references/harness-coverage.md

@@ -133,7 +133,7 @@ slashes).
 A directory whose own name contains a dash is ambiguous if every dash
 is a separator.
 So the adapter walks left-to-right. At each step it takes the longest prefix of remaining segments that exists on disk
-(`Users-paul-Dev-easy-cheese` → `/Users/paul/Dev/easy-cheese` when that path is
+(`Users-alex-src-app` → `/Users/alex/src/app` when that path is
 real). Unresolved tails fall back to a naive split. `gitBranch` is always null
 (not recorded).
 

{agent_session_analytics-0.2.0 → agent_session_analytics-0.2.1}/tests/conftest.py

@@ -27,7 +27,7 @@ class Sandbox:
 
     @property
     def database(self) -> Path:
-        return self.root / "cache" / "dotfiles" / "session-analytics" / "sessions.duckdb"
+        return self.root / "cache" / "agent-session-analytics" / "sessions.duckdb"
 
     def run(
         self, *args: str, extra_env: dict[str, str] | None = None

{agent_session_analytics-0.2.0 → agent_session_analytics-0.2.1}/tests/test_paths.py

@@ -36,7 +36,7 @@ def eval_ingest(expr: str, env: dict[str, str], cwd: Path, *argv: str) -> str:
     return result.stdout.strip()
 
 
-DEFAULT = "home/.cache/dotfiles/session-analytics/sessions.duckdb"
+DEFAULT = "home/.cache/agent-session-analytics/sessions.duckdb"
 
 DB_PATH_CASES: dict[str, tuple[Callable[[Path], dict[str, str]], Callable[[Path], str]]] = {
     "sessions_db_absolute": (
@@ -53,7 +53,7 @@ DB_PATH_CASES: dict[str, tuple[Callable[[Path], dict[str, str]], Callable[[Path]
     ),
     "xdg_cache_absolute": (
         lambda root: {"XDG_CACHE_HOME": str(root / "cache")},
-        lambda root: str(root / "cache" / "dotfiles" / "session-analytics" / "sessions.duckdb"),
+        lambda root: str(root / "cache" / "agent-session-analytics" / "sessions.duckdb"),
     ),
     "xdg_cache_relative_is_ignored": (
         lambda root: {"XDG_CACHE_HOME": "rel/c"},
@@ -92,6 +92,45 @@ def test_db_path_command_honours_sessions_db(sandbox: Sandbox) -> None:
     assert json.loads(result.stdout) == {"path": str(override)}
 
 
+def _touch(path: Path) -> None:
+    path.parent.mkdir(parents=True)
+    _ = path.write_text("")
+
+
+def _db_path(sandbox: Sandbox, extra_env: dict[str, str] | None = None) -> str:
+    result = sandbox.run("db-path", extra_env=extra_env)
+    assert result.returncode == 0, result.stderr
+    return cast(str, json.loads(result.stdout)["path"])
+
+
+def test_default_is_the_new_path_when_nothing_exists(sandbox: Sandbox) -> None:
+    assert _db_path(sandbox) == str(sandbox.database)
+    assert "dotfiles" not in sandbox.database.parts
+
+
+def test_default_falls_back_to_the_legacy_path_when_only_it_exists(sandbox: Sandbox) -> None:
+    legacy = sandbox.root / "cache" / "dotfiles" / "session-analytics" / "sessions.duckdb"
+    _touch(legacy)
+    assert _db_path(sandbox) == str(legacy)
+    assert legacy.exists()
+    assert not sandbox.database.exists()
+
+
+def test_default_prefers_the_new_path_when_both_exist(sandbox: Sandbox) -> None:
+    legacy = sandbox.root / "cache" / "dotfiles" / "session-analytics" / "sessions.duckdb"
+    _touch(legacy)
+    _touch(sandbox.database)
+    assert _db_path(sandbox) == str(sandbox.database)
+    assert legacy.exists()
+
+
+def test_sessions_db_beats_an_existing_legacy_file(sandbox: Sandbox) -> None:
+    legacy = sandbox.root / "cache" / "dotfiles" / "session-analytics" / "sessions.duckdb"
+    _touch(legacy)
+    override = sandbox.root / "elsewhere.duckdb"
+    assert _db_path(sandbox, {"SESSIONS_DB": str(override)}) == str(override)
+
+
 NAMES = ("CLAUDE_CONFIG_DIR", "CODEX_HOME", "CURSOR_HOME")