@xenia-martech/mcp 1.0.0-dev.5 → 1.0.0-dev.7

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.
Files changed (3) hide show
  1. package/README.md +17 -1
  2. package/dist/bin.js +68 -59
  3. package/package.json +1 -1
package/README.md CHANGED
@@ -21,6 +21,21 @@ you> wire the abandoned-cart journey into my checkout
21
21
  → detects your stack, writes .env, and edits your component
22
22
  ```
23
23
 
24
+ ## What it wires
25
+
26
+ After you choose how to get the SDK token, the assistant does the rest without stopping:
27
+
28
+ - **One-time setup** for your stack (`xenia_setup_project`). In Next.js: `proxy.ts` (or merges into
29
+ your existing one) for the visitor cookie and page URL, a `lib/xenia.ts` server helper with a
30
+ timeout and circuit breaker, consent from your cookie banner, and form conversions.
31
+ - **Each journey** you name, in your real components: server-side with `{ fallback: null }` so an
32
+ outage renders your default content; `track()` for event triggers.
33
+ - **Checks** — a type-check/build and `xenia_verify`, plus warnings about the journey itself (e.g. an
34
+ A/B split that would show the same visitor different variants) with the dashboard fix.
35
+
36
+ It stops to ask only for the token choice, a production write, or — if your site has no consent
37
+ banner — whether analytics needs consent.
38
+
24
39
  ## Install
25
40
 
26
41
  Pick your assistant — each command registers the server via the assistant's own MCP config.
@@ -68,9 +83,10 @@ can be disconnected there at any time.
68
83
  | `xenia_status` | Who is connected, and the active workspace |
69
84
  | `xenia_list_scopes` / `xenia_select_scope` | See and switch org / tenant / environment |
70
85
  | `xenia_list_journeys` | The journeys in the active workspace, each with its trigger(s) — flagged `can't connect` for a scheduler or a Shopify/HubSpot trigger whose connector isn't connected |
71
- | `xenia_get_journey` | Trigger id, method, request fields, content keys, and a stack-matched SDK snippet |
86
+ | `xenia_get_journey` | Trigger id, method, request fields, content keys, a stack-matched SDK snippet, and journey warnings (e.g. a non-sticky A/B split) |
72
87
  | `xenia_list_content_keys` | Every personalization key, and which journeys resolve it |
73
88
  | `xenia_detect_stack` | Framework, SDK entry point, and which token type this project needs |
89
+ | `xenia_setup_project` | The one-time wiring plan for this stack: files to create or merge, consent, forms, verification |
74
90
  | `xenia_mint_sdk_token` | Mint a token and write it to your env file |
75
91
  | `xenia_verify` | Read journeys, resolve a content key, optionally fire a test event |
76
92
  | `xenia_logout` | Revoke the session and forget the local credential |