WeKnora deployment source with the reviewed wiki identity, summary and recovery fixes

cli/internal/compat/cache.go

@@ -0,0 +1,51 @@
+package compat
+
+import (
+	"errors"
+	"fmt"
+	"os"
+	"time"
+
+	"gopkg.in/yaml.v3"
+
+	"github.com/Tencent/WeKnora/cli/internal/xdg"
+)
+
+const ttl = 24 * time.Hour
+
+func cachePath() (string, error) {
+	return xdg.Path("XDG_CACHE_HOME", ".cache", "server-info.yaml")
+}
+
+// LoadCache reads the cached Info. Returns (info, fresh, err).
+//
+//	info == nil when no cache exists (err == nil)
+//	fresh == false when the cache is missing or TTL-expired
+func LoadCache() (*Info, bool, error) {
+	p, err := cachePath()
+	if err != nil {
+		return nil, false, err
+	}
+	data, err := os.ReadFile(p)
+	if errors.Is(err, os.ErrNotExist) {
+		return nil, false, nil
+	}
+	if err != nil {
+		return nil, false, fmt.Errorf("read cache: %w", err)
+	}
+	var info Info
+	if err := yaml.Unmarshal(data, &info); err != nil {
+		return nil, false, fmt.Errorf("parse cache: %w", err)
+	}
+	fresh := time.Since(info.ProbedAt) < ttl
+	return &info, fresh, nil
+}
+
+// SaveCache atomically writes Info to the cache file (mode 0600).
+func SaveCache(info *Info) error {
+	p, err := cachePath()
+	if err != nil {
+		return err
+	}
+	return xdg.WriteAtomicYAML(p, info)
+}