Module: RailsAiBridge::Registry

Defined in:
lib/rails_ai_bridge/registry.rb,
lib/rails_ai_bridge/registry/lockfile.rb,
lib/rails_ai_bridge/registry/resolver.rb,
lib/rails_ai_bridge/registry/truncatable.rb,
lib/rails_ai_bridge/registry/pack_detector.rb,
lib/rails_ai_bridge/registry/pack_resolver.rb,
lib/rails_ai_bridge/registry/source_parser.rb,
lib/rails_ai_bridge/registry/tile_manifest.rb,
lib/rails_ai_bridge/registry/rake_presenter.rb,
lib/rails_ai_bridge/registry/resolver_cache.rb,
lib/rails_ai_bridge/registry/pack_definition.rb,
lib/rails_ai_bridge/registry/context_tool_spec.rb,
lib/rails_ai_bridge/registry/registry_manifest.rb,
lib/rails_ai_bridge/registry/frontmatter_parser.rb,
lib/rails_ai_bridge/registry/skill_source_resolver.rb,
lib/rails_ai_bridge/registry/context_provider_definition.rb

Overview

Registry resolution system for skill packs.

Provides priority-based loading of skill packs from git repositories, deprecation redirect handling, and framework auto-detection.

See Also:

Defined Under Namespace

Modules: GitRunner, SourceParser, Truncatable Classes: AgentEntry, ContextProviderDefinition, ContextToolSpec, DefaultGitRunner, DeprecatedEntry, DetectedFramework, FrontmatterParser, LoadedPack, Lockfile, PackDefinition, PackDetector, PackResolver, RakePresenter, RegistryManifest, ResolvedSkill, Resolver, ResolverCache, SkillEntry, SkillSourceResolver, SkillSummary, TileManifest

Constant Summary collapse

REQUEST_RESOLVER_KEY =

This constant is part of a private API. You should avoid using this constant if possible, as it may be removed or be changed in the future.

Thread-local key for the request-scoped resolver.

:rails_ai_bridge_request_resolver

Class Method Summary collapse

Class Method Details

.build_resolver(config = RailsAiBridge.configuration.registry) ⇒ Resolver?

Builds (or returns a cached) Resolver from the current Config::Registry.

The first call for a given TTL window loads the manifest from disk, wires the SkillSourceResolver and PackResolver pipeline, and caches the result. Subsequent calls within the TTL window return the same resolver without I/O.

When inside a with_request_resolver block, the first successful build is memoized for the remainder of the request so multiple tool calls in the same request cycle share a single resolver without risking a mid-request rebuild.

Returns nil when the registry manifest file does not exist, allowing callers to surface a helpful setup message rather than raising. A nil result is never cached — the next call will retry.

Parameters:

Returns:

  • (Resolver, nil) —

    wired resolver, or nil if manifest file is missing



115
116
117
118
119
120
121
 
# File 'lib/rails_ai_bridge/registry.rb', line 115

def self.build_resolver(config = RailsAiBridge.configuration.registry)
  return request_resolver if request_resolver?

  resolver = resolver_cache.fetch(config) { build_resolver_uncached(config) }
  store_request_resolver(resolver) if request_active?
  resolver
end

.clear_request_resolver! ⇒ void

This method returns an undefined value.

Clears the request-scoped resolver for the current thread, if any.



95
96
97
 
# File 'lib/rails_ai_bridge/registry.rb', line 95

def self.clear_request_resolver!
  Thread.current[REQUEST_RESOLVER_KEY] = nil
end

.invalidate_resolver_cache! ⇒ void

This method returns an undefined value.

Discards the cached resolver so the next build_resolver call rebuilds from disk.

Call this after clearing the git cache or modifying the registry manifest at runtime.



72
73
74
 
# File 'lib/rails_ai_bridge/registry.rb', line 72

def self.invalidate_resolver_cache!
  @resolver_cache_mutex.synchronize { @resolver_cache&.invalidate! }
end

.resolver_cache ⇒ Object

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Returns the module-level ResolverCache instance, creating it on first call.



61
62
63
64
65
 
# File 'lib/rails_ai_bridge/registry.rb', line 61

def self.resolver_cache
  @resolver_cache_mutex.synchronize do
    @resolver_cache ||= ResolverCache.new
  end
end

.with_request_resolver { ... } ⇒ Object

Wraps a block in a request scope so that build_resolver is called at most once per request cycle. The first build_resolver call within the block stores the result in a thread-local; subsequent calls return the same resolver without touching the TTL cache. The thread-local is always cleared when the block exits, even on error.

Yields:

  • block to execute within the request scope

Returns:

  • (Object) —

    the block result



84
85
86
87
88
89
90
 
# File 'lib/rails_ai_bridge/registry.rb', line 84

def self.with_request_resolver
  previous = Thread.current[REQUEST_RESOLVER_KEY]
  Thread.current[REQUEST_RESOLVER_KEY] = nil
  yield
ensure
  Thread.current[REQUEST_RESOLVER_KEY] = previous
end

.write_lockfile(config = RailsAiBridge.configuration.registry) ⇒ void

This method returns an undefined value.

Writes a lockfile containing the current HEAD commit SHA for every pack in the registry manifest.

Parameters:

Raises:

  • (ArgumentError) —

    when the manifest file does not exist



153
154
155
156
157
158
159
160
161
162
 
# File 'lib/rails_ai_bridge/registry.rb', line 153

def self.write_lockfile(config = RailsAiBridge.configuration.registry)
  manifest_path = config.registry_manifest_path
  raise ArgumentError, "Registry manifest not found at #{manifest_path}" unless File.exist?(manifest_path)

  manifest = RegistryManifest.from_file(manifest_path)
  git_runner = DefaultGitRunner.new(timeout: config.git_timeout)
  source_resolver = SkillSourceResolver.new(config.skill_cache_dir, git_runner, pull_ttl: config.git_pull_ttl)

  Lockfile.write(config.lockfile_path, manifest, source_resolver)
end