feat(modules): bundle common::sense

[fglock]

Summary

Bundles a full implementation of common::sense so use common::sense; works out of the box in PerlOnJava.

Per the CPAN compatibility report (refreshed in this PR), common::sense is a direct dependency of ~19 modules (CBOR::XS, AnyEvent::HTTP, Types::Serialiser, JSON::XS::VersionOneAndTwo, several Catalyst plugins, etc.) and many more transitively. Previously its install failed because upstream's sense.pm is generated at build time from sense.pm.PL, which PerlOnJava's installer doesn't run — so every dependent failed at Can't locate common/sense.pm.

What it does

src/main/perl/lib/common/sense.pm reproduces all the behaviours of upstream common-sense 3.75:

• use strict (vars/refs/subs)
• use utf8
• use warnings FATAL => qw(closed threads internal debugging pack malloc prototype inplace io pipe unpack glob digit printf layer reserved taint closure semicolon)
• no warnings qw(exec newline unopened)
• use feature qw(say state switch fc evalbytes current_sub unicode_strings)

Why high-level pragmas instead of ${^WARNING_BITS} / $^H mutation

Upstream sense.pm mutates ${^WARNING_BITS} and $^H directly via byte-level masks. PerlOnJava's parser honors that for inline -E scripts but not reliably when mutated mid-compile from a .pm loaded via use from a script file. Using the high-level pragmas (strict->import, feature->import, etc.) propagates the lexical state into the caller's scope on both code paths.

Verification

• ./jcpan -t common::sense → Result: PASS (both upstream tests pass: t/00_load.t, t/01_arch.t).
• Verified caller-scope propagation: strict vars / strict refs / say / fc / state are all active in the caller's package after use common::sense; (tested in both main and other packages).
• Warning behaviour matches system Perl exactly — only the FATAL categories common::sense enables; uninitialized is not warned (matches upstream).
• ./jcpan -t Types::Serialiser (a downstream dependent) successfully resolves the common::sense prereq and proceeds to its own tests.
• make passes.

Note on stale installs

@INC lists ~/.perlonjava/lib before the bundled JAR. If a user previously had a partially-installed ~/.perlonjava/lib/common/sense.pm from before this change, it would shadow the bundled version. The fix is rm -f ~/.perlonjava/lib/common/sense.pm. New installs / clean machines are unaffected — jcpan's MakeMaker shim auto-detects the JAR-bundled module and skips installing the .pm (it still installs sense.pod).

Test plan

• make (build + unit tests) passes
• ./jcpan -t common::sense PASS
• Caller-scope pragma propagation verified
• Downstream Types::Serialiser resolves the dep

Files

• src/main/perl/lib/common/sense.pm — new
• dev/cpan-reports/cpan-compatibility{.md,-pass.dat,-fail.dat} — refreshed report

Generated with Devin