entireio / entireio/cli

Document or support fallback when semantic search is unavailable in a repository region

Open
#1,923 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
Go
Stars
5.1k
Forks
475
Avg merge
1d 11h
Merged PRs (30d)
178

Description

Summary

entire checkpoint search cannot search a repository whose data is hosted in an unsupported region. Entire CLI 0.9.0 now returns a clear region-availability error, but the documented search workflow does not describe regional availability or a supported local fallback.

Environment

  • Entire CLI: 0.9.0
  • OS: Windows amd64
  • Authentication: active GitHub device-flow login
  • Repository: Entire-enabled Git repository with local and remote entire/checkpoints/v1 refs

Reproduction

Run an exact search for a known session that exists in local checkpoint history:

entire checkpoint search "<known-session-id>" --json

Actual result:

search failed: semantic search: semantic search is not yet available in the region(s) hosting this search

The same session is available locally:

entire checkpoint explain --session "<known-session-id>" --search-all --json --limit 1000 --no-pager

This returns multiple checkpoints. The default branch-limited local lookup can return zero for the same older session.

Expected Behavior

One of the following should be supported and documented:

  1. Hosted semantic search is available for every region where Entire can host/index repository checkpoint data; or
  2. The CLI provides a supported local-history fallback when hosted search is unavailable; or
  3. The search documentation clearly lists regional availability and the exact local fallback command.

Machine-readable --json calls should ideally return a structured error that distinguishes regional unavailability from an empty search result.

Additional Context

On Entire CLI 0.8.42, the same exact query returned an empty result set, which could be misinterpreted as absent history. Version 0.9.0 improves the error message, but agents still need a documented way to avoid a false no-history conclusion.

Acceptance Criteria

  • Regional search availability is documented or made universal.
  • Automation can distinguish regional unavailability from zero matches.
  • A supported fallback is documented when hosted search cannot serve the repository.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with the entire checkpoint search and entire checkpoint explain --session ... --search-all --json entry points, reproducing the regional error and local-history result described here. Read the search documentation and the JSON error handling around these commands. Done means regional availability and a supported fallback are documented or implemented, with machine-readable output distinguishing unavailability from zero matches.

Written by the indexing model from the issue text.

Assessment

Tech stack
go
Domain
cli, documentation, search
Issue type
Feature
Difficulty
4/5
Estimated time
3-5 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.