mirror of https://github.com/PerpetualSoftware/pad.git synced 2026-10-26 06:19:49 +00:00

Files

T

xarmian f6f588b4d4 fix: a convention's stored metadata copy follows its ordinary fields (TASK-2257) (#1964 )

A convention keeps its metadata twice: in the ordinary fields (trigger,
scope/surfaces, enforcement/priority, category, commands), which agents
and bootstrap read, and in the reserved `convention` key, which
item.convention prefers. Since BUG-3163 nothing but the create member can
write the reserved copy, so a fields_patch changing `trigger` left the
copy behind and the two disagreed.

UpdateItem now mirrors every mirrored key the write CHANGED into the
reserved copy, under the write lock, after the BUG-3163 carry guard. A
convention with no reserved copy is untouched. The merged copy is
validated with models.ValidateConventionMetadata; a write that would leave
it invalid is refused 400 validation_error (new, deliberate: storing an
invalid copy is what the reserved key exists to prevent).

The web Conventions page's edit form gains trigger / surface /
enforcement selects (sent as fields_patch with both spellings) and an
"Open item" link to the full item.

Drift measured before the change: 194 conventions, 5 with a reserved
copy, all 5 agreeing, so no reconcile follow-up was filed.

2026-10-09 09:38:42 -04:00

.vscode

Initial release

2026-03-26 01:52:36 +00:00

e2e

fix(web): conventions, playbooks and the library say what their markers mean (TASK-2257 C72) (#1963 )

2026-10-09 08:48:53 -04:00

scripts

feat(materialize): headless op-log materializer bundle, goja runner and worker (TASK-2198 U2) (#1678 )

2026-09-30 02:50:10 -04:00

src

fix: a convention's stored metadata copy follows its ordinary fields (TASK-2257) (#1964 )

2026-10-09 09:38:42 -04:00

static

feat(brand): the Pad mark is the brand: one vector master, the app's icons, header and link card from it (TASK-3514) (#1926 )

2026-10-08 23:28:47 -04:00

.gitignore

build(web): move the SvelteKit and Svelte config into vite.config.ts (TASK-3423, PR A) (#1823 )

2026-10-05 23:38:37 -04:00

.npmrc

Initial release

2026-03-26 01:52:36 +00:00

package-lock.json

fix(web): the command palette is an accessible combobox, axe-clean in both themes (TASK-2234) (#1847 )

2026-10-07 03:22:58 -04:00

package.json

fix(web): the command palette is an accessible combobox, axe-clean in both themes (TASK-2234) (#1847 )

2026-10-07 03:22:58 -04:00

playwright.config.ts

feat(mcp): off-cloud Host allowlist on the non-API MCP paths (TASK-2319, PLAN-2310 U3) (#1665 )

2026-09-29 15:25:44 -04:00

README.md

refactor(web): delete unmounted components carrying real logic (TASK-2632) (#1163 )

2026-08-19 11:39:39 -04:00

svelteCompileOptions.ts

build(web): move the SvelteKit and Svelte config into vite.config.ts (TASK-3423, PR A) (#1823 )

2026-10-05 23:38:37 -04:00

tsconfig.json

test(web): jsdom/Svelte vitest harness + Modal & breakpoint tests (TASK-2081) (#887 )

2026-07-09 19:53:55 -04:00

vite.config.ts

build(web): move the SvelteKit and Svelte config into vite.config.ts (TASK-3423, PR A) (#1823 )

2026-10-05 23:38:37 -04:00

vitest.config.ts

build(web): move the SvelteKit and Svelte config into vite.config.ts (TASK-3423, PR A) (#1823 )

2026-10-05 23:38:37 -04:00

README.md

Pad Web UI

SvelteKit 2 + Svelte 5 frontend for Pad, compiled to static files and embedded into the Go binary.

Development

npm install
npm run dev          # Dev server at localhost:5173 (proxies API to localhost:7777)
npm run build        # Production build to build/
npm run check        # Type checking with svelte-check

When developing, run the Go backend separately with make dev from the project root.

Building for Production

Do not build in isolation. Always use make build from the project root — this builds the web frontend, then compiles the Go binary with the build output embedded via //go:embed.

Stack

Svelte 5 with runes ($state, $derived, $effect)
SvelteKit 2 with adapter-static (SPA mode)
Tiptap block editor with markdown round-trip
svelte-dnd-action for drag-and-drop in board/list views
SSE for real-time updates
TypeScript throughout

Structure

src/
  routes/                    SvelteKit pages
    +layout.svelte           App shell (sidebar + main)
    +page.svelte             Landing/redirect
    [workspace]/
      +page.svelte           Dashboard (collections, phases, activity)
      +layout.svelte         SSE connection per workspace
      [collection]/
        +page.svelte         Collection view (board/list)
      [collection]/[item]/
        +page.svelte         Item detail + editor
      conventions/            Purpose-built conventions page
      playbooks/              Purpose-built playbooks page
      settings/               Workspace settings
  lib/
    api/client.ts            HTTP API client
    components/
      layout/                Sidebar, navigation
      editor/                Tiptap editor, raw markdown editor
      fields/                FieldEditor, relation picker
      items/                 ItemCard, ItemDetail
      collections/           BoardView, ListView
      common/                StatusBadge, badges, modals
      search/                CommandPalette
    stores/                  Svelte 5 reactive stores
      workspace.svelte.ts    Workspace state
      collections.svelte.ts  Collection + item state
      ui.svelte.ts           Sidebar, mobile state
    types/index.ts           TypeScript types and constants
  app.css                    Global styles and design tokens