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: aibadge.concerns
  type: concerns
  links:
    - target: aibadge.product-vision
      kind: informed_by
    - target: aibadge.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