psyflow-web

Shared browser runner and runtime for TAPS-style HTML tasks.

Local Development

cd e:\xhmhc\TaskBeacon\psyflow-web
npm install
npm run dev

Open:

http://127.0.0.1:4173/?task=H000006-mid

Static Site Build

This builds a deployable static site with the discovered HTML tasks bundled into the runner:

cd e:\xhmhc\TaskBeacon\psyflow-web
npm run build:site

Output:

psyflow-web/dist

GitHub Pages

For repository-hosted GitHub Pages, build the shared runner in Pages mode:

npm run build:pages

Published runner URL:

https://taskbeacon.github.io/psyflow-web/?task=H000006-mid

Public companion manifest:

https://taskbeacon.github.io/psyflow-web/task-manifest.json

The included workflow at .github/workflows/pages.yml fetches public Hxxxxxx-* task repos from the TaskBeacon org, regenerates both the runtime import manifest and the public companion manifest, and deploys the shared runner to GitHub Pages.

Cross-Repo Refresh From HTML Task Repos

Hxxxxxx-* repos can notify psyflow-web after pushes by calling the GitHub repository_dispatch API.

Recommended secret name:

TASKBEACON_ORG_DISPATCH_TOKEN

For a fine-grained PAT, grant access to:

• TaskBeacon/psyflow-web

Required repository permission:

• Contents: Read and write

Actions: Read and write alone is not sufficient for repository_dispatch.

If the TaskBeacon organization enforces PAT approval, the token may also need org approval before dispatch requests succeed.