This repository was archived by the owner on Aug 7, 2026. It is now read-only.
Repository navigation
Tags
Tags
chore(release): v2.6.1 — dashboard, web, and status design renovation Redesigned apps/dashboard, apps/web, and apps/status under a shared design system: cut the dead dashboard right-sidebar, removed card-soup across ~35 boxed single-fact containers, demoted monospace to literal data only, added real data visualization to Analytics, and fixed a Astro CSS-scoping bug that broke shared styles on several web pages. No API/SDK/CLI changes, no breaking changes. Full process documented in design-renovation/01-audit.md through 05b-quality-report.md.
feat(sdk): v2.6.0 — Go, Rust, Java, PHP SDKs + full 6-SDK audit
Add four thin-REST SDKs (no client crypto), each distributed as a static
registry off cdn.certivu.ai (private monorepo — no public repos):
- Go → static GOPROXY (packages/sdk-go, cdn.certivu.ai/sdk/go)
- Rust → Cargo sparse reg (packages/sdk-rust, sparse+.../sdk/rust)
- Java → Maven repo (packages/sdk-java, ai.certivu:certivu)
- PHP → Composer repo (packages/sdk-php, certivu/sdk)
Each versions on its own line from 1.0.0, content-addressed. Packagers
infra/scripts/package-{go,rust,java,php}-sdk.ts fold into package-cdn.ts
(package-integrations.ts renamed).
Audit + parity fixes across all 6 SDKs:
- TokenStatus shape corrected everywhere (was record_id/org_id; real
shape {valid,confidence,org,...}) — Python/Rust had crashed
- API now emits X-Certivu-Deduplicated so SignResult.deduplicated is real
- Python: AuditEvent.type gains key_rotated; sign field image→content
- JS: typed CertivuError (status/upgradeUrl/isQuota/isAuth) + signBatch
+ configurable timeoutMs (60s) + exported public types
- PHP: ApiException $code→$errorCode (readonly $code fatals shadowing
Exception::$code)
Webhook routes (/v1/webhooks*) now accept API keys (requireSession→
requireAuth) so SDK webhook CRUD works programmatically. Fix undefined
BearerSession security scheme on analytics ops → apiKey.
Bump apps/api, @certivu/sdk, certivu (py) to 2.6.0. Docs: guides/{go,rust,
java,php}-sdk, whats-new, sdk-usage, webhooks. Remove stale infra scripts.
chore(release): v2.5.1 — reliability & hardening
Focused remediation of the v2.4.0→v2.5.0 audit (V2_5_AUDIT.md). No breaking
changes; all existing paths behave as before.
- inference service: fail-closed auth + constant-time compare, threadpool
offload of torch inference, streamed body size guard, decode-bomb + audio
duration caps, model-load lock
- neural watermark: image re-encode degrades gracefully; dedup-integrity guard
so a re-signed asset can't be reported tampered during an inference outage;
fingerprint computed on delivered bytes; timeout NaN guard; URL boot-validation
- in-band video: up-front size/duration/frame caps, -frames:v decode cap,
per-frame neural wall-clock budget, SIGKILL escalation on timeout, AAC audio
for MP4 output
- post-quantum C2PA: hard-binding two-pass iterates to a fixed point (fixes
CBOR integer-width boundary under-coverage); tightened APP11 strip bounds;
Buffer-view response
- verify: neural-audio collision declines instead of misattributing; batch
verify concurrency-capped (6) + per-item rate-limit cost
- worker pool: crash-requeue of in-flight tasks + bounded-queue backpressure
- sign route: C2PA embed gated Growth+, bodyLimit, revoked-generator guard
- plan: unset-subscription_status quota carve-out restricted to non-Stripe orgs
Docs/OpenAPI/POST_MVP/CLAUDE updated. apps/api version → 2.5.1.
feat(release): v2.5.0 — Real-World Resilience (neural watermarking + …
…post-quantum C2PA)
Make provenance survive social-media round-trips and re-encodes, and write real
ML-DSA-signed C2PA. Additive and backward-compatible — every existing path (DCT
watermark, ZWC, pHash, acoustic fingerprint, metadata token, ML-DSA signature) is
unchanged; these are new resilience layers, all opt-in.
Neural watermarking
- New inference service (apps/inference: FastAPI + torch, TrustMark + WavMark)
reached via a graceful-degrade adapter (apps/api/src/lib/inference.ts). Opt-in
via INFERENCE_URL / NEURAL_AUDIO_ENABLED / NEURAL_VIDEO_ENABLED; deploy with
infra/fly/fly.inference.toml.
- Marks carry opaque lookup codes (packages/crypto/src/neural.ts; neural_image_code
64-bit, neural_audio_code 16-bit, sparse-indexed, format-scoped). Signature stays
the source of truth.
- Image (TrustMark): embedded after DCT, before hash; verify decodes before pHash.
- Audio (WavMark): WAV-only, opt-in (16 kHz mono, lossy).
- Verify gained signals.neural_watermark_found + token_source "neural_watermark";
a neural match returns high confidence.
In-band video (opt-in)
- Audio-track WavMark (remux, video copied) + keyframe TrustMark (re-encode, marks
every frame so verify reliably lands on one). ffmpeg helpers in packages/crypto/
src/ffmpeg.ts (watermarkVideoFrames / extractSampledFrames / extractAudioAsWav /
remuxVideoAudio), bounded by VIDEO_MAX_FRAMES. Reuses format-scoped neural codes.
Post-quantum C2PA
- Pure-TS CBOR/COSE/JUMBF writer (packages/crypto/{cbor,cose,c2paWrite}.ts) builds
a real ML-DSA COSE_Sign1 (alg -49) + hard-bound manifest embedded into JPEG
(APP11) and PNG (caBX) via POST /v1/records/:id/c2pa/embed. Interoperable C2PA
structure; standard verifiers report the algorithm as unrecognized (the moat).
- Richer third-party C2PA read (manifest_count / signature_issuer / is_certivu).
- mlDsa.ts gained signBytes / verifyBytes (raw-byte signing for COSE).
Fixes
- c2pa-node native binary was never fetched under Bun -> added to root
trustedDependencies, so C2PA read works in dev and the Docker image (it had been
a silent no-op in prod).
- Corrected image-pHash verify signals (was reporting fingerprint_match instead of
phash_match).
Surfaces: OpenAPI, JS + Python SDKs (embedC2pa / embed_c2pa, C2paSignals), CLI
(certivu c2pa), docs, web Features, version bumps to 2.5.0.
Deferred: verify-side self-display of our own ML-DSA C2PA (standard readers can't
validate the unknown alg), PDF/MP4 C2PA write, neural density/robustness tuning
against deployed models.
chore(release): v2.4.1 — security & reliability audit remediation Full-codebase audit remediation across 4 severity passes (see AUDIT_REPORT.md). No breaking changes. Critical/High: admin-inbox stored XSS (sandboxed iframe); recursive canonicalJson; admin->owner API-key priv-esc guard; webhook SSRF (DNS-resolving guard + redirect:manual); key_rotated audit enum; GDPR delete complete + transactional; cron digest leader-lock; removed broken Dilithium3 module from Python SDK. Medium/Low + follow-ups: email-verify gate on requireAuth; auth throttle; validateEnv; revocation cache-race tombstone; quota allowlist; session revocation on member removal/role change; Stripe webhook idempotency + overage restore; checkout/portal RBAC; marketing filter fixes; mongoose pooling; dashboard 401 handling; web open-redirect; SDK/badge type drift; HS256 pinning; constant-time login; Sentry-backed error reporting; image decode-once; orphan cleanup; admin JWT jti; one-click unsubscribe (RFC 8058); standardized error envelope; server-sign input dedup; ML-DSA + audio-FFT worker offload; SDK timeout/retry; audit keyset pagination; on-demand extension injection. Versions bumped to 2.4.1 (api, dashboard, cli, types, sdk, badge, python SDK, OpenAPI).
feat(release): v2.4.0 — compliance attestation export + branded certi…
…ficates
Compliance & white-label: the cheapest revenue unlock over existing
provenance data, no new infra or external deps.
EU AI Act compliance attestation (Enterprise):
- GET /v1/attestation (JSON) + GET /v1/attestation/export?format=json|html
- attestation.service.ts aggregates generators, records-by-format,
verification + tamper counts; maps three Article 50 obligations
- Self-contained printable HTML render, zero PDF dependencies
- Enterprise-gated (402 otherwise); default 90-day, max 366-day window
- Framed as a factual record of activity, not a certification/legal opinion
Org-branded verification certificates (Growth+):
- OrgBranding (display_name, logo_url, primary_color, support_url) on Org
- GET/PATCH /v1/account/branding (session auth, owner/admin, BRANDING_PLANS)
- org_name + branding added to public GET /v1/verify/status/:token,
Redis-cached (15m TTL + invalidate-on-write)
- Static public certificate page: certivu.ai/certificate?t=<token>
(client-side fetch, XSS-escaped, noindex)
- Dashboard Settings → Certificate Branding card with live preview
Surfaces updated: OpenAPI spec, JS + Python SDK (getAttestation/
exportAttestation, get_attestation/export_attestation; TokenStatus gained
org_name + branding), CLI (certivu attestation), docs (attestation
reference + guides + whats-new), web Features/Pricing, CLAUDE.md, POST_MVP.
Bug fixes from review:
- branding save rejected blank fields (zod now accepts to clear)
- attestation HTML key list rendered escaped <br> literals
Version bumped to 2.4.0 across api, dashboard, cli, types, sdk, sdk-python.
Stale claim_generator in c2pa.service bumped to Certivu/2.4.0.
feat(adoption): v2.3.0 — web signer, integrations, sandbox, CI verify
Get content signed where it's created and verified where it's consumed,
with no SDK code. Closes v2.3.0 (S3/R2 upload trigger deferred).
- dashboard: /sign no-code web signer (drag-drop → generator → download),
signFile() multipart client, Sign nav item
- packages/badge: <certivu-badge> web component (npm + cdn badge.js),
reads GET /v1/verify/status/:token, themable Shadow DOM, neutral claims
- integrations/comfyui + integrations/a1111: sign images at generation
time via the certivu pip SDK (ComfyUI node + A1111 on_image_saved hook)
- integrations/browser-extension: buildless MV3, right-click verify with
a Shadow-DOM result overlay
- cli: `verify` gains globs + --fail-on-missing for CI (self-contained
glob matcher, skips node_modules/.git); chosen over a GitHub Action
because the monorepo is private
- api: sandbox mode (CERTIVU_ENV) — skips quota, ctv_test_key_ prefix,
GET /version, X-Certivu-Environment header; fly.sandbox.toml +
deploy-sandbox.sh
- api: permissive CORS on public read/verify endpoints (badge/extension)
- apps/status: public status page polling /health
- infra/scripts/package-integrations.ts: builds CDN zips + manifest for
cdn.certivu.ai/integrations (private repo → no public GitHub distribution)
- docs: 7 new guides + sidebar; openapi 2.3.0 (+/version, sandbox server);
web Features/Footer/docs; POST_MVP + CLAUDE updated
- versions: api, dashboard, cli, @certivu/badge → 2.3.0
feat(api,crypto): v2.2.2 — provenance pipeline hardening + key rotation
Remediation of the provenance pipeline audit plus the v2.2.2 release prep.
Pre-launch change set: the watermark format is revised with no legacy-decode
fallback (acceptable — no signed content in production yet).
Watermark (resize-invariant)
- Add embedWatermarkCanonical/extractWatermarkCanonical: both sides normalize
to a fixed 512x512 canonical grid before the 8x8 DCT grid is touched, so the
mark re-aligns after a resize instead of desyncing. Embed maps the canonical
per-pixel delta back to native resolution, preserving original dimensions.
- Tune QIM strength to DEFAULT_STRENGTH=12 (PSNR ~44 dB, imperceptible) for
robustness headroom; chosen from a strength/PSNR sweep.
- Verified via new infra/scripts/watermark-robustness.ts: 100% recovery across
resize / recompression / social round-trips (crop remains pHash-covered).
Fuzzy lookup (LSH-banded pHash)
- Add crypto.phashBands(): split the 64-bit pHash into 9 multikey-indexed band
tokens (9 > Hamming threshold 8 => guaranteed recall, verified 0 misses /20k).
- Replace the linear recent-records scan in findRecordByPhash with an indexed
$in over phash_bands; removes the corpus ceiling and the in-memory sort.
- Populate phash_bands at every write site (image sign, video pHash patch,
client ingest). Add {format,created_at} index for the fingerprint scan.
- backfill-phash-bands.ts migrates pre-existing records; verify-indexes.ts
asserts the new indexes.
Concurrency (worker offload)
- Run watermark embed + pHash in a worker_threads pool (apps/api/src/workers)
off the event loop, with transparent inline fallback (WORKER_POOL_SIZE=0).
Build emits dist/image-worker.js as a second entrypoint.
Key management (rotation)
- Stamp signing-key kid into signed_payload; verify/ingest select the public key
by kid (fallback to first key for legacy). Per-key active/retired status +
active_kid on the generator.
- New POST /v1/generators/:id/rotate-key (server-managed): appends a fresh key,
retires the old public key, discards the old private key; past content stays
verifiable. Adds audit "key_rotated" + webhook "generator.key_rotated".
Caching
- Single-flight coalescing on record/generator/signature-verify caches so a
viral asset verified en masse after a cache flush collapses to one DB read
and one ML-DSA verify per instance.
Release / docs (v2.2.2)
- Bump api, types, dashboard, OpenAPI spec to 2.2.2.
- OpenAPI: rotate-key path, generator.key_rotated/key_rotated enums, active_kid
+ key status on the Generator schema.
- Docs: rotate-key reference; key_rotated added to webhook + audit event tables;
general v2.2.2 changelog entry.
- Web: "Signing Key Rotation" feature + security-page note; 7th webhook event.
- Dashboard: webhook event list includes generator.key_rotated.
- POST_MVP.md + CLAUDE.md build status / endpoints table updated.
Ops
- Run backfill-phash-bands.ts and verify-indexes.ts against Atlas post-deploy.
- Optional new env WORKER_POOL_SIZE. No required new secrets.
BREAKING: image watermarks produced before this release no longer decode via the
watermark layer (token/record verification is unaffected). No migration —
pre-2.2.2 signed content does not exist in production. SDK/CLI/Python unchanged.
feat(crypto): v2.1.0 — provenance durability (HTML ZWC, PDF /Metadata…
…, WAV 24-bit,acoustic fingerprint)
2.1.1: embed ZWC watermark into HTML body text nodes; survives DOMPurify and comment-stripping minifiers
2.1.2: embed token in PDF /Metadata XMP stream via incremental update (ISO 32000);survives GhostScript
2.1.3: extend DCT frame watermark to WAV 24-bit integer PCM (safe 3-byte read/write, ±8388607 clamp)
2.1.4: distribute ZWC payload across every paragraph in plain text; survives intro truncation
2.1.5: acoustic fingerprint fallback for audio — pure-TS Cooley-Tukey FFT, Shazam-style landmark pairs,
WAV 16/24-bit PCM only; fuzzy match threshold 15% overlap, min 5 hashes
fix: fingerprintMatch=true when record found via fingerprint verify path
fix: XML-escape token in all XMP/PDF metadata insertion paths
fix: fingerprint_match present in all VerificationSignals objects
fix: logVerification token_source cast includes fingerprint
chore: bump all package versions to 2.1.0
chore: OpenAPI spec → 2.1.0; fingerprint_match signal + fingerprint record field documented
chore: Python SDK Signals model adds phash_match + fingerprint_match; token_sourceadds fingerprint
docs: whats-new.mdx v2.1.0 entry; verify.mdx fingerprint path + signals; sign.mdx watermark table
PreviousNext