actoviq-agent-sdk 0.4.9 → 0.4.11

package/CHANGELOG.md

@@ -6,6 +6,27 @@ The format is based on Keep a Changelog, with automated updates from GitHub Rele
 
 ## Unreleased
 
+## v0.4.10 - 2026-07-31
+
+### Product / docs
+
+- Rebrand the product, repository, CLIs, GUI, and config paths from **Actoviq** to **Hadamard** (`hadamard-*`, `~/.hadamard`, project-local `.hadamard/`). The published npm package name remains **`actoviq-agent-sdk`**.
+- Migrate legacy `~/.actoviq` and project-local `.actoviq/` into the new Hadamard paths on first use.
+- Point GitHub Pages / VitePress at `/hadamard/` with Hadamard branding; clarify package-vs-product naming in README.
+
+### GUI
+
+- Do not auto-register the process cwd / install / source tree as a Project on bare GUI launch. First open shows an empty Projects list until the user opens or creates one.
+
+### Sandbox / CI
+
+- Harden OS sandbox adapters: honor `enforcement: 'off'`, keep host tool PATH roots readable, and use allow-default write isolation on macOS seatbelt so CI (including macOS) stays usable.
+
+### Notes
+
+- This release stays on the **0.4.x** line. **1.0.0 is not published yet.**
+- GitHub repository: https://github.com/DeconBear/hadamard — docs: https://deconbear.github.io/hadamard/
+
 ## v0.4.9 - 2026-07-30
 
 ### Platform
@@ -31,7 +52,7 @@ The format is based on Keep a Changelog, with automated updates from GitHub Rele
 
 ### Bridge / tests / CI
 
-- Add regression coverage for consecutive `ActoviqBridgeSession.stream()` calls so the second turn uses `--resume` (GitHub #8).
+- Add regression coverage for consecutive `HadamardBridgeSession.stream()` calls so the second turn uses `--resume` (GitHub #8).
 - Harden GUI publish update-metadata validation (`workflow_dispatch` may rebuild an existing tag with the current builder).
 
 ### Notes
@@ -124,12 +145,12 @@ The format is based on Keep a Changelog, with automated updates from GitHub Rele
 
 - **Subagent infrastructure**: `Agent`/`Task` tool with Task compatibility alias, persistent sessions, and `SendMessage` continuation
 - **Background agents**: automatic completion notifications, progress tracking, cancellation, and lifecycle reconciliation
-- **Markdown agent definitions**: user-level (`~/.actoviq/agents/`) and project-level (`.actoviq/agents/`) `.md` files with tool/skill/permission/MCP/effort controls
+- **Markdown agent definitions**: user-level (`~/.hadamard/agents/`) and project-level (`.hadamard/agents/`) `.md` files with tool/skill/permission/MCP/effort controls
 - **Worktree isolation**: `isolation: "worktree"` for parallel agents editing overlapping files; dirty worktrees retained, clean ones auto-removed
 - **Nested delegation controls**: configurable depth limit (`maxSubagentDepth`), fanout limit (`maxSubagentFanout`), and per-definition allowed agents
 - **Built-in agent definitions**: Explore, Plan, and general-purpose agents with Claude Code-compatible profiles
 - **Windows Bash tool**: now uses Git Bash for POSIX commands on Windows
-- **TUI**: full-screen terminal UI (`actoviq-tui`) with session management, permission mode switching, and provider configuration
+- **TUI**: full-screen terminal UI (`hadamard-tui`) with session management, permission mode switching, and provider configuration
 - **Model tiers**: `min`/`medium`/`max` tier resolution with `ACTVIQ_DEFAULT_{TIER}_MODEL` env vars
 - **Enhanced Agent tool prompt**: Claude Code-level subagent guidance (foreground/background, parallel delegation, "never delegate understanding")
 
@@ -140,7 +161,7 @@ The format is based on Keep a Changelog, with automated updates from GitHub Rele
 - Background task `cancel()`: re-reads store after abort to prevent TOCTOU race with terminal state
 - `forwardStreamResult`: captures both pump and result errors instead of silently losing one
 - Agent definition loader: logs a warning for malformed `.md` files instead of silently skipping them
-- `encodeActoviqProjectPath` test made platform-aware (was hardcoded to Windows paths)
+- `encodeHadamardProjectPath` test made platform-aware (was hardcoded to Windows paths)
 
 ### Benchmark
 
@@ -151,17 +172,17 @@ The format is based on Keep a Changelog, with automated updates from GitHub Rele
 
 ### TUI Branding
 
-- Display name changed from `Actoviq TUI` to `Hadamard Agent` (3 visible strings; all internal names, env vars, and config paths unchanged)
+- Display name changed from `Hadamard TUI` to `Hadamard Agent` (3 visible strings; all internal names, env vars, and config paths unchanged)
 
-**Full Changelog**: https://github.com/DeconBear/actoviq-agent-sdk/compare/v0.3.1...v0.4.0
+**Full Changelog**: https://github.com/DeconBear/hadamard/compare/v0.3.1...v0.4.0
 
 ## v0.3.1 - 2026-06-11
 
-**Full Changelog**: https://github.com/DeconBear/actoviq-agent-sdk/compare/v0.3.0...v0.3.1
+**Full Changelog**: https://github.com/DeconBear/hadamard/compare/v0.3.0...v0.3.1
 
 ## v0.3.0 - 2026-05-11
 
-**Full Changelog**: https://github.com/DeconBear/actoviq-agent-sdk/commits/v0.3.0
+**Full Changelog**: https://github.com/DeconBear/hadamard/commits/v0.3.0
 
 ## v0.2.0 - 2026-05-08
 
@@ -194,61 +215,61 @@ The format is based on Keep a Changelog, with automated updates from GitHub Rele
 
 - Added `workflow-annotated.ts` — annotated walkthrough of every API parameter
 - Added `workflow-agent-orchestration.ts` — Agent autonomously designs and executes workflows
-- Added `actoviq-platform.ts` — consolidated workspaces + swarm + session memory + dream
+- Added `hadamard-platform.ts` — consolidated workspaces + swarm + session memory + dream
 - Removed 8 redundant examples (buddy, computer-use, dream, memory, session-memory, skills, swarm, workspaces)
 - 12 focused examples remaining
 
 ### Fixes
 
 - 18 bugs across provider layer, runtime, and workflow engine
-- Missing public API exports (trackRecentFile, resolveActoviqStopHooks, etc.)
+- Missing public API exports (trackRecentFile, resolveHadamardStopHooks, etc.)
 
 ### Internal
 
 - Fixed regex for hyphenated step IDs in variable interpolation (`\w+` → `[\w-]+`)
 - Defensive `?.` checks on optional `dependsOn` and `steps` fields across workflow engine
-- `getTool()` public method on `ActoviqAgentClient` for tool registry lookup
+- `getTool()` public method on `HadamardAgentClient` for tool registry lookup
 
 ## v0.1.12 - 2026-05-06
 
-**Full Changelog**: https://github.com/DeconBear/actoviq-agent-sdk/compare/v0.1.11...v0.1.12
+**Full Changelog**: https://github.com/DeconBear/hadamard/compare/v0.1.11...v0.1.12
 
 ## v0.1.11 - 2026-04-04
 
-**Full Changelog**: https://github.com/DeconBear/actoviq-agent-sdk/compare/v0.1.9...v0.1.11
+**Full Changelog**: https://github.com/DeconBear/hadamard/compare/v0.1.9...v0.1.11
 
 ## v0.1.10 - 2026-04-03
 
-**Full Changelog**: https://github.com/DeconBear/actoviq-agent-sdk/compare/v0.1.9...v0.1.10
+**Full Changelog**: https://github.com/DeconBear/hadamard/compare/v0.1.9...v0.1.10
 
 ## v0.1.9 - 2026-04-03
 
-**Full Changelog**: https://github.com/DeconBear/actoviq-agent-sdk/compare/v0.1.8...v0.1.9
+**Full Changelog**: https://github.com/DeconBear/hadamard/compare/v0.1.8...v0.1.9
 
 ## v0.1.8 - 2026-04-03
 
-**Full Changelog**: https://github.com/DeconBear/actoviq-agent-sdk/compare/v0.1.7...v0.1.8
+**Full Changelog**: https://github.com/DeconBear/hadamard/compare/v0.1.7...v0.1.8
 
 ## v0.1.7 - 2026-04-02
 
-**Full Changelog**: https://github.com/DeconBear/actoviq-agent-sdk/compare/v0.1.6...v0.1.7
+**Full Changelog**: https://github.com/DeconBear/hadamard/compare/v0.1.6...v0.1.7
 
 ## v0.1.6 - 2026-04-02
 
-**Full Changelog**: https://github.com/DeconBear/actoviq-agent-sdk/compare/v0.1.5...v0.1.6
+**Full Changelog**: https://github.com/DeconBear/hadamard/compare/v0.1.5...v0.1.6
 
 ## v0.1.5 - 2026-04-02
 
-**Full Changelog**: https://github.com/DeconBear/actoviq-agent-sdk/compare/v0.1.4...v0.1.5
+**Full Changelog**: https://github.com/DeconBear/hadamard/compare/v0.1.4...v0.1.5
 
 ## v0.1.4 - 2026-04-02
 
-**Full Changelog**: https://github.com/DeconBear/actoviq-agent-sdk/compare/v0.1.3...v0.1.4
+**Full Changelog**: https://github.com/DeconBear/hadamard/compare/v0.1.3...v0.1.4
 
 ## v0.1.3 - 2026-04-01
 
-**Full Changelog**: https://github.com/DeconBear/actoviq-agent-sdk/compare/v0.1.2...v0.1.3
+**Full Changelog**: https://github.com/DeconBear/hadamard/compare/v0.1.2...v0.1.3
 
 ## v0.1.2 - 2026-04-01
 
-**Full Changelog**: https://github.com/DeconBear/actoviq-agent-sdk/compare/v0.1.1...v0.1.2
+**Full Changelog**: https://github.com/DeconBear/hadamard/compare/v0.1.1...v0.1.2

package/README-zh.md

@@ -1,19 +1,21 @@
-# Actoviq Agent SDK
+# Hadamard Agent SDK
 
-[![CI](https://github.com/DeconBear/actoviq-agent-sdk/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/DeconBear/actoviq-agent-sdk/actions/workflows/ci.yml)
-[![Publish npm Package](https://github.com/DeconBear/actoviq-agent-sdk/actions/workflows/publish-npm.yml/badge.svg?branch=main)](https://github.com/DeconBear/actoviq-agent-sdk/actions/workflows/publish-npm.yml)
+[![CI](https://github.com/DeconBear/hadamard/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/DeconBear/hadamard/actions/workflows/ci.yml)
+[![Publish npm Package](https://github.com/DeconBear/hadamard/actions/workflows/publish-npm.yml/badge.svg?branch=main)](https://github.com/DeconBear/hadamard/actions/workflows/publish-npm.yml)
 [![npm version](https://img.shields.io/npm/v/actoviq-agent-sdk)](https://www.npmjs.com/package/actoviq-agent-sdk)
-[![Docs](https://img.shields.io/badge/docs-github%20pages-0f766e)](https://deconbear.github.io/actoviq-agent-sdk/)
+[![Docs](https://img.shields.io/badge/docs-github%20pages-0f766e)](https://deconbear.github.io/hadamard/)
 
 [English](./README.md) | [中文](./README-zh.md)
 
-文档站地址：https://deconbear.github.io/actoviq-agent-sdk/
+文档站地址：https://deconbear.github.io/hadamard/
 
-**Actoviq**（`0.4.x`）是 TypeScript agent SDK 与 agent-team 平台，含 TUI、GUI、Bridge 与多 agent 协作。未来的 **1.0** 线将稳定 package subpath 契约；该表面**尚未发布**。
+**Hadamard**（`0.4.x`）是 TypeScript agent SDK 与 agent-team 平台，含 TUI、GUI、Bridge 与多 agent 协作。未来的 **1.0** 线将稳定 package subpath 契约；该表面**尚未发布**。
+
+> **包名说明：** npm 发布名仍为 [`actoviq-agent-sdk`](https://www.npmjs.com/package/actoviq-agent-sdk)。产品、仓库、CLI 与配置路径统一为 **Hadamard**（`hadamard-*`、`~/.hadamard`、`.hadamard/`）。
 
 > **说明：** 桌面端 **Agent graph** 编排 UI（可视化团队 / 图编辑器）**仍在持续迭代与优化中**，交互与行为可能变化。生产工作流请优先使用 `/team`、已保存的 team 定义，以及 SDK 的 `createTeam()` / graph runtime。详见 `CHANGELOG.md`。
 
-受 Claude Code、Codex、Deepagents 等项目启发。Actoviq 保持独立，拥有自己的公开 API 与文档。
+受 Claude Code、Codex、Deepagents 等项目启发。Hadamard 保持独立，拥有自己的公开 API 与文档。
 
 ## 愿景
 
@@ -24,11 +26,11 @@
 ## 亮点
 
 - **Model Team** — `panel-analysis`（并行调查 + 收敛）和 `reviewer`（只报告可验证问题的审计者）。runtime-owned 成员池、流式 `TeamEvent`、成员 provider 配置，以及继承的权限/重试边界。
-- **Model Router / Leader-Dispatch** — 每轮由 leader 分派到最佳 specialist（任意模型/提供商），执行者自身也可召集 team。Profile 位于 `~/.actoviq/routers/`。
+- **Model Router / Leader-Dispatch** — 每轮由 leader 分派到最佳 specialist（任意模型/提供商），执行者自身也可召集 team。Profile 位于 `~/.hadamard/routers/`。
 - **Dynamic Workflows** — 显式信任等级的 JS 编排：trusted 兼容执行、隔离 local-process，或由 host 提供的远程/container 强 sandbox；local process 不宣传为对抗性多租户沙箱。
 - **Bridge（命名运行时配置）** — 可选 `Direct API` 做 provider/API 级复用，也可选 `External CLI` 直接启动已安装的 Claude Code、Codex、Pi、CodeWhale、Reasonix 或 Crush，继承各 CLI 的原生登录和配置、流式显示规范化后的工具与回答事件、终止后台任务，并浏览/恢复受支持的原生会话。单独填写的 key 只注入子进程，不写入 CLI 的凭据库；Pi、CodeWhale、Reasonix 与 Crush 会使用按配置隔离的持久会话目录，因此 key 模式重启后仍可读取历史，同时不会读取原生登录凭据。
-- **桌面 GUI (`actoviq-gui`)** — Electron 聊天 UI：流式 transcript、对话历史、命令面板、设置、每工具权限提示。安全增强。全局 **Assistant** FAB（Global/Project 作用域）。可视化 **Agent graph** 编排 UI 仍在迭代中，暂勿当作稳定产品面。
-- **TUI (`actoviq-tui`)** — 终端 UI，25+ 斜杠命令，Claude Code 风格 UX：`/team`、`/bridge`、`/plan`、`/hooks`、`/mcp`、`/review`、`/context`、`/cost`、`/doctor` 等。实时状态旋转器、滚动 transcript、todo 面板、项目/用户级权限对话框、子命令自动补全。
+- **桌面 GUI (`hadamard-gui`)** — Electron 聊天 UI：流式 transcript、对话历史、命令面板、设置、每工具权限提示。安全增强。全局 **Assistant** FAB（Global/Project 作用域）。可视化 **Agent graph** 编排 UI 仍在迭代中，暂勿当作稳定产品面。
+- **TUI (`hadamard-tui`)** — 终端 UI，25+ 斜杠命令，Claude Code 风格 UX：`/team`、`/bridge`、`/plan`、`/hooks`、`/mcp`、`/review`、`/context`、`/cost`、`/doctor` 等。实时状态旋转器、滚动 transcript、todo 面板、项目/用户级权限对话框、子命令自动补全。
 - **计划模式 + hooks** — `EnterPlanMode`/`ExitPlanMode` 工具 + 计划文件；`settings.json` 中的 `PreToolUse`/`PostToolUse`/`SessionStart` hooks。
 - **Worktree 工具** — `EnterWorktree`/`ExitWorktree`，栈式 cwd，`.worktreeinclude`，PR checkout。
 - **TavilySearch** — AI 优化网络搜索，纯 TypeScript。
@@ -63,7 +65,7 @@ npm install actoviq-agent-sdk zod
 本地使用，请将配置放在：
 
 ```text
-~/.actoviq/settings.json
+~/.hadamard/settings.json
 ```
 
 也可以使用 `loadJsonConfigFile(...)` 预加载自定义 JSON 文件。
@@ -100,28 +102,20 @@ try {
 运行仓库示例：
 
 ```bash
-npm run example:actoviq-quickstart
-npm run example:actoviq-agent-helpers
+npm run example:hadamard-quickstart
+npm run example:hadamard-agent-helpers
 npm run example:profiles
 ```
 
-## CLI REPL
-
-安装包后，可以直接从终端启动交互式 scrollback 模式 REPL：
-
-```bash
-npx actoviq-react [工作目录]
-```
-
 ## 终端 UI (TUI)
 
-`actoviq-tui` 是全功能终端 UI，模拟 Claude Code 的 REPL 设计:
+`hadamard-tui` 是唯一的交互式终端 Agent 入口，也是全功能终端 UI：
 
 ```bash
-npx actoviq-tui [工作目录] [选项]
+npx hadamard-tui [工作目录] [选项]
 
 # 选项
-#   --config <路径>            加载指定的 Actoviq 设置 JSON 文件
+#   --config <路径>            加载指定的 Hadamard 设置 JSON 文件
 #   --permission-mode <模式>   default | acceptEdits | plan | bypassPermissions (默认)
 #   --model <模型>             覆盖已配置的模型
 #   --resume <会话ID>          恢复已存储的 Hadamard SDK 会话
@@ -130,19 +124,19 @@ npx actoviq-tui [工作目录] [选项]
 
 特性与英文 README 一致，包括上下文管理（append-only 前缀以利于 DeepSeek 等自动缓存；超阈值走整段摘要 compact）、bridge config、计划模式、hooks、MCP、诊断等。六种 External CLI 都可使用 `/bridge status`、`/bridge background`、`/bridge runs` 和 `/bridge stop`；`/bridge history` 与 `/bridge resume` 在 TUI 和 GUI 中共享同一套校验逻辑，但原生历史/恢复能力仍取决于已安装 CLI 的协议与版本。
 
-## 桌面 GUI (`actoviq-gui`)
+## 桌面 GUI (`hadamard-gui`)
 
 ```bash
-npx actoviq-gui [工作目录] [选项]
+npx hadamard-gui [工作目录] [选项]
 ```
 
 - Project 详情提供 `Document` / `Issues` 双 Tab。Issue 支持优先级、标签、验收标准、评论，以及受守卫保护的 `backlog → todo → in_progress → in_review/blocked → done` 生命周期。
 - **Agent graph 编排 UI**（GUI **Agent** 区域的可视化团队/图编辑器）**仍在持续迭代和优化中**，请勿当作已定稿产品面；稳定工作流请用已保存 team + `/team` / SDK API。
 - Settings → Models & routing 可创建 Agent Profile，将 bridge config 与模型绑定。`/issues start <id> [agent-profile]` 会先让 Project Manager 生成任务书，再创建关联会话；执行 agent 通过 `IssueReport` 汇报待审或阻塞状态。
-- Issue 与会话可双向跳转。Issue 默认保存在 `<data-root>/projects/<workspace-key>/issues.json`，也可切换到受保护的工作区文件 `.actoviq/issues.json`。
+- Issue 与会话可双向跳转。Issue 默认保存在 `<data-root>/projects/<workspace-key>/issues.json`，也可切换到受保护的工作区文件 `.hadamard/issues.json`。
 - Settings → General 可将完整数据根目录迁移到空目录：复制并校验数据、写入 bootstrap 指针、重建 SDK/session store，并保留旧目录供手动清理。
 
-数据根目录解析优先级为：显式 SDK `homeDir` → `ACTOVIQ_HOME` → `~/.actoviq/data-root.json` → `~/.actoviq`。
+数据根目录解析优先级为：显式 SDK `homeDir` → `HADAMARD_HOME` → `~/.hadamard/data-root.json` → `~/.hadamard`。
 
 ## 开发者笔记
 
@@ -155,12 +149,12 @@ npx actoviq-gui [工作目录] [选项]
 
 - 英文教程：[docs/en/README.md](./docs/en/README.md)
 - 中文教程：[docs/zh/README.md](./docs/zh/README.md)
-- GitHub Pages 文档站：https://deconbear.github.io/actoviq-agent-sdk/
+- GitHub Pages 文档站：https://deconbear.github.io/hadamard/
 
 入口示例：
-- [examples/actoviq-quickstart.ts](./examples/actoviq-quickstart.ts)
-- [examples/actoviq-workflow.ts](./examples/actoviq-workflow.ts)
-- [examples/actoviq-agent-helpers.ts](./examples/actoviq-agent-helpers.ts)
+- [examples/hadamard-quickstart.ts](./examples/hadamard-quickstart.ts)
+- [examples/hadamard-workflow.ts](./examples/hadamard-workflow.ts)
+- [examples/hadamard-agent-helpers.ts](./examples/hadamard-agent-helpers.ts)
 - [examples/profiles/all-profiles.ts](./examples/profiles/all-profiles.ts)
 
 架构与运维文档：

package/README.md

@@ -1,19 +1,21 @@
-# Actoviq Agent SDK
+# Hadamard Agent SDK
 
-[![CI](https://github.com/DeconBear/actoviq-agent-sdk/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/DeconBear/actoviq-agent-sdk/actions/workflows/ci.yml)
-[![Publish npm Package](https://github.com/DeconBear/actoviq-agent-sdk/actions/workflows/publish-npm.yml/badge.svg?branch=main)](https://github.com/DeconBear/actoviq-agent-sdk/actions/workflows/publish-npm.yml)
+[![CI](https://github.com/DeconBear/hadamard/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/DeconBear/hadamard/actions/workflows/ci.yml)
+[![Publish npm Package](https://github.com/DeconBear/hadamard/actions/workflows/publish-npm.yml/badge.svg?branch=main)](https://github.com/DeconBear/hadamard/actions/workflows/publish-npm.yml)
 [![npm version](https://img.shields.io/npm/v/actoviq-agent-sdk)](https://www.npmjs.com/package/actoviq-agent-sdk)
-[![Docs](https://img.shields.io/badge/docs-github%20pages-0f766e)](https://deconbear.github.io/actoviq-agent-sdk/)
+[![Docs](https://img.shields.io/badge/docs-github%20pages-0f766e)](https://deconbear.github.io/hadamard/)
 
 [English](./README.md) | [Chinese](./README-zh.md)
 
-Documentation site: https://deconbear.github.io/actoviq-agent-sdk/
+Documentation site: https://deconbear.github.io/hadamard/
 
-**Actoviq** (`0.4.x`) is a TypeScript agent SDK and agent-team platform with TUI, GUI, Bridge, and multi-agent collaboration. A future **1.0** line will stabilize package subpath contracts; that surface is **not published yet**.
+**Hadamard** (`0.4.x`) is a TypeScript agent SDK and agent-team platform with TUI, GUI, Bridge, and multi-agent collaboration. A future **1.0** line will stabilize package subpath contracts; that surface is **not published yet**.
+
+> **Package name:** the published npm package remains [`actoviq-agent-sdk`](https://www.npmjs.com/package/actoviq-agent-sdk). Product, repo, CLI, and config paths use **Hadamard** (`hadamard-*`, `~/.hadamard`, `.hadamard/`).
 
 > **Note:** The desktop **Agent graph** orchestration UI (visual team / graph editor) is **still under active iteration and optimization** — expect UX and API changes. Prefer `/team`, saved team definitions, and the SDK `createTeam()` / graph runtime for production workflows today. See `CHANGELOG.md`.
 
-Inspired by Claude Code, Codex, Deepagents, and the broader agent ecosystem. Actoviq remains independent with its own public surface and documentation.
+Inspired by Claude Code, Codex, Deepagents, and the broader agent ecosystem. Hadamard remains independent with its own public surface and documentation.
 
 ## Vision
 
@@ -24,12 +26,12 @@ Inspired by Claude Code, Codex, Deepagents, and the broader agent ecosystem. Act
 ## Highlights
 
 - **Model Team** — `panel-analysis` (parallel investigation + convergence) and `reviewer` (verifiable-issues-only auditor). Runtime-owned member pooling, streamed `TeamEvent`s, per-member provider config, and inherited permission/retry boundaries.
-- **Model Router / Leader-Dispatch** — a leader classifies each turn and dispatches it to the best specialist route (any model/provider), runs normally, and the executor may itself convene a team. Profiles in `~/.actoviq/routers/`.
+- **Model Router / Leader-Dispatch** — a leader classifies each turn and dispatches it to the best specialist route (any model/provider), runs normally, and the executor may itself convene a team. Profiles in `~/.hadamard/routers/`.
 - **Dynamic Workflows** — JS script-based orchestration with explicit trust levels: trusted compatibility execution, isolated local-process execution, or a host-supplied remote/container sandbox for adversarial inputs.
 - **Bridge (named runtime configs)** — choose `Direct API` for provider-level reuse, or `External CLI` to launch installed Claude Code, Codex, Pi, CodeWhale, Reasonix, or Crush; reuse each CLI's native login/config, stream normalized tool and assistant events, stop background work, and browse/resume supported native conversations. An explicit key override is injected only into the child and is not written to the CLI's credential store; Pi, CodeWhale, Reasonix, and Crush keep isolated per-config session profiles so that key-mode history survives restarts without reading the native login store.
-- **Desktop GUI (`actoviq-gui`)** — Electron chat UI: streamed transcript, conversation history, command palette, settings, per-tool permission prompts. Security-hardened. Global **Assistant** FAB (Global/Project scope). The visual **Agent graph** orchestration UI is shipping in-progress and continues to be iterated (not a stable product surface yet).
-- **TUI (`actoviq-tui`)** — Terminal UI with 25+ slash commands, Claude Code-style UX: `/team`, `/bridge`, `/plan`, `/hooks`, `/mcp`, `/review`, `/context`, `/cost`, `/doctor`, and more. Live status spinner, scrollback transcript, todo panel, permission dialogs with project/user scope, sub-command autocomplete.
-- **Plan mode + hooks** — `EnterPlanMode`/`ExitPlanMode` tools with plan file; user-configurable `PreToolUse`/`PostToolUse`/`SessionStart` hooks from `settings.json`.
+- **Desktop GUI (`hadamard-gui`)** — Electron chat UI: streamed transcript, conversation history, command palette, settings, per-tool permission prompts. Security-hardened. Global **Assistant** FAB (Global/Project scope). The visual **Agent graph** orchestration UI is shipping in-progress and continues to be iterated (not a stable product surface yet).
+- **TUI (`hadamard-tui`)** — Terminal UI with 25+ slash commands, Claude Code-style UX: `/team`, `/bridge`, `/plan`, `/hooks`, `/mcp`, `/review`, `/context`, `/cost`, `/doctor`, and more. Live status spinner, scrollback transcript, todo panel, permission dialogs with project/user scope, sub-command autocomplete.
+- **Plan mode + hooks** — `EnterPlanMode`/`ExitPlanMode` tools with plan file; typed command, prompt, or HTTPS lifecycle hooks for session, turn, model, tool, permission, compact, stop, and worktree events. The GUI edits them directly; legacy `PreToolUse`/`PostToolUse`/`SessionStart` shell hooks remain compatible.
 - **Worktree Tools** — `EnterWorktree`/`ExitWorktree` with stack-based cwd, `.worktreeinclude`, PR checkout.
 - **TavilySearch** — AI-optimized web search, pure TypeScript.
 - **Standard Benchmark** — Self-contained framework with DeepSeek judge, HTML dashboard, 4-agent comparison.
@@ -64,7 +66,7 @@ npm install actoviq-agent-sdk zod
 For local examples, place your config at:
 
 ```text
-~/.actoviq/settings.json
+~/.hadamard/settings.json
 ```
 
 You can also preload a custom JSON file with `loadJsonConfigFile(...)`.
@@ -98,39 +100,25 @@ try {
 
 Existing 0.x applications may keep importing `createAgentSdk` from the package root or `/compat`; new applications should use the responsibility subpaths above.
 
+The supported differences between the SDK, `hadamard-tui`, and the desktop GUI are defined by the [three-layer product surface policy](./docs/en/08-product-surfaces.md) ([中文](./docs/zh/08-product-surfaces.md)). SDK-only developer parameters are intentional; shared TUI/GUI commands and runtime semantics are parity requirements.
+
 Run the repository examples with:
 
 ```bash
-npm run example:actoviq-quickstart
-npm run example:actoviq-agent-helpers
+npm run example:hadamard-quickstart
+npm run example:hadamard-agent-helpers
 npm run example:profiles
 ```
 
-## CLI REPL
-
-After installing the package, you can start an interactive scrollback-mode REPL directly from the terminal:
-
-```bash
-npx actoviq-react [work-dir]
-```
-
-This launches a readline-based interactive agent with:
-- Real-time streaming output in the main terminal buffer (native scrollback)
-- Tab completion for slash commands, including session model, permission, compact, and resume controls
-- Command history via ↑↓ arrow keys
-- Ctrl+C to abort the current request, press twice to exit
-
-**Note:** `actoviq-react` is a lightweight scrollback REPL, **not a full-featured TUI**. It does not use an alternate screen buffer, ScrollBox, or rich terminal rendering. It is designed for quick interaction and debugging. For the full terminal UI, use `actoviq-tui` below.
-
-## Terminal UI (TUI)
+## CLI / Terminal UI
 
-`actoviq-tui` is the full terminal UI, modeled on Claude Code's REPL design: the transcript prints into native scrollback while a redrawable bottom region hosts the status line, a Claude-style prompt bar, the slash-command menu, and permission dialogs.
+`hadamard-tui` is the full terminal UI, modeled on Claude Code's REPL design: the transcript prints into native scrollback while a redrawable bottom region hosts the status line, a Claude-style prompt bar, the slash-command menu, and permission dialogs.
 
 ```bash
-npx actoviq-tui [work-dir] [options]
+npx hadamard-tui [work-dir] [options]
 
 # Options
-#   --config <path>            Load a specific Actoviq settings JSON file
+#   --config <path>            Load a specific Hadamard settings JSON file
 #   --permission-mode <mode>   default | acceptEdits | plan | bypassPermissions (default)
 #   --model <model>            Override the configured model
 #   --resume <session-id>      Resume a stored Hadamard SDK session
@@ -147,29 +135,29 @@ Features:
 - **Team / workflow / worktree pickers** — `/team` activates a saved Model Team; `/workflows` runs a saved dynamic workflow; `/worktree` enters, exits, or lists git worktrees.
 - **Permission presets + per-tool scope** — `/permissions` switches between read-only/workspace/full/plan presets; always-allow rules persist with project or user scope.
 - **Mid-run steering** — keep typing while the agent works and press `Enter`: the message is queued and injected into the very next model request (shown as `⧗ queued`).
-- **Plan mode + hooks** — `/plan` enters plan mode (`EnterPlanMode`/`ExitPlanMode` tools, plan file); `PreToolUse`/`PostToolUse`/`SessionStart` hooks from settings.json; `/hooks` lists them.
+- **Plan mode + hooks** — `/plan` enters plan mode (`EnterPlanMode`/`ExitPlanMode` tools, plan file); typed lifecycle hooks are configured in the GUI or `settings.json`, while `/hooks` continues to list compatible legacy shell hooks.
 - **Bridge configs** — `/bridge config` manages named API or External CLI profiles for all six managed CLIs. `/bridge status`, `/bridge background`, `/bridge runs`, `/bridge stop`, `/bridge history`, and `/bridge resume` expose the same runtime lifecycle in the TUI and GUI; native history/resume remains subject to each installed CLI's protocol/version support.
 - **Diagnostics + inspection** — `/doctor` checks config health; `/context` inspects the context window; `/cost`/`/usage` track token + spend (per-config breakdown); `/review` reviews the git diff; `/stats` shows session stats.
 - **Context management built in** — the Hadamard SDK auto-compacts long sessions mid-run (full summary compact) and reactively recovers when a provider rejects an oversized prompt; notices surface as ∿ context compacted. History stays **append-only** between turns so automatic prefix caches (e.g. DeepSeek Context Caching) stay hot; Anthropic hosts still get explicit cache_control breakpoints. Oversized tool outputs are artifacted at write time rather than rewriting earlier messages.
-- **MCP management** — `/mcp add`/`/mcp remove` manage stdio + remote HTTP MCP servers, persisted to `~/.actoviq/mcp.json`.
+- **MCP management** — `/mcp add`/`/mcp remove` manage stdio + remote HTTP MCP servers, persisted to `~/.hadamard/mcp.json`.
 - **Image attachments** — `@<path>.png` tokens expand into image content blocks (in-process, read as base64).
 
-Both CLIs share the same Hadamard SDK runtime defaults (Actoviq settings from `~/.actoviq/settings.json`, core tools, `bypassPermissions`, uncapped tool iterations) and run against any Anthropic-compatible or OpenAI-compatible provider.
+The TUI uses the Hadamard SDK runtime defaults (Hadamard settings from `~/.hadamard/settings.json`, core tools, `bypassPermissions`, uncapped tool iterations) and runs against any Anthropic-compatible or OpenAI-compatible provider. `hadamard-tui` is the only interactive terminal agent entry point; the former `hadamard-react` and `hadamard-interactive-agent` entry points were retired after their capabilities were consolidated here.
 
-By default, Hadamard SDK sessions are scoped to the current workspace under `~/.actoviq/projects/<workspace-key>`. Explicit `sessionDirectory` settings still take precedence.
+By default, Hadamard SDK sessions are scoped to the current workspace under `~/.hadamard/projects/<workspace-key>`. Explicit `sessionDirectory` settings still take precedence.
 
-Model tiers are provider-neutral aliases. Configure them with `ACTOVIQ_DEFAULT_MIN_MODEL`, `ACTOVIQ_DEFAULT_MEDIUM_MODEL`, and `ACTOVIQ_DEFAULT_MAX_MODEL`, then use `min`, `medium`, or `max` anywhere a model can be selected.
+Model tiers are provider-neutral aliases. Configure them with `HADAMARD_DEFAULT_MIN_MODEL`, `HADAMARD_DEFAULT_MEDIUM_MODEL`, and `HADAMARD_DEFAULT_MAX_MODEL`, then use `min`, `medium`, or `max` anywhere a model can be selected.
 
-## Desktop GUI (`actoviq-gui`)
+## Desktop GUI (`hadamard-gui`)
 
 A local Electron desktop chat UI for the Hadamard SDK.
 
 ```bash
-npx actoviq-gui [work-dir] [options]
+npx hadamard-gui [work-dir] [options]
 
 # Options
 #   --port <port>              Internal port to bind (default: 4174, auto-fallback if busy)
-#   --config <path>            Load a specific Actoviq settings JSON file
+#   --config <path>            Load a specific Hadamard settings JSON file
 #   --permission-mode <mode>   default | acceptEdits | plan | bypassPermissions (default)
 #   --model <model>            Override the configured model
 #   --resume <session-id>      Resume a stored session
@@ -180,26 +168,29 @@ It opens an Electron window backed by a localhost-only HTTP server. Features:
 
 - **Streamed transcript** with markdown rendering and copyable code blocks, plus live tool-call cards
 - **Conversation history on resume** — opening or switching a chat replays its stored messages
-- **Command palette + slash commands**, settings (provider / model / keys / appearance), workspace switching, and empty-chat cleanup
+- **Shared slash commands**, settings (provider / model / keys / appearance), workspace switching, and empty-chat cleanup
 - **Per-tool permission prompts** (queued so concurrent requests don't collide) and a token-usage readout
 - **Project Documents + Issues** — each Project detail page has `Document` and `Issues` tabs. Issues use the guarded `backlog → todo → in_progress → in_review/blocked → done` lifecycle, support priorities, labels, acceptance criteria, comments, and links back to their worker sessions.
 - **Agent graph orchestration UI** — visual team/graph editor lives in the GUI **Agent** region; **it is still being iterated and optimized** and should not be treated as a finished product surface. Prefer saved teams + `/team` / SDK APIs for stable workflows.
+- **Agent Workflow + Automation** — the Agent region edits validated sequential, branch, and parallel Workflow trees. New Automation tasks select those saved Workflows; historical dynamic-script tasks remain compatible without being reinterpreted.
+- **Custom shortcuts + desktop screenshots** — Settings remaps supported actions, including a cross-platform screenshot action available to the user and agent runtime.
+- **Lifecycle hook editor** — Settings manages typed session, turn, model, tool, permission, compact, stop, and worktree hooks while retaining legacy hook compatibility.
 - **Agent Profiles for issue dispatch** — Settings → Models & routing can bind a named profile to a saved bridge config and model. `/issues start <id> [agent-profile]` asks the Project Manager for a worker brief, starts a linked session without changing the globally active runtime, and requires the worker to report through `IssueReport`.
-- **Movable data root** — Settings → General can copy the complete Actoviq data root to an empty directory, validate it, write the bootstrap pointer, rebuild the SDK/session store, and retain the previous directory for manual cleanup.
+- **Movable data root** — Settings → General can copy the complete Hadamard data root to an empty directory, validate it, write the bootstrap pointer, rebuild the SDK/session store, and retain the previous directory for manual cleanup.
 
 **Security model:** the internal API is reachable only from loopback (Host + Origin allowlist, which defeats DNS-rebinding / CSRF) and requires a per-process token; the page ships a strict Content-Security-Policy. Electron runs with `sandbox`, `contextIsolation`, and no `nodeIntegration`.
 
-Actoviq resolves its data root in this order: an explicit SDK `homeDir`, `ACTOVIQ_HOME`, `~/.actoviq/data-root.json`, then `~/.actoviq`. Project issues default to `<data-root>/projects/<workspace-key>/issues.json`; a project can instead use the protected workspace file `.actoviq/issues.json`.
+Hadamard resolves its data root in this order: an explicit SDK `homeDir`, `HADAMARD_HOME`, `~/.hadamard/data-root.json`, then `~/.hadamard`. Project issues default to `<data-root>/projects/<workspace-key>/issues.json`; a project can instead use the protected workspace file `.hadamard/issues.json`.
 
 > `electron` and `bun` are **optional** dependencies — installed only if you use the GUI / bridge runtime. The core SDK does not require them.
 >
-> **Bridge env overrides:** `ACTOVIQ_CLAUDE_PATH`, `ACTOVIQ_PI_PATH`, … (one per provider) to point the bridge at a specific runtime binary when it's not on `PATH`. See `docs/en/05-bridge-runtime.md`.
+> **Bridge env overrides:** `HADAMARD_CLAUDE_PATH`, `HADAMARD_PI_PATH`, … (one per provider) to point the bridge at a specific runtime binary when it's not on `PATH`. See `docs/en/05-bridge-runtime.md`.
 
 ## Developer notes
 
 - **Build before launching the CLIs/GUI:** `npm run build` (clean + `tsc`). Type-check only with `npm run typecheck`; run the suite with `npm test -- --run`.
 - **Team behavior is centralized:** extend teams through `src/team/teamRuntime.ts` (`runMemberAgent` / `buildMemberIdentities` / `preflightMember`) rather than duplicating per-mode logic. Observe a run via `team.ask(prompt, signal, { onEvent })` and inspect `result.memberStatuses` / `result.incompleteReason`.
-- **Router profiles are leader/dispatch configs:** a `RouterProfile` is a leader (`routerModel`) + a roster of specialist `routes` (each with `when` and optional `role` / `description`). `BUILT_IN_ROUTER_PROFILES` ships a ready-made `dispatch` profile; a user file of the same name in `.actoviq/routers/` shadows it.
+- **Router profiles are leader/dispatch configs:** a `RouterProfile` is a leader (`routerModel`) + a roster of specialist `routes` (each with `when` and optional `role` / `description`). `BUILT_IN_ROUTER_PROFILES` ships a ready-made `dispatch` profile; a user file of the same name in `.hadamard/routers/` shadows it.
 - **`CLAUDE.md` is intentionally git-ignored** in this repo — keep contributor-facing docs here in the README (or under `docs/`), not in `CLAUDE.md`.
 
 ## Tutorials
@@ -207,13 +198,13 @@ Actoviq resolves its data root in this order: an explicit SDK `homeDir`, `ACTOVI
 - English tutorial: [docs/en/README.md](./docs/en/README.md)
 - Chinese tutorial: [docs/zh/README.md](./docs/zh/README.md)
 - GitHub Pages docs site:
-  - https://deconbear.github.io/actoviq-agent-sdk/
+  - https://deconbear.github.io/hadamard/
 
 Start with these examples:
 
-- [examples/actoviq-quickstart.ts](./examples/actoviq-quickstart.ts)
-- [examples/actoviq-workflow.ts](./examples/actoviq-workflow.ts)
-- [examples/actoviq-agent-helpers.ts](./examples/actoviq-agent-helpers.ts)
+- [examples/hadamard-quickstart.ts](./examples/hadamard-quickstart.ts)
+- [examples/hadamard-workflow.ts](./examples/hadamard-workflow.ts)
+- [examples/hadamard-agent-helpers.ts](./examples/hadamard-agent-helpers.ts)
 - [examples/profiles/all-profiles.ts](./examples/profiles/all-profiles.ts)
 
 Architecture and operations:

package/SECURITY.md

@@ -2,11 +2,11 @@
 
 ## Supported versions
 
-Security fixes are provided for the latest Actoviq Agent SDK 1.x minor release. The legacy root compatibility façade remains supported throughout 1.x. Node.js 22.5+ and Node.js 24 are the supported runtime lines.
+Security fixes are provided for the latest Hadamard Agent SDK 1.x minor release. The legacy root compatibility façade remains supported throughout 1.x. Node.js 22.5+ and Node.js 24 are the supported runtime lines.
 
 ## Reporting a vulnerability
 
-Do not open a public issue for a suspected vulnerability. Use the repository's [private vulnerability reporting form](https://github.com/DeconBear/actoviq-agent-sdk/security/advisories/new). Include:
+Do not open a public issue for a suspected vulnerability. Use the repository's [private vulnerability reporting form](https://github.com/DeconBear/hadamard/security/advisories/new). Include:
 
 - affected version/commit, Node version, and operating system;
 - the smallest reproducible scenario and required configuration;

package/bin/{actoviq-app-server.js → hadamard-app-server.js}

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
 import('../dist/src/app-server/cli.js').catch(error => {
-  console.error('Failed to start actoviq-app-server:', error);
+  console.error('Failed to start hadamard-app-server:', error);
   process.exit(1);
 });

package/bin/{actoviq-gui.js → hadamard-gui.js}

@@ -13,12 +13,12 @@ const prepareLauncher = fileURLToPath(new URL('../scripts/prepare-gui-launcher.m
 function resolveElectronExecutable() {
   const electronExe = require('electron');
   if (process.platform === 'win32') {
-    const brandedLauncher = join(dirname(electronExe), 'Actoviq.exe');
+    const brandedLauncher = join(dirname(electronExe), 'Hadamard.exe');
     if (!existsSync(brandedLauncher)) {
       const prep = spawnSync(process.execPath, [prepareLauncher], { stdio: 'inherit' });
       if (prep.status !== 0) {
         process.stderr.write(
-          'Actoviq: branded launcher unavailable; taskbar may show the Electron icon.\n',
+          'Hadamard: branded launcher unavailable; taskbar may show the Electron icon.\n',
         );
       }
     }
@@ -33,7 +33,7 @@ const child = spawn(electron, [main, ...process.argv.slice(2)], {
   stdio: 'inherit',
   env: {
     ...process.env,
-    ACTOVIQ_GUI_ROOT: rootDir,
+    HADAMARD_GUI_ROOT: rootDir,
   },
   windowsHide: false,
 });
@@ -44,6 +44,6 @@ child.on('exit', (code, signal) => {
 });
 
 child.on('error', (error) => {
-  console.error('Failed to start actoviq-gui:', error);
+  console.error('Failed to start hadamard-gui:', error);
   process.exit(1);
 });

package/bin/{actoviq-link-runtime.js → hadamard-link-runtime.js}

@@ -3,28 +3,28 @@
  * Link or copy a third-party agent runtime bundle for use with the bridge SDK.
  *
  * Usage:
- *   npx actoviq-link-runtime /path/to/claude-code
- *   npx actoviq-link-runtime /path/to/runtime-bundle
+ *   npx hadamard-link-runtime /path/to/claude-code
+ *   npx hadamard-link-runtime /path/to/runtime-bundle
  */
 import { existsSync, symlinkSync, copyFileSync, unlinkSync, mkdirSync } from 'node:fs';
 import { resolve, join, dirname } from 'node:path';
 import { fileURLToPath } from 'node:url';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
-const targetDir = resolve(__dirname, '..', 'vendor', 'actoviq-runtime');
+const targetDir = resolve(__dirname, '..', 'vendor', 'hadamard-runtime');
 const targetPath = join(targetDir, 'runtime.bundle.br');
 
 const input = process.argv[2];
 if (!input || input === '--help' || input === '-h') {
-  console.log('Usage: actoviq-link-runtime <path>');
+  console.log('Usage: hadamard-link-runtime <path>');
   console.log('');
   console.log('  <path>  Path to a third-party agent runtime installation,');
   console.log('          or directly to a runtime bundle file.');
   console.log('');
   console.log('Examples:');
-  console.log('  actoviq-link-runtime ~/.nvm/versions/node/v22/lib/node_modules/@anthropic-ai/claude-code');
-  console.log('  actoviq-link-runtime /usr/local/lib/node_modules/@anthropic-ai/claude-code');
-  console.log('  actoviq-link-runtime ./runtime-bundle');
+  console.log('  hadamard-link-runtime ~/.nvm/versions/node/v22/lib/node_modules/@anthropic-ai/claude-code');
+  console.log('  hadamard-link-runtime /usr/local/lib/node_modules/@anthropic-ai/claude-code');
+  console.log('  hadamard-link-runtime ./runtime-bundle');
   console.log('');
   console.log('The bridge SDK works with a third-party agent runtime bundle');
   console.log('to provide the reference implementation.');
@@ -35,8 +35,8 @@ const sourcePath = resolve(input);
 
 // If the input is a directory, look for the bundle inside it
 let bundlePath;
-if (existsSync(sourcePath) && existsSync(join(sourcePath, 'vendor', 'actoviq-runtime', 'runtime.bundle.br'))) {
-  bundlePath = join(sourcePath, 'vendor', 'actoviq-runtime', 'runtime.bundle.br');
+if (existsSync(sourcePath) && existsSync(join(sourcePath, 'vendor', 'hadamard-runtime', 'runtime.bundle.br'))) {
+  bundlePath = join(sourcePath, 'vendor', 'hadamard-runtime', 'runtime.bundle.br');
 } else if (existsSync(sourcePath) && sourcePath.endsWith('.br')) {
   bundlePath = sourcePath;
 } else if (existsSync(join(sourcePath, 'runtime.bundle.br'))) {
@@ -71,4 +71,4 @@ try {
 
 console.log('');
 console.log('Bridge runtime bundle is now available.');
-console.log('Run: npx actoviq-interactive-agent');
+console.log('Run: npx hadamard-tui');

package/bin/hadamard-tui.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+import('../dist/src/cli/hadamard-tui.js').catch((e) => {
+  console.error('Failed to start hadamard-tui:', e);
+  process.exit(1);
+});

package/dist/src/app-server/appServer.d.ts

@@ -1,10 +1,10 @@
-import type { ActoviqAgentClient } from '../runtime/agentClient.js';
+import type { HadamardAgentClient } from '../runtime/agentClient.js';
 import { type AppServerNotification, type AppServerRequest, type AppServerResponse } from './protocol.js';
 export type AppServerEmit = (notification: AppServerNotification) => void;
 export declare class AppServer {
     private readonly sdk;
     private readonly liveSessions;
-    constructor(sdk: ActoviqAgentClient);
+    constructor(sdk: HadamardAgentClient);
     handle(request: AppServerRequest, emit?: AppServerEmit): Promise<AppServerResponse>;
     private dispatch;
     private openSession;