Innsigle Reference Session provenance — convergence (Claude + Codex adversarial review)

Generated reference: edit sources under docs/helix/, then npm run site:build.

Generated from HELIX docs. Source: docs/helix/02-design/session-provenance-CONVERGENCE.md. Edit the source, not this file or site/ HTML.
Source frontmatter
ddx:
  id: innsigle.design.session-provenance-convergence
  type: design-note
  links:
    - target: innsigle.design.session-provenance
      kind: refines
    - target: innsigle.feat.004
      kind: informs
status: accepted
activity: 02-design
created: 2026-07-24

Session provenance — convergence (Claude + Codex adversarial review)

Round 1 verdict: BLOCK (both harnesses). Round 2 verdict: Codex APPROVE on P1 fixture path; Claude deferred to live test (suite already green). Resolution: Fix load-bearing contracts below; implement P1 fixture path; live multi-agent capture via test driver with recorded journals.

Blocking fixes accepted

IssueResolution
Journal underspecifiedVersioned JSONL schema session-journal-event.schema.json with session_id, event_id, sequence, actor, model, file_write.by
Composition non-deterministicTotal function in propose-colo (see algorithm)
FR-4a unenforceablePropose refuses human-authored if any file_write.by=model unless --force-composition + notes
L2 digest vs file bytesDigest = SHA-256 of exact L2 file bytes as written (CONTRACT-001 aligned). No JCS for L2 file binding.
colophon.provenance unschematizedAdd optional provenance to colophon schema
Skills kindMap skills → kind: "tool" until enum extended
Clock nondeterminism--generated-at required for golden tests (or default now; goldens pass fixed value)
Multi-agent driverScripted human inputs → per-agent journal segments (live or mock) → merge → build → propose-colo
Review gatepropose-colo does not sign; sign remains separate CLI step (human/explicit)

Composition algorithm (total)

Input: L2 document (and optional --prior-composition).

if any artifact role=primary-output has write.by=model (from build) OR models[] non-empty
   AND humans have prompt_count > 0:
    if only model wrote primary bytes (no human file_write on primary): model-primary
    else: mixed
else if models[] empty AND no file_write.by=model:
    human-authored
else:
    model-primary   # conservative default

Never propose human-authored if any file_write with by=model exists unless forced.

P1 implementable path

journal.jsonl → provenance build → L2.json
L2.json → provenance propose-colo → colo.json

Test driver: human-inputs sequence × agents {claude,codex} → journals → merge → build → colo.

Harness findings (archive)

  • .tmp-review/findings-claude.md
  • .tmp-review/findings-codex.md
Innsigle seal: model-primary by Innsigle (build key)

Signature covers the markdown source of this page, not these HTML bytes. This render quotes that seal.

Composition
model-primary
Issuer
Innsigle innsigle
Signing key
ed25519:050bf4d0361a96aa3b6baa3fc2ffd0cb (build key)
Signed source
docs/website/content/generated/artifacts/session-provenance-convergence.md
Signed
2026-09-30T20:48:46Z
Content digest
sha256:9564e8ec…4eb89295

Endorsed by the human key for seal recognition (ADR-003).

Raw attestation JSON
{
  "payload": {
    "innsigle": "1",
    "type": "https://innsigle.dev/claim/colophon/v1",
    "issued_at": "2026-09-30T20:48:46Z",
    "issuer": {
      "id": "innsigle",
      "name": "Innsigle",
      "key_id": "ed25519:050bf4d0361a96aa3b6baa3fc2ffd0cb",
      "key_url": "https://documentdrivendx.github.io/innsigle/.well-known/innsigle/keys.json"
    },
    "subjects": [
      {
        "uri": "https://documentdrivendx.github.io/innsigle/reference/artifacts/session-provenance-convergence/",
        "digest": {
          "alg": "sha256",
          "value": "9564e8ecfe209088ae3b47aa33c1bd5ea68c3ded84332002ddde2a884eb89295"
        }
      }
    ],
    "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:050bf4d0361a96aa3b6baa3fc2ffd0cb",
      "alg": "ed25519",
      "sig": "qljCECJa1D9-K_S9gfBxxppVebAMTcNnXcmaWZcac-8V39z16kOL5PvWIyh6dteWTDzjHfx-LEZdZlVVyDe_AQ",
      "signed_at": "2026-09-30T20:48:46Z"
    }
  ]
}