From a4f35c6a16651e7480281f5ad9d9f27ae9434c0d Mon Sep 17 00:00:00 2001 From: ALeks ishmanov Date: Sat, 16 May 2026 23:04:59 +0300 Subject: [PATCH 1/2] docs(readme): add resume flag documentation Add subsection explaining --resume flag usage for interrupted init operations. Includes technical note on LanceDB/SQL drift behavior. Co-Authored-By: Claude Sonnet 4.6 --- README.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/README.md b/README.md index 3bce29a9..3605534b 100644 --- a/README.md +++ b/README.md @@ -114,6 +114,18 @@ repowise init . # scans for git repos, indexes each, runs cross-repo analys repowise serve # workspace dashboard + per-repo pages ``` +### Resuming an interrupted index + +If `repowise init` is interrupted (timeout, crash, Ctrl+C), you can resume from where it stopped: + +```bash +repowise init . --resume +``` + +The `--resume` flag checks the vector store for already-generated pages and continues generation for only the missing pages. Pro tip: Always use `--resume` when re-running init on a large repo — it's a safe no-op if the repo is fully indexed. + +**How it works:** Pages are written to LanceDB incrementally during generation, but the SQL `generation_jobs` row only finalizes at the end. A hard interrupt can leave LanceDB ahead of SQL — `--resume` is the supported recovery path, and `repowise doctor` will flag any drift. + That's it. `repowise init` automatically registers the MCP server, installs PreToolUse/PostToolUse hooks in `~/.claude/settings.json`, generates `.mcp.json` at the project root, and offers to install a post-commit git hook that keeps everything in sync after every commit. See [Auto-Sync](docs/AUTO_SYNC.md) for all sync methods (hooks, file watcher, GitHub/GitLab webhooks, polling). To manually add the MCP server to another editor: From fff14d27b48421948b696ea73696510438d35614 Mon Sep 17 00:00:00 2001 From: ALeks ishmanov Date: Sat, 16 May 2026 23:13:39 +0300 Subject: [PATCH 2/2] docs(cli): improve --resume flag help text Replace terse 'Resume from last checkpoint.' with descriptive explanation of skip behavior and safety on fully indexed repos. Co-Authored-By: Claude Sonnet 4.6 --- packages/cli/src/repowise/cli/commands/init_cmd.py | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/packages/cli/src/repowise/cli/commands/init_cmd.py b/packages/cli/src/repowise/cli/commands/init_cmd.py index 66e662c9..a0abf6c5 100644 --- a/packages/cli/src/repowise/cli/commands/init_cmd.py +++ b/packages/cli/src/repowise/cli/commands/init_cmd.py @@ -854,7 +854,12 @@ def _workspace_init( "--dry-run", is_flag=True, default=False, help="Show generation plan without running." ) @click.option("--yes", "-y", is_flag=True, default=False, help="Skip cost confirmation prompt.") -@click.option("--resume", is_flag=True, default=False, help="Resume from last checkpoint.") +@click.option( + "--resume", + is_flag=True, + default=False, + help="Skip pages already generated in the vector store and continue from where a previous run stopped. Safe no-op on a fully indexed repo." +) @click.option( "--force", is_flag=True, default=False, help="Regenerate all pages, ignoring existing." )