@sortlist/cli 0.61.0 → 0.62.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.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@sortlist/cli",
3
- "version": "0.61.0",
3
+ "version": "0.62.0",
4
4
  "description": "Sortlist platform CLI — GraphQL federation client",
5
5
  "repository": {
6
6
  "type": "git",
@@ -1,8 +1,8 @@
1
1
  # Billing, approval and spend reports
2
2
 
3
3
  Read before a quote, paid data reveal, watcher, Outreach action or subscription change. Keep the
4
- requested output, caller and payer explicit. Prices come from the [price list](#prices) below,
5
- or from a price list command when `sl operations` shows one for this identity.
4
+ requested output, caller and payer explicit. Prices come from the live price list
5
+ (see [Prices](#prices)), never from memory or an old quote.
6
6
 
7
7
  ## Separate the counters
8
8
 
@@ -22,44 +22,27 @@ have different dates.
22
22
 
23
23
  ## Prices
24
24
 
25
- What each paid item costs a company, in customer credits, as of 10 November 2026. Prices can
26
- change: a quote names this list and its date, and the debit follows the price in force when the
27
- work runs. If `sl operations --search price` shows a price list command for this identity, read it
28
- and prefer its figures. A plan or a balance does not change a price.
25
+ Read the current prices before quoting:
29
26
 
30
- | Atlas reveal dimension | Credits per record revealed |
31
- | --- | --- |
32
- | `CONTACT_IDENTITY` | 2 |
33
- | `CONTACT_LINKEDIN_URL` | 5 |
34
- | `CONTACT_EMAIL_ADDRESS` | 40 |
35
- | `CONTACT_PHONE_NUMBER` | 150 |
36
- | `ORGANIZATION_IDENTITY` | 1 |
37
- | `ORGANIZATION_WEBSITE` | 1 |
38
- | `ORGANIZATION_LINKEDIN_URL` | 2 |
39
- | `ORGANIZATION_ADDRESS` | 2 |
40
- | `ORGANIZATION_FIRMOGRAPHICS` | 5 |
41
- | `ORGANIZATION_EMAIL_ADDRESS` | 5 |
42
- | `ORGANIZATION_PHONE_NUMBER` | 10 |
43
-
44
- | Outreach LinkedIn action | Credits per action |
45
- | --- | --- |
46
- | `linkedinSendMessage` | 5 |
47
- | `linkedinInvite` | 5 |
48
- | `linkedinVisit` | 2 |
49
- | `linkedinLookupProfile` | 2 |
50
- | `linkedinCancelInvitation` | 1 |
27
+ ```bash
28
+ sl billing billing-credit-prices --first 100 --fields billingItem,credits
29
+ ```
51
30
 
52
- Email actions are not charged.
31
+ Each row is a paid item and its credits per unit. Match it to the planned work:
53
32
 
54
- | Credits per delivered Signals lead | Watcher definition slugs |
33
+ | Planned work | Item in the list |
55
34
  | --- | --- |
56
- | 20 | `company-followers`, `company-page-engagement`, `linkedin-reactions`, `competitor-social-reactions`, `influencer-engagement`, `social-mentions`, `dormant-linkedin-poster`, `job-offers`, `republished-job-offers`, `google-business-listing`, `company-registration` |
57
- | 50 | `job-changes`, `employee-departure`, `department-growth`, `company-growth`, `recruitment-campaign`, `event-attendees`, `tech-adoption`, `tech-displacement`, `ai-adoption`, `public-tenders`, `public-contract-award`, `competitor-customers`, `competitor-customer-care`, `competitor-relationships` |
58
- | 100 | `fundraising`, `mergers-acquisitions`, `forecasted-funding`, `forecasted-acquisition`, `forecasted-growth`, `forecasted-ipo`, `radar`, `radar-website` |
35
+ | Reveal of an Atlas dimension on one record | The dimension in lower case, with `contact.` or `organization.` in front: `CONTACT_EMAIL_ADDRESS` is `atlas.contact.email_address`, `ORGANIZATION_FIRMOGRAPHICS` is `atlas.organization.firmographics` |
36
+ | A LinkedIn action | `outreach.linkedin.` and the action: `send_message`, `invite`, `visit`, `lookup_profile`, `cancel_invitation` |
37
+ | A delivered Signals lead | `signals.lead.` and the watcher definition slug, such as `signals.lead.fundraising` |
38
+
39
+ An item the list does not name costs nothing, as email actions do today. A quote names the date
40
+ the list was read, and the debit follows the price in force when the work runs. A plan or a balance
41
+ does not change a price.
59
42
 
60
- An item missing from these tables has no known price: say so, treat the ceiling as unknown and
61
- ask before running it. Never invent a price, use raw GraphQL to look one up, or elevate just to
62
- read billing.
43
+ If this identity has no `billing-credit-prices` command (check `sl operations --search price`),
44
+ the prices are unknown: say so, treat the ceiling as unknown and ask before running paid work.
45
+ Never invent a price, use raw GraphQL to look one up, or elevate just to read billing.
63
46
 
64
47
  When a price cannot be established, report the uncertainty. Do not call an estimate a guaranteed
65
48
  maximum or execute paid work against an unknown ceiling. Continue with already available data or
@@ -79,7 +62,7 @@ action. Do not assume all selected records are owned unless the same company and
79
62
  verified. Reduce the ceiling only for ownership established on that basis. Avoid a broad paid search
80
63
  that can select more or different people than the approved set.
81
64
 
82
- Arithmetic examples at the listed prices:
65
+ Arithmetic examples, with identity at 2 credits and email at 40:
83
66
 
84
67
  - If identity is 2 credits and email is 40, ten of each cost at most
85
68
  `10 × 2 + 10 × 40 = 420` customer credits, for 20 reveal units.
@@ -123,7 +106,7 @@ An example manifest at the listed price, which is not an approval:
123
106
  "company": "example-company",
124
107
  "environment": "production",
125
108
  "verified": true,
126
- "source": "sortlist-cli price list, 2026-11-10",
109
+ "source": "sl billing billing-credit-prices, 2026-11-10",
127
110
  "verifiedAt": "2026-11-10T11:00:00Z",
128
111
  "rates": { "CONTACT_IDENTITY": "2" }
129
112
  }
@@ -133,7 +116,7 @@ An example manifest at the listed price, which is not an approval:
133
116
  Required fields are the exact selected `ids`, exact `dimensions`, payer `company`, `environment`,
134
117
  UTC ISO `asOf`, and `tariff`. The tariff must match company/environment, be attested with
135
118
  `verified: true`, name its source (an HTTP(S) URL without credentials, or a short label such as
136
- `sortlist-cli price list, 2026-11-10`) and verification timestamp, and provide every requested
119
+ `sl billing billing-credit-prices, 2026-11-10`) and verification timestamp, and provide every requested
137
120
  rate. Optional `tariff.validUntil` must be after `asOf`. The helper rejects future verification
138
121
  dates, malformed dates, missing/negative/nonfinite rates, duplicate IDs or dimensions and mixed
139
122
  contact/organization dimensions. Quote organizations separately with their own selected IDs,
@@ -239,7 +222,7 @@ as calculated from the named rate, not as a verified ledger debit. A before/afte
239
222
  can include other concurrent activity; do not attribute its whole change to this task. No readable
240
223
  ledger means final account debit is unverified, not zero.
241
224
 
242
- At the listed prices, a truthful report is:
225
+ With those prices, a truthful report is:
243
226
 
244
227
  ```text
245
228
  Atlas: 19 new reveal units (11 identity, 8 email), company acme.