Repository navigation
Releases
YLPlugin v0.1.3 — experimental
YLPlugin v0.1.3 — direct metadata discovery and bundled CLI
Publication status: GitHub, PyPI and Maven Central are published. npm 0.1.3 is
awaiting corrected token write permissions; its public latest remains 0.1.2.
The npm 0.1.3 install command below becomes available after that upload succeeds.
See the publication record.
Read public YLSpec metadata without scanning a plugin's index or payload, and
install the native core and command together through supported language packages.
Direct metadata discovery
- New standalone C/C++ operations read only the 128-byte header and embedded
YLSpec frame. They do not construct a Package or read TOC, payload or signature bytes. - Python exposes
Library.read_metadataand a custom exact-range reader;
JS/TS exposesreadMetadata; Java/Kotlin exposes equivalent native operations. ylplugin metadata FILEemits canonical TOML.--jsonlabels discovery scope
metadata-onlyand integrityUNVERIFIED.- Limits, malformed framing, corrupt-index independence and virtual 5 GiB range
reads have regression coverage. Metadata discovery does not authenticate a publisher.
Install the core and CLI together
python -m pip install ylplugin==0.1.3
ylplugin --version
python -m ylplugin --help
npm install @younglionorganization/ylplugin@0.1.3
npx ylplugin --helpPython platform wheels contain the matching native runtime and executable;
pip registers ylplugin in the active environment's scripts directory. npm
registers its bin command and bundles the native executable. Java/Kotlin resolve
the native JAR transitively and can invoke xyz.younglion.ylplugin.Cli without
modifying the system PATH. No import-time core download is required.
Published native targets: Linux x86_64/ARM64, macOS x86_64/ARM64, Windows x86_64.
Python 3.11+, Node 20+ and JVM 11+ remain the language baselines. GNU Linux wheels
use the manylinux_2_39 policy. Use matching SDK/native versions.
The universal wheel among GitHub's source-release assets is facade-only;
use PyPI platform wheels for automatic core/CLI installation. Unsupported platforms
and source checkouts require an explicit native build.
Correctness and performance
- Plaintext store validation streams the complete resource hash with at most
1 MiB scratch instead of materializing the whole resource. Integrity checks
still cover every byte on each call. - Slice cancellation covers empty resources and the final reader callback.
- Node rejects lone UTF-16 surrogates before converting filesystem paths.
- Windows CLI arguments and core diagnostics preserve valid Unicode paths.
- VERSION changes automatically invalidate incremental CMake configuration.
- PyPI description, author/maintainer metadata, classifiers, keywords and project
links are expanded. SDK/CLI install tests exercise the actual built packages.
The recorded 32 MiB Linux comparison measured lower latency and peak process RSS;
see performance evidence and scope.
No universal speedup is claimed. Encrypted/compressed validation keeps its existing path.
Documentation and next milestone
The English Wiki, installation/API guides, CLI reference, troubleshooting and
roadmap now distinguish implemented metadata-only discovery from planned
presentation assets. Automatic icon/README/license/security discovery and
selective document reads are not implemented in 0.1.3. Track that work in the
roadmap.
Container/profile 1.0, C ABI version 1, permission semantics and LGPL-3.0-only
licensing remain unchanged. New C entry points are additive; no stable 1.x C++
ABI or production security audit is claimed. Signature verification and host
preflight remain separate from metadata inspection.
Verified release build
Commit: 584ceb1c2e8cb1336eeb0c3a69259ee15d82a688
All 7 CI jobs passed. Linux x86_64/ARM64, Windows, macOS, sanitizer, fuzz and packaging jobs succeeded. Native execution tests are intentionally skipped on Windows/macOS. See the workflow for precise results and the release manifest for asset hashes.
YLPlugin v0.1.2 — experimental
YLPlugin v0.1.2 — LGPLv3 licensing
The project owner has selected GNU LGPL version 3 only (LGPL-3.0-only)
for original YLPlugin code, bindings, tools, examples and documentation.
- Full LGPLv3 text in
LICENSE, with incorporated GPLv3 terms inCOPYING. - SPDX copyright/license notices in maintained source files.
- Matching npm, Python and Maven license metadata and README badges.
- License texts and project/actual-YLSpec source archives included in native
language distributions; CMake installs license notices too. SOURCES.mddocuments source locations, rebuilds and replacement of native modules.- README installation/architecture examples and registry badges follow YLSpec's
documentation pattern, adapted to YLPlugin's actual supported capabilities.
The container/profile format and C ABI are unchanged. Existing third-party
components retain their own licenses. Historical 0.1.0/0.1.1 registry files and
tags are immutable; this patch carries the selected license in distributed files.
Use the linked CI results and release manifest for the exact tested commit,
platform results and hashes. Native activation remains unsupported on Windows
because secure extraction is not implemented. This is an experimental SDK.
Verified release build
Commit: 81b1fa257ca7085f41180d2f2b08934a852c1940
All 7 CI jobs passed. Linux x86_64/ARM64, Windows, macOS, sanitizer, fuzz and packaging jobs succeeded. Native execution tests are intentionally skipped on Windows/macOS. See the workflow for precise results and the release manifest for asset hashes.
YLPlugin v0.1.1 — experimental
YLPlugin v0.1.1 — experimental
Native-backed JavaScript/TypeScript, Java, Kotlin and Python libraries now share
the C++ core and its container validation, permissions, signing and encryption.
- Node-API SDK with ESM/CommonJS exports, TypeScript declarations, exact bigint
results and byte permission buffers. - Java 11 JNI SDK with explicit ownership, structured results and key callbacks;
Kotlin lifecycle and resource helpers. - Typed Python facade and platform-specific wheels with a bundled native runtime.
- Linux x86_64/ARM64, macOS x86_64/ARM64 and Windows x86_64 SDK build/test coverage.
- Data, WebAssembly host and native C plugin examples alongside RCC and encrypted/
signed data examples; deterministic fixture inputs across Windows checkouts. - Expanded documentation and separate, manually dispatched npm/PyPI/Maven Central
workflows using organization secrets and verified CI artifacts.
Implementation: f36b5d5e5ba1e20cb060cf8a9f385dd1947310a2.
Core CI
and language SDK CI
passed. The latter produced five Node prebuilds, five Python platform wheels and
three Maven publications containing all five JNI runtimes. Registry upload status
is reported by the separate publishing workflow; build success alone is not publication.
GitHub core assets contain the source archive, universal Python facade wheel,
RCC demo, release manifest and checksums. That universal wheel requires a separately
built native library. Platform wheels are supplied through the language package
pipeline. Linux wheels require manylinux_2_39; see the compatibility guide for npm/
JVM native runtime requirements and other platform limits.
File format/profile 1.0 and C ABI version 1 are unchanged. Windows secure extraction
is unsupported; native plugin execution is not sandboxed. The WASM example uses
an explicit host runtime. No project license grant is made by publication; dependency
licenses are included separately. v0.1.0 remains immutable.
Verified release build
Commit: f36b5d5e5ba1e20cb060cf8a9f385dd1947310a2
All 7 CI jobs passed. Linux x86_64/ARM64, Windows, macOS, sanitizer, fuzz and packaging jobs succeeded. Native execution tests are intentionally skipped on Windows/macOS. See the workflow for precise results and the release manifest for asset hashes.
YLPlugin v0.1.0 — experimental
YLPlugin v0.1.0 — experimental
Initial working implementation of the standalone YLPlugin container, SDK and CLI.
- Own binary container with embedded, unchanged YLSpec framing and profile 1.0.
- C/C++ SDK, Python ctypes facade, indexed resources, store/Zstd and SHA256.
- Host-scoped string/mask/byte permissions, deterministic multi-host preflight.
- Ed25519 signatures and AES-256-GCM payload encryption with host key/trust callbacks.
- Controlled POSIX extraction, data/native adapters and optional memory RCC support.
- Actual RCC sample, conformance vectors, mutation tests and sanitizer/fuzz CI.
Assets contain the source tree, the pure Python facade wheel, a demo package,
a commit/hash manifest and SHA256 checksums. The wheel requires a separately built
native SDK; it does not bundle native binaries or Qt/OpenSSL. Build instructions
are in README.md and docs/building.md. No package registry upload is included.
This release is experimental and is not an independently audited production
security boundary. Windows secure extraction, WASM/Python execution adapters,
mobile/device validation and general foreign runtime vtables remain open.
Native execution is not sandboxed; RCC bytes require host approval. Existing
YLSpec and LeoMiniGames source/loaders are unchanged.
No project license has been selected and no license grant is made by publication.
Dependency licenses remain separate; see LICENSING.md and THIRD_PARTY_NOTICES.md.
Remote CI evidence and exact executed/platform-skipped checks are recorded in
docs/test-report.md and the linked GitHub Actions run for the release commit.
Verified release build
Commit: 6e3f1132c13187522314fd621471a5c9b968e192
All 7 CI jobs passed. Linux x86_64/ARM64, Windows, macOS, sanitizer, fuzz and packaging jobs succeeded. Native execution tests are intentionally skipped on Windows/macOS. See the workflow for precise results and the release manifest for asset hashes.