@hasna/hooks 0.2.19 → 0.3.0

package/README.md

@@ -26,16 +26,56 @@ hooks --help
 - `hooks doctor`
 - `hooks run`
 
-## Cloud Sync
+## Codewith-native hooks
 
-This package supports cloud sync via `@hasna/cloud`:
+@hasna/hooks includes five unprefixed Codewith-native hook names:
+
+- `session-start` — `SessionStart` digest and additional context.
+- `prompt-guard` — `UserPromptSubmit` guard for pasted fake policy/freeze/run-this-now content.
+- `pre-bash` — `PreToolUse` Bash gate for staged secrets scans and risky-op comms checks.
+- `worktree-guard` — `PreToolUse` guard for managed repos worktree boundaries.
+- `stop-sync` — `Stop` turn-end heartbeat/evidence best effort.
+
+For Codewith, the installer is renderer-safe by default: it emits a TOML
+fragment instead of mutating managed `~/.codewith/config.toml`.
+
+```bash
+hooks install session-start prompt-guard pre-bash worktree-guard stop-sync --target codewith
+```
+
+Apply that fragment through `open-configs` or the managed config renderer. A
+direct write path exists only for explicit local/test use:
+
+```bash
+hooks install session-start --target codewith --apply-codewith --codewith-config /tmp/codewith-config.toml
+```
+
+## Storage
+
+Hooks stores data locally by default in `~/.hasna/hooks/` and uses SQLite
+directly for hook event history. The package owns its database schema and
+migrations; it does not depend on the deprecated shared runtime or its CLI.
+The repo includes its own PostgreSQL migration definitions for optional remote
+storage deployments. Use the `hooks log` commands to inspect local hook event
+data.
 
 ```bash
-cloud setup
-cloud sync push --service hooks
-cloud sync pull --service hooks
+hooks storage status --json
+HASNA_HOOKS_DATABASE_URL=postgres://... hooks storage push --tables hook_events,feedback --json
+hooks storage pull --json
+hooks storage sync --json
 ```
 
+Configure database storage with `HASNA_HOOKS_DATABASE_URL` or fallback
+`HOOKS_DATABASE_URL`. Optional storage mode env vars are
+`HASNA_HOOKS_STORAGE_MODE` and `HOOKS_STORAGE_MODE`, with `local`, `hybrid`, or
+`remote` values.
+
+## Runtime model
+
+This package is an npm/local CLI, MCP server, and static dashboard package. It
+does not require a deployed cloud or self-hosted runtime to install or run hooks.
+
 ## Data Directory
 
 Data is stored in `~/.hasna/hooks/`.