agent-switchboard 0.3.11 → 0.4.1

package/dist/manifest/store.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Project distribution manifest I/O and helpers.
+ *
+ * The manifest lives at `<project>/.asb/state/distribution.json` and records
+ * which artifacts ASB has written, enabling manifest-driven cleanup.
+ */
+import type { ManagedMcpEntry, ManifestEntry, ManifestSections, ProjectDistributionManifest, RulesManifestEntry } from './types.js';
+export declare function resolveManifestPath(projectRoot: string): string;
+export declare function loadManifest(projectRoot: string): ProjectDistributionManifest;
+export declare function saveManifest(projectRoot: string, manifest: ProjectDistributionManifest): void;
+export type LibraryManifestSection = 'skills' | 'commands' | 'agents';
+export interface ManifestCleanupItem {
+    id: string;
+    entry: ManifestEntry;
+}
+export declare function recordLibraryEntry(manifest: ProjectDistributionManifest, section: LibraryManifestSection, id: string, entry: ManifestEntry): void;
+export declare function removeLibraryEntry(manifest: ProjectDistributionManifest, section: LibraryManifestSection, id: string, targetId?: string): void;
+export declare function recordMcpEntry(manifest: ProjectDistributionManifest, serverName: string, entry: ManagedMcpEntry): void;
+/**
+ * Remove an MCP manifest entry by its composite key (as returned by
+ * `computeMcpCleanupSet`).
+ */
+export declare function removeMcpEntry(manifest: ProjectDistributionManifest, compositeKey: string): void;
+export declare function recordRulesEntry(manifest: ProjectDistributionManifest, filePathKey: string, entry: RulesManifestEntry): void;
+export declare function removeRulesEntry(manifest: ProjectDistributionManifest, filePathKey: string): void;
+/**
+ * Compute entries that were previously owned by ASB but are no longer in the
+ * current desired set. These are safe to clean up.
+ *
+ * Returns `ManifestCleanupItem[]` with the bare entry id and the full entry,
+ * so callers can resolve file paths and remove the manifest record.
+ */
+export declare function computeLibraryCleanupSet(manifest: ProjectDistributionManifest, section: LibraryManifestSection, currentDesiredIds: ReadonlySet<string>, targetId?: string): ManifestCleanupItem[];
+/**
+ * Compute MCP composite keys that were previously owned but are no longer enabled.
+ * Returns composite keys (serverName::targetId) for use with `removeMcpEntry`.
+ */
+export declare function computeMcpCleanupSet(manifest: ProjectDistributionManifest, currentDesiredNames: ReadonlySet<string>, targetId?: string): string[];
+/**
+ * Get the set of previously-owned MCP server names for a given target.
+ * Returns bare server names (not composite keys).
+ */
+export declare function getOwnedMcpServers(manifest: ProjectDistributionManifest, targetId: string): Set<string>;
+/**
+ * Get manifest entry for a library section item, if it exists.
+ * When targetId is provided, looks up the composite key directly.
+ * Without targetId, scans for the first entry matching the bare id.
+ */
+export declare function getLibraryEntry(manifest: ProjectDistributionManifest, section: LibraryManifestSection, id: string, targetId?: string): ManifestEntry | undefined;
+/**
+ * Resolve the effective sections record, ensuring it exists.
+ */
+export declare function ensureSections(manifest: ProjectDistributionManifest): ManifestSections;

package/dist/manifest/store.js

@@ -0,0 +1,183 @@
+/**
+ * Project distribution manifest I/O and helpers.
+ *
+ * The manifest lives at `<project>/.asb/state/distribution.json` and records
+ * which artifacts ASB has written, enabling manifest-driven cleanup.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+const MANIFEST_DIR = '.asb/state';
+const MANIFEST_FILENAME = 'distribution.json';
+export function resolveManifestPath(projectRoot) {
+    return path.join(projectRoot, MANIFEST_DIR, MANIFEST_FILENAME);
+}
+function emptyManifest() {
+    return {
+        version: 1,
+        updatedAt: new Date().toISOString(),
+        sections: {},
+    };
+}
+export function loadManifest(projectRoot) {
+    const filePath = resolveManifestPath(projectRoot);
+    try {
+        if (!fs.existsSync(filePath))
+            return emptyManifest();
+        const content = fs.readFileSync(filePath, 'utf-8');
+        const parsed = JSON.parse(content);
+        if (parsed.version !== 1)
+            return emptyManifest();
+        return parsed;
+    }
+    catch {
+        return emptyManifest();
+    }
+}
+export function saveManifest(projectRoot, manifest) {
+    const filePath = resolveManifestPath(projectRoot);
+    const dir = path.dirname(filePath);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true, mode: 0o700 });
+    }
+    manifest.updatedAt = new Date().toISOString();
+    fs.writeFileSync(filePath, `${JSON.stringify(manifest, null, 2)}\n`, 'utf-8');
+}
+// ── Composite key helpers ──────────────────────────────────
+const KEY_SEP = '::';
+/** Build a manifest key that is unique per (id, targetId) pair. */
+function manifestKey(id, targetId) {
+    return `${id}${KEY_SEP}${targetId}`;
+}
+/** Parse a composite manifest key back to id and targetId. */
+function parseManifestKey(key) {
+    const sep = key.indexOf(KEY_SEP);
+    if (sep === -1)
+        return { id: key, targetId: '' };
+    return { id: key.slice(0, sep), targetId: key.slice(sep + KEY_SEP.length) };
+}
+export function recordLibraryEntry(manifest, section, id, entry) {
+    const sec = (manifest.sections[section] ?? {});
+    sec[manifestKey(id, entry.targetId)] = entry;
+    manifest.sections[section] = sec;
+}
+export function removeLibraryEntry(manifest, section, id, targetId) {
+    const sec = manifest.sections[section];
+    if (!sec)
+        return;
+    if (targetId) {
+        delete sec[manifestKey(id, targetId)];
+    }
+    else {
+        for (const key of Object.keys(sec)) {
+            if (parseManifestKey(key).id === id)
+                delete sec[key];
+        }
+    }
+}
+export function recordMcpEntry(manifest, serverName, entry) {
+    const sec = (manifest.sections.mcp ?? {});
+    sec[manifestKey(serverName, entry.targetId)] = entry;
+    manifest.sections.mcp = sec;
+}
+/**
+ * Remove an MCP manifest entry by its composite key (as returned by
+ * `computeMcpCleanupSet`).
+ */
+export function removeMcpEntry(manifest, compositeKey) {
+    const sec = manifest.sections.mcp;
+    if (sec)
+        delete sec[compositeKey];
+}
+export function recordRulesEntry(manifest, filePathKey, entry) {
+    const sec = (manifest.sections.rules ?? {});
+    sec[filePathKey] = entry;
+    manifest.sections.rules = sec;
+}
+export function removeRulesEntry(manifest, filePathKey) {
+    const sec = manifest.sections.rules;
+    if (sec)
+        delete sec[filePathKey];
+}
+// ── Cleanup computation ────────────────────────────────────
+/**
+ * Compute entries that were previously owned by ASB but are no longer in the
+ * current desired set. These are safe to clean up.
+ *
+ * Returns `ManifestCleanupItem[]` with the bare entry id and the full entry,
+ * so callers can resolve file paths and remove the manifest record.
+ */
+export function computeLibraryCleanupSet(manifest, section, currentDesiredIds, targetId) {
+    const sec = manifest.sections[section];
+    if (!sec)
+        return [];
+    const toRemove = [];
+    for (const [key, entry] of Object.entries(sec)) {
+        if (targetId && entry.targetId !== targetId)
+            continue;
+        const { id } = parseManifestKey(key);
+        if (!currentDesiredIds.has(id)) {
+            toRemove.push({ id, entry });
+        }
+    }
+    return toRemove;
+}
+/**
+ * Compute MCP composite keys that were previously owned but are no longer enabled.
+ * Returns composite keys (serverName::targetId) for use with `removeMcpEntry`.
+ */
+export function computeMcpCleanupSet(manifest, currentDesiredNames, targetId) {
+    const sec = manifest.sections.mcp;
+    if (!sec)
+        return [];
+    const toRemove = [];
+    for (const [key, entry] of Object.entries(sec)) {
+        if (targetId && entry.targetId !== targetId)
+            continue;
+        const { id: serverName } = parseManifestKey(key);
+        if (!currentDesiredNames.has(serverName)) {
+            toRemove.push(key);
+        }
+    }
+    return toRemove;
+}
+/**
+ * Get the set of previously-owned MCP server names for a given target.
+ * Returns bare server names (not composite keys).
+ */
+export function getOwnedMcpServers(manifest, targetId) {
+    const sec = manifest.sections.mcp;
+    if (!sec)
+        return new Set();
+    const owned = new Set();
+    for (const [key, entry] of Object.entries(sec)) {
+        if (entry.targetId === targetId) {
+            owned.add(parseManifestKey(key).id);
+        }
+    }
+    return owned;
+}
+/**
+ * Get manifest entry for a library section item, if it exists.
+ * When targetId is provided, looks up the composite key directly.
+ * Without targetId, scans for the first entry matching the bare id.
+ */
+export function getLibraryEntry(manifest, section, id, targetId) {
+    const sec = manifest.sections[section];
+    if (!sec)
+        return undefined;
+    if (targetId) {
+        return sec[manifestKey(id, targetId)];
+    }
+    for (const [key, entry] of Object.entries(sec)) {
+        if (parseManifestKey(key).id === id)
+            return entry;
+    }
+    return undefined;
+}
+/**
+ * Resolve the effective sections record, ensuring it exists.
+ */
+export function ensureSections(manifest) {
+    return manifest.sections;
+}
+//# sourceMappingURL=store.js.map

package/dist/manifest/store.js.map

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

package/dist/manifest/types.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Project distribution manifest types.
+ *
+ * The manifest tracks which artifacts ASB has written to a project directory,
+ * enabling safe cleanup (only remove ASB-owned items) and conflict detection
+ * (don't overwrite project-native content).
+ */
+/** An artifact ASB has distributed (file or bundle directory). */
+export interface ManifestEntry {
+    /** Path relative to project root (e.g. ".claude/skills/my-skill") */
+    relativePath: string;
+    /** Which target app wrote this (e.g. "claude-code", "cursor", "agents") */
+    targetId: string;
+    /** SHA-256 hash of last-written content */
+    hash: string;
+    updatedAt: string;
+}
+/** An MCP server key ASB has written into a target config file. */
+export interface ManagedMcpEntry {
+    /** Config file path relative to project root (e.g. ".mcp.json") */
+    relativePath: string;
+    /** Target app that owns this server key */
+    targetId: string;
+    /** Actual key written into mcpServers (after sanitize) */
+    serverKey: string;
+    updatedAt: string;
+}
+/** A rules block ASB has injected into a shared or dedicated file. */
+export interface RulesManifestEntry {
+    /** File path relative to project root */
+    relativePath: string;
+    /** "block" = shared file with markers, "full" = dedicated ASB file */
+    mode: 'block' | 'full';
+    /** Which target apps share this physical file */
+    targetIds: string[];
+    /** SHA-256 of last-written ASB rules content */
+    hash: string;
+    updatedAt: string;
+}
+export type ManifestSectionKey = 'skills' | 'commands' | 'agents' | 'mcp' | 'rules';
+export interface ManifestSections {
+    skills?: Record<string, ManifestEntry>;
+    commands?: Record<string, ManifestEntry>;
+    agents?: Record<string, ManifestEntry>;
+    mcp?: Record<string, ManagedMcpEntry>;
+    rules?: Record<string, RulesManifestEntry>;
+}
+export interface ProjectDistributionManifest {
+    version: 1;
+    updatedAt: string;
+    sections: ManifestSections;
+}

package/dist/manifest/types.js

@@ -0,0 +1,9 @@
+/**
+ * Project distribution manifest types.
+ *
+ * The manifest tracks which artifacts ASB has written to a project directory,
+ * enabling safe cleanup (only remove ASB-owned items) and conflict detection
+ * (don't overwrite project-native content).
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/manifest/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/manifest/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/mcp/distribution.d.ts

@@ -1,4 +1,5 @@
 import type { ConfigScope } from '../config/scope.js';
+import type { ProjectDistributionManifest } from '../manifest/types.js';
 export interface McpDistributionResult {
     application: string;
     filePath: string;
@@ -9,5 +10,9 @@ export interface McpDistributionResult {
 export interface DistributeMcpOptions {
     useSpinner?: boolean;
     assumeInstalled?: ReadonlySet<string>;
+    /** Project distribution manifest for managed merge (project scope only) */
+    manifest?: ProjectDistributionManifest;
+    /** Project distribution mode */
+    projectMode?: 'managed' | 'exclusive' | 'none';
 }
 export declare function distributeMcp(scope?: ConfigScope, enabledServerNames?: string[], options?: DistributeMcpOptions): Promise<McpDistributionResult[]>;

package/dist/mcp/distribution.js

@@ -1,4 +1,5 @@
 import fs from 'node:fs';
+import path from 'node:path';
 import chalk from 'chalk';
 import ora from 'ora';
 import { resolveScopedSectionConfig } from '../config/application-config.js';
@@ -6,6 +7,7 @@ import { loadMcpConfigWithPlugins } from '../config/mcp-config.js';
 import { scopeToLayerOptions } from '../config/scope.js';
 import { loadSwitchboardConfig } from '../config/switchboard-config.js';
 import { loadMcpEnabledState } from '../library/state.js';
+import { computeMcpCleanupSet, getOwnedMcpServers, recordMcpEntry, removeMcpEntry, } from '../manifest/store.js';
 import { initTargets } from '../targets/init.js';
 import { getTargetById } from '../targets/registry.js';
 import { shortenPath } from '../util/cli.js';
@@ -79,7 +81,38 @@ export async function distributeMcp(scope, enabledServerNames, options) {
             if (scope?.project && mcpHandler.applyProjectConfig) {
                 const projectPath = mcpHandler.projectConfigPath?.(scope.project) ?? 'project config';
                 const before = readFileSafe(projectPath);
-                mcpHandler.applyProjectConfig(scope.project, configToApply);
+                // Build managed merge options if manifest is provided
+                const manifest = options?.manifest;
+                const isManaged = manifest && (options?.projectMode ?? 'exclusive') === 'managed';
+                const sanitize = mcpHandler.sanitizeServerName;
+                const ownedServers = isManaged ? getOwnedMcpServers(manifest, agentId) : new Set();
+                const managedOpts = isManaged
+                    ? { previouslyOwned: ownedServers }
+                    : undefined;
+                // Skip silently if no servers to apply and nothing to clean up
+                if (Object.keys(configToApply.mcpServers).length === 0 && ownedServers.size === 0) {
+                    continue;
+                }
+                mcpHandler.applyProjectConfig(scope.project, configToApply, managedOpts);
+                // Record owned servers in manifest (using sanitized names to match on-disk keys)
+                if (isManaged && manifest) {
+                    const timestamp = new Date().toISOString();
+                    for (const serverName of Object.keys(configToApply.mcpServers)) {
+                        const manifestName = sanitize ? sanitize(serverName) : serverName;
+                        recordMcpEntry(manifest, manifestName, {
+                            relativePath: path.relative(path.resolve(scope.project), projectPath),
+                            targetId: agentId,
+                            serverKey: manifestName,
+                            updatedAt: timestamp,
+                        });
+                    }
+                    // Remove no-longer-enabled servers from manifest
+                    const currentDesired = new Set(Object.keys(configToApply.mcpServers).map((n) => (sanitize ? sanitize(n) : n)));
+                    const toRemove = computeMcpCleanupSet(manifest, currentDesired, agentId);
+                    for (const name of toRemove) {
+                        removeMcpEntry(manifest, name);
+                    }
+                }
                 const after = readFileSafe(projectPath);
                 const changed = before !== after;
                 persist(chalk.green('✓'), `${chalk.cyan(agentId)} ${chalk.dim(shortenPath(projectPath))}`);

package/dist/mcp/distribution.js.map

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

package/dist/rules/block-merge.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Block merge for shared rules files (CLAUDE.md, AGENTS.md).
+ *
+ * In managed project mode, ASB content is wrapped in markers so that
+ * project-native content is preserved. If markers already exist, only
+ * the block between them is replaced.
+ */
+/**
+ * Merge ASB rules content into an existing file, preserving non-ASB content.
+ *
+ * - If markers exist: replace content between markers.
+ * - If no markers: insert block according to `placement`.
+ * - If `asbContent` is empty: remove the block entirely.
+ */
+export declare function mergeRulesBlock(existing: string, asbContent: string, placement?: 'prepend' | 'append'): string;
+/**
+ * Remove ASB markers and their content from a file, preserving the rest.
+ */
+export declare function removeRulesBlock(content: string): string;
+/**
+ * Check if a rules target file is a dedicated ASB file (safe for full replace)
+ * vs a shared file (needs block merge).
+ */
+export declare function isDedicatedAsbRulesFile(filePath: string): boolean;

package/dist/rules/block-merge.js

@@ -0,0 +1,68 @@
+/**
+ * Block merge for shared rules files (CLAUDE.md, AGENTS.md).
+ *
+ * In managed project mode, ASB content is wrapped in markers so that
+ * project-native content is preserved. If markers already exist, only
+ * the block between them is replaced.
+ */
+const ASB_BLOCK_START = '<!-- asb:rules:start -->';
+const ASB_BLOCK_END = '<!-- asb:rules:end -->';
+/**
+ * Merge ASB rules content into an existing file, preserving non-ASB content.
+ *
+ * - If markers exist: replace content between markers.
+ * - If no markers: insert block according to `placement`.
+ * - If `asbContent` is empty: remove the block entirely.
+ */
+export function mergeRulesBlock(existing, asbContent, placement = 'prepend') {
+    const startIdx = existing.indexOf(ASB_BLOCK_START);
+    const endIdx = existing.indexOf(ASB_BLOCK_END);
+    if (asbContent.length === 0) {
+        // Remove existing block if present
+        if (startIdx !== -1 && endIdx !== -1) {
+            return removeRulesBlock(existing);
+        }
+        return existing;
+    }
+    const block = `${ASB_BLOCK_START}\n${asbContent.trimEnd()}\n${ASB_BLOCK_END}`;
+    if (startIdx !== -1 && endIdx !== -1 && endIdx > startIdx) {
+        // Replace existing block
+        const before = existing.slice(0, startIdx);
+        const after = existing.slice(endIdx + ASB_BLOCK_END.length);
+        return `${before}${block}${after}`;
+    }
+    // Insert new block
+    const trimmed = existing.trimEnd();
+    if (placement === 'prepend') {
+        if (trimmed.length === 0)
+            return `${block}\n`;
+        return `${block}\n\n${trimmed}\n`;
+    }
+    // append
+    if (trimmed.length === 0)
+        return `${block}\n`;
+    return `${trimmed}\n\n${block}\n`;
+}
+/**
+ * Remove ASB markers and their content from a file, preserving the rest.
+ */
+export function removeRulesBlock(content) {
+    const startIdx = content.indexOf(ASB_BLOCK_START);
+    const endIdx = content.indexOf(ASB_BLOCK_END);
+    if (startIdx === -1 || endIdx === -1 || endIdx <= startIdx)
+        return content;
+    const before = content.slice(0, startIdx);
+    const after = content.slice(endIdx + ASB_BLOCK_END.length);
+    // Clean up extra whitespace left by removal
+    const result = (before + after).replace(/\n{3,}/g, '\n\n').trim();
+    return result.length > 0 ? `${result}\n` : '';
+}
+/**
+ * Check if a rules target file is a dedicated ASB file (safe for full replace)
+ * vs a shared file (needs block merge).
+ */
+export function isDedicatedAsbRulesFile(filePath) {
+    const basename = filePath.split('/').pop() ?? '';
+    return basename.startsWith('asb-rules');
+}
+//# sourceMappingURL=block-merge.js.map

package/dist/rules/block-merge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"block-merge.js","sourceRoot":"","sources":["../../src/rules/block-merge.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,eAAe,GAAG,0BAA0B,CAAC;AACnD,MAAM,aAAa,GAAG,wBAAwB,CAAC;AAE/C;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAC7B,QAAgB,EAChB,UAAkB,EAClB,YAAkC,SAAS;IAE3C,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;IACnD,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IAE/C,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,mCAAmC;QACnC,IAAI,QAAQ,KAAK,CAAC,CAAC,IAAI,MAAM,KAAK,CAAC,CAAC,EAAE,CAAC;YACrC,OAAO,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QACpC,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,MAAM,KAAK,GAAG,GAAG,eAAe,KAAK,UAAU,CAAC,OAAO,EAAE,KAAK,aAAa,EAAE,CAAC;IAE9E,IAAI,QAAQ,KAAK,CAAC,CAAC,IAAI,MAAM,KAAK,CAAC,CAAC,IAAI,MAAM,GAAG,QAAQ,EAAE,CAAC;QAC1D,yBAAyB;QACzB,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;QAC3C,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;QAC5D,OAAO,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,EAAE,CAAC;IACrC,CAAC;IAED,mBAAmB;IACnB,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,EAAE,CAAC;IACnC,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC5B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,GAAG,KAAK,IAAI,CAAC;QAC9C,OAAO,GAAG,KAAK,OAAO,OAAO,IAAI,CAAC;IACpC,CAAC;IACD,SAAS;IACT,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,GAAG,KAAK,IAAI,CAAC;IAC9C,OAAO,GAAG,OAAO,OAAO,KAAK,IAAI,CAAC;AACpC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC9C,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;IAClD,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IAC9C,IAAI,QAAQ,KAAK,CAAC,CAAC,IAAI,MAAM,KAAK,CAAC,CAAC,IAAI,MAAM,IAAI,QAAQ;QAAE,OAAO,OAAO,CAAC;IAE3E,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;IAC1C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IAE3D,4CAA4C;IAC5C,MAAM,MAAM,GAAG,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;IAClE,OAAO,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;AAChD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,QAAgB;IACtD,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;IACjD,OAAO,QAAQ,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;AAC1C,CAAC"}

package/dist/rules/distribution.d.ts

@@ -1,4 +1,5 @@
 import type { ConfigScope } from '../config/scope.js';
+import type { ProjectDistributionManifest } from '../manifest/types.js';
 import type { ComposedRules } from './composer.js';
 export type DistributionStatus = 'written' | 'skipped' | 'error' | 'deleted';
 export interface DistributionResult {
@@ -16,6 +17,12 @@ interface DistributionOptions {
     force?: boolean;
     activeAppIds?: string[];
     assumeInstalled?: ReadonlySet<string>;
+    /** Project distribution manifest for managed mode */
+    manifest?: ProjectDistributionManifest;
+    /** Project distribution mode */
+    projectMode?: 'managed' | 'exclusive' | 'none';
+    /** Rules placement in shared files */
+    rulesPlacement?: 'prepend' | 'append';
 }
 export declare function distributeRules(options?: DistributionOptions, scope?: ConfigScope): DistributionOutcome;
 export declare function listUnsupportedAgents(): string[];