cf-mcp 0.13.0 → 0.13.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ad39a05c699d135149232079a4fde287ad14f7d9e01f4aac4fac7441c21fdfe6
-  data.tar.gz: 298af20e5926fe580ba1eef84180a8cb05e319cfb72ea3c3f8cfee475beb106f
+  metadata.gz: b6ac6ddc9bfd8c2ba7af914a9abde416092e436ed650ebf153987c2ed6ed5369
+  data.tar.gz: 3f573e333e680a2975bc858179911ae45a4b2382b5ceaeed9ab2432dfec070c9
 SHA512:
-  metadata.gz: 6a118fd341152bf21b4252e4f9da09a02f937a56b9cf0c279cfa2d90d52dd7c3737e2de41717f6a10a8757449fc01f7f600686525f465789c1f87590e35012d1
-  data.tar.gz: 5b91f27293ef5b9048f826eb549deeae63ce5bf950311927bfc59cd4f63fcbfe0bdc37a9204d7eef20c9b6f97a61981fa62c18eaee0196a71e8573885bdb1833
+  metadata.gz: 9c14eb9de223630781010533916abc12999b7186e06dd476d3737a7e66813827806cd5e6b1f1d5571960ea0e3d05bf6025a097ee6c298eb48d1cb90e4fba91f4
+  data.tar.gz: 8427a7e2dd1ccb6cdd785292273199e15afc5644a81eff5ee2904efb464da055449c72b404bb6c6cff56d2f166cc6913011cca82c703ec9aaf1187b20e7b8da5

data/CHANGELOG.md

@@ -5,6 +5,25 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.13.1] - 2026-01-16
+
+### Added
+
+- RBS type signatures for all classes in `sig/cf/mcp.rbs`
+- `rbs` gem added to development dependencies
+- `rake rbs` task for validating RBS signatures (included in default rake task)
+
+### Changed
+
+- Removed title from web UI landing page
+
+## [0.13.0] - 2026-01-16
+
+### Changed
+
+- Refactored server to use single `Server` class (merged `HTTPServer` functionality)
+- Updated MCP protocol version to 2024-11-05
+
 ## [0.12.1] - 2026-01-14
 
 ### Changed
@@ -148,6 +167,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - `cf_list_category` - List items by category
   - `cf_get_details` - Get full documentation by name
 
+[0.13.1]: https://github.com/pusewicz/cf-mcp/compare/v0.13.0...v0.13.1
+[0.13.0]: https://github.com/pusewicz/cf-mcp/compare/v0.12.1...v0.13.0
 [0.12.1]: https://github.com/pusewicz/cf-mcp/compare/v0.12.0...v0.12.1
 [0.12.0]: https://github.com/pusewicz/cf-mcp/compare/v0.10.1...v0.12.0
 [0.10.1]: https://github.com/pusewicz/cf-mcp/compare/v0.10.0...v0.10.1

data/Rakefile

@@ -23,7 +23,12 @@ task :manifest do
   puts "Generated Manifest.txt with #{files.size} files"
 end
 
-task default: %i[test standard manifest]
+desc "Validate RBS type signatures"
+task :rbs do
+  sh "rbs", "-I", "sig", "validate"
+end
+
+task default: %i[test standard rbs manifest]
 
 desc "Deploy to Fly.io (runs tests and linting first)"
 task deploy: %i[test standard] do

data/lib/cf/mcp/server.rb

@@ -136,8 +136,7 @@ module CF
         index.topics.map do |topic|
           ::MCP::Resource.new(
             uri: "cf://topics/#{topic.name}",
-            name: topic.name,
-            title: topic.name.tr("_", " ").split.map(&:capitalize).join(" "),
+            name: topic.name.tr("_", " ").split.map(&:capitalize).join(" "),
             description: topic.brief,
             mime_type: "text/markdown"
           )

data/lib/cf/mcp/version.rb

@@ -2,6 +2,6 @@
 
 module CF
   module MCP
-    VERSION = "0.13.0"
+    VERSION = "0.13.1"
   end
 end

data/sig/cf/mcp.rbs

@@ -2,31 +2,79 @@ module CF
   module MCP
     VERSION: String
 
+    def self.root: () -> Pathname
+
     class Error < StandardError
     end
 
     class Parser
+      DOC_BLOCK_PATTERN: Regexp
+      TAG_PATTERN: Regexp
+      MEMBER_COMMENT_PATTERN: Regexp
+      ENTRY_COMMENT_PATTERN: Regexp
+      CF_ENUM_PATTERN: Regexp
+      SIGNATURE_CLEANUP: Regexp
+      END_MARKER_PATTERN: Regexp
+
       def parse_file: (String path) -> Array[Models::DocItem]
       def parse_directory: (String path) -> Array[Models::DocItem]
     end
 
+    class TopicParser
+      API_LINK_PATTERN: Regexp
+      TOPIC_LINK_PATTERN: Regexp
+      SECTION_PATTERN: Regexp
+      CATEGORY_MAP: Hash[String, String]
+
+      def parse_file: (String path) -> Models::TopicDoc?
+      def parse_directory: (String path) -> Array[Models::TopicDoc]
+      def parse_reading_order: (String index_path) -> Hash[String, Integer]
+    end
+
     class Index
       attr_reader items: Hash[String, Models::DocItem]
       attr_reader by_type: Hash[Symbol, Array[Models::DocItem]]
       attr_reader by_category: Hash[String, Array[Models::DocItem]]
+      attr_reader topic_references: Hash[String, Array[String]]
 
+      def initialize: () -> void
       def add: (Models::DocItem item) -> void
       def find: (String name) -> Models::DocItem?
+      def brief_for: (String name) -> Hash[Symbol, untyped]?
       def search: (String query, ?type: Symbol?, ?category: String?, ?limit: Integer) -> Array[Models::DocItem]
       def functions: () -> Array[Models::DocItem]
       def structs: () -> Array[Models::DocItem]
       def enums: () -> Array[Models::DocItem]
+      def topics: () -> Array[Models::DocItem]
+      def topics_ordered: () -> Array[Models::DocItem]
+      def topics_for: (String api_name) -> Array[Models::DocItem]
       def categories: () -> Array[String]
       def items_in_category: (String category) -> Array[Models::DocItem]
       def size: () -> Integer
       def stats: () -> Hash[Symbol, Integer]
     end
 
+    class IndexBuilder
+      DEFAULT_HEADERS_PATH: String
+
+      attr_reader headers_path: String
+
+      def initialize: (?root: String?, ?download: bool) -> void
+      def build: () ?{ (Symbol, String, Integer) -> void } -> Index
+      def valid?: () -> bool
+    end
+
+    class Downloader
+      CUTE_FRAMEWORK_ZIP_URL: String
+      DEFAULT_DOWNLOAD_DIR: String
+
+      class DownloadError < StandardError
+      end
+
+      def initialize: (?download_dir: String) -> void
+      def download_and_extract: () -> String
+    end
+
     class CLI
       def initialize: (Array[String] args) -> void
       def run: () -> void
@@ -36,14 +84,41 @@ module CF
       attr_reader server: untyped
       attr_reader index: Index
 
+      TOOLS: Array[Class]
+      CORS_HEADERS: Hash[String, String]
+
+      def self.build_rack_app: (?root: String?, ?download: bool) -> untyped
       def initialize: (Index index) -> void
       def run_stdio: () -> void
-      def run_http: (?port: Integer) -> void
-      def run_sse: (?port: Integer) -> void
+      def rack_app: () -> untyped
+
+      class TemplateContext
+        TEMPLATES_DIR: String
+
+        attr_reader version: String
+        attr_reader stats: Hash[Symbol, Integer]
+        attr_reader categories: Array[String]
+        attr_reader topics: Array[Hash[Symbol, String?]]
+        attr_reader tools: Array[Hash[Symbol, String]]
+        attr_reader tool_schemas_json: String
+
+        def initialize: (version: String, stats: Hash[Symbol, Integer], categories: Array[String], topics: Array[Hash[Symbol, String?]], tools: Array[Hash[Symbol, String]], tool_schemas_json: String) -> void
+        def categories_json: () -> String
+        def topics_json: () -> String
+        def css_content: () -> String
+        def changelog_content: () -> String
+        def changelog_json: () -> String
+        def js_content: () -> String
+        def h: (untyped text) -> String
+        def get_binding: () -> Binding
+      end
     end
 
     module Models
       class DocItem
+        GITHUB_REPO: String
+        GITHUB_RAW_BASE: String
+
         attr_accessor name: String?
         attr_accessor type: Symbol?
         attr_accessor category: String?
@@ -53,11 +128,16 @@ module CF
         attr_accessor example_brief: String?
         attr_accessor related: Array[String]
         attr_accessor source_file: String?
+        attr_accessor source_line: Integer?
 
-        def matches?: (String query) -> bool
+        def initialize: (?name: String?, ?type: Symbol?, ?category: String?, ?brief: String?, ?remarks: String?, ?example: String?, ?example_brief: String?, ?related: Array[String], ?source_file: String?, ?source_line: Integer?) -> void
+        def matches?: (String? query) -> bool
+        def relevance_score: (String? query) -> Integer
+        def source_urls: () -> Hash[Symbol, String]?
         def to_h: () -> Hash[Symbol, untyped]
         def to_summary: () -> String
-        def to_text: (?detailed: bool) -> String
+        def to_text: (?detailed: bool, ?index: Index?) -> String
+        def format_related_items: (Index? index) -> String
       end
 
       class FunctionDoc < DocItem
@@ -65,19 +145,154 @@ module CF
         attr_accessor parameters: Array[Parameter]
         attr_accessor return_value: String?
 
-        Parameter: untyped
+        class Parameter < Data
+          attr_reader name: String
+          attr_reader description: String
+        end
+
+        def initialize: (?signature: String?, ?parameters: Array[Parameter], ?return_value: String?, **untyped) -> void
+        def to_h: () -> Hash[Symbol, untyped]
+        def to_summary: () -> String
+        def to_text: (?detailed: bool, ?index: Index?) -> String
       end
 
       class StructDoc < DocItem
         attr_accessor members: Array[Member]
 
-        Member: untyped
+        class Member < Data
+          attr_reader declaration: String
+          attr_reader description: String
+        end
+
+        def initialize: (?members: Array[Member], **untyped) -> void
+        def to_h: () -> Hash[Symbol, untyped]
       end
 
       class EnumDoc < DocItem
         attr_accessor entries: Array[Entry]
 
-        Entry: untyped
+        class Entry < Data
+          attr_reader name: String
+          attr_reader value: String
+          attr_reader description: String
+        end
+
+        def initialize: (?entries: Array[Entry], **untyped) -> void
+        def to_h: () -> Hash[Symbol, untyped]
+      end
+
+      class TopicDoc < DocItem
+        attr_accessor content: String?
+        attr_accessor sections: Array[Section]
+        attr_accessor function_references: Array[String]
+        attr_accessor struct_references: Array[String]
+        attr_accessor enum_references: Array[String]
+        attr_accessor topic_references: Array[String]
+        attr_accessor reading_order: Integer?
+
+        class Section < Data
+          attr_reader title: String
+          attr_reader content: String
+        end
+
+        def initialize: (?content: String?, ?sections: Array[Section], ?function_references: Array[String], ?struct_references: Array[String], ?enum_references: Array[String], ?topic_references: Array[String], ?reading_order: Integer?, **untyped) -> void
+        def all_api_references: () -> Array[String]
+        def to_h: () -> Hash[Symbol, untyped]
+        def to_summary: () -> String
+        def to_text: (?detailed: bool, ?index: Index?) -> String
+      end
+    end
+
+    module Tools
+      module ResponseHelpers
+        def text_response: (String text) -> untyped
+        def error_response: (String message) -> untyped
+      end
+
+      module SearchResultFormatter
+        def format_search_results: (Array[Models::DocItem] results, query: String, type_label: String, limit: Integer, details_tip: String, ?filter_suggestion: String?) -> String
+      end
+
+      class SearchTool
+        extend ResponseHelpers
+        extend SearchResultFormatter
+
+        DETAILS_TIP: String
+
+        def self.call: (query: String, ?type: String?, ?category: String?, ?limit: Integer, ?server_context: Hash[Symbol, untyped]) -> untyped
+      end
+
+      class SearchFunctions
+        extend ResponseHelpers
+        extend SearchResultFormatter
+
+        DETAILS_TIP: String
+
+        def self.call: (query: String, ?category: String?, ?limit: Integer, ?server_context: Hash[Symbol, untyped]) -> untyped
+      end
+
+      class SearchStructs
+        extend ResponseHelpers
+        extend SearchResultFormatter
+
+        DETAILS_TIP: String
+
+        def self.call: (query: String, ?category: String?, ?limit: Integer, ?server_context: Hash[Symbol, untyped]) -> untyped
+      end
+
+      class SearchEnums
+        extend ResponseHelpers
+        extend SearchResultFormatter
+
+        DETAILS_TIP: String
+
+        def self.call: (query: String, ?category: String?, ?limit: Integer, ?server_context: Hash[Symbol, untyped]) -> untyped
+      end
+
+      class ListCategory
+        extend ResponseHelpers
+
+        def self.call: (?category: String?, ?type: String?, ?server_context: Hash[Symbol, untyped]) -> untyped
+      end
+
+      class GetDetails
+        extend ResponseHelpers
+
+        NAMING_TIP: String
+
+        def self.call: (name: String, ?server_context: Hash[Symbol, untyped]) -> untyped
+      end
+
+      class FindRelated
+        extend ResponseHelpers
+
+        def self.call: (name: String, ?server_context: Hash[Symbol, untyped]) -> untyped
+      end
+
+      class ParameterSearch
+        extend ResponseHelpers
+
+        def self.call: (type: String, ?direction: String, ?server_context: Hash[Symbol, untyped]) -> untyped
+      end
+
+      class MemberSearch
+        extend ResponseHelpers
+
+        def self.call: (query: String, ?limit: Integer, ?server_context: Hash[Symbol, untyped]) -> untyped
+      end
+
+      class ListTopics
+        extend ResponseHelpers
+
+        CATEGORY_TIP: String
+
+        def self.call: (?category: String?, ?ordered: bool, ?server_context: Hash[Symbol, untyped]) -> untyped
+      end
+
+      class GetTopic
+        extend ResponseHelpers
+
+        def self.call: (name: String, ?server_context: Hash[Symbol, untyped]) -> untyped
       end
     end
   end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: cf-mcp
 version: !ruby/object:Gem::Version
-  version: 0.13.0
+  version: 0.13.1
 platform: ruby
 authors:
 - Piotr Usewicz