Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

[AI] WASM dev docs abilities — block schemas and hook documentation via embedded SQLite

Open
#35 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
5/5
Estimated time
Over a week
Newbie friendliness
25/100
Issue type
Feature
Clarity
Mostly clear
Activity status
Stale
Tech stack
javascript, sqlite, wasm, wordpress
Domain
ai, databases, devtools

Research direction

Start on the feature/wasm-sqlite-devdocs branch by reading the four ability files, src/extensions/abilities/index.js, webpack.config.js, and tests/abilities/devdocs-wasm.test.js. Review the existing 11 tests and the remaining checklist, then confirm the branch can be merged and determine the scope of IndexedDB caching, database refresh, and block-editor chat integration. Done means the remaining items are implemented and the tests pass.

Written by the indexing model from the issue text.

Description

ai-ml hackathon react-js testing

Goal

Give the AI access to WordPress block schemas and hook documentation via an embedded WASM/SQLite database (@pluginslab/wp-devdocs-wasm), so it answers developer questions with verified data instead of hallucinating.

Status

Partially implemented on the feature/wasm-sqlite-devdocs branch (not yet merged). Four abilities built and tested (11 tests including multi-turn chains).

What's done

  • search-wp-blocks — search Gutenberg blocks by keyword
  • get-block-schema — retrieve full schema for a specific block (attributes, supports, variations)
  • search-wp-hooks — search WordPress hooks (actions and filters)
  • get-hook-context — retrieve details for a specific hook (type, file, parameters)
  • Databases bundled inline via webpack browser entry point (no raw sql.js)
  • 11 tests in tests/abilities/devdocs-wasm.test.js (10 single-turn + 1 multi-turn chain)
  • ReAct agent fix for partial tool ID suffix matching

What's remaining

  • Merge the feature/wasm-sqlite-devdocs branch to main
  • IndexedDB caching — databases currently decoded fresh each session
  • Database refresh mechanism — update when block plugins change
  • Wire block schema lookups into block editor chat (Goal 8) so AI validates markup before saving

Key Files (on feature/wasm-sqlite-devdocs branch)

  • src/extensions/abilities/search-wp-blocks.js
  • src/extensions/abilities/get-block-schema.js
  • src/extensions/abilities/search-wp-hooks.js
  • src/extensions/abilities/get-hook-context.js
  • src/extensions/abilities/index.js — registers all four
  • webpack.config.js — browser added to conditionNames for WASM package resolution
  • src/extensions/services/react-agent.js — partial tool ID suffix matching fix
  • tests/abilities/devdocs-wasm.test.js — 11 tests

Technical Notes

  • Uses @pluginslab/wp-devdocs-wasm package (dynamic import, graceful degradation if not installed)
  • Database covers 121+ core Gutenberg blocks + WordPress hooks with verified schemas
  • See CLOUDFEST_HACKATHON.md Goal 9 for full context

Skills needed

React/JS, WASM

Dominant language
JavaScript
Stars
28
Forks
6
Avg merge
4d 3h
Merged PRs (30d)
2

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from pluginslab/wp-agentic-admin

All issues in pluginslab/wp-agentic-admin

Similar issues

More JavaScript issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.