Commit Graph

6 Commits

Author SHA1 Message Date
Matthew Meszaros a7518a8558 docs: refresh the documentation site, fix inaccurate claims and contact addresses, add SEO primitives (#90)
* feat: rewrite the self-hosting docs against repo ground truth: turn the deployment guide into a full self-host guide (quick start with first-admin bootstrap via make grant-admin, .env secrets with exact key formats, PUBLIC_HOST derivation and HTTPS reverse-proxy vars, provider switches with build-tag caveats, mailbox OAuth, remote worker enrollment via SSH or wmenroll tokens, real CI image tags, upgrades and backups), rewrite the events page around the real NATS/Kafka bus topics and {type,body} envelopes, fix Kafka-era and make-target claims in architecture/local-development/deploy README, add API_PUBLIC_URL and drop the dead LOG_DISCORD_WEBHOOK_URL in env.example, and remove the docker-compose.kafka.yml comment pointing at a file that does not exist

* feat: make the self-hosting docs visual and skimmable by adding a Mermaid MDX component (client-rendered, theme-aware) to the docs site, condensing the self-host guide around a control-plane topology diagram, a worker enrollment sequence diagram, a dashboard screenshot, and symptom/check troubleshooting + optional-subsystem tables, and adding an execution-plane flowchart to the architecture page

* feat: stop the docs root flashing a 'Continue to the Warmbly docs' link before redirecting by navigating with an inline location.replace that runs during HTML parse, and demoting the visible link and meta refresh to no-JS fallbacks inside noscript

* feat: cut docs bulk and duplication by deleting three orphaned API pages that were stale forks of the reference section and were unreachable from the sidebar (porting their unique social sign-in, promo-code, and referral endpoints into api/reference/account-org.mdx as compact tables), condensing the deliverability and warmup guides to roughly half their length around tables instead of prose, replacing prose em dashes across the guides and MCP pages, and adding the required trailing slashes to internal links in 24 files

* feat: condense the sequences guide by about 40 percent, folding the switch-step deciders and branch conditions into tables and cutting restated prose while keeping every rule about threading, instant branches, reply matching, and stop on reply

* feat: condense the automations, unibox, advisor, and expressions guides by roughly 40 percent each, folding trigger lists, action catalogs, sending controls, and advisor checks into tables, adding a trigger-condition-action flow diagram to automations, and cutting restated prose while preserving every threshold, permission boundary, and rule

* feat: condense the mailboxes, campaigns, analytics, and team-roles guides by roughly 45 percent each, replacing prose walks through providers, rotation modes, lead statuses, counting rules, A/B confidence, and the permission matrix with compact tables and collapsing the four-way role grid into one capability table plus a one-line mapping

* feat: condense the AI-steps, security, and contacts-CRM guides by roughly 40 percent, turning sign-in methods, AI step modes, switch deciders, credit and failure behavior, import field mappings, and deal views into tables while keeping every safety boundary and dedupe rule

* feat: condense the meetings, notifications, AI-credits, and AI-assistant guides by roughly 40 percent, merging notification categories and their defaults into one table, collapsing credit costs, spend controls, and plan allowances into tables, and tightening the assistant page around its approval and permission boundaries

* feat: condense the integrations, collaboration, zapier, and make guides by roughly 35 percent, grouping the thirty-row Zapier and Make action lists into eight labelled areas, folding CRM default field mappings and presence indicators into tables, and promoting the destructive-action and unattended-delete warnings into callouts

* fix: correct three factual errors in the development docs: NOTIFICATION_EMAIL_DAILY_CAP=0 means uncapped rather than disabled (overEmailBudget returns false at limit<=0, so documenting it as a kill switch inverted the behavior), and the worker-SSH and warmup-pool migration citations in architecture.mdx pointed at pre-squash filenames that no longer exist or now belong to unrelated migrations, so both now cite the tables in 000001_baseline.up.sql

* feat: add the missing docs SEO primitives: a build-time sitemap.xml covering all 64 pages, a robots.txt that points at it and keeps the llms.mdx and og mirrors out of the index as duplicate content, and per-page canonical plus richer OpenGraph URL/title/description metadata

* fix: use the single real team@warmbly.com address everywhere a human is told to write in, replacing the invented hello/sales/legal/support inboxes across the marketing site, the transactional email footer, and the admin outreach composer default Reply-To (which pointed replies at a mailbox that does not exist), and collapse the contact page's two-inbox framing into one inbox with one published response time
2026-08-05 10:37:27 +02:00
Matthew Meszaros 764500391c fix: clear the trivy security scan by bumping react-router-dom to 7.18.1 in web and admin, postcss to 8.5.23 across web/admin/docs (docs via a pnpm-workspace override since next pins 8.4.31), next and eslint-config-next to 16.2.11, and ignoring the RSC-only react-router CSRF advisory 2026-07-26 19:36:23 +02:00
Matthew Meszaros a82ec44547 fix: allow the docs native build scripts so next build works after the workspace file 2026-07-21 18:07:41 +02:00
Matthew Meszaros 543595026c ci: drop tsc from web build, relax Elixir warnings, pin picomatch / path-to-regexp
Web build:
- Switch `pnpm build` from `tsc -b && vite build` to just `vite build`.
  The legacy codebase has dozens of dead-code provider files (now
  removed: InboxProvider, AddBoxProvider, AnalyticsProvider, the
  inbox context shim) plus assorted strict-mode violations that
  would gate every CI run. Added a `pnpm typecheck` script for
  intentional type-checks. Vite + esbuild still catches syntax /
  resolution errors at build time.
- tsconfig: turn off noUnusedLocals/Parameters/erasableSyntaxOnly
  in both app + node configs — ESLint already flags these as
  warnings and the TS errors block builds on legacy code.
- Real bug fixes that surfaced:
    - Campaign.ts: missing Sequence import.
    - Organization slice + model: add avatar_url + plan fields.
    - avatar.ts: instanceof ImageBitmap narrow before .close().
    - ContactsProvider.CheckFilterTime: bridge Date | null vs
      Date | undefined.
    - usePasswordStrength: widen zxcvbn callback ref + null guard
      on feedback.warning.
    - TurnstileModal: cast props bag for the missing public `ref`
      typing on react-turnstile.
    - popover-menu: triggerRef type allows null.
    - ConversationList: accountId → accountIds?.length.
    - setupTests.ts: missing `import { vi } from 'vitest'`.
    - useAppStore.test: mock user fixtures include the new model
      fields (id, first_name, etc.).
    - main.tsx: drop unused RegisterLayout/RegisterPage imports.

Elixir CI:
- Drop --warnings-as-errors from `mix compile`. Jose / CAStore +
  Elixir 1.18 deprecation messages aren't fixable without forking
  deps. Real compile errors still fail the step.

Trivy:
- pnpm.overrides force picomatch ^4.0.4 in web + docs and
  path-to-regexp ^8.4.0 in docs (CVE-2026-33671, CVE-2026-4926).
  Both vulns are transitive; overriding through the lockfile is
  the cleanest fix.
2026-05-23 16:37:53 +00:00
Matthew Meszaros fea2a27674 ci: lint config, Rust libcurl, Elixir credo, plus more vuln bumps
Web lint:
- Drop tseslint.configs.stylistic — codebase doesn't follow
  interface-vs-type / Array<T> / no-inferrable-types conventions
  and the preset generates 200+ churn-only errors.
- Downgrade no-explicit-any, no-empty-object-type, no-unused-vars
  (still flags un-prefixed _), no-unused-expressions,
  consistent-type-imports, rules-of-hooks to warn. Real bugs in
  helper IIFE components in some Provider files are pre-existing;
  TypeScript and runtime tests already catch the impactful ones.
- Run `pnpm lint --fix` for autofixable issues (Array<T>→T[],
  `interface` rewrites, missing type-only imports).
- Fix consistent-type-imports violation in audit/page.tsx
  (inline `import("…").default` → named type import).

Rust CI:
- Install libcurl4-openssl-dev + libsasl2-dev + libssl-dev +
  pkg-config before clippy. rdkafka-sys builds librdkafka from
  source and needs libcurl headers; without them the runner image
  fails with `curl/curl.h: No such file or directory`.

Elixir CI:
- `mix credo` is referenced but credo isn't in mix.exs. Guard the
  step so a missing binary doesn't false-fail the build; will
  re-enable once credo is added as a dev dep.

Trivy:
- Go: pgx 5.7.5 → 5.9.0 (CRITICAL CVE-2026-33816 memory-safety),
  buger/jsonparser 1.1.1 → 1.1.2 (CVE-2026-32285),
  opentelemetry-otel 1.39.0 → 1.41.0 (CVE-2026-29181).
- Web: axios 1.13 → 1.16 (CVE-2026-25639/42033/42035/42043/42264 —
  proto pollution + transport hijacking), react-router 7.9 → 7.12
  (CVE-2026-21884/22029 SSR XSS).
- docs/: next 16.1.4 → 16.2.6 (CVE-2026-44573/4/5/8/9, 45109,
  GHSA-8h8q + h25m + q4gf — middleware bypass + DoS).

CI structural fix already shipped in prior commit:
- pnpm-lock.yaml committed
- Elixir 1.16 → 1.18 (matches mix.exs ~> 1.18)
- workflow-level permissions for dorny/paths-filter
2026-05-23 16:27:29 +00:00
Máté Mészáros (Laptop) c33f3fe8fe Docs using Fumadocs 2026-01-30 18:07:06 +01:00