@cerefox/memory 1.12.0 → 1.13.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (23) hide show
  1. package/AGENT_GUIDE.md +2 -2
  2. package/dist/bin/cerefox.js +6988 -7343
  3. package/dist/frontend/assets/index-InRztcXr.js +121 -0
  4. package/dist/frontend/assets/index-InRztcXr.js.map +1 -0
  5. package/dist/frontend/index.html +1 -1
  6. package/dist/server-assets/_shared/ef-meta/index.ts +3 -3
  7. package/dist/server-assets/_shared/mcp-tools/feature-flags.ts +41 -23
  8. package/dist/server-assets/_shared/mcp-tools/ingest.ts +2 -4
  9. package/dist/server-assets/_shared/mcp-tools/metadata-search.ts +6 -1
  10. package/dist/server-assets/_shared/mcp-tools/partial-edits.ts +2 -2
  11. package/dist/server-assets/db/migrations/0031_review_workflow_toggle.sql +72 -0
  12. package/dist/server-assets/db/rpcs.sql +46 -8
  13. package/dist/server-assets/db/schema.sql +13 -2
  14. package/dist/server-assets/supabase/functions/cerefox-ingest/index.ts +2 -4
  15. package/dist/server-assets/supabase/functions/cerefox-metadata-search/index.ts +12 -2
  16. package/docs/guides/access-paths.md +1 -1
  17. package/docs/guides/cli.md +11 -4
  18. package/docs/guides/configuration.md +56 -8
  19. package/docs/guides/connect-agents.md +9 -5
  20. package/docs/guides/upgrading.md +21 -1
  21. package/package.json +1 -1
  22. package/dist/frontend/assets/index-P1F2Ldl9.js +0 -121
  23. package/dist/frontend/assets/index-P1F2Ldl9.js.map +0 -1
package/AGENT_GUIDE.md CHANGED
@@ -576,7 +576,7 @@ If you're using Cerefox via the local CLI (Path C from `connect-agents.md`), the
576
576
 
577
577
  ## Governance
578
578
 
579
- - **Review status**: agent writes set `pending_review`; human edits set `approved`. Both are searchable.
579
+ - **Review status** (only while the store's `review_workflow_enabled` flag is on): agent writes set `pending_review`; human edits set `approved`. Both are searchable. When the workflow is off — the default on a fresh install — every write lands `approved` and no tool output mentions a review status; do not look for one.
580
580
  - **Soft delete**: deleted documents go to trash (recoverable). They are excluded from search. Delete via `cerefox_delete_document` (MCP, v1.7.0+ — requires the document's `content_hash` as you read it), the CLI (`cerefox document delete --yes --author <you> --author-type agent`), or the web UI.
581
581
  - **Restore is agent-reachable; permanent purge is web-UI-only.** A mistaken soft-delete can be undone with `cerefox_restore_document` (or `cerefox document restore`), fully audited (#210, v1.7.0). Purge — the only action that actually destroys data — keeps its human-in-the-loop confirmation in the web UI. If you delete or restore something, **tell the user explicitly** so they can follow it in the audit trail. See [`docs/guides/access-paths.md` → Destructive operations and the trust model](docs/guides/access-paths.md#destructive-operations-and-the-trust-model).
582
582
  - **Versioning**: every update via `update_if_exists` creates an archived version. Old content is always recoverable.
@@ -622,7 +622,7 @@ The Python implementation was fully removed at v1.0.0; every command is the Type
622
622
 
623
623
  You **MUST** identify yourself on every CLI invocation, exactly as you do via MCP:
624
624
 
625
- - **Writes** (`document ingest`, `document ingest-dir`): set `--author "<your-agent-name>" --author-type "agent"`. The `author_type=agent` value auto-routes the write to `pending_review` (governance signal), matching the MCP path.
625
+ - **Writes** (`document ingest`, `document ingest-dir`): set `--author "<your-agent-name>" --author-type "agent"`. The `author_type=agent` value routes the write to `pending_review` while the review workflow is on (governance signal), matching the MCP path; with it off the write lands `approved` and attribution is still recorded.
626
626
  - **Reads** (`search`, `document get`, `document version list`, `project list`, `metadata search`, `audit list`): set `--requestor "<your-agent-name>"`.
627
627
 
628
628
  Alternative: have your user set `CEREFOX_AUTHOR_NAME`, `CEREFOX_AUTHOR_TYPE`, `CEREFOX_REQUESTOR_NAME` in their `.env` once. The CLI picks them up automatically — see [`docs/guides/cli.md`](docs/guides/cli.md) for the precedence rules.