let d = import "../defaults.ncl" in

# Consumption contract for publishing content INTO a Rustelo HTMX-SSR site.
#
# This mode exists because the site's self-description validates content QUALITY
# (validate-content: bilingual parity; plan-publication: coverage/SEO/state) but
# never declared the MECHANICS of getting a page to render. Those mechanics live
# scattered in adr-001 (build-time codegen), adr-006 (htmx profile), and adr-007
# (templates+generator). A consumer that assumes "drop a markdown file and it is
# visible" is wrong by design: routes and content-kinds are build-time codegen.
#
# The build/runtime boundary — VERIFIED against the binary, not assumed:
#   - Content-TYPE discovery is RUNTIME. content_processor reads
#     site/content/content-kinds.toml ([[content_kinds]] name/enabled); if that
#     file is absent it falls back to [blog, recipes] (rustelo_server bin: "no
#     hardcoded types"). So enabling a new kind (projects, …) is a TOML edit →
#     NO recompile. A kind that is a silent no-op is simply missing from that TOML.
#   - Markdown WITHIN an enabled kind is indexed at runtime by content_processor
#     (→ site/r/<kind>/<lang>/) → NO recompile.
#   - Only ROUTES are build-time codegen (config/routes/*.ncl, adr-001): the server
#     must already carry the kind's <Handler> route. Adding a NEW route REQUIRES
#     `cargo build`. Reusing an existing routed kind (e.g. projects) does not.
#   - Serving path: the server reads processed content from public/r; if the site
#     uses it, sync site/r → site/public/r (just sync) after reindexing.
#
# Content layout per kind shape (from the living model):
#   - index-style (projects):  content/<kind>/<lang>/<slug>/index.md   → /<kind>/<slug>
#   - category-style (blog):    content/<kind>/<lang>/<category>/<slug>.md → /<kind>/<category>/<slug>
#
# Site identity (logo/name/footer/nav) is NOT content — it lives in
# site/config/site.ncl + templates/build-tools/partials/{header,footer}.tera.

d.make_mode String {
  id      = "publish-content",
  trigger = "Publish content into a Rustelo HTMX-SSR site: place markdown in the content-kind's on-disk layout, reindex with content_processor (no recompile for an existing kind), and verify the route serves — honoring the build-time/runtime boundary (adr-001) and the bilingual-parity axiom (validate-content).",

  preconditions = [
    "site/content/ exists",
    "content_processor is on PATH",
    "the target content-kind is listed in site/content/content-kinds.toml (runtime registry — add it if missing, no recompile)",
    "the target kind already has a <Handler> route in config/routes (build-time, adr-001 — a NEW route needs `cargo build`; reusing an existing routed kind like projects does not)",
  ],

  steps = [
    {
      id     = "classify-target",
      action = "Confirm content_processor recognises the kind. Discovery is RUNTIME from site/content/content-kinds.toml — NOT compiled in. Oracle: run content_processor on the kind; 'Processing <kind>' means it is enabled. If it is a silent no-op, the kind is missing from content-kinds.toml — add a [[content_kinds]] entry (name=<kind>, enabled=true). This is a TOML edit, NO recompile. Only check the route separately: the kind needs a <Handler> route in config/routes, which is build-time (reusing an already-routed kind like projects avoids any build).",
      cmd    = "content_processor --content-type \"$KIND\" 2>&1 | grep -qi \"processing $KIND\" && echo \"kind enabled (runtime)\" || echo \"kind missing from content-kinds.toml — add a [[content_kinds]] entry (no recompile)\"",
      actor  = 'Both,
      on_error = { strategy = 'Continue },
    },
    {
      id     = "place-content",
      action = "Write the markdown at the kind's layout: index-style kinds (e.g. projects) use content/<kind>/<lang>/<slug>/index.md and serve at /<kind>/<slug>; category-style kinds (e.g. blog) use content/<kind>/<lang>/<category>/<slug>.md. Author BOTH languages (en and es) — the bilingual-parity axiom makes a route present in one language only a hard error. Frontmatter must carry at least id, title, slug, subtitle, excerpt, author, date, published, category, tags.",
      actor  = 'Agent,
      depends_on = [{ step = "classify-target" }],
      on_error = { strategy = 'Stop },
    },
    {
      id     = "enforce-bilingual-parity",
      action = "Run the validate-content mode as a sub-check: EN/ES route symmetry, content-file count parity, FTL key parity. Any route present in one language but not the other is a blocking error against the bilingual-parity gate; resolve before reindexing.",
      actor  = 'Both,
      depends_on = [{ step = "place-content" }],
      on_error = { strategy = 'Stop },
    },
    {
      action = "Regenerate the runtime content index with content_processor (writes site/r/<kind>/<lang>/ + filter-index.json + category indexes). With the kind enabled in content-kinds.toml this is the SINGLE activation command — no recompile. Then ensure the server's serving path is current: if the site serves from public/r, sync site/r → site/public/r (just sync) so the new index is visible.",
      id     = "reindex",
      cmd    = "content_processor --content-type $KIND",
      actor  = 'Both,
      depends_on = [{ step = "enforce-bilingual-parity" }],
      on_error = { strategy = 'Stop },
    },
    {
      id     = "verify-oracle",
      action = "Start the server (run.sh / rustelo-htmx-server) and GET each published route in both languages — /<kind>/<slug> and its localized path — asserting the page renders the authored title/body, not a 404 or the index fallback. This observed render is the oracle; publication is not done until it passes.",
      cmd    = "for u in \"/$KIND/$SLUG\" \"/$KIND_ES/$SLUG\"; do printf '%s -> ' \"$u\"; curl -sfI \"http://localhost:3000$u\" >/dev/null && echo ok || echo FAIL; done",
      actor  = 'Both,
      depends_on = [{ step = "reindex" }],
      on_error = { strategy = 'Continue },
    },
    {
      id     = "review",
      action = "Human confirms the rendered pages match intent in both languages. Only then is the content published. A failing oracle is a blocker, never bridged by assumption.",
      actor  = 'Human,
      depends_on = [{ step = "verify-oracle" }],
      on_error = { strategy = 'Stop },
    },
  ],

  postconditions = [
    "Content exists at the kind's layout in BOTH languages (bilingual-parity satisfied)",
    "The kind is enabled in content-kinds.toml (runtime registry) — a new TYPE costs a TOML edit, never a recompile",
    "content_processor index (site/r/<kind>) regenerated and synced to the server's serving path (public/r if used)",
    "Each published route returns the authored page in both languages (oracle passed)",
    "Only a NEW ROUTE is flagged as build-time (cargo build); enabling a content-type is never silently treated as needing a rebuild",
  ],
}