memorix 1.0.8 → 1.0.9

package/CHANGELOG.md

@@ -1,9 +1,44 @@
 # Changelog
 
-All notable changes to this project will be documented in this file.
-
-## [1.0.8] - 2026-04-19
-
+All notable changes to this project will be documented in this file.
+
+## [1.0.9] - 2026-05-19
+
+### Added -- Knowledge Base / LLM Wiki Foundation
+- **First-class Knowledge Base layer** -- Added a readable project knowledge layer generated from durable memory, git-backed facts, mini-skills, and project evidence. The Knowledge Base is a shared human-and-AI surface, not a replacement for raw observations and not a TUI-only feature.
+- **Knowledge graph projection** -- Added a semantic graph projection over the same eligible knowledge inputs, preserving source refs for navigation and traceability.
+- **Dashboard Knowledge foundation** -- Dashboard surfaces can consume the same generated knowledge contract as the TUI, keeping Knowledge Base and graph semantics aligned.
+
+### Added -- TUI Knowledge Workbench
+- **Tabbed terminal workbench** -- Reworked the TUI around `Home`, `Knowledge`, `Memory`, `Workbench`, and `Graph` tabs.
+- **Knowledge browsing** -- Added a Knowledge tab for generated wiki sections, item summaries, entities, and source refs.
+- **Memory browsing** -- Added a Memory tab for recent/search/detail flows with ref-focused navigation from Knowledge.
+- **Workbench session center** -- Added explicit session status, explicit bind/end actions, context source summary, and chat. Entering the tab does not auto-start a session.
+- **Graph text browser** -- Added a terminal-native Knowledge Graph tab with summary stats, cluster browsing, node detail, light filtering, and Graph -> Knowledge jumps.
+- **Cross-surface ref navigation** -- Added Knowledge -> Memory, Memory -> Knowledge, and Graph -> Knowledge navigation paths based on stable refs where available.
+
+### Changed
+- **Knowledge architecture clarified** -- Documented the memory layer as the primary input to the knowledge layer, while project evidence such as docs, source structure, and git facts act as secondary inputs.
+- **TUI scope tightened** -- The TUI now behaves as a knowledge-native workbench, not a placeholder coding-agent harness. No fake Run Task / Review controls are exposed.
+- **Session semantics preserved** -- `session_start` remains explicit and lightweight. Agent Team join remains opt-in.
+
+### Fixed
+- **Formation duplicate detection (#94)** -- Fixed Formation resolve comparing raw Orama/BM25 ranking scores against normalized similarity thresholds. Noisy log-dump memories with high backend scores no longer discard unrelated valid memories as duplicates.
+- **TUI chat input lock** -- Fixed a regression where after a free-text chat response the bottom input bar became unresponsive because the chat overlay disabled the CommandBar. Chat overlay now keeps input active so users can continue the conversation.
+- **TUI read-only overlay input lock** -- Fixed read-only overlays such as `/doctor` disabling the CommandBar. Users can now keep typing commands or questions while diagnostics and other non-action views are open.
+- **TUI shortcut/input conflicts** -- Fixed CommandBar conflicts with view shortcuts such as Graph `f`/`k`, Memory `k`, and Knowledge `m` while still allowing normal first-character input.
+- **Graph TypeScript build issue** -- Fixed a type-only re-export under `verbatimModuleSyntax`.
+
+### Known Limitations
+- The Knowledge Base and Knowledge Graph are read-only generated projections in 1.0.9.
+- 1.0.9 does not include a desktop app, realtime agent messaging layer, GraphRAG system, graph editing, or full coding-agent harness.
+
+### Stats
+- **Verified TUI subset:** 95 passing tests across `interaction`, `workbench`, and `graph` suites.
+- **Release gates run during cleanup:** `npm run lint`, `npm run build`, and full `npm test`.
+
+## [1.0.8] - 2026-04-19
+
 ### Added -- Operator CLI Surface
 - **Namespaced operator commands** -- Added human-oriented CLI namespaces for `session`, `memory`, `reasoning`, `retention`, `formation`, `audit`, `transfer`, `skills`, `team`, `task`, `message`, `lock`, `handoff`, `poll`, `sync`, and `ingest` so Memorix-native operations no longer require raw MCP tool calls.
 - **Lightweight session start + explicit collaboration join** -- `memorix session start` now opens project-bound memory sessions without auto-registering a team identity. Operators can opt into collaboration with `--joinTeam`, or join later via `memorix team join`, while still getting default role mapping from `agentType` when they do join.

package/README.md

@@ -123,9 +123,11 @@ Deeper details on startup, project binding, config precedence, and agent workflo
 
 ![Memorix TUI Workbench](https://raw.githubusercontent.com/AVIDS2/memorix/main/assets/readme-tui-workbench.png)
 
-Running `memorix` without arguments opens an interactive fullscreen terminal UI (requires a TTY). Use it for chat with project memory, search, quick memory capture, diagnostics, background service control, dashboard launch, and IDE setup. Press `/help` inside the TUI for the current command list.
-
-Single-shot chat (no TUI): `memorix ask "your question"`.
+Running `memorix` without arguments opens an interactive fullscreen terminal UI (requires a TTY). Use it for chat with project memory, search, quick memory capture, diagnostics, background service control, dashboard launch, and IDE setup. Press `/help` inside the TUI for the current command list.
+
+In 1.0.9 the TUI is organized as a knowledge workbench with `Home`, `Knowledge`, `Memory`, `Workbench`, and `Graph` tabs. It can browse the generated Knowledge Base, inspect memory detail, jump between wiki refs and source observations, view the text Knowledge Graph, and keep chatting after answers without leaving the terminal.
+
+Single-shot chat (no TUI): `memorix ask "your question"`.
 
 ### Operator CLI
 
@@ -429,19 +431,17 @@ Additional deep references:
 
 ---
 
-## What's New in 1.0.8
-
-Version `1.0.8` builds on the 1.0.7 coordination/storage/team baseline with a CLI-first operator surface, official Docker path, dashboard refinements, and broad hooks fixes.
-
-- **CLI-First Product Surface**: Every Memorix-native operator capability now has a task-oriented CLI route — `session`, `memory`, `reasoning`, `retention`, `formation`, `audit`, `transfer`, `skills`, `team`, `task`, `message`, `lock`, `handoff`, `poll`, `sync`, `ingest`. MCP remains the integration protocol and optional graph-compatibility layer.
-- **Docker Deployment**: Official `Dockerfile`, `compose.yaml`, healthcheck, `--host` binding, and [DOCKER.md](docs/DOCKER.md) for running the HTTP control plane in a container.
-- **Multi-Agent Orchestrator**: `memorix orchestrate` runs plan, parallel execution, verification, fix, review, and merge loops across Claude, Codex, Gemini CLI, and OpenCode with capability routing, worktree isolation, and agent fallback.
-- **SQLite Canonical Store**: Observations, mini-skills, sessions, and archives in SQLite. Shared DB handle, freshness-safe retrieval, dead `JsonBackend` removed.
-- **Opt-in Agent Team**: task board, messages, file locks, handoff artifacts, and autonomous-agent heartbeat state. `session_start` is lightweight by default; team identity is opt-in via `joinTeam` or `team_manage join`.
-- **Dashboard Semantic Layering**: Team page filter tabs (Active/Recent/Historical), de-emphasized historical agents, project switcher grouped by real/temporary/placeholder, identity page cleanup.
-- **Hooks Fixes**: OpenCode event-name key mapping + `Bun.spawn` → `spawnSync`; Copilot `pwsh` fallback + global-hooks guard; hook handler diagnostic logging.
-- **Programmatic SDK**: `import { createMemoryClient } from 'memorix/sdk'` to store, search, get, and resolve observations directly from your own code without MCP or CLI. Also exports `createMemorixServer` and `detectProject`.
-- **Test Suite Stabilization**: E2e and live-LLM tests are excluded from the default suite, and load-sensitive tests are isolated so the default verification path stays deterministic.
+## What's New in 1.0.9
+
+Version `1.0.9` adds the first readable project knowledge layer and turns the terminal UI into a knowledge-native workbench.
+
+- **Knowledge Base / LLM Wiki**: Memorix now exposes a generated, readable Knowledge Base from durable observations, git facts, mini-skills, and project evidence. Raw memory remains the source of truth; the Knowledge Base is a citable synthesis for humans and agents.
+- **Semantic Knowledge Graph**: A graph projection over the same eligible knowledge inputs preserves source refs and supports concept/module/decision exploration without claiming to be GraphRAG.
+- **Tabbed TUI Workbench**: `Home`, `Knowledge`, `Memory`, `Workbench`, and `Graph` tabs replace the old scattered view model.
+- **Cross-Reference Navigation**: Jump between Knowledge items, Memory detail, and Graph nodes through stable refs where available.
+- **Explicit Session Center**: Workbench shows session state and context sources with explicit bind/end actions. It does not auto-start sessions or auto-join Agent Team.
+- **TUI Chat Usability Fixes**: Chat input remains active after assistant responses, and view shortcuts no longer steal normal CommandBar text.
+- **Architecture Boundaries**: App, realtime agent messaging, full coding-agent harness, graph editing, and GraphRAG remain outside 1.0.9 scope.
 
 ---
 

package/README.zh-CN.md

@@ -123,9 +123,11 @@ Memorix 使用两类文件：
 
 ![Memorix TUI Workbench](https://raw.githubusercontent.com/AVIDS2/memorix/main/assets/readme-tui-workbench.png)
 
-在终端中直接运行 `memorix`（不带参数）即可打开交互式全屏 TUI（需要 TTY）。它适合用于项目记忆问答、搜索、快速存储、诊断、后台服务控制、Dashboard 打开和 IDE 配置。进入 TUI 后用 `/help` 查看当前命令列表。
-
-单次聊天（不进 TUI）：`memorix ask "your question"`。
+在终端中直接运行 `memorix`（不带参数）即可打开交互式全屏 TUI（需要 TTY）。它适合用于项目记忆问答、搜索、快速存储、诊断、后台服务控制、Dashboard 打开和 IDE 配置。进入 TUI 后用 `/help` 查看当前命令列表。
+
+在 1.0.9 中，TUI 已整理成知识工作台：`Home`、`Knowledge`、`Memory`、`Workbench`、`Graph` 五个 tab。它可以浏览生成的 Knowledge Base、查看记忆详情、在 wiki refs 和源 observation 之间跳转、查看文本化 Knowledge Graph，并且在回答结束后继续保持输入可用。
+
+单次聊天（不进 TUI）：`memorix ask "your question"`。
 
 ### Operator CLI
 
@@ -427,11 +429,25 @@ Memorix 不是一条单线流水线。它从多个入口接收记忆，把内容
 - [`llms.txt`](llms.txt)
 - [`llms-full.txt`](llms-full.txt)
 
----
-
-## 1.0.8 更新亮点
-
-`1.0.8` 在 1.0.7 的多 Agent 协调 / SQLite / 团队身份基线上，进一步收成了 CLI-first operator surface、官方 Docker 路径、Dashboard 语义分层和大量 Hooks 修复。
+---
+
+## 1.0.9 更新亮点
+
+`1.0.9` 增加了第一版可读项目知识层，并把终端 UI 收束为 knowledge-native workbench。
+
+- **Knowledge Base / LLM Wiki**：Memorix 现在可以从 durable observations、Git facts、mini-skills 和项目证据生成可读的 Knowledge Base。Raw memory 仍是事实来源；Knowledge Base 是给人和 agent 使用的可引用综合层。
+- **Semantic Knowledge Graph**：基于同一批 eligible knowledge inputs 生成语义图谱投影，保留 source refs，支持围绕概念、模块和决策探索，但不把它包装成 GraphRAG。
+- **Tabbed TUI Workbench**：`Home`、`Knowledge`、`Memory`、`Workbench`、`Graph` 五个 tab 替代旧的分散视图模型。
+- **跨引用导航**：可通过稳定 refs 在 Knowledge item、Memory detail 和 Graph node 之间跳转。
+- **显式 Session Center**：Workbench 展示 session 状态和上下文来源，bind/end 都是显式动作；进入 tab 不会自动 start session，也不会自动 join Agent Team。
+- **TUI Chat 可用性修复**：assistant 回复后输入框保持可用；Graph/Memory/Knowledge 的视图快捷键不再吞掉正常 CommandBar 输入。
+- **架构边界**：desktop app、realtime agent messaging、完整 coding-agent harness、graph editing 和 GraphRAG 都不属于 1.0.9 范围。
+
+---
+
+## 1.0.8 更新亮点
+
+`1.0.8` 在 1.0.7 的多 Agent 协调 / SQLite / 团队身份基线上，进一步收成了 CLI-first operator surface、官方 Docker 路径、Dashboard 语义分层和大量 Hooks 修复。
 
 - **CLI-First 产品面**：所有 Memorix 原生能力都已经有面向人的 CLI 路径 — `session`、`memory`、`reasoning`、`retention`、`formation`、`audit`、`transfer`、`skills`、`team`、`task`、`message`、`lock`、`handoff`、`poll`、`sync`、`ingest`。MCP 保留为标准接入协议和可选 graph-compatibility 层。
 - **Docker 部署**：官方 `Dockerfile`、`compose.yaml`、健康检查、`--host` 绑定，详见 [DOCKER.md](docs/DOCKER.md)。