Record review manifest
Technical contract, ownership boundaries, source files, and acceptance checks for this workflow kit.
States
Initial: viewing. Terminal: confirmed Values: viewing, editing, validating, reviewing, submitting, confirmed, conflict, outcome-unknown.
Components
Alert, Badge, Button, Dialog, Field, Input, Select, Spinner, Textarea
Adapters
- Deterministic memory · memory · source
- Single-process local JSON · local-file · source
- Authenticated organization adapter · host-owned · source
Ownership
Kit provides
- Pure transition validation
- Revision and idempotency contract
- Memory and local file adapters
- HTTP handler and client
- Vlak React composition
Host provides
- Authentication
- Organization authorization
- Transactional shared storage
- Business eligibility rules
- Retention and audit policy
External validation boundary: The AuthenticatedOrganizationAdapter derives scope, actor, and decision permission from trusted server state before the workflow adapter runs.
Install and run
cd examples/workflows pnpm install --ignore-workspace --ignore-scripts pnpm server pnpm ui
Run from a source checkout. The browser example uses supplied local fixtures; follow these commands for the standalone reference or recipe.
Acceptance
- Stale revisions return the current record
- A duplicate command commits once
- Lost responses resolve by idempotency key
- Validation preserves the draft
- Conflicts preserve server and draft values
- Undo refuses a competing revision
- History retains at most 20 entries
Limitations
- The local file adapter supports one Node.js process
- The reference server has one fixed local owner
- No account, recovery, organization, or deployment authentication is included
Source map
- examples/workflows/record-review/domain/types.tsdomain
- examples/workflows/record-review/domain/review.tsdomain
- examples/workflows/record-review/adapters/memory.tsadapter
- examples/workflows/record-review/adapters/local-file.tsadapter
- examples/workflows/record-review/transports/http/contract.tstransport
- examples/workflows/record-review/transports/http/client.tstransport
- examples/workflows/record-review/handlers/reference/handler.tshandler
- examples/workflows/record-review/server/node-server.tshandler
- examples/workflows/record-review/ui/src/record-review-app.tsxui
- examples/workflows/record-review/tests/memory.test.tstest
- examples/workflows/record-review/tests/local-file.test.tstest
- examples/workflows/record-review/README.mddocumentation
- examples/workflows/record-review/HTTP.mddocumentation
- examples/workflows/record-review/AUTHENTICATED-ADAPTER.mddocumentation