@sudocode-ai/cli 0.1.12 → 0.1.14

package/dist/integrations/config-validator.js.map

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

package/dist/integrations/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Integration module for sudocode
+ * Provides plugin loading, configuration validation, path resolution,
+ * provider interfaces, sync coordination, and registry for external integrations
+ */
+export { loadPlugin, loadConfiguredPlugins, resolvePluginPath, validateProviderConfig, testProviderConnection, getFirstPartyPlugins, clearPluginCache, } from "./plugin-loader.js";
+export { validateIntegrationsConfig, validateIntegrationsConfigWithPlugins, type ValidationResult, } from "./config-validator.js";
+export { resolveIntegrationPaths, getEnabledProviders, type ResolvedConfig, type ResolvedProviderConfig, type ResolvedJiraConfig, type ResolvedBeadsConfig, type ResolvedSpecKitConfig, type ResolvedOpenSpecConfig, } from "./config-resolver.js";
+export type { IntegrationProvider, ProviderRegistry } from "./types.js";
+export { BaseIntegrationProvider } from "./base-provider.js";
+export { DefaultProviderRegistry } from "./registry.js";
+export { SyncCoordinator, type SyncCoordinatorOptions, } from "./sync-coordinator.js";
+export { resolveByStrategy, logConflict, createConflictLog, isConflict, type ConflictLog, } from "./utils/conflict-resolver.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/integrations/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/integrations/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACL,UAAU,EACV,qBAAqB,EACrB,iBAAiB,EACjB,sBAAsB,EACtB,sBAAsB,EACtB,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,0BAA0B,EAC1B,qCAAqC,EACrC,KAAK,gBAAgB,GACtB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,uBAAuB,EACvB,mBAAmB,EACnB,KAAK,cAAc,EACnB,KAAK,sBAAsB,EAE3B,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,GAC5B,MAAM,sBAAsB,CAAC;AAG9B,YAAY,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAGxE,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAG7D,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAGxD,OAAO,EACL,eAAe,EACf,KAAK,sBAAsB,GAC5B,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,iBAAiB,EACjB,WAAW,EACX,iBAAiB,EACjB,UAAU,EACV,KAAK,WAAW,GACjB,MAAM,8BAA8B,CAAC"}

package/dist/integrations/index.js

@@ -0,0 +1,20 @@
+/**
+ * Integration module for sudocode
+ * Provides plugin loading, configuration validation, path resolution,
+ * provider interfaces, sync coordination, and registry for external integrations
+ */
+// Plugin loading (dynamic imports)
+export { loadPlugin, loadConfiguredPlugins, resolvePluginPath, validateProviderConfig, testProviderConnection, getFirstPartyPlugins, clearPluginCache, } from "./plugin-loader.js";
+// Configuration validation
+export { validateIntegrationsConfig, validateIntegrationsConfigWithPlugins, } from "./config-validator.js";
+// Configuration path resolution
+export { resolveIntegrationPaths, getEnabledProviders, } from "./config-resolver.js";
+// Base provider class
+export { BaseIntegrationProvider } from "./base-provider.js";
+// Provider registry
+export { DefaultProviderRegistry } from "./registry.js";
+// Sync coordinator
+export { SyncCoordinator, } from "./sync-coordinator.js";
+// Conflict resolution utilities
+export { resolveByStrategy, logConflict, createConflictLog, isConflict, } from "./utils/conflict-resolver.js";
+//# sourceMappingURL=index.js.map

package/dist/integrations/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/integrations/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,mCAAmC;AACnC,OAAO,EACL,UAAU,EACV,qBAAqB,EACrB,iBAAiB,EACjB,sBAAsB,EACtB,sBAAsB,EACtB,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAE5B,2BAA2B;AAC3B,OAAO,EACL,0BAA0B,EAC1B,qCAAqC,GAEtC,MAAM,uBAAuB,CAAC;AAE/B,gCAAgC;AAChC,OAAO,EACL,uBAAuB,EACvB,mBAAmB,GAQpB,MAAM,sBAAsB,CAAC;AAK9B,sBAAsB;AACtB,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAE7D,oBAAoB;AACpB,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAExD,mBAAmB;AACnB,OAAO,EACL,eAAe,GAEhB,MAAM,uBAAuB,CAAC;AAE/B,gCAAgC;AAChC,OAAO,EACL,iBAAiB,EACjB,WAAW,EACX,iBAAiB,EACjB,UAAU,GAEX,MAAM,8BAA8B,CAAC"}

package/dist/integrations/plugin-loader.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Plugin loader for integration plugins
+ *
+ * Handles dynamic loading of integration plugins via:
+ * - npm packages (e.g., "@sudocode-ai/integration-beads")
+ * - Local paths (e.g., "./plugins/my-integration")
+ *
+ * First-party plugins are loaded by short name:
+ * - "beads" -> "@sudocode-ai/integration-beads"
+ */
+import type { IntegrationPlugin, IntegrationProviderConfig, IntegrationsConfig, PluginValidationResult, PluginTestResult } from "@sudocode-ai/types";
+/**
+ * Resolve a plugin identifier to an importable module path
+ *
+ * @param pluginId - Plugin identifier (short name, npm package, or local path)
+ * @returns Module path that can be passed to import()
+ */
+export declare function resolvePluginPath(pluginId: string): string;
+/**
+ * Load a plugin by its identifier
+ *
+ * @param pluginId - Plugin identifier (short name, npm package, or local path)
+ * @returns The loaded plugin, or null if loading failed
+ */
+export declare function loadPlugin(pluginId: string): Promise<IntegrationPlugin | null>;
+/**
+ * Load all configured plugins
+ *
+ * @param config - Integrations configuration
+ * @returns Map of provider name to loaded plugin
+ */
+export declare function loadConfiguredPlugins(config: IntegrationsConfig): Promise<Map<string, IntegrationPlugin>>;
+/**
+ * Validate a provider's configuration using its plugin
+ *
+ * @param providerName - Name of the provider in config
+ * @param providerConfig - The provider's configuration
+ * @returns Validation result from the plugin, or error if plugin not loaded
+ */
+export declare function validateProviderConfig(providerName: string, providerConfig: IntegrationProviderConfig): Promise<PluginValidationResult>;
+/**
+ * Test a provider's connection using its plugin
+ *
+ * @param providerName - Name of the provider in config
+ * @param providerConfig - The provider's configuration
+ * @param projectPath - Path to the sudocode project
+ * @returns Test result from the plugin
+ */
+export declare function testProviderConnection(providerName: string, providerConfig: IntegrationProviderConfig, projectPath: string): Promise<PluginTestResult>;
+/**
+ * Get a list of available first-party plugins
+ */
+export declare function getFirstPartyPlugins(): Array<{
+    name: string;
+    package: string;
+}>;
+/**
+ * Clear the plugin cache (useful for testing)
+ */
+export declare function clearPluginCache(): void;
+/**
+ * Extend Error to include 'code' property for module not found errors
+ */
+declare global {
+    interface Error {
+        code?: string;
+    }
+}
+//# sourceMappingURL=plugin-loader.d.ts.map

package/dist/integrations/plugin-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-loader.d.ts","sourceRoot":"","sources":["../../src/integrations/plugin-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EACV,iBAAiB,EACjB,yBAAyB,EACzB,kBAAkB,EAClB,sBAAsB,EACtB,gBAAgB,EACjB,MAAM,oBAAoB,CAAC;AAc5B;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAa1D;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,CAC9B,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CA0CnC;AAqBD;;;;;GAKG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAkBzC;AAED;;;;;;GAMG;AACH,wBAAsB,sBAAsB,CAC1C,YAAY,EAAE,MAAM,EACpB,cAAc,EAAE,yBAAyB,GACxC,OAAO,CAAC,sBAAsB,CAAC,CAcjC;AAED;;;;;;;GAOG;AACH,wBAAsB,sBAAsB,CAC1C,YAAY,EAAE,MAAM,EACpB,cAAc,EAAE,yBAAyB,EACzC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,gBAAgB,CAAC,CAe3B;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,KAAK,CAAC;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC,CAKD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC;AAED;;GAEG;AACH,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,KAAK;QACb,IAAI,CAAC,EAAE,MAAM,CAAC;KACf;CACF"}

package/dist/integrations/plugin-loader.js

@@ -0,0 +1,172 @@
+/**
+ * Plugin loader for integration plugins
+ *
+ * Handles dynamic loading of integration plugins via:
+ * - npm packages (e.g., "@sudocode-ai/integration-beads")
+ * - Local paths (e.g., "./plugins/my-integration")
+ *
+ * First-party plugins are loaded by short name:
+ * - "beads" -> "@sudocode-ai/integration-beads"
+ */
+/**
+ * Mapping of first-party plugin short names to npm package names
+ */
+const FIRST_PARTY_PLUGINS = {
+    beads: "@sudocode-ai/integration-beads",
+};
+/**
+ * Cache for loaded plugins
+ */
+const pluginCache = new Map();
+/**
+ * Resolve a plugin identifier to an importable module path
+ *
+ * @param pluginId - Plugin identifier (short name, npm package, or local path)
+ * @returns Module path that can be passed to import()
+ */
+export function resolvePluginPath(pluginId) {
+    // Check if it's a first-party plugin short name
+    if (FIRST_PARTY_PLUGINS[pluginId]) {
+        return FIRST_PARTY_PLUGINS[pluginId];
+    }
+    // If it starts with @ or contains /, treat as npm package or path
+    if (pluginId.startsWith("@") || pluginId.includes("/")) {
+        return pluginId;
+    }
+    // Otherwise, assume it's a first-party plugin
+    return `@sudocode-ai/integration-${pluginId}`;
+}
+/**
+ * Load a plugin by its identifier
+ *
+ * @param pluginId - Plugin identifier (short name, npm package, or local path)
+ * @returns The loaded plugin, or null if loading failed
+ */
+export async function loadPlugin(pluginId) {
+    // Check cache first
+    const cached = pluginCache.get(pluginId);
+    if (cached) {
+        return cached;
+    }
+    const modulePath = resolvePluginPath(pluginId);
+    try {
+        // Dynamic import
+        const module = await import(modulePath);
+        // Plugin should be the default export
+        const plugin = module.default || module;
+        // Validate plugin has required fields
+        if (!isValidPlugin(plugin)) {
+            console.error(`Invalid plugin '${pluginId}': missing required fields (name, displayName, version, validateConfig, testConnection, createProvider)`);
+            return null;
+        }
+        // Cache the plugin
+        pluginCache.set(pluginId, plugin);
+        return plugin;
+    }
+    catch (error) {
+        // Plugin not installed or failed to load
+        const err = error;
+        if (err.code === "ERR_MODULE_NOT_FOUND" ||
+            err.code === "MODULE_NOT_FOUND") {
+            console.warn(`Plugin '${pluginId}' not installed. Install with: npm install ${modulePath}`);
+        }
+        else {
+            console.error(`Failed to load plugin '${pluginId}':`, err.message);
+        }
+        return null;
+    }
+}
+/**
+ * Check if an object is a valid IntegrationPlugin
+ */
+function isValidPlugin(plugin) {
+    if (!plugin || typeof plugin !== "object") {
+        return false;
+    }
+    const p = plugin;
+    return (typeof p.name === "string" &&
+        typeof p.displayName === "string" &&
+        typeof p.version === "string" &&
+        typeof p.validateConfig === "function" &&
+        typeof p.testConnection === "function" &&
+        typeof p.createProvider === "function");
+}
+/**
+ * Load all configured plugins
+ *
+ * @param config - Integrations configuration
+ * @returns Map of provider name to loaded plugin
+ */
+export async function loadConfiguredPlugins(config) {
+    const plugins = new Map();
+    for (const [providerName, providerConfig] of Object.entries(config)) {
+        if (!providerConfig?.enabled) {
+            continue;
+        }
+        // Determine plugin ID: use explicit plugin field, or fall back to provider name
+        const pluginId = providerConfig.plugin || providerName;
+        const plugin = await loadPlugin(pluginId);
+        if (plugin) {
+            plugins.set(providerName, plugin);
+        }
+    }
+    return plugins;
+}
+/**
+ * Validate a provider's configuration using its plugin
+ *
+ * @param providerName - Name of the provider in config
+ * @param providerConfig - The provider's configuration
+ * @returns Validation result from the plugin, or error if plugin not loaded
+ */
+export async function validateProviderConfig(providerName, providerConfig) {
+    const pluginId = providerConfig.plugin || providerName;
+    const plugin = await loadPlugin(pluginId);
+    if (!plugin) {
+        return {
+            valid: false,
+            errors: [`Plugin '${pluginId}' not installed or failed to load`],
+            warnings: [],
+        };
+    }
+    // Delegate validation to plugin
+    return plugin.validateConfig(providerConfig.options || {});
+}
+/**
+ * Test a provider's connection using its plugin
+ *
+ * @param providerName - Name of the provider in config
+ * @param providerConfig - The provider's configuration
+ * @param projectPath - Path to the sudocode project
+ * @returns Test result from the plugin
+ */
+export async function testProviderConnection(providerName, providerConfig, projectPath) {
+    const pluginId = providerConfig.plugin || providerName;
+    const plugin = await loadPlugin(pluginId);
+    if (!plugin) {
+        return {
+            success: false,
+            configured: true,
+            enabled: providerConfig.enabled,
+            error: `Plugin '${pluginId}' not installed or failed to load`,
+        };
+    }
+    // Delegate test to plugin
+    return plugin.testConnection(providerConfig.options || {}, projectPath);
+}
+/**
+ * Get a list of available first-party plugins
+ */
+export function getFirstPartyPlugins() {
+    return Object.entries(FIRST_PARTY_PLUGINS).map(([name, pkg]) => ({
+        name,
+        package: pkg,
+    }));
+}
+/**
+ * Clear the plugin cache (useful for testing)
+ */
+export function clearPluginCache() {
+    pluginCache.clear();
+}
+//# sourceMappingURL=plugin-loader.js.map

package/dist/integrations/plugin-loader.js.map

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

package/dist/integrations/registry.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Integration provider registry
+ * Central place to register and look up integration providers
+ */
+import type { IntegrationProvider, ProviderRegistry } from "./types.js";
+/**
+ * Default implementation of the provider registry
+ *
+ * Stores providers in a Map keyed by provider name.
+ * Throws on duplicate registration to prevent accidental overwrites.
+ *
+ * @example
+ * ```typescript
+ * const registry = new DefaultProviderRegistry();
+ *
+ * // Register providers
+ * registry.register(new JiraProvider());
+ * registry.register(new BeadsProvider());
+ *
+ * // Look up a provider
+ * const jira = registry.get('jira');
+ * if (jira) {
+ *   await jira.initialize(config);
+ * }
+ *
+ * // Check if provider exists
+ * if (registry.has('beads')) {
+ *   console.log('Beads integration available');
+ * }
+ *
+ * // Get all providers
+ * for (const provider of registry.getAll()) {
+ *   console.log(`Provider: ${provider.name}`);
+ * }
+ * ```
+ */
+export declare class DefaultProviderRegistry implements ProviderRegistry {
+    private providers;
+    /**
+     * Register a provider in the registry
+     *
+     * @param provider - The provider to register
+     * @throws Error if a provider with the same name is already registered
+     */
+    register(provider: IntegrationProvider): void;
+    /**
+     * Get a provider by name
+     *
+     * @param name - The provider name (e.g., "jira", "beads")
+     * @returns The provider, or undefined if not found
+     */
+    get(name: string): IntegrationProvider | undefined;
+    /**
+     * Get all registered providers
+     *
+     * @returns Array of all registered providers
+     */
+    getAll(): IntegrationProvider[];
+    /**
+     * Check if a provider is registered
+     *
+     * @param name - The provider name
+     * @returns True if a provider with this name is registered
+     */
+    has(name: string): boolean;
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/integrations/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/integrations/registry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAExE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,qBAAa,uBAAwB,YAAW,gBAAgB;IAC9D,OAAO,CAAC,SAAS,CAA0C;IAE3D;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,GAAG,IAAI;IAO7C;;;;;OAKG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS;IAIlD;;;;OAIG;IACH,MAAM,IAAI,mBAAmB,EAAE;IAI/B;;;;;OAKG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;CAG3B"}

package/dist/integrations/registry.js

@@ -0,0 +1,77 @@
+/**
+ * Integration provider registry
+ * Central place to register and look up integration providers
+ */
+/**
+ * Default implementation of the provider registry
+ *
+ * Stores providers in a Map keyed by provider name.
+ * Throws on duplicate registration to prevent accidental overwrites.
+ *
+ * @example
+ * ```typescript
+ * const registry = new DefaultProviderRegistry();
+ *
+ * // Register providers
+ * registry.register(new JiraProvider());
+ * registry.register(new BeadsProvider());
+ *
+ * // Look up a provider
+ * const jira = registry.get('jira');
+ * if (jira) {
+ *   await jira.initialize(config);
+ * }
+ *
+ * // Check if provider exists
+ * if (registry.has('beads')) {
+ *   console.log('Beads integration available');
+ * }
+ *
+ * // Get all providers
+ * for (const provider of registry.getAll()) {
+ *   console.log(`Provider: ${provider.name}`);
+ * }
+ * ```
+ */
+export class DefaultProviderRegistry {
+    providers = new Map();
+    /**
+     * Register a provider in the registry
+     *
+     * @param provider - The provider to register
+     * @throws Error if a provider with the same name is already registered
+     */
+    register(provider) {
+        if (this.providers.has(provider.name)) {
+            throw new Error(`Provider '${provider.name}' already registered`);
+        }
+        this.providers.set(provider.name, provider);
+    }
+    /**
+     * Get a provider by name
+     *
+     * @param name - The provider name (e.g., "jira", "beads")
+     * @returns The provider, or undefined if not found
+     */
+    get(name) {
+        return this.providers.get(name);
+    }
+    /**
+     * Get all registered providers
+     *
+     * @returns Array of all registered providers
+     */
+    getAll() {
+        return Array.from(this.providers.values());
+    }
+    /**
+     * Check if a provider is registered
+     *
+     * @param name - The provider name
+     * @returns True if a provider with this name is registered
+     */
+    has(name) {
+        return this.providers.has(name);
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/integrations/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/integrations/registry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,OAAO,uBAAuB;IAC1B,SAAS,GAAG,IAAI,GAAG,EAA+B,CAAC;IAE3D;;;;;OAKG;IACH,QAAQ,CAAC,QAA6B;QACpC,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACtC,MAAM,IAAI,KAAK,CAAC,aAAa,QAAQ,CAAC,IAAI,sBAAsB,CAAC,CAAC;QACpE,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC9C,CAAC;IAED;;;;;OAKG;IACH,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;IAED;;;;OAIG;IACH,MAAM;QACJ,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED;;;;;OAKG;IACH,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;CACF"}

package/dist/integrations/sync-coordinator.d.ts

@@ -0,0 +1,186 @@
+/**
+ * SyncCoordinator - Orchestrates sync between sudocode and external integration providers
+ *
+ * Manages provider lifecycle, handles change detection, and resolves conflicts
+ * during bidirectional synchronization.
+ */
+import type { IntegrationsConfig, ExternalLink, SyncResult, SyncConflict, SyncDirection } from "@sudocode-ai/types";
+import type { IntegrationProvider } from "./types.js";
+/**
+ * Options for creating a SyncCoordinator
+ */
+export interface SyncCoordinatorOptions {
+    /** Project root path (where .sudocode is located) */
+    projectPath: string;
+    /** Integration configurations */
+    config: IntegrationsConfig;
+    /** Custom conflict resolution callback (for manual resolution) */
+    onConflict?: (conflict: SyncConflict) => Promise<"sudocode" | "external" | "skip">;
+}
+/**
+ * SyncCoordinator manages integration providers and synchronization
+ *
+ * @example
+ * ```typescript
+ * const coordinator = new SyncCoordinator({
+ *   projectPath: '/path/to/project',
+ *   config: { jira: { enabled: true, ... } },
+ * });
+ *
+ * coordinator.registerProvider(new JiraProvider());
+ * await coordinator.start();
+ *
+ * // Sync all providers
+ * const results = await coordinator.syncAll();
+ *
+ * // Link a sudocode entity to an external entity
+ * await coordinator.linkEntity('i-abc', 'PROJ-123', 'jira');
+ *
+ * await coordinator.stop();
+ * ```
+ */
+export declare class SyncCoordinator {
+    private options;
+    private providers;
+    private lastSyncTimes;
+    constructor(options: SyncCoordinatorOptions);
+    /**
+     * Register an integration provider
+     * @param provider - The provider to register
+     */
+    registerProvider(provider: IntegrationProvider): void;
+    /**
+     * Get a registered provider by name
+     * @param name - Provider name
+     * @returns The provider, or undefined if not found
+     */
+    getProvider(name: string): IntegrationProvider | undefined;
+    /**
+     * Get all registered provider names
+     */
+    getProviderNames(): string[];
+    /**
+     * Start the coordinator and initialize all enabled providers
+     *
+     * For each registered provider:
+     * 1. Skip if not enabled in config
+     * 2. Initialize with config
+     * 3. Validate connection
+     * 4. Start watching if auto_sync is enabled and provider supports it
+     */
+    start(): Promise<void>;
+    /**
+     * Stop the coordinator and dispose all providers
+     */
+    stop(): Promise<void>;
+    /**
+     * Sync all registered and enabled providers
+     * @returns Array of sync results from all providers
+     */
+    syncAll(): Promise<SyncResult[]>;
+    /**
+     * Sync a specific provider
+     * @param providerName - Name of the provider to sync
+     * @returns Array of sync results
+     */
+    syncProvider(providerName: string): Promise<SyncResult[]>;
+    /**
+     * Sync a specific entity's external links
+     * @param entityId - Sudocode entity ID (s-xxxx or i-xxxx)
+     * @returns Array of sync results for each link
+     */
+    syncEntity(entityId: string): Promise<SyncResult[]>;
+    /**
+     * Link a sudocode entity to an external entity
+     *
+     * @param entityId - Sudocode entity ID
+     * @param externalId - External system entity ID
+     * @param provider - Provider name
+     * @param options - Link options (sync direction, enabled)
+     */
+    linkEntity(entityId: string, externalId: string, provider: string, options?: {
+        sync_direction?: SyncDirection;
+        sync_enabled?: boolean;
+    }): Promise<void>;
+    /**
+     * Remove a link between a sudocode entity and an external entity
+     *
+     * @param entityId - Sudocode entity ID
+     * @param externalId - External system entity ID
+     */
+    unlinkEntity(entityId: string, externalId: string): Promise<void>;
+    /**
+     * Handle deletion of a sudocode entity - propagate to external systems
+     *
+     * Call this when a sudocode entity is deleted to propagate the deletion
+     * to all linked external systems.
+     *
+     * @param entityId - Sudocode entity ID that was deleted
+     * @param externalLinks - The external_links from the deleted entity
+     * @returns Array of sync results
+     */
+    handleEntityDeleted(entityId: string, externalLinks: ExternalLink[]): Promise<SyncResult[]>;
+    /**
+     * Handle inbound changes from an external provider
+     */
+    private handleInboundChanges;
+    /**
+     * Process a single inbound change
+     */
+    private processInboundChange;
+    /**
+     * Sync a single external link
+     */
+    private syncSingleLink;
+    /**
+     * Detect if there's a conflict between sudocode and external versions
+     */
+    private detectConflict;
+    /**
+     * Resolve a sync conflict based on configured strategy
+     */
+    private resolveConflict;
+    /**
+     * Get provider config from options
+     */
+    private getProviderConfig;
+    /**
+     * Determine if an ID is for a spec or issue
+     */
+    private getEntityType;
+    /**
+     * Get the JSONL file path for an entity type
+     */
+    private getEntityFilePath;
+    /**
+     * Load an entity from JSONL storage
+     */
+    /**
+     * Load an entity from JSONL storage
+     */
+    private loadEntity;
+    /**
+     * Convert JSONL entity to domain Entity
+     */
+    private toEntity;
+    /**
+     * Find a sudocode entity linked to an external entity
+     */
+    private findLinkedEntity;
+    /**
+     * Update external_links on an entity
+     */
+    private updateEntityLinks;
+    /**
+     * Update the last_synced_at timestamp on a link
+     */
+    /**
+     * Update the last_synced_at timestamp on a link
+     */
+    private updateLinkSyncTime;
+    /**
+     * Apply partial updates to an entity
+     */
+    private applyUpdatesToEntity;
+}
+//# sourceMappingURL=sync-coordinator.d.ts.map

package/dist/integrations/sync-coordinator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-coordinator.d.ts","sourceRoot":"","sources":["../../src/integrations/sync-coordinator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAEV,kBAAkB,EAElB,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,aAAa,EAMd,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAiBtD;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,qDAAqD;IACrD,WAAW,EAAE,MAAM,CAAC;IACpB,iCAAiC;IACjC,MAAM,EAAE,kBAAkB,CAAC;IAC3B,kEAAkE;IAClE,UAAU,CAAC,EAAE,CACX,QAAQ,EAAE,YAAY,KACnB,OAAO,CAAC,UAAU,GAAG,UAAU,GAAG,MAAM,CAAC,CAAC;CAChD;AAQD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,eAAe;IAId,OAAO,CAAC,OAAO;IAH3B,OAAO,CAAC,SAAS,CAA0C;IAC3D,OAAO,CAAC,aAAa,CAA2B;gBAE5B,OAAO,EAAE,sBAAsB;IAMnD;;;OAGG;IACH,gBAAgB,CAAC,QAAQ,EAAE,mBAAmB,GAAG,IAAI;IAIrD;;;;OAIG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS;IAI1D;;OAEG;IACH,gBAAgB,IAAI,MAAM,EAAE;IAQ5B;;;;;;;;OAQG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAoC5B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAe3B;;;OAGG;IACG,OAAO,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;IAwBtC;;;;OAIG;IACG,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAe/D;;;;OAIG;IACG,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAuCzD;;;;;;;OAOG;IACG,UAAU,CACd,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE;QAAE,cAAc,CAAC,EAAE,aAAa,CAAC;QAAC,YAAY,CAAC,EAAE,OAAO,CAAA;KAAE,GACnE,OAAO,CAAC,IAAI,CAAC;IAgChB;;;;;OAKG;IACG,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUvE;;;;;;;;;OASG;IACG,mBAAmB,CACvB,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,YAAY,EAAE,GAC5B,OAAO,CAAC,UAAU,EAAE,CAAC;IA6DxB;;OAEG;YACW,oBAAoB;IA8BlC;;OAEG;YACW,oBAAoB;IA2KlC;;OAEG;YACW,cAAc;IA2H5B;;OAEG;IACH,OAAO,CAAC,cAAc;IAyBtB;;OAEG;YACW,eAAe;IA+B7B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAMzB;;OAEG;IACH,OAAO,CAAC,aAAa;IAIrB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAOzB;;OAEG;IACH;;OAEG;IACH,OAAO,CAAC,UAAU;IAclB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAMhB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAmCxB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAczB;;OAEG;IACH;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAe1B;;OAEG;IACH,OAAO,CAAC,oBAAoB;CAsB7B"}