PHPackages                             nexus-scholar/core - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility &amp; Helpers](/categories/utility)
4. /
5. nexus-scholar/core

ActiveLibrary[Utility &amp; Helpers](/categories/utility)

nexus-scholar/core
==================

Systematic Literature Review toolkit for PHP 8.3+

v1.0.0(1mo ago)0231↓50%MITPHP ^8.3

Since May 22Compare

[ Source](https://github.com/nexus-scholar/core)[ Packagist](https://packagist.org/packages/nexus-scholar/core)[ RSS](/packages/nexus-scholar-core/feed)WikiDiscussions Synced 3w ago

READMEChangelog (4)Dependencies (10)Versions (7)Used By (0)

Nexus Scholar Core
==================

[](#nexus-scholar-core)

[![Latest Version on Packagist](https://camo.githubusercontent.com/c580f476bfa16d5c1b6802362f4c13ad6a5ba6651ac92685db7a3fae0cd4f0a8/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6e657875732d7363686f6c61722f636f72652e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/nexus-scholar/core)[![Tests](https://github.com/nexus-scholar/core/actions/workflows/test.yml/badge.svg)](https://github.com/nexus-scholar/core/actions/workflows/test.yml)[![Total Downloads](https://camo.githubusercontent.com/d809350d1671261bdf98162b16ca2c8fc4fceb4a985053cf31ad9fa497753ea4/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6e657875732d7363686f6c61722f636f72652e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/nexus-scholar/core)[![License](https://camo.githubusercontent.com/2e9dc615e7977a0e6e0132d51b12a9a67d08adbb4d81a27db7403a25ea5f54e6/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f6e657875732d7363686f6c61722f636f72652e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/nexus-scholar/core)

Nexus Scholar Core is a PHP 8.3+ package for building systematic literature review workflows in Laravel applications. It provides reusable services for academic search, corpus normalization, deduplication, screening, citation-network analysis, legal open-access full-text retrieval, and export auditing.

The package is designed as a reusable engine. Domain and application code depend on ports and value objects; Laravel-specific infrastructure lives behind service-provider bindings, migrations, jobs, events, and Eloquent-backed repositories.

Ecosystem Role
--------------

[](#ecosystem-role)

`core` is the public package boundary of Nexus Scholar. It keeps the scholarly workflow logic reusable while host applications own product concerns, local project layout, credentials, and user experience.

- `nexus-scholar/nexus-cli` is the local research-workspace host for command-line review workflows.
- `nexus-scholar/nexus-web` is the hosted Laravel/Inertia product shell.
- `nexus-scholar/graph-core` and `nexus-scholar/graph-algorithms` provide the graph foundation used by citation-network features.
- `nexus-scholar/refmanager` covers bibliographic import/export support around RIS, BibTeX, CSL-JSON, and EndNote XML.

What It Provides
----------------

[](#what-it-provides)

- Search orchestration across arXiv, Crossref, DOAJ, IEEE, OpenAlex, PubMed, and Semantic Scholar.
- YAML search plans, provider selection, rate limits, cache identity, and persisted search provenance.
- Scholarly work normalization with stable internal identity and provider/external identifier tracking.
- Deduplication policies, representative selection, cluster persistence, and corpus locking.
- Deterministic, LLM-assisted, council, and human adjudication screening workflows.
- Screening run comparison for reviewer, criteria, and model-output analysis.
- Citation, co-citation, and bibliographic-coupling graph builders with metrics and exports.
- Legal open-access full-text retrieval through direct URLs, Unpaywall, PubMed Central, Europe PMC, arXiv, OpenAlex metadata, and Semantic Scholar metadata sources.
- Bibliography, graph, and network export history with host-facing read ports.
- Laravel package integration through config, migrations, repositories, commands, jobs, events, listeners, and reader APIs.

Installation
------------

[](#installation)

Install the package with Composer:

```
composer require nexus-scholar/core
```

Publish the Laravel configuration and migrations:

```
php artisan vendor:publish --tag="nexus-config"
php artisan vendor:publish --tag="nexus-migrations"
php artisan migrate
```

Set the operational contact values used by retrieval and provider workflows:

```
NEXUS_MAIL_TO=you@example.com
NEXUS_UNPAYWALL_EMAIL=you@example.com
```

Provider API keys are optional unless a provider requires them. Keep real credentials in the host application's environment, not in source control.

Package Commands
----------------

[](#package-commands)

The package registers only reusable package-owned commands:

```
php artisan nexus:search --file=queries.yml --all --project=my-project
php artisan nexus:screen --project=my-project --include="tomato segmentation" --exclude="medical imaging"
```

Applications that need richer command-line workflows should wrap the package handlers and ports in their own console commands. Keep review policy and scholarly workflow behavior in `core`; let host applications own input parsing, presentation, local file layout, and project-specific conventions.

Application Surface
-------------------

[](#application-surface)

Laravel applications consume the package through handlers, ports, value objects, published migrations, configuration, and reader APIs. The service provider binds the shipped repositories, provider clients, jobs, events, lifecycle listeners, and application services.

Common integration points include:

- search execution and search-plan services;
- deduplication and corpus lock/unlock handlers;
- screening, adjudication, and screening comparison handlers;
- full-text retrieval handlers;
- citation graph build, analysis, shortest path, snowballing, and export handlers;
- bibliography and network export handlers;
- export history, job lifecycle, and full-text fetch reader ports.

Documentation
-------------

[](#documentation)

The v1 documentation lives in `docs/v1.0` and is published with MkDocs through GitHub Pages.

- [Documentation Home](docs/v1.0/README.md)
- [Tutorials](docs/v1.0/tutorials/README.md)
- [Module Reference](docs/v1.0/modules/README.md)
- [v1.0 Release Status](docs/v1.0/release-state-audit.md)
- [Publishing The Documentation](docs/v1.0/publishing.md)

Quality Gates
-------------

[](#quality-gates)

Run the package checks from the repository root:

```
composer validate --strict
composer audit --format=plain --abandoned=ignore
composer test
composer analyse
composer format:check
```

The provider test lane is fixture-backed. CI must not depend on live provider network calls.

Build the documentation locally with:

```
python -m pip install -r requirements-docs.txt
mkdocs build --strict
```

License
-------

[](#license)

Nexus Scholar Core is open-sourced software licensed under the [MIT license](LICENSE.md).

###  Health Score

42

—

FairBetter than 88% of packages

Maintenance88

Actively maintained with recent releases

Popularity12

Limited adoption so far

Community2

Small or concentrated contributor base

Maturity53

Maturing project, gaining track record

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~1 days

Total

5

Last Release

58d ago

Major Versions

v0.2.1 → v1.0.02026-05-27

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/233639653?v=4)[Bekhouche Mouadh](/maintainers/nexus-scholar)[@nexus-scholar](https://github.com/nexus-scholar)

###  Code Quality

TestsPest

Static AnalysisPHPStan

Code StyleLaravel Pint

Type Coverage Yes

### Embed Badge

![Health badge](/badges/nexus-scholar-core/health.svg)

```
[![Health](https://phpackages.com/badges/nexus-scholar-core/health.svg)](https://phpackages.com/packages/nexus-scholar-core)
```

###  Alternatives

[pimcore/pimcore

Content &amp; Product Management Framework (CMS/PIM/E-Commerce)

3.8k3.8M511](/packages/pimcore-pimcore)[craftcms/cms

Craft CMS

3.6k3.6M3.2k](/packages/craftcms-cms)[tempest/framework

The PHP framework that gets out of your way.

2.2k34.4k16](/packages/tempest-framework)[azuracast/azuracast

The AzuraCast self-hosted web radio station management suite.

3.9k27.8k](/packages/azuracast-azuracast)[open-dxp/opendxp

Content &amp; Product Management Framework (CMS/PIM)

9421.6k64](/packages/open-dxp-opendxp)[drupal/core

Drupal is an open source content management platform powering millions of websites and applications.

19566.0M1.8k](/packages/drupal-core)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
