Skip to content

Self-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.

document reindex modes (#2845)

Zayn Jarvisfb39c574423a
diff --git a/README.md b/README.md
index 85ce7873f..6040ca184 100644
--- a/README.md
+++ b/README.md
@@ -574,6 +574,8 @@ ov find "what is openviking"
ov grep "openviking" --uri viking://resources/volcengine/OpenViking/docs/zh
```
+To rebuild existing indexes, `ov reindex <uri> --mode vectors_only` refreshes vectors only. Use `--mode semantic_and_vectors` when semantic artifacts (`.abstract.md` and `.overview.md`) must be regenerated before vectors; there is no `semantic` or `full` mode alias.
+
Congratulations! You have successfully run OpenViking 🎉
### Commercial Access
diff --git a/crates/ov_cli/src/help_ui.rs b/crates/ov_cli/src/help_ui.rs
index 48eb8666d..73c8363d0 100644
--- a/crates/ov_cli/src/help_ui.rs
+++ b/crates/ov_cli/src/help_ui.rs
@@ -1210,10 +1210,16 @@ const COMMAND_HELP_SPECS: &[CommandHelpSpec] = &[
CommandHelpSpec {
path: &["reindex"],
purpose: "Reindex semantic/vector artifacts for a URI.",
- examples: &[HelpItem {
- label: "ov reindex viking://projects/acme --mode vectors_only --wait true",
- description: "Rebuild vector artifacts and wait.",
- }],
+ examples: &[
+ HelpItem {
+ label: "ov reindex viking://projects/acme --mode vectors_only --wait true",
+ description: "Rebuild vector artifacts and wait.",
+ },
+ HelpItem {
+ label: "ov reindex viking://projects/acme --mode semantic_and_vectors --wait true",
+ description: "Regenerate semantic artifacts, then vectors.",
+ },
+ ],
next_steps: &[
HelpItem {
label: "ov task list",
@@ -2756,6 +2762,17 @@ mod tests {
assert!(search_help.contains("Search may merge multiple passes"));
}
+ #[test]
+ fn reindex_help_lists_supported_modes() {
+ let rendered = strip_ansi(
+ &render_command_help_request(&os_args(&["ov", "reindex", "--help"]))
+ .expect("reindex help should render"),
+ );
+
+ assert!(rendered.contains("--mode <vectors_only|semantic_and_vectors>"));
+ assert!(rendered.contains("Regenerate semantic artifacts, then vectors."));
+ }
+
#[test]
fn renders_curated_command_help_for_single_dash_help_alias() {
let rendered = strip_ansi(
diff --git a/crates/ov_cli/src/main.rs b/crates/ov_cli/src/main.rs
index 1258c8505..0d88793df 100644
--- a/crates/ov_cli/src/main.rs
+++ b/crates/ov_cli/src/main.rs
@@ -950,10 +950,11 @@ enum Commands {
/// Viking URI
#[arg(value_name = "uri")]
uri: String,
- /// Reindex mode
+ /// Reindex mode: vectors_only rebuilds vectors; semantic_and_vectors regenerates semantic artifacts, then vectors
#[arg(
long,
default_value = "vectors_only",
+ value_parser = ["vectors_only", "semantic_and_vectors"],
value_name = "mode",
help_heading = "Common options"
)]
@@ -3666,7 +3667,7 @@ mod tests {
.expect("skills list should parse");
match list.command {
Commands::Skills {
- action: SkillCommands::List { node_limit },
+ action: SkillCommands::List { node_limit, .. },
} => assert_eq!(node_limit, 25),
_ => panic!("expected skills list"),
}
@@ -3788,7 +3789,9 @@ mod tests {
.expect("skills remove --yes should parse");
match remove.command {
Commands::Skills {
- action: SkillCommands::Remove { skills, yes, all },
+ action: SkillCommands::Remove {
+ skills, yes, all, ..
+ },
} => {
assert_eq!(skills, vec!["foo", "bar"]);
assert!(yes);
@@ -4374,6 +4377,19 @@ mod tests {
assert!(result.is_ok(), "reindex command should parse");
}
+ #[test]
+ fn cli_rejects_unknown_reindex_mode() {
+ let result = Cli::try_parse_from([
+ "ov",
+ "reindex",
+ "viking://resources/demo",
+ "--mode",
+ "semantic",
+ ]);
+
+ assert!(result.is_err(), "unknown reindex mode should not parse");
+ }
+
#[test]
fn append_time_filter_params_only_emits_after_and_before() {
let mut params = Vec::new();