Skip to content

docs: add comprehensive v4.0.0 changelog#763

Open
jthrilly wants to merge 3 commits into
nextfrom
claude/create-v4-changelog-hYBuG
Open

docs: add comprehensive v4.0.0 changelog#763
jthrilly wants to merge 3 commits into
nextfrom
claude/create-v4-changelog-hYBuG

Conversation

@jthrilly
Copy link
Copy Markdown
Member

Summary

Add a comprehensive CHANGELOG.md documenting the Fresco v4.0.0 release, a major architectural overhaul spanning authentication, storage, interview engine extraction, dashboard redesign, and significant stack upgrades.

Changes

  • New file: CHANGELOG.md with 281 lines of detailed release notes covering:
    • Architecture: Interview engine extracted to @codaco/interview npm package, UI primitives to @codaco/fresco-ui, network exporters to @codaco/network-exporters
    • Authentication: Passkey (WebAuthn) support, TOTP 2FA, recovery codes, brute-force protection via login-attempt logging, optional passwords
    • Storage: Pluggable storage layer with S3/MinIO support alongside UploadThing, presigned URLs, streaming export pipeline
    • Database: Schema relocated to lib/db/schema.prisma, protocol schema v7→v8 migration, new models for auth and API tokens
    • API: Versioned /api/v1/ endpoints for protocol metadata, interview data, and exports, gated by API tokens
    • Dashboard: Rebuilt with activity feed, new DataTable component with metadata-driven filters and URL-persisted state, settings hub reorganization
    • Stack: Next.js 14→16, React 18→19, TypeScript 5→6, Zod 3→4, Tailwind 4.1→4.3, Prisma 7.1→7.8, Redux removed in favor of Zustand + nuqs
    • Removed features: Preview Mode, in-repo interview runtime, in-repo UI primitives, in-repo network exporters
    • Migration notes: Database backup, schema relocation, protocol v8 upgrade, auth re-enrollment, storage configuration, dev environment setup

Implementation Details

The changelog is structured with:

  • Highlights section summarizing the three pillars (modular interview engine, modern security, pluggable storage)
  • Detailed subsections for each major area (auth, storage, database, API, dashboard, etc.)
  • Comprehensive stack upgrade table showing before/after versions
  • Explicit lists of new and removed dependencies
  • Step-by-step migration guidance for existing deployments
  • Protocol schema v7→v8 transformation details with concrete examples

https://claude.ai/code/session_01WuLtx7TNaZNvi2T5GkbFRs

claude added 3 commits May 20, 2026 14:05
Adds CHANGELOG.md with a comprehensive v4 entry covering the interview
engine extraction, passkey/TOTP authentication, S3 storage layer,
streaming export pipeline, programmatic API, dashboard rebuild, and the
Next.js 16 / React 19 / TypeScript 6 stack upgrades.
…anges

Adds detail on each settings section, the sign-in / first-run setup flow,
per-page dashboard table improvements, the long tail of small fixes
(combobox state, categorical bin, confirm-password toggle, datepicker
validation, etc.), and the new Zod schemas under schemas/.
Adds a dedicated "Protocol schema v8" subsection describing the v7→v8
transformations observable from Fresco's migration code and tests:
new top-level experiments JSON, node iconVariant→icon rename, node
shape object, Toggle option stripping, alter-filter restructuring,
and hash recomputation. Notes that the authoritative grammar lives in
@codaco/protocol-validation.
Copilot AI review requested due to automatic review settings May 20, 2026 20:25
@coderabbitai
Copy link
Copy Markdown

coderabbitai Bot commented May 20, 2026

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: ee8ec648-c675-454a-9e8a-0c50d113741f

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch claude/create-v4-changelog-hYBuG

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds a new CHANGELOG.md documenting the upcoming Fresco v4.0.0 release, summarizing the major architectural changes (extracted interview engine/UI/exporters), the redesigned auth + storage subsystems, and the accompanying stack/tooling upgrades.

Changes:

  • Introduces a comprehensive v4.0.0 changelog entry with detailed highlights and migration notes.
  • Documents major feature areas (auth, storage, API, dashboard, export pipeline) and notable removals.
  • Includes a stack-upgrade table and dependency add/remove lists.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread CHANGELOG.md
Comment on lines +244 to +258
| Package | v3 | v4 |
| --- | --- | --- |
| Next.js | 14.2.x | 16.2.6 |
| React / React DOM | 18.3.1 | 19.2.6 |
| TypeScript | 5.x | 6.0.3 |
| Tailwind CSS | 4.1.x | 4.3.0 |
| Prisma (client + adapters) | 7.1 | 7.8 |
| Zod | 3.25 | 4.4 |
| `react-hook-form` | 7.x | replaced by `@codaco/fresco-ui` form layer |
| `react-markdown` | 9 | 10 |
| `react-dropzone` | 14 | 15 |
| `lucide-react` | 0.554 | 1.16 |
| `nuqs` | 1 | 2 |
| pnpm | 10.24 | 11.1.2 (sha-pinned) |

Comment thread CHANGELOG.md

New runtime dependencies of note: `effect`, `superjson`, `zustand`, `immer`, `@base-ui/react`, `@codaco/fresco-ui`, `@codaco/interview`, `@codaco/network-exporters`, `@codaco/protocol-validation@^11.5.0`, `@codaco/tailwind-config`, `@codaco/shared-consts@5.0.0`, `@faker-js/faker`, `@posthog/nextjs-config`, `posthog-js`, `posthog-node`, `qrcode`, `otpauth`, `@simplewebauthn/{browser,server}`, all three `@aws-sdk/*` clients.

Removed: `animejs`, `archiver`, `class-variance-authority`, `classnames`, `cmdk`, `color`, `concaveman`, `csvtojson`, `d3`, `dotenv` (dev only), `fuse.js`, `jssha`, `lucia`, `@lucia-auth/adapter-prisma`, all 13 individual `@radix-ui/*` packages (consolidated into `@base-ui/react`), `@reduxjs/toolkit`, `react-redux`, `react-compound-slider`, `react-flip-toolkit`, `react-resize-aware`, `react-transition-group`, `react-virtualized-auto-sizer`, `react-window`, `recompose`, `redux-form`, `redux-logger`, `redux-thunk`, `rehype-raw`, `rehype-sanitize`, `remark`, `remark-gemoji`, `reselect`, `sanitize-filename`, `scrollparent`, `strip-markdown`, `tailwind-merge`, `@tailwindcss/aspect-ratio`, `@tailwindcss/container-queries`, `@tailwindcss/typography`, `@uploadthing/react`, `@xmldom/xmldom`, `uuid`, `validator`, `zod-form-data`. Plus several smaller leaf utilities.
Comment thread CHANGELOG.md

All notable changes to Fresco are documented in this file.

## [4.0.0] — Unreleased
@github-actions
Copy link
Copy Markdown

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants