@fractary/codex 0.12.2 → 0.12.5

package/dist/index.d.ts

@@ -460,7 +460,7 @@ declare const CodexConfigSchema: z.ZodObject<{
             include: string[];
             exclude?: string[] | undefined;
         }>>;
-        from_codex: z.ZodOptional<z.ZodObject<{
+        from_codex: z.ZodOptional<z.ZodEffects<z.ZodObject<{
             include: z.ZodArray<z.ZodString, "many">;
             exclude: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         }, "strip", z.ZodTypeAny, {
@@ -469,6 +469,12 @@ declare const CodexConfigSchema: z.ZodObject<{
         }, {
             include: string[];
             exclude?: string[] | undefined;
+        }>, {
+            include: string[];
+            exclude?: string[] | undefined;
+        }, {
+            include: string[];
+            exclude?: string[] | undefined;
         }>>;
         exclude: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         default_to_codex: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -557,52 +563,12 @@ declare const CodexConfigSchema: z.ZodObject<{
             fallback_to_public?: boolean | undefined;
         } | undefined;
     }>>;
-    dependencies: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
-        sources: z.ZodRecord<z.ZodString, z.ZodObject<{
-            type: z.ZodEnum<["github", "s3", "http", "local"]>;
-            token_env: z.ZodOptional<z.ZodString>;
-            token: z.ZodOptional<z.ZodString>;
-            branch: z.ZodOptional<z.ZodString>;
-            base_url: z.ZodOptional<z.ZodString>;
-            bucket: z.ZodOptional<z.ZodString>;
-            prefix: z.ZodOptional<z.ZodString>;
-        }, "strip", z.ZodTypeAny, {
-            type: "local" | "github" | "http" | "s3";
-            token?: string | undefined;
-            branch?: string | undefined;
-            bucket?: string | undefined;
-            prefix?: string | undefined;
-            token_env?: string | undefined;
-            base_url?: string | undefined;
-        }, {
-            type: "local" | "github" | "http" | "s3";
-            token?: string | undefined;
-            branch?: string | undefined;
-            bucket?: string | undefined;
-            prefix?: string | undefined;
-            token_env?: string | undefined;
-            base_url?: string | undefined;
-        }>>;
+    remotes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        token: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
-        sources: Record<string, {
-            type: "local" | "github" | "http" | "s3";
-            token?: string | undefined;
-            branch?: string | undefined;
-            bucket?: string | undefined;
-            prefix?: string | undefined;
-            token_env?: string | undefined;
-            base_url?: string | undefined;
-        }>;
+        token?: string | undefined;
     }, {
-        sources: Record<string, {
-            type: "local" | "github" | "http" | "s3";
-            token?: string | undefined;
-            branch?: string | undefined;
-            bucket?: string | undefined;
-            prefix?: string | undefined;
-            token_env?: string | undefined;
-            base_url?: string | undefined;
-        }>;
+        token?: string | undefined;
     }>>>;
 }, "strict", z.ZodTypeAny, {
     organizationSlug: string;
@@ -652,16 +618,8 @@ declare const CodexConfigSchema: z.ZodObject<{
             fallback_to_public?: boolean | undefined;
         } | undefined;
     } | undefined;
-    dependencies?: Record<string, {
-        sources: Record<string, {
-            type: "local" | "github" | "http" | "s3";
-            token?: string | undefined;
-            branch?: string | undefined;
-            bucket?: string | undefined;
-            prefix?: string | undefined;
-            token_env?: string | undefined;
-            base_url?: string | undefined;
-        }>;
+    remotes?: Record<string, {
+        token?: string | undefined;
     }> | undefined;
 }, {
     organizationSlug: string;
@@ -711,16 +669,8 @@ declare const CodexConfigSchema: z.ZodObject<{
             fallback_to_public?: boolean | undefined;
         } | undefined;
     } | undefined;
-    dependencies?: Record<string, {
-        sources: Record<string, {
-            type: "local" | "github" | "http" | "s3";
-            token?: string | undefined;
-            branch?: string | undefined;
-            bucket?: string | undefined;
-            prefix?: string | undefined;
-            token_env?: string | undefined;
-            base_url?: string | undefined;
-        }>;
+    remotes?: Record<string, {
+        token?: string | undefined;
     }> | undefined;
 }>;
 type CodexConfig = z.infer<typeof CodexConfigSchema>;
@@ -818,6 +768,7 @@ declare const UnifiedConfigSchema: z.ZodObject<{
             region?: string | undefined;
         }>>;
     }, "strip", z.ZodTypeAny, {
+        schema_version: string;
         sources: Record<string, {
             local: {
                 base_path: string;
@@ -834,8 +785,8 @@ declare const UnifiedConfigSchema: z.ZodObject<{
             } | undefined;
             region?: string | undefined;
         }>;
-        schema_version: string;
     }, {
+        schema_version: string;
         sources: Record<string, {
             local: {
                 base_path: string;
@@ -852,7 +803,6 @@ declare const UnifiedConfigSchema: z.ZodObject<{
             } | undefined;
             region?: string | undefined;
         }>;
-        schema_version: string;
     }>>;
     codex: z.ZodOptional<z.ZodObject<{
         organizationSlug: z.ZodString;
@@ -923,7 +873,7 @@ declare const UnifiedConfigSchema: z.ZodObject<{
                 include: string[];
                 exclude?: string[] | undefined;
             }>>;
-            from_codex: z.ZodOptional<z.ZodObject<{
+            from_codex: z.ZodOptional<z.ZodEffects<z.ZodObject<{
                 include: z.ZodArray<z.ZodString, "many">;
                 exclude: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
             }, "strip", z.ZodTypeAny, {
@@ -932,6 +882,12 @@ declare const UnifiedConfigSchema: z.ZodObject<{
             }, {
                 include: string[];
                 exclude?: string[] | undefined;
+            }>, {
+                include: string[];
+                exclude?: string[] | undefined;
+            }, {
+                include: string[];
+                exclude?: string[] | undefined;
             }>>;
             exclude: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
             default_to_codex: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -1020,52 +976,12 @@ declare const UnifiedConfigSchema: z.ZodObject<{
                 fallback_to_public?: boolean | undefined;
             } | undefined;
         }>>;
-        dependencies: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
-            sources: z.ZodRecord<z.ZodString, z.ZodObject<{
-                type: z.ZodEnum<["github", "s3", "http", "local"]>;
-                token_env: z.ZodOptional<z.ZodString>;
-                token: z.ZodOptional<z.ZodString>;
-                branch: z.ZodOptional<z.ZodString>;
-                base_url: z.ZodOptional<z.ZodString>;
-                bucket: z.ZodOptional<z.ZodString>;
-                prefix: z.ZodOptional<z.ZodString>;
-            }, "strip", z.ZodTypeAny, {
-                type: "local" | "github" | "http" | "s3";
-                token?: string | undefined;
-                branch?: string | undefined;
-                bucket?: string | undefined;
-                prefix?: string | undefined;
-                token_env?: string | undefined;
-                base_url?: string | undefined;
-            }, {
-                type: "local" | "github" | "http" | "s3";
-                token?: string | undefined;
-                branch?: string | undefined;
-                bucket?: string | undefined;
-                prefix?: string | undefined;
-                token_env?: string | undefined;
-                base_url?: string | undefined;
-            }>>;
+        remotes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+            token: z.ZodOptional<z.ZodString>;
         }, "strip", z.ZodTypeAny, {
-            sources: Record<string, {
-                type: "local" | "github" | "http" | "s3";
-                token?: string | undefined;
-                branch?: string | undefined;
-                bucket?: string | undefined;
-                prefix?: string | undefined;
-                token_env?: string | undefined;
-                base_url?: string | undefined;
-            }>;
+            token?: string | undefined;
         }, {
-            sources: Record<string, {
-                type: "local" | "github" | "http" | "s3";
-                token?: string | undefined;
-                branch?: string | undefined;
-                bucket?: string | undefined;
-                prefix?: string | undefined;
-                token_env?: string | undefined;
-                base_url?: string | undefined;
-            }>;
+            token?: string | undefined;
         }>>>;
     }, "strict", z.ZodTypeAny, {
         organizationSlug: string;
@@ -1115,16 +1031,8 @@ declare const UnifiedConfigSchema: z.ZodObject<{
                 fallback_to_public?: boolean | undefined;
             } | undefined;
         } | undefined;
-        dependencies?: Record<string, {
-            sources: Record<string, {
-                type: "local" | "github" | "http" | "s3";
-                token?: string | undefined;
-                branch?: string | undefined;
-                bucket?: string | undefined;
-                prefix?: string | undefined;
-                token_env?: string | undefined;
-                base_url?: string | undefined;
-            }>;
+        remotes?: Record<string, {
+            token?: string | undefined;
         }> | undefined;
     }, {
         organizationSlug: string;
@@ -1174,20 +1082,13 @@ declare const UnifiedConfigSchema: z.ZodObject<{
                 fallback_to_public?: boolean | undefined;
             } | undefined;
         } | undefined;
-        dependencies?: Record<string, {
-            sources: Record<string, {
-                type: "local" | "github" | "http" | "s3";
-                token?: string | undefined;
-                branch?: string | undefined;
-                bucket?: string | undefined;
-                prefix?: string | undefined;
-                token_env?: string | undefined;
-                base_url?: string | undefined;
-            }>;
+        remotes?: Record<string, {
+            token?: string | undefined;
         }> | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
     file?: {
+        schema_version: string;
         sources: Record<string, {
             local: {
                 base_path: string;
@@ -1204,7 +1105,6 @@ declare const UnifiedConfigSchema: z.ZodObject<{
             } | undefined;
             region?: string | undefined;
         }>;
-        schema_version: string;
     } | undefined;
     codex?: {
         organizationSlug: string;
@@ -1254,20 +1154,13 @@ declare const UnifiedConfigSchema: z.ZodObject<{
                 fallback_to_public?: boolean | undefined;
             } | undefined;
         } | undefined;
-        dependencies?: Record<string, {
-            sources: Record<string, {
-                type: "local" | "github" | "http" | "s3";
-                token?: string | undefined;
-                branch?: string | undefined;
-                bucket?: string | undefined;
-                prefix?: string | undefined;
-                token_env?: string | undefined;
-                base_url?: string | undefined;
-            }>;
+        remotes?: Record<string, {
+            token?: string | undefined;
         }> | undefined;
     } | undefined;
 }, {
     file?: {
+        schema_version: string;
         sources: Record<string, {
             local: {
                 base_path: string;
@@ -1284,7 +1177,6 @@ declare const UnifiedConfigSchema: z.ZodObject<{
             } | undefined;
             region?: string | undefined;
         }>;
-        schema_version: string;
     } | undefined;
     codex?: {
         organizationSlug: string;
@@ -1334,16 +1226,8 @@ declare const UnifiedConfigSchema: z.ZodObject<{
                 fallback_to_public?: boolean | undefined;
             } | undefined;
         } | undefined;
-        dependencies?: Record<string, {
-            sources: Record<string, {
-                type: "local" | "github" | "http" | "s3";
-                token?: string | undefined;
-                branch?: string | undefined;
-                bucket?: string | undefined;
-                prefix?: string | undefined;
-                token_env?: string | undefined;
-                base_url?: string | undefined;
-            }>;
+        remotes?: Record<string, {
+            token?: string | undefined;
         }> | undefined;
     } | undefined;
 }>;
@@ -1398,6 +1282,41 @@ interface LoadConfigOptions {
 }
 declare function loadConfig(options?: LoadConfigOptions): CodexConfig;
 
+declare const CONFIG_SCHEMA_VERSION: "2.0";
+interface SyncPresetConfig {
+    to_codex: {
+        include: string[];
+        exclude?: string[];
+    };
+    from_codex: {
+        include: string[];
+        exclude?: string[];
+    };
+}
+interface SyncPreset {
+    readonly name: string;
+    readonly description: string;
+    readonly config: {
+        readonly to_codex: {
+            readonly include: readonly string[];
+            readonly exclude?: readonly string[];
+        };
+        readonly from_codex: {
+            readonly include: readonly string[];
+            readonly exclude?: readonly string[];
+        };
+    };
+}
+declare const SYNC_PATTERN_PRESETS: Record<string, SyncPreset>;
+declare const DEFAULT_GLOBAL_EXCLUDES: readonly ["**/.git/**", "**/node_modules/**", "**/.env", "**/.env.*", "**/*.log", "**/dist/**", "**/build/**", "**/.DS_Store", "**/credentials.json", "**/*secret*", "**/*password*"];
+declare function getSyncPreset(name: string): SyncPreset | undefined;
+declare function getSyncPresetNames(): string[];
+declare function substitutePatternPlaceholders(patterns: readonly string[], org: string, codexRepo: string): string[];
+interface GenerateSyncConfigOptions {
+    includeGlobalExcludes?: boolean;
+}
+declare function generateSyncConfigFromPreset(presetName: string, org: string, codexRepo: string, options?: GenerateSyncConfigOptions): SyncPresetConfig | undefined;
+
 interface ShouldSyncOptions {
     filePath: string;
     fileMetadata: Metadata;
@@ -1544,6 +1463,7 @@ declare class StorageManager {
     private priority;
     private codexConfig?;
     constructor(config?: StorageManagerConfig);
+    private resolveTokenValue;
     private resolveToken;
     private resolveFetchOptions;
     registerProvider(provider: StorageProvider): void;
@@ -2237,4 +2157,4 @@ declare function formatSeconds(seconds: number): string;
 declare function isValidDuration(value: string): boolean;
 declare function isValidSize(value: string): boolean;
 
-export { type ArchiveConfig, type ArtifactType, type AutoSyncPattern, AutoSyncPatternSchema, BUILT_IN_TYPES, CODEX_URI_PREFIX, type CacheEntry, type CacheEntryMetadata, type CacheEntryStatus, type CacheLookupResult, CacheManager, type CacheManagerConfig, CachePersistence, type CachePersistenceOptions, type CacheStats, type CodexConfig, CodexConfigSchema, CodexError, type CodexYamlConfig, CommonRules, ConfigurationError, type ConversionOptions, type ConvertedReference, type CustomSyncDestination, type CustomTypeConfig$1 as CustomTypeConfig, CustomTypeSchema, DEFAULT_CACHE_DIR, DEFAULT_FETCH_OPTIONS, DEFAULT_MIGRATION_OPTIONS, DEFAULT_PERMISSION_CONFIG, DEFAULT_SYNC_CONFIG, DEFAULT_TYPE, type DirectionalSyncConfig, type EvaluationResult, type EvaluationSummary, type ExpandEnvOptions, type FetchOptions, type FetchResult, type FileConfig, type FileInfo, FilePluginFileNotFoundError, type FilePluginFileNotFoundErrorOptions, FilePluginStorage, type FilePluginStorageOptions, type FileSyncStatus, GitHubStorage, type GitHubStorageOptions, HttpStorage, type HttpStorageOptions, LEGACY_PATTERNS, LEGACY_REF_PREFIX, type LegacyAutoSyncPattern, type LegacyCodexConfig, type LoadConfigOptions, LocalStorage, type LocalStorageOptions, type Metadata, MetadataSchema, type MigrationChange, type MigrationOptions, type MigrationResult, type ModernCodexConfig, type ModernSyncPattern, PERMISSION_LEVEL_ORDER, type ParseMetadataOptions, type ParseOptions, type ParseResult, type ParsedReference, type PermissionAction, type PermissionConfig, type PermissionContext, PermissionDeniedError, type PermissionLevel$1 as PermissionLevel, PermissionManager, type PermissionManagerConfig, type PermissionResult, type PermissionRule$1 as PermissionRule, type PermissionScope, type PlanStats, type ReadConfigOptions, type ReferenceConversionResult, type ResolveOptions, type ResolveOrgOptions, type ResolvedReference, type SerializedCacheEntry, type ShouldSyncOptions, StorageManager, type StorageManagerConfig, type StorageProvider, type StorageProviderConfig$1 as StorageProviderConfig, type StorageProviderType$1 as StorageProviderType, type SyncConfig$1 as SyncConfig, type SyncDirection, SyncManager, type SyncManagerConfig, type SyncManifest, type SyncManifestEntry, type SyncOperation, type SyncOptions, type SyncPlan, type SyncResult, type SyncRule$1 as SyncRule, type SyncRules, SyncRulesSchema, TTL, TypeRegistry, type TypeRegistryOptions, type TypesConfig$1 as TypesConfig, TypesConfigSchema, type UnifiedConfig, ValidationError, type VersionDetectionResult, type CacheConfig as YamlCacheConfig, type CustomTypeConfig as YamlCustomTypeConfig, type GitHubStorageConfig as YamlGitHubStorageConfig, type HttpStorageConfig as YamlHttpStorageConfig, type LocalStorageConfig as YamlLocalStorageConfig, type McpConfig as YamlMcpConfig, type PermissionLevel as YamlPermissionLevel, type PermissionRule as YamlPermissionRule, type PermissionsConfig as YamlPermissionsConfig, type S3StorageConfig as YamlS3StorageConfig, type StorageProviderConfig as YamlStorageProviderConfig, type StorageProviderType as YamlStorageProviderType, type SyncConfig as YamlSyncConfig, type SyncRule as YamlSyncRule, type TypesConfig as YamlTypesConfig, buildUri, calculateCachePath, calculateContentHash, convertLegacyReference, convertLegacyReferences, convertToUri, createCacheEntry, createCacheManager, createCachePersistence, createDefaultRegistry, createEmptyModernConfig, createEmptySyncPlan, createGitHubStorage, createHttpStorage, createLocalStorage, createPermissionManager, createRule, createRulesFromPatterns, createStorageManager, createSyncManager, createSyncPlan, deserializeCacheEntry, detectContentType, detectCurrentProject, detectVersion, estimateSyncTime, evaluatePath, evaluatePaths, evaluatePatterns, evaluatePermission, evaluatePermissions, expandEnvVars, expandEnvVarsInConfig, extendType, extractEnvVarNames, extractOrgFromRepoName, extractRawFrontmatter, filterByPatterns, filterByPermission, filterPlanOperations, filterSyncablePaths, findLegacyReferences, formatBytes, formatDuration, formatPlanSummary, formatSeconds, generateMigrationReport, generateReferenceMigrationSummary, getBuiltInType, getBuiltInTypeNames, getCacheEntryAge, getCacheEntryStatus, getCurrentContext, getCustomSyncDestinations, getDefaultCacheManager, getDefaultConfig, getDefaultDirectories, getDefaultPermissionManager, getDefaultRules, getDefaultStorageManager, getDirectory, getExtension, getFilename, getMigrationRequirements, getPlanStats, getRelativeCachePath, getRemainingTtl, getTargetRepos, hasContentChanged, hasEnvVars, hasFrontmatter, hasLegacyReferences, hasPermission as hasPermissionLevel, isBuiltInType, isCacheEntryFresh, isCacheEntryValid, isCurrentProjectUri, isLegacyConfig, isLegacyReference, isModernConfig, isAllowed as isPermissionAllowed, isUnifiedConfig, isValidDuration, isValidSize, isValidUri, levelGrants, loadConfig, loadCustomTypes, matchAnyPattern, matchPattern, maxLevel, mergeFetchOptions, mergeRules, mergeTypes, migrateConfig, migrateFileReferences, minLevel, needsMigration, parseCustomDestination, parseDuration, parseMetadata, parseReference, parseSize, parseTtl, readCodexConfig, readUnifiedConfig, resolveOrganization, resolveReference, resolveReferences, ruleMatchesAction, ruleMatchesContext, ruleMatchesPath, sanitizePath, serializeCacheEntry, setDefaultCacheManager, setDefaultPermissionManager, setDefaultStorageManager, shouldSyncToRepo, summarizeEvaluations, touchCacheEntry, validateCustomTypes, validateMetadata, validateMigratedConfig, validateOrg, validatePath, validateRules as validatePermissionRules, validateProject, validateRules$1 as validateRules, validateUri };
+export { type ArchiveConfig, type ArtifactType, type AutoSyncPattern, AutoSyncPatternSchema, BUILT_IN_TYPES, CODEX_URI_PREFIX, CONFIG_SCHEMA_VERSION, type CacheEntry, type CacheEntryMetadata, type CacheEntryStatus, type CacheLookupResult, CacheManager, type CacheManagerConfig, CachePersistence, type CachePersistenceOptions, type CacheStats, type CodexConfig, CodexConfigSchema, CodexError, type CodexYamlConfig, CommonRules, ConfigurationError, type ConversionOptions, type ConvertedReference, type CustomSyncDestination, type CustomTypeConfig$1 as CustomTypeConfig, CustomTypeSchema, DEFAULT_CACHE_DIR, DEFAULT_FETCH_OPTIONS, DEFAULT_GLOBAL_EXCLUDES, DEFAULT_MIGRATION_OPTIONS, DEFAULT_PERMISSION_CONFIG, DEFAULT_SYNC_CONFIG, DEFAULT_TYPE, type DirectionalSyncConfig, type EvaluationResult, type EvaluationSummary, type ExpandEnvOptions, type FetchOptions, type FetchResult, type FileConfig, type FileInfo, FilePluginFileNotFoundError, type FilePluginFileNotFoundErrorOptions, FilePluginStorage, type FilePluginStorageOptions, type FileSyncStatus, type GenerateSyncConfigOptions, GitHubStorage, type GitHubStorageOptions, HttpStorage, type HttpStorageOptions, LEGACY_PATTERNS, LEGACY_REF_PREFIX, type LegacyAutoSyncPattern, type LegacyCodexConfig, type LoadConfigOptions, LocalStorage, type LocalStorageOptions, type Metadata, MetadataSchema, type MigrationChange, type MigrationOptions, type MigrationResult, type ModernCodexConfig, type ModernSyncPattern, PERMISSION_LEVEL_ORDER, type ParseMetadataOptions, type ParseOptions, type ParseResult, type ParsedReference, type PermissionAction, type PermissionConfig, type PermissionContext, PermissionDeniedError, type PermissionLevel$1 as PermissionLevel, PermissionManager, type PermissionManagerConfig, type PermissionResult, type PermissionRule$1 as PermissionRule, type PermissionScope, type PlanStats, type ReadConfigOptions, type ReferenceConversionResult, type ResolveOptions, type ResolveOrgOptions, type ResolvedReference, SYNC_PATTERN_PRESETS, type SerializedCacheEntry, type ShouldSyncOptions, StorageManager, type StorageManagerConfig, type StorageProvider, type StorageProviderConfig$1 as StorageProviderConfig, type StorageProviderType$1 as StorageProviderType, type SyncConfig$1 as SyncConfig, type SyncDirection, SyncManager, type SyncManagerConfig, type SyncManifest, type SyncManifestEntry, type SyncOperation, type SyncOptions, type SyncPlan, type SyncPreset, type SyncPresetConfig, type SyncResult, type SyncRule$1 as SyncRule, type SyncRules, SyncRulesSchema, TTL, TypeRegistry, type TypeRegistryOptions, type TypesConfig$1 as TypesConfig, TypesConfigSchema, type UnifiedConfig, ValidationError, type VersionDetectionResult, type CacheConfig as YamlCacheConfig, type CustomTypeConfig as YamlCustomTypeConfig, type GitHubStorageConfig as YamlGitHubStorageConfig, type HttpStorageConfig as YamlHttpStorageConfig, type LocalStorageConfig as YamlLocalStorageConfig, type McpConfig as YamlMcpConfig, type PermissionLevel as YamlPermissionLevel, type PermissionRule as YamlPermissionRule, type PermissionsConfig as YamlPermissionsConfig, type S3StorageConfig as YamlS3StorageConfig, type StorageProviderConfig as YamlStorageProviderConfig, type StorageProviderType as YamlStorageProviderType, type SyncConfig as YamlSyncConfig, type SyncRule as YamlSyncRule, type TypesConfig as YamlTypesConfig, buildUri, calculateCachePath, calculateContentHash, convertLegacyReference, convertLegacyReferences, convertToUri, createCacheEntry, createCacheManager, createCachePersistence, createDefaultRegistry, createEmptyModernConfig, createEmptySyncPlan, createGitHubStorage, createHttpStorage, createLocalStorage, createPermissionManager, createRule, createRulesFromPatterns, createStorageManager, createSyncManager, createSyncPlan, deserializeCacheEntry, detectContentType, detectCurrentProject, detectVersion, estimateSyncTime, evaluatePath, evaluatePaths, evaluatePatterns, evaluatePermission, evaluatePermissions, expandEnvVars, expandEnvVarsInConfig, extendType, extractEnvVarNames, extractOrgFromRepoName, extractRawFrontmatter, filterByPatterns, filterByPermission, filterPlanOperations, filterSyncablePaths, findLegacyReferences, formatBytes, formatDuration, formatPlanSummary, formatSeconds, generateMigrationReport, generateReferenceMigrationSummary, generateSyncConfigFromPreset, getBuiltInType, getBuiltInTypeNames, getCacheEntryAge, getCacheEntryStatus, getCurrentContext, getCustomSyncDestinations, getDefaultCacheManager, getDefaultConfig, getDefaultDirectories, getDefaultPermissionManager, getDefaultRules, getDefaultStorageManager, getDirectory, getExtension, getFilename, getMigrationRequirements, getPlanStats, getRelativeCachePath, getRemainingTtl, getSyncPreset, getSyncPresetNames, getTargetRepos, hasContentChanged, hasEnvVars, hasFrontmatter, hasLegacyReferences, hasPermission as hasPermissionLevel, isBuiltInType, isCacheEntryFresh, isCacheEntryValid, isCurrentProjectUri, isLegacyConfig, isLegacyReference, isModernConfig, isAllowed as isPermissionAllowed, isUnifiedConfig, isValidDuration, isValidSize, isValidUri, levelGrants, loadConfig, loadCustomTypes, matchAnyPattern, matchPattern, maxLevel, mergeFetchOptions, mergeRules, mergeTypes, migrateConfig, migrateFileReferences, minLevel, needsMigration, parseCustomDestination, parseDuration, parseMetadata, parseReference, parseSize, parseTtl, readCodexConfig, readUnifiedConfig, resolveOrganization, resolveReference, resolveReferences, ruleMatchesAction, ruleMatchesContext, ruleMatchesPath, sanitizePath, serializeCacheEntry, setDefaultCacheManager, setDefaultPermissionManager, setDefaultStorageManager, shouldSyncToRepo, substitutePatternPlaceholders, summarizeEvaluations, touchCacheEntry, validateCustomTypes, validateMetadata, validateMigratedConfig, validateOrg, validatePath, validateRules as validatePermissionRules, validateProject, validateRules$1 as validateRules, validateUri };

package/dist/index.js

@@ -899,12 +899,24 @@ var DirectionalSyncConfigSchema = z.object({
   /** Patterns to exclude (optional) */
   exclude: z.array(z.string()).optional()
 });
+var FromCodexSyncConfigSchema = DirectionalSyncConfigSchema.refine(
+  (config) => {
+    const includeValid = config.include.every(
+      (pattern) => pattern.startsWith("codex://")
+    );
+    const excludeValid = !config.exclude || config.exclude.every((pattern) => pattern.startsWith("codex://"));
+    return includeValid && excludeValid;
+  },
+  {
+    message: 'from_codex patterns must use codex:// URI format (e.g., "codex://{org}/{codex_repo}/docs/**"). Plain paths like "docs/**" are not valid for from_codex.'
+  }
+);
 var DirectionalSyncSchema = z.object({
   // New format (v0.7.0+) - Recommended
-  // Patterns for files to push from this project to codex
+  // Patterns for files to push from this project to codex (plain paths)
   to_codex: DirectionalSyncConfigSchema.optional(),
-  // Patterns for files to pull from codex to this project
-  from_codex: DirectionalSyncConfigSchema.optional(),
+  // Patterns for files to pull from codex to this project (codex:// URIs required)
+  from_codex: FromCodexSyncConfigSchema.optional(),
   // Global exclude patterns (applied to both directions)
   exclude: z.array(z.string()).optional(),
   // Legacy format (deprecated, backward compatible)
@@ -932,25 +944,9 @@ var AuthConfigSchema = z.object({
   /** GitHub authentication configuration */
   github: GitHubAuthConfigSchema.optional()
 });
-var SourceConfigSchema = z.object({
-  /** Source type */
-  type: z.enum(["github", "s3", "http", "local"]),
-  /** Environment variable containing the authentication token */
-  token_env: z.string().optional(),
-  /** Direct token value (not recommended, use token_env instead) */
-  token: z.string().optional(),
-  /** Branch to fetch from (for GitHub sources) */
-  branch: z.string().optional(),
-  /** Base URL (for HTTP sources) */
-  base_url: z.string().optional(),
-  /** Bucket name (for S3 sources) */
-  bucket: z.string().optional(),
-  /** Prefix/path within bucket (for S3 sources) */
-  prefix: z.string().optional()
-});
-var DependencyConfigSchema = z.object({
-  /** Sources within this dependency */
-  sources: z.record(SourceConfigSchema)
+var RemoteConfigSchema = z.object({
+  /** Authentication token - can be direct value or ${ENV_VAR} reference */
+  token: z.string().optional()
 });
 var CodexConfigSchema = z.object({
   organizationSlug: z.string(),
@@ -968,8 +964,9 @@ var CodexConfigSchema = z.object({
   archive: ArchiveConfigSchema.optional(),
   // Authentication configuration
   auth: AuthConfigSchema.optional(),
-  // Dependencies configuration (external projects)
-  dependencies: z.record(DependencyConfigSchema).optional()
+  // Remote repositories configuration (external projects)
+  // Keys are org/project identifiers, values configure authentication
+  remotes: z.record(RemoteConfigSchema).optional()
 }).strict();
 var FileSourceSchema = z.object({
   type: z.enum(["s3", "r2", "gcs", "local"]),
@@ -1214,6 +1211,99 @@ function mergeConfigs(base, override) {
   };
 }
 
+// src/core/config/sync-presets.ts
+var CONFIG_SCHEMA_VERSION = "2.0";
+var SYNC_PATTERN_PRESETS = {
+  standard: {
+    name: "standard",
+    description: "Standard configuration with docs, README, and CLAUDE.md",
+    config: {
+      to_codex: {
+        include: ["docs/**", "README.md", "CLAUDE.md"],
+        exclude: ["*.tmp"]
+      },
+      from_codex: {
+        include: ["codex://{org}/{codex_repo}/docs/**"]
+      }
+    }
+  },
+  minimal: {
+    name: "minimal",
+    description: "Minimal configuration with just docs and README",
+    config: {
+      to_codex: {
+        include: ["docs/**", "README.md"]
+      },
+      from_codex: {
+        include: ["codex://{org}/{codex_repo}/docs/**"]
+      }
+    }
+  }
+};
+var DEFAULT_GLOBAL_EXCLUDES = [
+  "**/.git/**",
+  "**/node_modules/**",
+  "**/.env",
+  "**/.env.*",
+  "**/*.log",
+  "**/dist/**",
+  "**/build/**",
+  "**/.DS_Store",
+  "**/credentials.json",
+  "**/*secret*",
+  "**/*password*"
+];
+function getSyncPreset(name) {
+  return SYNC_PATTERN_PRESETS[name];
+}
+function getSyncPresetNames() {
+  return Object.keys(SYNC_PATTERN_PRESETS);
+}
+function substitutePatternPlaceholders(patterns, org, codexRepo) {
+  if (!org || typeof org !== "string" || org.trim() === "") {
+    throw new ValidationError("org must be a non-empty string");
+  }
+  if (!codexRepo || typeof codexRepo !== "string" || codexRepo.trim() === "") {
+    throw new ValidationError("codexRepo must be a non-empty string");
+  }
+  return patterns.map(
+    (pattern) => pattern.replace(/\{org\}/g, org).replace(/\{codex_repo\}/g, codexRepo)
+  );
+}
+function generateSyncConfigFromPreset(presetName, org, codexRepo, options) {
+  const preset = getSyncPreset(presetName);
+  if (!preset) {
+    return void 0;
+  }
+  let toCodexExclude;
+  if (options?.includeGlobalExcludes) {
+    toCodexExclude = [
+      ...preset.config.to_codex.exclude || [],
+      ...DEFAULT_GLOBAL_EXCLUDES
+    ];
+  } else if (preset.config.to_codex.exclude) {
+    toCodexExclude = [...preset.config.to_codex.exclude];
+  }
+  return {
+    to_codex: {
+      include: [...preset.config.to_codex.include],
+      exclude: toCodexExclude
+    },
+    from_codex: {
+      include: substitutePatternPlaceholders(
+        preset.config.from_codex.include,
+        org,
+        codexRepo
+      ),
+      exclude: preset.config.from_codex.exclude ? substitutePatternPlaceholders(
+        preset.config.from_codex.exclude,
+        org,
+        codexRepo
+      ) : void 0
+    }
+  };
+}
+
 // src/core/routing/evaluator.ts
 init_matcher();
 function shouldSyncToRepo(options) {
@@ -2358,30 +2448,31 @@ var StorageManager = class {
     }
     this.priority = config.priority || (config.filePlugin && config.s3Archive ? ["file-plugin", "local", "s3-archive", "github", "http"] : config.filePlugin ? ["file-plugin", "local", "github", "http"] : config.s3Archive ? ["local", "s3-archive", "github", "http"] : ["local", "github", "http"]);
   }
+  /**
+   * Resolve a token value, expanding ${VAR} references to environment variables
+   */
+  resolveTokenValue(token) {
+    const envVarMatch = token.match(/^\$\{([^}]+)\}$/);
+    if (envVarMatch && envVarMatch[1]) {
+      const envVarName = envVarMatch[1];
+      return process.env[envVarName];
+    }
+    return token;
+  }
   /**
    * Resolve authentication token for a reference
    *
-   * Looks up dependency-specific authentication or falls back to default
+   * Looks up remote-specific authentication or falls back to default
    */
   resolveToken(reference) {
     if (!this.codexConfig) {
       return void 0;
     }
-    const dependencyKey = `${reference.org}/${reference.project}`;
-    if (this.codexConfig.dependencies?.[dependencyKey]) {
-      const dependency = this.codexConfig.dependencies[dependencyKey];
-      for (const [, sourceConfig] of Object.entries(dependency.sources)) {
-        if (sourceConfig.type === "github") {
-          if (sourceConfig.token_env) {
-            const token = process.env[sourceConfig.token_env];
-            if (token) {
-              return token;
-            }
-          }
-          if (sourceConfig.token) {
-            return sourceConfig.token;
-          }
-        }
+    const remoteKey = `${reference.org}/${reference.project}`;
+    if (this.codexConfig.remotes?.[remoteKey]?.token) {
+      const token = this.resolveTokenValue(this.codexConfig.remotes[remoteKey].token);
+      if (token) {
+        return token;
       }
     }
     const defaultTokenEnv = this.codexConfig.auth?.github?.default_token_env || "GITHUB_TOKEN";
@@ -2440,7 +2531,7 @@ var StorageManager = class {
    * Fetch content for a reference
    *
    * Tries providers in priority order until one succeeds.
-   * Automatically resolves authentication based on dependency configuration.
+   * Automatically resolves authentication based on remote configuration.
    */
   async fetch(reference, options) {
     const resolvedOptions = this.resolveFetchOptions(reference, options);
@@ -2472,7 +2563,7 @@ var StorageManager = class {
    * Check if content exists for a reference
    *
    * Returns true if any provider reports the content exists.
-   * Automatically resolves authentication based on dependency configuration.
+   * Automatically resolves authentication based on remote configuration.
    */
   async exists(reference, options) {
     const resolvedOptions = this.resolveFetchOptions(reference, options);
@@ -5115,6 +5206,6 @@ function isValidSize(value) {
   return /^\d+(?:\.\d+)?\s*(B|KB|MB|GB|TB)$/i.test(value);
 }
 
-export { AutoSyncPatternSchema, BUILT_IN_TYPES, CODEX_URI_PREFIX, CacheManager, CachePersistence, CodexConfigSchema, CodexError, CommonRules, ConfigurationError, CustomTypeSchema, DEFAULT_CACHE_DIR, DEFAULT_FETCH_OPTIONS, DEFAULT_MIGRATION_OPTIONS, DEFAULT_PERMISSION_CONFIG, DEFAULT_SYNC_CONFIG, DEFAULT_TYPE, FilePluginFileNotFoundError, FilePluginStorage, GitHubStorage, HttpStorage, LEGACY_PATTERNS, LEGACY_REF_PREFIX, LocalStorage, MetadataSchema, PERMISSION_LEVEL_ORDER, PermissionDeniedError, PermissionManager, StorageManager, SyncManager, SyncRulesSchema, TTL, TypeRegistry, TypesConfigSchema, ValidationError, buildUri, calculateCachePath, calculateContentHash, convertLegacyReference, convertLegacyReferences, convertToUri, createCacheEntry, createCacheManager, createCachePersistence, createDefaultRegistry, createEmptyModernConfig, createEmptySyncPlan, createGitHubStorage, createHttpStorage, createLocalStorage, createPermissionManager, createRule, createRulesFromPatterns, createStorageManager, createSyncManager, createSyncPlan, deserializeCacheEntry, detectContentType, detectCurrentProject, detectVersion, estimateSyncTime, evaluatePath, evaluatePaths, evaluatePatterns, evaluatePermission, evaluatePermissions, expandEnvVars, expandEnvVarsInConfig, extendType, extractEnvVarNames, extractOrgFromRepoName, extractRawFrontmatter, filterByPatterns, filterByPermission, filterPlanOperations, filterSyncablePaths, findLegacyReferences, formatBytes2 as formatBytes, formatDuration, formatPlanSummary, formatSeconds, generateMigrationReport, generateReferenceMigrationSummary, getBuiltInType, getBuiltInTypeNames, getCacheEntryAge, getCacheEntryStatus, getCurrentContext, getCustomSyncDestinations, getDefaultCacheManager, getDefaultConfig, getDefaultDirectories, getDefaultPermissionManager, getDefaultRules, getDefaultStorageManager, getDirectory, getExtension, getFilename, getMigrationRequirements, getPlanStats, getRelativeCachePath, getRemainingTtl, getTargetRepos, hasContentChanged, hasEnvVars, hasFrontmatter, hasLegacyReferences, hasPermission as hasPermissionLevel, isBuiltInType, isCacheEntryFresh, isCacheEntryValid, isCurrentProjectUri, isLegacyConfig, isLegacyReference, isModernConfig, isAllowed as isPermissionAllowed, isUnifiedConfig, isValidDuration, isValidSize, isValidUri, levelGrants, loadConfig, loadCustomTypes, matchAnyPattern, matchPattern, maxLevel, mergeFetchOptions, mergeRules, mergeTypes, migrateConfig, migrateFileReferences, minLevel, needsMigration, parseCustomDestination, parseDuration, parseMetadata, parseReference, parseSize, parseTtl, readCodexConfig, readUnifiedConfig, resolveOrganization, resolveReference, resolveReferences, ruleMatchesAction, ruleMatchesContext, ruleMatchesPath, sanitizePath, serializeCacheEntry, setDefaultCacheManager, setDefaultPermissionManager, setDefaultStorageManager, shouldSyncToRepo, summarizeEvaluations, touchCacheEntry, validateCustomTypes, validateMetadata, validateMigratedConfig, validateOrg, validatePath, validateRules2 as validatePermissionRules, validateProject, validateRules, validateUri };
+export { AutoSyncPatternSchema, BUILT_IN_TYPES, CODEX_URI_PREFIX, CONFIG_SCHEMA_VERSION, CacheManager, CachePersistence, CodexConfigSchema, CodexError, CommonRules, ConfigurationError, CustomTypeSchema, DEFAULT_CACHE_DIR, DEFAULT_FETCH_OPTIONS, DEFAULT_GLOBAL_EXCLUDES, DEFAULT_MIGRATION_OPTIONS, DEFAULT_PERMISSION_CONFIG, DEFAULT_SYNC_CONFIG, DEFAULT_TYPE, FilePluginFileNotFoundError, FilePluginStorage, GitHubStorage, HttpStorage, LEGACY_PATTERNS, LEGACY_REF_PREFIX, LocalStorage, MetadataSchema, PERMISSION_LEVEL_ORDER, PermissionDeniedError, PermissionManager, SYNC_PATTERN_PRESETS, StorageManager, SyncManager, SyncRulesSchema, TTL, TypeRegistry, TypesConfigSchema, ValidationError, buildUri, calculateCachePath, calculateContentHash, convertLegacyReference, convertLegacyReferences, convertToUri, createCacheEntry, createCacheManager, createCachePersistence, createDefaultRegistry, createEmptyModernConfig, createEmptySyncPlan, createGitHubStorage, createHttpStorage, createLocalStorage, createPermissionManager, createRule, createRulesFromPatterns, createStorageManager, createSyncManager, createSyncPlan, deserializeCacheEntry, detectContentType, detectCurrentProject, detectVersion, estimateSyncTime, evaluatePath, evaluatePaths, evaluatePatterns, evaluatePermission, evaluatePermissions, expandEnvVars, expandEnvVarsInConfig, extendType, extractEnvVarNames, extractOrgFromRepoName, extractRawFrontmatter, filterByPatterns, filterByPermission, filterPlanOperations, filterSyncablePaths, findLegacyReferences, formatBytes2 as formatBytes, formatDuration, formatPlanSummary, formatSeconds, generateMigrationReport, generateReferenceMigrationSummary, generateSyncConfigFromPreset, getBuiltInType, getBuiltInTypeNames, getCacheEntryAge, getCacheEntryStatus, getCurrentContext, getCustomSyncDestinations, getDefaultCacheManager, getDefaultConfig, getDefaultDirectories, getDefaultPermissionManager, getDefaultRules, getDefaultStorageManager, getDirectory, getExtension, getFilename, getMigrationRequirements, getPlanStats, getRelativeCachePath, getRemainingTtl, getSyncPreset, getSyncPresetNames, getTargetRepos, hasContentChanged, hasEnvVars, hasFrontmatter, hasLegacyReferences, hasPermission as hasPermissionLevel, isBuiltInType, isCacheEntryFresh, isCacheEntryValid, isCurrentProjectUri, isLegacyConfig, isLegacyReference, isModernConfig, isAllowed as isPermissionAllowed, isUnifiedConfig, isValidDuration, isValidSize, isValidUri, levelGrants, loadConfig, loadCustomTypes, matchAnyPattern, matchPattern, maxLevel, mergeFetchOptions, mergeRules, mergeTypes, migrateConfig, migrateFileReferences, minLevel, needsMigration, parseCustomDestination, parseDuration, parseMetadata, parseReference, parseSize, parseTtl, readCodexConfig, readUnifiedConfig, resolveOrganization, resolveReference, resolveReferences, ruleMatchesAction, ruleMatchesContext, ruleMatchesPath, sanitizePath, serializeCacheEntry, setDefaultCacheManager, setDefaultPermissionManager, setDefaultStorageManager, shouldSyncToRepo, substitutePatternPlaceholders, summarizeEvaluations, touchCacheEntry, validateCustomTypes, validateMetadata, validateMigratedConfig, validateOrg, validatePath, validateRules2 as validatePermissionRules, validateProject, validateRules, validateUri };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map