Skip to main content

Z204 — Forbidden Term

Z204 FORBIDDEN_TERM fires when a documentation file contains a string that the project has declared permanently off-limits via .zenzic.local.toml.

This is not spell-checking. This is a non-negotiable gate: a term in the forbidden list is treated as a security-class finding. Exit 2. Non-suppressible.


What Z204 Catches

ScenarioExampleWhy it matters
Internal codenames"Project Obsidian"Codenames must never appear in public docs
Deprecated product names"Zenzic Legacy"Creates user confusion after a rename
Legal exposure terms"ACME Corp"NDA or trademark violation in public content
Sensitive internal URLs"internal.corp.example.com"Infrastructure disclosure

Configuration

Declare forbidden terms in .zenzic.local.toml:

.zenzic.local.toml
[core]
forbidden_patterns = [
"Project Obsidian", # internal codename
"internal.corp.example.com", # infrastructure URL
"acme-access-key", # vendor-specific key prefix
]

.zenzic.local.toml is the Local Sanctuary — project-specific overrides that are never committed to the shared .zenzic.toml. It extends, never overrides, the shared config.


Difference from Z201 (Credential Scanner)

PropertyZ201 LEAKED_CREDENTIALZ204 FORBIDDEN_TERM
Pattern sourceBuilt-in entropy heuristics + known formatsYour .zenzic.local.toml
Suppressible?No (Exit 2, always)No (Exit 2, always)
ScopeAny credential-shaped stringExact strings you declare
False-positive riskLow (multi-pass normalization)Zero — you own the list

Exit Behavior

Z204 is a policy-violation finding (security-class severity):

  • Exits with code 2 immediately
  • Not suppressed by --exit-zero or exit_zero = true in .zenzic.toml
  • Not suppressed by .zenzic-ignore
  • Not influenced by fail_under threshold

The CLI banner reads POLICY VIOLATION DETECTED (distinct from Z201’s SECURITY BREACH DETECTED) to signal governance enforcement rather than credential incident response.

When Z204 fires, the CI pipeline halts. The term must be removed or the finding investigated — there is no bypass mechanism.