Skip to content

0.10.3

Choose a tag to compare

View all tags
@github-actions github-actions released this 01 Aug 15:39
· 34 commits to main since this release
v0.10.3
1f6f029

Stela v0.10.3

English

Highlights

  • Reusable SQL templates — Create Vault-scoped SQL templates as Markdown and insert them directly into RunSQL blocks. Templates support
    {{variable}} placeholders, linked editing, keyboard navigation, and optional connection metadata.
  • Persistent Agent session history — Agent conversations now survive app restarts through device-sharded JSONL history stored in the Vault. Sessions
    from another device remain read-only until continued as a new local fork.
  • Agent execution plans — For multi-step analysis, the Agent can maintain and display a structured execution plan, making progress and remaining
    work easier to follow.
  • Live database schema authority — Agent table search and schema inspection now use the live connector instead of potentially stale schema
    snapshots. Connectors can also provide column descriptions and comments through the new optional describeTables capability.
  • More efficient Vault watching — Stela now uses a native recursive watcher, reducing filesystem resource usage and improving shutdown behavior for
    larger Vaults.

Improvements

  • Agent answers are more concise by default while retaining the key evidence needed to verify a result.
  • Agent tool activity and execution-plan progress are presented more clearly in the Agent panel.
  • Automatic Skill maintenance is now evidence-gated, create-only, and limited to concise reusable knowledge.
  • Skill distillation can use related SQL usage and favors recently updated Vault documentation when historical guidance conflicts.
  • SQL templates are stored under .stela/sql-templates/, remain Git-friendly, and do not appear as ordinary notes or pollute SQL usage search.
  • Added keyboard shortcuts for opening the template picker and navigating template variables.
  • Improved Windows CI compatibility and expanded automated coverage for Agent history, execution plans, schema resolution, Skills, Vault watching, and
    SQL templates.

Upgrade Notes

No manual migration is required.

Agent history created after upgrading is stored under .stela/agent-history/<device>/ and follows the Vault through Git. Stela retains the 20 most
recently updated Agent sessions for each device.

SQL templates are stored under .stela/sql-templates/. This directory is created when templates are added.

中文

重点更新

  • 可复用 SQL 模板 —— 可以在 Vault 中以 Markdown 创建 SQL 模板，并直接插入 RunSQL 代码块。模板支持 {{variable}} 变量、同名变量联动编辑、键盘切换以
    及可选的连接信息。
  • Agent 会话历史持久化 —— Agent 对话现在可在应用重启后恢复。历史以设备分片的 JSONL 文件保存在 Vault 中；来自其他设备的会话保持只读，继续对话时会创建
    新的本机会话分支。
  • Agent 执行计划 —— 进行多步骤分析时，Agent 可以维护并展示结构化执行计划，让当前进度和剩余工作更加清晰。
  • 实时数据库 Schema 权威 —— Agent 的表搜索和结构读取现在以实时连接为准，不再依赖可能过期的 schema 快照。连接器还可通过新的可选 describeTables 能力
    提供字段描述和注释。
  • 更高效的 Vault 文件监听 —— Stela 改用原生递归文件监听，降低大型 Vault 的文件系统资源占用，并改善应用退出速度。

改进

  • Agent 默认输出更加简洁，同时保留验证结果所需的关键依据。
  • Agent 面板可以更清楚地展示工具调用和执行计划进度。
  • 自动 Skill 维护现在必须基于实际工具证据，仅创建新 Skill，并限制为简洁、可复用的知识。
  • Skill 提炼可以参考相关 SQL 使用记录；历史说明发生冲突时，优先采用最近更新的 Vault 文档。
  • SQL 模板保存在 .stela/sql-templates/，便于 Git 同步，同时不会显示为普通笔记或干扰 SQL 用法检索。
  • 新增打开模板选择器及切换模板变量的键盘快捷键。
  • 改善 Windows CI 兼容性，并扩充 Agent 历史、执行计划、Schema 解析、Skills、Vault 监听及 SQL 模板的自动化测试。

升级说明

本次升级无需手动迁移。

升级后产生的 Agent 历史会保存在 .stela/agent-history/<设备>/，并随 Vault 通过 Git 同步。每台设备默认保留最近更新的 20 个 Agent 会话。

SQL 模板保存在 .stela/sql-templates/，首次添加模板时会创建该目录。

Review 结论：发布范围里没有需要声明的破坏性数据迁移。需要特别告知用户的行为变化主要是 Agent 历史会进入 Vault/Git，以及每台设备保留最近 20 个会话。

ADRs：none。
Docs：新增双语 release note 模板。
验证：git diff --check 通过；当前干净分支没有 npm run checks 脚本。

Assets 10
Loading