@dezkareid/ai-context-sync 1.1.0 → 1.2.0

package/dist/engine.js

@@ -16,8 +16,9 @@ class SyncEngine {
         new gemini_js_1.GeminiStrategy(),
         new gemini_md_js_1.GeminiMdStrategy()
     ];
-    async sync(projectRoot, selectedStrategies) {
+    async sync(projectRoot, selectedStrategies, targetDir) {
         const agentsPath = path_1.default.join(projectRoot, constants_js_1.AGENTS_FILENAME);
+        const outputDir = targetDir ?? projectRoot;
         if (!(await fs_extra_1.default.pathExists(agentsPath))) {
             throw new Error(`${constants_js_1.AGENTS_FILENAME} not found in ${projectRoot}`);
         }
@@ -42,7 +43,7 @@ class SyncEngine {
         }
         for (const strategy of strategiesToRun) {
             console.log(`Syncing for ${strategy.name}...`);
-            await strategy.sync(context, projectRoot);
+            await strategy.sync(context, projectRoot, outputDir);
         }
     }
 }

package/dist/engine.test.js

@@ -89,4 +89,62 @@ const os_1 = __importDefault(require("os"));
         await fs_extra_1.default.writeFile(agentsPath, '# Agent Context');
         await (0, vitest_1.expect)(engine.sync(tempDir, 'invalid')).rejects.toThrow('No valid strategies found for: invalid. Available strategies: claude, gemini, gemini-md');
     });
+    (0, vitest_1.describe)('targetDir option', () => {
+        let targetDir;
+        (0, vitest_1.beforeEach)(async () => {
+            targetDir = await fs_extra_1.default.mkdtemp(path_1.default.join(os_1.default.tmpdir(), 'sync-engine-target-'));
+        });
+        (0, vitest_1.afterEach)(async () => {
+            await fs_extra_1.default.remove(targetDir);
+        });
+        (0, vitest_1.it)('should write synced files to targetDir instead of projectRoot', async () => {
+            const engine = new engine_js_1.SyncEngine();
+            const agentsPath = path_1.default.join(tempDir, constants_js_1.AGENTS_FILENAME);
+            await fs_extra_1.default.writeFile(agentsPath, '# Agent Context');
+            await engine.sync(tempDir, 'claude', targetDir);
+            // File should be in targetDir
+            const claudeInTarget = path_1.default.join(targetDir, 'CLAUDE.md');
+            (0, vitest_1.expect)(await fs_extra_1.default.pathExists(claudeInTarget)).toBe(true);
+            // File should NOT be in projectRoot (tempDir)
+            const claudeInSource = path_1.default.join(tempDir, 'CLAUDE.md');
+            (0, vitest_1.expect)(await fs_extra_1.default.pathExists(claudeInSource)).toBe(false);
+        });
+        (0, vitest_1.it)('should create symlink in targetDir pointing back to projectRoot AGENTS.md', async () => {
+            const engine = new engine_js_1.SyncEngine();
+            const agentsPath = path_1.default.join(tempDir, constants_js_1.AGENTS_FILENAME);
+            await fs_extra_1.default.writeFile(agentsPath, '# Agent Context');
+            await engine.sync(tempDir, 'claude', targetDir);
+            const claudePath = path_1.default.join(targetDir, 'CLAUDE.md');
+            const stats = await fs_extra_1.default.lstat(claudePath);
+            (0, vitest_1.expect)(stats.isSymbolicLink()).toBe(true);
+            // The symlink should resolve to the AGENTS.md in projectRoot
+            const resolvedPath = await fs_extra_1.default.realpath(claudePath);
+            const expectedPath = await fs_extra_1.default.realpath(agentsPath);
+            (0, vitest_1.expect)(resolvedPath).toBe(expectedPath);
+        });
+        (0, vitest_1.it)('should write .gemini/settings.json to targetDir when targetDir is specified', async () => {
+            const engine = new engine_js_1.SyncEngine();
+            const agentsPath = path_1.default.join(tempDir, constants_js_1.AGENTS_FILENAME);
+            await fs_extra_1.default.writeFile(agentsPath, '# Agent Context');
+            await engine.sync(tempDir, 'gemini', targetDir);
+            // Settings should be in targetDir
+            const settingsInTarget = path_1.default.join(targetDir, '.gemini', 'settings.json');
+            (0, vitest_1.expect)(await fs_extra_1.default.pathExists(settingsInTarget)).toBe(true);
+            // Settings should NOT be in projectRoot
+            const settingsInSource = path_1.default.join(tempDir, '.gemini', 'settings.json');
+            (0, vitest_1.expect)(await fs_extra_1.default.pathExists(settingsInSource)).toBe(false);
+            // The stored path should be relative from targetDir to AGENTS.md
+            const settings = await fs_extra_1.default.readJson(settingsInTarget);
+            const expectedRelPath = path_1.default.relative(targetDir, agentsPath);
+            (0, vitest_1.expect)(settings.context.fileName).toContain(expectedRelPath);
+        });
+        (0, vitest_1.it)('should use projectRoot as targetDir when targetDir is not specified', async () => {
+            const engine = new engine_js_1.SyncEngine();
+            const agentsPath = path_1.default.join(tempDir, constants_js_1.AGENTS_FILENAME);
+            await fs_extra_1.default.writeFile(agentsPath, '# Agent Context');
+            await engine.sync(tempDir, 'claude');
+            const claudeInSource = path_1.default.join(tempDir, 'CLAUDE.md');
+            (0, vitest_1.expect)(await fs_extra_1.default.pathExists(claudeInSource)).toBe(true);
+        });
+    });
 });

package/dist/index.js

@@ -18,12 +18,14 @@ program
 program
     .command('sync')
     .description('Synchronize context files from AGENTS.md')
-    .option('-d, --dir <path>', 'Project directory', process.cwd())
+    .option('-d, --dir <path>', 'Project directory (where AGENTS.md lives)', process.cwd())
+    .option('-t, --target-dir <path>', 'Target directory where synced files will be written (defaults to --dir)')
     .option('-s, --strategy <strategy>', 'Sync strategy (claude, gemini, all, or comma-separated list)')
     .option('--skip-config', 'Avoid reading/creating the config file', false)
     .action(async (options) => {
     try {
         const projectRoot = path_1.default.resolve(options.dir);
+        const targetDir = options.targetDir ? path_1.default.resolve(options.targetDir) : projectRoot;
         const configPath = path_1.default.join(projectRoot, constants_js_1.CONFIG_FILENAME);
         let strategy = options.strategy;
         // 1. If no strategy provided, try to read from config
@@ -70,7 +72,7 @@ program
             await fs_extra_1.default.writeJson(configPath, { strategies: strategy }, { spaces: 2 });
         }
         const engine = new engine_js_1.SyncEngine();
-        await engine.sync(projectRoot, strategy);
+        await engine.sync(projectRoot, strategy, targetDir);
         const strategyMsg = Array.isArray(strategy) ? strategy.join(', ') : strategy;
         console.log(`Successfully synchronized context files using "${strategyMsg}"!`);
     }

package/dist/strategies/gemini.js

@@ -9,9 +9,13 @@ const fs_extra_1 = __importDefault(require("fs-extra"));
 const path_1 = __importDefault(require("path"));
 class GeminiStrategy {
     name = 'gemini';
-    async sync(_context, projectRoot) {
-        const geminiDir = path_1.default.join(projectRoot, '.gemini');
+    async sync(_context, projectRoot, targetDir) {
+        const outputDir = targetDir ?? projectRoot;
+        const geminiDir = path_1.default.join(outputDir, '.gemini');
         const settingsPath = path_1.default.join(geminiDir, 'settings.json');
+        // Compute the path to AGENTS.md relative to the target .gemini directory
+        const agentsAbsPath = path_1.default.join(projectRoot, index_js_1.AGENTS_FILE);
+        const agentsRelativePath = path_1.default.relative(outputDir, agentsAbsPath);
         await fs_extra_1.default.ensureDir(geminiDir);
         let settings = {};
         let exists = false;
@@ -30,19 +34,19 @@ class GeminiStrategy {
         const currentFiles = settings.context.fileName;
         let modified = false;
         if (Array.isArray(currentFiles)) {
-            if (!currentFiles.includes(index_js_1.AGENTS_FILE)) {
-                settings.context.fileName = [...currentFiles, index_js_1.AGENTS_FILE];
+            if (!currentFiles.includes(agentsRelativePath)) {
+                settings.context.fileName = [...currentFiles, agentsRelativePath];
                 modified = true;
             }
         }
         else if (typeof currentFiles === 'string') {
-            if (currentFiles !== index_js_1.AGENTS_FILE) {
-                settings.context.fileName = [currentFiles, index_js_1.AGENTS_FILE];
+            if (currentFiles !== agentsRelativePath) {
+                settings.context.fileName = [currentFiles, agentsRelativePath];
                 modified = true;
             }
         }
         else {
-            settings.context.fileName = [index_js_1.AGENTS_FILE];
+            settings.context.fileName = [agentsRelativePath];
             modified = true;
         }
         if (modified || !exists) {

package/dist/strategies/symlink.js

@@ -8,23 +8,27 @@ const index_js_1 = require("./index.js");
 const fs_extra_1 = __importDefault(require("fs-extra"));
 const path_1 = __importDefault(require("path"));
 class SymlinkStrategy {
-    async sync(_context, projectRoot) {
-        const targetPath = path_1.default.join(projectRoot, this.targetFilename);
+    async sync(_context, projectRoot, targetDir) {
+        const outputDir = targetDir ?? projectRoot;
+        const targetPath = path_1.default.join(outputDir, this.targetFilename);
+        // Compute the symlink value: relative path from outputDir to the AGENTS.md in projectRoot
+        const agentsAbsPath = path_1.default.join(projectRoot, index_js_1.AGENTS_FILE);
+        const symlinkTarget = path_1.default.relative(outputDir, agentsAbsPath);
         // Check if it exists and what type it is
         if (await fs_extra_1.default.pathExists(targetPath)) {
             const stats = await fs_extra_1.default.lstat(targetPath);
             if (stats.isSymbolicLink()) {
-                const target = await fs_extra_1.default.readlink(targetPath);
-                if (target === index_js_1.AGENTS_FILE) {
-                    // Already points to AGENTS.md, nothing to do
+                const existingTarget = await fs_extra_1.default.readlink(targetPath);
+                if (existingTarget === symlinkTarget) {
+                    // Already points to the correct location, nothing to do
                     return;
                 }
             }
             // If it's a file or a link to somewhere else, remove it
             await fs_extra_1.default.remove(targetPath);
         }
-        // Create relative symlink
-        await fs_extra_1.default.ensureSymlink(index_js_1.AGENTS_FILE, targetPath);
+        // Create symlink pointing to AGENTS.md
+        await fs_extra_1.default.ensureSymlink(symlinkTarget, targetPath);
     }
 }
 exports.SymlinkStrategy = SymlinkStrategy;

package/dist/strategies/symlink.test.js

@@ -62,4 +62,40 @@ class TestSymlinkStrategy extends symlink_js_1.SymlinkStrategy {
         const target = await fs_extra_1.default.readlink(targetPath);
         (0, vitest_1.expect)(target).toBe(index_js_1.AGENTS_FILE);
     });
+    (0, vitest_1.describe)('targetDir option', () => {
+        let targetDir;
+        (0, vitest_1.beforeEach)(async () => {
+            targetDir = await fs_extra_1.default.mkdtemp(path_1.default.join(os_1.default.tmpdir(), 'symlink-strategy-target-'));
+        });
+        (0, vitest_1.afterEach)(async () => {
+            await fs_extra_1.default.remove(targetDir);
+        });
+        (0, vitest_1.it)('should create symlink in targetDir pointing to AGENTS.md in projectRoot', async () => {
+            await strategy.sync('', tempDir, targetDir);
+            const targetPath = path_1.default.join(targetDir, 'TEST.md');
+            const stats = await fs_extra_1.default.lstat(targetPath);
+            (0, vitest_1.expect)(stats.isSymbolicLink()).toBe(true);
+            // Symlink should resolve to the actual AGENTS.md in projectRoot
+            const resolvedPath = await fs_extra_1.default.realpath(targetPath);
+            const expectedPath = await fs_extra_1.default.realpath(path_1.default.join(tempDir, index_js_1.AGENTS_FILE));
+            (0, vitest_1.expect)(resolvedPath).toBe(expectedPath);
+        });
+        (0, vitest_1.it)('should not recreate symlink if it already points to the correct location', async () => {
+            const targetPath = path_1.default.join(targetDir, 'TEST.md');
+            const agentsAbsPath = path_1.default.join(tempDir, index_js_1.AGENTS_FILE);
+            const symlinkTarget = path_1.default.relative(targetDir, agentsAbsPath);
+            await fs_extra_1.default.ensureSymlink(symlinkTarget, targetPath);
+            const initialStats = await fs_extra_1.default.lstat(targetPath);
+            await strategy.sync('', tempDir, targetDir);
+            const finalStats = await fs_extra_1.default.lstat(targetPath);
+            (0, vitest_1.expect)(finalStats.mtimeMs).toBe(initialStats.mtimeMs);
+        });
+        (0, vitest_1.it)('should write to projectRoot when targetDir is not provided', async () => {
+            await strategy.sync('', tempDir);
+            const targetPath = path_1.default.join(tempDir, 'TEST.md');
+            (0, vitest_1.expect)(await fs_extra_1.default.pathExists(targetPath)).toBe(true);
+            const targetPathInTargetDir = path_1.default.join(targetDir, 'TEST.md');
+            (0, vitest_1.expect)(await fs_extra_1.default.pathExists(targetPathInTargetDir)).toBe(false);
+        });
+    });
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dezkareid/ai-context-sync",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "CLI utility to synchronize AI agent context files from AGENTS.md",
   "main": "dist/index.js",
   "bin": {