nullkey
5b07c9ab87
New subtree (chunk list / view / delete) exposes RAG retrieval debugging primitives with SDK-grounded field set (23 Chunk fields). Pagination follows v0.4 canon: --limit / --page-size (1..1000) / --all-pages. - chunk list --doc <id>: enumerate by ChunkIndex (separate from search chunks which is hybrid retrieval; Long help documents the distinction) - chunk view <id>: scope-less render via /chunks/by-id route; full content verbatim - chunk delete <id> --doc <id>: scope-flag + scope-id; L-13 destructive; 404 NOT idempotent; resource.not_found / auth.forbidden / input.confirmation_required typed exit codes documented in Long help MCP server gains chunk_list as 10th curated tool. Schema deliberately exposes only doc_id + limit (no pagination workflow on MCP); response includes truncated_at_limit flag when total > limit. cli/AGENTS.md MCP curation rationale rewritten: curated read-only is a deliberate product call because the server side does not yet enforce per-token scope. When server scope ships, mutation tools can land in the MCP surface. Shared helper cli/internal/text/timeago_string.go (FuzzyAgoStr) extracted from session list during the C2 quality-review pass.
38 lines
1.4 KiB
Go
38 lines
1.4 KiB
Go
// Package chunkcmd implements the `chunk` verb subtree for managing
|
|
// document chunks in a knowledge base. The directory is named `chunk/`
|
|
// (cobra noun-verb convention) but the Go package is `chunkcmd` to
|
|
// avoid colliding with cobra's *cobra.Command identifier.
|
|
//
|
|
// "chunk" in this subtree refers to indexed pieces of a knowledge
|
|
// document (server resource: GET/DELETE /chunks/...). Each document
|
|
// has many chunks; the chunking pipeline produces them at ingest time.
|
|
package chunkcmd
|
|
|
|
import (
|
|
"github.com/spf13/cobra"
|
|
|
|
"github.com/Tencent/WeKnora/cli/internal/cmdutil"
|
|
)
|
|
|
|
const chunkLong = `Manage and inspect document chunks.
|
|
|
|
Chunks are the indexed pieces of a knowledge document (1 doc → many chunks).
|
|
Use 'chunk list' to enumerate chunks in stored order (RAG admin / debug).
|
|
For relevance-ranked retrieval, use 'search chunks "<query>" --kb <id>'
|
|
instead — that runs hybrid vector + keyword scoring across all chunks.`
|
|
|
|
// NewCmdChunk builds the parent `chunk` command. Called from cli/cmd/root.go.
|
|
func NewCmdChunk(f *cmdutil.Factory) *cobra.Command {
|
|
cmd := &cobra.Command{
|
|
Use: "chunk <subcommand>",
|
|
Short: "Manage document chunks (RAG retrieval debug)",
|
|
Long: chunkLong,
|
|
Args: cobra.NoArgs,
|
|
Run: func(c *cobra.Command, _ []string) { _ = c.Help() },
|
|
}
|
|
cmd.AddCommand(NewCmdList(f))
|
|
cmd.AddCommand(NewCmdView(f))
|
|
cmd.AddCommand(NewCmdDelete(f))
|
|
return cmd
|
|
}
|