Add interlinearizer project storage and createProject command

- Add `src/projectStorage.ts` with `createProject`, `getProject`, `listProjects`, and `deleteProject` backed by `papi.storage`
- Register `interlinearizer.createProject` command in `main.ts` that prompts for source/target projects, writes the record, and surfaces storage errors as notifications
- Add `InterlinearProject` type and `interlinearizer.createProject` signature to shared type declarations
- Extend PAPI backend mock with `papi.storage` and `papi.notifications`
- Broaden Jest coverage to all `src/**` files
- Add full test suites for the storage module and the new command

Author: alex-rawlings-yyc

__mocks__/papi-backend.ts

@@ -10,6 +10,10 @@ const mockSelectProject = jest.fn();
 const mockGetOpenWebViewDefinition = jest.fn();
 const mockOnDidOpenWebView = jest.fn();
 const mockOnDidCloseWebView = jest.fn();
+const mockReadUserData = jest.fn();
+const mockWriteUserData = jest.fn();
+const mockDeleteUserData = jest.fn();
+const mockNotificationsSend = jest.fn();
 const mockLogger = {
   debug: jest.fn(),
   error: jest.fn(),
@@ -24,6 +28,14 @@ const papi = {
   dialogs: {
     selectProject: mockSelectProject,
   },
+  notifications: {
+    send: mockNotificationsSend,
+  },
+  storage: {
+    readUserData: mockReadUserData,
+    writeUserData: mockWriteUserData,
+    deleteUserData: mockDeleteUserData,
+  },
   webViewProviders: {
     registerWebViewProvider: mockRegisterWebViewProvider,
   },
@@ -44,6 +56,10 @@ const defaultExport = {
   __mockGetOpenWebViewDefinition: mockGetOpenWebViewDefinition,
   __mockOnDidOpenWebView: mockOnDidOpenWebView,
   __mockOnDidCloseWebView: mockOnDidCloseWebView,
+  __mockReadUserData: mockReadUserData,
+  __mockWriteUserData: mockWriteUserData,
+  __mockDeleteUserData: mockDeleteUserData,
+  __mockNotificationsSend: mockNotificationsSend,
   __mockLogger: mockLogger,
 };
 
@@ -58,6 +74,10 @@ module.exports = {
   __mockGetOpenWebViewDefinition: mockGetOpenWebViewDefinition,
   __mockOnDidOpenWebView: mockOnDidOpenWebView,
   __mockOnDidCloseWebView: mockOnDidCloseWebView,
+  __mockReadUserData: mockReadUserData,
+  __mockWriteUserData: mockWriteUserData,
+  __mockDeleteUserData: mockDeleteUserData,
+  __mockNotificationsSend: mockNotificationsSend,
   __mockLogger: mockLogger,
 };
 

jest.config.ts

@@ -23,15 +23,10 @@ const config: Config = {
    */
   collectCoverage: false,
 
-  /**
-   * Collect coverage from parsers, main entry (main.ts), and WebView UI
-   * (interlinearizer.web-view.tsx). Excludes test files, type declarations, and build artifacts.
-   */
+  /** Collect coverage from all source files. Excludes type declarations and test files. */
   collectCoverageFrom: [
-    'src/parsers/**/*.ts',
-    'src/main.ts',
-    'src/**/*.web-view.tsx',
-    '!src/parsers/**/*.d.ts',
+    'src/**/*.{ts,tsx}',
+    '!src/**/*.d.ts',
     '!src/**/__tests__/**',
     '!src/**/*.test.{ts,tsx}',
     '!src/**/*.spec.{ts,tsx}',

src/__tests__/main.test.ts

@@ -16,6 +16,9 @@ interface PapiBackendTestMock {
   __mockGetOpenWebViewDefinition: jest.Mock;
   __mockOnDidOpenWebView: jest.Mock;
   __mockOnDidCloseWebView: jest.Mock;
+  __mockReadUserData: jest.Mock;
+  __mockWriteUserData: jest.Mock;
+  __mockNotificationsSend: jest.Mock;
   __mockLogger: { debug: jest.Mock; error: jest.Mock; info: jest.Mock; warn: jest.Mock };
 }
 
@@ -34,6 +37,9 @@ function isPapiBackendTestMock(m: unknown): m is PapiBackendTestMock {
     '__mockGetOpenWebViewDefinition' in m &&
     '__mockOnDidOpenWebView' in m &&
     '__mockOnDidCloseWebView' in m &&
+    '__mockReadUserData' in m &&
+    '__mockWriteUserData' in m &&
+    '__mockNotificationsSend' in m &&
     '__mockLogger' in m
   );
 }
@@ -47,6 +53,9 @@ const {
   __mockGetOpenWebViewDefinition,
   __mockOnDidOpenWebView,
   __mockOnDidCloseWebView,
+  __mockReadUserData,
+  __mockWriteUserData,
+  __mockNotificationsSend,
   __mockLogger,
 } = papiBackendMock;
 
@@ -63,6 +72,12 @@ describe('main', () => {
     __mockGetOpenWebViewDefinition.mockResolvedValue(undefined);
     __mockOnDidOpenWebView.mockReturnValue(jest.fn());
     __mockOnDidCloseWebView.mockReturnValue(jest.fn());
+    __mockReadUserData.mockRejectedValue(
+      Object.assign(new Error('ENOENT: no such file or directory'), { code: 'ENOENT' }),
+    );
+    __mockWriteUserData.mockResolvedValue(undefined);
+    __mockNotificationsSend.mockResolvedValue('mock-notification-id');
+    jest.spyOn(crypto, 'randomUUID').mockReturnValue('00000000-0000-0000-0000-000000000000');
   });
 
   describe('activate', () => {
@@ -92,12 +107,12 @@ describe('main', () => {
       );
     });
 
-    it('adds all four registrations to the activation context', async () => {
+    it('adds all five registrations to the activation context', async () => {
       const context = createTestActivationContext();
 
       await activate(context);
 
-      expect(context.registrations.unsubscribers.size).toBe(4);
+      expect(context.registrations.unsubscribers.size).toBe(5);
     });
 
     it('logs activation start and finish', async () => {
@@ -330,6 +345,84 @@ describe('main', () => {
     });
   });
 
+  describe('interlinearizer.createProject command', () => {
+    async function getCreateProjectHandler(): Promise<
+      (analysisWritingSystem: string) => Promise<string | undefined>
+    > {
+      const context = createTestActivationContext();
+      await activate(context);
+      const rawHandler = findRegisteredHandler('interlinearizer.createProject');
+      if (!rawHandler) throw new Error('Handler not found for interlinearizer.createProject');
+      return async (ws: string): Promise<string | undefined> => {
+        const result: unknown = await rawHandler(ws);
+        return typeof result === 'string' ? result : undefined;
+      };
+    }
+
+    it('registers the interlinearizer.createProject command', async () => {
+      const context = createTestActivationContext();
+
+      await activate(context);
+
+      expect(__mockRegisterCommand).toHaveBeenCalledWith(
+        'interlinearizer.createProject',
+        expect.any(Function),
+        expect.any(Object),
+      );
+    });
+
+    it('creates and returns the new project ID when both pickers are confirmed', async () => {
+      __mockSelectProject.mockResolvedValueOnce('src-project').mockResolvedValueOnce('tgt-project');
+      const handler = await getCreateProjectHandler();
+
+      const result = await handler('en');
+
+      expect(result).toBe('00000000-0000-0000-0000-000000000000');
+      expect(__mockWriteUserData).toHaveBeenCalledWith(
+        expect.anything(),
+        'project:00000000-0000-0000-0000-000000000000',
+        expect.stringContaining('"sourceProjectId":"src-project"'),
+      );
+    });
+
+    it('returns undefined when the source picker is cancelled', async () => {
+      __mockSelectProject.mockResolvedValue(undefined);
+      const handler = await getCreateProjectHandler();
+
+      const result = await handler('en');
+
+      expect(result).toBeUndefined();
+      expect(__mockWriteUserData).not.toHaveBeenCalled();
+    });
+
+    it('returns undefined when the target picker is cancelled', async () => {
+      __mockSelectProject.mockResolvedValueOnce('src-project').mockResolvedValueOnce(undefined);
+      const handler = await getCreateProjectHandler();
+
+      const result = await handler('en');
+
+      expect(result).toBeUndefined();
+      expect(__mockWriteUserData).not.toHaveBeenCalled();
+    });
+
+    it('logs the error, sends an error notification, and returns undefined when storage fails', async () => {
+      __mockSelectProject.mockResolvedValueOnce('src-project').mockResolvedValueOnce('tgt-project');
+      __mockWriteUserData.mockRejectedValue(new Error('disk full'));
+      const handler = await getCreateProjectHandler();
+
+      const result = await handler('en');
+
+      expect(result).toBeUndefined();
+      expect(__mockLogger.error).toHaveBeenCalledWith(
+        'Interlinearizer: failed to create project',
+        expect.any(Error),
+      );
+      expect(__mockNotificationsSend).toHaveBeenCalledWith(
+        expect.objectContaining({ severity: 'error' }),
+      );
+    });
+  });
+
   describe('WebView lifecycle event subscriptions', () => {
     it('subscribes to onDidOpenWebView and onDidCloseWebView during activation', async () => {
       const context = createTestActivationContext();