README

A Laravel package for automated digital preservation risk assessment based on the NARA Digital Preservation Framework.

Features

• Official NARA TTL/RDF data integration
• Automatic caching with 28-day refresh cycle
• Nara Risk assessment for 100+ file formats via PRONOM IDs
• Nara Preservation action recommendations
• Support for 16 NARA format categories
• Nara Tool suggestions for preservation workflows

Installation

composer require kraenzle-ritter/nara-risk

The package auto-registers via Laravel's package discovery.

Usage

use KraenzleRitter\NaraRisk\Services\NaraAssessmentService;

$service = app(NaraAssessmentService::class);
$result = $service->assessFile('fmt/412'); // PDF 1.7

echo $result['risk_level'];           // "Low"
echo $result['category'];             // "Textual"
echo $result['recommended_action'];   // "Retain"

Response Structure

Each assessment returns an array with these key fields:

• pronom_id - PRONOM identifier
• format_name - Human-readable format name
• category - NARA format category
• risk_level - Low, Moderate, or High
• recommended_action - Retain, Transform, Assess, or Identify
• tools - Array of suggested preservation tools
• nara_compliant - Boolean indicating NARA framework coverage
• assessment_notes - Detailed recommendations

Additional Methods

// Get all supported PRONOM IDs
$ids = $service->getSupportedPronomIds();

// Get format statistics
$stats = $service->getFormatStatistics();

// Check cache status
$cacheInfo = $service->getCacheInfo();

Testing

Run the test suite:

composer test

The package includes 44 comprehensive tests covering all functionality.

Requirements

• PHP 8.2+
• Laravel 11.44+ | 12.4+

Data Sources

This package uses official data from:

• NARA Digital Preservation Framework
• PRONOM Technical Registry
• Archives.gov TTL/RDF files

Data is cached locally and refreshed automatically every 28 days.

License

This project is licensed under the MIT License.