cc8254f862
Two intertwined mainstream-alignment moves bundled because they share
the migration target (every command's --json path):
1. Drop --dry-run entirely. Survey of comparable API-wrapper CLIs
(gh, aws, stripe, lark): none expose --dry-run. The mainstream that
does (kubectl/git/helm/ansible) operates on declarative manifests
or local state where the preview is materially different from the
executed action. WeKnora's CLI just echoed the same parameters
that would have gone on the wire — the preview added no real
signal over `--help` + reading the call site. Removes:
- root --dry-run persistent flag + cmdutil/dryrun.go
- DryRun fields + EmitDryRun calls in 12 write commands
- format.Envelope.DryRun field
- 8 corresponding *_test.go cases
- --dry-run mention from README.md and CHANGELOG.md
- "dry_run":false from 16 golden envelopes
2. Migrate every --json output to bare data:
- New format.WriteJSON / WriteJSONFiltered helpers
(cli/internal/format/bare.go) share filterArrayItems /
filterObjectKeys / writeJQ with the (still-live for now) envelope
filter helpers.
- Read commands (kb/doc/session list+view, search chunks/docs/
sessions/kb, auth list/status, agent list/view, context list,
doctor) emit bare arrays / objects on stdout.
- Write commands (kb create/edit/delete/pin/empty, doc upload/
upload_recursive/delete, session delete, auth login/logout/
refresh/token, link/unlink, context add/use/remove, agent
invoke, chat, api, version) emit bare result objects. Risk
classification dropped — the resource + exit code already
convey the action.
Per-command shape changes:
list / search → []T (was {ok, data:{items:[…]}})
view → T (was {ok, data:T, _meta:…})
create / edit → T
delete / pin / etc. → {id, …action result…}
doctor → {summary, checks}
api → {status, headers, body}
_meta dropped on the read path:
pagination (page/page_size/total/has_more) — agents iterate with
--all-pages or accept --limit (gh CLI parity);
kb_id / context echo — caller already knows what it asked for.
Acceptance contract goldens regenerated for the new bare shape.
Error envelope on stdout (PrintErrorEnvelope) stays live for now —
the envelope-infra deletion lands in the next commit.
83 lines
2.9 KiB
Go
83 lines
2.9 KiB
Go
package linkcmd
|
|
|
|
import (
|
|
"fmt"
|
|
"os"
|
|
|
|
"github.com/spf13/cobra"
|
|
|
|
"github.com/Tencent/WeKnora/cli/internal/aiclient"
|
|
"github.com/Tencent/WeKnora/cli/internal/cmdutil"
|
|
"github.com/Tencent/WeKnora/cli/internal/format"
|
|
"github.com/Tencent/WeKnora/cli/internal/iostreams"
|
|
"github.com/Tencent/WeKnora/cli/internal/projectlink"
|
|
)
|
|
|
|
// unlinkFields enumerates the fields surfaced for `--json` discovery on
|
|
// `unlink`. Tracks the small unlinkResult struct.
|
|
var unlinkFields = []string{"project_link_path"}
|
|
|
|
type UnlinkOptions struct{}
|
|
|
|
// unlinkResult is the typed payload emitted under data.
|
|
type unlinkResult struct {
|
|
ProjectLinkPath string `json:"project_link_path"`
|
|
}
|
|
|
|
// NewCmdUnlink builds `weknora unlink`. Walks up from cwd so a user in
|
|
// a subdirectory of a linked project can unlink without cd-ing up first.
|
|
func NewCmdUnlink() *cobra.Command {
|
|
opts := &UnlinkOptions{}
|
|
cmd := &cobra.Command{
|
|
Use: "unlink",
|
|
Short: "Remove the directory's knowledge-base binding",
|
|
Long: `Removes the .weknora/project.yaml that ` + "`weknora link`" + ` previously
|
|
wrote, so subsequent commands no longer auto-resolve --kb from the link.
|
|
|
|
Walks up from the current directory until a link is found, mirroring the
|
|
discovery that ` + "`--kb`" + ` resolution uses; you do not need to cd to the
|
|
project root to unlink. Errors with input.invalid_argument when no link
|
|
is present anywhere in the parent chain.`,
|
|
Example: ` weknora unlink # remove the binding for this project
|
|
weknora unlink --json # envelope output (CI / agents)`,
|
|
Args: cobra.NoArgs,
|
|
RunE: func(c *cobra.Command, _ []string) error {
|
|
jopts, err := cmdutil.CheckJSONFlags(c)
|
|
if err != nil {
|
|
return err
|
|
}
|
|
return runUnlink(opts, jopts)
|
|
},
|
|
}
|
|
cmdutil.AddJSONFlags(cmd, unlinkFields)
|
|
aiclient.SetAgentHelp(cmd, "Removes .weknora/project.yaml (the cwd → KB binding). Walks up from cwd. Errors with input.invalid_argument when no link is present in the parent chain.")
|
|
return cmd
|
|
}
|
|
|
|
func runUnlink(opts *UnlinkOptions, jopts *cmdutil.JSONOptions) error {
|
|
cwd, err := os.Getwd()
|
|
if err != nil {
|
|
return cmdutil.Wrapf(cmdutil.CodeLocalFileIO, err, "get cwd")
|
|
}
|
|
linkPath, found, err := projectlink.Discover(cwd)
|
|
if err != nil {
|
|
return cmdutil.Wrapf(cmdutil.CodeLocalFileIO, err, "discover project link")
|
|
}
|
|
if !found {
|
|
return &cmdutil.Error{
|
|
Code: cmdutil.CodeInputInvalidArgument,
|
|
Message: fmt.Sprintf("no %s/%s found at or above %s", projectlink.DirName, projectlink.FileName, cwd),
|
|
Hint: "run `weknora link --kb <id>` first, or check you're in the right directory",
|
|
}
|
|
}
|
|
if err := projectlink.Remove(linkPath); err != nil {
|
|
return cmdutil.Wrapf(cmdutil.CodeLocalFileIO, err, "remove %s", linkPath)
|
|
}
|
|
if jopts.Enabled() {
|
|
return format.WriteJSONFiltered(iostreams.IO.Out,
|
|
unlinkResult{ProjectLinkPath: linkPath}, jopts.Fields, jopts.JQ)
|
|
}
|
|
fmt.Fprintf(iostreams.IO.Out, "✓ Unlinked %s\n", linkPath)
|
|
return nil
|
|
}
|