Install npm package semver.

In project.ts:
Added functions fetchProjectInfo and updateProjectIfNecessary.
Call updateProjectIfNecessary in fetchProject.

Author: lizlooney

package-lock.json

@@ -24,6 +24,7 @@
     "react-dom": "^19.1.0",
     "react-i18next": "^15.6.0",
     "react-syntax-highlighter": "^15.6.1",
+    "semver": "^7.7.2",
     "web-vitals": "^5.0.3"
   },
   "scripts": {
@@ -56,6 +57,7 @@
     "@shadcn/ui": "^0.0.4",
     "@types/node": "^24.0.15",
     "@types/react-syntax-highlighter": "^15.5.13",
+    "@types/semver": "^7.7.0",
     "@vitejs/plugin-react": "^4.7.0",
     "autoprefixer": "^10.4.21",
     "playwright": "^1.54.1",

package.json

@@ -20,6 +20,7 @@
  */
 
 import JSZip from 'jszip';
+import * as semver from 'semver';
 
 import * as commonStorage from './common_storage';
 import * as storageModule from './module';
@@ -35,6 +36,7 @@ export type Project = {
   opModes: storageModule.OpMode[],
 };
 
+const NO_VERSION = '0.0.0';
 const CURRENT_VERSION = '0.0.1';
 
 type ProjectInfo = {
@@ -60,6 +62,8 @@ export async function listProjectNames(storage: commonStorage.Storage): Promise<
  */
 export async function fetchProject(
     storage: commonStorage.Storage, projectName: string): Promise<Project> {
+  await updateProjectIfNecessary(storage, projectName);
+
   const modulePaths: string[] = await storage.listFilePaths(
       storageNames.makeModulePathRegexPattern(projectName));
 
@@ -540,3 +544,34 @@ async function deleteProjectInfo(
   const projectInfoPath = storageNames.makeProjectInfoPath(projectName);
   await storage.deleteFile(projectInfoPath);
 }
+
+async function fetchProjectInfo(
+    storage: commonStorage.Storage, projectName: string): Promise<ProjectInfo> {
+  const projectInfoPath = storageNames.makeProjectInfoPath(projectName);
+  let projectInfo: ProjectInfo;
+  try {
+    const projectInfoContentText = await storage.fetchFileContentText(projectInfoPath);
+    projectInfo = parseProjectInfoContentText(projectInfoContentText);
+  } catch (error) {
+    // The file doesn't exist.
+    projectInfo = {
+      version: NO_VERSION,
+    };
+  }
+  return projectInfo;
+}
+
+async function updateProjectIfNecessary(
+    storage: commonStorage.Storage, projectName: string): Promise<void> {
+  const projectInfo = await fetchProjectInfo(storage, projectName);
+  if (semver.lt(projectInfo.version, CURRENT_VERSION)) {
+    switch (projectInfo.version) {
+      case '0.0.0':
+        // Project was saved without a project.info.json file.
+        // Nothing needs to be done to update to '0.0.1';
+        projectInfo.version = '0.0.1';
+        break;
+    }
+    await saveProjectInfo(storage, projectName);
+  }
+}