ltcai 4.3.3

Lattice AI — local-first Digital Brain Platform: knowledge graph with provenance, durable memory, hybrid search, real agent/workflow runtimes, and portable encrypted brain archives

Lattice AI

Lattice AI v4.3.3 is a local-first Digital Brain desktop workspace. It runs as a Tauri desktop app with a localhost FastAPI sidecar, stores the user's brain locally by default, and presents the Knowledge Graph as the durable asset.

This README describes the v4.3.3 release tree, which promotes the post-cleanup main branch after the v4.3.2 self-audit and independent dead-code/runtime audit. External package registries are owner-published; the badges above link to package pages and may show the most recently published owner-controlled registry version, which can lag behind the GitHub Release.

What Was Verified

• Desktop app starts and serves the React/Vite product shell from the FastAPI sidecar.
• Brain graph renders persisted local graph data with search, groups, focus, filtering, and hybrid-search results.
• Ask displays durable conversations, graph context, and honest unavailable state when no model is loaded.
• Capture uploads a document through /upload/document and shows indexed documents from the backend.
• Act exposes workflow create/run surfaces and agent runtime status without presenting simulation as real success. When no LLM-backed model is loaded, deterministic model-free agent simulation is reported honestly and does not call a model.
• Library shows model/runtime availability honestly.
• System exposes storage, backup health, archive, Brain Network, device identity, and admin status through real APIs.
• Backup, restore dry-run, archive verify, archive import dry-run, and .latticebrain portability flows were exercised.

Product Tour

Desktop Startup

The v4.3.3 DMG build launches a visible Tauri app, starts the FastAPI sidecar on localhost, and shuts that sidecar down on normal macOS quit.

Evidence:

• Health log: output/audits/v4.3.2-rc/logs/desktop-sidecar-health-after-shutdown-fix.json
• Shutdown log: output/audits/v4.3.2-rc/logs/desktop-shutdown-after-fix.txt

Brain Graph

Brain opens on the graph-first workspace. The graph uses real persisted nodes and edges from /knowledge-graph/graph, then layers product controls for search, semantic grouping, focus neighborhoods, label modes, group collapse/expand, and importance filtering.

Ask

Ask uses backend conversation, model, and graph context APIs. In the audited state no model was loaded, so the UI showed a ready/unavailable state instead of fabricating an answer while still surfacing graph context from local data.

Capture

Capture sends files through the backend upload/ingestion path and shows indexed documents returned by the backend. The screenshot below includes a note uploaded during release-prep evidence capture.

Upload evidence: output/audits/v4.3.2-rc/logs/readme-upload-note.json

Act

Act exposes agents, workflows, approvals, hooks, and runtime status through existing backend APIs. The audited workflow path created a real workflow record; agent runtime simulation remains honestly unavailable as product success when no LLM-backed model is loaded.

Library

Library shows models, skills, MCP, and marketplace/configuration state with availability reported from runtime APIs. Optional model runtimes are not treated as loaded unless the runtime is actually available.

System

System exposes account/workspace status, storage mode, backup health, archive operations, device identity, Brain Network, and admin hardening state. External integrations remain opt-in.

Backup / Restore

Backup and restore flows are backed by the knowledge-graph portability APIs. The retained v4.3.2 product audit exercised backup health, backup creation, restore dry-run, and archive restore surfaces.

.latticebrain Portability

The portable brain format is an encrypted .latticebrain archive. The audited System flow exercised archive export, inspect, verify, import dry-run, and restore dry-run/restore controls through FastAPI.

Archive evidence:

• Create: output/audits/v4.3.2-rc/logs/archive-create.json
• Verify: output/audits/v4.3.2-rc/logs/archive-verify.json
• Import dry-run: output/audits/v4.3.2-rc/logs/archive-import-dry-run.json

Architecture At A Glance

• Desktop shell: Tauri 2 primary shell; Electron remains fallback-only.
• Frontend: React, TypeScript, Vite, TanStack Query, Zustand, Cytoscape.js, React Flow, Tailwind/shadcn-style primitives, generated OpenAPI client.
• Backend: FastAPI on localhost is the source of truth for the UI.
• Brain Core: independent Python package lattice_brain, imported by FastAPI, CLI, tests, and future tools.
• Storage: StorageEngine abstraction with SQLite default and optional PostgreSQL/pgvector scale mode.
• Portability: encrypted .latticebrain archive plus backup/restore and migration tooling.
• Privacy: local-first by default; cloud models, Telegram, Brain Network, Docker, model downloads, and update checks require explicit opt-in paths.

See ARCHITECTURE.md for the detailed v4.3.3 architecture.

Installation And Release Artifacts

Validated v4.3.3 artifacts are produced from the post-cleanup tree:

• dist/ltcai-4.3.3-py3-none-any.whl
• dist/ltcai-4.3.3.tar.gz
• ltcai-4.3.3.tgz
• dist/ltcai-4.3.3.vsix
• src-tauri/target/release/bundle/dmg/Lattice AI_4.3.3_aarch64.dmg

For a public release, attach only those exact artifacts to the GitHub Release. Package-registry publishing is reserved for the owner.

Local Development

npm install
npm run dev

Open the local app:

http://127.0.0.1:4825/app

Build the release artifacts:

npm run release:artifacts
npm run release:validate

Run the main validation set:

npm run check:python
node scripts/run_python.mjs -m ruff check .
npm run lint
npm run typecheck
npm run test:unit
LTCAI_TEST_BASE_URL=http://127.0.0.1:4932 npm run test:integration
npm run test:visual
npm run desktop:tauri:check
node scripts/run_python.mjs scripts/wheel_smoke.py --wheel dist/ltcai-4.3.3-py3-none-any.whl
npm pack --dry-run

Known Limitations

• External package registries are owner-published and can lag behind the GitHub Release.
• PostgreSQL/pgvector is optional scale mode and is not required for default local use.
• Docker is never auto-started by default.
• Model downloads and cloud model calls require explicit user action/consent.
• Ask does not fabricate answers when no model is loaded.
• Historical artifacts may remain in dist/; release uploads must use exact v4.3.3 filenames.

Release History

Version	Theme
4.3.3	Dead-Code Cleanup Release: post-audit cleanup, architecture documentation correction, Vercel/static-docs readiness, README badge restoration, exact-current artifacts
4.3.2	Product Polish & Graph UX Overhaul RC: evidence-based README, graph UX, structured product state, archive UX, desktop sidecar cleanup, publishing readiness
4.3.1	End-User Audit Repair RC: desktop sidecar startup, npm clean install, default-off downloads, honest agent/workflow states
4.3.0	Portability & Product Hardening RC: encrypted .latticebrain archives, backup/restore hardening, local-only startup guards
4.2.0	Brain Core & Storage Rebuild: independent lattice_brain, StorageEngine abstraction, SQLite default, opt-in Postgres/pgvector
4.1.0	Frontend & Desktop Rebuild: React/Vite SPA, Tauri shell, generated OpenAPI client
4.0.1	Digital Brain maintenance: durable async runs, identity/workspace state, /app parity
4.0.0	Digital Brain Platform foundation
3.0.0	v3 local-first AI workspace platform

Current Documentation

• ARCHITECTURE.md - v4.3.3 architecture.
• FEATURE_STATUS.md - current feature status and historical status ledger.
• RELEASE_NOTES.md - current release notes index.
• RELEASE_NOTES_v4.3.3.md - v4.3.3 release notes.
• RELEASE.md - release checklist and exact artifact guidance.
• SECURITY.md - security posture.
• docs/CHANGELOG.md - changelog.
• docs/V4_3_2_DEADCODE_AUDIT_REPORT.md - v4.3.3 cleanup basis.
• docs/V4_3_2_GRAPH_UX_REPORT.md - graph UX report.
• docs/V4_3_2_PRODUCT_POLISH_REPORT.md - product polish report.
• docs/V4_3_2_SELF_AUDIT_REPORT.md - self-audit evidence.
• docs/V4_3_2_VALIDATION_REPORT.md - RC validation report.
• docs/V4_3_2_DOCUMENTATION_CLEANUP_REPORT.md - release-prep documentation cleanup report.
• docs/V4_3_2_GITHUB_VERCEL_CHECK_REPORT.md - GitHub/Vercel readiness report.
• docs/V4_3_2_INDEPENDENT_AUDIT_PACKAGE.md - package for an independent reviewer.
• docs/V4_3_2_DEADCODE_AUDIT_REPORT.md - independent dead-code, architecture, and runtime audit.
• docs/V4_DIGITAL_BRAIN_RECOVERY.md - transformation recovery file.

License

MIT. See LICENSE.