Skip to contents

rairai (development version)

rairai 0.2.7

  • Construct CRAN tool definitions when the server starts instead of during package installation.
  • Fix schema extraction in tests and the vignette with mcplite 0.2.0, retaining compatibility with 0.1.0.
  • Revise the package title and remove internal-helper examples following CRAN review.

rairai 0.2.6

  • Source navigation, R6 tools, test lookup, and overview source summaries now reject discovered symlink escapes before reads or cached-fact reuse.

rairai 0.2.5

  • Every package-local MCP tool now accepts a call-local absolute package_root override and reports its canonical effective root, while serve(path = ...) remains the immutable default.

rairai 0.2.4

  • package_news() now uses Markdown outline ancestry to keep nested categories within releases while leaving generic sibling sections outside release ranges.

rairai 0.2.3

  • definition() and refactor_context() now expose the resolved definition only once instead of duplicating it in singleton collections.

rairai 0.2.2

  • Package-local MCP tools now inspect the active serve(path = ...) root regardless of the process working directory.

rairai 0.2.1

  • Source-index tools now reuse cached per-file facts across repeated calls, improving warm symbols(), definition(), references(), function_formals(), and refactor_context() performance while preserving same-service freshness.

rairai 0.2.0

  • serve() now runs fully in-process without a language-server runtime; the public diagnostics() tool was removed and package-qualified function_formals() now returns a static limitation with help-tool next steps.
  • Code-location tools now keep location exact and add optional pathless leading_comment_lines for immediately preceding comments on source-object, test-block, and R6 records.
  • MCP tool schemas now correctly mark optional/defaulted arguments as optional.
  • Dedicated R6 tools now use Tree-sitter syntax facts, inspect flat R/*.[Rr] package source, report Tree-sitter parse-error partiality without text fallback, and include r6_method_references() target-resolution metadata.
  • Local function_formals() now resolves unqualified package helpers through package-wide Tree-sitter lookup; source-index navigation outputs now include truncation metadata, R6 member reference caveats, and no public declaration-inclusion option.
  • Local symbols(), definition(), references(), function_formals(), and refactor_context() now use a Tree-sitter source index for package-local navigation and require R >= 4.3.0 with treesitter and treesitter.r.
  • Removed the direct dplyr dependency.

rairai 0.1.2

  • MCP tool-call errors now use JSON text thrown from rairai tools and handled by mcplite as isError = true results.

rairai 0.1.1

  • LSP-backed tools now normalize in-root absolute paths and file:// URIs to package-root-relative paths and reject out-of-root paths with structured errors.
  • symbols(path = "R") now treats the source directory as a flat R/*.R prefix scan instead of trying to open R as a document.
  • serve() now accepts a path argument for explicitly selecting the target package root without calling setwd() first.
  • Documentation tools now include install guidance when a requested package is not installed or has no Rd database.

rairai 0.1.0

  • Top-level MCP tool failures now return error tool results so clients can set isError = true, while successful and partial-success payloads remain JSON values.
  • New cran_search() and cran_package() tools search ranked CRAN package metadata and return DESCRIPTION-like package details using pkgsearch.
  • Improve tool performance.

rairai 0.0.1

  • package_dependencies(), package_overview(), and package_files() now report structured partial errors for malformed metadata, unavailable dependency metadata, and unreadable line counts.
  • function_formals() source fallback now recognizes same-line <- function assignments when language-server signature help is unavailable.
  • package_vignettes() now falls back to exact article-like installed help topics when packages ship those instead of standard vignettes, using stable topic names and reporting ambiguous matches.
  • r6_method_references() now reports distinct source lines for repeated method calls in the same file.
  • tests_for() now groups repeated hits by enclosing test block while preserving concrete hit locations.
  • refactor_context() now exposes static test text hits separately from language-server references.
  • package_overview() now previews source objects by default while preserving full source-object counts.
  • symbols() now reports file_outline status for file-scoped outline requests.
  • help_search() now suggests follow-up tools when local Rd search finds no matches.
  • r6_classes() and top-level r6_class() locations now report full class definition line ranges when available.
  • package_docs() and help_search() now report structured local Rd limitations when generated source documentation is missing or unreadable.
  • New package_docs() tool returns a compact documentation map with help topics, vignette summaries, NEWS summaries, and next-tool hints.
  • help_search() now requires a non-empty query, supports optional package scoping, and returns compact ranked matches with match metadata.
  • help_page() now reports available, requested, matched, and missing sections when retrieving section-limited help pages.
  • package_namespace() now returns a merged package-keyed import map with compact default object lists, focused package expansion, S3 method registrations, and dynamic library declarations.
  • package_overview() now returns the redesigned six-section orientation map with full DESCRIPTION fields, namespace exports, compact file layout, documentation/test summaries, and complete top-level source object indexing.
  • package_dependencies() now returns all dependency varieties as concise strings with version requirements, plus top-level remotes and Config/Needs/* entries.
  • package_files(scope = "all") now returns every non-gitignored file under the package root instead of only the focused R, tests, man, and vignettes scopes.
  • Empty symbols() results now include structured next_tools hints for fallback discovery routes.
  • references() and related refactor outputs now filter internal synthetic signature documents from returned reference locations.
  • Location-bearing tool outputs now use compact exact location strings such as R/foo.R:12-18 instead of separate path and line range fields.
  • r6_class() now reports member source locations for fields, methods, and active bindings.
  • r6_method() now returns exact file-sliced method source and reports a structured error when exact source cannot be resolved.
  • serve() now exposes a single concise public toolset and no longer registers backend-shaped LSP tools such as workspace_symbols(), document_symbols(), find_symbol(), or positional definition/reference tools.
  • refactor_context() now includes related tests, namespace export metadata, and structured next-tool hints for safe-change workflows.
  • New symbols(), definition(), and references() tools provide the redesigned name/path-based public navigation interface.
  • New package_overview() tool provides a compact first-look package orientation summary, and tests_for() replaces the public find_test_for_symbol() MCP tool.
  • package_news() replaces pkg_news() and now returns structured NEWS overviews by default, with version and keyword filters for focused entries.
  • help_search() now returns bounded results by default and supports limit and offset pagination metadata for large result sets.
  • Removed the redundant serve() profile argument; serve() now exposes the complete public tool surface without profiles.
  • New r6_method(class, method) tool: returns exact file-sliced source for a specific method on a named R6 class. Reports the section (public, private, or active), signature, and source location.
  • New r6_method_references(class, method) tool: searches the codebase for call sites of the form obj$method() using AST analysis on parseable files and heuristic pattern matching as a fallback. Returns concrete call-site locations, the receiver object, and call text.
  • New r6_classes() tool: lists all R6 classes in the package’s R/ directory with exact source locations and inheritance.
  • New r6_class(name) tool: returns the full structure of a named R6 class, including all public, private, and active members with their kinds and signatures.
  • New package_news() tool: reads structured NEWS.md or NEWS content for a package. Supports optional version and keyword filtering to narrow output. Works for the local package under development and installed packages.
  • New package_vignettes() tool: lists available vignettes for a package and retrieves their content as plain text. Works for the local package under development and installed packages.
  • diagnostics() gains an optional severity argument ("Error", "Warning", "Information", "Hint") to filter results by severity level. NULL, "", and "all" return all severities (P9-safe).
  • Definition location results from symbol_definition(), symbol_definition_by_name(), and refactor_context() use compact exact source-object locations.
  • New tests_for() tool: searches test files for mentions of a symbol by name and returns compact 1-based locations. Supports W6 (add or update tests).
  • New help_page() tool: retrieves and renders an R help page as plain readable text. Searches the package under development first (in-source Rd files), then falls back to installed packages. Supports optional sections filtering and max_chars truncation to control response length.
  • New help_search() tool: searches R help pages for a query string and returns matching topics with their package and a brief description.
  • New refactor_context() tool: returns definition location, all references, namespace export status, and diagnostics for the definition file — all in one call. Supports W3 (refactor without guessing).