= DEI-SSG

A consent-aware static site generator written in WokeLang, emphasizing human collaboration, ethical computing, and empathetic design as first-class language constructs.

1. Who Is This For?

• WokeLang enthusiasts wanting real-world examples of ethical language constructs

• Content creators seeking SSG tooling with built-in consent and attribution

• Developers exploring human-centered programming paradigms

• Teams requiring auditable decision trails in their build pipelines

2. Why WokeLang for an SSG?

Construct	SSG Application
thanks to (gratitude annotations)	Auto-generated contributor credits in page footers
only if okay (consent gates)	Permission prompts before processing sensitive content or external embeds
measured in (units of measure)	Type-safe handling of image dimensions, file sizes, cache durations
@feeling (empathy annotations)	Document confidence levels in generated output decisions

3. Value Propositions

3.1. Consent All the Way Down

Every transformation that touches user data or external resources passes through explicit consent gates—no silent third-party fetches, no hidden tracking embeds.

render page from source
  only if okay with "embed external fonts"
  only if okay with "analytics snippet"

3.2. Attribution by Default

Contributor acknowledgment isn’t an afterthought—gratitude annotations generate living CREDITS.adoc and per-page attribution blocks automatically.

thanks to "Alex Chen" for "accessibility audit"
thanks to "River Okonkwo" for "dark mode palette"

build styles using palette

3.3. Type-Safe Content Pipeline

Units of measure prevent dimension mismatches and cache-duration bugs at compile time.

thumbnail: Image measured in 320px × 240px
cache_ttl: Duration measured in 24 hours

resize hero_image to thumbnail dimensions
set cache header to cache_ttl

4. Architecture

                    ┌─────────────────────────────────────────────┐
                    │              DEI-SSG Pipeline               │
                    └─────────────────────────────────────────────┘

  ┌──────────┐    ┌──────────┐    ┌──────────┐    ┌──────────┐
  │ Watcher  │───▶│  Parser  │───▶│ Renderer │───▶│  Emitter │
  │          │    │          │    │          │    │          │
  │ @feeling │    │ thanks   │    │ only if  │    │ measured │
  │ cautious │    │ to...    │    │ okay...  │    │ in...    │
  └──────────┘    └──────────┘    └──────────┘    └──────────┘
       │               │               │               │
       ▼               ▼               ▼               ▼
   Filesystem     Attribution      Consent         Type-safe
   Changes        Tracking         Prompts         Output

5. Features

• Incremental builds — only regenerate changed pages

• Hot reload — live preview with consent state preservation

• Multi-format — AsciiDoc, Markdown, and WokeLang templates

• WASM target — compile to WebAssembly for browser-based preview

• Ethical defaults — no external resources without explicit consent gates

6. Ecosystem Integration

DEI-SSG is a standalone project with its own value, and a satellite of the broader poly-mcp portfolio:

• poly-ssg-mcp — unified MCP server for 28+ static site generators

• poly-container-mcp — multi-runtime container management

• poly-iac-mcp — infrastructure as code orchestration

ReScript adapters enable integration with the poly-ssg-mcp protocol layer.

7. Quick Start

# Clone
git clone https://github.com/hyperpolymath/dei-ssg
cd dei-ssg

# Enter development environment
guix shell -D -f guix.scm

# Build site
just build

# Preview with consent prompts
just serve

8. WokeLang Primer

Construct	Syntax	Purpose
Gratitude	thanks to "Name" for "contribution"	Explicit attribution tracking
Consent Gate	only if okay with "action"	User permission checkpoint
Units	value measured in unit	Compile-time dimension safety
Empathy	@feeling confident|cautious|uncertain	Decision confidence metadata

9. License

SPDX-License-Identifier: PMPL-1.0

10. Links

• WokeLang — the language

• eclipse-ssg — Pony-based sibling SSG

• poly-ssg-mcp — MCP integration layer