@mrpatronz/nexusflow 0.2.17 → 0.2.18

package/src/core/adapters/vault-storage.ts

@@ -0,0 +1,86 @@
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import * as os from 'node:os';
+import type { StoragePort, StorageAdapterMeta } from '../ports/storage.js';
+
+export class CentralVaultAdapter implements StoragePort {
+  readonly meta: StorageAdapterMeta = {
+    name: 'central-vault',
+    displayName: 'Central Vault',
+    description: 'Store context in ~/.nexusflow/vault/ — keeps repos clean, Obsidian-compatible.',
+    configFields: [],
+  };
+
+  private getVaultPath(featureId: string): string {
+    return path.join(os.homedir(), '.nexusflow', 'vault', featureId);
+  }
+
+  async writeWorkspaceFile(workspacePath: string, featureId: string, filename: string, content: string): Promise<void> {
+    const vaultDir = this.getVaultPath(featureId);
+    const filePath = path.join(vaultDir, filename);
+    await fs.mkdir(path.dirname(filePath), { recursive: true });
+    await fs.writeFile(filePath, content, 'utf8');
+  }
+
+  async readWorkspaceFile(workspacePath: string, featureId: string, filename: string): Promise<string> {
+    const vaultDir = this.getVaultPath(featureId);
+    const filePath = path.join(vaultDir, filename);
+    return await fs.readFile(filePath, 'utf8');
+  }
+
+  async workspaceFileExists(workspacePath: string, featureId: string, filename: string): Promise<boolean> {
+    const vaultDir = this.getVaultPath(featureId);
+    const filePath = path.join(vaultDir, filename);
+    try {
+      await fs.access(filePath);
+      return true;
+    } catch {
+      return false;
+    }
+  }
+
+  resolveWorkspaceFileUrl(workspacePath: string, featureId: string, filename: string): string {
+    const vaultDir = this.getVaultPath(featureId);
+    return path.join(vaultDir, filename).replace(/\\/g, '/');
+  }
+
+  private getBaseVaultPath(repoName: string): string {
+    return path.join(os.homedir(), '.nexusflow', 'vault', '_base', repoName);
+  }
+
+  async writeBaseFile(workspacePath: string, repoName: string, filename: string, content: string): Promise<void> {
+    const baseDir = this.getBaseVaultPath(repoName);
+    const filePath = path.join(baseDir, filename);
+    await fs.mkdir(path.dirname(filePath), { recursive: true });
+    await fs.writeFile(filePath, content, 'utf8');
+  }
+
+  async readBaseFile(workspacePath: string, repoName: string, filename: string): Promise<string> {
+    const baseDir = this.getBaseVaultPath(repoName);
+    const filePath = path.join(baseDir, filename);
+    return await fs.readFile(filePath, 'utf8');
+  }
+
+  async baseFileExists(workspacePath: string, repoName: string, filename: string): Promise<boolean> {
+    const baseDir = this.getBaseVaultPath(repoName);
+    const filePath = path.join(baseDir, filename);
+    try {
+      await fs.access(filePath);
+      return true;
+    } catch {
+      return false;
+    }
+  }
+
+  resolveBaseFileUrl(workspacePath: string, repoName: string, filename: string): string {
+    const baseDir = this.getBaseVaultPath(repoName);
+    return path.join(baseDir, filename).replace(/\\/g, '/');
+  }
+
+  async deleteWorkspace(workspacePath: string, featureId: string): Promise<void> {
+    const dir = this.getVaultPath(featureId);
+    try {
+      await fs.rm(dir, { recursive: true, force: true });
+    } catch {}
+  }
+}

package/src/core/config.test.ts

@@ -1,96 +1,96 @@
-import { describe, it, expect, vi, beforeEach } from 'vitest';
-import * as fs from 'node:fs/promises';
-import * as os from 'node:os';
-import { getConfigDir, getDefaultConfig, ensureConfigDir, loadConfig, saveConfig } from './config.js';
-
-vi.mock('node:fs/promises');
-vi.mock('node:os', async () => {
-  const actual = await vi.importActual<typeof import('node:os')>('node:os');
-  return {
-    ...actual,
-    homedir: vi.fn(),
-  };
-});
-
-describe('config core module', () => {
-  beforeEach(() => {
-    vi.clearAllMocks();
-    vi.mocked(os.homedir).mockReturnValue('/mock/home');
-  });
-
-  describe('getConfigDir', () => {
-    it('should return path based on home directory', () => {
-      const dir = getConfigDir();
-      expect(dir).toContain('.nexusflow');
-    });
-  });
-
-  describe('getDefaultConfig', () => {
-    it('should return config with defaults populated', () => {
-      const config = getDefaultConfig();
-      expect(config.version).toBe('1.0.0');
-      expect(config.scanDepth).toBe(2);
-      expect(config.localLlm?.enabled).toBe(false);
-    });
-  });
-
-  describe('ensureConfigDir', () => {
-    it('should invoke fs.mkdir with correct options', async () => {
-      vi.mocked(fs.mkdir).mockResolvedValue(undefined);
-
-      await ensureConfigDir();
-
-      expect(fs.mkdir).toHaveBeenCalledWith(expect.stringContaining('.nexusflow'), { recursive: true });
-    });
-  });
-
-  describe('loadConfig', () => {
-    it('should load config if file exists', async () => {
-      const savedConfig = {
-        devDir: '/custom/dev',
-        localLlm: {
-          enabled: true,
-          model: 'custom-model'
-        }
-      };
-
-      vi.mocked(fs.readFile).mockResolvedValue(JSON.stringify(savedConfig));
-
-      const config = await loadConfig();
-
-      expect(config.devDir).toBe('/custom/dev');
-      expect(config.localLlm?.enabled).toBe(true);
-      expect(config.localLlm?.model).toBe('custom-model');
-      // Should merge with defaults
-      expect(config.scanDepth).toBe(2);
-    });
-
-    it('should return default config if read fails', async () => {
-      vi.mocked(fs.readFile).mockRejectedValue(new Error('ENOENT'));
-
-      const config = await loadConfig();
-
-      expect(config.version).toBe('1.0.0');
-      expect(config.localLlm?.enabled).toBe(false);
-    });
-  });
-
-  describe('saveConfig', () => {
-    it('should create directory and save configuration', async () => {
-      vi.mocked(fs.mkdir).mockResolvedValue(undefined);
-      vi.mocked(fs.writeFile).mockResolvedValue(undefined);
-
-      const config = getDefaultConfig();
-      config.devDir = '/custom/saved/dev';
-
-      await saveConfig(config);
-
-      expect(fs.mkdir).toHaveBeenCalled();
-      expect(fs.writeFile).toHaveBeenCalledWith(
-        expect.stringContaining('config.json'),
-        expect.stringContaining('/custom/saved/dev'),
-        'utf-8'
-      );
-    });
-  });
-});
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import * as fs from 'node:fs/promises';
+import * as os from 'node:os';
+import { getConfigDir, getDefaultConfig, ensureConfigDir, loadConfig, saveConfig } from './config.js';
+
+vi.mock('node:fs/promises');
+vi.mock('node:os', async () => {
+  const actual = await vi.importActual<typeof import('node:os')>('node:os');
+  return {
+    ...actual,
+    homedir: vi.fn(),
+  };
+});
+
+describe('config core module', () => {
+  beforeEach(() => {
+    vi.clearAllMocks();
+    vi.mocked(os.homedir).mockReturnValue('/mock/home');
+  });
+
+  describe('getConfigDir', () => {
+    it('should return path based on home directory', () => {
+      const dir = getConfigDir();
+      expect(dir).toContain('.nexusflow');
+    });
+  });
+
+  describe('getDefaultConfig', () => {
+    it('should return config with defaults populated', () => {
+      const config = getDefaultConfig();
+      expect(config.version).toBe('1.0.0');
+      expect(config.scanDepth).toBe(2);
+      expect(config.localLlm?.enabled).toBe(false);
+    });
+  });
+
+  describe('ensureConfigDir', () => {
+    it('should invoke fs.mkdir with correct options', async () => {
+      vi.mocked(fs.mkdir).mockResolvedValue(undefined);
+
+      await ensureConfigDir();
+
+      expect(fs.mkdir).toHaveBeenCalledWith(expect.stringContaining('.nexusflow'), { recursive: true });
+    });
+  });
+
+  describe('loadConfig', () => {
+    it('should load config if file exists', async () => {
+      const savedConfig = {
+        devDir: '/custom/dev',
+        localLlm: {
+          enabled: true,
+          model: 'custom-model'
+        }
+      };
+
+      vi.mocked(fs.readFile).mockResolvedValue(JSON.stringify(savedConfig));
+
+      const config = await loadConfig();
+
+      expect(config.devDir).toBe('/custom/dev');
+      expect(config.localLlm?.enabled).toBe(true);
+      expect(config.localLlm?.model).toBe('custom-model');
+      // Should merge with defaults
+      expect(config.scanDepth).toBe(2);
+    });
+
+    it('should return default config if read fails', async () => {
+      vi.mocked(fs.readFile).mockRejectedValue(new Error('ENOENT'));
+
+      const config = await loadConfig();
+
+      expect(config.version).toBe('1.0.0');
+      expect(config.localLlm?.enabled).toBe(false);
+    });
+  });
+
+  describe('saveConfig', () => {
+    it('should create directory and save configuration', async () => {
+      vi.mocked(fs.mkdir).mockResolvedValue(undefined);
+      vi.mocked(fs.writeFile).mockResolvedValue(undefined);
+
+      const config = getDefaultConfig();
+      config.devDir = '/custom/saved/dev';
+
+      await saveConfig(config);
+
+      expect(fs.mkdir).toHaveBeenCalled();
+      expect(fs.writeFile).toHaveBeenCalledWith(
+        expect.stringContaining('config.json'),
+        expect.stringContaining('/custom/saved/dev'),
+        'utf-8'
+      );
+    });
+  });
+});

package/src/core/config.ts

@@ -1,115 +1,140 @@
-/**
- * @module core/config
- * Manages NexusFlow configuration stored at ~/.nexusflow/config.json.
- */
-
-import * as fs from 'node:fs/promises';
-import * as path from 'node:path';
-import * as os from 'node:os';
-
-import type { NexusFlowConfig } from '../types.js';
-
-/** Name of the config directory under the user's home folder. */
-const CONFIG_DIR_NAME = '.nexusflow';
-
-/** Name of the config file. */
-const CONFIG_FILE_NAME = 'config.json';
-
-/**
- * Returns the absolute path to the NexusFlow config directory (~/.nexusflow).
- */
-export function getConfigDir(): string {
-  return path.join(os.homedir(), CONFIG_DIR_NAME);
-}
-
-/**
- * Returns a NexusFlowConfig populated with sensible defaults.
- */
-export function getDefaultConfig(): NexusFlowConfig {
-  return {
-    version: '1.0.0',
-    devDir: path.join(os.homedir(), 'dev'),
-    workspacesDir: path.join(os.homedir(), 'dev', 'workspaces'),
-    defaultAssistant: null,
-    defaultEditor: null,
-    scanDepth: 2,
-    packContextXml: false,
-    excludePatterns: [
-      '**/node_modules/**',
-      '**/bin/**',
-      '**/obj/**',
-      '**/dist/**',
-      '**/out/**',
-      '**/.git/**',
-      '**/*.lock',
-      '**/package-lock.json',
-      '**/pnpm-lock.yaml',
-      '**/yarn.lock',
-      '**/*.png',
-      '**/*.jpg',
-      '**/*.jpeg',
-      '**/*.gif',
-      '**/*.svg',
-      '**/*.ico',
-      '**/*.pdf',
-      '**/*.zip',
-      '**/*.tar.gz',
-      '**/.vs/**',
-      '**/.vscode/**',
-      '**/.idea/**',
-    ],
-    localLlm: {
-      enabled: false,
-      provider: 'ollama',
-      endpoint: 'http://localhost:11434',
-      model: 'qwen2.5-coder:1.5b',
-    },
-  };
-}
-
-/**
- * Ensures the ~/.nexusflow directory exists, creating it if necessary.
- */
-export async function ensureConfigDir(): Promise<void> {
-  const configDir = getConfigDir();
-  await fs.mkdir(configDir, { recursive: true });
-}
-
-/**
- * Loads the NexusFlow config from disk.
- * Returns default values when the config file does not exist yet.
- *
- * @returns The loaded or default configuration.
- */
-export async function loadConfig(): Promise<NexusFlowConfig> {
-  const configPath = path.join(getConfigDir(), CONFIG_FILE_NAME);
-
-  try {
-    const raw = await fs.readFile(configPath, 'utf-8');
-    const parsed = JSON.parse(raw) as Partial<NexusFlowConfig>;
-
-    // Merge with defaults so newly-added keys are always present.
-    const merged = { ...getDefaultConfig(), ...parsed };
-    if (parsed.localLlm) {
-      merged.localLlm = { ...getDefaultConfig().localLlm, ...parsed.localLlm };
-    }
-    return merged;
-  } catch {
-    // File doesn't exist or is unreadable — return defaults.
-    return getDefaultConfig();
-  }
-}
-
-/**
- * Persists the given configuration to ~/.nexusflow/config.json.
- * Creates the config directory if it doesn't exist.
- *
- * @param config - The configuration to save.
- */
-export async function saveConfig(config: NexusFlowConfig): Promise<void> {
-  await ensureConfigDir();
-
-  const configPath = path.join(getConfigDir(), CONFIG_FILE_NAME);
-  const data = JSON.stringify(config, null, 2) + '\n';
-  await fs.writeFile(configPath, data, 'utf-8');
-}
+/**
+ * @module core/config
+ * Manages NexusFlow configuration stored at ~/.nexusflow/config.json.
+ */
+
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import * as os from 'node:os';
+
+import type { NexusFlowConfig } from '../types.js';
+import { getStorageProvider, setActiveStorageProvider } from './adapters/registry.js';
+
+/** Name of the config directory under the user's home folder. */
+const CONFIG_DIR_NAME = '.nexusflow';
+
+/** Name of the config file. */
+const CONFIG_FILE_NAME = 'config.json';
+
+/**
+ * Returns the absolute path to the NexusFlow config directory (~/.nexusflow).
+ */
+export function getConfigDir(): string {
+  return path.join(os.homedir(), CONFIG_DIR_NAME);
+}
+
+/**
+ * Returns a NexusFlowConfig populated with sensible defaults.
+ */
+export function getDefaultConfig(): NexusFlowConfig {
+  return {
+    version: '1.0.0',
+    devDir: path.join(os.homedir(), 'dev'),
+    workspacesDir: path.join(os.homedir(), 'dev', 'workspaces'),
+    defaultAssistant: null,
+    defaultEditor: null,
+    scanDepth: 2,
+    excludePatterns: [
+      '**/node_modules/**',
+      '**/bin/**',
+      '**/obj/**',
+      '**/dist/**',
+      '**/out/**',
+      '**/.git/**',
+      '**/*.lock',
+      '**/package-lock.json',
+      '**/pnpm-lock.yaml',
+      '**/yarn.lock',
+      '**/*.png',
+      '**/*.jpg',
+      '**/*.jpeg',
+      '**/*.gif',
+      '**/*.svg',
+      '**/*.ico',
+      '**/*.pdf',
+      '**/*.zip',
+      '**/*.tar.gz',
+      '**/.vs/**',
+      '**/.vscode/**',
+      '**/.idea/**',
+    ],
+    localLlm: {
+      enabled: false,
+      provider: 'ollama',
+      endpoint: 'http://localhost:11434',
+      model: 'qwen2.5-coder:1.5b',
+    },
+  };
+}
+
+/**
+ * Ensures the ~/.nexusflow directory exists, creating it if necessary.
+ */
+export async function ensureConfigDir(): Promise<void> {
+  const configDir = getConfigDir();
+  await fs.mkdir(configDir, { recursive: true });
+}
+
+/**
+ * Loads the NexusFlow config from disk.
+ * Returns default values when the config file does not exist yet.
+ *
+ * @returns The loaded or default configuration.
+ */
+export async function loadConfig(): Promise<NexusFlowConfig> {
+  const configPath = path.join(getConfigDir(), CONFIG_FILE_NAME);
+
+  let merged: NexusFlowConfig;
+  try {
+    const raw = await fs.readFile(configPath, 'utf-8');
+    const parsed = JSON.parse(raw) as Partial<NexusFlowConfig>;
+
+    // Merge with defaults so newly-added keys are always present.
+    merged = { ...getDefaultConfig(), ...parsed };
+    if (parsed.localLlm) {
+      merged.localLlm = { ...getDefaultConfig().localLlm, ...parsed.localLlm };
+    }
+  } catch {
+    // File doesn't exist or is unreadable — return defaults.
+    merged = getDefaultConfig();
+  }
+
+  // Set the active storage provider based on configuration
+  try {
+    const providerName = merged.storageProvider || 'local';
+    const provider = getStorageProvider(providerName);
+    // Pass per-adapter settings if available
+    const adapterSettings = merged.adapterConfig?.[providerName] ?? {};
+    if (provider.configure) {
+      provider.configure(adapterSettings);
+    }
+    setActiveStorageProvider(provider);
+  } catch {}
+
+  return merged;
+}
+
+/**
+ * Persists the given configuration to ~/.nexusflow/config.json.
+ * Creates the config directory if it doesn't exist.
+ *
+ * @param config - The configuration to save.
+ */
+export async function saveConfig(config: NexusFlowConfig): Promise<void> {
+  await ensureConfigDir();
+
+  const configPath = path.join(getConfigDir(), CONFIG_FILE_NAME);
+  const data = JSON.stringify(config, null, 2) + '\n';
+  await fs.writeFile(configPath, data, 'utf-8');
+
+  // Set the active storage provider based on configuration
+  try {
+    const providerName = config.storageProvider || 'local';
+    const provider = getStorageProvider(providerName);
+    const adapterSettings = config.adapterConfig?.[providerName] ?? {};
+    if (provider.configure) {
+      provider.configure(adapterSettings);
+    }
+    setActiveStorageProvider(provider);
+  } catch {}
+}