cf-mcp 0.17.2 → 0.19.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 98423800bb5ecaf4605f4ebf9dda9e8a23d0e769d2840d7ea02604ab46b2e82e
-  data.tar.gz: 89d5e7b80786cec6e6304e1acf9f06e1eff0811f7091f77d776742ded9b515df
+  metadata.gz: 8503e2b733dd80a28ab4e44b5435ce8ca334ba25a0bd34a3751c2b986beea8dc
+  data.tar.gz: f4b986ddb96f77b7bc97c5b56384b6aaae88ee73f1f030a184409e64c78cd317
 SHA512:
-  metadata.gz: c5af9f6e8e234fcf8dd3cd9cb074609bd600df1dd7dfb6884d10b993a22bc29dce1d0ad1b7b88b35ac0635089350004eb4a61718f9231a05d5f9f5755e0ff202
-  data.tar.gz: 1aeb2b9475763f1d88a53d870f0513696b2855c3edbdab2652ad08a960b7a17fc6768b99c9ae233243ab509285b4726dcf17f562256b9d887a8759ca0e1dbe4a
+  metadata.gz: e408e0273973b658e8eb883946d350b25a899d901e5f0940bbb4e9cec4e64e3d21287461fdf17141ba21b33e9b03016d4375635115b490b143476c0a5e142554
+  data.tar.gz: 7878980a0bb69c7038055106a803ee68032840ffb9fb37c684ddc99353797c133133c1485405f8342ae98052d974b7771d2e17258cf1474e27df1b90592a6dcf

data/CHANGELOG.md

@@ -5,7 +5,20 @@ 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).
 
-## [Unreleased]
+## [0.19.0] - 2026-09-15
+
+### Added
+
+- Show the Cute Framework revision (git commit SHA) being served at startup and on the dashboard, linked to the commit on GitHub
+- Print progress while parsing header files, when running in a terminal
+
+### Changed
+
+- Updated dependencies, including `mcp` from 0.22.0 to 0.25.0
+
+### Fixed
+
+- `--root` now accepts a Cute Framework project root (as documented) and auto-descends into its `include/` directory; previously this scanned unrelated files and skipped topic indexing entirely
 
 ## [0.17.2] - 2026-02-10
 
@@ -293,6 +306,7 @@ This version was prepared but never released. Changes rolled into 0.17.2.
   - `cf_list_category` - List items by category
   - `cf_get_details` - Get full documentation by name
 
+[0.19.0]: https://github.com/pusewicz/cf-mcp/compare/v0.18.0...v0.19.0
 [0.17.2]: https://github.com/pusewicz/cf-mcp/compare/v0.17.0...v0.17.2
 [0.17.1]: https://github.com/pusewicz/cf-mcp/compare/v0.17.0...v0.17.1
 [0.17.0]: https://github.com/pusewicz/cf-mcp/compare/v0.16.2...v0.17.0

data/Manifest.txt

@@ -4,8 +4,8 @@ Manifest.txt
 README.md
 Rakefile
 config.ru
+config/puma.rb
 exe/cf-mcp
-exe/cf-mcp-wrapper
 lib/cf/mcp.rb
 lib/cf/mcp/cli.rb
 lib/cf/mcp/downloader.rb

data/Rakefile

@@ -9,7 +9,7 @@ require "standard/rake"
 
 desc "Generate Manifest.txt from git ls-files"
 task :manifest do
-  ignore_patterns = %w[bin/ Gemfile .gitignore test/ .github/ .standard.yml cf-mcp.gemspec .ruby-version CLAUDE.md AGENTS.md fly.toml Procfile Dockerfile .dockerignore .claude/ .mcp.json]
+  ignore_patterns = %w[bin/ Gemfile .gitignore test/ .github/ .standard.yml cf-mcp.gemspec .ruby-version CLAUDE.md AGENTS.md fly.toml Procfile Dockerfile .dockerignore .claude/ .mcp.json .serena/]
 
   files = IO.popen(%w[git ls-files -z], chdir: __dir__, err: IO::NULL) do |ls|
     ls.readlines("\x0", chomp: true)

data/config/puma.rb

@@ -0,0 +1,17 @@
+# Puma configuration for Fly.io deployment
+# Optimized for low memory usage on shared-cpu-1x (256MB RAM)
+
+# Single worker process (no forking) to save memory
+workers 0
+
+# Minimal threads for light MCP traffic
+threads 2, 2
+
+# Preload application for faster startup and lower memory footprint
+preload_app!
+
+# Bind to all interfaces
+bind "tcp://0.0.0.0:#{ENV.fetch("PORT", 8080)}"
+
+# Disable stats since we're running a single worker
+activate_control_app false

data/exe/cf-mcp

@@ -1,7 +1,6 @@
 #!/usr/bin/env ruby
 # frozen_string_literal: true
 
-require "bundler/setup"
 require "cf/mcp"
 
 CF::MCP::CLI.new(ARGV).run

data/lib/cf/mcp/cli.rb

@@ -97,8 +97,9 @@ module CF
           warn "Indexed #{count} topics from: #{path}" if event == :topics_indexed
         end
         warn "Indexed #{index.stats[:total]} items (#{index.stats[:functions]} functions, #{index.stats[:structs]} structs, #{index.stats[:enums]} enums)"
+        warn "Cute Framework revision: #{builder.revision}" if builder.revision
 
-        server = Server.new(index)
+        server = Server.new(index, revision: builder.revision)
         server.run_stdio
       end
 

data/lib/cf/mcp/downloader.rb

@@ -15,6 +15,8 @@ module CF
 
       class DownloadError < StandardError; end
 
+      attr_reader :sha
+
       def initialize(download_dir: DEFAULT_DOWNLOAD_DIR)
         @download_dir = download_dir
       end
@@ -30,6 +32,7 @@ module CF
         # Check if cache is valid
         stored_sha = read_sha_metadata(sha_file)
         latest_sha = fetch_latest_sha
+        @sha = latest_sha
 
         if stored_sha && latest_sha && stored_sha == latest_sha
           if File.directory?(include_path) && !Dir.empty?(include_path)

data/lib/cf/mcp/index_builder.rb

@@ -1,11 +1,13 @@
 # frozen_string_literal: true
 
+require "open3"
+
 module CF
   module MCP
     class IndexBuilder
       DEFAULT_HEADERS_PATH = File.expand_path("~/Work/GitHub/pusewicz/cute_framework/include")
 
-      attr_reader :headers_path
+      attr_reader :headers_path, :revision
 
       def initialize(root: nil, download: false)
         @headers_path = resolve_headers_path(root: root, download: download)
@@ -41,20 +43,45 @@ module CF
       private
 
       def resolve_headers_path(root:, download:)
-        return root if root
-        return ENV["CF_HEADERS_PATH"] if ENV["CF_HEADERS_PATH"]
+        if root
+          @revision = detect_git_revision(root)
+          nested_include = File.join(root, "include")
+          return File.directory?(nested_include) ? nested_include : root
+        end
+
+        if (env_path = ENV["CF_HEADERS_PATH"])
+          @revision = detect_git_revision(env_path)
+          return env_path
+        end
 
         if download
           warn "Downloading Cute Framework headers from GitHub..."
           downloader = Downloader.new
           path = downloader.download_and_extract
+          @revision = downloader.sha
           warn "Downloaded headers to: #{path}"
           return path
         end
 
+        @revision = detect_git_revision(DEFAULT_HEADERS_PATH)
         DEFAULT_HEADERS_PATH
       end
 
+      # Detects the current git commit SHA for a local Cute Framework checkout.
+      # `path` may be the repo root or any subdirectory within it (e.g. include/) -
+      # git walks up to find the enclosing repository either way.
+      def detect_git_revision(path)
+        return nil unless File.directory?(path)
+
+        stdout, _stderr, status = Open3.capture3("git", "-C", path, "rev-parse", "--short", "HEAD")
+        return nil unless status.success?
+
+        sha = stdout.strip
+        sha.empty? ? nil : sha
+      rescue Errno::ENOENT
+        nil
+      end
+
       def find_topics_path(headers_path)
         # If headers_path is .../cute_framework/include, topics is at .../cute_framework/docs/topics
         base = File.dirname(headers_path)

data/lib/cf/mcp/parser.rb

@@ -32,6 +32,7 @@ module CF
       def parse_directory(path)
         items = []
         Dir.glob(File.join(path, "**/*.h")).each do |header_file|
+          warn "Parsing #{header_file}" if $stderr.isatty
           items.concat(parse_file(header_file))
         end
         items

data/lib/cf/mcp/server.rb

@@ -5,7 +5,9 @@ require "mcp"
 module CF
   module MCP
     class Server
-      attr_reader :server, :index
+      attr_reader :server, :index, :revision
+
+      CUTE_FRAMEWORK_COMMIT_URL_TEMPLATE = "https://github.com/RandyGaul/cute_framework/commit/%{revision}"
 
       CORS_HEADERS = {
         "access-control-allow-origin" => "*",
@@ -30,16 +32,18 @@ module CF
           warn "Indexed #{count} topics from: #{path}" if event == :topics_indexed
         end
         warn "Indexed #{index.stats[:total]} items (#{index.stats[:functions]} functions, #{index.stats[:structs]} structs, #{index.stats[:enums]} enums)"
+        warn "Cute Framework revision: #{builder.revision}" if builder.revision
 
-        new(index).rack_app
+        new(index, revision: builder.revision).rack_app
       end
 
       PROTOCOL_VERSION = "2025-03-26"
       WEBSITE_URL = ENV.fetch("FLY_APP_NAME", nil) ? "https://#{ENV["FLY_APP_NAME"]}.fly.dev" : "https://cf-mcp.fly.dev"
       PUBLIC_DIR = File.join(__dir__, "public")
 
-      def initialize(index)
+      def initialize(index, revision: nil)
         @index = index
+        @revision = revision
 
         configuration = ::MCP::Configuration.new(protocol_version: PROTOCOL_VERSION)
         @server = ::MCP::Server.new(
@@ -190,6 +194,8 @@ module CF
           context = TemplateContext.new(
             version: CF::MCP::VERSION,
             protocol_version: PROTOCOL_VERSION,
+            revision: @revision,
+            revision_url: @revision && format(CUTE_FRAMEWORK_COMMIT_URL_TEMPLATE, revision: @revision),
             stats: index.stats,
             categories: index.categories.sort,
             topics: index.topics_ordered.map { |t| {name: t.name, brief: t.brief} },
@@ -213,11 +219,13 @@ module CF
       class TemplateContext
         TEMPLATES_DIR = File.join(__dir__, "templates")
 
-        attr_reader :version, :protocol_version, :stats, :categories, :topics, :tools, :tool_schemas_json
+        attr_reader :version, :protocol_version, :revision, :revision_url, :stats, :categories, :topics, :tools, :tool_schemas_json
 
-        def initialize(version:, protocol_version:, stats:, categories:, topics:, tools:, tool_schemas_json:)
+        def initialize(version:, protocol_version:, revision:, revision_url:, stats:, categories:, topics:, tools:, tool_schemas_json:)
           @version = version
           @protocol_version = protocol_version
+          @revision = revision
+          @revision_url = revision_url
           @stats = stats
           @categories = categories
           @topics = topics

data/lib/cf/mcp/templates/index.erb

@@ -55,6 +55,12 @@
       <th>Protocol Version</th>
       <td><%= protocol_version %></td>
     </tr>
+    <% if revision %>
+    <tr>
+      <th>Cute Framework Revision</th>
+      <td><a href="<%= h(revision_url) %>"><%= h(revision) %></a></td>
+    </tr>
+    <% end %>
   </table>
 
   <h2>Endpoints</h2>

data/lib/cf/mcp/version.rb

@@ -2,6 +2,6 @@
 
 module CF
   module MCP
-    VERSION = "0.17.2"
+    VERSION = "0.19.0"
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: cf-mcp
 version: !ruby/object:Gem::Version
-  version: 0.17.2
+  version: 0.19.0
 platform: ruby
 authors:
 - Piotr Usewicz
@@ -9,20 +9,34 @@ bindir: exe
 cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: listen
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.10'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.10'
 - !ruby/object:Gem::Dependency
   name: mcp
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.6'
+        version: '0.25'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.6'
+        version: '0.25'
 - !ruby/object:Gem::Dependency
   name: puma
   requirement: !ruby/object:Gem::Requirement
@@ -85,7 +99,6 @@ email:
 - piotr@layer22.com
 executables:
 - cf-mcp
-- cf-mcp-wrapper
 extensions: []
 extra_rdoc_files: []
 files:
@@ -95,8 +108,8 @@ files:
 - README.md
 - Rakefile
 - config.ru
+- config/puma.rb
 - exe/cf-mcp
-- exe/cf-mcp-wrapper
 - lib/cf/mcp.rb
 - lib/cf/mcp/cli.rb
 - lib/cf/mcp/downloader.rb
@@ -155,7 +168,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.6
+rubygems_version: 4.0.12
 specification_version: 4
 summary: MCP server providing documentation tools for Cute Framework
 test_files: []

data/exe/cf-mcp-wrapper

@@ -1,8 +0,0 @@
-#!/bin/bash
-source /opt/homebrew/share/chruby/chruby.sh
-
-PROJECT_DIR="$(cd "$(dirname "$0")/.." && pwd)"
-chruby "$(cat "$PROJECT_DIR/.ruby-version")"
-
-export BUNDLE_GEMFILE="$PROJECT_DIR/Gemfile"
-exec "$PROJECT_DIR/exe/cf-mcp" "$@"