Walkthrough: seal a docs page
You have a static HTML page (often model-drafted). You want a model-primary colophon, a footer seal, and a claim someone can verify from local copies of the page, attestation, and keys.
Prerequisites
- Node 20+
- Innsigle CLI installed (CLI):
npm install github:DocumentDrivenDX/innsigle then npx innsigle, or clone and npm install -g . / node src/cli.mjs
Commands below use innsigle. From a clone without install, substitute node src/cli.mjs.
Steps
1. Draft and edit
Produce the page content (often a model draft). Optionally run sloptimizer on prose. Do not change composition to human-authored because of that rewrite.
2. Write the colophon
innsigle colo example --kind model-primary > colo.json
# edit ingredients: name Claude, sloptimizer, human roles
3. Generate issuer keys (once)
innsigle keygen --out-dir ./keys
innsigle keys template \
--issuer-id my-house --issuer-name "My House" \
--public-key "$(cat keys/ed25519.pub.raw.b64url)" \
--key-id "$(cat keys/key-id.txt)" \
--out keys.json
Publish keys.json over HTTPS (or ship beside content for local demos). See Issuer.
4. Build claim and sign
innsigle claim build \
--content ./page.html \
--uri https://example.com/page/ \
--colo colo.json \
--issuer-id my-house --issuer-name "My House" \
--key-id "$(cat keys/key-id.txt)" \
--key-url https://example.com/.well-known/innsigle/keys.json \
--out claim.json
innsigle sign \
--claim claim.json \
--key keys/ed25519.priv.pem \
--out claim.attestation.json
Keep the private key offline (not in the site tree). --key-url must be absolute https://….
5. Place the seal
Footer (see docs/sample/snippets/footer.html): glyph + link to the attestation or a colophon page. Use the A mark for model-primary (Marks).
6. Verify
innsigle verify \
--attestation claim.attestation.json \
--content ./page.html \
--keys keys.json
# expect VALID
Mutate the HTML and re-run: expect content mismatch (exit 3).
Check it (this site)
What we claim: the published sample is already sealed this way.
Live: Sample · curl recipe on CLI. Expect: VALID.
Proof in this repo
- Sample page + attestation under
docs/sample/ - Vectors:
tests/vectors/on GitHub
Spec
Feature note: signed docs claims
Innsigle seal: mixed by Innsigle (human key)
Signature covers the markdown source of this page, not these HTML bytes. This render quotes that seal.
- Composition
- mixed
- Issuer
- Innsigle
innsigle - Signing key
ed25519:15c6242b6ef825413847e221267959c9(human key)- Signed source
docs/website/content/curated/use/walkthrough-docs.md- Signed
- 2026-09-30T20:46:37Z
- Content digest
sha256:4ec0d18b…f52fe54a
Human-controlled key. 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-09-30T20:46:37Z",
"issuer": {
"id": "innsigle",
"name": "Innsigle",
"key_id": "ed25519:15c6242b6ef825413847e221267959c9",
"key_url": "https://documentdrivendx.github.io/innsigle/.well-known/innsigle/keys.json"
},
"subjects": [
{
"uri": "https://documentdrivendx.github.io/innsigle/use/walkthrough-docs/",
"digest": {
"alg": "sha256",
"value": "4ec0d18b4e095a32884ea0b287e32d03c3b840fcaff343508a120aa6f52fe54a"
}
}
],
"colophon": {
"schema_version": "1",
"composition": "mixed",
"ingredients": [
{
"kind": "human",
"name": "operator",
"role": "outline"
},
{
"kind": "model",
"name": "Claude",
"role": "expand"
},
{
"kind": "human",
"name": "operator",
"role": "final-edit"
}
],
"notes": null
}
},
"payload_encoding": "json",
"signatures": [
{
"key_id": "ed25519:15c6242b6ef825413847e221267959c9",
"alg": "ed25519",
"sig": "SWXrNmgapujAPmfX1ikjXhYzoBI6dZuBh5xJWX04UX-2R6RQ40-x_TTX1zQf4_RE1g_hE6rTZ1Z14a7K81oJCg",
"signed_at": "2026-09-30T20:46:37Z"
}
]
}