ltcai 6.5.0 → 6.7.0

package/frontend/src/features/brain/BrainHome.tsx

@@ -5,7 +5,7 @@ import { type BrainState, LivingBrain, triggerBrainRecall } from "@/components/L
 import { useAppStore } from "@/store/appStore";
 import { t } from "@/i18n";
 import { BrainConversation } from "./BrainConversation";
-import { buildBrainReadiness, buildMemoryFragments, currentModelName, parseKnowledgeGraph } from "./brainData";
+import { buildBrainProof, buildBrainReadiness, buildMemoryFragments, currentModelName, parseKnowledgeGraph } from "./brainData";
 import { DepthEmergence } from "./DepthEmergence";
 import { DEPTHS, type BrainDepth, type MemoryFragment, type Message } from "./types";
 
@@ -29,6 +29,8 @@ export function BrainHome({
   const [graphSearch, setGraphSearch] = React.useState("");
   const [selectedGraphId, setSelectedGraphId] = React.useState<string | null>(null);
   const [memoryFeedback, setMemoryFeedback] = React.useState<string | null>(null);
+  const [uploadingDocument, setUploadingDocument] = React.useState(false);
+  const [lastRecallQuery, setLastRecallQuery] = React.useState("");
   const streamRef = React.useRef<HTMLDivElement>(null);
   const recallTimerRef = React.useRef<number | null>(null);
 
@@ -36,6 +38,10 @@ export function BrainHome({
   const historyQ = useQuery({ queryKey: ["chatHistory"], queryFn: latticeApi.chatHistory });
   const graphQ = useQuery({ queryKey: ["graph"], queryFn: latticeApi.graph });
   const modelsQ = useQuery({ queryKey: ["models"], queryFn: latticeApi.models });
+  const brainProofQ = useQuery({
+    queryKey: ["memoryBrainProof", lastRecallQuery],
+    queryFn: () => latticeApi.memoryBrainProof(lastRecallQuery, 3),
+  });
 
   const memoryFragments = React.useMemo(
     () => buildMemoryFragments(memoriesQ.data?.data, historyQ.data?.data),
@@ -55,6 +61,10 @@ export function BrainHome({
     [graphModel.edges],
   );
   const modelName = React.useMemo(() => currentModelName(modelsQ.data?.data), [modelsQ.data]);
+  const brainProof = React.useMemo(
+    () => buildBrainProof(brainProofQ.data?.data, modelName),
+    [brainProofQ.data, modelName],
+  );
   const currentDepth = DEPTHS[explorationDepth - 1];
   const starterPrompts = React.useMemo(
     () => [
@@ -123,12 +133,39 @@ export function BrainHome({
         });
       } else {
         setMemoryFeedback(t(language, "brain.saved", { topics: knowledgeConcepts.length, memories: memoryFragments.length }));
+        setLastRecallQuery(text);
       }
     } finally {
       setStreaming(false);
       void qc.invalidateQueries({ queryKey: ["chatHistory"] });
       void qc.invalidateQueries({ queryKey: ["memoryManager"] });
       void qc.invalidateQueries({ queryKey: ["graph"] });
+      void qc.invalidateQueries({ queryKey: ["memoryBrainProof"] });
+    }
+  }
+
+  async function uploadDocument(file: File) {
+    if (uploadingDocument) return;
+
+    setUploadingDocument(true);
+    setMemoryFeedback(t(language, "brain.upload.pending", { name: file.name }));
+    onBrainChange("recalling", 0.86);
+
+    try {
+      const result = await latticeApi.uploadDocument(file);
+      if (result.error) {
+        setMemoryFeedback(t(language, "brain.upload.failed", { reason: result.error }));
+        return;
+      }
+
+      setMemoryFeedback(t(language, "brain.upload.saved", { name: file.name }));
+      setLastRecallQuery(file.name);
+      triggerBrainRecall();
+      void qc.invalidateQueries({ queryKey: ["memoryManager"] });
+      void qc.invalidateQueries({ queryKey: ["graph"] });
+      void qc.invalidateQueries({ queryKey: ["memoryBrainProof"] });
+    } finally {
+      setUploadingDocument(false);
     }
   }
 
@@ -242,9 +279,12 @@ export function BrainHome({
         memories={memoryFragments}
         concepts={knowledgeConcepts}
         readiness={brainReadiness}
+        proof={brainProof}
+        uploadingDocument={uploadingDocument}
         onOpenDepth={jumpToDepth}
         onDraftChange={setDraft}
         onImageDataChange={setImageData}
+        onUploadDocument={(file) => void uploadDocument(file)}
         onSend={() => void send()}
       />
     </main>

package/frontend/src/features/brain/BrainOverviewPanel.tsx

@@ -1,23 +1,31 @@
 import * as React from "react";
+import { BrainCircuit, DatabaseZap, Repeat2 } from "lucide-react";
 import { t } from "@/i18n";
 import { useAppStore } from "@/store/appStore";
-import type { BrainDepth, BrainReadiness, KnowledgeConcept, MemoryFragment } from "./types";
+import type { BrainDepth, BrainProof, BrainReadiness, KnowledgeConcept, MemoryFragment } from "./types";
 
 export function BrainOverviewPanel({
   memories,
   concepts,
   readiness,
+  proof,
   onOpenDepth,
 }: {
   memories: MemoryFragment[];
   concepts: KnowledgeConcept[];
   readiness: BrainReadiness;
+  proof: BrainProof;
   onOpenDepth: (depth: BrainDepth) => void;
 }) {
   const language = useAppStore((state) => state.language);
   const recent = memories.slice(0, 3);
   const older = memories.slice(3, 6);
   const topics = concepts.slice(0, 4);
+  const hasDurableProof = proof.proofs.hasDurableEvidence || proof.modelContinuity.proven;
+  const hasRecallProof = proof.recall.items.length > 0;
+  const modelProofValue = proof.modelContinuity.proven && proof.claims.keepsContextAcrossModels
+    ? proof.modelContinuity.activeModel || t(language, "brain.proof.noModel")
+    : t(language, "brain.proof.modelPending");
 
   return (
     <section className="brain-overview-panel" aria-label={t(language, "brain.aria.overview")}>
@@ -60,10 +68,63 @@ export function BrainOverviewPanel({
           {t(language, readiness.actionKey)}
         </button>
       </div>
+      <div className="brain-proof-strip" aria-label={t(language, "brain.proof.aria")}>
+        <BrainProofPoint
+          icon={<DatabaseZap className="h-4 w-4" />}
+          label={t(language, "brain.proof.context")}
+          value={hasDurableProof
+            ? t(language, "brain.proof.contextValue", { count: proof.proofs.durableItems })
+            : t(language, "brain.proof.contextEmpty")}
+        />
+        <BrainProofPoint
+          icon={<Repeat2 className="h-4 w-4" />}
+          label={t(language, "brain.proof.model")}
+          value={modelProofValue}
+        />
+        <BrainProofPoint
+          icon={<BrainCircuit className="h-4 w-4" />}
+          label={t(language, "brain.proof.store")}
+          value={t(language, "brain.proof.storeValue", {
+            topics: proof.proofs.graphConcepts,
+            vectors: proof.proofs.vectorItems,
+          })}
+        />
+      </div>
+      {hasRecallProof ? (
+        <button type="button" className="brain-recall-proof" onClick={() => onOpenDepth(2)}>
+          <span>{t(language, "brain.proof.recall")}</span>
+          <strong>{proof.recall.items[0].title}</strong>
+          <small>{proof.recall.items[0].snippet || proof.recall.query}</small>
+        </button>
+      ) : (
+        <div className="brain-recall-proof is-empty" role="status">
+          <span>{t(language, "brain.proof.recallEmpty.kicker")}</span>
+          <strong>{t(language, hasDurableProof ? "brain.proof.recallPending" : "brain.proof.recallEmpty.title")}</strong>
+          <small>{t(language, hasDurableProof ? "brain.proof.recallPending.detail" : "brain.proof.recallEmpty.detail")}</small>
+        </div>
+      )}
     </section>
   );
 }
 
+function BrainProofPoint({
+  icon,
+  label,
+  value,
+}: {
+  icon: React.ReactNode;
+  label: string;
+  value: string;
+}) {
+  return (
+    <div className="brain-proof-point">
+      {icon}
+      <span>{label}</span>
+      <strong>{value}</strong>
+    </div>
+  );
+}
+
 function BrainOverviewColumn({
   title,
   empty,

package/frontend/src/features/brain/brainData.ts

@@ -1,5 +1,5 @@
 import { asArray } from "@/lib/utils";
-import type { ApiRecord, BrainDepth, BrainReadiness, KnowledgeConcept, KnowledgeGraphModel, MemoryFragment, RelationshipThread } from "./types";
+import type { ApiRecord, BrainDepth, BrainProof, BrainReadiness, KnowledgeConcept, KnowledgeGraphModel, MemoryFragment, RelationshipThread } from "./types";
 import { clamp } from "./graphLayout";
 
 export function buildMemoryFragments(memoryData: unknown, historyData: unknown): MemoryFragment[] {
@@ -86,6 +86,51 @@ export function buildBrainReadiness(memoryData: unknown, fallbackMemoryCount: nu
   return fallbackBrainReadiness(fallbackMemoryCount, fallbackConceptCount);
 }
 
+export function buildBrainProof(data: unknown, fallbackModelName = ""): BrainProof {
+  const proof = isRecord(data) ? data : {};
+  const modelContinuity = isRecord(proof.model_continuity) ? proof.model_continuity : {};
+  const proofs = isRecord(proof.proofs) ? proof.proofs : {};
+  const recall = isRecord(proof.recall) ? proof.recall : {};
+  const claims = isRecord(proof.claims) ? proof.claims : {};
+  const durableItems = numberValue(proofs, ["durable_items", "durableItems"]);
+  return {
+    status: textValue(proof, ["status"], "quiet"),
+    modelContinuity: {
+      activeModel: textValue(modelContinuity, ["active_model", "activeModel"], fallbackModelName),
+      brainOwner: textValue(modelContinuity, ["brain_owner", "brainOwner"], "lattice_brain"),
+      capability: booleanValue(modelContinuity, ["capability"], true),
+      survivesModelSwitch: booleanValue(modelContinuity, ["survives_model_switch", "survivesModelSwitch"], false),
+      proven: booleanValue(modelContinuity, ["proven"], false),
+      contextStore: textValue(modelContinuity, ["context_store", "contextStore"], "workspace + conversation + graph + vector"),
+    },
+    proofs: {
+      durableItems,
+      hasDurableEvidence: booleanValue(proofs, ["has_durable_evidence", "hasDurableEvidence"], durableItems > 0),
+      workspaceMemories: numberValue(proofs, ["workspace_memories", "workspaceMemories"]),
+      conversations: numberValue(proofs, ["conversations"]),
+      graphConcepts: numberValue(proofs, ["graph_concepts", "graphConcepts"]),
+      vectorItems: numberValue(proofs, ["vector_items", "vectorItems"]),
+      healthySources: numberValue(proofs, ["healthy_sources", "healthySources"]),
+    },
+    recall: {
+      query: textValue(recall, ["query"]),
+      count: numberValue(recall, ["count"]),
+      items: asArray<ApiRecord>(recall.items).map((item, index) => ({
+        id: textValue(item, ["id"], `recall-${index}`),
+        source: titleValue(item, ["source"], "Memory"),
+        title: textValue(item, ["title"], "Memory"),
+        snippet: textValue(item, ["snippet"]),
+        score: numberValue(item, ["score"]),
+      })),
+    },
+    claims: {
+      canRecallUserContext: booleanValue(claims, ["can_recall_user_context", "canRecallUserContext"], false),
+      keepsContextAcrossModels: booleanValue(claims, ["keeps_context_across_models", "keepsContextAcrossModels"], false),
+      isKnowledgeStore: booleanValue(claims, ["is_knowledge_store", "isKnowledgeStore"], false),
+    },
+  };
+}
+
 function uniqueById<T extends { id: string }>(items: T[]) {
   const seen = new Set<string>();
   return items.filter((item) => {
@@ -167,3 +212,11 @@ function numberValue(record: ApiRecord, keys: string[]) {
   }
   return 0;
 }
+
+function booleanValue(record: ApiRecord, keys: string[], fallback: boolean) {
+  for (const key of keys) {
+    const value = record[key];
+    if (typeof value === "boolean") return value;
+  }
+  return fallback;
+}

package/frontend/src/features/brain/types.ts

@@ -50,6 +50,43 @@ export type BrainReadiness = {
   };
 };
 
+export type BrainProof = {
+  status: "quiet" | "forming" | "alive" | string;
+  modelContinuity: {
+    activeModel: string;
+    brainOwner: string;
+    capability: boolean;
+    survivesModelSwitch: boolean;
+    proven: boolean;
+    contextStore: string;
+  };
+  proofs: {
+    durableItems: number;
+    hasDurableEvidence: boolean;
+    workspaceMemories: number;
+    conversations: number;
+    graphConcepts: number;
+    vectorItems: number;
+    healthySources: number;
+  };
+  recall: {
+    query: string;
+    count: number;
+    items: Array<{
+      id: string;
+      source: string;
+      title: string;
+      snippet: string;
+      score: number;
+    }>;
+  };
+  claims: {
+    canRecallUserContext: boolean;
+    keepsContextAcrossModels: boolean;
+    isKnowledgeStore: boolean;
+  };
+};
+
 export const DEPTHS: Array<{ level: BrainDepth; labelKey: string; state: BrainState }> = [
   { level: 1, labelKey: "brain.depthLabel.1", state: "idle" },
   { level: 2, labelKey: "brain.depthLabel.2", state: "recalling" },

package/frontend/src/i18n.ts

@@ -34,6 +34,7 @@ export const COPY: Record<Language, TextMap> = {
     "brain.depthRail.aria": "Brain 깊이 진행 상태",
     "brain.aria.conversation": "대화",
     "brain.aria.ownership": "Brain 소유 보장",
+    "brain.aria.actions": "Brain 주요 작업",
     "brain.aria.starterPrompts": "시작 프롬프트",
     "brain.aria.overview": "Brain 한눈에 보기",
     "brain.aria.graph": "지식 그래프",
@@ -42,6 +43,10 @@ export const COPY: Record<Language, TextMap> = {
     "brain.portable": "이동 가능",
     "brain.private": "개인 소유",
     "brain.admin": "관리자 콘솔",
+    "brain.action.add": "넣기",
+    "brain.action.find": "찾기",
+    "brain.action.model": "모델",
+    "brain.action.settings": "설정",
     "brain.empty.kicker": "내 오래가는 기억",
     "brain.empty.title": "잊으면 안 되는 맥락부터 말해 주세요.",
     "brain.empty.body": "문서, 대화, 프로젝트, 결정이 이 컴퓨터의 Brain에 쌓이고 나중에 주제와 관계로 다시 보입니다.",
@@ -53,6 +58,13 @@ export const COPY: Record<Language, TextMap> = {
     "brain.prompt.know": "이 문서를 내 Brain에 넣고 요약해줘: ",
     "brain.prompt.plan": "지난 결정들을 나중에 찾을 수 있게 정리해줘: ",
     "brain.placeholder": "Brain에게 말하기...",
+    "brain.upload.cta": "파일/문서 넣기",
+    "brain.upload.ctaShort": "문서",
+    "brain.upload.uploading": "넣는 중",
+    "brain.upload.hint": "업로드하면 실제 기억과 그래프로 다시 보입니다.",
+    "brain.upload.pending": "{name}을 Brain에 넣는 중입니다.",
+    "brain.upload.saved": "{name}이 Brain에 저장됐습니다.",
+    "brain.upload.failed": "문서를 넣지 못했습니다: {reason}",
     "brain.image": "이미지",
     "brain.unavailable": "지금은 답할 수 없음",
     "brain.imageAttached": "이미지 첨부됨",
@@ -77,6 +89,21 @@ export const COPY: Record<Language, TextMap> = {
     "brain.readiness.start": "첫 기억 보기",
     "brain.readiness.grow": "주제 키우기",
     "brain.readiness.map": "지도 보기",
+    "brain.proof.aria": "Brain 증거",
+    "brain.proof.context": "다시 불러올 맥락",
+    "brain.proof.contextValue": "{count}개 저장됨",
+    "brain.proof.contextEmpty": "첫 기억 대기",
+    "brain.proof.model": "모델 교체 후에도 유지",
+    "brain.proof.noModel": "모델 미로드",
+    "brain.proof.modelPending": "저장 후 증명됨",
+    "brain.proof.store": "지식 저장소",
+    "brain.proof.storeValue": "주제 {topics}개 · 벡터 {vectors}개",
+    "brain.proof.recall": "방금 Brain이 다시 꺼낸 기억",
+    "brain.proof.recallEmpty.kicker": "Brain 증거 자리",
+    "brain.proof.recallEmpty.title": "첫 대화 후 여기에 다시 꺼낸 기억이 표시됩니다.",
+    "brain.proof.recallEmpty.detail": "아직 저장된 기억이 없어서 가짜 예시는 보여주지 않습니다.",
+    "brain.proof.recallPending": "기억은 저장됐고 recall 증거를 준비 중입니다.",
+    "brain.proof.recallPending.detail": "인덱싱이 끝나면 이 자리에서 실제 기억을 다시 보여줍니다.",
     "brain.memory.empty.kicker": "첫 기억",
     "brain.memory.empty": "기억이 조용합니다.",
     "brain.knowledge.empty": "지식이 형성되는 중입니다.",
@@ -366,6 +393,7 @@ export const COPY: Record<Language, TextMap> = {
     "brain.depthRail.aria": "Brain depth progress",
     "brain.aria.conversation": "Conversation",
     "brain.aria.ownership": "Brain ownership guarantees",
+    "brain.aria.actions": "Brain primary actions",
     "brain.aria.starterPrompts": "Starter prompts",
     "brain.aria.overview": "Brain overview",
     "brain.aria.graph": "Knowledge Graph",
@@ -374,6 +402,10 @@ export const COPY: Record<Language, TextMap> = {
     "brain.portable": "Portable",
     "brain.private": "Private",
     "brain.admin": "Admin Console",
+    "brain.action.add": "Add",
+    "brain.action.find": "Find",
+    "brain.action.model": "Model",
+    "brain.action.settings": "Settings",
     "brain.empty.kicker": "Durable memory",
     "brain.empty.title": "Start with context that should not be forgotten.",
     "brain.empty.body": "Documents, conversations, projects, and decisions accumulate in the Brain on this computer, then reappear as topics and relationships.",
@@ -385,6 +417,13 @@ export const COPY: Record<Language, TextMap> = {
     "brain.prompt.know": "Put this document into my Brain and summarize it: ",
     "brain.prompt.plan": "Organize past decisions so I can find them later: ",
     "brain.placeholder": "Talk to your Brain...",
+    "brain.upload.cta": "Add file or document",
+    "brain.upload.ctaShort": "Document",
+    "brain.upload.uploading": "Adding...",
+    "brain.upload.hint": "After upload, it reappears as real memory and graph context.",
+    "brain.upload.pending": "Adding {name} to Brain.",
+    "brain.upload.saved": "{name} was saved to Brain.",
+    "brain.upload.failed": "Could not add the document: {reason}",
     "brain.image": "Image",
     "brain.unavailable": "Unavailable",
     "brain.imageAttached": "Image attached",
@@ -409,6 +448,21 @@ export const COPY: Record<Language, TextMap> = {
     "brain.readiness.start": "View first memory",
     "brain.readiness.grow": "Grow topics",
     "brain.readiness.map": "Open map",
+    "brain.proof.aria": "Brain proof",
+    "brain.proof.context": "Recallable context",
+    "brain.proof.contextValue": "{count} saved",
+    "brain.proof.contextEmpty": "Waiting for first memory",
+    "brain.proof.model": "Survives model switches",
+    "brain.proof.noModel": "No model loaded",
+    "brain.proof.modelPending": "Proven after saving",
+    "brain.proof.store": "Knowledge store",
+    "brain.proof.storeValue": "{topics} topics · {vectors} vectors",
+    "brain.proof.recall": "Just recalled by Brain",
+    "brain.proof.recallEmpty.kicker": "Brain proof slot",
+    "brain.proof.recallEmpty.title": "After your first exchange, recalled memory appears here.",
+    "brain.proof.recallEmpty.detail": "No saved memory yet, so Lattice does not show a fake example.",
+    "brain.proof.recallPending": "Memory is saved; recall proof is preparing.",
+    "brain.proof.recallPending.detail": "When indexing finishes, this slot shows the actual memory Brain can bring back.",
     "brain.memory.empty.kicker": "First memory",
     "brain.memory.empty": "Memory is quiet",
     "brain.knowledge.empty": "Knowledge is forming",

package/frontend/src/routes.ts

@@ -9,19 +9,29 @@ import {
 
 export type PrimaryRoute = "brain" | "memory" | "capture" | "act" | "library" | "system";
 
-export const primaryRoutes = [
-  { id: "brain", label: "Brain", icon: Brain, description: "Talk with your living Brain" },
-  { id: "memory", label: "Memory", icon: Database, description: "Recall what your Brain remembers" },
-  { id: "capture", label: "Files", icon: FolderInput, description: "Bring in files, folders, and pages" },
-  { id: "act", label: "Automations", icon: Workflow, description: "Turn goals into supervised runs" },
-  { id: "library", label: "Models", icon: Library, description: "Choose the local model powering your Brain" },
-  { id: "system", label: "Settings", icon: Settings, description: "Keep your Brain safe and portable" },
+export type RouteTarget = { primary: PrimaryRoute; tab?: string };
+
+export const productShellRoutes = [
+  { id: "brain", path: "brain", label: "Lattice Brain", icon: Brain, description: "Talk with your living Brain" },
+  { id: "capture", path: "capture", label: "Files", icon: FolderInput, description: "Bring in files, folders, and pages" },
+  { id: "memory", path: "knowledge-graph", label: "Graph", icon: Database, description: "Search and inspect Brain knowledge" },
+  { id: "library", path: "models", label: "Models", icon: Library, description: "Choose the local model powering your Brain" },
+  { id: "system", path: "settings", label: "Settings", icon: Settings, description: "Keep your Brain safe and portable" },
+  { id: "act", path: "review", label: "Act", icon: Workflow, description: "Turn goals into supervised runs" },
 ] as const;
 
-export const routeAliases: Record<string, { primary: PrimaryRoute; tab?: string }> = {
+export const directProductRoutes: Record<string, RouteTarget> = {
+  brain: { primary: "brain", tab: "conversation" },
+  capture: { primary: "capture", tab: "files" },
+  "knowledge-graph": { primary: "brain", tab: "graph" },
+  models: { primary: "library", tab: "models" },
+  settings: { primary: "system", tab: "settings" },
+  review: { primary: "act", tab: "review" },
+};
+
+export const compatibilityRouteAliases: Record<string, RouteTarget> = {
   home: { primary: "brain", tab: "conversation" },
   onboarding: { primary: "system", tab: "account" },
-  "knowledge-graph": { primary: "brain", tab: "graph" },
   "hybrid-search": { primary: "brain", tab: "knowledge" },
   memory: { primary: "memory", tab: "memory" },
   ask: { primary: "brain", tab: "conversation" },
@@ -31,13 +41,11 @@ export const routeAliases: Record<string, { primary: PrimaryRoute; tab?: string
   "my-computer": { primary: "capture", tab: "local" },
   agents: { primary: "act", tab: "agents" },
   runs: { primary: "act", tab: "runs" },
-  review: { primary: "act", tab: "review" },
   "review-center": { primary: "act", tab: "review" },
   workflows: { primary: "act", tab: "workflows" },
   planning: { primary: "act", tab: "agents" },
   hooks: { primary: "act", tab: "hooks" },
   tools: { primary: "act", tab: "tools" },
-  models: { primary: "library", tab: "models" },
   skills: { primary: "library", tab: "skills" },
   mcp: { primary: "library", tab: "mcp" },
   marketplace: { primary: "library", tab: "marketplace" },
@@ -55,21 +63,27 @@ export const routeAliases: Record<string, { primary: PrimaryRoute; tab?: string
   "admin/private-vpc": { primary: "system", tab: "admin" },
 };
 
+export const primaryRoutes = productShellRoutes;
+export const routeAliases = compatibilityRouteAliases;
+
 export const commandRoutes = [
-  { key: "brain", label: "Brain", icon: Brain },
-  { key: "memory", label: "Memory", icon: Database },
+  { key: "brain", label: "Lattice Brain", icon: Brain },
   { key: "files", label: "Files", icon: FolderInput },
-  { key: "workflows", label: "Automations", icon: Workflow },
+  { key: "knowledge-graph", label: "Graph", icon: Database },
   { key: "models", label: "Models", icon: Library },
   { key: "settings", label: "Settings", icon: Settings },
+  { key: "review", label: "Act", icon: Workflow },
 ];
 
 export function parseHash() {
   const raw = window.location.hash.replace(/^#\/?/, "").replace(/^\/+/, "");
   const path = raw || "brain";
-  const direct = primaryRoutes.find((route) => route.id === path);
-  if (direct) return { primary: direct.id as PrimaryRoute, tab: undefined, path };
-  const aliased = routeAliases[path] || routeAliases[path.split("?")[0]];
+  const normalized = path.split("?")[0];
+  const direct = directProductRoutes[normalized];
+  if (direct) return { ...direct, path };
+  const primary = productShellRoutes.find((route) => route.id === normalized);
+  if (primary) return { primary: primary.id as PrimaryRoute, tab: undefined, path };
+  const aliased = compatibilityRouteAliases[normalized];
   return { primary: aliased?.primary || "brain", tab: aliased?.tab, path };
 }