feat: add pluggable friction stores (#75)

* Add pluggable friction stores

* Expose stored occurrence counts

* Respect PostgreSQL search paths

* Configure CLI friction stores

* Simplify Postgres store setup

* Format CLI store configuration

* Resolve pnpm toolchain friction

* Harden pluggable store boundaries

* refactor: align pluggable stores

* test: use postgres testcontainers

* refactor: group postgres options

* test: namespace postgres fixture

* fix: resolve store review feedback

* feat: accept postgres connection strings

* feat: use postgres.js for stores

* fix: preserve store edge cases

* feat: migrate stores through frog

* docs: describe database store roadmap

* docs: add d1 store roadmap

* docs: reorder database store guide

* fix: guard store parsing boundaries

* docs: simplify database setup

* docs: trim database usage

* docs: reorder database storage

---------

Co-authored-by: jxom <7336481+jxom@users.noreply.github.com>

Author: Slokh

.changeset/calm-frogs-store.md

@@ -0,0 +1,19 @@
+---
+'frog': minor
+---
+
+Added pluggable friction stores, a Postgres.js-backed `Store.postgres({ connectionString })` factory, and the `Frog.create` logging API.
+
+```ts
+import { Frog, Store } from 'frog'
+
+const store = Store.postgres({ connectionString: process.env.DATABASE_URL! })
+const frog = Frog.create({ store })
+await frog.log({
+  body: 'The workaround used.',
+  severity: 'minor',
+  title: 'Tool required a workaround',
+})
+const logs = await frog.logs()
+await store.close()
+```

README.md

@@ -213,6 +213,26 @@ Accept friction reported by other repositories with `.agents/friction-log/config
 `frog init` enables inbound reports by default. Run `frog init --no-inbound` to initialize without
 accepting inbound reports.
 
+### Store Logs in a Database
+
+Frog separates friction logging from persistence, so agents and applications can record and inspect
+logs through one API while choosing where they live. Repository files are the default, PostgreSQL is
+supported today, and SQLite and Cloudflare D1 are planned.
+
+```sh
+export FROG_DATABASE_URL=postgres://...
+frog migrate
+frog list
+```
+
+#### Database Support
+
+| Database      | Status      | Factory                                |
+| ------------- | ----------- | -------------------------------------- |
+| PostgreSQL    | Available   | `Store.postgres({ connectionString })` |
+| SQLite        | Coming soon | —                                      |
+| Cloudflare D1 | Coming soon | —                                      |
+
 ## CLI Reference
 
 ```
@@ -224,7 +244,9 @@ Commands:
   init     Create the friction log, config, and issue form.
   list     List entries with their state.
   log      Write a friction entry.
+  migrate  Create or upgrade the selected store.
   publish  Report pending entries as GitHub issues.
+  resolve  Remove one resolved friction entry.
   sync     Reconcile entries against issue state.
   targets  List dependencies that accept friction reports.
 

package.json

@@ -13,6 +13,7 @@
   },
   "devDependencies": {
     "@changesets/cli": "catalog:",
+    "@testcontainers/postgresql": "catalog:",
     "@types/node": "catalog:",
     "@vitest/coverage-v8": "catalog:",
     "tsx": "catalog:",
@@ -62,6 +63,7 @@
     "@clack/prompts": "catalog:",
     "@octokit/rest": "catalog:",
     "incur": "catalog:",
+    "postgres": "catalog:",
     "yaml": "catalog:"
   },
   "engines": {