@scribed/cli 0.1.12 → 0.1.14

package/README.md

@@ -292,7 +292,12 @@ scribed records create deals name="Ada — SAFE" amount=25000 stage="Soft Commit
 scribed records set <recordId> stage="Docs Sent"                                  # objects_record_update
 scribed records bulk-set deals --ids a,b,c stage="Docs Signed" --yes              # one objects_record_update per id, stops at the first failure
 scribed records note <recordId> "Called, sending the deck" [--pin]                # objects_note_create
-scribed records archive <recordId> --yes | records restore <recordId>            # objects_record_delete / objects_record_restore
+scribed records archive <recordId> --yes | records restore <recordId>            # admin/owner; automatic deletion eligible after 30 days
+scribed records archived [--limit 100] [--cursor <nextCursor>]                    # admin/owner; includes deleteAfter
+scribed records delete-permanently <recordId> --yes                              # owner only; already archived; no undo
+scribed records collection archived | collection archive <typeId> --yes          # admin/owner
+scribed records collection restore <typeId>                                     # admin/owner, before expiry
+scribed records collection delete-permanently <typeId> --yes                     # owner only; removes archived collection and its records
 scribed records views deals            # objects_views_list
 scribed records view create deals --input view.json | view update <viewId> --input patch.json | view delete <viewId> --yes
                                        # objects_view_create / objects_view_update / objects_view_delete
@@ -463,6 +468,10 @@ For `pages blocks update`, first save the result of `pages read <pageId> --json`
 
 Board queries can select an exact lane with `--lane-field` and `--lane`, using the raw group key returned by `--group` or `--board-preview`; use `null` for the unassigned lane. A relation lane uses the first link, while a `--where` relation filter matches any link. Continue with the lane's cursor and the same filters. `--timeline-scope` uses the saved timeline/calendar date field and reports dated/undated counts. These are query flags; exports use `--where`. Summaries and metrics average recorded numeric values, keeping explicit zeros and leaving empty amounts as `—`. Pipeline totals keep records with no stage separate from open stages. Stage summaries and outcome filters use stable option ids and per-option metadata from `optionDetails`; repeated labels remain separate. `--stage` and `leads stage` accept an option id when a label is ambiguous (see `records schema --json`).
 
+Record and collection archives require an admin or owner and become eligible for automatic permanent deletion after 30 days. The returned `deleteAfter` is the earliest deletion time, not a guaranteed purge date; protected investment or enrichment history is retained. Restore remains available until actual permanent deletion. User-requested permanent deletion is owner-only and irreversible. The legacy `objects_record_delete` and `objects_type_delete` tools still archive. A `collections.delete` grant does not grant permanent deletion.
+
+When talking to an agent, name your workspace (for example, Fundraising). It resolves the name with `workspaces_list` and supplies the ID. All `automation_*` tools accept a per-call `workspaceId`; no connector URL change is needed for one selected call. Ambiguous names need clarification and credential scope still applies.
+
 `--where` rules are `key:op[:value]` — `stage:in:Qualified,Demo Booked`, `commitment:gte:5000`, `nextFollowUp:is_empty`, `assignedTo:assigned_to:$me`; operators are the view query's (`eq neq contains in gt gte lt lte is_empty is_not_empty before after within_days assigned_to`). `--assigned me` is the app's "Assigned to me" lens (an unassigned record matches everyone), `--assigned archived` the archived bucket. A list shows ONE page (`--limit`, ≤ 200) — every matching row is the `export` command, which the API renders server-side and reserves for the workspace owner and the members granted "Export data" (`--max-rows` defaults to 10,000, the API holds at most 100,000); an import creates at most 16 rows at a time and lists every refused row by line.
 
 `key=value` args are JSON-coerced per value (`limit=5` → number, `ids='["a"]'` → array, dotted keys nest objects: `values.email=jane@acme.com`). Prototype keys are rejected. Examples:
@@ -492,6 +501,41 @@ Async work (meeting/YouTube transcriptions, automation runs) returns an id immed
 
 Four internal chat helpers are excluded from the CLI and MCP: `web_search`, `attachment_list`, `attachment_save_to_vault`, and `tool_discover`. External clients use `tools list` for discovery and the shared `agent_session_attachments_list` / `agent_session_attachment_save_to_vault` tools with an explicit session id.
 
+## Agent integrations
+
+Use Scribed in **Claude Code, Codex, and Cursor**. Choose any combination; each
+platform has its own connection. No package-install hook changes agent settings.
+
+```bash
+scribed agents install                          # interactive platform selection
+scribed agents install claude-code codex --yes   # select several platforms
+scribed agents install --all --yes               # all three
+scribed agents status                           # inspect current files and skills
+scribed agents status --json                     # machine-readable setup status
+scribed agents repair --all --yes                # update bundled skills / restore missing files
+scribed agents remove cursor --yes               # remove only Scribed-managed, unchanged files
+```
+
+New connections use Scribed's hosted OAuth MCP endpoint. Setup installs four
+skills for customer briefs, reviewed follow-ups, Chat conversations, and records.
+Open each selected platform to complete Scribed sign-in and select the workspace;
+**installed does not mean authenticated**. Start a new agent session to load the
+skills. Existing permissions and tool availability still apply.
+
+The CLI, Talk, Chat, Tel, Bot, Capital, and Guide desktop apps share installation
+ownership and the optional onboarding offer. Their Agent integrations settings
+recognize setup performed by another Scribed app. Codex and Cursor share the
+user-level `~/.agents/skills` copy; Claude Code uses `~/.claude/skills`. Removing
+one platform preserves skills still used by another. User-edited skills and
+unrelated configuration are preserved. Repair uses the skills bundled in this
+CLI release and never downgrades a newer installation.
+
+The portable plugin source and Claude Code adapter live in
+[`integrations/agents`](../integrations/agents); see the
+[integration contract](../docs/specs/agent-integrations.md). These are local
+computer integrations; installing the app on a phone does not configure another
+computer or a remote/cloud agent environment.
+
 ## MCP server
 
 ```bash