Renamed putior_skills() to putior_guide(). The function, its MCP tool
(putior_guide), and its ACP operation (guide) all use the new name.
putior_help("skills") still works as an alias for backward compatibility.
The inst file was renamed from SKILLS.md to GUIDE.md, and the vignette
from skills.Rmd to ai-integration.Rmd. (#41)
put(), put_auto(), put_generate(), and put_merge() now default to
recursive = TRUE (previously FALSE). Directory scans now include
subdirectories by default. Pass recursive = FALSE for the old behavior.
(#34)
show_source_info = TRUE using <small> HTML tags that are unsupported
by GitHub's Mermaid renderer. Source file names are now shown without HTML
formatting tags. (#32)|) in node labels breaking Mermaid diagram parsing.
Pipes are now escaped using the #124; entity. (#33)putior_mcp_server() to expose putior functions as MCP tools for AI assistantsputior_mcp_tools() to get/filter tool definitions for custom MCP integrationsput, put_diagram, put_auto, put_generate, put_merge,
get_comment_prefix, get_supported_extensions, list_supported_languages,
get_detection_patterns, get_diagram_themes, putior_guide, putior_help,
set_putior_log_level, is_valid_put_annotation, split_file_list, ext_to_languageputior_acp_server() to expose putior as an ACP agent for inter-agent
communication via REST APIputior_acp_manifest() for agent discovery# (R, Python, Shell, etc.), -- (SQL, Lua, Haskell),
// (JavaScript, TypeScript, C/C++, Go, Rust, Java, etc.), % (MATLAB, LaTeX)get_comment_prefix(), get_supported_extensions(), ext_to_language()list_supported_languages() to enumerate all supported languagesR/language_registry.R)put_auto() for automatic workflow detection from code analysisput_generate() for generating PUT annotation comments (roxygen2-style)
output = "raw" for programmatic accessput_merge() for combining manual and auto-detected annotations
viridis: Purple-blue-green-yellow (general accessibility)magma: Purple-red-yellow (high contrast, print-friendly)plasma: Purple-pink-orange-yellow (presentations)cividis: Blue-gray-yellow (deuteranopia/protanopia optimized)put_theme() for creating custom color palettes (#39)palette parameter on put_diagram() accepts putior_theme objects/* */ and /** */ block comments (#37)* put as line prefix inside block bodies for all //-prefix languagesexclude parameter to put(), put_auto(), put_generate(), and
put_merge() for regex-based file exclusion (#38).wgsl with // comment prefix (#31).FILENAME_MAP (#35).FILENAME_MAP (#36)show_source_info parameter to put_diagram() for displaying source file
information in diagram nodessource_info_style parameter with "inline" and "subgraph" display optionsenable_clicks parameter to put_diagram() for making nodes clickableclick_protocol parameter: "vscode", "file", "rstudio"logger package integration for debugging annotation parsingset_putior_log_level() for configurationlog_level parameter on core functionsputior_workflow S3 classprint.putior_workflow() for concise workflow summariessummary.putior_workflow() for structured summary informationnode_type values across vignettes and reference (#40)inst/cheatsheet/putior-cheatsheet.qmd)inst/examples/putior_guide() and putior_help() for in-session referenceresolve_label() internal helper to reduce code duplication in diagram generationsanitize_acp_path() for ACP input validationnormalize_path_for_url() for cross-platform path handlinggenerate_click_url() for creating protocol-specific URLsgenerate_click_directives() for Mermaid click action generationgenerate_file_subgraphs() for file-based node groupingput_generate() called with invalid output = "raw" (now supported)name instead of id in examples1:nrow() loops with seq_len(nrow()) to handle empty data frames%||% operator from acp.R to zzz.R for shared access.LANGUAGES_WITH_DETECTION in language_registry.R)output parameter across put_diagram(), put_generate(), and
putior_guide() -- all now support "raw"resolve_label() helperputior_workflow class inherits from data.frame, preserving compatibilityput() function for extracting workflow annotations from source code filesput_diagram() function for creating Mermaid flowchart diagramsis_valid_put_annotation() for validating annotation syntaxid field is omitted from annotationsoutput field is omittedname to id for better graph theory alignment