Generated from HELIX docs. Source:docs/helix/01-frame/concerns.md. Edit the source, not this file orsite/HTML.
Source frontmatter
ddx:
id: innsigle.concerns
type: concerns
links:
- target: innsigle.product-vision
kind: informed_by
- target: innsigle.prd
kind: informed_by
status: draft
activity: 01-frame
created: 2026-07-22
Project Concerns
Project Concerns declare active cross-cutting context for Innsigle. They are not principles, requirements, ADRs, test plans, or implementation tasks.
Active Concerns
| Concern | Source | Areas | Why Active | Key Practices |
|---|---|---|---|---|
scope-discipline | library | area:brand, area:cli, area:web, area:crypto | Brand-first product; easy to gold-plate into C2PA, detectors, or full IdP | Ship mark + colophon + optional sign/verify first; park industrial provenance and multi-tenant identity unless an FR demands them |
claim-not-oracle | project-local | area:brand, area:web, area:cli, area:docs | Category integrity: not an AI detector | Copy, UI, and verify results never imply detection scores; always attribute claims to a principal when signed |
visual-seal-system | project-local | area:brand, area:web | Recognition is mark-first | One seal family for human / AI / mixed composition; readable colophon layout; no purity/shame color coding |
key-custody | project-local | area:cli, area:crypto | DKIM-like signing needs safe keys without enterprise IdP in v1 | Local key generation; never log private keys; clear compromise guidance; public key discovery via URL or well-known path |
security-owasp | library | area:web, area:cli, area:crypto | Verify pages and tooling handle untrusted input and keys | Input validation on claims; safe URL handling; no secret leakage in errors |
typescript-bun | library (shipped-default) | area:cli, area:web | Language/runtime slot for tooling | Prefer TypeScript + Bun for CLI and any app code unless an ADR overrides |
testing | library | area:cli, area:web, area:crypto | Assertions and verify paths must be falsifiable | Unit tests for hash/sign/verify; fixture colophons; golden claim payloads |
verification | library | area:cli, area:web | Claims-vs-reality for product integrity | No phantom “we verify AI content” claims; demos exercise real sign→verify |
product-microsite-ia | library | area:web, area:brand | Brand site for evaluate/start/operate readers; generated reference from HELIX docs | Curated copy in docs/website/content/curated/; generate artifacts/glossary from docs/helix/ via npm run site:build; nav by reader mode (ADR-002); site/ is build output only |
a11y-wcag-aa | library | area:web, area:brand | Seal and verify UI must be readable beyond color | Text labels for composition states; contrast; keyboard access on verify views |
Slot resolutions
| Slot | Filler | Source |
|---|---|---|
language-runtime | typescript-bun intended; v0 CLI is Node ESM (.mjs) until Bun is available in CI | assumption / interim |
frontend-framework | deferred / static-first | assumption — brand site may be static or light framework; lock in ADR when site builds |
e2e-framework | e2e-playwright | shipped-default — e2e/*.spec.ts against static microsite |
auth-provider | none in v1 | assumption — no multi-tenant accounts; keys + public discovery only |
datastore | none required in v1 | assumption — claims travel with content or sidecar; no central claim DB required for P0 |
deploy-target | static host + npm/CLI distribute | assumption — lock when packaging |
architecture-style | modular library + CLI + assets | assumption — not a multi-service backend |
Project Overrides
| Concern | Practice | Override | Authority |
|---|---|---|---|
auth / multi-tenancy | Default HELIX account products | Not selected for v1 | Vision + PRD non-goals |
frontend-framework | react-nextjs default | Static generated microsite (no SPA framework) | ADR-002 |
product-microsite-ia | Generated reference from methodology sources | Curated Why/Use outside docs/helix/; generated Reference from HELIX tree | ADR-002 · docs/website/ia.yml |
Area Labels
area:brand— seal mark, visual system, wordmark, placement guidelinesarea:web— brand site, verify view, embed snippetsarea:cli— assert, sign, verify commandsarea:crypto— hashing, keys, signatures, discoveryarea:docs— human docs, “what this is not”area:testing— fixtures, crypto tests, visual regression later
Concern Conflicts
| Conflict | Resolution |
|---|---|
visual-seal-system vs claim-not-oracle | Mark may look authoritative as a maker’s stamp, not as a platform truth badge—no green check “authentic content” tropes |
key-custody vs low-friction mark use | Unsigned seals require no keys; signing is a second step |
scope-discipline vs future C2PA interop | Document as parking-lot / P2; do not shape v1 APIs solely for C2PA |
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/concerns.md- Signed
- 2026-09-30T20:48:46Z
- Content digest
sha256:a40d2dad…30285c57
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/concerns/",
"digest": {
"alg": "sha256",
"value": "a40d2dad86983a11b62bceb090cef6ab1867c1462ea134391601a29b30285c57"
}
}
],
"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": "WwEpnZRapAgrOi2RJCptg0lmjqaN-WJXkfiyD-8-EgpEa4PAgS2z9djkixbg9S7pEo2sRwUrUMJA9BiuAbeSCw",
"signed_at": "2026-09-30T20:48:46Z"
}
]
}