fix+feat: deploy end-to-end, Urban human front-end for the review task, Biome linting

[jwulf]

This PR started as the npm run deploy fix and now also adds the human front-end that lets the review task be acted on, plus Biome linting.

---

1. Make npm run deploy run end-to-end

npm run deploy couldn't run against a Nano gateway. Two independent defects:

• Loader can't compile a TS parameter property. The scripts ran node --experimental-strip-types, which can't compile EffectClient's private constructor(private readonly client: WorkflowClient) {} (needs an emit) → ERR_UNSUPPORTED_TYPESCRIPT_SYNTAX. Fix: switch scripts to --experimental-transform-types and rewrite the constructor to an explicit field assignment.
• Falcon worker-start null-transport race. On the Falcon path the worker started before its transport bound → Cannot read properties of null (reading 'subscribe') in NanoJobWorker.start. Fixed upstream in NanoJobWorker.start() null-transport crash when started before bindTransport() (Falcon race) jwulf/nano-sdk-js#12 + @nanobpm/workflow eagerly starts nano-sdk worker, racing async transport bind (null-transport crash) nano-ide#415 (both closed). Fix: adopt @nanobpm/workflow ^0.13.1 + @nanobpm/nano-sdk 1.2.7 (floored via overrides), and make transport selectable via CAMUNDA_TRANSPORT (default auto).

2. Urban human front-end for the review task

The human(review) step parks each instance on a user task nothing completes, so the convergence loop never resolves. Rather than a bespoke reviewer UI, mount @nanobpm/urban's built-in taskInbox surface (ADR 0026) — no embedded engine, no duplicated workers:

• nano.app.json — enables surfaces.taskInbox, declares the form under models.forms.
• resources/forms/research-review.form — form-js schema (read-only question + drafted finalAnswer, required approve/revise verdict, conditional revisionNotes); field keys match the review task I/O.
• urban-app.ts — runFromEnv deploys the form and mounts the surface against the same engine npm run deploy targets; run with npm run app (default :8090/tasks). Embeds in the console at /console/app-view/research-agent/tasks (ADR 0057).

3. Biome linting

• biome.json (recommended lint + 2-space/120 formatter), lint/lint:fix scripts, CI lint step.
• Format existing sources to comply; fix an unused parameter.

Verification

• Deploy: end-to-end on the auto/Falcon transport — deploy → 8 workers → instance → agent jobs complete, no null-transport crash.
• Front-end (live node): the taskInbox surface lists the review task and serves the research-review form (keys question/finalAnswer/verdict/revisionNotes). Completing via the surface converges the loop: approve → publish → archive → COMPLETED; revise → record-revision → re-synthesize → fresh review.
• npm run lint, npm run typecheck, and npm test (14/14) all pass.

[Copilot]

Pull request overview

This PR fixes end-to-end deploy execution against a Nano gateway, adds an Urban-based human task inbox to complete the review user task (so the workflow can converge), and introduces Biome for linting/formatting with CI enforcement.

Changes:

• Switch Node TS execution to --experimental-transform-types and adjust code to avoid unsupported TS syntax in runtime execution.
• Add an Urban “taskInbox” app + form schema to act on the review task and complete the converge loop.
• Add Biome configuration, scripts, and a CI lint step; reformat sources accordingly.

Reviewed changes

Copilot reviewed 19 out of 21 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
urban-app.ts	New Urban app entrypoint to deploy forms and mount the taskInbox surface against the target engine.
tsconfig.json	Includes urban-app.ts in TypeScript compilation.
test/worker.test.ts	Formatting/import order updates to align with Biome and project style.
test/model.test.ts	Import order update for Biome/style compliance.
test/agents.test.ts	Import order/formatting updates for Biome/style compliance.
src/model/research-agent.ts	Import split/ordering adjustments (type vs value) for style/TS hygiene.
src/main.ts	Adds CAMUNDA_TRANSPORT support and updates deploy runtime wiring/formatting.
src/effect/worker.ts	Formatting/type layout changes; refactors some call formatting for readability.
src/effect/Llm.ts	Formatting change to satisfy lint/formatter rules.
src/effect/client.ts	Removes TS parameter property in constructor (runtime TS transform compatibility).
src/agents/util.ts	Formatting/refactor for lint/formatter compliance.
src/agents/search.ts	Formatting/refactor for lint/formatter compliance.
src/agents/index.ts	Import ordering adjustments.
scripts/emit-bpmn.ts	Import ordering adjustment.
resources/forms/research-review.form	New form schema to render/complete the review task with approve/revise flow.
README.md	Documents transform-types runtime, lint scripts, and how to run the Urban task inbox.
package.json	Adds Urban/Biome deps, new scripts (lint, lint:fix, app), and dependency overrides.
package-lock.json	Locks new dependencies (Urban, Biome) and updated workflow/nano-sdk versions.
nano.app.json	New Urban app manifest enabling taskInbox and declaring form models.
biome.json	New Biome configuration for formatting/linting scope and rules.
.github/workflows/ci.yml	Adds CI step to run Biome linting.

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

[Copilot]

Pull request overview

Copilot reviewed 19 out of 21 changed files in this pull request and generated no new comments.