feat: implement global chord track

src/core/project-upgrader/KGProjectUpgrader.ts

@@ -13,6 +13,7 @@ import { upgradeToV11 } from './upgradeToV11';
 import { upgradeToV12 } from './upgradeToV12';
 import { upgradeToV13 } from './upgradeToV13';
 import { upgradeToV14 } from './upgradeToV14';
+import { upgradeToV15 } from './upgradeToV15';
 
 /**
  * Upgrade the given project to the latest structure version, one version at a time.
@@ -88,6 +89,10 @@ export function upgradeProjectToLatest(project: KGProject): KGProject {
         workingProject = upgradeToV14(workingProject);
         break;
       }
+      case 15: {
+        workingProject = upgradeToV15(workingProject);
+        break;
+      }
       default: {
         // If an upgrader is missing, throw to prevent loading incompatible structures
         throw new Error(`No upgrader found for project structure version ${nextVersion}`);

src/core/project-upgrader/upgradeToV15.test.ts

@@ -0,0 +1,23 @@
+import { describe, expect, it } from 'vitest';
+import { KGProject } from '../KGProject';
+import { upgradeProjectToLatest } from './KGProjectUpgrader';
+import { upgradeToV15 } from './upgradeToV15';
+
+describe('upgradeToV15', () => {
+  it('marks projects as upgraded and preserves default global tracks', () => {
+    const project = new KGProject('Legacy', 32, 0, 125, undefined, undefined, undefined, undefined, [0, 0], 1, [], 14, 1, []);
+
+    upgradeToV15(project);
+
+    expect(project.getProjectStructureVersion()).toBe(15);
+    expect(project.getGlobalTracks()).toHaveLength(4);
+  });
+
+  it('runs through the main upgrader path', () => {
+    const project = new KGProject('Legacy', 32, 0, 125, undefined, undefined, undefined, undefined, [0, 0], 1, [], 14, 1, []);
+
+    const upgraded = upgradeProjectToLatest(project);
+
+    expect(upgraded.getProjectStructureVersion()).toBe(KGProject.CURRENT_PROJECT_STRUCTURE_VERSION);
+  });
+});

src/core/project-upgrader/upgradeToV15.ts

@@ -0,0 +1,12 @@
+import { KGProject } from '../KGProject';
+import { ensureDefaultGlobalTracks } from '../../util/globalTrackUtil';
+
+export function upgradeToV15(project: KGProject): KGProject {
+  try {
+    ensureDefaultGlobalTracks(project);
+  } finally {
+    project.setProjectStructureVersion(15);
+  }
+
+  return project;
+}