actoviq-agent-sdk 0.4.8 → 0.4.10

package/CHANGELOG.md

@@ -4,6 +4,62 @@ All notable changes to this project will be documented in this file.
 
 The format is based on Keep a Changelog, with automated updates from GitHub Releases.
 
+## 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
+
+- **Policy / sandbox / hooks** — host/user/project policy resolution, OS sandbox adapters (Linux bubblewrap / macOS sandbox-exec / Windows degraded), and typed lifecycle hooks.
+- **Checkpoints / goals / session graph** — durable file+conversation checkpoints, goal contracts, and session fork/tree/catalog primitives.
+- **App-server / remote / VS Code** — stdio/WebSocket JSON app-server, file-backed remote job leases, and a VS Code extension client.
+- **Plugin packages** — versioned installable plugins with integrity-required trust grants.
+- **Code intel / updates / worktrees / proposals** — LSP tools, app update service, task worktree coordination, context rules, review/diff stores, memory and team proposals.
+
+### GUI
+
+- Upgrade the bottom-right FAB to a global **Assistant**: always visible, chat icon, Global/Project scope. Global mode lists project briefs and can change settings/plugins/bridge/automation/MCP (no source Write/Edit/Bash); Project mode keeps Manager update/plan/issues.
+- Remove the redundant sidebar **New chat** button; start chats from project detail **+ New conversation**.
+- Fix opening local workspace paths: strip quotes / `file://`, require directories, surface API errors in the Open workspace dialog, roll back on failure, and allow credentialless opens (External CLI).
+- Remove Settings → **Automation** / **Browser** / **Computer control**. Configure schedules in the main **Automation** region; configure Playwright and Computer Use under **Customize → Plugins**.
+
+### Managed plugins
+
+- Add **Image Generation**, **Video Generation**, and **3D Generation** managed plugins with multi-profile / multi-key configuration (Gemini Nano Banana, GPT Image 2, Qwen-Image; Seedance, Hailuo, HappyHorse; Meshy, Tripo, Rodin).
+- Agent tools `generate_image` / `generate_video` / `generate_mesh` inject Qwen-style professional prompt-rewrite guidance and let the model choose among configured profiles.
+- Customize → Plugins includes a profile list editor with **Get API Key** links to each provider console.
+
+### Bridge / tests / CI
+
+- 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
+
+- This release stays on the **0.4.x** line. **1.0.0 is not published yet.**
+- Windows shell sandbox remains best-effort/degraded; `enforcement: required` fails closed when OS isolation is unavailable.
+
 ## v0.4.8 - 2026-07-27
 
 ### Runtime / prompt cache
@@ -89,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")
 
@@ -105,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
 
@@ -116,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
 
@@ -159,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、对话历史、命令面板、设置、每工具权限提示。安全增强。可视化 **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 文件。
@@ -95,13 +97,13 @@ try {
 }
 ```
 
-0.x 应用可继续从 package root 或 `/compat` 导入 `createAgentSdk`。新应用应使用上述职责 subpath；迁移步骤见 [1.0 迁移指南](./docs/zh/09-sdk-v2-migration-guide.md)。
+0.x 应用可继续从 package root 或 `/compat` 导入 `createAgentSdk`；新应用应使用上述职责 subpath。
 
 运行仓库示例：
 
 ```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
 ```
 
@@ -110,18 +112,18 @@ npm run example:profiles
 安装包后，可以直接从终端启动交互式 scrollback 模式 REPL：
 
 ```bash
-npx actoviq-react [工作目录]
+npx hadamard-react [工作目录]
 ```
 
 ## 终端 UI (TUI)
 
-`actoviq-tui` 是全功能终端 UI，模拟 Claude Code 的 REPL 设计:
+`hadamard-tui` 是全功能终端 UI，模拟 Claude Code 的 REPL 设计:
 
 ```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 +132,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,21 +157,16 @@ 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)
 
 架构与运维文档：
 
-- [架构审计与实施规划](./docs/zh/08-sdk-architecture-audit-and-optimization-plan.md)
-- [1.0 迁移指南](./docs/zh/09-sdk-v2-migration-guide.md)
-- [支持、安全、SemVer 与 failure model](./docs/zh/10-support-security-semver-and-failure-model.md)
-- [JSON v1 → SQLite 迁移 Runbook](./docs/zh/11-json-v1-to-sqlite-migration-runbook.md)
-- [1.0 实施与端到端验收报告](./docs/zh/12-sdk-1.0-implementation-and-verification-report.md)
 - [安全报告政策](./SECURITY.md)
 
 ## 参与贡献

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,11 +26,11 @@ 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. 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.
+- **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; user-configurable `PreToolUse`/`PostToolUse`/`SessionStart` hooks from `settings.json`.
 - **Worktree Tools** — `EnterWorktree`/`ExitWorktree` with stack-based cwd, `.worktreeinclude`, PR checkout.
 - **TavilySearch** — AI-optimized web search, pure TypeScript.
@@ -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(...)`.
@@ -96,13 +98,13 @@ try {
 }
 ```
 
-Existing 0.x applications may keep importing `createAgentSdk` from the package root or `/compat`. See the [1.0 migration guide](./docs/zh/09-sdk-v2-migration-guide.md); new applications should use the responsibility subpaths above.
+Existing 0.x applications may keep importing `createAgentSdk` from the package root or `/compat`; new applications should use the responsibility subpaths above.
 
 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
 ```
 
@@ -111,7 +113,7 @@ npm run example:profiles
 After installing the package, you can start an interactive scrollback-mode REPL directly from the terminal:
 
 ```bash
-npx actoviq-react [work-dir]
+npx hadamard-react [work-dir]
 ```
 
 This launches a readline-based interactive agent with:
@@ -120,17 +122,17 @@ This launches a readline-based interactive agent with:
 - 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.
+**Note:** `hadamard-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 `hadamard-tui` below.
 
 ## Terminal UI (TUI)
 
-`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
@@ -151,25 +153,25 @@ Features:
 - **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.
+Both CLIs share the same Hadamard SDK runtime defaults (Hadamard settings from `~/.hadamard/settings.json`, core tools, `bypassPermissions`, uncapped tool iterations) and run against any Anthropic-compatible or OpenAI-compatible provider.
 
-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
@@ -185,21 +187,21 @@ It opens an Electron window backed by a localhost-only HTTP server. Features:
 - **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 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,22 +209,17 @@ 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:
 
-- [Architecture audit and implementation plan](./docs/zh/08-sdk-architecture-audit-and-optimization-plan.md)
-- [1.0 migration guide](./docs/zh/09-sdk-v2-migration-guide.md)
-- [Support, security, SemVer, and failure model](./docs/zh/10-support-security-semver-and-failure-model.md)
-- [JSON v1 to SQLite migration runbook](./docs/zh/11-json-v1-to-sqlite-migration-runbook.md)
-- [1.0 implementation and verification report](./docs/zh/12-sdk-1.0-implementation-and-verification-report.md)
 - [Security policy](./SECURITY.md)
 
 ## Contributing

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;
@@ -16,7 +16,7 @@ Do not open a public issue for a suspected vulnerability. Use the repository's [
 
 Avoid including real credentials or private user data. If private reporting is unavailable, open a public issue containing no exploit details and ask a maintainer to establish a private channel.
 
-The maintainers will acknowledge receipt, validate severity, coordinate remediation and disclosure, and publish an advisory when appropriate. Response targets and the full threat/failure policy are documented in [docs/zh/10-support-security-semver-and-failure-model.md](docs/zh/10-support-security-semver-and-failure-model.md).
+The maintainers will acknowledge receipt, validate severity, coordinate remediation and disclosure, and publish an advisory when appropriate.
 
 ## Security boundaries
 

package/bin/hadamard-app-server.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+import('../dist/src/app-server/cli.js').catch(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-interactive-agent.js → hadamard-interactive-agent.js}

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