Files
Memoh/internal/mcp/versioning.go
T
BBQ bc374fe8cd refactor: content-addressed assets, cross-channel multimodal, infra simplification (#63)
* refactor(attachment): multimodal attachment refactor with snapshot schema and storage layer

- Add snapshot schema migration (0008) and update init/versions/snapshots
- Add internal/attachment and internal/channel normalize for unified attachment handling
- Move containerfs provider from internal/media to internal/storage
- Update agent types, channel adapters (Telegram/Feishu), inbound and handlers
- Add containerd snapshot lineage and local_channel tests
- Regenerate sqlc, swagger and SDK

* refactor(media): content-addressed asset system with unified naming

- Replace asset_id foreign key with content_hash as sole identifier
  for bot_history_message_assets (pure soft-link model)
- Remove mime, size_bytes, storage_key from DB; derive at read time
  via media.Resolve from actual storage
- Merge migrations 0008/0009 into single 0008; keep 0001 as canonical schema
- Add Docker initdb script for deterministic migration execution order
- Fix cross-channel real-time image display (Telegram → WebUI SSE)
- Fix message disappearing on refresh (null assets fallback)
- Fix file icon instead of image preview (mime derivation from storage)
- Unify AssetID → ContentHash naming across Go, Agent, and Frontend
- Change storage key prefix from 4-char to 2-char for directory sharding
- Add server-entrypoint.sh for Docker deployment migration handling

* refactor(infra): embedded migrations, Docker simplification, and config consolidation

- Embed SQL migrations into Go binary, removing shell-based migration scripts
- Consolidate config files into conf/ directory (app.example.toml, app.docker.toml, app.dev.toml)
- Simplify Docker setup: remove initdb.d scripts, streamline nginx config and entrypoint
- Remove legacy CLI, feishu-echo commands, and obsolete incremental migration files
- Update install script and docs to require sudo for one-click install
- Add mise tasks for dev environment orchestration

* chore: recover migrations

---------

Co-authored-by: Acbox <acbox0328@gmail.com>
2026-02-19 00:20:27 +08:00

492 lines
12 KiB
Go

package mcp
import (
"context"
"encoding/json"
"fmt"
"strings"
"time"
"github.com/containerd/containerd/v2/pkg/oci"
"github.com/containerd/errdefs"
"github.com/google/uuid"
"github.com/jackc/pgx/v5/pgtype"
"github.com/opencontainers/runtime-spec/specs-go"
"github.com/memohai/memoh/internal/config"
ctr "github.com/memohai/memoh/internal/containerd"
"github.com/memohai/memoh/internal/db"
dbsqlc "github.com/memohai/memoh/internal/db/sqlc"
)
const (
SnapshotSourceManual = "manual"
SnapshotSourcePreExec = "pre_exec"
SnapshotSourceRollback = "rollback"
)
type VersionInfo struct {
ID string
Version int
SnapshotName string
CreatedAt time.Time
}
type SnapshotCreateInfo struct {
ContainerID string
SnapshotName string
Snapshotter string
Version int
CreatedAt time.Time
}
func (m *Manager) CreateSnapshot(ctx context.Context, botID, snapshotName, source string) (*SnapshotCreateInfo, error) {
if m.db == nil || m.queries == nil {
return nil, fmt.Errorf("db is not configured")
}
if err := validateBotID(botID); err != nil {
return nil, err
}
containerID := m.containerID(botID)
unlock := m.lockContainer(containerID)
defer unlock()
container, err := m.service.GetContainer(ctx, containerID)
if err != nil {
return nil, err
}
info, err := container.Info(ctx)
if err != nil {
return nil, err
}
if _, err := m.ensureDBRecords(ctx, botID, info.ID, info.Runtime.Name, info.Image); err != nil {
return nil, err
}
normalizedSnapshotName := strings.TrimSpace(snapshotName)
if normalizedSnapshotName == "" {
normalizedSnapshotName = fmt.Sprintf("%s-%s", containerID, time.Now().Format("20060102150405"))
}
normalizedSource := normalizeSnapshotSource(source)
if err := m.service.CommitSnapshot(ctx, info.Snapshotter, normalizedSnapshotName, info.SnapshotKey); err != nil {
return nil, err
}
_, versionNumber, createdAt, err := m.recordSnapshotVersion(
ctx,
containerID,
normalizedSnapshotName,
info.SnapshotKey,
info.Snapshotter,
normalizedSource,
)
if err != nil {
return nil, err
}
if err := m.insertEvent(ctx, containerID, "snapshot_create", map[string]any{
"snapshot_name": normalizedSnapshotName,
"snapshotter": info.Snapshotter,
"source": normalizedSource,
"version": versionNumber,
}); err != nil {
return nil, err
}
return &SnapshotCreateInfo{
ContainerID: containerID,
SnapshotName: normalizedSnapshotName,
Snapshotter: info.Snapshotter,
Version: versionNumber,
CreatedAt: createdAt,
}, nil
}
func (m *Manager) CreateVersion(ctx context.Context, botID string) (*VersionInfo, error) {
if m.db == nil || m.queries == nil {
return nil, fmt.Errorf("db is not configured")
}
if err := validateBotID(botID); err != nil {
return nil, err
}
containerID := m.containerID(botID)
unlock := m.lockContainer(containerID)
defer unlock()
container, err := m.service.GetContainer(ctx, containerID)
if err != nil {
return nil, err
}
info, err := container.Info(ctx)
if err != nil {
return nil, err
}
if _, err := m.ensureDBRecords(ctx, botID, info.ID, info.Runtime.Name, info.Image); err != nil {
return nil, err
}
if err := m.safeStopTask(ctx, containerID); err != nil {
return nil, err
}
versionSnapshotName := fmt.Sprintf("%s-v%d", containerID, time.Now().UnixNano())
if err := m.service.CommitSnapshot(ctx, info.Snapshotter, versionSnapshotName, info.SnapshotKey); err != nil {
return nil, err
}
activeSnapshotName := fmt.Sprintf("%s-active-%d", containerID, time.Now().UnixNano())
if err := m.service.PrepareSnapshot(ctx, info.Snapshotter, activeSnapshotName, versionSnapshotName); err != nil {
return nil, err
}
if err := m.service.DeleteContainer(ctx, containerID, &ctr.DeleteContainerOptions{CleanupSnapshot: false}); err != nil {
return nil, err
}
dataDir, err := m.ensureBotDir(botID)
if err != nil {
return nil, err
}
dataMount := m.cfg.DataMount
if dataMount == "" {
dataMount = config.DefaultDataMount
}
resolvPath, err := ctr.ResolveConfSource(dataDir)
if err != nil {
return nil, err
}
specOpts := []oci.SpecOpts{
oci.WithMounts([]specs.Mount{
{
Destination: dataMount,
Type: "bind",
Source: dataDir,
Options: []string{"rbind", "rw"},
},
{
Destination: "/etc/resolv.conf",
Type: "bind",
Source: resolvPath,
Options: []string{"rbind", "ro"},
},
}),
}
_, err = m.service.CreateContainerFromSnapshot(ctx, ctr.CreateContainerRequest{
ID: containerID,
ImageRef: info.Image,
SnapshotID: activeSnapshotName,
Snapshotter: info.Snapshotter,
Labels: info.Labels,
SpecOpts: specOpts,
})
if err != nil {
return nil, err
}
versionID, versionNumber, createdAt, err := m.recordSnapshotVersion(
ctx,
containerID,
versionSnapshotName,
info.SnapshotKey,
info.Snapshotter,
SnapshotSourcePreExec,
)
if err != nil {
return nil, err
}
if err := m.insertEvent(ctx, containerID, "version_create", map[string]any{
"snapshot_name": versionSnapshotName,
"version": versionNumber,
"version_id": versionID,
}); err != nil {
return nil, err
}
return &VersionInfo{
ID: versionID,
Version: versionNumber,
SnapshotName: versionSnapshotName,
CreatedAt: createdAt,
}, nil
}
func (m *Manager) ListVersions(ctx context.Context, botID string) ([]VersionInfo, error) {
if m.db == nil || m.queries == nil {
return nil, fmt.Errorf("db is not configured")
}
if err := validateBotID(botID); err != nil {
return nil, err
}
containerID := m.containerID(botID)
versions, err := m.queries.ListVersionsByContainerID(ctx, containerID)
if err != nil {
return nil, err
}
out := make([]VersionInfo, 0, len(versions))
for _, row := range versions {
createdAt := time.Time{}
if row.CreatedAt.Valid {
createdAt = row.CreatedAt.Time
}
out = append(out, VersionInfo{
ID: uuidString(row.ID),
Version: int(row.Version),
SnapshotName: row.RuntimeSnapshotName,
CreatedAt: createdAt,
})
}
return out, nil
}
func (m *Manager) RollbackVersion(ctx context.Context, botID string, version int) error {
if m.db == nil || m.queries == nil {
return fmt.Errorf("db is not configured")
}
if err := validateBotID(botID); err != nil {
return err
}
containerID := m.containerID(botID)
unlock := m.lockContainer(containerID)
defer unlock()
snapshotName, err := m.queries.GetVersionSnapshotRuntimeName(ctx, dbsqlc.GetVersionSnapshotRuntimeNameParams{
ContainerID: containerID,
Version: int32(version),
})
if err != nil {
return err
}
container, err := m.service.GetContainer(ctx, containerID)
if err != nil {
return err
}
info, err := container.Info(ctx)
if err != nil {
return err
}
if err := m.safeStopTask(ctx, containerID); err != nil {
return err
}
activeSnapshotName := fmt.Sprintf("%s-rollback-%d", containerID, time.Now().UnixNano())
if err := m.service.PrepareSnapshot(ctx, info.Snapshotter, activeSnapshotName, snapshotName); err != nil {
return err
}
if err := m.service.DeleteContainer(ctx, containerID, &ctr.DeleteContainerOptions{CleanupSnapshot: false}); err != nil {
return err
}
dataDir, err := m.ensureBotDir(botID)
if err != nil {
return err
}
dataMount := m.cfg.DataMount
if dataMount == "" {
dataMount = config.DefaultDataMount
}
resolvPath, err := ctr.ResolveConfSource(dataDir)
if err != nil {
return err
}
specOpts := []oci.SpecOpts{
oci.WithMounts([]specs.Mount{
{
Destination: dataMount,
Type: "bind",
Source: dataDir,
Options: []string{"rbind", "rw"},
},
{
Destination: "/etc/resolv.conf",
Type: "bind",
Source: resolvPath,
Options: []string{"rbind", "ro"},
},
}),
}
_, err = m.service.CreateContainerFromSnapshot(ctx, ctr.CreateContainerRequest{
ID: containerID,
ImageRef: info.Image,
SnapshotID: activeSnapshotName,
Snapshotter: info.Snapshotter,
Labels: info.Labels,
SpecOpts: specOpts,
})
if err != nil {
return err
}
return m.insertEvent(ctx, containerID, "version_rollback", map[string]any{
"snapshot_name": snapshotName,
"version": version,
"source": SnapshotSourceRollback,
})
}
func (m *Manager) VersionSnapshotName(ctx context.Context, botID string, version int) (string, error) {
if m.db == nil || m.queries == nil {
return "", fmt.Errorf("db is not configured")
}
if err := validateBotID(botID); err != nil {
return "", err
}
containerID := m.containerID(botID)
return m.queries.GetVersionSnapshotRuntimeName(ctx, dbsqlc.GetVersionSnapshotRuntimeNameParams{
ContainerID: containerID,
Version: int32(version),
})
}
func (m *Manager) safeStopTask(ctx context.Context, containerID string) error {
err := m.service.StopTask(ctx, containerID, &ctr.StopTaskOptions{
Timeout: 10 * time.Second,
Force: true,
})
if err == nil {
return nil
}
if errdefs.IsNotFound(err) {
return nil
}
return err
}
func (m *Manager) ensureDBRecords(ctx context.Context, botID, containerID, runtime, imageRef string) (pgtype.UUID, error) {
hostPath, err := m.DataDir(botID)
if err != nil {
return pgtype.UUID{}, err
}
botUUID, err := db.ParseUUID(botID)
if err != nil {
return pgtype.UUID{}, err
}
if _, err := m.queries.GetBotByID(ctx, botUUID); err != nil {
return pgtype.UUID{}, err
}
containerPath := m.cfg.DataMount
if containerPath == "" {
containerPath = config.DefaultDataMount
}
if err := m.queries.UpsertContainer(ctx, dbsqlc.UpsertContainerParams{
BotID: botUUID,
ContainerID: containerID,
ContainerName: containerID,
Image: imageRef,
Status: "created",
Namespace: "default",
AutoStart: true,
HostPath: pgtype.Text{String: hostPath, Valid: hostPath != ""},
ContainerPath: containerPath,
LastStartedAt: pgtype.Timestamptz{},
LastStoppedAt: pgtype.Timestamptz{},
}); err != nil {
return pgtype.UUID{}, err
}
return botUUID, nil
}
func (m *Manager) recordSnapshotVersion(ctx context.Context, containerID, runtimeSnapshotName, parentRuntimeSnapshotName, snapshotter, source string) (string, int, time.Time, error) {
containerID = strings.TrimSpace(containerID)
runtimeSnapshotName = strings.TrimSpace(runtimeSnapshotName)
snapshotter = strings.TrimSpace(snapshotter)
if containerID == "" || runtimeSnapshotName == "" || snapshotter == "" {
return "", 0, time.Time{}, ctr.ErrInvalidArgument
}
tx, err := m.db.Begin(ctx)
if err != nil {
return "", 0, time.Time{}, err
}
defer tx.Rollback(ctx)
qtx := m.queries.WithTx(tx)
parent := pgtype.Text{}
normalizedParent := strings.TrimSpace(parentRuntimeSnapshotName)
if normalizedParent != "" {
parent = pgtype.Text{String: normalizedParent, Valid: true}
}
snapshotRow, err := qtx.UpsertSnapshot(ctx, dbsqlc.UpsertSnapshotParams{
ContainerID: containerID,
RuntimeSnapshotName: runtimeSnapshotName,
ParentRuntimeSnapshotName: parent,
Snapshotter: snapshotter,
Source: normalizeSnapshotSource(source),
})
if err != nil {
return "", 0, time.Time{}, err
}
version, err := qtx.NextVersion(ctx, containerID)
if err != nil {
return "", 0, time.Time{}, err
}
versionRow, err := qtx.InsertVersion(ctx, dbsqlc.InsertVersionParams{
ContainerID: containerID,
SnapshotID: snapshotRow.ID,
Version: version,
})
if err != nil {
return "", 0, time.Time{}, err
}
if err := tx.Commit(ctx); err != nil {
return "", 0, time.Time{}, err
}
createdAt := time.Time{}
if versionRow.CreatedAt.Valid {
createdAt = versionRow.CreatedAt.Time
}
return uuidString(versionRow.ID), int(version), createdAt, nil
}
func (m *Manager) insertEvent(ctx context.Context, containerID, eventType string, payload map[string]any) error {
b, err := json.Marshal(payload)
if err != nil {
return err
}
return m.queries.InsertLifecycleEvent(ctx, dbsqlc.InsertLifecycleEventParams{
ID: fmt.Sprintf("%s-%d", containerID, time.Now().UnixNano()),
ContainerID: containerID,
EventType: eventType,
Payload: b,
})
}
func normalizeSnapshotSource(source string) string {
s := strings.TrimSpace(source)
if s == "" {
return SnapshotSourceManual
}
return s
}
func uuidString(v pgtype.UUID) string {
if !v.Valid {
return ""
}
return uuid.UUID(v.Bytes).String()
}