[facontidavide]

What

Moves the functional parser-module kit out of the installed SDK and into experimental/parser_module/. It is still built and tested in this repository, but it is no longer installed, no longer packaged, and no longer covered by the compatibility promise.

Why

1.0.0 would otherwise freeze an export ABI, a manifest schema and about 5,000 lines of authoring headers that nothing uses: no parser module exists, and no host loads one. The pre-1.0 review found three things in module ABI 1 that would need an ABI 2 (no timestamp on the object output, the payload copied inline per message, no contract-violation result code). Keeping the kit outside the promise lets those be fixed without a MAJOR.

Why experimental/ here, and not another repository

• The native loader uses the plugin loaders' private pj_plugins/src/detail/library_loader.hpp, so the host half cannot leave without exporting or duplicating it.
• The export ABI is a host-to-module contract. The host would be PJ4 and the authors would be plugin writers; this repository is the only place both can depend on.
• ObjectWriter is coupled to the builtin codecs and splice table and should keep being tested against them in the same commit.

If the kit should leave the repository entirely, the follow-up is git rm -r experimental/parser_module.

Interaction with #173

Draft PR #173 (feat/parser-extensibility-1b, the wasm parser-module loader) builds on this kit and touches the same files. Whichever lands second needs a rebase across the path moves. The two agree in direction: #173 already keeps its wasm executor in-tree and out of the installed package, and with this PR the wasm loader would land under experimental/parser_module/ beside the native one.

Removed from the installed SDK (breaking)

• Component plotjuggler_sdk::parser_module and pj_add_parser_module() (PjParserModule.cmake)
• pj_base/parser_module/*.hpp, pj_base/parser_module_abi.h, pj_base/parser_module_manifest.hpp
• pj_plugins/host/native_parser_module.hpp, pj_plugins/host/parser_module_runtime.hpp
• The pj_parser_module_host archive that plotjuggler_sdk::plugin_host linked; the PJ::parser_module codecs leave libpj_base.a
• ParserClaimCatalog::ingestModuleManifest, decodeParserModuleManifest, ParserModuleManifest
• PJ_MODULE_PARSE_INPUT_FLAG_HAS_TIMESTAMP from the feature_floors.json baseline

No consumer references any of these: I grepped PlotJuggler, pj-official-plugins, plotjuggler-ros-plugins, PJ-plugins, mosaico, plotjuggler-agent and WASM, including their worktrees.

Unchanged

ParserClaimCatalog claim admission, synthesizeParserPluginClaims and ParserRouteResolver, which PJ4's ParserRoutingService uses.

Notes for review

• Almost every file is a pure git mv. Headers keep their pj_base/... and pj_plugins/host/... include spellings, so promoting the kit back later is a move, not a rewrite.
• The manifest decoder used the catalog's private claim validator. In experimental/ it validates by admitting into a scratch ParserClaimCatalog and reading the claims back, so the stable catalog gains no new public API. ingestParserModuleManifest() is now a free function that takes the diagnostic sink as an argument.
• The module ABI static_assert pins moved from abi_layout_sentinels_test.cpp into the experimental ABI test.
• New option PJ_BUILD_EXPERIMENTAL, default follows PJ_BUILD_TESTS. Conan exports experimental/* so with_tests=True still configures; nothing from it is packaged.
• test_sdk_install.sh now fails if any parser-module file reaches the install tree.
• The plugin-authoring skill no longer offers parser modules as an option; its reference moved to experimental/parser_module/AUTHORING.md.

Verification

• ./build.sh --debug (Debug + ASAN): builds
• ./test.sh: 108 of 108 pass, including the 8 parser-module tests from their new location
• pre-commit (clang-format 22): clean
• tools/feature_floors/check_feature_floors.py: OK, 140 surfaces
• ./test_sdk_install.sh (Release): passes, including the new leak check
• conan create (Release, with_tests=False) plus a throwaway consumer that links plotjuggler_sdk::plugin_host and asserts the parser_module target and pj_add_parser_module are absent: passes

Not run locally: the abidiff gate (libabigail is not installed here) and the WASI conformance job (no wasi-sdk here). Both run in CI; the WASI target name is unchanged.

🤖 Generated with Claude Code