nextcloud-playground

Playwright E2E expert for the Nextcloud playground. Use when writing or debugging browser end-to-end tests — booting the shell, waiting for the WASM runtime to be ready, verifying the Nextcloud login/dashboard renders, applying blueprints via query params, exercising the side panel / settings, and fixing flaky waits. References playwright.config.mjs and tests/e2e/.

Blueprint JSON provisioning expert for the Nextcloud playground. Use when working with blueprint parsing/normalization, step handlers, executing occ commands for Nextcloud provisioning (installNextcloud, login, createUser, createGroup, addUserToGroup, enableApp, disableApp, setConfig, writeFile, createShare, runOcc), resource resolution, and PHP/occ code generation. References src/shared/blueprint.js, assets/blueprints/, and the occ wrapper pattern from spike/run-spike.mjs.

Nextcloud server domain expert for the php-wasm playground. Use for occ commands (maintenance:install, app:enable/disable, config:system:set, user:add, group:adduser, status), config/config.php keys (datadirectory, dbtype=sqlite3, trusted_domains, overwrite.cli.url, filelocking.enabled, enabledPreviewProviders, check_data_directory_permissions, memcache.local), the apps/ + core/shipped.json system, SQLite usage, AJAX cron, and CRITICALLY the WASM constraints plus the exact source-patch set (posix polyfill, base.php CLI detection under SAPI 'wasm', Config.php flock, console.php owner check, Avatar.php bbox, the console.php occ wrapper). This is the most important skill in this repo — base every claim on docs/feasibility-spike.md.

Node built-in test runner expert for the Nextcloud playground. Use when writing or debugging node:test / node --test unit tests for blueprint parsing/normalization, shared paths, storage, the posix/PHP prepend generation, and occ/install-script generation. References tests/*.test.mjs and the helpers they cover in src/shared and src/runtime.

WebAssembly and browser runtime expert for the Nextcloud playground. Use when debugging WASM crashes (OOM, unreachable traps, memory access out of bounds), working with Emscripten MEMFS vs NODEFS, the Nextcloud bundle-size / memory problem (807 MB extracted), trimming strategy, a possible OPFS-backed core mount, service worker request routing, Web Worker comms, crash recovery, and GitHub Pages subpath handling. Adapted from the Moodle skill of the same name to this repo's specifics.

WordPress Playground / @php-wasm runtime expert for the Nextcloud playground. Use when working with the PHP WebAssembly runtime — PHP instance lifecycle, php.run() vs php.request(), loadWebRuntime / loadNodeRuntime, filesystem mounting (createNodeFsMountHandler, MEMFS), setPhpIniEntries, auto_prepend_file, the intl extension, php_sapi_name()=='wasm' detection, tcpOverFetch networking, and filesystem ops. References how src/runtime/php-loader.js and the spike (spike/run-spike.mjs) use these.