Release v0.4.0

This PR was opened by the [Changesets
release](https://github.com/changesets/action) GitHub action. When
you're ready to do a release, you can merge this and publish to npm
yourself or [setup this action to publish
automatically](https://github.com/changesets/action#with-publishing). If
you're not ready to do a release yet, that's fine, whenever you add more
changesets to main, this PR will be updated.


# Releases
## agentcrumbs@0.4.0

### Minor Changes

- ca4aace: Add app concept for project-level crumb isolation and
cursor-based query pagination.

    **App isolation:**

- Every crumb is stamped with an `app` name, auto-detected from the
nearest `package.json`
    -   Crumbs stored per-app at `~/.agentcrumbs/<app>/crumbs.jsonl`
    -   Collector routes incoming crumbs to per-app stores
    -   All CLI commands scope to the current app by default
- Override with `--app <name>`, `--all-apps`, `AGENTCRUMBS_APP` env var,
or `app` field in JSON config

    **Query pagination:**

- New `--cursor` flag for forward pagination with short 8-char cursor
IDs
- New `--after` and `--before` flags for absolute ISO timestamp windows
    -   Default limit reduced from 100 to 50 per page
- Results returned oldest-first with `Next: --cursor <id>` in output
when more pages exist

    **New files:**

- `src/cli/app-store.ts` — shared helper for app context resolution
across CLI commands
    -   `src/cli/cursor.ts` — cursor storage with 1-hour TTL

    **Breaking changes:**

    -   `Crumb` type now has a required `app: string` field
- `AgentCrumbsConfig` type now has an optional `app?: string` field
- `CollectorServer` no longer exposes `getStore()` (routes to per-app
stores internally)
- Storage location changed from `~/.agentcrumbs/crumbs.jsonl` to
`~/.agentcrumbs/<app>/crumbs.jsonl`
- Legacy flat-file crumbs (without `app` field) are still readable as
app `"unknown"`

## papertrail@0.0.1

### Patch Changes

-   Updated dependencies [ca4aace]
    -   agentcrumbs@0.4.0

Author: ericallam

.changeset/app-concept-and-pagination.md

@@ -0,0 +1,8 @@
+# papertrail
+
+## 0.0.1
+
+### Patch Changes
+
+- Updated dependencies [ca4aace]
+  - agentcrumbs@0.4.0

examples/papertrail/CHANGELOG.md

@@ -1,6 +1,6 @@
 {
   "name": "papertrail",
-  "version": "0.0.0",
+  "version": "0.0.1",
   "private": true,
   "type": "module",
   "scripts": {

examples/papertrail/package.json

@@ -1,5 +1,39 @@
 # agentcrumbs
 
+## 0.4.0
+
+### Minor Changes
+
+- ca4aace: Add app concept for project-level crumb isolation and cursor-based query pagination.
+
+  **App isolation:**
+
+  - Every crumb is stamped with an `app` name, auto-detected from the nearest `package.json`
+  - Crumbs stored per-app at `~/.agentcrumbs/<app>/crumbs.jsonl`
+  - Collector routes incoming crumbs to per-app stores
+  - All CLI commands scope to the current app by default
+  - Override with `--app <name>`, `--all-apps`, `AGENTCRUMBS_APP` env var, or `app` field in JSON config
+
+  **Query pagination:**
+
+  - New `--cursor` flag for forward pagination with short 8-char cursor IDs
+  - New `--after` and `--before` flags for absolute ISO timestamp windows
+  - Default limit reduced from 100 to 50 per page
+  - Results returned oldest-first with `Next: --cursor <id>` in output when more pages exist
+
+  **New files:**
+
+  - `src/cli/app-store.ts` — shared helper for app context resolution across CLI commands
+  - `src/cli/cursor.ts` — cursor storage with 1-hour TTL
+
+  **Breaking changes:**
+
+  - `Crumb` type now has a required `app: string` field
+  - `AgentCrumbsConfig` type now has an optional `app?: string` field
+  - `CollectorServer` no longer exposes `getStore()` (routes to per-app stores internally)
+  - Storage location changed from `~/.agentcrumbs/crumbs.jsonl` to `~/.agentcrumbs/<app>/crumbs.jsonl`
+  - Legacy flat-file crumbs (without `app` field) are still readable as app `"unknown"`
+
 ## 0.3.3
 
 ### Patch Changes

packages/agentcrumbs/CHANGELOG.md

@@ -1,6 +1,6 @@
 {
   "name": "agentcrumbs",
-  "version": "0.3.3",
+  "version": "0.4.0",
   "description": "Debug mode for any agent.",
   "tshy": {
     "exports": {