ltcai 8.1.0 → 8.3.0

package/docs/V4_5_1_PRODUCT_REIMAGINING_REPORT.md

@@ -1,61 +0,0 @@
-# v4.5.1 Product Reimagining Report
-
-Release date: 2026-06-13
-
-## Objective
-
-v4.5.1 treats the previous desktop product surface as non-authoritative. The
-goal was not to polish the v4.5.0 recovery UI; it was to relaunch Lattice AI as
-a premium local-first Digital Brain while preserving all capabilities,
-workflows, data contracts, storage, FastAPI APIs, Tauri shell behavior, Brain
-Core, model runtimes, backup/restore, and portability.
-
-## Product Decision
-
-The product is now organized around six user-facing rooms:
-
-- Home: the living shape of what Lattice knows.
-- Ask: thinking with remembered context.
-- Add: files, folders, and pages entering memory.
-- Automate: supervised goals, runs, workflows, approvals, hooks, and tools.
-- Library: models, skills, marketplace, and tool connections.
-- Care: account, spaces, backups, devices, settings, and admin safety.
-
-Legacy hash routes still resolve into the SPA, but they no longer dictate the
-visible product model.
-
-## What Changed
-
-- Replaced the fixed left rail with compact desktop chrome and a centered
-  navigation dock.
-- Added a command palette and responsive mobile drawer.
-- Added an ambient brain canvas so the first viewport reads as a thinking
-  environment rather than a dashboard.
-- Replaced the first-run checklist with a first-session journey.
-- Reworked route labels and page hero copy across Brain, Ask, Capture, Act,
-  Library, and System.
-- Rebuilt global styling around calmer surfaces, fixed responsive type sizes,
-  and restrained accents.
-
-## What Was Preserved
-
-- FastAPI and generated OpenAPI client.
-- Tauri desktop shell and sidecar behavior.
-- `lattice_brain` package boundary.
-- StorageEngine, SQLite default, optional PostgreSQL scale mode.
-- Backup/restore and `.latticebrain` portability.
-- Model recommendation, prepare/load stream, and consent-gated downloads.
-- Knowledge graph, hybrid search, chat, capture, workflow, agent, system, and
-  admin APIs.
-
-## Self Review
-
-The redesigned first viewport immediately reads as a different product:
-Lattice branding, Home/Ask/Add/Automate/Library/Care navigation, first-session
-journey, and premium desktop chrome replace the old dashboard hierarchy.
-
-## Evidence
-
-- Desktop screenshot: `output/audits/v4.5.1-reimagining/screenshots/home-desktop.png`
-- Mobile screenshot: `output/audits/v4.5.1-reimagining/screenshots/home-mobile.png`
-- Walkthrough GIF: `output/audits/v4.5.1-reimagining/gifs/v4.5.1-reimagining-walkthrough.gif`

package/docs/V4_5_1_RC_ARTIFACTS.md

@@ -1,44 +0,0 @@
-# v4.5.1 RC Artifact Manifest
-
-Release date: 2026-06-13
-
-## Screenshots
-
-- `output/audits/v4.5.1-reimagining/screenshots/home-desktop.png`
-- `output/audits/v4.5.1-reimagining/screenshots/home-mobile.png`
-- `output/audits/v4.5.1-reimagining/screenshots/memory-map.png`
-- `output/audits/v4.5.1-reimagining/screenshots/library-models.png`
-
-## GIFs
-
-- `output/audits/v4.5.1-reimagining/gifs/v4.5.1-reimagining-walkthrough.gif`
-
-## Release Artifacts
-
-- `dist/ltcai-4.5.1-py3-none-any.whl`
-- `dist/ltcai-4.5.1.tar.gz`
-- `ltcai-4.5.1.tgz`
-- `dist/ltcai-4.5.1.vsix`
-- `src-tauri/target/release/bundle/dmg/Lattice AI_4.5.1_aarch64.dmg`
-
-## SHA-256
-
-| Artifact | SHA-256 |
-| --- | --- |
-| `dist/ltcai-4.5.1-py3-none-any.whl` | `3d5ce1a0a85f7aba1f78587cd7e4a66c63dd5c03ddde7cee57624ec3f487899b` |
-| `dist/ltcai-4.5.1.tar.gz` | `62f0e05ff32554cf599b76678de3136bc02e5af4775144e7347182eed0fb4675` |
-| `ltcai-4.5.1.tgz` | `e755f40f87484d8a6e3f6bc95f48f0f78e1d0fcde3af8b14c709cf7fa71b2e4b` |
-| `dist/ltcai-4.5.1.vsix` | `3badc5915dc31425fa383d5946f78e0914497aa9e523cb7fbdc81a295b8f4a2f` |
-| `src-tauri/target/release/bundle/dmg/Lattice AI_4.5.1_aarch64.dmg` | `689ffc9553facf3987a5d57016dfd24fc3872f9c0810e28621f96b340ca38ce0` |
-
-## Validation
-
-`npm run release:validate` passed for the exact v4.5.1 artifact set. Historical
-files remain in `dist/` for prior releases, so all publish or upload steps must
-use exact v4.5.1 filenames only.
-
-## Notes
-
-The artifact list is exact-version only. Publishing remains out of scope for
-this RC unless the repository owner explicitly performs the manual registry
-publish steps.

package/docs/V4_5_1_UX_REPORT.md

@@ -1,45 +0,0 @@
-# v4.5.1 UX Report
-
-## UX Principle
-
-v4.5.1 designs for non-technical users who should understand what Lattice AI is,
-what to do next, how to add knowledge, how to use the brain, how to install a
-model, and how to automate work without reading the README.
-
-## Primary Flow
-
-The first-session journey is:
-
-1. Make it yours.
-2. Choose a space.
-3. Meet your Mac.
-4. Pick a brain.
-5. Install locally.
-6. Try a question.
-7. Set the pace.
-8. Explore memory.
-
-This replaces implementation-facing setup labels with user outcomes while still
-driving the same account, workspace, model recommendation, model setup, mode,
-and graph routes.
-
-## Screen Inventory Decision
-
-- Brain became Home, emphasizing the shape of work rather than a graph tool.
-- Capture became Add, emphasizing the act of feeding memory.
-- Act became Automate, emphasizing supervised work instead of an agent console.
-- System became Care, emphasizing trust, portability, and maintenance.
-- Ask and Library survived because their user intent is direct and legible.
-
-## Interaction Notes
-
-- Command palette remains available with Cmd/Ctrl+K.
-- Mode switching is visible as Calm, Deep, and Admin instead of Basic,
-  Advanced, and Admin in the first viewport.
-- Mobile navigation opens as a room chooser and preserves no-horizontal-overflow
-  behavior at 390px width.
-
-## Evidence
-
-- Playwright visual coverage: `tests/visual/v3.spec.js`
-- Screenshots: `output/audits/v4.5.1-reimagining/screenshots/`

package/docs/V4_5_1_VALIDATION_REPORT.md

@@ -1,55 +0,0 @@
-# v4.5.1 Validation Report
-
-Release date: 2026-06-13
-
-## Scope
-
-Validation covers the v4.5.1 product reimagining, version sync, frontend visual
-changes, release artifacts, and compatibility preservation.
-
-## Command Matrix
-
-| Check | Result |
-| --- | --- |
-| Python compile | PASS: `npm run check:python` compiled 775 modules |
-| Ruff | PASS: `node scripts/run_python.mjs -m ruff check .` |
-| Unit tests | PASS: `npm run test:unit` - 616 passed, 2 warnings |
-| Integration tests | PASS: `LTCAI_TEST_BASE_URL=http://127.0.0.1:4932 npm run test:integration` - 9 passed, 1 skipped |
-| Frontend lint | PASS: `npm run lint` |
-| TypeScript typecheck | PASS: `npm run typecheck` and `npm run typecheck:frontend` |
-| Playwright | PASS: `npm run test:visual` - 14 passed |
-| Tauri check/build | PASS: `npm run desktop:tauri:check`; PASS via `npm run release:artifacts` for the Tauri app and DMG build |
-| Release artifact validation | PASS: `npm run release:validate` |
-| Wheel smoke | PASS: `node scripts/run_python.mjs scripts/wheel_smoke.py --wheel dist/ltcai-4.5.1-py3-none-any.whl` |
-| npm pack dry-run | PASS: `npm pack --dry-run` |
-
-## Browser Evidence
-
-- Desktop screenshot: `output/audits/v4.5.1-reimagining/screenshots/home-desktop.png`
-- Mobile screenshot: `output/audits/v4.5.1-reimagining/screenshots/home-mobile.png`
-- Walkthrough GIF: `output/audits/v4.5.1-reimagining/gifs/v4.5.1-reimagining-walkthrough.gif`
-
-## RC Artifacts
-
-Expected exact-version artifacts:
-
-- `dist/ltcai-4.5.1-py3-none-any.whl`
-- `dist/ltcai-4.5.1.tar.gz`
-- `ltcai-4.5.1.tgz`
-- `dist/ltcai-4.5.1.vsix`
-- `src-tauri/target/release/bundle/dmg/Lattice AI_4.5.1_aarch64.dmg`
-
-## Artifact Hashes
-
-| Artifact | SHA-256 |
-| --- | --- |
-| `dist/ltcai-4.5.1-py3-none-any.whl` | `3d5ce1a0a85f7aba1f78587cd7e4a66c63dd5c03ddde7cee57624ec3f487899b` |
-| `dist/ltcai-4.5.1.tar.gz` | `62f0e05ff32554cf599b76678de3136bc02e5af4775144e7347182eed0fb4675` |
-| `ltcai-4.5.1.tgz` | `e755f40f87484d8a6e3f6bc95f48f0f78e1d0fcde3af8b14c709cf7fa71b2e4b` |
-| `dist/ltcai-4.5.1.vsix` | `3badc5915dc31425fa383d5946f78e0914497aa9e523cb7fbdc81a295b8f4a2f` |
-| `src-tauri/target/release/bundle/dmg/Lattice AI_4.5.1_aarch64.dmg` | `689ffc9553facf3987a5d57016dfd24fc3872f9c0810e28621f96b340ca38ce0` |
-
-`npm run release:validate` confirmed all exact-version RC artifacts are present.
-It also warned that historical artifacts remain in `dist/`, so publish commands
-must continue to use explicit v4.5.1 filenames rather than a wildcard from the
-`dist` directory.

package/docs/V4_5_1_VISUAL_DESIGN_REPORT.md

@@ -1,30 +0,0 @@
-# v4.5.1 Visual Design Report
-
-## Direction
-
-The visual language targets a calm premium desktop product rather than a
-developer/admin dashboard. The palette uses a carbon and warm-white base with
-jade, amber, violet, blue, and coral accents so the UI is not dominated by a
-single hue family.
-
-## System Changes
-
-- New sticky desktop chrome and centered dock.
-- Ambient brain canvas built from grid, line, and tile motifs.
-- Fixed responsive typography with media-query breakpoints, avoiding viewport
-  width font scaling.
-- Cards remain at 8px radius or less.
-- Shared buttons and badges were tightened for stable sizing and text fit.
-- Light theme retains the same hierarchy with warmer surfaces.
-
-## Accessibility And Layout
-
-- Primary navigation has an explicit `Primary navigation` label.
-- The command palette exposes a dialog label.
-- Mode switch has `Experience mode` semantics and pressed states.
-- Mobile layout was checked at 390x780 with zero horizontal overflow.
-
-## Evidence
-
-- Desktop visual pass: `output/audits/v4.5.1-reimagining/screenshots/home-desktop.png`
-- Mobile visual pass: `output/audits/v4.5.1-reimagining/screenshots/home-mobile.png`

package/docs/V4_6_0_LIVING_BRAIN_EXPERIENCE_REPORT.md

@@ -1,72 +0,0 @@
-# v4.6.0 Living Brain Experience Report
-
-## Goal
-
-v4.6.0 stops presenting Lattice AI as a graph product or dashboard. The
-first-run product flow is Login -> Environment Analysis -> Recommended Models
--> Install & Load -> Brain. After setup, the Brain is the center of the desktop
-experience, and the graph is repositioned as the deepest layer inside Brain
-exploration rather than a separate destination.
-
-## Product Changes
-
-- First launch opens to a premium minimal Login screen only.
-- Setup runs as a full-screen guided sequence: friendly environment analysis,
-  short ranked model recommendations, and install/download/validate/load.
-- After model load, `/app` and compatible legacy entry URLs open into Brain plus
-  conversation.
-- The living Brain is an anatomical, recognizable Brain that remains visible
-  during primary conversation and reacts to listening, recall, thinking,
-  planning, and active agent/workflow signals.
-- Brain exploration now has five depths:
-  Living Brain, Memory Layer, Knowledge Layer, Relationship Layer, and
-  Knowledge Graph.
-- The Knowledge Graph appears only at Level 5 and includes nodes, edges, search,
-  and focus details.
-- `/chat`, `/ask`, `/graph`, and other legacy entry URLs remain compatible app
-  entry points, but the primary user path inward is through the Brain itself.
-- First-run setup no longer appears as dashboard cards above any app page; it
-  gates the app before the Brain opens.
-
-## Architecture
-
-- Added `frontend/src/components/LivingBrain.tsx` as the animated Brain
-  presence component.
-- Updated `frontend/src/App.tsx` to own the five-depth Brain journey and the
-  emergent graph surface.
-- `frontend/src/components/BrainConversation.tsx` remains available for legacy
-  page compatibility and now shares the expanded Brain activity states.
-- Added `frontend/src/components/ProductFlow.tsx` to own Login, environment
-  analysis, recommendation, install/download/validate/load, and Brain entry.
-- Kept graph APIs, memory APIs, search, provenance, portability, and archive
-  APIs intact.
-- Kept FastAPI, Tauri, StorageEngine, Brain Core, backup/restore, and
-  portability unchanged.
-
-## Compatibility
-
-- Existing backend routes are unchanged.
-- Legacy hash routes and redirects continue to arrive inside the SPA.
-- The advanced graph capability remains available as Level 5 of Brain
-  exploration.
-- The older route components remain in source for compatibility while the
-  primary app surface is the Brain Space.
-
-## Validation Scope
-
-The v4.6.0 work should be validated with:
-
-- frontend lint/typecheck/build
-- Python syntax validation
-- affected visual tests
-- unit tests covering version consistency and route compatibility
-- Tauri cargo check when the desktop toolchain is available
-
-Validated in this update:
-
-- `npm run lint`
-- `npm run test:visual`
-- `npm run check:python`
-- `npm run test:unit`
-- `npm run test:integration` with the local server on port 8899
-- `npm run build`

package/docs/V4_6_1_RELEASE_REFRESH_REPORT.md

@@ -1,42 +0,0 @@
-# v4.6.1 Living Brain Release Refresh Report
-
-## Scope
-
-v4.6.1 is the publishable Living Brain release refresh after the v4.6.0 PyPI
-immutability block. The work intentionally does not redesign backend
-architecture or add unrelated product features.
-
-## Completed Refresh Areas
-
-- Synchronized then-current release version metadata to `4.6.1`.
-- Reframed README around the current Living Brain flow:
-  Login -> Environment Analysis -> Recommended Models -> Install & Load ->
-  Brain Chat.
-- Documented the five Brain depths: Living Brain, Memory Layer, Knowledge Layer,
-  Relationship Layer, and Knowledge Graph.
-- Kept the Knowledge Graph positioned as the deepest Brain exploration layer,
-  not a standalone dashboard or home screen.
-- Updated ARCHITECTURE.md for the current Tauri, React/Vite, FastAPI,
-  independent `lattice_brain`, StorageEngine, SQLite default, optional
-  PostgreSQL/pgvector, backup/restore, and `.latticebrain` portability reality.
-- Added v4.6.1 release notes and synchronized the changelog, feature status,
-  security policy, VS Code extension README, and release guide.
-
-## Evidence
-
-Fresh v4.6.1 screenshots and walkthrough media are indexed in
-[output/release/v4.6.1/SCREENSHOT_INDEX.md](../output/release/v4.6.1/SCREENSHOT_INDEX.md).
-
-## Expected Artifacts
-
-- `dist/ltcai-4.6.1-py3-none-any.whl`
-- `dist/ltcai-4.6.1.tar.gz`
-- `dist/ltcai-4.6.1.vsix`
-- `ltcai-4.6.1.tgz`
-- `src-tauri/target/release/bundle/dmg/Lattice AI_4.6.1_aarch64.dmg`
-
-## Validation Checklist
-
-The final release report records command results, artifact SHA256 hashes, commit,
-tag, push, and GitHub Release URL. External package registries are not published
-by this refresh.

package/docs/V4_7_0_ADMIN_SEPARATION_REPORT.md

@@ -1,42 +0,0 @@
-# v4.7.0 Admin Separation Report
-
-## Scope
-
-v4.7.0 turns Lattice AI into a cleaner product split: everyday users live in the
-Living Brain, while operators use a dedicated Admin Console for observability and
-maintenance. This release does not redesign Brain Core or the storage layer.
-
-## Completed Areas
-
-- Separated the admin route into `#/admin` while keeping `/app` focused on Brain
-  plus conversation.
-- Added admin overview cards for users, recent logs, security, and Brain index
-  status.
-- Added admin panels for user directory, audit logs, security events, policies,
-  and index rebuild operations.
-- Added workspace-aware filtering for admin summary, stats, sensitivity, and
-  audit reads when the active workspace header/query is present.
-- Added frontend API helpers for `/admin/stats` and `/admin/security/events`.
-- Updated visual validation to confirm the admin console is separate from the
-  user Brain surface.
-- Synchronized then-current release version metadata to `4.7.0`.
-- Updated README, RELEASE.md, release notes, changelog, architecture, security,
-  feature status, VS Code extension docs, and release evidence references.
-
-## Evidence
-
-Fresh v4.7.0 screenshots and walkthrough media are indexed in
-[output/release/v4.7.0/SCREENSHOT_INDEX.md](../output/release/v4.7.0/SCREENSHOT_INDEX.md).
-
-## Expected Artifacts
-
-- `dist/ltcai-4.7.0-py3-none-any.whl`
-- `dist/ltcai-4.7.0.tar.gz`
-- `dist/ltcai-4.7.0.vsix`
-- `ltcai-4.7.0.tgz`
-- `src-tauri/target/release/bundle/dmg/Lattice AI_4.7.0_aarch64.dmg`
-
-## Validation Checklist
-
-The final release report records command results, artifact SHA256 hashes, commit,
-tag, push, GitHub Release URL, and package registry publish status.

package/docs/V4_7_1_ADMIN_OPERATIONS_REPORT.md

@@ -1,49 +0,0 @@
-# v4.7.1 Admin Operations Report
-
-## Scope
-
-v4.7.1 turns Lattice AI into a cleaner product split: everyday users live in the
-Living Brain, while operators use a dedicated Admin Console for observability and
-maintenance. This release does not redesign Brain Core or the storage layer.
-
-## Completed Areas
-
-- Separated the admin route into `#/admin` while keeping `/app` focused on Brain
-  plus conversation.
-- Added admin overview cards for users, recent logs, security, and Brain index
-  status.
-- Added admin panels for user directory, role permissions, filtered audit logs,
-  security events, policies, log retention, and index rebuild operations.
-- Added server-side audit query filters for search text, actor, action,
-  severity, and result limit.
-- Added `/admin/log-retention` for local-first retention posture, retained event
-  counts, prune candidates, and export-before-prune status.
-- Added workspace-aware filtering for admin summary, stats, sensitivity, and
-  audit reads when the active workspace header/query is present.
-- Added frontend API helpers for `/admin/stats`, `/admin/security/events`,
-  `/admin/roles`, and `/admin/log-retention`.
-- Moved Admin Console data loading into a dedicated hook so Brain user state and
-  admin observability state remain separate in the frontend runtime.
-- Updated visual validation to confirm the admin console is separate from the
-  user Brain surface.
-- Synchronized then-current release version metadata to `4.7.1`.
-- Updated README, RELEASE.md, release notes, changelog, architecture, security,
-  feature status, VS Code extension docs, and release evidence references.
-
-## Evidence
-
-Fresh v4.7.1 screenshots and walkthrough media are indexed in
-[output/release/v4.7.1/SCREENSHOT_INDEX.md](../output/release/v4.7.1/SCREENSHOT_INDEX.md).
-
-## Expected Artifacts
-
-- `dist/ltcai-4.7.1-py3-none-any.whl`
-- `dist/ltcai-4.7.1.tar.gz`
-- `dist/ltcai-4.7.1.vsix`
-- `ltcai-4.7.1.tgz`
-- `src-tauri/target/release/bundle/dmg/Lattice AI_4.7.1_aarch64.dmg`
-
-## Validation Checklist
-
-The final release report records command results, artifact SHA256 hashes, commit,
-tag, push, GitHub Release URL, and package registry publish status.

package/docs/V4_7_2_INTUITIVE_BRAIN_UX_REPORT.md

@@ -1,62 +0,0 @@
-# v4.7.2 Intuitive Brain UX Report
-
-## Scope
-
-v4.7.2 focuses on the product question: can a normal user understand why Lattice
-AI exists and operate the Brain without learning database, graph, or admin
-jargon? The release does not redesign Brain Core, storage, APIs, model runtime,
-backup/restore, portability, or the separated Admin Console.
-
-## Product Changes
-
-- First-run login no longer auto-registers a new local account when the saved
-  Brain email differs or when the saved email has a wrong password.
-- Recommended model setup now has a single primary action for users who do not
-  know which model to choose.
-- Install/download messaging explains long-running model downloads honestly
-  without fabricated ETA.
-- Brain home now exposes direct Memory, Topic, Relationship, and Graph actions.
-- Brain Chat shows recent memories, older memories, major topics, and
-  saved-to-memory feedback after chat.
-
-## Collaboration Summary
-
-pts_claudecode identified the highest-risk product gaps: empty-Brain creation
-from login typo, graph-first mental model leakage, lack of direct topic/time
-visibility, and model download trust problems. v4.7.2 addresses the parts that
-fit a scoped release: safer login, direct Brain views, topic/memory overview,
-and honest model setup copy. pts_grok did not return a channel review before
-completion.
-
-## Evidence
-
-Fresh v4.7.2 screenshots and walkthrough media are indexed in
-[output/release/v4.7.2/SCREENSHOT_INDEX.md](../output/release/v4.7.2/SCREENSHOT_INDEX.md).
-
-## Validation Targets
-
-- `npm run typecheck:frontend`
-- `npm run lint`
-- `npm run test:visual`
-- `npm run test:unit`
-- `npm run test:integration`
-- `npm run release:artifacts`
-- `npm run release:validate`
-
-## Expected Artifacts
-
-- `dist/ltcai-4.7.2-py3-none-any.whl`
-- `dist/ltcai-4.7.2.tar.gz`
-- `dist/ltcai-4.7.2.vsix`
-- `ltcai-4.7.2.tgz`
-- `src-tauri/target/release/bundle/dmg/Lattice AI_4.7.2_aarch64.dmg`
-
-## Remaining Technical Debt
-
-- Admin Console still needs deeper role-based authorization workflows and
-  configurable log retention UI.
-- Brain topic grouping is now visible, but backend topic clustering and a true
-  time-axis memory view should be promoted into first-class APIs next.
-- AgentRuntime extraction should continue so user Brain state and admin
-  observability state remain architecturally separate beyond the frontend layer.
-