Innsigle Reference Project Concerns

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

Generated from HELIX docs. Source: docs/helix/01-frame/concerns.md. Edit the source, not this file or site/ 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

ConcernSourceAreasWhy ActiveKey Practices
scope-disciplinelibraryarea:brand, area:cli, area:web, area:cryptoBrand-first product; easy to gold-plate into C2PA, detectors, or full IdPShip mark + colophon + optional sign/verify first; park industrial provenance and multi-tenant identity unless an FR demands them
claim-not-oracleproject-localarea:brand, area:web, area:cli, area:docsCategory integrity: not an AI detectorCopy, UI, and verify results never imply detection scores; always attribute claims to a principal when signed
visual-seal-systemproject-localarea:brand, area:webRecognition is mark-firstOne seal family for human / AI / mixed composition; readable colophon layout; no purity/shame color coding
key-custodyproject-localarea:cli, area:cryptoDKIM-like signing needs safe keys without enterprise IdP in v1Local key generation; never log private keys; clear compromise guidance; public key discovery via URL or well-known path
security-owasplibraryarea:web, area:cli, area:cryptoVerify pages and tooling handle untrusted input and keysInput validation on claims; safe URL handling; no secret leakage in errors
typescript-bunlibrary (shipped-default)area:cli, area:webLanguage/runtime slot for toolingPrefer TypeScript + Bun for CLI and any app code unless an ADR overrides
testinglibraryarea:cli, area:web, area:cryptoAssertions and verify paths must be falsifiableUnit tests for hash/sign/verify; fixture colophons; golden claim payloads
verificationlibraryarea:cli, area:webClaims-vs-reality for product integrityNo phantom “we verify AI content” claims; demos exercise real sign→verify
product-microsite-ialibraryarea:web, area:brandBrand site for evaluate/start/operate readers; generated reference from HELIX docsCurated 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-aalibraryarea:web, area:brandSeal and verify UI must be readable beyond colorText labels for composition states; contrast; keyboard access on verify views

Slot resolutions

SlotFillerSource
language-runtimetypescript-bun intended; v0 CLI is Node ESM (.mjs) until Bun is available in CIassumption / interim
frontend-frameworkdeferred / static-firstassumption — brand site may be static or light framework; lock in ADR when site builds
e2e-frameworke2e-playwrightshipped-default — e2e/*.spec.ts against static microsite
auth-providernone in v1assumption — no multi-tenant accounts; keys + public discovery only
datastorenone required in v1assumption — claims travel with content or sidecar; no central claim DB required for P0
deploy-targetstatic host + npm/CLI distributeassumption — lock when packaging
architecture-stylemodular library + CLI + assetsassumption — not a multi-service backend

Project Overrides

ConcernPracticeOverrideAuthority
auth / multi-tenancyDefault HELIX account productsNot selected for v1Vision + PRD non-goals
frontend-frameworkreact-nextjs defaultStatic generated microsite (no SPA framework)ADR-002
product-microsite-iaGenerated reference from methodology sourcesCurated Why/Use outside docs/helix/; generated Reference from HELIX treeADR-002 · docs/website/ia.yml

Area Labels

  • area:brand — seal mark, visual system, wordmark, placement guidelines
  • area:web — brand site, verify view, embed snippets
  • area:cli — assert, sign, verify commands
  • area:crypto — hashing, keys, signatures, discovery
  • area:docs — human docs, “what this is not”
  • area:testing — fixtures, crypto tests, visual regression later

Concern Conflicts

ConflictResolution
visual-seal-system vs claim-not-oracleMark 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 useUnsigned seals require no keys; signing is a second step
scope-discipline vs future C2PA interopDocument 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"
    }
  ]
}