Skip to content

v0.3.4

Choose a tag to compare

View all tags
@github-actions github-actions released this 13 Jun 13:32
· 272 commits to main since this release
v0.3.4
eeebbdb

Release Notes: BabeL-O v0.3.4

BabeL-O v0.3.4 is a runtime stability and distribution-readiness release. It keeps the Go TUI as the production interactive entrypoint, adds a user-facing memory management surface, and hardens long-session recovery, session replay, tool evidence, context compaction, and installer self-checks.

English

Overview

Use the production Go TUI entrypoint:

bbl go

v0.3.4 focuses on making that path more dependable after long sessions, panel transitions, provider retries, compact/replay cycles, and fresh installations on another machine.

Highlights

  1. Memory management surface

    • /memory now exposes runtime-owned memory status in the Go TUI.
    • Read-only memory search returns bounded hints and keeps project facts non-authoritative until workspace evidence confirms them.
    • Memory candidates are review-only by default.
    • save-note, flush, and lifecycle-style actions require explicit approval and never run silently.

  2. Session replay and evidence governance

    • SQLite event ordering now preserves append order for same-timestamp events.
    • Provider replay repairs completed-before-started tool pairs and rejects invalid OpenAI-compatible orphan tool results before sending a provider request.
    • Read evidence caching is coverage-aware, so partial file reads are no longer reused as full-file evidence.
    • Read now supports explicit lineOffset / lineLimit and byteOffset / byteLimit ranges with clearer shownBytes / shownLines diagnostics.
    • Grep pathMatches supports multiple file globs and reports malformed boolean-string glob input as recoverable guidance.

  3. Generalized agent behavior routing

    • User intake routing now persists structured problemTarget and Turn Policy fields rather than dynamic natural-language guidance.
    • New user_intake_guidance events no longer persist natural-language guidance payloads; old events remain readable for compatibility.
    • Self-diagnosis and capability answers are governed through structured policy and static evidence rules instead of hardcoded Chinese/English prompt snippets.
    • evidenceMode=verify_before_claim keeps verified observations, code-confirmed causes, and hypotheses distinct.

  4. Timeout and recovery stability

    • Near-timeout and soft-timeout events replay as convergence constraints so the model can summarize, narrow, or do one bounded final check instead of continuing broad discovery.
    • Context compact/restore metadata has stronger retained-segment validation and legacy compatibility.
    • Wrapped terminal paths such as split markdown filenames are normalized before path extraction without merging ordinary prose bullets.

  5. Go TUI polish and panel stability

    • Context, model, session, tool, and memory overlays are designed to render above the prompt area and avoid truncation.
    • Prompt height and panel exit paths were tightened after /model and /context transitions.
    • Tool rows, Bash display, activity lines, footer hints, and slash-command overlays received consistency fixes.
    • Mouse selection, wheel input, multi-line input, and clipboard feedback remain part of the stabilized Go TUI path.

  6. Distribution and installer hardening

    • The release workflow publishes both standalone bbl-* binaries and matching go-tui-* binaries on the same tag.
    • scripts/install.sh validates release assets before installing them and treats missing Go TUI assets as an install failure by default.
    • On macOS, the installer installs a shell launcher that routes bbl go directly to the installed Go TUI and avoids the known Node SEA spawn path for the TUI.
    • The installer runs an end-to-end self-check after installation: Go TUI --version plus bbl go --check --no-start-nexus.

Installation

Install the latest release binary on macOS or Linux:

curl -fsSL https://raw.githubusercontent.com/SuTang-vain/BabeL-O/main/scripts/install.sh | bash
bbl go

Install this release explicitly:

curl -fsSL https://raw.githubusercontent.com/SuTang-vain/BabeL-O/main/scripts/install.sh | BBL_VERSION=v0.3.4 bash
bbl go

Expected v0.3.4 release assets:

Quick Reference

bbl go                           # Start the production Go TUI
bbl go --check                   # Verify Go TUI install readiness
bbl run <prompt>                 # Run a one-shot prompt task
bbl sessions list                # List persisted sessions
bbl sessions inspect <sessionId> # Inspect one session
bbl tools audit                  # Review tool audit history

Release Verification

Before tagging this release, verify at minimum:

  • npm run typecheck
  • npm run format:check
  • npm run build
  • npm run build:binary
  • ./dist/bbl --version
  • ./dist/bbl go --check --no-start-nexus
  • npm run test:go-tui
  • cd clients/go-tui && make build && ./bin/go-tui --version
  • installer smoke with BBL_INSTALL_DIR and BBL_VERSION=v0.3.4 after the release assets are uploaded

简体中文

版本概述

正式交互入口仍然是：

bbl go

v0.3.4 重点修复长 session、面板切换、provider retry、context compact/replay、跨机器安装后的稳定性问题，并补齐用户可见的记忆管理入口。

主要更新

  1. 记忆管理面板

    • Go TUI 新增 /memory 运行时记忆状态面板。
    • 只读记忆搜索返回受限 hint；项目事实仍必须由 workspace evidence 验证。
    • 记忆候选默认是 review-only。
    • save-note、flush 和生命周期类操作必须显式确认，不会静默写入或重启。

  2. Session replay 与证据治理

    • SQLite event ordering 使用 append order 处理同时间戳事件。
    • provider replay 可修复 completed-before-started tool pair，并在发送 OpenAI-compatible 请求前拒绝 orphan tool result。
    • Read cache 改为 coverage-aware，partial file read 不再被复用为 full-file evidence。
    • Read 支持 lineOffset / lineLimit 与 byteOffset / byteLimit，并输出更清晰的 shownBytes / shownLines 诊断。
    • Grep pathMatches 支持多个 file glob，并对 boolean-string glob 这类错误输入返回 recoverable guidance。

  3. 泛化 agent 行为路由

    • User intake routing 改为持久化结构化 problemTarget 与 Turn Policy 字段，不再依赖动态自然语言 guidance。
    • 新写入的 user_intake_guidance 事件不再持久化自然语言 guidance payload；旧事件仍可兼容读取。
    • 自诊断与能力问答由结构化 policy 和静态证据规则治理，不再注入硬编码中英文提示片段。
    • evidenceMode=verify_before_claim 会要求区分 verified observations、code-confirmed causes 与 hypotheses。

  4. Timeout 与恢复稳定性

    • near-timeout / soft-timeout 事件在 provider replay 中会成为收敛约束，避免继续 broad discovery。
    • context compact/restore 的 retained segment 校验更强，并兼容旧 metadata。
    • terminal-wrapped path 会先被受限归一化，避免被换行截断，同时不合并普通 prose bullet。

  5. Go TUI 面板与交互稳定性

    • context、model、session、tool、memory overlay 都按输入框上方显示的设计修复截断问题。
    • /model 与 /context 退出后的输入框高度和布局恢复路径进一步加固。
    • 工具行、Bash 显示、activity line、footer hint 和 slash overlay 做了统一修复。
    • 鼠标选择、滚轮输入、多行输入、复制提示继续作为正式 Go TUI 路径的一部分。

  6. 分发与安装加固

    • release workflow 会在同一个 tag 上传 bbl-* 与匹配的 go-tui-* 资产。
    • scripts/install.sh 会先验证 release asset，默认把缺失 Go TUI 资产视为安装失败。
    • macOS 安装器会生成 shell launcher，让 bbl go 直接走已安装的 Go TUI，避开 Node SEA 启动 TUI 的已知风险路径。
    • 安装结束会运行端到端自检：Go TUI --version 与 bbl go --check --no-start-nexus。

安装方式

macOS 或 Linux 安装最新发布二进制：

curl -fsSL https://raw.githubusercontent.com/SuTang-vain/BabeL-O/main/scripts/install.sh | bash
bbl go

显式安装本版本：

curl -fsSL https://raw.githubusercontent.com/SuTang-vain/BabeL-O/main/scripts/install.sh | BBL_VERSION=v0.3.4 bash
bbl go

v0.3.4 预期发布资产：

命令速查

bbl go                           # 启动正式 Go TUI
bbl go --check                   # 检查 Go TUI 安装可用性
bbl run <prompt>                 # 执行一次性 prompt 任务
bbl sessions list                # 列出持久化 session
bbl sessions inspect <sessionId> # 查看指定 session
bbl tools audit                  # 查看工具审计历史

发布验证

发布 tag 前至少验证：

  • npm run typecheck
  • npm run format:check
  • npm run build
  • npm run build:binary
  • ./dist/bbl --version
  • ./dist/bbl go --check --no-start-nexus
  • npm run test:go-tui
  • cd clients/go-tui && make build && ./bin/go-tui --version
  • release assets 上传后，用 BBL_INSTALL_DIR 与 BBL_VERSION=v0.3.4 做 installer smoke
Assets 10
Loading