docs: add sparq development notice to the top of the README - #1959
Draft
jeswr wants to merge 2 commits into
Draft
Conversation
Adds a banner at the top of the README pointing eye-js users at https://github.com/sparq-org/sparq (Rust-native triplestore with N3 reasoning), with verified bundle-size and benchmark figures, and links the eye-js-compatible migration package request (sparq-org/sparq#1499). Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2 tasks
…rq notice Replace the "orders of magnitude faster than the native EYE reasoner" phrasing (a sparq-vs-native-EYE figure) with a direct, honest eye-js-vs-sparq DeepTaxonomy-1k comparison using measured numbers: sparq (native Rust) ~7 ms engine / ~70 ms end-to-end vs eye-js (WASM build of EYE) ~390 ms end-to-end (~270 ms WASM boot + ~120 ms reasoning). Flag it explicitly as native-vs-WASM since sparq publishes no WASM DeepTaxonomy timing. Keep the (verified) bundle-size comparison and reflect sparq's current experimental/pre-1.0 state. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
4 tasks
Contributor
There was a problem hiding this comment.
⚠️ Performance Alert ⚠️
Possible performance regression was detected for benchmark 'EYE JS Benchmark'.
Benchmark result of this commit is worse than the previous benchmark result exceeding threshold 1.25.
| Benchmark suite | Current: a82637b | Previous: d129aee | Ratio |
|---|---|---|---|
Run socrates query |
15.33 ops/sec (±6.69%) |
22.2 ops/sec (±2.39%) |
1.45 |
Executing the socrates query |
115 ops/sec (±20.74%) |
3890 ops/sec (±1.67%) |
33.83 |
Run deep taxonomy benchmark [10] |
6.51 ops/sec (±2.61%) |
18.83 ops/sec (±6.56%) |
2.89 |
Run deep taxonomy benchmark [50] |
0.24 ops/sec (±1.60%) |
19.63 ops/sec (±7.26%) |
81.79 |
Run deep taxonomy benchmark [100] |
0.04 ops/sec (±1.32%) |
18.67 ops/sec (±6.95%) |
466.75 |
Run deep taxonomy benchmark [10] [reasoning only] |
7.07 ops/sec (±16.51%) |
4107 ops/sec (±1.65%) |
580.91 |
Run deep taxonomy benchmark [50] [reasoning only] |
0.56 ops/sec (±21.44%) |
4147 ops/sec (±1.85%) |
7405.36 |
Run deep taxonomy benchmark [100] [reasoning only] |
0.15 ops/sec (±23.05%) |
4136 ops/sec (±1.60%) |
27573.33 |
Run timbl + foaf + rdfs rules |
1.95 ops/sec (±2.47%) |
17.23 ops/sec (±6.18%) |
8.84 |
Run timbl + foaf + owl2rl rules |
1.12 ops/sec (±1.60%) |
17.03 ops/sec (±3.91%) |
15.21 |
Run timbl + rdfs rules |
4.43 ops/sec (±2.59%) |
18.28 ops/sec (±6.60%) |
4.13 |
Run timbl + owl2rl rules |
5.66 ops/sec (±0.72%) |
17.1 ops/sec (±6.85%) |
3.02 |
Run timbl + foaf + rdfs rules [string] |
2 ops/sec (±0.46%) |
18.45 ops/sec (±7.08%) |
9.22 |
Run timbl + foaf + owl2rl rules [string] |
1.15 ops/sec (±0.46%) |
18.54 ops/sec (±6.64%) |
16.12 |
Run timbl + rdfs rules [string] |
4.52 ops/sec (±0.30%) |
18.77 ops/sec (±6.77%) |
4.15 |
Run timbl + owl2rl rules [string] |
5.82 ops/sec (±0.29%) |
18.98 ops/sec (±6.47%) |
3.26 |
This comment was automatically generated by workflow using github-action-benchmark.
CC: @jeswr
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
🚧 Draft — agent-generated, for @jeswr's wording/figures review before landing
Adds a
> [!NOTE]banner at the very top of the README (directly under the H1) announcing that @jeswr is now actively developing sparq, for eye-js users to find the successor project. Nothing else in the README is touched.Direct eye-js-vs-sparq DeepTaxonomy comparison (+ the caveat)
The speed line no longer reuses sparq's sparq-vs-native-EYE figure ("orders of magnitude faster than the native EYE reasoner… ≈62×"). That 62× compared sparq against the standalone native EYE binary running a full forward
--passclosure — a different task from what eye-js's own bench actually runs, so quoting it against eye-js would have been misleading.Instead the notice now states a direct eye-js-vs-sparq DeepTaxonomy-1k comparison with measured numbers:
perf/bench.ts— of which ≈270 ms is one-time WASM module instantiation and ≈120 ms is reasoning.Every other figure is verified
skills/inference/SKILL.md;crates/sparq-reason-wasm, deployed atsparq.jeswr.org/wasm/reason/sparq_reason_wasm_bg.wasm= 2,572,368 B raw, 909,549 Bgzip -9fa76971:swipl-web.wasm2,190,887 B +swipl-web.data1,642,703 B = 3,833,590 B; webpackbundle/index.js4,051,911 Bbench/inference/eye-comparison.md; eye-js: on-box measurement (eyereasoner v21.1.10, canonicalperf/bench.tslinear DT-1000 shape)Deliberately not claimed: any identical-closure guarantee between eye-js and sparq (verified only sparq-vs-native-EYE in the linked file; eye-js's bench uses a goal-directed
--query, so its derivation may differ), and any published sparq npm package.Trackers
npm install <name>+ drop-in snippet) once sparq's npm package publishes.Adjacency note
🤖 Generated with Claude Code