NEWS

---

birddog 1.0.6

New features

• sniff_trajectory_destination(): track where the papers of an incomplete trajectory (one that stops before the last year) end up. Takes a detect_main_trajectories() result and a traj_id, follows the terminal node's documents forward, and returns the final-year destiny vector, the dormant share, the dominant continuation group, and a per-year flow table. With the optional all_detected argument (all groups' detect_main_trajectories() outputs) it also resolves the destination at the trajectory level, identifying which living trajectory absorbed the stagnant one (destination_traj, continuation_traj).
• plot_trajectory_destination(): render the destinations from sniff_trajectory_destination() as variable-width lines on a Sugiyama time layout, matching plot_group_trajectories_lines_2d(). Each destination is one line whose width tracks the papers carried; color_by switches between destination group and destination trajectory, and min_prop folds minor destinations into a grey (other) line.
• plot_trajectory_handoff(): draw the stagnant trajectory and the trajectory that absorbed it as two timelines on a shared year axis, with an arrow at the handoff year.
• sniff_citations_cycle_time(): new normalize argument ("none" | "domain") to divide each group's annual CCT by the per-year network median, enabling within-domain comparability following Lee (2024).
• sniff_citations_cycle_time(): new dispersion argument (logical) that adds p25 and p75 columns to the returned data tibble, useful for detecting bimodal citation-age distributions.
• sniff_citations_cycle_time(): new citation_scope argument ("global" | "local") to restrict CCT to intra-corpus citations. Currently supported for OpenAlex data; Web of Science data falls back to "global" with a warning.

birddog 1.0.5

Bug fixes

• sniff_groups_terms(): replace base tolower() with stringr::str_to_lower() to avoid locale-dependent failures on non-ASCII UTF-8 text.
• sniff_groups_terms(): fix tryCatch scoping bug where error-handler assignments to stats[[i]] were lost, causing purrr::map_int(stats, nrow) to abort the whole run on a single failing group. Skipped groups are now dropped cleanly via purrr::compact().

birddog 1.0.4 (2026-04-04)

New features

• mixed_sort(): exported for external use, with improved documentation.
• plot_group_trajectories_lines_2d(): new width_by_traj_size parameter to scale line width by trajectory size (default TRUE).
• plot_group_trajectories_lines_3d(): new width_by_traj_size parameter to scale line width by trajectory size (default TRUE).

Improvements

• Rewrite vignette with biogas dataset and gallery-with-code format.
• Fix README: wrong package name and CRAN URL, add Features section.

birddog 1.0.2

New features

• sniff_key_route(): support for multiple key-routes and natural group ordering.
• sniff_key_route(): new compact_gaps and direction arguments.
• sniff_entropy(): new mode and window_size arguments.
• get_openalex_fields(): cache saved batches to skip duplicate API downloads.

Improvements

• Optimize SPC and key-route search with pre-built adjacency lists.
• Pre-render horizon plots to reduce gt object size in sniff_groups_attributes().
• Improve key-route plot layout, axis labels, and data output.
• Improve horizon plot x-axis: vertical year labels, removed title.
• Use 95th percentile for entropy diff plot y-axis range.
• Swap diff colors in index plots: red for negative, blue for positive.
• Add y_limits_diff parameter to indexes_plots().

Bug fixes

• Fix y-axis scale across entropy plots for group comparison.
• Fix dplyr variable collision in sniff_key_route() group filter.
• Fix rlang .env import to resolve R CMD check NOTE.
• Fix plot issues: diff colors and same-year node spreading.

birddog 1.0.0 (2026-02-19)

• Initial CRAN release.
• Rewrite of sniff_key_route(), sniff_citations_cycle_time(), and sniff_entropy().
• Added testthat test suite with 102 tests across 16 files.
• Fix BibTeX parser for Windows CRLF line endings.
• Fix CRAN check issues: Unicode chars, \dontrun examples, DOI URLs.
• Replace \dontrun with \donttest in all examples.
• Add error guards to vignettes to prevent crashes.

birddog 0.1.0

• Initial development version.
• Added sniff_key_route() function for main path analysis.
• Includes visualization capabilities.
• Implements methodology from Liu & Lu (2012).