feat(cli): agent-first WeKnora CLI

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.
This commit is contained in:
nullkey
2026-06-26 20:40:59 +08:00
committed by lyingbug
parent 445a4330fa
commit 6f8b825f5f
151 changed files with 7305 additions and 733 deletions
+1 -1
View File
@@ -158,7 +158,7 @@ func runChunks(ctx context.Context, opts *ChunksOptions, fopts *cmdutil.FormatOp
if results == nil {
results = []*sdk.SearchResult{}
}
meta := &output.Meta{Count: len(results), HasMore: truncated}
meta := &output.Meta{Count: output.IntPtr(len(results)), HasMore: truncated}
return fopts.Emit(iostreams.IO.Out, results, meta)
}
return renderChunkResults(results, opts.KBID)
+1 -1
View File
@@ -172,7 +172,7 @@ done:
if matches == nil {
matches = []sdk.Knowledge{}
}
meta := &output.Meta{Count: len(matches), HasMore: truncated}
meta := &output.Meta{Count: output.IntPtr(len(matches)), HasMore: truncated}
return fopts.Emit(iostreams.IO.Out, matches, meta)
}
if len(matches) == 0 {
+4 -3
View File
@@ -80,8 +80,9 @@ content, use ` + "`weknora search chunks`" + `.`,
cmd.Flags().IntVarP(&opts.Limit, "limit", "L", 30, "Maximum results to return")
cmdutil.AddFormatFlag(cmd, kbSearchFields...)
cmdutil.SetAgentHelp(cmd, cmdutil.AgentHelp{
UsedFor: "Find knowledge bases by name or description (client-side case-insensitive substring match). Results come with meta.count; use --limit to cap. For searching content inside a KB, use 'search chunks' instead.",
Examples: []string{`weknora search kb "engineering" --format json`},
UsedFor: "Find knowledge bases by name or description (client-side case-insensitive substring match). Results come with meta.count; use --limit to cap. For searching content inside a KB, use 'search chunks' instead.",
RequiredFlags: []string{"<query> (positional)"},
Examples: []string{`weknora search kb "engineering" --format json`},
Output: "envelope.data is an array of KnowledgeBase objects with id, name, knowledge_count; meta.count is the returned count; meta.has_more=true if more matched than --limit",
})
return cmd
@@ -102,7 +103,7 @@ func runKBSearch(ctx context.Context, opts *KBSearchOptions, fopts *cmdutil.Form
if matches == nil {
matches = []sdk.KnowledgeBase{}
}
meta := &output.Meta{Count: len(matches), HasMore: truncated}
meta := &output.Meta{Count: output.IntPtr(len(matches)), HasMore: truncated}
return fopts.Emit(iostreams.IO.Out, matches, meta)
}
if len(matches) == 0 {
+4 -3
View File
@@ -93,8 +93,9 @@ to stop after one page.`,
cmd.Flags().BoolVar(&opts.AllPages, "all-pages", true, "Walk every server page until exhausted or --limit hit")
cmdutil.AddFormatFlag(cmd, sessionsSearchFields...)
cmdutil.SetAgentHelp(cmd, cmdutil.AgentHelp{
UsedFor: "Find chat sessions by title or description (client-side case-insensitive substring match). Results come with meta.count; use --limit to cap and --all-pages=false to stop after one page.",
Examples: []string{`weknora search sessions "onboarding" --format json`},
UsedFor: "Find chat sessions by title or description (client-side case-insensitive substring match). Results come with meta.count; use --limit to cap and --all-pages=false to stop after one page.",
RequiredFlags: []string{"<query> (positional)"},
Examples: []string{`weknora search sessions "onboarding" --format json`},
Output: "envelope.data is an array of Session objects with id, title, updated_at; meta.count is the returned count; meta.has_more=true if more matched than --limit",
})
return cmd
@@ -146,7 +147,7 @@ done:
if matches == nil {
matches = []sdk.Session{}
}
meta := &output.Meta{Count: len(matches), HasMore: truncated}
meta := &output.Meta{Count: output.IntPtr(len(matches)), HasMore: truncated}
return fopts.Emit(iostreams.IO.Out, matches, meta)
}
if len(matches) == 0 {