Deployed runtime: email, signatures, and billing
| Capability | Environment variables | Dev / production rule |
|---|---|---|
| Email backend | NAVIGATOR_EMAIL_BACKEND | Must be sendgrid outside the harness |
| Outbound SendGrid | SENDGRID_API_KEY, SENDGRID_FROM_EMAIL | Required outside the harness |
| SendGrid base URL | SENDGRID_BASE_URL | Official hosts only outside the harness |
| Inbound URL gate | SENDGRID_INBOUND_SECRET | Required outside the harness |
| Inbound signature | SENDGRID_INBOUND_PUBLIC_KEY | Required when summary review is enabled |
| Attachment scanner | NAVIGATOR_CLAMD_ADDR | Required in every deployed profile; private clamd only |
| Event webhook | SENDGRID_EVENTS_SECRET, SENDGRID_EVENTS_PUBLIC_KEY | Required outside the harness |
| Threaded mail | NAVIGATOR_PARSE_HOST, NAVIGATOR_LAWYER_NOTIFY_EMAIL | Both values enable it |
| Summary opt-in | NAVIGATOR_SUMMARY_ENABLED | Enables durable review |
| Summary identity | NAVIGATOR_DEPLOYMENT_ID, NAVIGATOR_SUMMARY_CHANNEL_ID | Durable review coordinates |
| Summary Firm | NAVIGATOR_SUMMARY_FIRM_ID | Optional; unset uses the Firm wearing the neon brand |
| Summary account | NAVIGATOR_SUMMARY_PROVIDER_ACCOUNT | Optional; defaults to sendgrid |
| Summary envelope | NAVIGATOR_SUMMARY_ENVELOPE_RECIPIENTS | Unset/off by default; blank values fail |
| SMS | NAVIGATOR_SMS_NUMBER, TWILIO_AUTH_TOKEN, TWILIO_ACCOUNT_SID | Off by default; a number needs both |
| Voice lines | NAVIGATOR_VOICE_NUMBERS | Optional brand_key=+E164 pairs; omitted Brands keep their own |
| SMS test numbers | NAVIGATOR_SMS_TEST_RECIPIENTS | Staging secret: the only numbers simulated matters may text |
| SMS reply account | TWILIO_ACCOUNT_SID | Replies need live production egress and sender registration |
| Summary Gemini model | NAVIGATOR_SUMMARY_GEMINI_MODEL | Optional Vertex model override |
| Summary Gemini location | NAVIGATOR_SUMMARY_GEMINI_LOCATION | Optional Vertex location override |
| Summary input limit | NAVIGATOR_SUMMARY_MAX_INPUT_CHARS | Optional input limit |
| Summary output limit | NAVIGATOR_SUMMARY_MAX_OUTPUT_TOKENS | Optional output limit |
| DKIM fence | NAVIGATOR_DKIM_REQUIRE_DOMAIN | Optional domain pin |
| Lawyer-sender DKIM check | none (always on) | Must pass for sender's own domain on every lawyer command/relay |
| Internal ops notices | SLACK_WEBHOOK_URL | Optional; otherwise captured in memory |
| Per-Project client-view notices | SLACK_BOT_TOKEN | Required outside the harness; creates private Project channels |
| Inbox notice Firm | SLACK_MESSAGES_FIRM_ID | Optional; unset uses the Firm wearing Neon |
| Dash0 endpoint | DASH0_ENDPOINT | Optional staging-only integration declaration |
| Dash0 dataset | DASH0_DATASET | Required with DASH0_ENDPOINT |
| Dash0 token | DASH0_TOKEN | Encrypted Secret Manager input; required with DASH0_ENDPOINT |
| Signature provider | NAVIGATOR_SIGNATURE_PROVIDER | fake/docusign; unset fails boot; fake refuses production |
| DocuSign endpoint | DOCUSIGN_BASE_URL | Declares DocuSign; demo in dev, live in production |
| DocuSign account | DOCUSIGN_ACCOUNT_ID | Environment-specific account |
| DocuSign JWT IDs | DOCUSIGN_INTEGRATION_KEY, DOCUSIGN_USER_ID | Preferred auth path |
| DocuSign JWT proof | DOCUSIGN_PRIVATE_KEY, DOCUSIGN_OAUTH_BASE | Preferred auth path |
| DocuSign static auth | DOCUSIGN_ACCESS_TOKEN | Short-lived fallback |
| DocuSign signer | DOCUSIGN_SIGNER_EMAIL, DOCUSIGN_SIGNER_NAME | Required signer identity |
| DocuSign webhook | DOCUSIGN_HMAC_KEY, DOCUSIGN_WEBHOOK_SECRET | Required once DOCUSIGN_BASE_URL is set |
| Xero tenant | XERO_TENANT_ID, XERO_BASE_URL | All Xero values select real billing |
| Xero OAuth client | XERO_CLIENT_ID, XERO_CLIENT_SECRET | Otherwise stub billing |
| Xero OAuth token | XERO_TOKEN_URL, XERO_SCOPE, XERO_ACCESS_TOKEN | Otherwise stub billing |
The signature provider is a closed enum, SignatureProviderKind: fake (the local signature loop — envelopes on disk,
local sign pages, DocuSign-Connect-shaped HMAC-signed completion webhooks; dev and CI only, refuses production) or
docusign (the real eSignature REST API). There is no implicit default: unset refuses to boot. An envelope on the fake
provider carries one of two statuses, EnvelopeStatus: sent (anchors validated against the prepared PDF, PDF stored)
or completed (every recipient signed, documents and certificate filed). There is no third state. Tests fail the loop
on purpose with the third enum, Fault — send, view, or webhook — and the durable envelope keeps its last true
state across every injected failure. Before anything is sent, on either provider, prepare_envelope groups the
manifest's fields into per-signer, per-role tabs (SignatureFieldKind::tabs_key picks the tab type, the recipient's
role picks the sign page) and refuses the send with a typed SignatureError::TabValidation when a field names no
recipient, or SignatureError::AnchorValidation when the prepared PDF's text lacks the field's nlsig- anchor. Off the
loop, a matter's execution reading is another closed enum, OnboardingStatus (store/src/projects.rs): pitch — no
completed, Navigator-sent onboarding envelope on the matter's onboarding notation — or official — that envelope has
completed a loop Navigator itself sent. It is additive to MatterLifecycle (pitch/active/closed), which it does
not change, and surfaces on the matter page, through navigator project lifecycle, and in the Portal. The funnel the
prospective client walks is itself a closed enum, FunnelEvent (telemetry/src/lib.rs), whose steps are enumerated
with their fields in docs/observability.md — lead_captured, offer_accepted (a start-door acceptance: the offer's
matter, notation, and proposed terms exist), intake_complete, review_entered, and sent — every field an
identifier, never client content.