@mrpatronz/nexusflow 0.2.17 → 0.2.18

package/dist/core/adapters/obsidian-storage.js

@@ -0,0 +1,135 @@
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import * as os from 'node:os';
+/**
+ * Obsidian-native storage adapter.
+ *
+ * Writes markdown files to a configurable Obsidian vault path with optional
+ * YAML frontmatter (tags, dates, type). Uses the same two-layer structure
+ * as CentralVaultAdapter (_base/<repo>/ + <workspace>/).
+ */
+export class ObsidianStorageAdapter {
+    meta = {
+        name: 'obsidian',
+        displayName: 'Obsidian Vault',
+        description: 'Store context in an Obsidian vault with YAML frontmatter and wikilinks.',
+        configFields: [
+            {
+                key: 'vaultPath',
+                label: 'Obsidian Vault Path',
+                type: 'path',
+                required: true,
+                description: 'Absolute path to your Obsidian vault folder (e.g. ~/Obsidian/Dev)',
+            },
+            {
+                key: 'addFrontmatter',
+                label: 'Add YAML Frontmatter',
+                type: 'boolean',
+                default: true,
+                description: 'Add tags, created date, and type metadata to each file',
+            },
+        ],
+    };
+    vaultPath = '';
+    addFrontmatter = true;
+    constructor() {
+        try {
+            const home = os.homedir();
+            if (home) {
+                this.vaultPath = path.join(home, 'Obsidian', 'NexusFlow');
+            }
+        }
+        catch { }
+    }
+    configure(settings) {
+        if (settings.vaultPath && typeof settings.vaultPath === 'string') {
+            this.vaultPath = settings.vaultPath.startsWith('~')
+                ? path.join(os.homedir(), settings.vaultPath.slice(1))
+                : settings.vaultPath;
+        }
+        if (typeof settings.addFrontmatter === 'boolean') {
+            this.addFrontmatter = settings.addFrontmatter;
+        }
+    }
+    // ── Frontmatter helpers ──────────────────────────────────
+    wrapWithFrontmatter(content, tags, type) {
+        if (!this.addFrontmatter)
+            return content;
+        const now = new Date().toISOString();
+        const fm = [
+            '---',
+            `tags: [${tags.map(t => `"${t}"`).join(', ')}]`,
+            `type: ${type}`,
+            `created: ${now}`,
+            `modified: ${now}`,
+            `generator: nexusflow`,
+            '---',
+            '',
+        ].join('\n');
+        // Strip existing frontmatter if present
+        const stripped = content.replace(/^---\n[\s\S]*?\n---\n*/, '');
+        return fm + stripped;
+    }
+    // ── Workspace (feature) layer ────────────────────────────
+    getFeaturePath(featureId) {
+        return path.join(this.vaultPath, 'nexusflow', 'workspaces', featureId);
+    }
+    async writeWorkspaceFile(workspacePath, featureId, filename, content) {
+        const dir = this.getFeaturePath(featureId);
+        const filePath = path.join(dir, filename);
+        await fs.mkdir(path.dirname(filePath), { recursive: true });
+        const wrapped = this.wrapWithFrontmatter(content, [featureId, 'workspace'], 'workspace-context');
+        await fs.writeFile(filePath, wrapped, 'utf8');
+    }
+    async readWorkspaceFile(workspacePath, featureId, filename) {
+        const dir = this.getFeaturePath(featureId);
+        return await fs.readFile(path.join(dir, filename), 'utf8');
+    }
+    async workspaceFileExists(workspacePath, featureId, filename) {
+        try {
+            await fs.access(path.join(this.getFeaturePath(featureId), filename));
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    resolveWorkspaceFileUrl(workspacePath, featureId, filename) {
+        return path.join(this.getFeaturePath(featureId), filename).replace(/\\/g, '/');
+    }
+    // ── Base (repo) layer ────────────────────────────────────
+    getBasePath(repoName) {
+        return path.join(this.vaultPath, 'nexusflow', '_base', repoName);
+    }
+    async writeBaseFile(workspacePath, repoName, filename, content) {
+        const dir = this.getBasePath(repoName);
+        const filePath = path.join(dir, filename);
+        await fs.mkdir(path.dirname(filePath), { recursive: true });
+        const wrapped = this.wrapWithFrontmatter(content, [repoName, 'base'], 'base-knowledge');
+        await fs.writeFile(filePath, wrapped, 'utf8');
+    }
+    async readBaseFile(workspacePath, repoName, filename) {
+        const dir = this.getBasePath(repoName);
+        return await fs.readFile(path.join(dir, filename), 'utf8');
+    }
+    async baseFileExists(workspacePath, repoName, filename) {
+        try {
+            await fs.access(path.join(this.getBasePath(repoName), filename));
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    resolveBaseFileUrl(workspacePath, repoName, filename) {
+        return path.join(this.getBasePath(repoName), filename).replace(/\\/g, '/');
+    }
+    async deleteWorkspace(workspacePath, featureId) {
+        const dir = this.getFeaturePath(featureId);
+        try {
+            await fs.rm(dir, { recursive: true, force: true });
+        }
+        catch { }
+    }
+}
+//# sourceMappingURL=obsidian-storage.js.map

package/dist/core/adapters/obsidian-storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"obsidian-storage.js","sourceRoot":"","sources":["../../../src/core/adapters/obsidian-storage.ts"],"names":[],"mappings":"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"}

package/dist/core/adapters/registry.d.ts

@@ -0,0 +1,8 @@
+import type { StoragePort, StorageAdapterMeta } from '../ports/storage.js';
+export declare function registerStorageProvider(name: string, provider: StoragePort): void;
+/** Returns metadata for all registered storage providers. */
+export declare function listStorageProviders(): StorageAdapterMeta[];
+export declare function getStorageProvider(name: string): StoragePort;
+export declare function setActiveStorageProvider(provider: StoragePort): void;
+export declare function getActiveStorageProvider(): StoragePort;
+//# sourceMappingURL=registry.d.ts.map

package/dist/core/adapters/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/core/adapters/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAQ3E,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,QAE1E;AAOD,6DAA6D;AAC7D,wBAAgB,oBAAoB,IAAI,kBAAkB,EAAE,CAE3D;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAM5D;AAED,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,WAAW,QAE7D;AAED,wBAAgB,wBAAwB,IAAI,WAAW,CAStD"}

package/dist/core/adapters/registry.js

@@ -0,0 +1,37 @@
+import { LocalStorageAdapter } from './local-storage.js';
+import { CentralVaultAdapter } from './vault-storage.js';
+import { ObsidianStorageAdapter } from './obsidian-storage.js';
+const storageProviders = new Map();
+let activeProvider = null;
+export function registerStorageProvider(name, provider) {
+    storageProviders.set(name, provider);
+}
+// Auto-register built-in adapters
+registerStorageProvider('local', new LocalStorageAdapter());
+registerStorageProvider('central-vault', new CentralVaultAdapter());
+registerStorageProvider('obsidian', new ObsidianStorageAdapter());
+/** Returns metadata for all registered storage providers. */
+export function listStorageProviders() {
+    return Array.from(storageProviders.values()).map(p => p.meta);
+}
+export function getStorageProvider(name) {
+    const provider = storageProviders.get(name);
+    if (!provider) {
+        throw new Error(`Storage provider "${name}" is not registered.`);
+    }
+    return provider;
+}
+export function setActiveStorageProvider(provider) {
+    activeProvider = provider;
+}
+export function getActiveStorageProvider() {
+    if (!activeProvider) {
+        const local = storageProviders.get('local');
+        if (!local) {
+            throw new Error('No storage providers registered.');
+        }
+        return local;
+    }
+    return activeProvider;
+}
+//# sourceMappingURL=registry.js.map

package/dist/core/adapters/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/core/adapters/registry.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAE/D,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAuB,CAAC;AACxD,IAAI,cAAc,GAAuB,IAAI,CAAC;AAE9C,MAAM,UAAU,uBAAuB,CAAC,IAAY,EAAE,QAAqB;IACzE,gBAAgB,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AACvC,CAAC;AAED,kCAAkC;AAClC,uBAAuB,CAAC,OAAO,EAAE,IAAI,mBAAmB,EAAE,CAAC,CAAC;AAC5D,uBAAuB,CAAC,eAAe,EAAE,IAAI,mBAAmB,EAAE,CAAC,CAAC;AACpE,uBAAuB,CAAC,UAAU,EAAE,IAAI,sBAAsB,EAAE,CAAC,CAAC;AAElE,6DAA6D;AAC7D,MAAM,UAAU,oBAAoB;IAClC,OAAO,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,MAAM,QAAQ,GAAG,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC5C,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,qBAAqB,IAAI,sBAAsB,CAAC,CAAC;IACnE,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,QAAqB;IAC5D,cAAc,GAAG,QAAQ,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,wBAAwB;IACtC,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,MAAM,KAAK,GAAG,gBAAgB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC5C,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;QACtD,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,cAAc,CAAC;AACxB,CAAC"}

package/dist/core/adapters/storage.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=storage.test.d.ts.map

package/dist/core/adapters/storage.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.test.d.ts","sourceRoot":"","sources":["../../../src/core/adapters/storage.test.ts"],"names":[],"mappings":""}

package/dist/core/adapters/storage.test.js

@@ -0,0 +1,106 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import * as fs from 'node:fs/promises';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import { LocalStorageAdapter } from './local-storage.js';
+import { CentralVaultAdapter } from './vault-storage.js';
+import { ObsidianStorageAdapter } from './obsidian-storage.js';
+vi.mock('node:fs/promises');
+vi.mock('node:os', async () => {
+    const actual = await vi.importActual('node:os');
+    return {
+        ...actual,
+        homedir: vi.fn().mockReturnValue('/mock/home'),
+    };
+});
+describe('Storage Adapters', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+        vi.mocked(os.homedir).mockReturnValue('/mock/home');
+    });
+    describe('LocalStorageAdapter', () => {
+        const adapter = new LocalStorageAdapter();
+        it('should declare correct meta', () => {
+            expect(adapter.meta.name).toBe('local');
+            expect(adapter.meta.configFields.length).toBe(0);
+        });
+        it('should write workspace files directly to the workspace path', async () => {
+            vi.mocked(fs.mkdir).mockResolvedValue(undefined);
+            vi.mocked(fs.writeFile).mockResolvedValue(undefined);
+            await adapter.writeWorkspaceFile('/ws/path', 'feature-1', 'test.txt', 'hello');
+            expect(fs.mkdir).toHaveBeenCalledWith(expect.stringContaining(path.normalize('/ws/path')), { recursive: true });
+            expect(fs.writeFile).toHaveBeenCalledWith(path.normalize('/ws/path/test.txt'), 'hello', 'utf8');
+        });
+        it('should resolve local workspace paths', () => {
+            const resolved = adapter.resolveWorkspaceFileUrl('/ws/path', 'feature-1', 'test.txt');
+            expect(resolved).toContain('/ws/path/test.txt');
+        });
+        it('should delete workspace as NOP', async () => {
+            await adapter.deleteWorkspace('/ws/path', 'feature-1');
+            expect(fs.rm).not.toHaveBeenCalled();
+        });
+    });
+    describe('CentralVaultAdapter', () => {
+        const adapter = new CentralVaultAdapter();
+        it('should declare correct meta', () => {
+            expect(adapter.meta.name).toBe('central-vault');
+        });
+        it('should write workspace files to ~/.nexusflow/vault/<featureId>', async () => {
+            vi.mocked(fs.mkdir).mockResolvedValue(undefined);
+            vi.mocked(fs.writeFile).mockResolvedValue(undefined);
+            await adapter.writeWorkspaceFile('/ws/path', 'feature-1', 'test.txt', 'hello');
+            expect(fs.writeFile).toHaveBeenCalledWith(expect.stringContaining(path.normalize('.nexusflow/vault/feature-1/test.txt')), 'hello', 'utf8');
+        });
+        it('should write base files to ~/.nexusflow/vault/_base/<repoName>', async () => {
+            vi.mocked(fs.mkdir).mockResolvedValue(undefined);
+            vi.mocked(fs.writeFile).mockResolvedValue(undefined);
+            await adapter.writeBaseFile('/ws/path', 'RepoName', 'map.md', 'content');
+            expect(fs.writeFile).toHaveBeenCalledWith(expect.stringContaining(path.normalize('.nexusflow/vault/_base/RepoName/map.md')), 'content', 'utf8');
+        });
+        it('should delete workspace folder from ~/.nexusflow/vault', async () => {
+            vi.mocked(fs.rm).mockResolvedValue(undefined);
+            await adapter.deleteWorkspace('/ws/path', 'feature-1');
+            expect(fs.rm).toHaveBeenCalledWith(expect.stringContaining(path.normalize('.nexusflow/vault/feature-1')), { recursive: true, force: true });
+        });
+    });
+    describe('ObsidianStorageAdapter', () => {
+        it('should declare correct meta and configuration settings', () => {
+            const adapter = new ObsidianStorageAdapter();
+            expect(adapter.meta.name).toBe('obsidian');
+            expect(adapter.meta.configFields.some(f => f.key === 'vaultPath')).toBe(true);
+        });
+        it('should respect custom vaultPath configuration', async () => {
+            const adapter = new ObsidianStorageAdapter();
+            adapter.configure({ vaultPath: '/custom/obsidian/vault' });
+            vi.mocked(fs.mkdir).mockResolvedValue(undefined);
+            vi.mocked(fs.writeFile).mockResolvedValue(undefined);
+            await adapter.writeWorkspaceFile('/ws/path', 'feature-1', 'test.txt', 'hello');
+            expect(fs.writeFile).toHaveBeenCalledWith(path.normalize('/custom/obsidian/vault/nexusflow/workspaces/feature-1/test.txt'), expect.any(String), 'utf8');
+        });
+        it('should wrap content with YAML frontmatter by default', async () => {
+            const adapter = new ObsidianStorageAdapter();
+            adapter.configure({ vaultPath: '/custom/obsidian/vault', addFrontmatter: true });
+            vi.mocked(fs.mkdir).mockResolvedValue(undefined);
+            vi.mocked(fs.writeFile).mockResolvedValue(undefined);
+            await adapter.writeWorkspaceFile('/ws/path', 'feature-1', 'test.txt', 'hello');
+            expect(fs.writeFile).toHaveBeenCalledWith(expect.any(String), expect.stringContaining('tags: ["feature-1", "workspace"]'), 'utf8');
+            expect(fs.writeFile).toHaveBeenCalledWith(expect.any(String), expect.stringContaining('generator: nexusflow'), 'utf8');
+        });
+        it('should not wrap content with frontmatter if addFrontmatter is disabled', async () => {
+            const adapter = new ObsidianStorageAdapter();
+            adapter.configure({ vaultPath: '/custom/obsidian/vault', addFrontmatter: false });
+            vi.mocked(fs.mkdir).mockResolvedValue(undefined);
+            vi.mocked(fs.writeFile).mockResolvedValue(undefined);
+            await adapter.writeWorkspaceFile('/ws/path', 'feature-1', 'test.txt', 'hello');
+            expect(fs.writeFile).toHaveBeenCalledWith(expect.any(String), 'hello', 'utf8');
+        });
+        it('should delete workspace folder from custom vault path under nexusflow', async () => {
+            const adapter = new ObsidianStorageAdapter();
+            adapter.configure({ vaultPath: '/custom/obsidian/vault' });
+            vi.mocked(fs.rm).mockResolvedValue(undefined);
+            await adapter.deleteWorkspace('/ws/path', 'feature-1');
+            expect(fs.rm).toHaveBeenCalledWith(path.normalize('/custom/obsidian/vault/nexusflow/workspaces/feature-1'), { recursive: true, force: true });
+        });
+    });
+});
+//# sourceMappingURL=storage.test.js.map

package/dist/core/adapters/storage.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.test.js","sourceRoot":"","sources":["../../../src/core/adapters/storage.test.ts"],"names":[],"mappings":"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"}

package/dist/core/adapters/vault-storage.d.ts

@@ -0,0 +1,16 @@
+import type { StoragePort, StorageAdapterMeta } from '../ports/storage.js';
+export declare class CentralVaultAdapter implements StoragePort {
+    readonly meta: StorageAdapterMeta;
+    private getVaultPath;
+    writeWorkspaceFile(workspacePath: string, featureId: string, filename: string, content: string): Promise<void>;
+    readWorkspaceFile(workspacePath: string, featureId: string, filename: string): Promise<string>;
+    workspaceFileExists(workspacePath: string, featureId: string, filename: string): Promise<boolean>;
+    resolveWorkspaceFileUrl(workspacePath: string, featureId: string, filename: string): string;
+    private getBaseVaultPath;
+    writeBaseFile(workspacePath: string, repoName: string, filename: string, content: string): Promise<void>;
+    readBaseFile(workspacePath: string, repoName: string, filename: string): Promise<string>;
+    baseFileExists(workspacePath: string, repoName: string, filename: string): Promise<boolean>;
+    resolveBaseFileUrl(workspacePath: string, repoName: string, filename: string): string;
+    deleteWorkspace(workspacePath: string, featureId: string): Promise<void>;
+}
+//# sourceMappingURL=vault-storage.d.ts.map

package/dist/core/adapters/vault-storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vault-storage.d.ts","sourceRoot":"","sources":["../../../src/core/adapters/vault-storage.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAE3E,qBAAa,mBAAoB,YAAW,WAAW;IACrD,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAK/B;IAEF,OAAO,CAAC,YAAY;IAId,kBAAkB,CAAC,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO9G,iBAAiB,CAAC,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAM9F,mBAAmB,CAAC,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAWvG,uBAAuB,CAAC,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM;IAK3F,OAAO,CAAC,gBAAgB;IAIlB,aAAa,CAAC,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOxG,YAAY,CAAC,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAMxF,cAAc,CAAC,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAWjG,kBAAkB,CAAC,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM;IAK/E,eAAe,CAAC,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAM/E"}

package/dist/core/adapters/vault-storage.js

@@ -0,0 +1,77 @@
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import * as os from 'node:os';
+export class CentralVaultAdapter {
+    meta = {
+        name: 'central-vault',
+        displayName: 'Central Vault',
+        description: 'Store context in ~/.nexusflow/vault/ — keeps repos clean, Obsidian-compatible.',
+        configFields: [],
+    };
+    getVaultPath(featureId) {
+        return path.join(os.homedir(), '.nexusflow', 'vault', featureId);
+    }
+    async writeWorkspaceFile(workspacePath, featureId, filename, content) {
+        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, featureId, filename) {
+        const vaultDir = this.getVaultPath(featureId);
+        const filePath = path.join(vaultDir, filename);
+        return await fs.readFile(filePath, 'utf8');
+    }
+    async workspaceFileExists(workspacePath, featureId, filename) {
+        const vaultDir = this.getVaultPath(featureId);
+        const filePath = path.join(vaultDir, filename);
+        try {
+            await fs.access(filePath);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    resolveWorkspaceFileUrl(workspacePath, featureId, filename) {
+        const vaultDir = this.getVaultPath(featureId);
+        return path.join(vaultDir, filename).replace(/\\/g, '/');
+    }
+    getBaseVaultPath(repoName) {
+        return path.join(os.homedir(), '.nexusflow', 'vault', '_base', repoName);
+    }
+    async writeBaseFile(workspacePath, repoName, filename, content) {
+        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, repoName, filename) {
+        const baseDir = this.getBaseVaultPath(repoName);
+        const filePath = path.join(baseDir, filename);
+        return await fs.readFile(filePath, 'utf8');
+    }
+    async baseFileExists(workspacePath, repoName, filename) {
+        const baseDir = this.getBaseVaultPath(repoName);
+        const filePath = path.join(baseDir, filename);
+        try {
+            await fs.access(filePath);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    resolveBaseFileUrl(workspacePath, repoName, filename) {
+        const baseDir = this.getBaseVaultPath(repoName);
+        return path.join(baseDir, filename).replace(/\\/g, '/');
+    }
+    async deleteWorkspace(workspacePath, featureId) {
+        const dir = this.getVaultPath(featureId);
+        try {
+            await fs.rm(dir, { recursive: true, force: true });
+        }
+        catch { }
+    }
+}
+//# sourceMappingURL=vault-storage.js.map

package/dist/core/adapters/vault-storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vault-storage.js","sourceRoot":"","sources":["../../../src/core/adapters/vault-storage.ts"],"names":[],"mappings":"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"}

package/dist/core/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAQnD;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,eAAe,CAwClD;AAED;;GAEG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAGrD;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC,eAAe,CAAC,CAiB3D;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAMvE"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AASnD;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,eAAe,CAuClD;AAED;;GAEG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAGrD;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC,eAAe,CAAC,CA+B3D;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAiBvE"}

package/dist/core/config.js

@@ -5,6 +5,7 @@
 import * as fs from 'node:fs/promises';
 import * as path from 'node:path';
 import * as os from 'node:os';
+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. */
@@ -26,7 +27,6 @@ export function getDefaultConfig() {
         defaultAssistant: null,
         defaultEditor: null,
         scanDepth: 2,
-        packContextXml: false,
         excludePatterns: [
             '**/node_modules/**',
             '**/bin/**',
@@ -74,20 +74,33 @@ export async function ensureConfigDir() {
  */
 export async function loadConfig() {
     const configPath = path.join(getConfigDir(), CONFIG_FILE_NAME);
+    let merged;
     try {
         const raw = await fs.readFile(configPath, 'utf-8');
         const parsed = JSON.parse(raw);
         // Merge with defaults so newly-added keys are always present.
-        const merged = { ...getDefaultConfig(), ...parsed };
+        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();
+        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.
@@ -100,5 +113,16 @@ export async function saveConfig(config) {
     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 { }
 }
 //# sourceMappingURL=config.js.map

package/dist/core/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"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"}

package/dist/core/plugins/index.d.ts

@@ -0,0 +1,14 @@
+import type { StoragePort } from '../ports/storage.js';
+export type { StoragePort, StorageAdapterMeta, AdapterConfigField } from '../ports/storage.js';
+export interface PluginRegistryContext {
+    /** Registers a custom storage provider/adapter. The provider must include a `meta` property. */
+    registerStorageProvider(name: string, provider: StoragePort): void;
+    /** Registers a custom commander CLI subcommand. */
+    registerCommand(commandBuilder: (program: any) => void): void;
+}
+export interface NexusFlowPlugin {
+    name: string;
+    version: string;
+    register(context: PluginRegistryContext): void | Promise<void>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/core/plugins/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/plugins/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAE/F,MAAM,WAAW,qBAAqB;IACpC,gGAAgG;IAChG,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,GAAG,IAAI,CAAC;IAEnE,mDAAmD;IACnD,eAAe,CAAC,cAAc,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,IAAI,GAAG,IAAI,CAAC;CAC/D;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,OAAO,EAAE,qBAAqB,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChE"}

package/dist/core/plugins/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/core/plugins/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/plugins/index.ts"],"names":[],"mappings":""}

package/dist/core/plugins/loader.d.ts

@@ -0,0 +1,2 @@
+export declare function loadPlugins(program: any, pluginsList: string[]): Promise<void>;
+//# sourceMappingURL=loader.d.ts.map

package/dist/core/plugins/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../../src/core/plugins/loader.ts"],"names":[],"mappings":"AAIA,wBAAsB,WAAW,CAAC,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA+BpF"}

package/dist/core/plugins/loader.js

@@ -0,0 +1,34 @@
+import * as path from 'node:path';
+import { registerStorageProvider } from '../adapters/registry.js';
+export async function loadPlugins(program, pluginsList) {
+    const context = {
+        registerStorageProvider(name, provider) {
+            registerStorageProvider(name, provider);
+        },
+        registerCommand(commandBuilder) {
+            commandBuilder(program);
+        }
+    };
+    for (const pluginPath of pluginsList) {
+        try {
+            let resolvedPath = pluginPath;
+            if (pluginPath.startsWith('.') || path.isAbsolute(pluginPath)) {
+                resolvedPath = path.resolve(pluginPath);
+            }
+            // Dynamic import works with file:// URLs on Windows
+            const fileUrl = resolvedPath.startsWith('file://') ? resolvedPath : `file:///${resolvedPath.replace(/\\/g, '/')}`;
+            const module = await import(fileUrl);
+            const plugin = module.default || module.plugin;
+            if (plugin && typeof plugin.register === 'function') {
+                await plugin.register(context);
+            }
+            else {
+                console.warn(`Warning: Plugin at "${pluginPath}" does not export a valid NexusFlowPlugin.`);
+            }
+        }
+        catch (error) {
+            console.error(`Failed to load plugin "${pluginPath}":`, error.message);
+        }
+    }
+}
+//# sourceMappingURL=loader.js.map

package/dist/core/plugins/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../../src/core/plugins/loader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAElE,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAAY,EAAE,WAAqB;IACnE,MAAM,OAAO,GAA0B;QACrC,uBAAuB,CAAC,IAAI,EAAE,QAAQ;YACpC,uBAAuB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAC1C,CAAC;QACD,eAAe,CAAC,cAAc;YAC5B,cAAc,CAAC,OAAO,CAAC,CAAC;QAC1B,CAAC;KACF,CAAC;IAEF,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;QACrC,IAAI,CAAC;YACH,IAAI,YAAY,GAAG,UAAU,CAAC;YAC9B,IAAI,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC9D,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;YAC1C,CAAC;YAED,oDAAoD;YACpD,MAAM,OAAO,GAAG,YAAY,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,WAAW,YAAY,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,CAAC;YAClH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,CAAC;YACrC,MAAM,MAAM,GAAoB,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,MAAM,CAAC;YAEhE,IAAI,MAAM,IAAI,OAAO,MAAM,CAAC,QAAQ,KAAK,UAAU,EAAE,CAAC;gBACpD,MAAM,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YACjC,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,IAAI,CAAC,uBAAuB,UAAU,4CAA4C,CAAC,CAAC;YAC9F,CAAC;QACH,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,OAAO,CAAC,KAAK,CAAC,0BAA0B,UAAU,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;QACzE,CAAC;IACH,CAAC;AACH,CAAC"}