@kaitranntt/ccs 8.4.0-dev.10 → 8.4.0-dev.12

package/dist/management/shared-manager/project-memory-sync.js

@@ -0,0 +1,113 @@
+"use strict";
+/**
+ * SharedManager - per-project memory directory synchronization.
+ *
+ * Extracted from project-context-sync.ts to keep each sync concern under
+ * the 400 LOC target. Owns the layout migration from per-instance
+ * projects/<project>/memory/ into the canonical shared memory root at
+ * ~/.ccs/shared/memory/<project>/.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.syncProjectMemories = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const ui_1 = require("../../utils/ui");
+const fs_helpers_1 = require("./fs-helpers");
+const symlink_helpers_1 = require("./symlink-helpers");
+/**
+ * Ensure all project memory directories for an instance are shared.
+ *
+ * Source layout (isolated):
+ *   ~/.ccs/instances/<profile>/projects/<project>/memory/
+ *
+ * Shared layout (canonical):
+ *   ~/.ccs/shared/memory/<project>/
+ */
+async function syncProjectMemories(roots, instancePath, deps) {
+    const projectsDir = path.join(instancePath, 'projects');
+    if (!(await (0, fs_helpers_1.pathExists)(projectsDir))) {
+        return;
+    }
+    await (0, fs_helpers_1.ensureDirectory)(roots.sharedDir);
+    const sharedMemoryRoot = path.join(roots.sharedDir, 'memory');
+    await (0, fs_helpers_1.ensureDirectory)(sharedMemoryRoot);
+    let projectEntries = [];
+    try {
+        projectEntries = await fs.promises.readdir(projectsDir, { withFileTypes: true });
+    }
+    catch (_err) {
+        return;
+    }
+    const projects = projectEntries.filter((entry) => entry.isDirectory());
+    if (projects.length === 0) {
+        return;
+    }
+    let migrated = 0;
+    let merged = 0;
+    let linked = 0;
+    const instanceName = path.basename(instancePath);
+    for (const project of projects) {
+        const projectDir = path.join(projectsDir, project.name);
+        const projectMemoryPath = path.join(projectDir, 'memory');
+        const sharedProjectMemoryPath = path.join(sharedMemoryRoot, project.name);
+        const projectMemoryStats = await (0, fs_helpers_1.getLstat)(projectMemoryPath);
+        if (!projectMemoryStats) {
+            if (await (0, symlink_helpers_1.ensureProjectMemoryLink)(projectMemoryPath, sharedProjectMemoryPath, deps)) {
+                linked++;
+            }
+            continue;
+        }
+        if (projectMemoryStats.isSymbolicLink()) {
+            if (await (0, symlink_helpers_1.isSymlinkTarget)(projectMemoryPath, sharedProjectMemoryPath)) {
+                continue;
+            }
+            await fs.promises.unlink(projectMemoryPath);
+            if (await (0, symlink_helpers_1.ensureProjectMemoryLink)(projectMemoryPath, sharedProjectMemoryPath, deps)) {
+                linked++;
+            }
+            continue;
+        }
+        if (!projectMemoryStats.isDirectory()) {
+            continue;
+        }
+        if (!(await (0, fs_helpers_1.pathExists)(sharedProjectMemoryPath))) {
+            await (0, fs_helpers_1.moveDirectory)(projectMemoryPath, sharedProjectMemoryPath);
+            migrated++;
+        }
+        else {
+            merged += await (0, symlink_helpers_1.mergeDirectoryWithConflictCopies)(projectMemoryPath, sharedProjectMemoryPath, instanceName);
+            await fs.promises.rm(projectMemoryPath, { recursive: true, force: true });
+        }
+        if (await (0, symlink_helpers_1.ensureProjectMemoryLink)(projectMemoryPath, sharedProjectMemoryPath, deps)) {
+            linked++;
+        }
+    }
+    if (migrated > 0 || merged > 0 || linked > 0) {
+        console.log((0, ui_1.ok)(`Synced shared project memory: ${migrated} migrated, ${merged} merged conflict(s), ${linked} linked`));
+    }
+}
+exports.syncProjectMemories = syncProjectMemories;
+//# sourceMappingURL=project-memory-sync.js.map

package/dist/management/shared-manager/project-memory-sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-memory-sync.js","sourceRoot":"","sources":["../../../src/management/shared-manager/project-memory-sync.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,uCAAyB;AACzB,2CAA6B;AAE7B,uCAAoC;AACpC,6CAAoF;AACpF,uDAK2B;AAG3B;;;;;;;;GAQG;AACI,KAAK,UAAU,mBAAmB,CACvC,KAAuB,EACvB,YAAoB,EACpB,IAAuB;IAEvB,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;IACxD,IAAI,CAAC,CAAC,MAAM,IAAA,uBAAU,EAAC,WAAW,CAAC,CAAC,EAAE,CAAC;QACrC,OAAO;IACT,CAAC;IAED,MAAM,IAAA,4BAAe,EAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAEvC,MAAM,gBAAgB,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAC9D,MAAM,IAAA,4BAAe,EAAC,gBAAgB,CAAC,CAAC;IAExC,IAAI,cAAc,GAAgB,EAAE,CAAC;IACrC,IAAI,CAAC;QACH,cAAc,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IACnF,CAAC;IAAC,OAAO,IAAI,EAAE,CAAC;QACd,OAAO;IACT,CAAC;IAED,MAAM,QAAQ,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;IACvE,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO;IACT,CAAC;IAED,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;IAEjD,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QACxD,MAAM,iBAAiB,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QAC1D,MAAM,uBAAuB,GAAG,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QAE1E,MAAM,kBAAkB,GAAG,MAAM,IAAA,qBAAQ,EAAC,iBAAiB,CAAC,CAAC;QAC7D,IAAI,CAAC,kBAAkB,EAAE,CAAC;YACxB,IAAI,MAAM,IAAA,yCAAuB,EAAC,iBAAiB,EAAE,uBAAuB,EAAE,IAAI,CAAC,EAAE,CAAC;gBACpF,MAAM,EAAE,CAAC;YACX,CAAC;YACD,SAAS;QACX,CAAC;QAED,IAAI,kBAAkB,CAAC,cAAc,EAAE,EAAE,CAAC;YACxC,IAAI,MAAM,IAAA,iCAAe,EAAC,iBAAiB,EAAE,uBAAuB,CAAC,EAAE,CAAC;gBACtE,SAAS;YACX,CAAC;YAED,MAAM,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;YAC5C,IAAI,MAAM,IAAA,yCAAuB,EAAC,iBAAiB,EAAE,uBAAuB,EAAE,IAAI,CAAC,EAAE,CAAC;gBACpF,MAAM,EAAE,CAAC;YACX,CAAC;YACD,SAAS;QACX,CAAC;QAED,IAAI,CAAC,kBAAkB,CAAC,WAAW,EAAE,EAAE,CAAC;YACtC,SAAS;QACX,CAAC;QAED,IAAI,CAAC,CAAC,MAAM,IAAA,uBAAU,EAAC,uBAAuB,CAAC,CAAC,EAAE,CAAC;YACjD,MAAM,IAAA,0BAAa,EAAC,iBAAiB,EAAE,uBAAuB,CAAC,CAAC;YAChE,QAAQ,EAAE,CAAC;QACb,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,MAAM,IAAA,kDAAgC,EAC9C,iBAAiB,EACjB,uBAAuB,EACvB,YAAY,CACb,CAAC;YACF,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,iBAAiB,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5E,CAAC;QAED,IAAI,MAAM,IAAA,yCAAuB,EAAC,iBAAiB,EAAE,uBAAuB,EAAE,IAAI,CAAC,EAAE,CAAC;YACpF,MAAM,EAAE,CAAC;QACX,CAAC;IACH,CAAC;IAED,IAAI,QAAQ,GAAG,CAAC,IAAI,MAAM,GAAG,CAAC,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7C,OAAO,CAAC,GAAG,CACT,IAAA,OAAE,EACA,iCAAiC,QAAQ,cAAc,MAAM,wBAAwB,MAAM,SAAS,CACrG,CACF,CAAC;IACJ,CAAC;AACH,CAAC;AArFD,kDAqFC"}

package/dist/management/shared-manager/shared-dir-linker.d.ts

@@ -0,0 +1,41 @@
+/**
+ * SharedManager - shared directory linking entrypoints.
+ *
+ * Extracted from the original monolithic shared-manager.ts. Owns the
+ * creation of the ~/.ccs/shared/* symlinks pointing at ~/.claude/* and
+ * the per-instance links for commands/skills/agents/plugins/settings.
+ *
+ * Plugin-layout internals (the four functions that operate on the plugins/
+ * subtree) live in plugin-layout-internals.ts. This file keeps only the
+ * high-level entrypoints and circular-symlink detection so each file stays
+ * focused and under the 400 LOC target.
+ *
+ * These functions take an explicit roots object so they remain decoupled
+ * from SharedManager instance state.
+ */
+import type { PluginMetadataRoots } from './plugin-metadata-normalizer';
+/**
+ * Roots for the shared-dir linker. Reuses PluginMetadataRoots because the
+ * linker operates on the same three roots.
+ */
+export type LinkerRoots = PluginMetadataRoots;
+/**
+ * Detect a circular symlink before creation. A symlink is circular when its
+ * target (raw or canonical) points back inside the shared root.
+ */
+export declare function detectCircularSymlink(target: string, sharedDir: string): boolean;
+/**
+ * Ensure shared directories exist as symlinks to ~/.claude/ and that the
+ * plugin layout default directories and registry files are present.
+ */
+export declare function ensureSharedDirectories(roots: LinkerRoots): void;
+/**
+ * Link shared directories into a specific instance path.
+ */
+export declare function linkSharedDirectories(roots: LinkerRoots, instancePath: string): void;
+/**
+ * Detach shared-directory symlinks from an instance, removing only entries
+ * that point back at the shared root.
+ */
+export declare function detachSharedDirectories(roots: LinkerRoots, instancePath: string): void;
+//# sourceMappingURL=shared-dir-linker.d.ts.map

package/dist/management/shared-manager/shared-dir-linker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared-dir-linker.d.ts","sourceRoot":"","sources":["../../../src/management/shared-manager/shared-dir-linker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAcH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAYxE;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,mBAAmB,CAAC;AAE9C;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAsChF;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAuEhE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,CAwCpF;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,CAyBtF"}

package/dist/management/shared-manager/shared-dir-linker.js

@@ -0,0 +1,227 @@
+"use strict";
+/**
+ * SharedManager - shared directory linking entrypoints.
+ *
+ * Extracted from the original monolithic shared-manager.ts. Owns the
+ * creation of the ~/.ccs/shared/* symlinks pointing at ~/.claude/* and
+ * the per-instance links for commands/skills/agents/plugins/settings.
+ *
+ * Plugin-layout internals (the four functions that operate on the plugins/
+ * subtree) live in plugin-layout-internals.ts. This file keeps only the
+ * high-level entrypoints and circular-symlink detection so each file stays
+ * focused and under the 400 LOC target.
+ *
+ * These functions take an explicit roots object so they remain decoupled
+ * from SharedManager instance state.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detachSharedDirectories = exports.linkSharedDirectories = exports.ensureSharedDirectories = exports.detectCircularSymlink = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const ui_1 = require("../../utils/ui");
+const fs_helpers_1 = require("./fs-helpers");
+const plugin_metadata_normalizer_1 = require("./plugin-metadata-normalizer");
+const plugin_layout_internals_1 = require("./plugin-layout-internals");
+const types_1 = require("./types");
+/**
+ * Detect a circular symlink before creation. A symlink is circular when its
+ * target (raw or canonical) points back inside the shared root.
+ */
+function detectCircularSymlink(target, sharedDir) {
+    try {
+        const stats = fs.lstatSync(target);
+        if (!stats.isSymbolicLink()) {
+            return false;
+        }
+        const targetLink = fs.readlinkSync(target);
+        const resolvedTarget = path.resolve(path.dirname(target), targetLink);
+        const sharedDirPath = path.resolve(sharedDir);
+        // A raw target path pointing back into ~/.ccs/shared is already unsafe.
+        // Re-pointing ~/.ccs/shared/* to ~/.claude/* would turn it into a real
+        // loop, even if the current ~/.ccs/shared entry ultimately resolves to
+        // an external path.
+        if ((0, fs_helpers_1.isPathWithinDirectory)(resolvedTarget, sharedDirPath)) {
+            console.log((0, ui_1.warn)(`Circular symlink detected: ${target} → ${resolvedTarget}`));
+            return true;
+        }
+        // Only treat targets inside the managed shared root as circular.
+        // Existing shared symlinks may already resolve through ~/.claude/ to an
+        // external repo, which is a supported upgrade path rather than a loop.
+        const sharedDirCanonical = (0, fs_helpers_1.resolveCanonicalPath)(sharedDirPath);
+        const canonicalResolvedTarget = (0, fs_helpers_1.resolveCanonicalPath)(resolvedTarget);
+        if ((0, fs_helpers_1.isPathWithinDirectory)(canonicalResolvedTarget, sharedDirCanonical)) {
+            console.log((0, ui_1.warn)(`Circular symlink detected: ${target} → ${resolvedTarget}`));
+            return true;
+        }
+    }
+    catch (err) {
+        if (err.code === 'ENOENT') {
+            return false;
+        }
+        throw err;
+    }
+    return false;
+}
+exports.detectCircularSymlink = detectCircularSymlink;
+/**
+ * Ensure shared directories exist as symlinks to ~/.claude/ and that the
+ * plugin layout default directories and registry files are present.
+ */
+function ensureSharedDirectories(roots) {
+    const claudeDir = roots.claudeDir;
+    const sharedDir = roots.sharedDir;
+    if (!(0, fs_helpers_1.getLstatSync)(claudeDir)) {
+        console.log((0, ui_1.info)('Creating ~/.claude/ directory structure'));
+        fs.mkdirSync(claudeDir, { recursive: true, mode: 0o700 });
+    }
+    if (!(0, fs_helpers_1.getLstatSync)(sharedDir)) {
+        fs.mkdirSync(sharedDir, { recursive: true, mode: 0o700 });
+    }
+    (0, plugin_layout_internals_1.ensureSharedPluginLayoutDefaults)(claudeDir);
+    for (const item of types_1.SHARED_ITEMS) {
+        const claudePath = path.join(claudeDir, item.name);
+        const sharedPath = path.join(sharedDir, item.name);
+        if (!(0, fs_helpers_1.getLstatSync)(claudePath)) {
+            if (item.type === 'directory') {
+                fs.mkdirSync(claudePath, { recursive: true, mode: 0o700 });
+            }
+            else if (item.type === 'file') {
+                fs.writeFileSync(claudePath, JSON.stringify({}, null, 2), 'utf8');
+            }
+        }
+        if (detectCircularSymlink(claudePath, sharedDir)) {
+            console.log((0, ui_1.warn)(`Skipping ${item.name}: circular symlink detected`));
+            continue;
+        }
+        if ((0, fs_helpers_1.getLstatSync)(sharedPath)) {
+            try {
+                const stats = fs.lstatSync(sharedPath);
+                if (stats.isSymbolicLink()) {
+                    const currentTarget = fs.readlinkSync(sharedPath);
+                    const resolvedTarget = path.resolve(path.dirname(sharedPath), currentTarget);
+                    if (resolvedTarget === claudePath) {
+                        continue;
+                    }
+                }
+            }
+            catch (_err) {
+                // Continue to recreate
+            }
+            if (item.type === 'directory') {
+                fs.rmSync(sharedPath, { recursive: true, force: true });
+            }
+            else {
+                fs.unlinkSync(sharedPath);
+            }
+        }
+        try {
+            const symlinkType = item.type === 'directory' ? 'dir' : 'file';
+            fs.symlinkSync(claudePath, sharedPath, symlinkType);
+        }
+        catch (_err) {
+            if (process.platform === 'win32') {
+                if (item.type === 'directory') {
+                    (0, fs_helpers_1.copyDirectoryFallback)(claudePath, sharedPath);
+                }
+                else if (item.type === 'file') {
+                    fs.copyFileSync(claudePath, sharedPath);
+                }
+                console.log((0, ui_1.warn)(`Symlink failed for ${item.name}, copied instead (enable Developer Mode)`));
+            }
+            else {
+                throw _err;
+            }
+        }
+    }
+}
+exports.ensureSharedDirectories = ensureSharedDirectories;
+/**
+ * Link shared directories into a specific instance path.
+ */
+function linkSharedDirectories(roots, instancePath) {
+    ensureSharedDirectories(roots);
+    const sharedDir = roots.sharedDir;
+    for (const item of types_1.SHARED_ITEMS) {
+        if (item.name === 'plugins') {
+            (0, plugin_layout_internals_1.linkInstancePlugins)(roots, instancePath);
+            continue;
+        }
+        const linkPath = path.join(instancePath, item.name);
+        const targetPath = path.join(sharedDir, item.name);
+        (0, fs_helpers_1.removeExistingPath)(linkPath, item.type);
+        try {
+            const symlinkType = item.type === 'directory' ? 'dir' : 'file';
+            fs.symlinkSync(targetPath, linkPath, symlinkType);
+        }
+        catch (_err) {
+            if (process.platform === 'win32') {
+                if (item.type === 'directory') {
+                    (0, fs_helpers_1.copyDirectoryFallback)(targetPath, linkPath);
+                }
+                else if (item.type === 'file') {
+                    fs.copyFileSync(targetPath, linkPath);
+                }
+                console.log((0, ui_1.warn)(`Symlink failed for ${item.name}, copied instead (enable Developer Mode)`));
+            }
+            else {
+                throw _err;
+            }
+        }
+    }
+    // Preserve original behavior: linkSharedDirectories always concludes by
+    // normalizing plugin + marketplace metadata for the freshly linked
+    // instance. migrateFromV311 relies on this side effect.
+    (0, plugin_metadata_normalizer_1.normalizePluginRegistryPaths)(roots, instancePath);
+    (0, plugin_metadata_normalizer_1.normalizeMarketplaceRegistryPaths)(roots, instancePath);
+}
+exports.linkSharedDirectories = linkSharedDirectories;
+/**
+ * Detach shared-directory symlinks from an instance, removing only entries
+ * that point back at the shared root.
+ */
+function detachSharedDirectories(roots, instancePath) {
+    ensureSharedDirectories(roots);
+    const sharedDir = roots.sharedDir;
+    for (const item of types_1.SHARED_ITEMS) {
+        const managedPath = path.join(instancePath, item.name);
+        if (!fs.existsSync(managedPath)) {
+            continue;
+        }
+        if (item.name === 'plugins') {
+            (0, plugin_layout_internals_1.detachManagedPluginLayout)(roots, instancePath);
+            continue;
+        }
+        const stats = fs.lstatSync(managedPath);
+        if (!stats.isSymbolicLink()) {
+            continue;
+        }
+        if ((0, fs_helpers_1.symlinkPointsTo)(managedPath, path.join(sharedDir, item.name))) {
+            (0, fs_helpers_1.removeExistingPath)(managedPath, item.type);
+        }
+    }
+}
+exports.detachSharedDirectories = detachSharedDirectories;
+//# sourceMappingURL=shared-dir-linker.js.map

package/dist/management/shared-manager/shared-dir-linker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared-dir-linker.js","sourceRoot":"","sources":["../../../src/management/shared-manager/shared-dir-linker.ts"],"names":[],"mappings":"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"}

package/dist/management/shared-manager/symlink-helpers.d.ts

@@ -0,0 +1,61 @@
+/**
+ * SharedManager - async symlink and merge helpers.
+ *
+ * Extracted from the original monolithic shared-manager.ts. These functions
+ * handle the cross-platform symlink + recursive merge primitives that the
+ * project-context-sync and project-memory flows build on.
+ *
+ * Logging is dependency-injected via the SymlinkHelperDeps interface so this
+ * module stays free of imports from the UI layer. The orchestrator class is
+ * responsible for supplying `warn` from `../utils/ui`.
+ */
+/**
+ * Dependencies that the orchestrator (SharedManager) must supply to the
+ * symlink helpers. Injected rather than imported so this module has no
+ * coupling to the UI layer.
+ */
+export interface SymlinkHelperDeps {
+    warn: (message: string) => string;
+}
+/**
+ * Check whether a symlink points at an expected target. Returns false on any
+ * IO error or when the link is not a symlink.
+ */
+export declare function isSymlinkTarget(linkPath: string, expectedTarget: string): Promise<boolean>;
+/**
+ * Resolve a symlink to its absolute target path. Returns null on failure.
+ */
+export declare function resolveSymlinkTargetPath(linkPath: string): Promise<string | null>;
+/**
+ * Create a symlink from linkPath to targetPath, falling back to a recursive
+ * copy on Windows when symlink creation fails.
+ */
+export declare function linkDirectoryWithFallback(targetPath: string, linkPath: string, deps: SymlinkHelperDeps): Promise<void>;
+/**
+ * Ensure a symlink from linkPath to targetPath exists, creating the target
+ * directory first if needed. Returns true when a new link/copy was created
+ * or an existing incorrect link was replaced.
+ */
+export declare function ensureProjectMemoryLink(linkPath: string, targetPath: string, deps: SymlinkHelperDeps): Promise<boolean>;
+/**
+ * Merge sourceDir into targetDir recursively. On file conflicts the target
+ * is preserved and the source file is copied as
+ * "<name>.migrated-from-<instance>[-N]" to avoid data loss. Returns the
+ * number of conflict copies produced.
+ */
+export declare function mergeDirectoryWithConflictCopies(sourceDir: string, targetDir: string, instanceName: string): Promise<number>;
+/**
+ * Migrate legacy per-project memory symlinks that point into the shared
+ * memory root back to instance-local directories, preserving data via
+ * conflict-copy merge.
+ */
+export declare function detachLegacySharedMemoryLinks(projectsPath: string, instanceName: string, sharedDir: string): Promise<void>;
+/**
+ * Guard project merge operations to known CCS-managed roots only.
+ */
+export declare function isSafeProjectsMergeSource(sourcePath: string, instanceName: string, sharedDir: string, instancesDir: string): boolean;
+/**
+ * Guard advanced continuity merge operations to known CCS-managed roots only.
+ */
+export declare function isSafeContinuityMergeSource(sourcePath: string, instanceName: string, artifactName: string, sharedDir: string, instancesDir: string): boolean;
+//# sourceMappingURL=symlink-helpers.d.ts.map

package/dist/management/shared-manager/symlink-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"symlink-helpers.d.ts","sourceRoot":"","sources":["../../../src/management/shared-manager/symlink-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAeH;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC;CACnC;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAchG;AAED;;GAEG;AACH,wBAAsB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAOvF;AAED;;;GAGG;AACH,wBAAsB,yBAAyB,CAC7C,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,iBAAiB,GACtB,OAAO,CAAC,IAAI,CAAC,CAkBf;AAED;;;;GAIG;AACH,wBAAsB,uBAAuB,CAC3C,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,iBAAiB,GACtB,OAAO,CAAC,OAAO,CAAC,CAyClB;AAED;;;;;GAKG;AACH,wBAAsB,gCAAgC,CACpD,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,CAAC,CAgCjB;AAED;;;;GAIG;AACH,wBAAsB,6BAA6B,CACjD,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CA6Cf;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,GACnB,OAAO,CAWT;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,GACnB,OAAO,CAmBT"}