Implement Knowledge City platform, organizer and DAV integration

Capture accumulated application, UI, CLI, regression tests and design documentation changes, including task project mapping and default CalDAV list naming.

Keep deployment data, backups, local credentials and build artifacts out of Git. Move the Compose enrollment token to an ignored local environment file.
This commit is contained in:
Anya Tokugawa committed 2026-09-27 14:44:43 +09:00
1 parent 288e6e94ac
commit c1175d389f
699 files changed
+110197 -4117

No files matched your search

+248
View File
@@ -0,0 +1,248 @@
package server
import (
"encoding/base64"
"errors"
"net/http"
"path/filepath"
"strings"
"pageswiki/internal/compiler"
"pageswiki/internal/render"
"pageswiki/internal/store"
)
type adapterWorkspaceFile struct {
Path string `json:"path"`
SemanticPath string `json:"semantic_path"`
RevisionUUID string `json:"revision_uuid"`
ContentType string `json:"content_type"`
ContentBase64 string `json:"content_base64"`
}
func (s *Server) adapterPluginForSession(session *store.AdapterSession) adapterPlugin {
plugins, _ := s.adapterPlugins(session.DomainUUID)
for _, plugin := range plugins {
if plugin.ID == session.PluginID {
return plugin
}
}
return adapterPlugin{}
}
func workspaceFilename(semanticPath, rootPath, filename string, markdown bool) string {
if semanticPath == rootPath {
filename = filepath.Base(filename)
if filename == "." || filename == "" || filename == "/" {
filename = "index.html"
}
if markdown {
filename = strings.TrimSuffix(filename, filepath.Ext(filename)) + ".md"
}
return filename
}
relative := strings.TrimPrefix(semanticPath, strings.TrimRight(rootPath, "/")+"/")
if filepath.Ext(relative) == "" && filepath.Ext(filename) != "" {
relative += filepath.Ext(filename)
}
if markdown {
relative = strings.TrimSuffix(relative, filepath.Ext(relative)) + ".md"
}
return relative
}
func (s *Server) workspaceFile(session *store.AdapterSession, semanticPath string, plugin adapterPlugin) (adapterWorkspaceFile, error) {
objectUUID, err := s.store.ResolvePathInDomain(session.DomainUUID, semanticPath)
if err != nil {
return adapterWorkspaceFile{}, err
}
revision, err := s.store.GetLatestRevisionForLanguages(objectUUID, []string{s.getLocale(session.DomainUUID), "und"})
if err != nil {
return adapterWorkspaceFile{}, err
}
body := revision.Body
markdown := plugin.HTMLMarkdown && strings.HasPrefix(strings.ToLower(revision.ContentType), "text/html")
if markdown {
body, err = compiler.HTMLToMarkdown(body)
if err != nil {
return adapterWorkspaceFile{}, err
}
}
return adapterWorkspaceFile{
Path: workspaceFilename(semanticPath, session.RootPath, revision.Filename, markdown),
SemanticPath: semanticPath,
RevisionUUID: revision.UUID, ContentType: revision.ContentType,
ContentBase64: base64.StdEncoding.EncodeToString([]byte(body)),
}, nil
}
func adapterBearer(r *http.Request) string {
value := strings.TrimSpace(r.Header.Get("Authorization"))
if !strings.HasPrefix(value, "Bearer ") {
return ""
}
return strings.TrimSpace(strings.TrimPrefix(value, "Bearer "))
}
// authorizeAdapterSession re-checks the current principal on every operation;
// exchanging a ticket must not pin permissions for the lifetime of a session.
func (s *Server) authorizeAdapterSession(r *http.Request, session *store.AdapterSession, capability string, path string) error {
if session.PrincipalUUID == "" {
if mode, _ := s.store.GetConfigInDomain(session.DomainUUID, "authorization_mode"); mode == "enforcing" {
return store.ErrAccessDenied
}
return nil
}
// The session token is intentionally separate from the browser auth token;
// use the principal captured at ticket issuance and re-evaluate its current
// grants on every request.
return s.store.Authorize(store.AuthorizationRequest{DomainUUID: session.DomainUUID, PrincipalUUID: session.PrincipalUUID, Capability: capability, TargetType: "path", TargetID: path})
}
func (s *Server) handleAdapterSessionAPI(w http.ResponseWriter, r *http.Request) {
action := strings.Trim(strings.TrimPrefix(r.URL.Path, "/_/api/v1/adapter/session"), "/")
if action == "exchange" && r.Method == http.MethodPost {
var input struct {
Ticket string `json:"ticket"`
}
if !decodeEventJSON(w, r, &input) {
return
}
token, session, err := s.store.ExchangeAdapterTicket(input.Ticket)
if err != nil {
writeEventJSON(w, http.StatusUnauthorized, map[string]string{"error": err.Error()})
return
}
revision, err := s.store.GetRevision(session.BaseRevisionUUID)
if err != nil {
writeEventJSON(w, 500, map[string]string{"error": err.Error()})
return
}
writeEventJSON(w, 200, map[string]any{
"session_token": token, "expires_at_ms": session.ExpiresAtMS,
"plugin_id": session.PluginID,
"revision_uuid": revision.UUID, "filename": revision.Filename,
"content_type": revision.ContentType, "lang": revision.Language,
})
return
}
if action == "content" {
session, err := s.store.GetAdapterSession(adapterBearer(r))
if err != nil {
writeEventJSON(w, http.StatusUnauthorized, map[string]string{"error": err.Error()})
return
}
if r.Method == http.MethodGet {
if err := s.authorizeAdapterSession(r, session, "read", session.RootPath); err != nil {
writeEventJSON(w, http.StatusForbidden, map[string]string{"error": "adapter session authorization revoked"})
return
}
file, err := s.workspaceFile(session, session.RootPath, s.adapterPluginForSession(session))
if err != nil {
writeEventJSON(w, 500, map[string]string{"error": err.Error()})
return
}
writeEventJSON(w, 200, file)
return
}
if r.Method == http.MethodPut {
if err := s.authorizeAdapterSession(r, session, "write", session.RootPath); err != nil {
writeEventJSON(w, http.StatusForbidden, map[string]string{"error": "adapter session authorization revoked"})
return
}
var input struct {
ContentBase64 string `json:"content_base64"`
Message string `json:"message"`
Path string `json:"path"`
RevisionUUID string `json:"revision_uuid"`
}
if !decodeEventJSON(w, r, &input) {
return
}
payload, err := base64.StdEncoding.DecodeString(input.ContentBase64)
if err != nil {
writeEventJSON(w, 400, map[string]string{"error": "invalid content_base64"})
return
}
if len(payload) > 64<<20 {
writeEventJSON(w, 413, map[string]string{"error": "content exceeds 64 MiB"})
return
}
semanticPath := session.RootPath
if input.Path != "" {
semanticPath = strings.TrimSpace(input.Path)
}
rootPrefix := strings.TrimRight(session.RootPath, "/") + "/"
if semanticPath != session.RootPath && !strings.HasPrefix(semanticPath, rootPrefix) {
writeEventJSON(w, 403, map[string]string{"error": "path is outside the adapter workspace"})
return
}
if err := s.authorizeAdapterSession(r, session, "write", semanticPath); err != nil {
writeEventJSON(w, http.StatusForbidden, map[string]string{"error": "adapter path authorization revoked"})
return
}
objectUUID, err := s.store.ResolvePathInDomain(session.DomainUUID, semanticPath)
if err != nil {
writeEventJSON(w, 404, map[string]string{"error": err.Error()})
return
}
baseRevisionUUID := input.RevisionUUID
if baseRevisionUUID == "" && semanticPath == session.RootPath {
baseRevisionUUID = session.BaseRevisionUUID
}
base, err := s.store.GetRevision(baseRevisionUUID)
if err != nil || base.ObjectUUID != objectUUID {
writeEventJSON(w, 409, map[string]string{"error": "invalid base revision"})
return
}
plugin := s.adapterPluginForSession(session)
if plugin.HTMLMarkdown && strings.HasPrefix(strings.ToLower(base.ContentType), "text/html") {
payload = []byte(render.Markdown(string(payload)))
}
revision, err := s.store.SaveHostedRevisionAt(session, objectUUID, baseRevisionUUID, payload, input.Message)
if err != nil {
status := 500
if errors.Is(err, store.ErrRevisionConflict) {
status = http.StatusConflict
}
writeEventJSON(w, status, map[string]string{"error": err.Error()})
return
}
writeEventJSON(w, 200, map[string]any{"revision_uuid": revision.UUID, "document_hash": revision.DocumentHash})
return
}
}
if action == "workspace" && r.Method == http.MethodGet {
session, err := s.store.GetAdapterSession(adapterBearer(r))
if err != nil {
writeEventJSON(w, http.StatusUnauthorized, map[string]string{"error": err.Error()})
return
}
if err := s.authorizeAdapterSession(r, session, "read", session.RootPath); err != nil {
writeEventJSON(w, http.StatusForbidden, map[string]string{"error": "adapter session authorization revoked"})
return
}
paths := []string{session.RootPath}
children, err := s.store.ListChildrenInDomain(session.DomainUUID, session.RootPath)
if err != nil {
writeEventJSON(w, 500, map[string]string{"error": err.Error()})
return
}
paths = append(paths, children...)
plugin := s.adapterPluginForSession(session)
files := make([]adapterWorkspaceFile, 0, len(paths))
for _, path := range paths {
file, fileErr := s.workspaceFile(session, path, plugin)
if fileErr == nil {
files = append(files, file)
}
}
payload := map[string]any{"root_path": session.RootPath, "files": files}
if session.PluginID == "vim.wasm" {
payload["vim_settings"] = s.domainVimSettings(session.DomainUUID)
}
writeEventJSON(w, 200, payload)
return
}
writeEventJSON(w, http.StatusMethodNotAllowed, map[string]string{"error": "unsupported adapter session operation"})
}