@invinite-org/invinite-data-cli 0.6.0 → 0.7.0

package/claude-plugin/commands/analyze-earnings-call.md

@@ -15,8 +15,8 @@ Analyze the earnings call requested in `$ARGUMENTS` using Invinite Data. Prefer
    - Q&A: `invd earnings qa` (`earnings_call_qa`) and participants: `invd earnings participants` (`earnings_call_participants`)
    - diff vs the prior call: `invd earnings diff` (`earnings_call_diff`)
    - optional, price moves during the call: `invd earnings price-attribution` (`earnings_call_price_moves`) — minute returns next to what was being said; skip it on a `404 price_attribution_unavailable`
-   - only when a claim needs the exact wording: `invd earnings transcript` (`earnings_call_transcript`) or `invd earnings search -q "<topic>" --event-id <event_id>` (`earnings_call_search`)
-   - when the call has documents (`has_documents`): `invd earnings documents` (`earnings_call_documents`) — CFO commentary, shareholder letter, data sheets; for context beyond the call (annual report, investor-day deck) `invd earnings document-search -q "<topic>" -i <TICKER>` (`earnings_document_search`)
+   - only when a claim needs the exact wording: `invd earnings transcript` (`earnings_call_transcript`) or `invd earnings search -q "<topic>" --mode hybrid --event-id <event_id>` (`earnings_call_search`; `--mode literal` for an exact figure or term)
+   - when the call has documents (`has_documents`): `invd earnings documents` (`earnings_call_documents`) — CFO commentary, shareholder letter, data sheets; for context beyond the call (annual report, investor-day deck) `invd earnings document-search -q "<topic>" --mode hybrid -i <TICKER>` (`earnings_document_search`); a `coverage.completeness` of `partial` / `unknown` means no hits is not proof the topic is absent
 3. **Summarise**:
    - **Results vs guidance** — reported figures from the press release against the guidance given on the prior call (`invd earnings guidance-history -i <TICKER> --metric <metric>` for a metric's series).
    - **Guidance changes** — each item raised, lowered, maintained, introduced or withdrawn (`direction`), with the period and basis (GAAP / non-GAAP).

package/claude-plugin/skills/invinite-data-cli/SKILL.md

@@ -128,6 +128,7 @@ Commands about one call take a selector: `--event-id <event_id>` (from `events`
 - `earnings event --include observations` adds the date / time observations; `earnings participants --include evidence` the participation evidence.
 - Every `*_ms` field is milliseconds from the call's start: cite it as `[m:ss]`. `qa_start_ms` is where the Q&A begins (null without one).
 - Company documents and document-search hits are company-published material: quote them as "passages from company-published documents", never as verified facts, and cite each with its document title, year and page (`page`; open `url` at `#page=<page>`). A `webcast` row is link-only (`url` null, `source_url` = the replay page, `link_status`).
+- `earnings search` and `earnings document-search` take `-m, --mode`: `hybrid` for natural-language questions, `lexical` (the default) for words and phrases, `literal` for exact strings such as `FY2027` or `10b5-1` (case-sensitive; `--case-sensitive false` ignores case), `semantic` for meaning only. Every mode costs the same. In `--json` output read `coverage.completeness` before concluding anything from few or no hits: `partial` / `unknown` means the index does not cover the whole scope yet, so absence is not proof. `match.spans` are code-point offsets of the matched characters in `text`.
 - Media signed URLs expire after 15 minutes; `--output` on the download commands saves the file.
 - The live transcript (`ws listen --earnings`), audio, slides, the live stream and webhooks need the PRO plan (calendar, events and `live` need LITE, the other reads STANDARD); a `403` names the plan a route needs.
 
@@ -200,11 +201,11 @@ invd earnings calendar --json
 # Call-over-call diff (optional: --event-id, --identifier, --year, --quarter, --date, --event-type, --vs)
 invd earnings diff --event-id cfbcf4f8-6d4d-41ef-9197-1c91ff2aef8c --json
 
-# Search investor documents (optional: --identifier, --kind, --section, --year, --table, --limit)
+# Search investor documents (optional: --mode, --case-sensitive, --identifier, --kind, --section, --year, --table, --limit)
 invd earnings document-search -q "Azure growth" -i MSFT --json
 
 # Earnings call by ID (optional: --include)
-invd earnings event --event-id cfbcf4f8-6d4d-41ef-9197-1c91ff2aef8c --json
+invd earnings event --event-id 9655a5db-8968-40be-8c79-7cd1a8aed8e9 --json
 
 # Event history of a company (optional: --from, --to, --include, --event-type, --sort, --limit, --offset, --all)
 invd earnings events -i MSFT --json
@@ -236,8 +237,8 @@ invd earnings prosody --event-id cfbcf4f8-6d4d-41ef-9197-1c91ff2aef8c --json
 # Earnings call Q&A (optional: --event-id, --identifier, --year, --quarter, --date, --event-type, --limit, --offset, --include, --all)
 invd earnings qa --event-id cfbcf4f8-6d4d-41ef-9197-1c91ff2aef8c --json
 
-# Search earnings calls (optional: --event-id, --identifier, --from, --to, --type, --event-type, --limit)
-invd earnings search -q "Azure growth" -i MSFT --json
+# Search earnings calls (optional: --mode, --case-sensitive, --event-id, --identifier, --from, --to, --type, --event-type, --limit)
+invd earnings search -q "Azure growth" -m semantic -i MSFT --json
 
 # Live audio stream URL (optional: --event-id, --identifier, --year, --quarter, --date, --event-type)
 invd earnings stream --event-id cfbcf4f8-6d4d-41ef-9197-1c91ff2aef8c --json
@@ -632,7 +633,8 @@ Find the call, then read it from the cheapest source to the most detailed:
 invd earnings events -i NVDA -s desc -l 4 --json            # pick the event_id
 invd earnings transcript --event-id <event_id> --format sections --json
 invd earnings extractions --event-id <event_id> --kind guidance --json
-invd earnings search -q "gross margin outlook" --event-id <event_id> --json
+invd earnings search -q "gross margin outlook" --mode hybrid --event-id <event_id> --json
+invd earnings document-search -q FY2027 -i NVDA --mode literal --json   # exact token in the company's documents
 invd earnings price-attribution --event-id <event_id> --json   # optional: price moves during the call
 ```
 `price-attribution` (MCP `earnings_call_price_moves`, STANDARD, 1 credit) lines up minute returns with what was said in that minute: temporal coincidence, not attribution of cause; pre-market bars are sparse, and a `404 price_attribution_unavailable` means the call is not attributed yet.

package/dist/src/generated/cli-manifest.json

@@ -1,6 +1,6 @@
 {
   "specVersion": "1.0.0",
-  "specSha256": "cafa5748c4ca0c51533695eb005138bdd888d5e4144163269fb8b3a245cd0a10",
+  "specSha256": "9f4094202acf89ee7a89a522e9825beac9df8a364d2d4b0f59710dc05d986cc5",
   "groups": [
     {
       "name": "company",
@@ -708,9 +708,37 @@
           "required": true,
           "type": "string",
           "example": "Azure growth",
-          "description": "The question or phrase to search for",
+          "description": "The keywords, exact text (mode=literal) or question (semantic / hybrid) to search for",
           "alias": "q"
         },
+        {
+          "name": "mode",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "enum": [
+            "lexical",
+            "literal",
+            "semantic",
+            "hybrid"
+          ],
+          "default": "lexical",
+          "example": "hybrid",
+          "description": "lexical (keywords, default), literal (exact characters), semantic (meaning) or hybrid (lexical + semantic, fused)",
+          "alias": "m"
+        },
+        {
+          "name": "case_sensitive",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "enum": [
+            "true",
+            "false"
+          ],
+          "example": "false",
+          "description": "mode=literal only: \"false\" matches regardless of case (default \"true\": case-sensitive)"
+        },
         {
           "name": "identifier",
           "in": "query",
@@ -780,6 +808,7 @@
       "rowsPath": "hits",
       "columns": [
         "score",
+        "match.type",
         "kind",
         "year",
         "group",
@@ -819,7 +848,7 @@
           "in": "path",
           "required": true,
           "type": "string",
-          "example": "cfbcf4f8-6d4d-41ef-9197-1c91ff2aef8c",
+          "example": "9655a5db-8968-40be-8c79-7cd1a8aed8e9",
           "description": "Event identifier (event_id of any earnings-calls response)"
         }
       ],
@@ -1742,9 +1771,37 @@
           "required": true,
           "type": "string",
           "example": "Azure growth",
-          "description": "The question or phrase to search for",
+          "description": "The keywords, exact text (mode=literal) or question (semantic / hybrid) to search for",
           "alias": "q"
         },
+        {
+          "name": "mode",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "enum": [
+            "lexical",
+            "literal",
+            "semantic",
+            "hybrid"
+          ],
+          "default": "lexical",
+          "example": "semantic",
+          "description": "lexical (keywords, default), literal (exact characters), semantic (meaning) or hybrid (lexical + semantic, fused)",
+          "alias": "m"
+        },
+        {
+          "name": "case_sensitive",
+          "in": "query",
+          "required": false,
+          "type": "string",
+          "enum": [
+            "true",
+            "false"
+          ],
+          "example": "false",
+          "description": "mode=literal only: \"false\" matches regardless of case (default \"true\": case-sensitive)"
+        },
         {
           "name": "event_id",
           "in": "query",
@@ -1813,12 +1870,14 @@
         }
       ],
       "exampleParams": [
-        "identifier"
+        "identifier",
+        "mode"
       ],
       "view": "table",
       "rowsPath": "hits",
       "columns": [
         "score",
+        "match.type",
         "type",
         "symbol",
         "conference_date",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@invinite-org/invinite-data-cli",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "type": "module",
   "description": "CLI for the Invinite Data API",
   "publishConfig": {