zensical.toml

[project]
site_name = "trustsight"
site_description = "Audits AUR PKGBUILDs before you update: catches careless malice and structural risk, and tells you what it can't verify."
site_url = "https://docs.trustsight.org/"
docs_dir = "docs"
site_dir = "site"

copyright = "© 2026 Emiliano Gandini Outeda"

extra_css = ["stylesheets/extra.css"]

# ==============================================================================
# Theme
# ==============================================================================

[project.theme]
variant = "modern"
custom_dir = "overrides"
favicon = "assets/images/favicon.png"

font.text = "Ubuntu"
font.code = "JetBrains Mono"

features = [
    "navigation.instant",
    "navigation.instant.prefetch",
    "navigation.tabs",
    "navigation.indexes",
    "navigation.top",
    "navigation.footer",
    "search.suggest",
    "search.highlight",
    "content.code.copy",
    "content.code.annotate",
    "toc.follow",
]

[[project.theme.palette]]
scheme = "default"
primary = "custom"
accent = "custom"
toggle.icon = "lucide/sun"
toggle.name = "Switch to dark mode"

[[project.theme.palette]]
scheme = "slate"
primary = "custom"
accent = "custom"
toggle.icon = "lucide/moon"
toggle.name = "Switch to light mode"

# ==============================================================================
# Footer / extra
# ==============================================================================

[[project.extra.social]]
icon = "fontawesome/brands/github"
link = "https://github.com/emiliano-go/trustsight"
name = "trustsight on GitHub"

[[project.extra.social]]
icon = "fontawesome/brands/python"
link = "https://pypi.org/project/trustsight/"
name = "trustsight on PyPI"

# ==============================================================================
# Navigation
# ==============================================================================

[[project.nav]]
Overview = [
  {Home = "index.md"},
  {Changelog = "changelog.md"},
  {License = "license.md"},
]

[[project.nav]]
Security = [
  {"Security Model" = "security.md"},
]

[[project.nav]]
"Get Started" = [
  {Overview = "getting-started/index.md"},
  {Installation = "getting-started/installation.md"},
  {Quickstart = "getting-started/quickstart.md"},
  {"Reading a Report" = "getting-started/reading-a-report.md"},
]

[[project.nav]]
Guides = [
  {Overview = "guides/index.md"},
  {"Auditing Before Update" = "guides/auditing-before-update.md"},
  {"Using in CI" = "guides/using-in-ci.md"},
  {"Acting on a Flag" = "guides/acting-on-a-flag.md"},
  {"Configuring Rules and Weights" = "guides/configuring-rules-and-weights.md"},
  {"Tuning False Positives" = "guides/tuning-false-positives.md"},
]

[[project.nav]]
Rules = [
  {"Rules Overview" = "reference/rules/index.md"},
  {"Rule System" = "reference/rules/system.md"},
  {"Fetch and Execution" = "reference/rules/fetch-and-execution.md"},
  {Obfuscation = "reference/rules/obfuscation.md"},
  {"Deception and Anti-Analysis" = "reference/rules/deception.md"},
  {"Install and Persistence" = "reference/rules/install-and-persist.md"},
  {"Staging and Reconnaissance" = "reference/rules/staging-and-recon.md"},
  {"Integrity and Verification" = "reference/rules/integrity.md"},
  {"Naming and Dependencies" = "reference/rules/naming-and-dependency.md"},
  {"Maintainer and Metadata" = "reference/rules/maintainer-and-metadata.md"},
  {"Temporal Context" = "reference/rules/temporal.md"},
  {Composition = "reference/rules/composition.md"},
  {"Count-Based" = "reference/rules/count-based.md"},
  {"Corpus Behavioral" = "reference/rules/corpus-behavioral.md"},
  {Crossfire = "reference/rules/crossfire.md"},
  {Sabotage = "reference/rules/sabotage.md"},
  {Unverifiable = "reference/rules/unverifiable.md"},
]

[[project.nav]]
Reference = [
  {Overview = "reference/index.md"},
  {"CLI Reference" = "reference/cli.md"},
  {"Python API" = "reference/python-api.md"},
  {"Configuration Reference" = "reference/configuration.md"},
  {"Report Schema" = "reference/report-schema.md"},
  {"Evidence Tiers" = "reference/evidence-tiers.md"},
  {"Baseline Keys" = "reference/baseline-keys.md"},
  {"IOC Federation" = "reference/ioc.md"},
  {"Exit Codes" = "reference/exit-codes.md"},
]

[[project.nav]]
Explanation = [
  {Overview = "explanation/index.md"},
  {"Scoring Philosophy" = "explanation/scoring-philosophy.md"},
  {"Cold Start and Maturity" = "explanation/cold-start-and-maturity.md"},
  {"Corpus and Priors" = "explanation/corpus-and-priors.md"},
  {"Fire Rates" = "explanation/fire-rates.md"},
  {"What TrustSight Cannot See" = "explanation/what-trustsight-cannot-see.md"},
  {"Seed Provenance" = "explanation/seed-provenance.md"},
  {"Benchmarks and Methodology" = "explanation/benchmarks-and-methodology.md"},
  {"Sandboxing the Tokenizer" = "explanation/sandboxing-the-tokenizer.md"},
]

[[project.nav]]
Contributing = [
  {Overview = "contributing/index.md"},
  {"Development Setup" = "contributing/development-setup.md"},
  {"Writing a Rule" = "contributing/writing-a-rule.md"},
  {"Re-baselining" = "contributing/re-baselining.md"},
  {"Publishing Baselines" = "contributing/publishing-baselines.md"},
  {Releasing = "contributing/releasing.md"},
  {"Reviewing a Security Control" = "contributing/security-review.md"},
  {"Blinded Evaluation" = "contributing/blinded-evaluation.md"},
]

# ==============================================================================
# Markdown extensions
# ==============================================================================

[project.markdown_extensions]
tables = {}
admonition = {}
toc = { permalink = true }
"seoslug.contrib.zensical" = {
  canonical_host = "docs.trustsight.org",
  public_base_url = "https://docs.trustsight.org/",
  site_name = "trustsight",
  title_template = "{title} - TrustSight",
  default_og_image = "https://docs.trustsight.org/assets/images/trustsight-banner.png",
  publisher_name = "Emiliano Gandini Outeda",
  locale = "en_US",
  twitter_site = "@emiliano_go_",
  auto_generate_schema = true,
  debug_dir = ".seo-debug",
}

[project.markdown_extensions.pymdownx]
highlight = { anchor_linenums = true, line_spans = "__span", pygments_lang_class = true }
inlinehilite = {}
snippets = {}
superfences = {}
tabbed = { alternate_style = true }
tasklist = { custom_checkbox = true }

[project.markdown_extensions.attr_list]

[project.markdown_extensions.md_in_html]