Php Dna Laravel Package

Product Decisions This Supports

• Roadmap sequencing for genealogy analytics: The v4.0.0 removal of triangulateKits and introduction of a visualization placeholder signals the maintainers are reprioritizing away from raw DNA kit triangulation logic and toward a presentation/visualization layer. PMs should treat triangulation as unavailable/unsupported in this release and plan dependent features (shared-segment triangulation, cousin matching workflows) accordingly.
• Build vs. buy for DNA/genealogy ingestion: The package covers SNP file parsing (SNPs.php, CsvReader.php) — a candidate buy/integrate decision for raw DNA data ingestion rather than building custom parsers.
• Release-risk gating: The v4.0.0 notes include fixes for duplicate method declarations and syntax errors in core parsing files, indicating pre-release instability. This informs whether to pin versions, add integration test gates, or delay adoption until a patch release lands.
• Feature viability assessment: The "visualization placeholder" is not a delivered capability — PMs should not commit to visualization-dependent features on the basis of v4.0.0.

When to Consider This Package

Consider it when:

• You are building a Laravel/PHP genealogy or consumer-genomics application and need raw DNA data ingestion (SNP files, CSV consumers) without writing parsers from scratch.
• You can tolerate a pre-1.0-quality maturity curve: breaking removals between minor/major versions, active syntax-error fixups, and placeholder APIs.
• Your triangulation or visualization needs are non-critical or can be deferred; v4.0.0 explicitly does not deliver either.

Look elsewhere (or wait) when:

• Your product depends on kit triangulation — this method was removed in v4.0.0 with no stated replacement. Migrating off it is mandatory before upgrading from v3.x.
• You require stable, documented visualization — only a placeholder exists.
• You need vendor SLAs, security review, or a formal support contract; this is an early-stage community package with first-time contributors landing core-parser changes.
• Your stack is not Laravel/PHP, or you need clinical-grade/regulated genetic data handling (compliance, auditability) that a small package cannot evidence.

How to Pitch It (Stakeholders)

To executives: This is a small open-source PHP/Laravel library for reading consumer DNA data files in a genealogy product. The new v4.0.0 release is a breaking change: it deletes the DNA kit triangulation feature and adds only a non-functional visualization placeholder, while also fixing fundamental code errors in its file parsers. Recommendation: treat it as an ingestion utility only, pin the version, and do not build roadmap commitments on its triangulation or visualization capabilities until they are re-delivered and stable.

To engineering: v4.0.0 removes triangulateKits — audit and remove all call sites before upgrading from v3.x. SNPs.php and CsvReader.php received duplicate-declaration and syntax-error fixes, so add parser-level integration tests and validate against real SNP/CSV fixtures before trusting output. The visualization work is a placeholder, not an API contract. Recommend a version pin plus a spike to assess whether the remaining parsing surface is sufficient or whether we should own the parser in-house.