Commit Graph

3 Commits

Author SHA1 Message Date
vvzvlad
cc584a97f3 docs(spec): resolve remaining §12 open questions; expand §16 REST map
Research Docmost source (docmost/docmost@main) to close the last four §12 items.

- auth: dedicated service user; API-key (EE/Cloud) vs login JWT (OSS, 90d default,
  no refresh, session-bound) with "401 -> re-login"
- position: reuse `fractional-indexing-jittered` generateJitteredKeyBetween,
  siblings via /sidebar-pages, compare as raw bytes (COLLATE "C")
- initial clone: canonical = sidebar-pages walk + /info via our converter;
  spaces/export (turndown markdown, no meta/anchors) is bootstrap-only, not baseline
- attachments: v1 keeps them as links (out of scope), includeAttachments flag noted
- §16: add auth/JWT/API-key facts, /sidebar-pages, bulk export endpoints,
  extra gotchas (collation, throttling, EE-only API keys)
- park "REST vs direct Postgres" as the sole remaining open question
2026-06-16 18:54:10 +03:00
vvzvlad
42eb986596 docs(spec): resolve open questions §12 and add confirmed Docmost REST map
Research Docmost source (docmost/docmost@main) to pin real REST endpoints
and close all five §12 TODOs.

- §6: replace MCP `list_pages` polling with the real "changes since T"
  mechanism — `POST /api/pages/recent` (updatedAt DESC, cursor) + client cutoff
- §8: concrete trash/restore endpoints (per-space `trash`, `restore`),
  auto-purge note and `permanentlyDelete` guard
- §10: add `lastUpdatedById` loop-guard signal
- §12: turn open questions into decisions (trash/restore, changes-since-T,
  commit-attribution trailer, filename collisions, long-offline reconciliation);
  add a new list of genuinely-open items
- §15/§16: add the confirmed Docmost REST map (auth, info, recent, create,
  update, move, move-to-space, delete, trash, restore) with gotchas
- fix a nested-list markdown glitch in §12
2026-06-16 18:37:50 +03:00
vvzvlad
d5cd1bba02 docs: add project spec and VS Code workspace 2026-06-16 18:30:04 +03:00