docs: correct Vercel operator/action tables now that #261/#262/#263 are fixed
58b8401
docs: add GCP Setup guide, cross-link from sidebar
00ef1f8
Fix legacy rule shape shown as universal; document managed rule groups
Configuration.md's Rules section showed the legacy (Vercel-only)
conditionGroup/active/mitigate.action shape as if it applied to every
provider. A config with provider/providers set (required for
Cloudflare/Fastly) needs a structurally different shape
(conditions/enabled/action:{type}) -- verified empirically that the
old example fails real schema validation when provider is set.
Rewrote the Rules section with both shapes clearly labeled, correct
per-provider field/operator/action support tables (verified against
each provider's translator source, not guessed), and flagged real
Vercel translator bugs found along the way (doorman#261, #262) rather
than silently documenting broken combinations as if they work.
Also:
- Documented the new managedRules config surface (Cloudflare-only)
- Added a format-shape note to Examples.md and Getting-Started.md,
whose rule examples are genuinely legacy-format (matching the real
examples/ files) but weren't labeled as such
- Added a Managed Rule Groups section to Cloudflare-Setup.md
f6e9b57
fix: correct VERCEL_TEAM_ID from required to optional
Written against a stale local checkout of the CLI repo that predated
the actual fix. On current main, src/lib/providers/vercel/credentials.ts
explicitly marks teamId required: false with a comment citing issue
#207 ("every account, including Hobby, is a team... omitting it lets
Vercel resolve against the default team"), and VercelProvider.ts no
longer throws when it's missing. The "required in practice" callout
this page shipped with was already wrong the moment it was written.
0c1a83a
docs: add Vercel Setup guide, cross-link from Cloudflare/Fastly
Vercel had no dedicated setup guide even though it's the default
provider — general instructions were folded into Getting-Started.md
while Cloudflare and Fastly each got their own thorough guide
(credentials, day-to-day commands, provider quirks, troubleshooting,
security). Adds parity, verified against real CLI source (init.ts,
VercelProvider.ts, providerHelper.ts, promptForCredentials.ts, setup.ts)
rather than copied from the other guides' assumptions.
Notably documents that VERCEL_TEAM_ID is required in practice today,
despite setup.ts/README describing it as optional for personal
accounts — the runtime throws if it's missing.
11bb8b0
docs: add Fastly Next-Gen WAF coverage
New Fastly-Setup and Fastly-Migration pages mirroring the existing
Cloudflare ones, registered in the sidebar. Updated Home,
Getting-Started, Configuration, Commands-Overview, and
CI-CD-Integration to mention Fastly alongside Vercel/Cloudflare
wherever they previously only covered two providers — condition
type/operator/action compatibility tables, env vars, CLI examples,
and the multi-provider CI pipeline example.
Companion to gfargo/doorman#204/#205 (Fastly provider adapter).
936d94e
docs: fix remaining fabricated CLI flags and stale claims found in follow-up review
Found by a fresh review pass after the earlier wiki cleanup (commit
ac2db93) missed a few instances of the same bug class:
- CI-CD-Integration.md: `doorman validate --strict` doesn't exist
(validate only has --config/-c and --verbose/-v)
- Commands-Overview.md: `doorman init --provider cloudflare
--interactive` doesn't exist (init has no --provider flag at all,
contradicting what Cloudflare-Setup.md already correctly says)
- Commands-Overview.md: "Global Options" claimed --provider/--token/
--verbose are available on "most commands" — --verbose only exists
on validate, --provider/--token only exist on 8 of 14 commands
- Configuration.md: actions table wrongly marked Vercel as supporting
`allow` (Vercel's action enum has no `allow`; the equivalent is
`bypass`)
- Getting-Started.md: action list used `rateLimit`/`rewrite`, neither
of which are real Vercel action values (rate_limit is snake_case;
rewrite is Cloudflare-only)
- Examples.md: IP blocking example omitted `hostname`, a required
field on every ips[] entry, and the linked full example
(ip-block.json) actually demonstrates a different technique
(rules[] + ip_address conditions) than the ips[] array shown inline
- now noted explicitly instead of silently mismatched
- Getting-Started.md: stale "Doorman 2.0" version callout
- Templates.md / Commands-Overview.md: `doorman template` (no name)
launches an interactive select prompt, it doesn't list templates
1b11108
docs: fix wiki pages documenting nonexistent commands/flags (#89, #90, #99)
- Cloudflare-Migration.md documented a `doorman migrate` command that
doesn't exist (unbuilt "Phase 6" roadmap item per RELEASE-2.0.md).
Added a clear "not yet available" banner and a new manual-migration
workflow using commands that exist today (backup, download, hand-edit,
validate, sync), and marked the automated-workflow content as planned.
- Home.md and Cloudflare-Setup.md called Cloudflare support "stable"/
"production-ready", contradicting CLAUDE.md/AGENTS.md's "(beta)"
label. Updated both to say beta.
- Fixed several documented-but-nonexistent flags/subcommands:
`template add <name> --provider cloudflare` (no `add` subcommand or
`--provider` flag on template), `init --provider cloudflare`
(init has no --provider flag or Cloudflare support at all),
`validate --strict`/`--provider`, `diff --source/--target`
(diff doesn't do cross-provider comparison), `list --verbose`
(use --debug), `backup --name` (backups use an auto-generated
timestamped filename, controlled via --output).
ac2db93
docs: sync wiki for the vercel-doorman -> @gfargo/doorman rename
Install/npx examples now reference @gfargo/doorman, already-installed
binary examples (CI YAML, package.json scripts) use the doorman bin
name, and GitHub/npm links point at gfargo/doorman. Also drops the
"when Cloudflare support lands" line in Getting-Started since
Cloudflare WAF support has already shipped.
34ba920
docs: add `remove` command to Commands Overview
6942b7c
docs: add `add` command to Commands Overview and Getting Started
f6f5ccf
docs: update for 2.0 stable release — remove beta/coming-soon language
f897ce7
docs: update config filename references to .doorman.json
476921b
docs: add Cloudflare setup and migration guides, update sidebar
5cf8bd2
docs: add initial wiki pages for documentation site
e8d4faa