ente-cli 0.4.90 → 0.4.92

package/README.md

@@ -104,6 +104,7 @@ project `.env` file.
 ```bash
 ente search "Alice"
 ente entity list --type person
+ente entity get "Alice" --projection full --limit 50 --json
 ente entity rename "Lorey Georg" "Georg Lorey"
 ente task list --due today
 ente activity create --type note --title "Meeting notes" --entity "Alice" --space "Personal"
@@ -125,6 +126,14 @@ ente tasks
 ente guide              # concepts; `ente guide <topic>`: entities, tasks, activities, search, patterns, limits
 ```
 
+Entity search, list and detail default to the compact projection. Search returns
+5 matches by default; list returns 50, and detail returns 20 activities. Search
+and list accept up to 1,000 results; detail accepts up to 200 activities.
+`--projection full` returns the public fields without compact text excerpts.
+`entity get` also accepts `--hours-back` and `--min-count`. A missing or
+archived detail returns `{"data":null}` in JSON. JSON preserves the canonical
+result under `data`; a root `spaces` map supplies the CLI's space labels.
+
 Every command supports `--json`. Run `ente --help` or `ente <group> --help`.
 
 ### Command groups
@@ -536,3 +545,20 @@ Gmail applies native word/operator matching; arbitrary mid-name/address substrin
 and alias expansion are not guaranteed. IMAP applies native address-header
 substring matching with UIDVALIDITY-bound continuation. Neither source proves
 complete historical coverage; retain alternatives and ask on unresolved matches.
+
+### Typed entity fields
+
+Entity contact and business values are typed field values. Use, for example:
+
+```sh
+ente entity create "Jane Doe" --type person --space Personal --field '{"label":"E-Mail","type":"email","value":"jane@example.com"}'
+ente entity update "Jane Doe" --field '{"label":"Job title","type":"job-title","value":"Architect"}'
+ente entity field add "Jane Doe" --label "Mobilnummer" --type phone --value "+49 1512 3456789"
+ente entity field update <valueId> --value "replacement"
+ente entity field remove <valueId>
+```
+
+`--field` repeats JSON objects. Omitted labels stay unchanged; a supplied label
+replaces that field's values; `"value":null` removes them. Entity `--attr` is
+retained only to report the moved-to-fields error. Activity/task/list attributes
+are unchanged. Entity reads expose field/value IDs, labels, types and text.

package/dist/SKILL.md

@@ -131,6 +131,8 @@ Check the exit before parsing. Do not append a successful help command and treat
 its exit as the preceding command's result. `entity show` reports the supported
 `entity get` command and fails without making a request.
 
+Entity reads default to compact public DTOs. Search defaults to 5 results; entity list without a query defaults to 50; entity get defaults to 20 activities. Search/list accept at most 1,000, and get accepts at most 200. Use `--projection full` for full public text and fields. JSON keeps the canonical result under `data` with space labels in the root `spaces` envelope. Missing or archived detail returns `data: null`.
+
 For inbox coverage, page the unfiltered `agent mail threads` list to completion,
 then inspect thread messages, including updates to older threads. `--unread`
 and `--needs-reply` answer different questions; unread alone misses read but
@@ -153,17 +155,20 @@ ente auth profiles
 # Ask keeps scoped evidence on synthesis failure; check synthesisStatus.
 # Optional sourceHash/sourceFingerprint/passage metadata binds citations to a source version.
 # query remains deterministic and never starts embedding/indexing. See guide ask-the-graph.
-ente search "Alice" [--type person] [--json]
+ente search "Alice" [--type person] [--space <name>] [--limit 5] [--projection compact|full] [--json]
 ente ask "What's open with Erik?" [--space <name>] [--entity <name>] [--evidence] [--json]   # AI answer + citations
 ente query "QM system export" [--space <name>] [--entity <name>] [--since <epoch-ms>] [--until <epoch-ms>] [--limit 12] [--verbose] [--json]         # evidence only, no AI
 
 # Entities
-ente entity list [--query <text>] [--type person|org|project|topic|place|object] [--space <name>] [--limit 50] [--archived] [--json]
-ente entity create "Jane Doe" --type person [--pin "Acme Corp"] [--share-parents --parent-space-grant-fingerprint <token>] [--alias "JD"] [--attr email=jane@acme.com] [--tag vip] [--description "CTO at Acme"] [--json]
+ente entity list [--query <text>] [--type person|org|project|topic|place|object] [--space <name>] [--limit <count>] [--projection compact|full] [--archived] [--json]
+ente entity create "Jane Doe" --type person [--pin "Acme Corp"] [--share-parents --parent-space-grant-fingerprint <token>] [--alias "JD"] [--field '{"label":"E-Mail","type":"email","value":"jane@acme.com"}'] [--tag vip] [--description "CTO at Acme"] [--json]
 ente entity create "Leistungsphase 1" --type topic --space "Studio" --parent "Building A" --exclusive-parent [--json]
 ente entity duplicate <name-or-id> --space <space> [--name "New project"] [--include-exclusive-children] [--json]
-ente entity get "Jane Doe" [--json]
-ente entity update "Jane Doe" [--name "Jane A. Doe"] [--alias-add "Jane"] [--alias-remove "JD"] [--attr role=CEO] [--tag vip] [--description "…"] [--json]
+ente entity get "Jane Doe" [--limit 20] [--hours-back <hours>] [--min-count 5] [--projection compact|full] [--json]
+ente entity update "Jane Doe" [--name "Jane A. Doe"] [--alias-add "Jane"] [--alias-remove "JD"] [--field '{"label":"Job title","type":"job-title","value":"CEO"}'] [--tag vip] [--description "…"] [--json]
+ente entity field add "Jane Doe" --label "Mobilnummer" --type phone --value "+49 1512 3456789" [--json]
+ente entity field update <valueId> --value "new text" [--json]
+ente entity field remove <valueId> [--json]
 ente entity rename "Lorey Georg" "Georg Lorey"        # change display name
 ente entity pin "Jane Doe" "Acme Corp" [--role "student"] [--share-parents --parent-space-grant-fingerprint <token>] [--json]
 ente entity unpin "Jane Doe" "Acme Corp" [--json]
@@ -176,8 +181,8 @@ ente entity restore <entity-id> [--share-parents --parent-space-grant-fingerprin
 # Activities
 ente activity list [--entity "Jane"] [--compact] [--cursor <nextCursor>] [--min-count 0] [--type note|conversation|meeting|call|message|task] [--attr k=v] [--only-open] [--hours 168] [--limit 20] [--sort deadline|created] [--json]
 ente activity create --type meeting --title "Call with Jane" --entity "Jane Doe" --entity "Acme Corp" --space "Work" [--content "…"] [--content-file ./notes.md] [--auto-link --entity-space-grant-fingerprint <token>] [--json]
-ente activity search "quarterly review" [--entity "Acme"] [--type meeting] [--limit 10] [--json]
-ente activity get <activityId> [--json]                # complete detail: body, full nested agenda, messages/replies, entities, attachments
+ente activity search "quarterly review" [--entity "Acme"] [--type meeting] [--limit 20] [--projection compact|full] [--json]
+ente activity get <activityId> [--projection compact|full] [--json]                # public detail; use --projection full for full text and attachments
 ente activity transcript <activityId> [--grep "Preis"] [--context 2] [--recording <id>] [--json]   # transcript of the recording behind it
 ente activity update <activityId> [--title "…"] [--content "…"] [--deadline "2026-05-26" | --clear-deadline] [--entity-add "Bob"] [--entity-remove "Carol"] [--agent-assignee <agentId> ... | --clear-agent-assignees] [--json]
 ente activity content read <activityId> [--cursor <cursor> --expected-version <version>] [--max-blocks 20] [--max-characters 12000] [--json]
@@ -189,9 +194,9 @@ ente activity restore <activityId> [--json]
 
 # Database lists (entity + typed columns; each row is a note/task activity; no date column type)
 ente list create "<name>" --space "<space>" [--icon <topic-icon>] [--column "key[=Label]:text|number|boolean|single-select|multi-select[:opt,opt]"] [--pin "<parent>" [--share-parents --parent-space-grant-fingerprint <token>]] [--json]
-ente list add "<list>" --title "…" [--attr k=v ...] [--key <textColumn>] [--content-file ./row.md] [--json]   # --key = upsert by that cell
+ente list add "<list>" [--space "<space>"] --title "…" [--attr k=v ...] [--key <textColumn>] [--content-file ./row.md] [--json]   # --key = upsert by that cell
 ente list update "<list>" <rowId> [--attr k=v ...] [--title "…"] [--json]      # empty value clears a cell
-ente list import "<list>" --file rows.jsonl --key <textColumn> [--dry-run] [--concurrency 4] [--json]   # {"title","attrs","content"} per line → created/updated/unchanged
+ente list import "<list>" [--space "<space>"] --file rows.jsonl --key <textColumn> [--dry-run] [--concurrency 4] [--json]   # {"title","attrs","content"} per line → created/updated/unchanged
 ente list show "<list>" [--all | --cursor <nextCursor>] [--limit 100] [--where k=v ...] [--view] [--json]   # all rows by default; --view = table's saved filters
 # Rows are activities: trash with `ente activity delete <rowId>`, promote with `ente activity update <rowId> --entity-add "<entity>"`. Guide: playbooks/database-list-sync.md
 
@@ -250,6 +255,12 @@ ente agent mail reply <thread-id> --message <message-id> --reply-all (--text "Re
 ente agent mail mark <thread-id> --state-version <version> (--handled | --open | --needs-reply | --read | --unread) [--json]
 ```
 
+New list rows require explicit `--space`, including import dry runs and lists in a single space. Updates to existing rows keep their current space.
+
+
+Activity search and get return canonical public DTOs, defaulting to compact text. Use `--projection full` to include full public fields and attachment metadata. Missing or archived detail returns `data: null`. Search accepts at most 200 results and `--entity` includes the same bounded direct-child history as other canonical reads. The JSON result stays under `data`; `spaces` is a separate label envelope. Activity list keeps its installed filtering, sorting and pagination profile.
+
+
 Received attachments are available through the same bound agent credential;
 no browser login is needed. `ente agent mail show <thread-id> --json` lists
 `attachments` on each message with `attachmentId`, `filename`, `mimeType`, and
@@ -736,3 +747,9 @@ Gmail uses native word/operator matching, without guaranteed arbitrary substring
 or alias expansion. IMAP uses native address-header substring search and checks
 UIDVALIDITY on continuation. Never claim complete historical coverage or send
 from a recipient lookup; disclose choices and ask on unresolved alternatives.
+
+Entity values use typed `fields`; entity `--attr` and attribute payloads are legacy errors.
+`entity update --field` merges only supplied labels. Repeat JSON objects to store
+several values under one label; use `"value":null` to remove that label's values.
+A field ID selects an existing definition; a new label is owned by the acting
+space. Activity, task and list `--attr` options keep their existing behavior.