README

A Systematic Literature Review (SLR) toolkit for PHP 8.3+. Nexus Scholarly provides a robust, hexagonal-architecture-driven framework to search, deduplicate, and analyze scholarly literature from multiple providers.

Features

• Multi-Provider Search: Concurrently search arXiv, Crossref, DOAJ, IEEE, OpenAlex, PubMed, and Semantic Scholar.
• Advanced Deduplication: Rule-based and fuzzy-matching strategies to detect overlapping works.
• Citation Networks: Build and persist citation graphs (citation, co-citation, and bibliographic coupling).
• Framework Agnostic Domain: Core logic operates independently, with an included Laravel integration layer.

Installation

You can install the package via composer:

composer require nexus-scholar/core

For Laravel usage, publish the configuration file:

php artisan vendor:publish --tag="nexus-config"

Basic Usage

Using the included Artisan command to run a batch search:

php artisan nexus:search "Segment Anything AND tomato" --from-year=2024 --max=50

Alternatively, use a YAML file for batch processing:

php artisan nexus:search --file=queries.yml

Documentation

For full architecture notes and domain rules, please refer to the docs/ directory.

• Product Vision
• Architecture Rules
• Old Readme

Testing

To run the robust Pest test suite included with the core, make sure you bump the memory limit since the integration test's VCR YAML recordings can exceed defaults.

php -d memory_limit=512M vendor/bin/pest

License

The MIT License (MIT). Please see License File for more information.