Neko.js v1.3

1.3.0 — 2026-10-03

• Validate cheap inference/report options before acquiring a model in inline and worker execution; expose planInference() with exact chat/schema/image-expanded input tokens, output capacity and context-fit metadata. Valid cold planning calls still load the model/processor.
• Stop structured generation at a deterministic single-JSON-value boundary and retain fail-closed Draft-07 runtime validation. Expose json-boundary-runtime-validation evidence; no schema grammar constraints, repair, retry or factual guarantees.
• Preserve all selected paragraph text in an exact source-quote ledger independent of generated summaries; bound section planning to multiple evidence-linked claims and expose structural coverage, conclusion basis and explicitly unmeasured semantic retention.
• Breaking persisted contracts: reports use schemaVersion: 2; checkpoints use version: 2 and evidence-first-v2. Add validated report/checkpoint serialize/parse helpers and report integrity checksums. Reject older, unversioned and unknown versions without automatic migration; checksums are not authentication.
• Record trusted worker execution identity before report checksum generation, so packed Node and browser-worker reports pass validated persistence without post-generation metadata mutation.
• Add quality-regression CI gates separate from informational benchmark output; do not equate valid schemas/provenance with model quality.
• Complete bilingual first-use Node cache/offline and browser mirror/runtime/CORS instructions; derive local tarball filenames from npm pack. Separate platform API contracts, historical real inference and fresh verification instead of claiming Node/browser/OS parity.
• Exercise current changes on macOS/arm64 Node 22.23.3 and 26.7.0 CPU, the packed Node consumer, and Chromium 153 WebGPU inline/worker inference. Document that the strict four-fixture quality gate still fails for missing format prefixes and malformed hierarchical model JSON; no quality or cross-platform parity pass is claimed.

Upgrade and known limitations / 升級與已知限制

• Package version: 1.3.0; Git tag: v1.3. This is a GitHub/local-tarball release, not an npm registry publication.
• Persisted report/checkpoint v1 data is rejected. Reports require schemaVersion: 2; checkpoints require version: 2 and evidence-first-v2. No automatic migration.
• The real-model strict quality gate remains failing: the text/image/boundary cases omit the required FACT prefix, and the 300-paragraph hierarchy run fails on malformed model JSON at section:67. The SDK rejects it and preserves all 300 source quotes and 67 completed stages in the checkpoint. This is not a quality pass or a completed 300-paragraph report.
• Node CPU and Chromium WebGPU evidence is limited to the tested environments. Browser CPU/WASM is unsupported, and there is no automatic fallback or guarantee that every operator ran on GPU.
• 持久化契約升至 v2，舊版資料不會自動遷移；真實模型品質 gate 仍未通過，不宣稱模型品質或跨平台一致性達標。

Install / 安裝

Download Neko.js-1.3.0.tgz and SHA256 from this release, verify the SHA-256 checksum, then install the local archive:

shasum -a 256 -c SHA256
npm install ./Neko.js-1.3.0.tgz

Node.js 22+ is required. Model assets are not bundled; follow the English or Traditional Chinese usage guide for verified model-cache prefetch and offline inference.