Skip to content

Open-source LLM knowledge platform: turn raw documents into a queryable RAG, an autonomous reasoning agent, and a self-maintaining Wiki.

6.7 KB
Raw Blame
package service

import (
	"context"
	"encoding/json"
	"errors"
	"testing"

	"github.com/Tencent/WeKnora/internal/types"
	"github.com/hibiken/asynq"
	"github.com/stretchr/testify/require"
)

type optionalSummaryKnowledgeRepo struct {
	wikiEnqueueFailureKnowledgeRepo
	completionErr     error
	completionSkipped bool
}

func (r *optionalSummaryKnowledgeRepo) UpdateKnowledgeColumn(
	_ context.Context, _ string, column string, value interface{},
) error {
	if column == "summary_status" {
		r.knowledge.SummaryStatus = value.(string)
	}
	return nil
}

func (r *optionalSummaryKnowledgeRepo) CompleteProcessingWithoutSubtasks(context.Context, string) (bool, error) {
	if r.completionErr != nil {
		return false, r.completionErr
	}
	if r.completionSkipped {
		return false, nil
	}
	r.knowledge.ParseStatus = types.ParseStatusCompleted
	r.knowledge.SummaryStatus = types.SummaryStatusNone
	return true, nil
}

func TestKnowledgePostProcessOptionalSummary(t *testing.T) {
	t.Setenv("NEO4J_ENABLE", "true")
	for _, tt := range []struct {
		name      string
		summary   *bool
		question  bool
		graph     bool
		wiki      bool
		wantTasks []string
	}{
		{name: "legacy defaults generate summary", wantTasks: []string{types.TypeSummaryGeneration}},
		{
			name:      "explicitly enabled",
			summary:   processConfigBoolPtr(true),
			wantTasks: []string{types.TypeSummaryGeneration},
		},
		{name: "disabled completes without enrichment", summary: processConfigBoolPtr(false)},
		{
			name:      "disabled preserves question generation",
			summary:   processConfigBoolPtr(false),
			question:  true,
			wantTasks: []string{types.TypeQuestionGeneration},
		},
		{
			name:      "disabled preserves graph extraction",
			summary:   processConfigBoolPtr(false),
			graph:     true,
			wantTasks: []string{types.TypeChunkExtract},
		},
		{
			name:      "disabled preserves wiki generation",
			summary:   processConfigBoolPtr(false),
			wiki:      true,
			wantTasks: []string{types.TypeWikiIngest},
		},
	} {
		t.Run(tt.name, func(t *testing.T) {
			knowledge := &types.Knowledge{
				ID: "doc", TenantID: 7, KnowledgeBaseID: "kb", ParseStatus: types.ParseStatusProcessing,
			}
			require.NoError(t, knowledge.SetProcessOverrides(&types.KnowledgeProcessOverrides{
				SummaryEnabled: tt.summary,
			}))
			repo := &optionalSummaryKnowledgeRepo{
				wikiEnqueueFailureKnowledgeRepo: wikiEnqueueFailureKnowledgeRepo{knowledge: knowledge},
			}
			queue := &wikiEnqueueFailureTaskQueue{}
			kb := &types.KnowledgeBase{
				ID: "kb", TenantID: 7,
				IndexingStrategy: types.IndexingStrategy{
					VectorEnabled: true, GraphEnabled: tt.graph, WikiEnabled: tt.wiki,
				},
				QuestionGenerationConfig: &types.QuestionGenerationConfig{Enabled: tt.question},
				ExtractConfig:            &types.ExtractConfig{Enabled: tt.graph},
			}
			service := &KnowledgePostProcessService{
				knowledgeRepo: repo,
				kbService:     &wikiEnqueueFailureKBService{kb: kb},
				chunkRepo: &wikiEnqueueFailureChunkRepo{chunks: []*types.Chunk{{
					ID: "chunk", TenantID: 7, KnowledgeID: "doc", KnowledgeBaseID: "kb",
					ChunkType: types.ChunkTypeText, Content: "Document content for summary and enrichment.",
				}}},
				taskEnqueuer: queue,
				pendingRepo:  &wikiEnqueueFailurePendingRepo{knowledgeRepo: &repo.wikiEnqueueFailureKnowledgeRepo},
			}
			payload, err := json.Marshal(types.KnowledgePostProcessPayload{
				TenantID: 7, KnowledgeID: "doc", KnowledgeBaseID: "kb",
			})
			require.NoError(t, err)
			task := asynq.NewTask(types.TypeKnowledgePostProcess, payload)
			require.NoError(t, service.Handle(context.Background(), task))
			require.Equal(t, tt.wantTasks, queue.taskTypes)
			require.Equal(t, len(tt.wantTasks), repo.expectedSubtasks)
			if len(tt.wantTasks) == 0 {
				require.Equal(t, types.ParseStatusCompleted, knowledge.ParseStatus)
			} else {
				require.Equal(t, types.ParseStatusFinalizing, knowledge.ParseStatus)
			}
			if tt.summary != nil && !*tt.summary {
				require.Equal(t, types.SummaryStatusNone, knowledge.SummaryStatus)
			} else {
				require.Equal(t, types.SummaryStatusPending, knowledge.SummaryStatus)
			}
		})
	}
}

func TestKnowledgePostProcessWithoutSummaryCompletionFailure(t *testing.T) {
	for _, tc := range []struct {
		name    string
		err     error
		skipped bool
	}{
		{name: "database failure is retryable", err: errors.New("database unavailable")},
		{name: "concurrent cancellation skips auto tagging", skipped: true},
	} {
		t.Run(tc.name, func(t *testing.T) {
			knowledge := &types.Knowledge{
				ID: "doc", TenantID: 7, KnowledgeBaseID: "kb", ParseStatus: types.ParseStatusProcessing,
			}
			require.NoError(t, knowledge.SetProcessOverrides(&types.KnowledgeProcessOverrides{
				SummaryEnabled: processConfigBoolPtr(false),
			}))
			repo := &optionalSummaryKnowledgeRepo{
				wikiEnqueueFailureKnowledgeRepo: wikiEnqueueFailureKnowledgeRepo{knowledge: knowledge},
				completionErr:                   tc.err, completionSkipped: tc.skipped,
			}
			tracker, db := setupSpanTrackerTest(t)
			ctx := types.WithTaskRetryMetadata(context.Background(), 0, 3)
			_, attempt, err := tracker.OpenAttempt(ctx, knowledge.ID, "")
			require.NoError(t, err)
			queue := &wikiEnqueueFailureTaskQueue{}
			svc := &KnowledgePostProcessService{
				knowledgeRepo: repo,
				spanTracker:   tracker,
				kbService: &wikiEnqueueFailureKBService{kb: &types.KnowledgeBase{
					ID: "kb", TenantID: 7, Type: types.KnowledgeBaseTypeDocument,
					AutoTagConfig: &types.AutoTagConfig{Enabled: true},
				}},
				chunkRepo: &wikiEnqueueFailureChunkRepo{chunks: []*types.Chunk{{
					ID: "chunk", TenantID: 7, KnowledgeID: "doc", KnowledgeBaseID: "kb",
					ChunkType: types.ChunkTypeText, Content: "Document content.",
				}}},
				taskEnqueuer: queue,
			}
			payload, err := json.Marshal(types.KnowledgePostProcessPayload{
				TenantID: 7, KnowledgeID: "doc", KnowledgeBaseID: "kb",
			})
			require.NoError(t, err)
			err = svc.Handle(ctx, asynq.NewTask(types.TypeKnowledgePostProcess, payload))
			require.ErrorIs(t, err, tc.err)
			require.Empty(t, queue.taskTypes)
			require.Equal(t, types.ParseStatusProcessing, knowledge.ParseStatus)
			if tc.err != nil {
				status, code, message := rootSpan(t, db, knowledge.ID, attempt)
				require.Equal(t, types.SpanStatusRunning, status)
				require.Empty(t, code)
				require.Empty(t, message)
				repo.completionErr = nil
				ctx = types.WithTaskRetryMetadata(ctx, 1, 3)
				task := asynq.NewTask(types.TypeKnowledgePostProcess, payload)
				require.NoError(t, svc.Handle(ctx, task))
				require.Equal(t, types.ParseStatusCompleted, knowledge.ParseStatus)
				status, code, message = rootSpan(t, db, knowledge.ID, attempt)
				require.Equal(t, types.SpanStatusDone, status)
				require.Empty(t, code)
				require.Empty(t, message)
				require.Equal(t, []string{types.TypeKnowledgeAutoTag}, queue.taskTypes)
			}
		})
	}
}