Skip to content

Commit ca4aace

Browse files
committed
chore: add changeset for app concept and query pagination
1 parent 4508610 commit ca4aace

File tree

1 file changed

+29
-0
lines changed

1 file changed

+29
-0
lines changed
Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,29 @@
1+
---
2+
"agentcrumbs": minor
3+
---
4+
5+
Add app concept for project-level crumb isolation and cursor-based query pagination.
6+
7+
**App isolation:**
8+
- Every crumb is stamped with an `app` name, auto-detected from the nearest `package.json`
9+
- Crumbs stored per-app at `~/.agentcrumbs/<app>/crumbs.jsonl`
10+
- Collector routes incoming crumbs to per-app stores
11+
- All CLI commands scope to the current app by default
12+
- Override with `--app <name>`, `--all-apps`, `AGENTCRUMBS_APP` env var, or `app` field in JSON config
13+
14+
**Query pagination:**
15+
- New `--cursor` flag for forward pagination with short 8-char cursor IDs
16+
- New `--after` and `--before` flags for absolute ISO timestamp windows
17+
- Default limit reduced from 100 to 50 per page
18+
- Results returned oldest-first with `Next: --cursor <id>` in output when more pages exist
19+
20+
**New files:**
21+
- `src/cli/app-store.ts` — shared helper for app context resolution across CLI commands
22+
- `src/cli/cursor.ts` — cursor storage with 1-hour TTL
23+
24+
**Breaking changes:**
25+
- `Crumb` type now has a required `app: string` field
26+
- `AgentCrumbsConfig` type now has an optional `app?: string` field
27+
- `CollectorServer` no longer exposes `getStore()` (routes to per-app stores internally)
28+
- Storage location changed from `~/.agentcrumbs/crumbs.jsonl` to `~/.agentcrumbs/<app>/crumbs.jsonl`
29+
- Legacy flat-file crumbs (without `app` field) are still readable as app `"unknown"`

0 commit comments

Comments
 (0)