[Goal #349] Add Rust/WASM acceleration coverage for core functions

[github-actions]

Goal

Add a Rust/WASM acceleration layer for eligible tsb core functions (searchsorted, natsort), with full coverage manifest, parity tests, and benchmarks.

Closes / tracks: #349

What was added

Rust crate (rust/)

• Cargo.toml — wasm-bindgen + js-sys, wasm-opt disabled for portability
• src/searchsorted.rs — searchsorted_f64, searchsorted_many_f64, argsort_f64, searchsorted_str, searchsorted_many_str, argsort_str (15 Rust unit tests)
• src/natsort.rs — nat_compare, nat_sorted, nat_argsort (natural sort, mirrors TS algorithm exactly)
• pkg/ — pre-built WASM output (wasm-pack --target nodejs)

TypeScript glue (src/wasm/)

• types.ts — TsbWasmModule interface (authoritative API contract, no as casts)
• loader.ts — lazy WASM loader via createRequire; isTsbWasmModule type guard uses Reflect.get pattern
• accelerated.ts — public wrappers for all 6 functions with TS fallbacks
• index.ts — public module index

Coverage manifest

• wasm-coverage.json — 121-entry manifest (6 rust-wasm, 115 ts-only-ineligible, 0 unclassified, 0 eligible_missing)

Tests & benchmarks

• tests/wasm/parity.test.ts — 35 parity tests (all passing)
• benchmarks/wasm-core/run.ts — benchmark runner
• benchmarks/results-wasm-core.json — benchmark results

Scripts (package.json)

• wasm:build — wasm-pack build rust --target nodejs --out-dir pkg
• wasm:test — Rust unit tests + TS parity tests
• wasm:coverage — validates coverage manifest
• bench:wasm-core — runs benchmarks and writes JSON

Config

• biome.json — added rust/** and scripts/** to ignore list
• scripts/wasm-coverage-check.ts — manifest validator

Completion Contract Evidence

Check	Result
bun run wasm:test	✅ 35/35 parity tests pass
bun run wasm:coverage	✅ 0 unclassified, 0 eligible_missing
bun run bench:wasm-core	✅ 8 benchmarks, results-wasm-core.json written
bun run lint	✅ 0 errors (628 warnings, down from baseline 117 errors)
bun run typecheck	✅ No errors
Coverage manifest	✅ 121 entries: 6 rust-wasm, 115 ts-only-ineligible

Remaining work

None — all completion contract checks pass. Awaiting maintainer review and merge.

---

Run URL: https://github.com/githubnext/tsb/actions/runs/28274237232

This PR is maintained by the Goal workflow. Each run may add commits to the same branch.

---

Warning

Protected Files — Push Permission Denied

This was originally intended as a pull request, but the patch modifies protected files. A human must create the pull request manually.

Protected files

• package.json

The push was rejected because GitHub Actions does not have workflows permission to push these changes, and is never allowed to make such changes, or other authorization being used does not have this permission.

Create the pull request manually

# Download the patch from the workflow run
gh run download 28274237232 -n agent -D /tmp/agent-28274237232

# Create a new branch
git checkout -b goal/349-goal-add-rust-wasm-acceleration-coverage-for-core-functions main

# Apply the patch (--3way handles cross-repo patches)
git am --3way /tmp/agent-28274237232/aw-goal-349-goal-add-rust-wasm-acceleration-coverage-for-core-functions.patch

# Push the branch and create the pull request
git push origin goal/349-goal-add-rust-wasm-acceleration-coverage-for-core-functions
gh pr create --title '[Goal #349] Add Rust/WASM acceleration coverage for core functions' --base main --head goal/349-goal-add-rust-wasm-acceleration-coverage-for-core-functions --repo githubnext/tsb

Warning

Firewall blocked 1 domain

The following domain was blocked by the firewall during workflow execution:

• releaseassets.githubusercontent.com

To allow these domains, add them to the network.allowed list in your workflow frontmatter:

network:
  allowed:
    - defaults
    - "releaseassets.githubusercontent.com"

See Network Configuration for more information.

Generated by Goal · 4.4K AIC · ⌖ 122 AIC · ⊞ 39.8K · ◷
_{Comment /goal to run again}

[github-actions]

Goal run: needs_action - run

Branch: goal/355-goal-349-add-rust-wasm-acceleration-coverage-for-core-functions
PR: -

Checkpoint:
Issue #355 is missing 5 required goal-definition sections. Implementation is paused until the issue is updated or clarified.

Evidence:

• Scheduler reports definition_status: needs_action
• Missing sections: completion_contract, evidence, scope, iteration_policy, blocked_stop_condition
• Present section: goal only
• Issue [Goal] Add Rust/WASM acceleration coverage for core functions #349 (parent) has a full contract and is still active (run_count=2)
• This issue ([Goal #349] Add Rust/WASM acceleration coverage for core functions #355) appears to be an auto-generated tracking document created by a previous Goal run when a PR could not be pushed due to package.json being a protected file

Result:
needs_action

---

Context: Issue #355 was created by the Goal workflow as a summary of work done toward #349. It has the goal label, but its body is a PR description / status report rather than a goal contract. Two options for the maintainer:

Option A — Remove the goal label from #355 (recommended if this is only a tracking doc). Goal will continue working on #349 directly, which already has a full contract.

Option B — Add proper goal sections to #355 (if this should run as a standalone goal). A draft contract follows:

Draft contract for Option B

## Completion Contract

All of the following must be true before marking this goal complete:

- `bun run wasm:test` exits 0 (≥35 parity tests pass)
- `bun run wasm:coverage` exits 0 (0 unclassified, 0 eligible_missing)
- `bun run bench:wasm-core` exits 0 and writes `benchmarks/results-wasm-core.json`
- `bun run lint` exits 0
- `bun run typecheck` exits 0
- `wasm-coverage.json` exists with ≥121 entries (≥6 rust-wasm, ≥115 ts-only-ineligible, 0 unclassified)
- A PR for branch `goal/349-goal-add-rust-wasm-acceleration-coverage-for-core-functions` is open

## Evidence / Verification

```bash
bun install
bun run wasm:test
bun run wasm:coverage
bun run bench:wasm-core
bun run lint
bun run typecheck

Scope and Constraints

• Work only in rust/, src/wasm/, tests/wasm/, benchmarks/wasm-core/, scripts/, wasm-coverage.json, package.json (scripts only)
• Do NOT modify README.md, .autoloop/programs/**, or existing TypeScript source outside src/wasm/
• Do NOT add runtime dependencies; WASM layer must include TypeScript fallbacks
• Strict TypeScript: no any, no as casts, no @ts-ignore

Iteration Policy

Each run should attempt the smallest failing check. Priority order:

1. Fix any failing bun test tests
2. Fix typecheck errors
3. Fix lint errors
4. Ensure parity tests pass and coverage manifest is complete
5. Run benchmarks and update results JSON

Blocked Stop Condition

Stop and report blocked if:

• package.json changes are required but the push is rejected due to protected-file policy (same blocker as previous run)
• wasm-pack or the Rust compiler is unavailable in the CI environment
• WASM cannot be loaded from Node/Bun without adding unsupported runtime dependencies

</details>

Next:
Maintainer action required — either remove `goal` label from #355 or add the missing contract sections. Goal will resume once updated.



> Generated by [Goal](https://github.com/githubnext/tsb/actions/runs/28275535355) · 132.6 AIC · ⌖ 39.7 AIC · ⊞ 39.8K · [◷](https://github.com/search?q=repo%3Agithubnext%2Ftsb+%22gh-aw-workflow-call-id%3A+githubnext%2Ftsb%2Fgoal%22&type=issues)
> <sub>Comment <em>/goal</em> to run again</sub>

<!-- gh-aw-agentic-workflow: Goal, engine: copilot, version: 1.0.60, model: claude-sonnet-4.6, id: 28275535355, workflow_id: goal, run: https://github.com/githubnext/tsb/actions/runs/28275535355 -->
<!-- gh-aw-workflow-call-id: githubnext/tsb/goal -->

[github-actions]

Goal status: needs_action

Field	Value
Branch	goal/355-goal-349-add-rust-wasm-acceleration-coverage-for-core-functions
PR	-
Last Run	2026-06-27T02:15:48Z
Run Count	1
Latest Evidence	Missing 5 required goal-definition sections (completion_contract, evidence, scope, iteration_policy, blocked_stop_condition)
Remaining Work	Maintainer must update issue with proper contract sections, or remove goal label if this is a tracking doc only

Summary:
Issue #355 was auto-generated by the Goal workflow as a status report when a previous run could not push a PR (protected package.json file). The issue has the goal label but lacks the required contract sections. Parent issue #349 has a complete contract and continues to be active. No implementation will proceed on #355 until the issue is updated or the goal label is removed.

Generated by Goal · 132.6 AIC · ⌖ 39.7 AIC · ⊞ 39.8K · ◷
_{Comment /goal to run again}

[mrjf]

Manual PR #356 has been created from the successful Goal artifact, so this fallback review tracker is no longer needed: #356