Schwitzz 4efa71515e feat(entity): Chunk #4 data layer + entity UI (characters & world-building)
Data layer:
- Fuzzy scorer (packages/core/src/fuzzy.ts) with index recovery + unit tests
- Backlink computation (packages/core/src/backlinks.ts) incl. entity-level backlinks
- Consistency checker (packages/core/src/consistency.ts) incl. reciprocity/scope + unit tests
- StorageAdapter contract extended with listEntities/searchEntities/saveEntity/deleteEntity;
  implemented in Local (Dexie) and Server adapters; contract tests cover entity CRUD + ?q= search
- WorldItem.fields now supports list values (keyPeople, rivals); expanded RelationshipKind
- @mention autocomplete extension + picker in the editor package

Entity UI (apps/web/src/features/entities/):
- Generic field renderer (EntityFields) driven by ENTITY_FIELDS/FieldDef
- Tabbed directory with fuzzy search + entity cards (EntitiesView)
- Create/edit/delete drawer (EntityEditor) reusing shared fields
- Relationship editor + force-directed SVG relationship map
- Entity engine stylesheet; wired into nav

Store: project-store entity methods (load/create/update/delete) over the StorageAdapter contract.

CI-green: typecheck, lint, 65 tests, and web build all pass.
2026-10-25 22:42:55 -05:00

PubScript

A self-hostable, multi-user writing studio for novelists — one codebase that runs as a web app and as a native desktop app, with a local-first AI co-writing engine built in.

See PLAN.md for the full vision, architecture, and data model. The CHUNK#n.md files are the executable work orders.

Quickstart

pnpm i && pnpm dev      # run the app shell at http://localhost:5173
pnpm test               # run every workspace's unit tests
pnpm typecheck          # strict TypeScript across the monorepo
pnpm build              # build web + server

Docker (self-host)

docker compose -f docker/compose.yaml up --build
# → http://localhost:8080   (health: curl localhost:8080/api/health)

One container serves the web app, runs the Fastify API, and stores SQLite on a volume.

Repository layout

Path What it is
PLAN.md Single source of truth for what and why
CHUNK#n.md Executable, step-by-step work orders
apps/web/ React 19 + Vite app (runs in browser AND in Tauri)
packages/core/ Domain types, ULIDs, time, token budget, StorageAdapter contract
packages/ui/ Design tokens, theme engine (Ink / Parchment / Nocturne / Terminal), component kit
server/ Fastify + SQLite: auth, multi-tenant, WS, admin, AI proxy
docker/ Dockerfile + compose (one container serves app + API + data)
docs/ ADRs, data model reference, AI role prompts, parity matrix

Status

CHUNK #1 — Scaffold & Foundations is complete: monorepo, strict TypeScript, the app shell, the theming system, the packages/core contracts, a Fastify server skeleton, and a green CI pipeline.

Next: CHUNK #2 — Data Model, Storage & Auth.

S
Description
PubScript project
Readme GPL-3.0 1,004 KiB
Languages
TypeScript 94.2%
CSS 4.8%
C 0.4%
Shell 0.4%