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

package/dist/management/shared-manager/orchestrator.d.ts

@@ -0,0 +1,87 @@
+/**
+ * SharedManager orchestrator.
+ *
+ * Thin coordinator over the focused submodules under shared-manager/. The
+ * class is responsible ONLY for:
+ *   1. Resolving filesystem roots (homeDir, ccsDir, sharedDir, claudeDir,
+ *      instancesDir) and the plugin-layout lock.
+ *   2. Forwarding every public method to the appropriate extracted helper,
+ *      passing those roots explicitly.
+ *
+ * All behavior, signatures, and structured logging live in the submodules
+ * and are preserved exactly. This file deliberately contains no logic of
+ * its own.
+ */
+import type { AccountContextPolicy } from '../../auth/account-context';
+/**
+ * SharedManager Class
+ *
+ * Manages symlinked shared directories for CCS. See submodule docs for the
+ * detailed behavior of each operation.
+ */
+declare class SharedManager {
+    private readonly homeDir;
+    private readonly sharedDir;
+    private readonly claudeDir;
+    private readonly instancesDir;
+    private readonly pluginLayoutLock;
+    constructor();
+    private get roots();
+    private get symlinkDeps();
+    /**
+     * Ensure shared directories exist as symlinks to ~/.claude/. Creates
+     * ~/.claude/ structure if missing.
+     */
+    ensureSharedDirectories(): void;
+    /**
+     * Link shared directories into an instance.
+     */
+    linkSharedDirectories(instancePath: string): void;
+    /**
+     * Detach shared-directory symlinks from an instance.
+     */
+    detachSharedDirectories(instancePath: string): void;
+    /**
+     * Sync project workspace context based on account policy.
+     */
+    syncProjectContext(instancePath: string, policy: AccountContextPolicy): Promise<void>;
+    /**
+     * Sync advanced continuity artifacts for shared deeper mode.
+     */
+    syncAdvancedContinuityArtifacts(instancePath: string, policy: AccountContextPolicy): Promise<void>;
+    /**
+     * Ensure all project memory directories for an instance are shared.
+     */
+    syncProjectMemories(instancePath: string): Promise<void>;
+    /**
+     * Normalize plugin metadata and reconcile marketplace metadata for the
+     * active config dir.
+     */
+    normalizeSharedPluginMetadataPaths(configDir?: string): void;
+    /**
+     * Same as normalizeSharedPluginMetadataPaths but guarded by the
+     * plugin-layout named lock so concurrent instances cannot interleave.
+     */
+    normalizeSharedPluginMetadataPathsLocked(configDir?: string): void;
+    /**
+     * Normalize installed_plugins.json paths to canonical ~/.claude/ paths.
+     */
+    normalizePluginRegistryPaths(configDir?: string): void;
+    /**
+     * Reconcile marketplace registry content into the active config dir and
+     * keep the global ~/.claude copy up to date.
+     */
+    normalizeMarketplaceRegistryPaths(configDir?: string): void;
+    /**
+     * Migrate from v3.1.1 (copied data in ~/.ccs/shared/) to v3.2.0 (symlinks
+     * to ~/.claude/). Runs once on upgrade.
+     */
+    migrateFromV311(): void;
+    /**
+     * Migrate existing instances from isolated to shared settings.json
+     * (v4.4+). Runs once on upgrade.
+     */
+    migrateToSharedSettings(): void;
+}
+export default SharedManager;
+//# sourceMappingURL=orchestrator.d.ts.map

package/dist/management/shared-manager/orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../../../src/management/shared-manager/orchestrator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAMH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAwBvE;;;;;GAKG;AACH,cAAM,aAAa;IACjB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAyB;;IAW1D,OAAO,KAAK,KAAK,GAMhB;IAED,OAAO,KAAK,WAAW,GAEtB;IAED;;;OAGG;IACH,uBAAuB,IAAI,IAAI;IAI/B;;OAEG;IACH,qBAAqB,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;IAIjD;;OAEG;IACH,uBAAuB,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;IAInD;;OAEG;IACG,kBAAkB,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3F;;OAEG;IACG,+BAA+B,CACnC,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,IAAI,CAAC;IAIhB;;OAEG;IACG,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI9D;;;OAGG;IACH,kCAAkC,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;IAK5D;;;OAGG;IACH,wCAAwC,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;IAMlE;;OAEG;IACH,4BAA4B,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;IAItD;;;OAGG;IACH,iCAAiC,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;IAI3D;;;OAGG;IACH,eAAe,IAAI,IAAI;IAIvB;;;OAGG;IACH,uBAAuB,IAAI,IAAI;CAGhC;AAED,eAAe,aAAa,CAAC"}

package/dist/management/shared-manager/orchestrator.js

@@ -0,0 +1,161 @@
+"use strict";
+/**
+ * SharedManager orchestrator.
+ *
+ * Thin coordinator over the focused submodules under shared-manager/. The
+ * class is responsible ONLY for:
+ *   1. Resolving filesystem roots (homeDir, ccsDir, sharedDir, claudeDir,
+ *      instancesDir) and the plugin-layout lock.
+ *   2. Forwarding every public method to the appropriate extracted helper,
+ *      passing those roots explicitly.
+ *
+ * All behavior, signatures, and structured logging live in the submodules
+ * and are preserved exactly. This file deliberately contains no logic of
+ * its own.
+ */
+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;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+const ui_1 = require("../../utils/ui");
+const config_loader_facade_1 = require("../../config/config-loader-facade");
+const profile_context_sync_lock_1 = __importDefault(require("../profile-context-sync-lock"));
+const plugin_metadata_normalizer_1 = require("./plugin-metadata-normalizer");
+const shared_dir_linker_1 = require("./shared-dir-linker");
+const project_context_sync_1 = require("./project-context-sync");
+const project_memory_sync_1 = require("./project-memory-sync");
+const migrations_1 = require("./migrations");
+/**
+ * SharedManager Class
+ *
+ * Manages symlinked shared directories for CCS. See submodule docs for the
+ * detailed behavior of each operation.
+ */
+class SharedManager {
+    constructor() {
+        this.homeDir = os.homedir();
+        const ccsDir = (0, config_loader_facade_1.getCcsDir)();
+        this.sharedDir = path.join(ccsDir, 'shared');
+        this.claudeDir = path.join(this.homeDir, '.claude');
+        this.instancesDir = path.join(ccsDir, 'instances');
+        this.pluginLayoutLock = new profile_context_sync_lock_1.default(this.instancesDir);
+    }
+    get roots() {
+        return {
+            claudeDir: this.claudeDir,
+            sharedDir: this.sharedDir,
+            instancesDir: this.instancesDir,
+        };
+    }
+    get symlinkDeps() {
+        return { warn: ui_1.warn };
+    }
+    /**
+     * Ensure shared directories exist as symlinks to ~/.claude/. Creates
+     * ~/.claude/ structure if missing.
+     */
+    ensureSharedDirectories() {
+        (0, shared_dir_linker_1.ensureSharedDirectories)(this.roots);
+    }
+    /**
+     * Link shared directories into an instance.
+     */
+    linkSharedDirectories(instancePath) {
+        (0, shared_dir_linker_1.linkSharedDirectories)(this.roots, instancePath);
+    }
+    /**
+     * Detach shared-directory symlinks from an instance.
+     */
+    detachSharedDirectories(instancePath) {
+        (0, shared_dir_linker_1.detachSharedDirectories)(this.roots, instancePath);
+    }
+    /**
+     * Sync project workspace context based on account policy.
+     */
+    async syncProjectContext(instancePath, policy) {
+        await (0, project_context_sync_1.syncProjectContext)(this.roots, instancePath, policy, this.symlinkDeps);
+    }
+    /**
+     * Sync advanced continuity artifacts for shared deeper mode.
+     */
+    async syncAdvancedContinuityArtifacts(instancePath, policy) {
+        await (0, project_context_sync_1.syncAdvancedContinuityArtifacts)(this.roots, instancePath, policy, this.symlinkDeps);
+    }
+    /**
+     * Ensure all project memory directories for an instance are shared.
+     */
+    async syncProjectMemories(instancePath) {
+        await (0, project_memory_sync_1.syncProjectMemories)(this.roots, instancePath, this.symlinkDeps);
+    }
+    /**
+     * Normalize plugin metadata and reconcile marketplace metadata for the
+     * active config dir.
+     */
+    normalizeSharedPluginMetadataPaths(configDir) {
+        this.normalizePluginRegistryPaths(configDir);
+        this.normalizeMarketplaceRegistryPaths(configDir);
+    }
+    /**
+     * Same as normalizeSharedPluginMetadataPaths but guarded by the
+     * plugin-layout named lock so concurrent instances cannot interleave.
+     */
+    normalizeSharedPluginMetadataPathsLocked(configDir) {
+        this.pluginLayoutLock.withNamedLockSync('__plugin-layout__', () => {
+            this.normalizeSharedPluginMetadataPaths(configDir);
+        });
+    }
+    /**
+     * Normalize installed_plugins.json paths to canonical ~/.claude/ paths.
+     */
+    normalizePluginRegistryPaths(configDir) {
+        (0, plugin_metadata_normalizer_1.normalizePluginRegistryPaths)(this.roots, configDir);
+    }
+    /**
+     * Reconcile marketplace registry content into the active config dir and
+     * keep the global ~/.claude copy up to date.
+     */
+    normalizeMarketplaceRegistryPaths(configDir) {
+        (0, plugin_metadata_normalizer_1.normalizeMarketplaceRegistryPaths)(this.roots, configDir);
+    }
+    /**
+     * Migrate from v3.1.1 (copied data in ~/.ccs/shared/) to v3.2.0 (symlinks
+     * to ~/.claude/). Runs once on upgrade.
+     */
+    migrateFromV311() {
+        (0, migrations_1.migrateFromV311)(this.roots);
+    }
+    /**
+     * Migrate existing instances from isolated to shared settings.json
+     * (v4.4+). Runs once on upgrade.
+     */
+    migrateToSharedSettings() {
+        (0, migrations_1.migrateToSharedSettings)(this.roots);
+    }
+}
+exports.default = SharedManager;
+//# sourceMappingURL=orchestrator.js.map

package/dist/management/shared-manager/orchestrator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.js","sourceRoot":"","sources":["../../../src/management/shared-manager/orchestrator.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;GAaG;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,uCAAyB;AACzB,2CAA6B;AAE7B,uCAAsC;AAEtC,4EAA8D;AAC9D,6FAAkE;AAElE,6EAIsC;AACtC,2DAK6B;AAC7B,iEAIgC;AAChC,+DAA4D;AAC5D,6CAAwE;AAGxE;;;;;GAKG;AACH,MAAM,aAAa;IAOjB;QACE,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,IAAA,gCAAS,GAAE,CAAC;QAC3B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QAC7C,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QACpD,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;QACnD,IAAI,CAAC,gBAAgB,GAAG,IAAI,mCAAsB,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACxE,CAAC;IAED,IAAY,KAAK;QACf,OAAO;YACL,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,YAAY,EAAE,IAAI,CAAC,YAAY;SAChC,CAAC;IACJ,CAAC;IAED,IAAY,WAAW;QACrB,OAAO,EAAE,IAAI,EAAJ,SAAI,EAAE,CAAC;IAClB,CAAC;IAED;;;OAGG;IACH,uBAAuB;QACrB,IAAA,2CAAuB,EAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACtC,CAAC;IAED;;OAEG;IACH,qBAAqB,CAAC,YAAoB;QACxC,IAAA,yCAAqB,EAAC,IAAI,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;IAClD,CAAC;IAED;;OAEG;IACH,uBAAuB,CAAC,YAAoB;QAC1C,IAAA,2CAAuB,EAAC,IAAI,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;IACpD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,kBAAkB,CAAC,YAAoB,EAAE,MAA4B;QACzE,MAAM,IAAA,yCAAkB,EAAC,IAAI,CAAC,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IAC/E,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,+BAA+B,CACnC,YAAoB,EACpB,MAA4B;QAE5B,MAAM,IAAA,sDAA+B,EAAC,IAAI,CAAC,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IAC5F,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,mBAAmB,CAAC,YAAoB;QAC5C,MAAM,IAAA,yCAAmB,EAAC,IAAI,CAAC,KAAK,EAAE,YAAY,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IACxE,CAAC;IAED;;;OAGG;IACH,kCAAkC,CAAC,SAAkB;QACnD,IAAI,CAAC,4BAA4B,CAAC,SAAS,CAAC,CAAC;QAC7C,IAAI,CAAC,iCAAiC,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;IAED;;;OAGG;IACH,wCAAwC,CAAC,SAAkB;QACzD,IAAI,CAAC,gBAAgB,CAAC,iBAAiB,CAAC,mBAAmB,EAAE,GAAG,EAAE;YAChE,IAAI,CAAC,kCAAkC,CAAC,SAAS,CAAC,CAAC;QACrD,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,4BAA4B,CAAC,SAAkB;QAC7C,IAAA,yDAA4B,EAAC,IAAI,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IACtD,CAAC;IAED;;;OAGG;IACH,iCAAiC,CAAC,SAAkB;QAClD,IAAA,8DAAiC,EAAC,IAAI,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IAC3D,CAAC;IAED;;;OAGG;IACH,eAAe;QACb,IAAA,4BAAe,EAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;IAED;;;OAGG;IACH,uBAAuB;QACrB,IAAA,oCAAuB,EAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACtC,CAAC;CACF;AAED,kBAAe,aAAa,CAAC"}

package/dist/management/shared-manager/plugin-layout-internals.d.ts

@@ -0,0 +1,42 @@
+/**
+ * SharedManager - plugin layout linking internals.
+ *
+ * Extracted from shared-dir-linker.ts to keep each file focused and under
+ * the 400 LOC target. Owns the four plugin-layout primitives:
+ *
+ *   - ensureSharedPluginLayoutDefaults: provision ~/.claude/plugins defaults
+ *   - linkInstancePlugins: link shared plugin entries into an instance
+ *   - getSharedPluginLinkItems: enumerate plugin entries to link
+ *   - detachManagedPluginLayout: reverse link + reconcile local registry
+ */
+import type { PluginMetadataRoots } from './plugin-metadata-normalizer';
+import type { SharedItem } from './types';
+/**
+ * Roots for the plugin-layout internals. Same shape as PluginMetadataRoots.
+ */
+export type PluginLayoutRoots = PluginMetadataRoots;
+/**
+ * Ensure the plugin layout default directories (cache, marketplaces) and
+ * registry files (installed_plugins.json, known_marketplaces.json) exist
+ * under ~/.claude/plugins.
+ */
+export declare function ensureSharedPluginLayoutDefaults(claudeDir: string): void;
+/**
+ * Link shared plugins directory entries into an instance, creating the
+ * instance plugins directory first if needed.
+ */
+export declare function linkInstancePlugins(roots: PluginLayoutRoots, instancePath: string): void;
+/**
+ * Build the list of plugin entries to link from the shared plugins dir.
+ * Always includes the default SHARED_PLUGIN_ENTRIES; adds any additional
+ * entries physically present on disk, skipping instance-local metadata.
+ */
+export declare function getSharedPluginLinkItems(sharedDir: string): SharedItem[];
+/**
+ * Detach managed plugin layout from an instance. Removes the symlinked
+ * plugin entries that point back at the shared plugins dir and reconciles
+ * the local marketplace registry. Removes the plugins directory entirely
+ * if it ends up empty.
+ */
+export declare function detachManagedPluginLayout(roots: PluginLayoutRoots, instancePath: string): void;
+//# sourceMappingURL=plugin-layout-internals.d.ts.map

package/dist/management/shared-manager/plugin-layout-internals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-layout-internals.d.ts","sourceRoot":"","sources":["../../../src/management/shared-manager/plugin-layout-internals.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAOH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAOxE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1C;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,mBAAmB,CAAC;AAEpD;;;;GAIG;AACH,wBAAgB,gCAAgC,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAsBxE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,CA6CxF;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,EAAE,CAgCxE;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,CAgD9F"}

package/dist/management/shared-manager/plugin-layout-internals.js

@@ -0,0 +1,192 @@
+"use strict";
+/**
+ * SharedManager - plugin layout linking internals.
+ *
+ * Extracted from shared-dir-linker.ts to keep each file focused and under
+ * the 400 LOC target. Owns the four plugin-layout primitives:
+ *
+ *   - ensureSharedPluginLayoutDefaults: provision ~/.claude/plugins defaults
+ *   - linkInstancePlugins: link shared plugin entries into an instance
+ *   - getSharedPluginLinkItems: enumerate plugin entries to link
+ *   - detachManagedPluginLayout: reverse link + reconcile local registry
+ */
+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.detachManagedPluginLayout = exports.getSharedPluginLinkItems = exports.linkInstancePlugins = exports.ensureSharedPluginLayoutDefaults = 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 types_1 = require("./types");
+/**
+ * Ensure the plugin layout default directories (cache, marketplaces) and
+ * registry files (installed_plugins.json, known_marketplaces.json) exist
+ * under ~/.claude/plugins.
+ */
+function ensureSharedPluginLayoutDefaults(claudeDir) {
+    const pluginsDir = path.join(claudeDir, 'plugins');
+    fs.mkdirSync(pluginsDir, { recursive: true, mode: 0o700 });
+    for (const entry of types_1.SHARED_PLUGIN_ENTRIES) {
+        const entryPath = path.join(pluginsDir, entry.name);
+        if (fs.existsSync(entryPath)) {
+            continue;
+        }
+        if (entry.type === 'directory') {
+            fs.mkdirSync(entryPath, { recursive: true, mode: 0o700 });
+            continue;
+        }
+        fs.writeFileSync(entryPath, types_1.DEFAULT_INSTALLED_PLUGIN_REGISTRY, 'utf8');
+    }
+    const marketplaceRegistryPath = path.join(pluginsDir, 'known_marketplaces.json');
+    if (!fs.existsSync(marketplaceRegistryPath)) {
+        fs.writeFileSync(marketplaceRegistryPath, JSON.stringify({}, null, 2), 'utf8');
+    }
+}
+exports.ensureSharedPluginLayoutDefaults = ensureSharedPluginLayoutDefaults;
+/**
+ * Link shared plugins directory entries into an instance, creating the
+ * instance plugins directory first if needed.
+ */
+function linkInstancePlugins(roots, instancePath) {
+    const linkPath = path.join(instancePath, 'plugins');
+    const targetPath = path.join(roots.sharedDir, 'plugins');
+    let linkStats = null;
+    try {
+        linkStats = fs.lstatSync(linkPath);
+    }
+    catch (err) {
+        if (err.code !== 'ENOENT') {
+            throw err;
+        }
+    }
+    if (linkStats?.isSymbolicLink() || (linkStats && !linkStats.isDirectory())) {
+        (0, fs_helpers_1.removeExistingPath)(linkPath, linkStats.isDirectory() ? 'directory' : 'file');
+    }
+    if (!linkStats || !linkStats.isDirectory()) {
+        fs.mkdirSync(linkPath, { recursive: true, mode: 0o700 });
+    }
+    for (const item of getSharedPluginLinkItems(roots.sharedDir)) {
+        const targetEntryPath = path.join(targetPath, item.name);
+        const linkEntryPath = path.join(linkPath, item.name);
+        (0, fs_helpers_1.removeExistingPath)(linkEntryPath, item.type);
+        try {
+            const symlinkType = item.type === 'directory' ? 'dir' : 'file';
+            fs.symlinkSync(targetEntryPath, linkEntryPath, symlinkType);
+        }
+        catch (_err) {
+            if (process.platform === 'win32') {
+                if (item.type === 'directory') {
+                    (0, fs_helpers_1.copyDirectoryFallback)(targetEntryPath, linkEntryPath);
+                }
+                else {
+                    fs.copyFileSync(targetEntryPath, linkEntryPath);
+                }
+                console.log((0, ui_1.warn)(`Symlink failed for plugins/${item.name}, copied instead (enable Developer Mode)`));
+            }
+            else {
+                throw _err;
+            }
+        }
+    }
+}
+exports.linkInstancePlugins = linkInstancePlugins;
+/**
+ * Build the list of plugin entries to link from the shared plugins dir.
+ * Always includes the default SHARED_PLUGIN_ENTRIES; adds any additional
+ * entries physically present on disk, skipping instance-local metadata.
+ */
+function getSharedPluginLinkItems(sharedDir) {
+    const sharedPluginsPath = path.join(sharedDir, 'plugins');
+    const items = new Map(types_1.SHARED_PLUGIN_ENTRIES.map((entry) => [entry.name, { ...entry }]));
+    for (const entry of fs.readdirSync(sharedPluginsPath, { withFileTypes: true })) {
+        if (items.has(entry.name) || types_1.INSTANCE_LOCAL_PLUGIN_METADATA_FILES.has(entry.name)) {
+            continue;
+        }
+        const entryPath = path.join(sharedPluginsPath, entry.name);
+        let stats;
+        try {
+            stats = fs.statSync(entryPath);
+        }
+        catch (err) {
+            const code = err.code;
+            console.log((0, ui_1.warn)(`Skipping plugins/${entry.name}: unable to inspect shared plugin entry${code ? ` (${code})` : ''}`));
+            continue;
+        }
+        items.set(entry.name, {
+            name: entry.name,
+            type: stats.isDirectory() ? 'directory' : 'file',
+        });
+    }
+    return [...items.values()];
+}
+exports.getSharedPluginLinkItems = getSharedPluginLinkItems;
+/**
+ * Detach managed plugin layout from an instance. Removes the symlinked
+ * plugin entries that point back at the shared plugins dir and reconciles
+ * the local marketplace registry. Removes the plugins directory entirely
+ * if it ends up empty.
+ */
+function detachManagedPluginLayout(roots, instancePath) {
+    const pluginsPath = path.join(instancePath, 'plugins');
+    if (!fs.existsSync(pluginsPath)) {
+        return;
+    }
+    const stats = fs.lstatSync(pluginsPath);
+    const sharedPluginsPath = path.join(roots.sharedDir, 'plugins');
+    if (stats.isSymbolicLink()) {
+        if ((0, fs_helpers_1.symlinkPointsTo)(pluginsPath, sharedPluginsPath)) {
+            (0, fs_helpers_1.removeExistingPath)(pluginsPath, 'directory');
+        }
+        return;
+    }
+    if (!stats.isDirectory()) {
+        return;
+    }
+    let removedManagedEntries = false;
+    for (const item of getSharedPluginLinkItems(roots.sharedDir)) {
+        const pluginEntryPath = path.join(pluginsPath, item.name);
+        if (!fs.existsSync(pluginEntryPath)) {
+            continue;
+        }
+        const entryStats = fs.lstatSync(pluginEntryPath);
+        if (!entryStats.isSymbolicLink()) {
+            continue;
+        }
+        if ((0, fs_helpers_1.symlinkPointsTo)(pluginEntryPath, path.join(sharedPluginsPath, item.name))) {
+            (0, fs_helpers_1.removeExistingPath)(pluginEntryPath, item.type);
+            removedManagedEntries = true;
+        }
+    }
+    if (!removedManagedEntries) {
+        return;
+    }
+    (0, plugin_metadata_normalizer_1.reconcileLocalMarketplaceRegistry)(roots, instancePath);
+    if (fs.readdirSync(pluginsPath).length === 0) {
+        fs.rmSync(pluginsPath, { recursive: true, force: true });
+    }
+}
+exports.detachManagedPluginLayout = detachManagedPluginLayout;
+//# sourceMappingURL=plugin-layout-internals.js.map

package/dist/management/shared-manager/plugin-layout-internals.js.map

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

package/dist/management/shared-manager/plugin-metadata-normalizer.d.ts

@@ -0,0 +1,53 @@
+/**
+ * SharedManager - plugin metadata normalization and marketplace reconciliation.
+ *
+ * Extracted from the original monolithic shared-manager.ts. These helpers
+ * normalize installed_plugins.json and known_marketplaces.json contents so
+ * plugin metadata refers to canonical ~/.claude/ paths rather than
+ * instance-specific paths, and reconcile the marketplace registry against
+ * the on-disk marketplace directories.
+ *
+ * All filesystem roots (claudeDir, sharedDir, instancesDir) are passed
+ * explicitly to keep this module stateless and testable in isolation.
+ */
+import type { SharedItem } from './types';
+/**
+ * Roots that plugin-metadata normalization operates on. The SharedManager
+ * orchestrator supplies its own private fields when constructing this
+ * object.
+ */
+export interface PluginMetadataRoots {
+    claudeDir: string;
+    sharedDir: string;
+    instancesDir: string;
+}
+/**
+ * Normalize every installed_plugins.json file reachable from the given roots
+ * so its embedded paths are canonical ~/.claude/ paths.
+ */
+export declare function normalizePluginRegistryPaths(roots: PluginMetadataRoots, configDir?: string): void;
+/**
+ * Reconcile marketplace registry content into the active config dir while
+ * keeping the global ~/.claude copy up to date for non-instance flows.
+ */
+export declare function normalizeMarketplaceRegistryPaths(roots: PluginMetadataRoots, configDir?: string): void;
+/**
+ * Discover physical marketplace directories on disk. Skips hidden dirs and
+ * Claude Code rename-dance leftovers (.staging/.bak).
+ */
+export declare function discoverMarketplaceEntries(targetConfigDir: string): Record<string, {
+    installLocation: string;
+}>;
+/**
+ * Write a plugin metadata file, creating parent dirs first and skipping
+ * when the content is unchanged.
+ */
+export declare function writePluginMetadataFile(registryPath: string, content: string, successMessage: string): void;
+/**
+ * Reconcile the local marketplace registry against on-disk directories,
+ * removing the registry file entirely when no marketplaces remain and
+ * otherwise re-normalizing each entry.
+ */
+export declare function reconcileLocalMarketplaceRegistry(_roots: PluginMetadataRoots, configDir: string): void;
+export type { SharedItem };
+//# sourceMappingURL=plugin-metadata-normalizer.d.ts.map

package/dist/management/shared-manager/plugin-metadata-normalizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-metadata-normalizer.d.ts","sourceRoot":"","sources":["../../../src/management/shared-manager/plugin-metadata-normalizer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAYH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1C;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,mBAAmB,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAQjG;AAED;;;GAGG;AACH,wBAAgB,iCAAiC,CAC/C,KAAK,EAAE,mBAAmB,EAC1B,SAAS,CAAC,EAAE,MAAM,GACjB,IAAI,CAsBN;AAsID;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,eAAe,EAAE,MAAM,GACtB,MAAM,CAAC,MAAM,EAAE;IAAE,eAAe,EAAE,MAAM,CAAA;CAAE,CAAC,CAuB7C;AAUD;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,MAAM,GACrB,IAAI,CAUN;AAED;;;;GAIG;AACH,wBAAgB,iCAAiC,CAC/C,MAAM,EAAE,mBAAmB,EAC3B,SAAS,EAAE,MAAM,GAChB,IAAI,CA+CN;AAGD,YAAY,EAAE,UAAU,EAAE,CAAC"}