Dashboard/Algolia-Central (Second-Brain)/v2/wiki/decisions/2026-06-18-flagship-app-and-four-indices.md
Algolia-Central (Second-Brain)

v2/wiki/decisions/2026-06-18-flagship-app-and-four-indices.md

ADR: Move to FLAGSHIP app with four indices

Date: 2026-06-18 Status: Accepted

Context

The 2×2 needs four retrieval/architecture cells on identical data. Our current work lives on VVKSSPDMJX (ARIJIT-TEST). The demo home should be the accelerator demo app, which has NeuralSearch enabled.

Decision

Move everything to FLAGSHIP_Accelerator_Program_APP (abandon VVKSSPDMJX). Create four indices, all seeded from one fresh, English-only copy of the live Visibility ALGOLIA_WWW_PROD_V2 (1QDAWL72TQ, read-only):

  • ALGOLIA_WWW_PROD_V2_SINGLE_KEYWORD
  • ALGOLIA_WWW_PROD_V2_SINGLE_NEURAL
  • ALGOLIA_WWW_PROD_V2_MULTI_KEYWORD
  • ALGOLIA_WWW_PROD_V2_MULTI_NEURAL

Keyword vs neural = retrieval config (mode) on identical records. Per-index settings are NOT pre-decided; common baseline first, then proven per setup.

Rationale

  • Identical seed across all four keeps the experiment honest (only the intended variable changes).
  • NeuralSearch is already provisioned on FLAGSHIP.
  • Four physical indices give clean per-panel isolation for a demo and let each cell tune independently later.

Case-3 config port (sub-decision)

The Case-3 tuned config (on visibility_www_tuned, app VVKSSPDMJX) was: removeStopWords:['en'], ignorePlurals:['en'], queryLanguages:['en'], removeWordsIfNoResults:'allOptional', + 7 domain synonym groups. (Agent-instruction fixes are tracked separately.) - Apply it as the starting config for SINGLE_KEYWORD only (that cell is Case 3). allOptional kept for faithful reproduction despite the known over-broadening caveat; the autocorrect loop revisits it. - Keyword-only levers (removeStopWords, removeWordsIfNoResults, ignorePlurals, queryLanguages) do not go onto the neural indices (NeuralSearch reinterprets/ignores them). - Synonyms (vocabulary) may carry across all indices.

Alternatives Considered

Option Why rejected
Stay on VVKSSPDMJX Not the demo home; lacks the flagship framing
Two indices, toggle mode per query User wants per-panel isolation; cleaner for demo + independent tuning
Blind-copy all Case-3 settings to all 4 Cargo-cults keyword levers onto neural; violates "prove per setup"

Consequences

  • New app credentials/env; agents recreated on FLAGSHIP (namespace visibility-agent-*).
  • A seed/copy step (English-only, dedup by url) plus the daily delta-sync (see 2026-06-18-daily-delta-sync).
  • Live Visibility index remains strictly read-only.