6f8b825f5f
The `weknora` command-line client for the WeKnora RAG server. Full command surface: kb / doc / chunk / session / message / agent / model / search / chat / auth / profile / link / api / mcp / skills / config / doctor / schema / exit-codes. Agent-first wire contract: JSON envelope by default, typed error codes mapped to stable exit codes, error.retry_argv / retryable / partial-failure status, global --dry-run preview, the exit-10 confirmation protocol for writes, and control/ANSI/Bidi input hygiene. Stateless env-credential auth (WEKNORA_API_KEY / WEKNORA_TOKEN + WEKNORA_HOST) for headless/CI/agent use. A curated read-only MCP tool surface (`mcp serve`) and embedded Agent Skills (`skills install`). Extensive unit + contract-golden tests and CI.
135 lines
4.5 KiB
Go
135 lines
4.5 KiB
Go
package kb
|
|
|
|
import (
|
|
"context"
|
|
"encoding/json"
|
|
"errors"
|
|
"testing"
|
|
|
|
"github.com/spf13/cobra"
|
|
"github.com/stretchr/testify/assert"
|
|
"github.com/stretchr/testify/require"
|
|
|
|
"github.com/Tencent/WeKnora/cli/internal/cmdutil"
|
|
"github.com/Tencent/WeKnora/cli/internal/iostreams"
|
|
"github.com/Tencent/WeKnora/cli/internal/prompt"
|
|
sdk "github.com/Tencent/WeKnora/client"
|
|
)
|
|
|
|
type fakeInitSvc struct {
|
|
gotKB string
|
|
gotCfg *sdk.KBModelConfig
|
|
result *sdk.InitializationConfig
|
|
setErr error
|
|
}
|
|
|
|
func (f *fakeInitSvc) SetKBModelConfig(_ context.Context, kbID string, cfg *sdk.KBModelConfig) error {
|
|
f.gotKB = kbID
|
|
f.gotCfg = cfg
|
|
return f.setErr
|
|
}
|
|
|
|
func (f *fakeInitSvc) GetInitializationConfig(_ context.Context, _ string) (*sdk.InitializationConfig, error) {
|
|
if f.result != nil {
|
|
return f.result, nil
|
|
}
|
|
if f.gotCfg == nil {
|
|
return &sdk.InitializationConfig{}, nil
|
|
}
|
|
return &sdk.InitializationConfig{
|
|
ChatModelID: f.gotCfg.LLMModelID,
|
|
EmbeddingModelID: f.gotCfg.EmbeddingModelID,
|
|
}, nil
|
|
}
|
|
|
|
func TestKBInit_AppliesAndEmitsResult(t *testing.T) {
|
|
out, _ := iostreams.SetForTest(t)
|
|
svc := &fakeInitSvc{}
|
|
opts := &InitOptions{ChatModel: "model_llm", EmbeddingModel: "model_emb"}
|
|
require.NoError(t, runInit(context.Background(), opts, &cmdutil.FormatOptions{Mode: cmdutil.FormatJSON}, svc, "kb_abc"))
|
|
|
|
assert.Equal(t, "kb_abc", svc.gotKB)
|
|
require.NotNil(t, svc.gotCfg)
|
|
assert.Equal(t, "model_llm", svc.gotCfg.LLMModelID)
|
|
assert.Equal(t, "model_emb", svc.gotCfg.EmbeddingModelID)
|
|
|
|
var env struct {
|
|
OK bool `json:"ok"`
|
|
Data sdk.InitializationConfig `json:"data"`
|
|
}
|
|
require.NoError(t, json.Unmarshal(out.Bytes(), &env))
|
|
assert.True(t, env.OK)
|
|
assert.Equal(t, "model_emb", env.Data.EmbeddingModelID)
|
|
assert.Equal(t, "model_llm", env.Data.ChatModelID)
|
|
}
|
|
|
|
func TestKBInit_RequiresBothModels(t *testing.T) {
|
|
_, _ = iostreams.SetForTest(t)
|
|
svc := &fakeInitSvc{}
|
|
// Missing both.
|
|
err := runInit(context.Background(), &InitOptions{}, &cmdutil.FormatOptions{Mode: cmdutil.FormatText}, svc, "kb_abc")
|
|
var ce *cmdutil.Error
|
|
require.ErrorAs(t, err, &ce)
|
|
assert.Equal(t, cmdutil.CodeInputMissingFlag, ce.Code)
|
|
assert.Equal(t, "", svc.gotKB, "must not call SetKBModelConfig when flags are missing")
|
|
|
|
// Missing just embedding.
|
|
err = runInit(context.Background(), &InitOptions{ChatModel: "m"}, &cmdutil.FormatOptions{Mode: cmdutil.FormatText}, svc, "kb_abc")
|
|
require.ErrorAs(t, err, &ce)
|
|
assert.Contains(t, ce.Message, "--embedding-model")
|
|
}
|
|
|
|
func TestKBInit_WriteSucceedsReadbackFails(t *testing.T) {
|
|
out, _ := iostreams.SetForTest(t)
|
|
svc2 := &readbackErrSvc{fakeInitSvc: &fakeInitSvc{}}
|
|
opts := &InitOptions{ChatModel: "model_llm", EmbeddingModel: "model_emb"}
|
|
require.NoError(t, runInit(context.Background(), opts, &cmdutil.FormatOptions{Mode: cmdutil.FormatJSON}, svc2, "kb_abc"))
|
|
var env struct {
|
|
Data sdk.InitializationConfig `json:"data"`
|
|
}
|
|
require.NoError(t, json.Unmarshal(out.Bytes(), &env))
|
|
assert.Equal(t, "model_emb", env.Data.EmbeddingModelID, "falls back to applied config when read-back fails")
|
|
}
|
|
|
|
type readbackErrSvc struct{ *fakeInitSvc }
|
|
|
|
func (s *readbackErrSvc) GetInitializationConfig(_ context.Context, _ string) (*sdk.InitializationConfig, error) {
|
|
return nil, errors.New("read-back boom")
|
|
}
|
|
|
|
// withRootKB wraps a kb subcommand under a synthetic root with global flags,
|
|
// keyed off the sub's own name (unlike withRootHarnessKB which is hardcoded to
|
|
// `update`).
|
|
func withRootKB(sub *cobra.Command, args ...string) *cobra.Command {
|
|
root := &cobra.Command{Use: "weknora"}
|
|
pf := root.PersistentFlags()
|
|
pf.BoolP("yes", "y", false, "")
|
|
pf.String("format", "", "")
|
|
pf.StringP("jq", "q", "", "")
|
|
kb := &cobra.Command{Use: "kb"}
|
|
kb.AddCommand(sub)
|
|
root.AddCommand(kb)
|
|
root.SetArgs(append([]string{"kb", sub.Name()}, args...))
|
|
root.SetContext(context.Background())
|
|
root.SilenceErrors = true
|
|
root.SilenceUsage = true
|
|
return root
|
|
}
|
|
|
|
func TestKBInit_RequiresConfirmation(t *testing.T) {
|
|
iostreams.SetForTest(t)
|
|
f := &cmdutil.Factory{
|
|
Client: func() (*sdk.Client, error) { return nil, nil },
|
|
Prompter: func() prompt.Prompter { return prompt.AgentPrompter{} },
|
|
}
|
|
root := withRootKB(NewCmdInit(f), "kb_abc", "--chat-model", "model_llm", "--embedding-model", "model_emb", "--format", "json")
|
|
err := root.Execute()
|
|
require.Error(t, err)
|
|
var ce *cmdutil.Error
|
|
require.ErrorAs(t, err, &ce)
|
|
assert.Equal(t, cmdutil.CodeInputConfirmationRequired, ce.Code)
|
|
assert.Equal(t, 10, cmdutil.ExitCode(err))
|
|
assert.Contains(t, ce.RetryArgv, "-y")
|
|
assert.Contains(t, ce.RetryArgv, "model_emb")
|
|
}
|