feat: migrate to remote Single Source of Truth architecture and release v2.0.0

Author: jaiswalism

WORK_LOG/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## 2026-07-04 (v2.0.0)
+- **Massive Architectural Change**: Shifted Single Source of Truth for synced problems to GitHub via `commitcode.json`. This completely solves the multi-device problem where using a second laptop would reset the README.
+- Automatically migrates existing local databases to the remote repository.
+- Re-architected `ReadmeGenerator` to be entirely stateless and driven by the remote configuration file.
+
 ## 2026-07-03
 - Redesigned Onboarding, Options, and Popup UIs with a modern, premium glassmorphic dark theme using Tailwind CSS.
 - Rebranded extension from "LeetSync" to "CommitCode".

manifest.json

@@ -1,7 +1,7 @@
 {
   "manifest_version": 3,
   "name": "CommitCode",
-  "version": "1.1.0",
+  "version": "2.0.0",
   "description": "Privacy-first browser extension that automatically syncs accepted coding problem submissions from LeetCode to GitHub.",
   "icons": {
     "16": "logo.png",

package.json

@@ -1,6 +1,6 @@
 {
   "name": "commitcode",
-  "version": "1.1.0",
+  "version": "2.0.0",
   "description": "Privacy-first LeetCode to GitHub sync extension",
   "type": "module",
   "scripts": {

src/background/sync-engine.ts

@@ -181,11 +181,46 @@ export class SyncEngine {
         { path: targetPath, content: fullCode }
       ];
 
-      // 5. Generate README content if enabled
+      // 5. Remote Source of Truth & README Generation
       if (settings.readmeEnabled) {
-        const allProblems = await db.getAllProblems();
+        problem.version = version;
+        
+        let remoteMetadata: any[] = [];
+        try {
+          const remoteFile = await client.getFile('commitcode.json');
+          // UTF-8 base64 decode
+          const jsonStr = decodeURIComponent(escape(atob(remoteFile.content)));
+          remoteMetadata = JSON.parse(jsonStr);
+        } catch (e: any) {
+          if (e.status !== 404) {
+            console.warn('[CommitCode] Could not fetch commitcode.json, assuming new or missing.', e);
+          }
+        }
+
+        // Migrate local data to remote if remote is empty
+        if (remoteMetadata.length === 0) {
+          const localProblems = await db.getAllProblems();
+          remoteMetadata = localProblems.map(p => {
+            const { code: _, ...rest } = p;
+            return rest;
+          });
+        }
+
+        // Include current problem
+        const { code: _code, ...currentMeta } = problem;
+        const index = remoteMetadata.findIndex(p => p.id === currentMeta.id && p.language === currentMeta.language);
+        if (index >= 0) {
+          remoteMetadata[index] = currentMeta;
+        } else {
+          remoteMetadata.push(currentMeta);
+        }
+
+        // Queue commitcode.json
+        const newJsonStr = JSON.stringify(remoteMetadata, null, 2);
+        filesToCommit.push({ path: 'commitcode.json', content: newJsonStr });
+
         const readmeGenerator = new ReadmeGenerator();
-        const readmeContent = readmeGenerator.generate(settings, allProblems);
+        const readmeContent = readmeGenerator.generate(settings, remoteMetadata);
         if (readmeContent) {
           filesToCommit.push({ path: 'README.md', content: readmeContent });
         }

src/github/readme-generator.ts

@@ -1,4 +1,4 @@
-import { ProblemRecord, Settings } from '../storage/types';
+import { ProblemMetadata, Settings } from '../storage/types';
 
 export class ReadmeGenerator {
   private getExtensionByLanguage(language: string): string {
@@ -22,7 +22,7 @@ export class ReadmeGenerator {
     return map[language.toLowerCase()] || 'txt';
   }
 
-  private resolvePath(problem: ProblemRecord, settings: Settings): string {
+  private resolvePath(problem: ProblemMetadata, settings: Settings): string {
     const paddedId = problem.id.toString().padStart(4, '0');
     const safeTitle = problem.title.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-|-$/g, '');
     const ext = this.getExtensionByLanguage(problem.language);
@@ -41,8 +41,8 @@ export class ReadmeGenerator {
       case 'Language':
         return `${problem.language}/${filename}`;
       case 'Number':
-        const paddedId = problem.id.toString().padStart(4, '0');
-        return `${paddedId}/${filename}`;
+        const paddedIdFolder = problem.id.toString().padStart(4, '0');
+        return `${paddedIdFolder}/${filename}`;
       case 'Flat':
         return filename;
       case 'Topic':
@@ -52,7 +52,7 @@ export class ReadmeGenerator {
     }
   }
 
-  public generate(settings: Settings, allProblems: ProblemRecord[]): string {
+  public generate(settings: Settings, allProblems: ProblemMetadata[]): string {
     if (allProblems.length === 0) return '';
 
     let total = 0;

src/storage/types.ts

@@ -13,6 +13,8 @@ export interface ProblemRecord {
   version: number;
 }
 
+export type ProblemMetadata = Omit<ProblemRecord, 'code'>;
+
 export type FolderStructure = 'Difficulty' | 'Topic' | 'Language' | 'Number' | 'Flat';
 
 export interface Settings {