ltcai 8.1.0 → 8.3.0

package/docs/V4_4_0_EXTRACTION_REPORT.md

@@ -1,239 +0,0 @@
-# v4.4.0 Physical Extraction Report — `lattice_brain` Brain Engine
-
-Date: 2026-06-13
-Scope: complete physical extraction of the Brain Core implementation into the
-standalone `lattice_brain` package. The release flow attaches only validated
-v4.4.0 artifacts to GitHub; no external package registry publishing is part of
-this release step.
-
-## 1. Problem Before v4.4.0
-
-`lattice_brain` provided an import-path contract only. The graph, memory,
-context, conversation, and ingestion implementations physically lived under
-`latticeai/brain/` (and `latticeai/core/`, `latticeai/services/`) and were
-re-exported through `lattice_brain.*`. Importing `lattice_brain.store`
-actually executed `latticeai.brain.store`, so the Brain Core could not be
-used, tested, or distributed independently of the FastAPI product package.
-
-## 2. Dependency Graph
-
-### Before (v4.3.3)
-
-```
-lattice_brain.store/schema/retrieval/... (1-line re-exports)
-        │  imports
-        ▼
-latticeai.brain.* (physical implementation)
-        │  imports
-        ├─ latticeai.services.ingestion  (memory → IngestionItem)
-        │        └─ latticeai.core.hooks (dispatch_tool)
-        ├─ latticeai.core.graph_curator  (projection, lazy)
-        └─ kg_schema (root shim → lattice_brain.schema → latticeai.brain.schema)
-latticeai.services.agent_runtime → latticeai.core.multi_agent
-latticeai.services.kg_portability → lattice_brain.archive/storage (already clean)
-latticeai.core.workflow_engine    (stdlib only, hosted in latticeai)
-```
-
-Net effect: `import lattice_brain.store` pulled in `latticeai`.
-
-### After (v4.4.0)
-
-```
-latticeai (FastAPI app, routers, services, product backend)
-        │  imports (one direction only)
-        ▼
-lattice_brain (physical Brain Engine)
-  ├─ core, archive, embeddings, storage/        (already physical in v4.2+)
-  ├─ graph/   _kg_common, schema, store, write_master, retrieval, discovery,
-  │           documents, ingest, projection, provenance, identity, network,
-  │           curator
-  ├─ memory, context, conversations
-  ├─ ingestion                                   (uses .runtime.hooks)
-  ├─ runtime/ hooks, multi_agent, agent_runtime
-  ├─ workflow
-  └─ portability                                 (uses .archive/.storage/.graph.identity)
-```
-
-`lattice_brain` has zero `latticeai` imports — enforced by an import-hook test.
-External (third-party/optional) deps of the package: `cryptography`, `keyring`,
-`httpx`, `psycopg` (opt-in), `sqlite-vec` (opt-in), document parsers
-(`pdfplumber`, `python-docx`, `openpyxl`, `python-pptx`, `PIL`) — all already
-declared in `pyproject.toml`.
-
-## 3. Files Moved (physical, via `git mv`, history preserved)
-
-Knowledge graph → `lattice_brain/graph/`:
-
-| From | To |
-| --- | --- |
-| `latticeai/brain/_kg_common.py` | `lattice_brain/graph/_kg_common.py` |
-| `latticeai/brain/schema.py` | `lattice_brain/graph/schema.py` |
-| `latticeai/brain/store.py` | `lattice_brain/graph/store.py` |
-| `latticeai/brain/write_master.py` | `lattice_brain/graph/write_master.py` |
-| `latticeai/brain/retrieval.py` | `lattice_brain/graph/retrieval.py` |
-| `latticeai/brain/discovery.py` | `lattice_brain/graph/discovery.py` |
-| `latticeai/brain/documents.py` | `lattice_brain/graph/documents.py` |
-| `latticeai/brain/ingest.py` | `lattice_brain/graph/ingest.py` |
-| `latticeai/brain/projection.py` | `lattice_brain/graph/projection.py` |
-| `latticeai/brain/provenance.py` | `lattice_brain/graph/provenance.py` |
-| `latticeai/brain/identity.py` | `lattice_brain/graph/identity.py` |
-| `latticeai/brain/network.py` | `lattice_brain/graph/network.py` |
-| `latticeai/core/graph_curator.py` | `lattice_brain/graph/curator.py` |
-
-Memory / context / conversation:
-
-| From | To |
-| --- | --- |
-| `latticeai/brain/memory.py` | `lattice_brain/memory.py` |
-| `latticeai/brain/context.py` | `lattice_brain/context.py` |
-| `latticeai/brain/conversations.py` | `lattice_brain/conversations.py` |
-
-Ingestion / runtime / workflow / portability:
-
-| From | To |
-| --- | --- |
-| `latticeai/services/ingestion.py` | `lattice_brain/ingestion.py` |
-| `latticeai/core/hooks.py` | `lattice_brain/runtime/hooks.py` |
-| `latticeai/core/multi_agent.py` | `lattice_brain/runtime/multi_agent.py` |
-| `latticeai/services/agent_runtime.py` | `lattice_brain/runtime/agent_runtime.py` |
-| `latticeai/core/workflow_engine.py` | `lattice_brain/workflow.py` |
-| `latticeai/services/kg_portability.py` | `lattice_brain/portability.py` |
-
-19 files moved with history; 2 new subpackage `__init__.py` files
-(`lattice_brain/graph/`, `lattice_brain/runtime/`).
-
-Import edges rewritten inside moved code (the only source changes to the
-implementations):
-
-- `graph/_kg_common.py`: `latticeai.brain.schema` → `.schema`;
-  `lattice_brain.embeddings` → `..embeddings`
-- `graph/projection.py`: lazy `latticeai.core.graph_curator` → `.curator`
-- `graph/provenance.py`: lazy `kg_schema` → `.schema`
-- `graph/network.py`: `lattice_brain.identity` → `.identity`
-- `graph/store.py`: lazy `lattice_brain.storage` → `..storage`
-- `memory.py`: `latticeai.services.ingestion` → `.ingestion`
-- `ingestion.py`: `latticeai.core.hooks` → `.runtime.hooks`
-- `runtime/agent_runtime.py`: `latticeai.core.multi_agent` → `.multi_agent`
-- `portability.py`: absolute `lattice_brain.*` → relative; lazy identity →
-  `.graph.identity`
-- `runtime/hooks.py`: three `binding` metadata strings updated to the new
-  physical paths
-
-## 4. Re-Export Modules Deleted / Replaced
-
-Deleted (the old `lattice_brain → latticeai.brain` re-exports — the "fake
-extraction" layer):
-`lattice_brain/{_kg_common,schema,store,write_master,retrieval,discovery,documents,ingest,projection,provenance,network,identity}.py`
-
-Each path was recreated as an **internal alias shim** (`sys.modules[__name__] =
-lattice_brain.graph.<name>`), so old flat imports keep working with module
-identity preserved (the shim and the physical module are the same object —
-singletons, `isinstance`, and monkeypatching are unaffected). These alias the
-package to itself; nothing re-exports `latticeai` anymore.
-
-## 5. Compatibility Shims Kept (latticeai side)
-
-Deprecation shims (emit `DeprecationWarning`, alias the physical module):
-
-- `latticeai/brain/__init__.py` (re-exports the public surface from
-  `lattice_brain`)
-- `latticeai/brain/{store,schema,retrieval,discovery,documents,ingest,projection,provenance,write_master,network,identity,_kg_common,memory,context,conversations}.py`
-
-Silent alias shims (still-supported old paths):
-
-- `latticeai/core/hooks.py` → `lattice_brain.runtime.hooks`
-- `latticeai/core/multi_agent.py` → `lattice_brain.runtime.multi_agent`
-- `latticeai/core/workflow_engine.py` → `lattice_brain.workflow`
-- `latticeai/core/graph_curator.py` → `lattice_brain.graph.curator`
-- `latticeai/services/ingestion.py` → `lattice_brain.ingestion`
-- `latticeai/services/agent_runtime.py` → `lattice_brain.runtime.agent_runtime`
-- `latticeai/services/kg_portability.py` → `lattice_brain.portability`
-
-Root-level shims (`kg_schema.py`, `knowledge_graph.py`, …) continue to work
-unchanged through the flat `lattice_brain.*` paths.
-
-## 6. Consumers Updated to Import `lattice_brain` Directly
-
-`latticeai/app_factory.py`, `latticeai/core/{agent,agent_registry,builtin_hooks}.py`,
-`latticeai/api/{hooks,tools,computer_use,agents,browser,workflow_designer,chat,mcp}.py`,
-`latticeai/services/{platform_runtime,run_executor,upload_service}.py`,
-`p_reinforce.py`, `scripts/bump_version.py`, `scripts/wheel_smoke.py`, and all
-test modules now use the physical `lattice_brain` paths. Zero non-shim
-references to the old module locations remain.
-
-## 7. New Tests
-
-`tests/unit/test_lattice_brain_isolation.py`:
-
-1. **`test_lattice_brain_never_imports_latticeai`** — subprocess installs a
-   `sys.meta_path` finder that raises on any `latticeai` import, imports every
-   `lattice_brain` module via `pkgutil.walk_packages`, resolves every lazy
-   facade export, and asserts `latticeai` never entered `sys.modules`. This
-   test fails if `lattice_brain` ever imports `latticeai`.
-2. **`test_lattice_brain_usable_in_isolation`** — with the same import block
-   active and FastAPI never started: `BrainCore` construction, ingestion
-   pipeline → graph write, graph search, conversation store append/count,
-   context assembly, workflow engine run, agent runtime/hooks availability,
-   and an encrypted `.latticebrain` archive create → inspect → verify
-   round-trip.
-
-## 8. Packaging / Version Changes
-
-- `pyproject.toml`: packages now include `lattice_brain.graph` and
-  `lattice_brain.runtime`; version `4.4.0`.
-- `scripts/wheel_smoke.py`: import matrix extended with the new subpackages
-  and modules.
-- `scripts/bump_version.py`: `MULTI_AGENT_VERSION` target re-pointed to
-  `lattice_brain/runtime/multi_agent.py`.
-- All 13 synchronized version copies bumped to `4.4.0` via
-  `scripts/bump_version.py` (Python, npm, lockfiles, VSIX, Tauri, asset
-  manifest, runtime constants).
-- Docs updated: `ARCHITECTURE.md` (packaging note now describes the physical
-  layout and the isolation guarantee), `README.md` (Brain Core claim, history,
-  artifact names), `FEATURE_STATUS.md`, `SECURITY.md` (supported versions),
-  `RELEASE_NOTES.md`, `RELEASE_NOTES_v4.4.0.md`, `docs/CHANGELOG.md`,
-  `CHANGELOG.md` pointer.
-
-## 9. User Data and Behavior
-
-No storage schema, migration, archive format, or API change. The SQLite
-default engine, Postgres opt-in path, `.latticebrain` archive format, and
-backup/restore flows are byte-identical code, relocated. Old pickles are not
-used; module identity through shims keeps any dynamic lookups working.
-
-## 10. Validation Results
-
-Environment note: final release validation ran locally on macOS with Python
-3.12.13 (`LTCAI_PYTHON=/tmp/ltcai-v440-py312/bin/python`), Node 26.0.0,
-npm 11.12.1, Rust 1.96.0, Cargo 1.96.0, and Tauri CLI 2.0.0.
-
-| Check | Result |
-| --- | --- |
-| Python compile (`compileall` over `lattice_brain`, `latticeai`, `tests`, `tools`, `scripts`, root modules) | PASS |
-| `ruff check .` | PASS (no findings) |
-| Unit tests (`pytest tests/unit`) | **604 passed** (includes the 2 new isolation tests) |
-| Integration tests (`pytest tests/integration` against live uvicorn on localhost) | 9 passed, 1 skipped (live-Postgres test, opt-in by design) |
-| `lattice_brain` isolation tests | PASS (both) |
-| No `lattice_brain → latticeai` import test | PASS |
-| Graph/search/ingestion tests (`test_kg_*`, `test_ingestion_pipeline`, `test_browser_ingestion`, …) | PASS (within unit suite) |
-| Backup/restore + `.latticebrain` archive tests (`test_kg_portability`, archive round-trip in isolation test) | PASS |
-| Frontend lint (`npm run lint`) | PASS |
-| Frontend typecheck (`tsc --noEmit` + VS Code extension `tsc`) | PASS |
-| Playwright visual tests (`npx playwright test`) | **12 passed** |
-| Tauri check (`cargo check`) | PASS (existing transitive `block v0.1.6` future-incompat warning) |
-| Tauri DMG build (`npm run release:artifacts`) | PASS (`Lattice AI_4.4.0_aarch64.dmg`) |
-| Release artifact validation (`scripts/validate_release_artifacts.py 4.4.0 --require-vsix --require-tgz --require-dmg`) | PASS (warns about historical versions in `dist/`, as designed) |
-| Wheel smoke | PASS (29 wheel modules import from the wheel; `/health` returns `4.4.0`) |
-| `npm pack --dry-run` | PASS (315 files) |
-
-## 11. v4.4.0 Artifacts Built
-
-- `dist/ltcai-4.4.0-py3-none-any.whl` (contains `lattice_brain/graph/*`,
-  `lattice_brain/runtime/*`; verified by wheel content check + smoke)
-- `dist/ltcai-4.4.0.tar.gz`
-- `ltcai-4.4.0.tgz` (npm pack)
-- `dist/ltcai-4.4.0.vsix` (built via `scripts/build_vsix.mjs`)
-- `src-tauri/target/release/bundle/dmg/Lattice AI_4.4.0_aarch64.dmg`
-
-Per instructions: GitHub Release attachment uses only these exact validated
-v4.4.0 artifacts. External package registries are not published.

package/docs/V4_5_0_GEMMA_RUNTIME_COMPATIBILITY_REPORT.md

@@ -1,49 +0,0 @@
-# v4.5.0 Gemma Runtime Compatibility Report
-
-Date: 2026-06-13
-
-## Regression
-
-Gemma 4 12B Instruct and Gemma 4 26B A4B were both presented as local Gemma 4
-models, but they do not enter the same loader path. The first real divergence is
-the local `config.json`: 12B declares `model_type: gemma4_unified`, while 26B
-A4B declares `model_type: gemma4`. Installed MLX-VLM 0.5.0 can load the 26B
-standard `gemma4` path, but it lacks `mlx_vlm.models.gemma4_unified`, and
-MLX-LM does not provide a `gemma4_unified` loader either.
-
-## Fix
-
-- `latticeai.core.model_compat` reads the local model metadata before load and
-  reports `runtime_update_needed` for 12B `gemma4_unified` when
-  `mlx_vlm.models.gemma4_unified` is absent.
-- `latticeai.models.router` keeps the v3 MLX-VLM path first and only retries
-  MLX-LM for standard Gemma 4 metadata. It does not route `gemma4_unified`
-  through the incompatible MLX-LM fallback.
-- `/models` preserves pulled/ready state for no-alias local MLX models, so 26B
-  A4B stays ready while 12B shows the honest runtime-update state.
-- Generic loader failures are converted into friendly recovery payloads without
-  hiding the root cause.
-- Recommendation classification marks the 12B MLX snapshot not recommended until
-  the installed runtime can load it, while the 26B A4B path remains recommended.
-
-## User Guidance
-
-The UI recommends:
-
-- update MLX-VLM to a version with `mlx_vlm.models.gemma4_unified`
-  (`mlx-vlm>=0.6.3`) before loading the 12B MLX snapshot,
-- use Gemma 4 26B A4B locally while the 12B runtime update is pending,
-- use Gemma 4 12B GGUF through Ollama, LM Studio, or llama.cpp as a local-server
-  alternative.
-
-## Tests
-
-- `tests/unit/test_model_compat.py`
-- `tests/unit/test_model_recommendation.py`
-- `tests/unit/test_mlx_router_gemma4_fallback.py`
-- `tests/unit/test_models_api_runtime_routing.py`
-- `tests/visual/v3.spec.js`
-
-## Evidence
-
-Screenshot: `output/audits/v4.5.0-rc/screenshots/03-gemma-runtime-recovery.png`

package/docs/V4_5_0_GRAPH_UX_REPORT.md

@@ -1,34 +0,0 @@
-# v4.5.0 Graph UX Report
-
-Date: 2026-06-13
-
-## Goal
-
-Improve discoverability, readability, focus, searching, and filtering without
-redesigning the graph architecture.
-
-## Changes
-
-- Graph copy now describes ideas, relationships, sources, and saved items
-  instead of backend endpoints.
-- Basic mode hides raw node IDs in the focus panel and shows connections/source
-  instead.
-- Search placeholder is product-oriented in Basic mode.
-- Brain search copy explains unified memory/graph/document search without
-  exposing endpoint mechanics.
-- Advanced/Admin retain structured inspection where useful.
-
-## Existing Capabilities Preserved
-
-- Cytoscape graph rendering
-- semantic groups
-- search
-- label modes
-- importance filter
-- focus neighborhoods
-- group collapse/expand
-- backend hybrid search
-
-## Evidence
-
-Screenshot: `output/audits/v4.5.0-rc/screenshots/04-graph-basic-focus.png`

package/docs/V4_5_0_MODEL_RUNTIME_UX_REPORT.md

@@ -1,40 +0,0 @@
-# v4.5.0 Model Runtime UX Report
-
-Date: 2026-06-13
-
-## Restored Flow
-
-Library Models now presents the intended model flow:
-
-1. Environment Analysis
-2. Recommended Models
-3. Install
-4. Download Progress
-5. Validate
-6. Load
-7. Ready
-
-## Implementation
-
-- Frontend uses the existing `/engines/prepare-model/stream` API for progress.
-- The consent checkbox is required before a setup action may install a runtime
-  or download model files.
-- Current model, top pick, computer readiness, and compatibility validation are
-  visible in one workflow.
-- Advanced/Admin modes show load IDs and engine details; Basic mode shows
-  product-level status and recovery.
-
-## Failure UX
-
-Runtime failures show:
-
-- a clear actionable state such as runtime update, repair, download, fallback,
-  or unsupported format,
-- friendly explanation,
-- recovery guidance,
-- alternatives,
-- no raw Python module exception in Basic mode.
-
-## Evidence
-
-Screenshot: `output/audits/v4.5.0-rc/screenshots/02-model-setup-flow.png`

package/docs/V4_5_0_ONBOARDING_REPORT.md

@@ -1,31 +0,0 @@
-# v4.5.0 Onboarding Report
-
-Date: 2026-06-13
-
-## Restored Surface
-
-The desktop shell now shows a first-run setup guide unless the user dismisses it
-locally. It is also discoverable from the command palette as First-run Setup.
-
-## Covered Steps
-
-- Login: opens System -> Account.
-- Workspace Selection: opens System -> Workspaces.
-- Environment Analysis: opens Library -> Models and uses model recommendation
-  data from `/models/recommendations`.
-- Model Recommendation: surfaces the top recommended local model.
-- Model Installation: keeps runtime install/model download consent visible.
-- Model Validation: shows compatibility profile results after load.
-- Mode Selection: links to System -> Settings and preserves Basic/Advanced/Admin.
-- Brain Usage: opens the graph-first Brain surface.
-
-## Privacy Behavior
-
-No external model download, runtime install, or cloud call starts from
-onboarding. Downloads and installs require the visible Library consent checkbox.
-
-## Evidence
-
-Primary screenshot: `output/audits/v4.5.0-rc/screenshots/01-first-run-setup.png`
-
-Walkthrough GIF: `output/audits/v4.5.0-rc/gifs/v4.5.0-first-run-walkthrough.gif`

package/docs/V4_5_0_PRODUCT_EXPERIENCE_RECOVERY_REPORT.md

@@ -1,49 +0,0 @@
-# v4.5.0 Product Experience Recovery Report
-
-Date: 2026-06-13
-
-## Scope
-
-v4.5.0 restores the product experience on `main` after v4.4.0. It does not
-redesign `lattice_brain`, StorageEngine, FastAPI, Tauri, backup/restore, or
-portability architecture.
-
-## Restored Journey
-
-Before v4.5.0, account, workspace, setup, environment analysis, model setup, and
-mode selection existed but were scattered inside System/Library surfaces.
-
-After v4.5.0, the first-run path is visible from the app shell:
-
-1. Login
-2. Workspace Selection
-3. Environment Analysis
-4. Model Recommendation
-5. Model Installation
-6. Model Validation
-7. Mode Selection
-8. Brain Usage
-
-## Product Changes
-
-- Added a first-run guide in the desktop app shell with direct actions for
-  account, workspace, model setup, mode choice, and Brain entry.
-- Persisted the selected workspace across reloads so the chosen workspace is
-  used by API requests after restart.
-- Reworked Library Models around the existing streamed prepare/load path.
-- Kept model downloads and runtime installs behind explicit consent.
-- Added Gemma 4 MLX runtime metadata checks so 12B `gemma4_unified` shows
-  runtime update guidance while 26B A4B remains ready on the working path.
-- Reduced Basic-mode developer leakage while keeping Advanced/Admin detail.
-- Updated graph/search copy for readability, focus, and source clarity.
-
-## Evidence
-
-- Screenshots: `output/audits/v4.5.0-rc/screenshots/`
-- GIFs: `output/audits/v4.5.0-rc/gifs/`
-- Validation: `docs/V4_5_0_VALIDATION_REPORT.md`
-
-## No-Redesign Confirmation
-
-No storage migrations, archive format changes, FastAPI architecture changes,
-Tauri shell redesign, or Brain Core extraction changes were introduced.

package/docs/V4_5_0_VALIDATION_REPORT.md

@@ -1,60 +0,0 @@
-# v4.5.0 Validation Report
-
-Date: 2026-06-13
-
-## Status
-
-Local RC validation passed on macOS using Python 3.12.13
-(`/tmp/ltcai-v450-py312/bin/python`).
-
-## Required Matrix
-
-| Check | Result |
-| --- | --- |
-| Python compile | PASS: `npm run check:python` |
-| Ruff | PASS: `python -m ruff check .` |
-| Unit tests | PASS: `npm run test:unit` (`607 passed`) |
-| Integration tests | PASS: `npm run test:integration` against a live local server (`9 passed`, `1 skipped`) |
-| `lattice_brain` isolation tests | PASS: `tests/unit/test_lattice_brain_isolation.py` |
-| no `lattice_brain` -> `latticeai` import test | PASS: isolation import guard |
-| graph/search/ingestion tests | PASS: focused graph, search, and ingestion suite (`79 passed`) |
-| backup/restore tests | PASS: `tests/unit/test_kg_portability.py`, `tests/unit/test_v42_brain_storage.py` |
-| `.latticebrain` archive tests | PASS: encrypted archive round trip, tamper rejection, dry-run restore |
-| frontend lint/typecheck | PASS: `npm run lint`, `npm run typecheck` |
-| Playwright | PASS: `npm run test:visual` (`14 passed`) |
-| Tauri cargo check | PASS: `npm run desktop:tauri:check` |
-| Tauri DMG build | PASS: `npm run release:artifacts` |
-| release artifact validation | PASS: `npm run release:validate` |
-| wheel smoke | PASS: `scripts/wheel_smoke.py --wheel dist/ltcai-4.5.0-py3-none-any.whl` |
-| npm pack dry-run | PASS: `npm pack --dry-run` |
-| onboarding/model/Gemma/first-run validation | PASS: Playwright coverage plus screenshots/GIF evidence |
-
-## Notes
-
-- The first integration run was executed without the live local server and
-  failed with connection-refused setup errors. It was rerun against
-  `http://127.0.0.1:8899` and passed.
-- The Postgres live migration integration test remains skipped unless the
-  dedicated Postgres fixture is available.
-- Vite reports the existing large frontend bundle warning during production
-  builds.
-- Tauri/Rust reports an upstream future-incompatibility warning for
-  `block v0.1.6`.
-- SHA-256 artifact hashes were captured after the final local artifact rebuild
-  so this report can be packaged without creating self-referential hash churn.
-
-## Evidence
-
-- Screenshots: `output/audits/v4.5.0-rc/screenshots/`
-- Walkthrough GIF: `output/audits/v4.5.0-rc/gifs/v4.5.0-first-run-walkthrough.gif`
-- Validated artifacts:
-  - `dist/ltcai-4.5.0-py3-none-any.whl`
-  - `dist/ltcai-4.5.0.tar.gz`
-  - `ltcai-4.5.0.tgz`
-  - `dist/ltcai-4.5.0.vsix`
-  - `src-tauri/target/release/bundle/dmg/Lattice AI_4.5.0_aarch64.dmg`
-
-## External Publishing
-
-No PyPI, npm Registry, VS Code Marketplace, or Open VSX publish command is part
-of this RC validation.

package/docs/V4_5_1_GRAPH_EXPERIENCE_REPORT.md

@@ -1,33 +0,0 @@
-# v4.5.1 Graph Experience Report
-
-## Goal
-
-Knowledge exploration should feel like using a Digital Brain, not inspecting a
-database viewer.
-
-## Reimagined Entry Point
-
-Brain is now presented as Home. The default tab is Today, with the map still one
-click away. The first-viewport language now explains that Lattice turns added
-material into a living memory map and keeps every answer tied to its source.
-
-## Preserved Capability
-
-- Cytoscape graph explorer.
-- Semantic groups.
-- Search, focus, label modes, group collapse, and importance filtering.
-- Provenance coverage.
-- Hybrid search.
-- Portability and backup controls.
-
-## Presentation Changes
-
-- Page copy avoids endpoint/framework language in Calm mode.
-- Graph remains real and API-backed.
-- Existing graph route aliases still open the map directly.
-
-## Evidence
-
-- Graph UI: `frontend/src/pages/Brain.tsx`
-- Visual test: `knowledge graph renders a Cytoscape canvas and provenance coverage`
-- Related historical report: `docs/V4_5_0_GRAPH_UX_REPORT.md`

package/docs/V4_5_1_MODEL_EXPERIENCE_REPORT.md

@@ -1,37 +0,0 @@
-# v4.5.1 Model Experience Report
-
-## Goal
-
-Normal users should be able to install and use a local model without learning
-MLX, MLX-LM, MLX-VLM, Ollama, GGUF, or runtime internals.
-
-## Preserved Capability
-
-v4.5.1 keeps the v4.5.0 model recommendation and prepare/load stream:
-
-- Environment analysis.
-- Recommended model selection.
-- Explicit download/install consent.
-- Progress reporting.
-- Validation.
-- Load/ready state.
-- Compatibility recovery guidance.
-
-## Reimagined Presentation
-
-The model experience now sits under Library in the new product shell. The first
-session points users to "Pick a brain" and "Install locally" instead of runtime
-labels. Calm mode keeps implementation terms hidden while Deep/Admin retain
-diagnostics.
-
-## Non-Goals
-
-No model runtime behavior, download policy, local/cloud opt-in policy, or
-compatibility routing was changed in v4.5.1.
-
-## Evidence
-
-- Model UI: `frontend/src/pages/Library.tsx`
-- Model API client: `frontend/src/api/client.ts`
-- Related historical runtime report:
-  `docs/V4_5_0_MODEL_RUNTIME_UX_REPORT.md`

package/docs/V4_5_1_NAVIGATION_REPORT.md

@@ -1,37 +0,0 @@
-# v4.5.1 Navigation Report
-
-## New Navigation Model
-
-The primary navigation is now:
-
-- Home
-- Ask
-- Add
-- Automate
-- Library
-- Care
-
-This replaces the previous product taxonomy without removing compatibility
-routes. Existing paths such as `#/knowledge-graph`, `#/hybrid-search`,
-`#/files`, `#/agents`, `#/workspace-admin`, and admin aliases still route to
-the same capability modules.
-
-## Why This Model
-
-- Home is the user-facing Digital Brain entry point.
-- Ask is the clearest label for conversational work.
-- Add explains knowledge ingestion without technical vocabulary.
-- Automate explains agents/workflows as supervised outcomes.
-- Library remains clear for models, skills, and connections.
-- Care reframes account, backups, devices, and safety as maintenance.
-
-## Implementation
-
-- Route compatibility remains in `frontend/src/routes.ts`.
-- The visible dock and mobile drawer are implemented in `frontend/src/App.tsx`.
-- Visual tests now assert the new navigation labels and legacy route behavior.
-
-## Evidence
-
-- Tests: `tests/visual/v3.spec.js`
-- Code: `frontend/src/routes.ts`, `frontend/src/App.tsx`

package/docs/V4_5_1_ONBOARDING_REPORT.md

@@ -1,29 +0,0 @@
-# v4.5.1 Onboarding Report
-
-## Goal
-
-Onboarding should make the next action obvious to a first-time, non-technical
-user without documentation.
-
-## Reimagined Journey
-
-- Make it yours: account/profile setup.
-- Choose a space: personal or organization workspace selection.
-- Meet your Mac: environment analysis.
-- Pick a brain: model recommendation.
-- Install locally: consent-gated model/runtime setup.
-- Try a question: model validation through conversation.
-- Set the pace: Calm, Deep, or Admin mode.
-- Explore memory: open the knowledge map.
-
-## Behavior
-
-The journey reads real backend state from profile, workspace, models, and model
-recommendation APIs. The guide can be hidden through local storage, but no
-backend state is faked to mark setup complete.
-
-## Evidence
-
-- Primary component: `frontend/src/components/FirstRunGuide.tsx`
-- Desktop screenshot: `output/audits/v4.5.1-reimagining/screenshots/home-desktop.png`
-- Walkthrough GIF: `output/audits/v4.5.1-reimagining/gifs/v4.5.1-reimagining-walkthrough.gif`