xevol 0.12.8 → 0.12.10

package/README.md

@@ -54,7 +54,9 @@ xevol workspace switch <workspace-id>
 - `xevol companies ...` — all Companies reads and commands: list, get, options, create, update, remove, enrich, research, and primary Contact
 - `xevol contacts ...` — all Contacts reads and commands: list, get, create, update, and proposed-fact decisions
 - `xevol offers ...` — every Offers procedure used by Xevol Work Web, including profiles, status, snapshots, audiences, angles, artifacts, revisions, and reviewed generation
-- `xevol leads ...` — every Leads procedure used by Xevol Work Web, including campaigns, review, identity, packets, Deal handoff, outreach, learning, import, insights, and export
+- `xevol leads ...` — every Leads procedure used by Xevol Work Web, including campaigns, manual imported review, identity, packets, Deal handoff, outreach, learning, import, insights, and export
+- `xevol directory ...` — read-only Company/Contact source browsing, identity quality, memberships, and immutable import reports
+- `xevol career ...` — read-only source job browsing and detail, separate from personal Matches and Pursuits
 - `xevol deals ...` — list, get, create, update, and stage management
 - `xevol activities ...` — record timelines, counts, personal tasks, activity creation, and task completion
 - `xevol search [query]` — search Companies, Contacts, and Deals across the selected Workspace
@@ -83,6 +85,68 @@ List commands also accept `--query`, `--page`, `--page-size`, `--sort`, and `--d
 
 Campaign execution commands keep the Work API's reviewed-policy and acknowledgement requirements. In particular, `campaign-execution-activate` can start sending and requires both `expectedEnrollmentCount` and `"acknowledgeSend": true`; the CLI supplies no bypass and the API rechecks current Workspace authority.
 
+### Imported source data
+
+Directory and Career source commands use the same Work API token, selected Workspace,
+active membership, and direct-owner privacy checks as the web. They do not execute bulk
+imports, enrich records, enroll campaigns, send messages, or apply for jobs.
+
+```bash
+xevol directory companies --source explee --query Acme --page-size 25 --json
+xevol directory contacts --source explee --missing email --quality weak --json
+xevol directory company-get <company-id> --json
+xevol directory contact-get <contact-id> --json
+xevol directory sources <record-id> --kind CONTACT --page-size 25 --json
+xevol directory source-options --kind CONTACT --json
+xevol directory imports --state COMPLETED --json
+xevol directory import-get <batch-id> --json
+xevol directory import-rows <batch-id> --kind CONTACT --outcome UNRESOLVED --json
+xevol directory import-row-get <row-id> --batch-id <batch-id> --json
+xevol career source-list --source leadjobs --query engineer --age historical-365 --json
+xevol career source-get <opportunity-id> --json
+```
+
+Directory lists support `--source`, `--snapshot`, `--segment`, `--quality`, `--usage`,
+and `--missing`. Import reports filter by source/state; source rows filter by kind/outcome.
+Career source lists support `--source`, `--availability`, `--age`, and `--work-mode`.
+Searchable lists accept `--query`, `--sort`, and `--dir`; paged reads accept `--page`
+and `--page-size` (1–100). `source-options` returns the accessible filter values.
+Observed job availability is historical evidence, not proof that a job is open now.
+
+### Imported manual Leads review
+
+```bash
+xevol leads list --input '{"view":"all"}' --json
+xevol leads manual-campaign-resolve <source-campaign-id> --json
+xevol leads manual-campaign-detail <campaign-id> --json
+xevol leads manual-prospect-list <campaign-id> --disposition HELD --json
+xevol leads manual-lead-detail <lead-id> --campaign-id <campaign-id> --json
+xevol leads manual-draft-list <lead-id> --campaign-id <campaign-id> --json
+xevol leads manual-draft-detail <draft-id> --campaign-id <campaign-id> --lead-id <lead-id> --json
+xevol leads manual-source-catalog --json
+xevol leads manual-source-rows --source-table DRAFTS --page-size 25 --json
+xevol leads manual-source-record <row-id> --json
+```
+
+`leads list` defaults to submissions; use `view: all` when counting the full Lead corpus.
+Manual review mutations are **content-only**: approval never schedules or sends a message.
+They reuse the API's version, campaign, owner, archive, and replay checks without bypasses:
+
+```bash
+xevol leads manual-lead-review <lead-id> --file review.json --json
+xevol leads manual-draft-revise <draft-id> --file revision.json --json
+xevol leads manual-draft-decide <draft-id> --file content-decision.json --json
+```
+
+All three input files must supply `campaignId`, the exact observed `expectedVersion`, and
+an explicit `operationKey`. Review additionally needs `disposition` and `reason`.
+Revision needs `leadId`, `parentRevision`, `subject`, and `body`. Decision needs `leadId`,
+`revision`, and `decision` (`APPROVE` or `REJECT`); rejection requires `note`.
+IDs supplied positionally cannot conflict with JSON input. Context can also be provided
+with `--campaign-id`, `--lead-id` (draft commands), `--expected-version`, and `--operation-key`.
+No version or approval is inferred. Retain exact draft revisions and read server results
+before issuing another command. Bulk migration and provider actions remain separate operations.
+
 ### Bounded system workflow
 
 A strict `xevol.system/v1` JSON manifest can manage one Offer profile, up to two reviewed Offers, up to two manual campaigns, and up to five reviewed Leads:
@@ -100,6 +164,10 @@ Work and system commands return `xevol.cli/v1` envelopes in `--json` mode and ke
 
 ### Ingestion & content
 - `xevol add [url]` — URL ingestion (YouTube + non-YouTube); omit URL when using `--batch`
+- `xevol add --file source.pdf --lang en` — upload PDF, UTF-8 text, audio, or video
+- `xevol retry <id> --regenerate --lang en` — regenerate saved content on the same transcription
+
+Add, upload, status, and retry use the selected Work Workspace's Creator gateway. Retained authority still routes to Creator; exclusive Native authority uses canonical Work ingestion. Use `--operation-id <id>` on a single add/upload/retry to repeat an uncertain response without starting another import. Audio/video requires the Agent's optional ASR configuration.
 - `xevol create [text]` — create from text/file/url/stdin/editor
 - `xevol list` — list transcriptions
 - `xevol view <id>` — view summary/content
@@ -163,9 +231,9 @@ CLI config is stored in:
 
 - `~/.xevol/config.json`
 
-Includes the CLI token, Creator API URL, Work API URL, selected Work and mapped Creator Workspace IDs, and defaults.
+Includes the CLI token, Xevol API URL, Work API URL, selected Work and mapped Creator Workspace IDs, and defaults.
 
-- `XEVOL_API_URL` overrides the Creator API origin.
+- `XEVOL_API_URL` overrides the Xevol API origin used by the stable CLI HTTP protocol.
 - `XEVOL_WORK_API_URL` overrides the Xevol Work origin (default `https://xevol.com`).
 
 The same device-flow CLI token is introspected by Xevol Work and mapped through its imported Creator identity binding. Every request still passes normal active Workspace membership and module gates.