Concourse microsite integration
Example from HELIX’s own docs. This generated page comes from
docs/helix/. Use it to see the method in practice; start with the artifact-type catalog for reusable templates. Historical plans and reports may describe retired architecture.
Concourse microsite integration
Owner-authorized 2026-10-29. Shared behavior belongs to Concourse CONTRACT-001;
HELIX owns opt-in build wiring. documentor.concourse.install consumes a locally
checked-out, immutable Concourse revision, verifies every distribution digest,
then copies its browser assets and Hugo partial. publish.site.concourse selects
the site/API/package and enables the component. The default GitHub Pages build
keeps it disabled; the authenticated Cloudflare copy enables it at build time.
The base template calls the generic partial after content. The partial identifies resource by Hugo source path and revision by RawContent digest; runtime UI sits next to authored heading IDs. No private comment data enters the build. Documentor owns installation and site.py owns orchestration; the browser/server protocol and implementation remain outside HELIX. Concourse has no import of documentor.
Verification: Python installer tests cover disabled/no config, valid copies, bad digest and non-origin API rejection; a real Hugo build and browser journey must show marker/base-path integration, signed-out login and section persistence. Production provider/session/cloud acceptance is a separate deployment gate.
Rollback: disable Concourse and rebuild; immutable source/attestations remain unchanged. Infrastructure rollback must preserve D1 discussion data.
Innsigle seal: model-primary by HELIX
The signature covers the markdown source of this page, not these HTML bytes. This page quotes that seal; verify it against the source file.
- Composition
- model-primary
- Issuer
- HELIX
helix - Signing key
ed25519:b0865d76d834a52c48506414d16f4e5a(build key)- Signed source
artifacts/concourse-integration.md- Signed
- 2026-11-16T15:52:45Z
- Content digest
sha256:26409f89…e2437c8f
This build key is endorsed by the human key for build signing; the signature is not a detector and not a truth guarantee.
Raw attestation JSON
{
"payload": {
"innsigle": "1",
"type": "https://innsigle.dev/claim/colophon/v1",
"issued_at": "2026-11-16T15:52:45Z",
"issuer": {
"id": "helix",
"name": "HELIX",
"key_id": "ed25519:b0865d76d834a52c48506414d16f4e5a",
"key_url": "https://documentdrivendx.github.io/helix/.well-known/innsigle/keys.json"
},
"subjects": [
{
"uri": "https://documentdrivendx.github.io/helix/artifacts/concourse-integration/",
"digest": {
"alg": "sha256",
"value": "26409f8996637d107b961cc7c00168f014eea421c79adebb22dd6e22e2437c8f"
}
}
],
"colophon": {
"schema_version": "1",
"composition": "model-primary",
"ingredients": [
{
"kind": "model",
"name": "Claude",
"role": "draft"
},
{
"kind": "tool",
"name": "sloptimizer",
"role": "rewrite"
},
{
"kind": "human",
"name": "operator",
"role": "structure-edit"
}
],
"notes": null
}
},
"payload_encoding": "json",
"signatures": [
{
"key_id": "ed25519:b0865d76d834a52c48506414d16f4e5a",
"alg": "ed25519",
"sig": "UWKxS7KyhcCtAArsIIVn0Y_gjcI3ufLGvqlfuY9q7yoYOyarUkZe-dGk12cLqUZIiIMtaYhqPwdFdD-lh8pDCQ",
"signed_at": "2026-11-16T15:52:45Z"
}
]
}