V2 Refactor Temp Directory

Working directory for the Cherry Studio v2 data and UI refactor. Holds shared tools, working notes, and other transient artifacts used during the refactor.

Important: This directory will be removed after the v2 refactor lands.

Layout

v2-refactor-temp/
├── tools/                    # Refactor tooling
│   └── data-classify/        # Data classification and code generation
├── docs/                     # Working notes
│   ├── v2-todo.md            # Cross-cutting global v2-refactor TODO tracker
│   ├── breaking-changes.md   # V2 breaking changes index
│   └── breaking-changes/     # Individual breaking change records
└── README.md                 # This file

Contents

Tools (tools/)

• data-classify/ — Data classification and code generation pipeline
  • Extracts the data inventory from source
  • Manages classification mappings
  • Generates TypeScript types and migration mappings
  • See tools/data-classify/README.md

Docs (docs/)

• v2-todo.md — Cross-cutting global v2-refactor TODO tracker

  • Tracks whole-refactor tasks only: v1 data-stack and UI-library teardown, migrator and schema finalization, removal-slated @deprecated sites, release cleanup
  • Per-module fine-grained TODOs stay in their own docs and are not duplicated here
  • See docs/v2-todo.md

• breaking-changes.md — Index of v2 user-perceivable breaking changes

  • Any removed capability, incompatible data shape, migration downgrade, or user-visible behavior change should add an individual document and update this index
  • See docs/breaking-changes.md

• breaking-changes/ — Log of v2 changes that affect how users use the app

  • PR authors drop an entry alongside their PR; the release manager aggregates and translates these into the Chinese user-facing release note at v2.0.0
  • See docs/breaking-changes/README.md

Usage notes

1. This directory contains no production code — it only supports the refactor
2. Generated code is written to the canonical project locations, not here
3. Do not store anything that needs to be preserved long-term

Cleanup plan

After the v2 refactor lands, remove this directory entirely:

1. Confirm all tooling here is no longer needed
2. Move any documents worth keeping to their canonical locations
3. Delete the v2-refactor-temp/ directory
4. Update .gitignore and any remaining references